{{BUNDLE_NAME}}

<?php /**

Metadata

Field	Value
Source site	ɩ.com / JustAnIota.com
Source URL	https://justaniota.com/
Canonical AIWikis URL	https://aiwikis.org/justaniota/uai-system/files/justaniota-com-wp-content-themes-iota-authority-theme-functions-php-80fbde87/
Source reference	JustAnIota.com/wp-content/themes/iota-authority-theme/functions.php
File type	php
Content category	public-content
Last fetched	2026-05-06T17:58:24.5168382Z
Last changed	2026-05-06T17:48:32.0124787Z
Content hash	sha256:80fbde877c5925da3c4d0058f298554c70a849e8e94bdb60020ce596417a0b5b
Import status	unchanged
Raw source layer	data/sources/justaniota/justaniota-com-wp-content-themes-iota-authority-theme-functions-php-80fbde877c59.php
Normalized source layer	data/normalized/justaniota/justaniota-com-wp-content-themes-iota-authority-theme-functions-php-80fbde877c59.txt

Current File Content

Structure Preview

• {{BUNDLE_NAME}}
• Bundle Purpose
• Use This When
• Lifecycle
• Trust Boundary
• Included Files
• Maintenance Rule
• Review Before Sharing
• My Project AI Memory
• Handoff Summary
• Loaded Context
• Required First Response
• Do Not Change Without Explicit Approval
• My Project Human Briefing
• What You Need To Know
• Things The AI Will Defend
• Things Humans Should Make Explicit
• Project Overview
• Purpose
• Current Scope
• Source Of Truth
• Success Criteria
• Current State
• What Is True Now

Raw Version

This public page shows a bounded preview of a large source file. The complete source remains in the raw and normalized source layers named in metadata, with the SHA-256 hash above for verification.

• Source characters: 890751
• Preview characters: 11992

<?php
/**
 * Iota Authority theme functions.
 *
 * @package Iota_Authority
 */

if ( ! defined( 'UAIX_AUTHORITY_VERSION' ) ) {
	define( 'UAIX_AUTHORITY_VERSION', '2.8.0' );
}

require_once trailingslashit( get_template_directory() ) . 'inc/localization.php';
require_once trailingslashit( get_template_directory() ) . 'inc/justaniota-content-overrides.php';

/**
 * Determine whether lightweight local performance tracing is enabled.
 *
 * @return bool
 */
function uaix_authority_perf_trace_enabled() {
	static $enabled = null;

	if ( null !== $enabled ) {
		return $enabled;
	}

	$enabled = defined( 'UAIX_PERF_TRACE' ) && UAIX_PERF_TRACE;

	if ( ! $enabled && isset( $_GET['uaix_perf_trace'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Local diagnostics flag only.
		$host    = isset( $_SERVER['HTTP_HOST'] ) ? strtolower( (string) wp_unslash( $_SERVER['HTTP_HOST'] ) ) : '';
		$enabled = '' === $host || false !== strpos( $host, 'localhost' ) || false !== strpos( $host, '127.0.0.1' );
	}

	return (bool) $enabled;
}

/**
 * Return the request-local performance trace store.
 *
 * @return array<string,mixed>
 */
function &uaix_authority_perf_trace_store() {
	static $store = array(
		'start'  => 0.0,
		'totals' => array(),
		'counts' => array(),
		'open'   => array(),
		'events' => array(),
	);

	if ( 0.0 === $store['start'] ) {
		$store['start'] = microtime( true );
	}

	return $store;
}

/**
 * Start a performance span.
 *
 * @param string $key Component key.
 * @return void
 */
function uaix_authority_perf_start( $key ) {
	if ( ! uaix_authority_perf_trace_enabled() ) {
		return;
	}

	$store =& uaix_authority_perf_trace_store();
	$key    = (string) $key;

	if ( '' === $key ) {
		return;
	}

	if ( ! isset( $store['open'][ $key ] ) ) {
		$store['open'][ $key ] = array();
	}

	$store['open'][ $key ][] = microtime( true );
}

/**
 * Stop a performance span and add it to the component total.
 *
 * @param string $key Component key.
 * @return void
 */
function uaix_authority_perf_stop( $key ) {
	if ( ! uaix_authority_perf_trace_enabled() ) {
		return;
	}

	$store =& uaix_authority_perf_trace_store();
	$key    = (string) $key;

	if ( empty( $store['open'][ $key ] ) ) {
		return;
	}

	$start   = array_pop( $store['open'][ $key ] );
	$elapsed = microtime( true ) - (float) $start;

	if ( ! isset( $store['totals'][ $key ] ) ) {
		$store['totals'][ $key ] = 0.0;
		$store['counts'][ $key ] = 0;
	}

	$store['totals'][ $key ] += $elapsed;
	$store['counts'][ $key ]++;
}

/**
 * Add an instantaneous performance counter.
 *
 * @param string $key Component key.
 * @param int    $count Count increment.
 * @return void
 */
function uaix_authority_perf_count( $key, $count = 1 ) {
	if ( ! uaix_authority_perf_trace_enabled() ) {
		return;
	}

	$store =& uaix_authority_perf_trace_store();
	$key    = (string) $key;

	if ( '' === $key ) {
		return;
	}

	if ( ! isset( $store['counts'][ $key ] ) ) {
		$store['counts'][ $key ] = 0;
	}

	$store['counts'][ $key ] += (int) $count;
}

/**
 * Return compact trace rows sorted by elapsed time.
 *
 * @return array<int,array<string,mixed>>
 */
function uaix_authority_perf_trace_rows() {
	$store =& uaix_authority_perf_trace_store();
	$rows   = array();

	foreach ( $store['totals'] as $key => $seconds ) {
		$rows[] = array(
			'key'     => (string) $key,
			'seconds' => (float) $seconds,
			'count'   => isset( $store['counts'][ $key ] ) ? (int) $store['counts'][ $key ] : 0,
		);
	}

	usort(
		$rows,
		static function ( $left, $right ) {
			return $right['seconds'] <=> $left['seconds'];
		}
	);

	return $rows;
}

/**
 * Enable traced SQL timings when the local trace flag is active.
 *
 * @return void
 */
function uaix_authority_perf_enable_query_trace() {
	if ( ! uaix_authority_perf_trace_enabled() ) {
		return;
	}

	global $wpdb;

	if ( is_object( $wpdb ) && property_exists( $wpdb, 'save_queries' ) ) {
		$wpdb->save_queries = true;
	}
}
add_action( 'after_setup_theme', 'uaix_authority_perf_enable_query_trace', 1 );

/**
 * Start timing shortcode execution.
 *
 * @param mixed  $return Short-circuit return value.
 * @param string $tag    Shortcode tag.
 * @return mixed
 */
function uaix_authority_perf_trace_shortcode_start( $return, $tag ) {
	uaix_authority_perf_start( 'shortcode:' . (string) $tag );

	return $return;
}
add_filter( 'pre_do_shortcode_tag', 'uaix_authority_perf_trace_shortcode_start', 1, 2 );

/**
 * Stop timing shortcode execution.
 *
 * @param string $output Shortcode output.
 * @param string $tag    Shortcode tag.
 * @return string
 */
function uaix_authority_perf_trace_shortcode_stop( $output, $tag ) {
	uaix_authority_perf_stop( 'shortcode:' . (string) $tag );

	return $output;
}
add_filter( 'do_shortcode_tag', 'uaix_authority_perf_trace_shortcode_stop', 1000, 2 );

/**
 * Emit local performance trace output for explicit diagnostic requests.
 *
 * @return void
 */
function uaix_authority_perf_emit_trace() {
	if ( ! uaix_authority_perf_trace_enabled() ) {
		return;
	}

	$store =& uaix_authority_perf_trace_store();

	global $wpdb;

	if ( is_object( $wpdb ) ) {
		uaix_authority_perf_count( 'db:queries', isset( $wpdb->num_queries ) ? (int) $wpdb->num_queries : 0 );

		if ( ! empty( $wpdb->queries ) && is_array( $wpdb->queries ) ) {
			$query_time = 0.0;

			foreach ( $wpdb->queries as $query ) {
				if ( isset( $query[1] ) ) {
					$query_time += (float) $query[1];
				}
			}

			$store['totals']['db:query_time'] = $query_time;
			$store['counts']['db:query_time'] = count( $wpdb->queries );
		}
	}

	$total = microtime( true ) - (float) $store['start'];
	$rows  = uaix_authority_perf_trace_rows();

	if ( ! headers_sent() ) {
		header( 'X-UAIX-Perf-Total: ' . number_format( $total, 4, '.', '' ) );

		$server_timing = array();
		foreach ( array_slice( $rows, 0, 12 ) as $row ) {
			$name            = preg_replace( '/[^A-Za-z0-9_-]+/', '_', $row['key'] );
			$server_timing[] = $name . ';dur=' . number_format( $row['seconds'] * 1000, 2, '.', '' ) . ';desc="' . $row['key'] . ' x' . (int) $row['count'] . '"';
		}

		if ( ! empty( $server_timing ) ) {
			header( 'Server-Timing: ' . implode( ', ', $server_timing ) );
		}
	}

	echo "\n<!-- UAIX_PERF_TRACE total=" . esc_html( number_format( $total, 4, '.', '' ) ) . "s -->\n";

	foreach ( $rows as $row ) {
		echo '<!-- UAIX_PERF ' . esc_html( $row['key'] ) . ' count=' . esc_html( (string) $row['count'] ) . ' seconds=' . esc_html( number_format( $row['seconds'], 6, '.', '' ) ) . " -->\n";
	}

	if ( isset( $_GET['uaix_perf_log'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Local diagnostics flag only.
		error_log( 'UAIX_PERF_TRACE total=' . number_format( $total, 6, '.', '' ) . ' route=' . ( isset( $_SERVER['REQUEST_URI'] ) ? (string) wp_unslash( $_SERVER['REQUEST_URI'] ) : '' ) ); // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
	}
}
add_action( 'shutdown', 'uaix_authority_perf_emit_trace', 1000 );

/**
 * Rewrite shipped absolute internal URLs to the current site host.
 *
 * This keeps seeded page content and translated content portable across local,
 * staging, and production environments without requiring host-specific edits.
 *
 * @param string $content Rendered content HTML.
 * @return string
 */
function uaix_authority_rewrite_portable_internal_content_urls( $content ) {
	if ( ! is_string( $content ) || '' === $content ) {
		return $content;
	}

	$site_root = untrailingslashit( (string) get_option( 'home' ) );

	if ( '' === $site_root ) {
		return $content;
	}

	$content = preg_replace(
		'#https?://(?:localhost(?::\d+)?|(?:www\.)?(?:uaix|uiax)\.org)(?=/)#i',
		$site_root,
		$content
	);

	return preg_replace_callback(
		'#href=("|\')(.*?)\1#i',
		static function ( $matches ) {
			$quote = isset( $matches[1] ) ? $matches[1] : '"';
			$url   = isset( $matches[2] ) ? html_entity_decode( (string) $matches[2], ENT_QUOTES ) : '';

			return 'href=' . $quote . esc_url( uaix_authority_canonicalize_internal_public_url( $url ) ) . $quote;
		},
		$content
	);
}

/**
 * Timed wrapper for portable internal URL rewriting.
 *
 * @param string $content Rendered content HTML.
 * @return string
 */
function uaix_authority_trace_rewrite_portable_internal_content_urls( $content ) {
	uaix_authority_perf_start( 'content:portable_url_rewrite' );

	try {
		return uaix_authority_rewrite_portable_internal_content_urls( $content );
	} finally {
		uaix_authority_perf_stop( 'content:portable_url_rewrite' );
	}
}
add_filter( 'the_content', 'uaix_authority_trace_rewrite_portable_internal_content_urls', 5 );

/**
 * Resolve a post reference to the public-facing record when possible.
 *
 * @param WP_Post|int|null $post Post object or ID.
 * @return WP_Post|null
 */
function uaix_authority_resolve_public_post_object( $post = null ) {
	$post = get_post( $post );

	if ( ! $post instanceof WP_Post ) {
		return null;
	}

	$revision_parent_id = wp_is_post_revision( $post->ID );

	if ( $revision_parent_id ) {
		$post = get_post( (int) $revision_parent_id );
	}

	if ( ! $post instanceof WP_Post ) {
		return null;
	}

	if ( 'revision' === $post->post_type || 'auto-draft' === $post->post_status ) {
		return null;
	}

	return $post;
}

/**
 * Return the token replacement value for a post permalink structure.
 *
 * @param string  $token Structure token.
 * @param WP_Post $post Post object.
 * @return string
 */
function uaix_authority_post_path_token_value( $token, WP_Post $post ) {
	switch ( $token ) {
		case '%year%':
			return mysql2date( 'Y', $post->post_date, false );

		case '%monthnum%':
			return mysql2date( 'm', $post->post_date, false );

		case '%day%':
			return mysql2date( 'd', $post->post_date, false );

		case '%postname%':
			return '' !== (string) $post->post_name ? (string) $post->post_name : sanitize_title( $post->post_title );

		case '%post_id%':
			return (string) $post->ID;

		case '%category%':
			$categories = get_the_category( $post->ID );

			if ( ! empty( $categories ) && $categories[0] instanceof WP_Term ) {
				return (string) $categories[0]->slug;
			}

			return 'uncategorized';

		case '%author%':
			$author = get_userdata( (int) $post->post_author );

			if ( $author instanceof WP_User ) {
				return (string) $author->user_nicename;
			}

			return 'author';
	}

	return $token;
}

/**
 * Return the clean public route path for a record.
 *
 * @param WP_Post|int|null $post Post object or ID.
 * @return string
 */
function uaix_authority_public_route_path( $post = null ) {
	static $cache = array();

	$post = uaix_authority_resolve_public_post_object( $post );

	if ( ! $post instanceof WP_Post ) {
		return '';
	}

	$cache_key = (int) $post->ID;

	if ( isset( $cache[ $cache_key ] ) ) {
		return $cache[ $cache_key ];
	}

	if ( 'page' === $post->post_type ) {
		if ( (int) $post->ID === (int) get_option( 'page_on_front' ) ) {
			$cache[ $cache_key ] = '/';

			return $cache[ $cache_key ];
		}

		$page_path = trim( (string) get_page_uri( $post ), '/' );

		$cache[ $cache_key ] = '' === $page_path ? '/' : '/' . trailingslashit( $page_path );

		return $cache[ $cache_key ];
	}

	if ( 'post' === $post->post_type ) {
		$structure = trim( (string) get_option( 'permalink_structure' ) );

		if ( '' === $structure ) {
			$structure = '/%year%/%monthnum%/%day%/%postname%/';
		}

		$tokens = array( '%year%', '%monthnum%', '%day%', '%postname%', '%post_id%', '%category%', '%author%' );
		$values = array_map(
			static function ( $token ) use ( $post ) {
				return uaix_authority_post_path_token_value( $token, $post );
			},

Why This File Exists

This is a public content source file from ɩ.com / JustAnIota.com. It is shown here because AIWikis.org is demonstrating the real source files that make the UAIX / LLM Wiki memory system work, not only summarizing those systems after the fact.

Role

This file is a focused source unit. Its path, headings, and metadata give an agent a retrieval handle that is smaller than loading the entire site or repository.

Structure

The file is structured around these visible headings: {{BUNDLE_NAME}}; Bundle Purpose; Use This When; Lifecycle; Trust Boundary; Included Files; Maintenance Rule; Review Before Sharing. Those headings are retrieval anchors: a crawler or LLM can decide whether the file is relevant before reading every line.

Prompt-Size And Retrieval Benefit

Keeping this material in a separate file reduces prompt pressure because an agent can load this exact unit only when its role, source site, category, or hash is relevant. The surrounding index pages point to it, while this page preserves the full content for audit and exact recall.

How To Use It

• Humans should read the metadata first, then inspect the raw content when they need exact wording or provenance.
• LLMs and agents should use the source site, category, hash, headings, and related files to decide whether this file belongs in the active prompt.
• Crawlers should treat the AIWikis page as transparent evidence and follow the source URL/source reference for authority boundaries.
• Future maintainers should regenerate this page whenever the source hash changes, then review the explanation if the role or structure changed.

Update Requirements

When this source file changes, update the raw source layer, normalized source layer, hash history, this rendered page, generated explanation, source-file inventory, changed-files report, and any source-section index that links to it.

Related Pages

• Source overview
• UAI system index
• Source provenance
• Global File Index
• Reports

Provenance And History

• Current observation: 2026-05-06T17:58:24.5168382Z
• Source origin: current-source-workspace
• Retrieval method: local-source-workspace
• Duplicate group: sfg-344 (primary)
• Historical hash records are stored in data/hashes/source-file-history.jsonl.

Machine-Readable Metadata

{
    "title":  "{{BUNDLE_NAME}}",
    "source_site":  "ɩ.com / JustAnIota.com",
    "source_url":  "https://justaniota.com/",
    "canonical_url":  "https://aiwikis.org/justaniota/uai-system/files/justaniota-com-wp-content-themes-iota-authority-theme-functions-php-80fbde87/",
    "source_reference":  "JustAnIota.com/wp-content/themes/iota-authority-theme/functions.php",
    "file_type":  "php",
    "content_category":  "public-content",
    "content_hash":  "sha256:80fbde877c5925da3c4d0058f298554c70a849e8e94bdb60020ce596417a0b5b",
    "last_fetched":  "2026-05-06T17:58:24.5168382Z",
    "last_changed":  "2026-05-06T17:48:32.0124787Z",
    "import_status":  "unchanged",
    "duplicate_group_id":  "sfg-344",
    "duplicate_role":  "primary",
    "related_files":  [

                      ],
    "generated_explanation":  true,
    "explanation_last_generated":  "2026-05-06T17:58:24.5168382Z"
}