aiox-core 5.0.7 → 5.0.8

package/.aiox-core/core/synapse/context/context-tracker.js

@@ -5,13 +5,16 @@
  * based on estimated token usage. Provides token budgets and layer filtering
  * per bracket for the SynapseEngine orchestrator.
  *
- * Pure arithmetic module — zero I/O, zero external dependencies.
+ * Reads model context window from core-config.yaml → models.registry.
  *
  * @module core/synapse/context/context-tracker
- * @version 1.0.0
+ * @version 1.1.0
  * @created Story SYN-3 - Context Bracket Tracker
  */
 
+const fs = require('fs');
+const path = require('path');
+
 /**
  * Bracket definitions with thresholds and token budgets.
  *
@@ -51,11 +54,87 @@ const XML_SAFETY_MULTIPLIER = 1.2;
 
 /**
  * Default configuration values.
+ * maxContext is the fallback when core-config.yaml is unavailable.
  */
-const DEFAULTS = {
+const DEFAULTS = Object.freeze({
   avgTokensPerPrompt: 1500,
   maxContext: 200000,
-};
+});
+
+/** Cache for model config by project root (read once per root per process). */
+const _modelConfigCache = new Map();
+
+function cloneModelConfig(config) {
+  return { ...config };
+}
+
+function cacheModelConfig(root, config) {
+  const cachedConfig = Object.freeze(cloneModelConfig(config));
+  _modelConfigCache.set(root, cachedConfig);
+  return cloneModelConfig(cachedConfig);
+}
+
+function isPositiveFiniteNumber(value) {
+  return Number.isFinite(value) && value > 0;
+}
+
+/**
+ * Resolve the project root used for model config lookup.
+ *
+ * @param {string|null} basePath - Optional project root override
+ * @returns {string}
+ */
+function resolveConfigRoot(basePath) {
+  return path.resolve(basePath || path.resolve(__dirname, '..', '..', '..', '..'));
+}
+
+/**
+ * Read model configuration from core-config.yaml → models section.
+ * Returns { contextWindow, avgTokensPerPrompt } for the active model.
+ * Falls back to DEFAULTS if config is missing or malformed.
+ *
+ * @param {string|null} [basePath=null] - Project root override (defaults to __dirname-based resolution)
+ * @returns {{ maxContext: number, avgTokensPerPrompt: number }}
+ */
+function getModelConfig(basePath = null) {
+  const root = resolveConfigRoot(basePath);
+  if (_modelConfigCache.has(root)) return cloneModelConfig(_modelConfigCache.get(root));
+
+  try {
+    const yaml = require('js-yaml');
+    let configPath = path.join(root, '.aios-core', 'core-config.yaml');
+    if (!fs.existsSync(configPath)) {
+      configPath = path.join(root, '.aiox-core', 'core-config.yaml');
+    }
+    if (!fs.existsSync(configPath)) {
+      return cacheModelConfig(root, DEFAULTS);
+    }
+
+    const config = yaml.load(fs.readFileSync(configPath, 'utf8'));
+    const models = config && config.models;
+    if (!models || !models.registry || !models.active) {
+      return cacheModelConfig(root, DEFAULTS);
+    }
+
+    const activeModel = models.registry[models.active];
+    if (!activeModel || !isPositiveFiniteNumber(activeModel.contextWindow)) {
+      return cacheModelConfig(root, DEFAULTS);
+    }
+
+    const modelConfig = {
+      maxContext: activeModel.contextWindow,
+      avgTokensPerPrompt: isPositiveFiniteNumber(activeModel.avgTokensPerPrompt)
+        ? activeModel.avgTokensPerPrompt
+        : DEFAULTS.avgTokensPerPrompt,
+    };
+    return cacheModelConfig(root, modelConfig);
+  } catch (err) {
+    if (process.env.DEBUG || process.env.AIOX_DEBUG) {
+      console.warn('[context-tracker] Failed to load model config, using defaults:', err.message);
+    }
+    return cacheModelConfig(root, DEFAULTS);
+  }
+}
 
 /**
  * Layer configurations per bracket.
@@ -101,16 +180,20 @@ function calculateBracket(contextPercent) {
  * Formula: 100 - ((promptCount * avgTokensPerPrompt) / maxContext * 100)
  * Result is clamped to 0-100 range.
  *
+ * Reads maxContext and avgTokensPerPrompt from core-config.yaml → models.registry
+ * for the active model. Options parameter can override for testing.
+ *
  * @param {number} promptCount - Number of prompts in current session
- * @param {Object} [options={}] - Configuration options
- * @param {number} [options.avgTokensPerPrompt=1500] - Average tokens per prompt
- * @param {number} [options.maxContext=200000] - Maximum context window size in tokens
+ * @param {Object} [options={}] - Configuration options (override config values)
+ * @param {number} [options.avgTokensPerPrompt] - Average tokens per prompt
+ * @param {number} [options.maxContext] - Maximum context window size in tokens
  * @returns {number} Percentage of context remaining (0.0 to 100.0)
  */
 function estimateContextPercent(promptCount, options = {}) {
+  const modelConfig = getModelConfig();
   const {
-    avgTokensPerPrompt = DEFAULTS.avgTokensPerPrompt,
-    maxContext = DEFAULTS.maxContext,
+    avgTokensPerPrompt = modelConfig.avgTokensPerPrompt,
+    maxContext = modelConfig.maxContext,
   } = options;
 
   if (typeof promptCount !== 'number' || isNaN(promptCount) || promptCount < 0) {
@@ -184,6 +267,19 @@ function needsMemoryHints(bracket) {
   return bracket === 'DEPLETED' || bracket === 'CRITICAL';
 }
 
+/**
+ * Reset the model config cache. Useful for tests or after config changes.
+ *
+ * @param {string|null} [basePath=null] - Optional project root override
+ */
+function resetModelConfigCache(basePath = null) {
+  if (basePath === null) {
+    _modelConfigCache.clear();
+    return;
+  }
+  _modelConfigCache.delete(resolveConfigRoot(basePath));
+}
+
 module.exports = {
   calculateBracket,
   estimateContextPercent,
@@ -191,6 +287,8 @@ module.exports = {
   getActiveLayers,
   needsHandoffWarning,
   needsMemoryHints,
+  getModelConfig,
+  resetModelConfigCache,
   BRACKETS,
   TOKEN_BUDGETS,
   DEFAULTS,

package/.aiox-core/core/synapse/layers/layer-processor.js

@@ -50,7 +50,7 @@ class LayerProcessor {
    * @param {object[]} context.previousLayers - Results from previous layers
    * @returns {{ rules: string[], metadata: object } | null} Rules and metadata, or null to skip
    */
-  process(context) {
+  process(_context) {
     throw new Error(`${this.name}: process() must be implemented by subclass`);
   }
 

package/.aiox-core/core-config.yaml

@@ -312,6 +312,7 @@ ideSync:
     claude-code:
       enabled: true
       path: .claude/commands/AIOX/agents
+      skillsPath: .claude/skills
       format: full-markdown-yaml
     codex:
       enabled: true
@@ -385,4 +386,17 @@ boundary:
     - .aiox-core/core/config/schemas/**
     - .aiox-core/core/config/template-overrides.js
 
-# Memory Intelligence System (Epic MIS) configuration placeholder — MIS-2+
+# Context-tracker dynamic model registry (Issue #605).
+# Consumed by .aiox-core/core/synapse/context/context-tracker.js.
+models:
+  active: claude-sonnet-4-6
+  registry:
+    claude-opus-4-6:
+      contextWindow: 1000000
+      avgTokensPerPrompt: 1500
+    claude-sonnet-4-6:
+      contextWindow: 200000
+      avgTokensPerPrompt: 1500
+    claude-haiku-4-5:
+      contextWindow: 200000
+      avgTokensPerPrompt: 1200

package/.aiox-core/data/capability-detection.js

@@ -31,13 +31,13 @@ function detectToolSearch() {
     return {
       available: features.tengu_mcp_tool_search === true,
       source: 'cachedGrowthBookFeatures.tengu_mcp_tool_search',
-      detectionMethod: 'claude-json-feature-flag'
+      detectionMethod: 'claude-json-feature-flag',
     };
   } catch {
     return {
       available: false,
       source: 'detection-failed',
-      detectionMethod: 'claude-json-feature-flag'
+      detectionMethod: 'claude-json-feature-flag',
     };
   }
 }
@@ -47,7 +47,7 @@ function detectDeferLoading() {
   return {
     available: false,
     reason: 'defer_loading is API-only (Python SDK). Not exposed in Claude Code CLI.',
-    source: 'ADR-7 / Codex CRITICO-1'
+    source: 'ADR-7 / Codex CRITICO-1',
   };
 }
 
@@ -60,7 +60,7 @@ function detectProjectMcps() {
       name,
       type: cfg.type || 'command',
       scope: 'project',
-      source: '.mcp.json'
+      source: '.mcp.json',
     }));
   } catch {
     return [];
@@ -83,7 +83,7 @@ function detectGlobalMcps() {
           name: match[1],
           type: 'docker-gateway',
           scope: 'global',
-          source: '~/.docker/mcp/config.yaml'
+          source: '~/.docker/mcp/config.yaml',
         });
       }
     }
@@ -103,7 +103,7 @@ function detectGlobalMcps() {
           name,
           type: cfg.type || 'command',
           scope: 'global-settings',
-          source: '~/.claude/settings.json'
+          source: '~/.claude/settings.json',
         });
       }
     }
@@ -121,7 +121,7 @@ function detectDockerGateway() {
   return {
     available: exists,
     configPath: exists ? dockerMcpDir : null,
-    detectionMethod: 'filesystem-check'
+    detectionMethod: 'filesystem-check',
   };
 }
 
@@ -180,7 +180,7 @@ function loadToolRegistry() {
       tier2Count: tier2,
       tier3Count: tier3,
       essential,
-      nonEssential
+      nonEssential,
     };
   } catch {
     return { available: false, totalTools: 0, tier1Count: 0, tier2Count: 0, tier3Count: 0, essential: [], nonEssential: [] };
@@ -197,7 +197,7 @@ function determineStrategy(toolSearch, deferLoading, dockerGateway) {
     return {
       primary: 'tool-search-auto',
       description: 'Claude Code Tool Search is active. Tier 3 MCP tools are automatically deferred via tool_search.',
-      fallbacks: ['mcp-discipline', 'claudemd-guidance']
+      fallbacks: ['mcp-discipline', 'claudemd-guidance'],
     };
   }
 
@@ -205,14 +205,14 @@ function determineStrategy(toolSearch, deferLoading, dockerGateway) {
     return {
       primary: 'mcp-discipline',
       description: 'Tool Search not available. Using MCP discipline: disable non-essential servers in .mcp.json.',
-      fallbacks: ['claudemd-guidance']
+      fallbacks: ['claudemd-guidance'],
     };
   }
 
   return {
     primary: 'claudemd-guidance',
     description: 'Neither Tool Search nor Docker Gateway available. Using CLAUDE.md guidance for tool selection priority.',
-    fallbacks: []
+    fallbacks: [],
   };
 }
 
@@ -236,20 +236,20 @@ function run() {
 
     methodology: {
       toolSearchLatency: 'Managed internally by Claude Code — not programmatically measurable. Guidance-level enforcement via CLAUDE.md.',
-      mcpCountUnit: 'servers (not individual tools). TOK-1.5 baseline uses tool count (e.g., Apify = 7 tools = 1 server).'
+      mcpCountUnit: 'servers (not individual tools). TOK-1.5 baseline uses tool count (e.g., Apify = 7 tools = 1 server).',
     },
 
     runtime: {
       toolSearch,
       deferLoading,
-      dockerGateway
+      dockerGateway,
     },
 
     mcpServers: {
       project: projectMcps,
       global: globalMcps,
       totalCount: projectMcps.length + globalMcps.length,
-      countUnit: 'servers'
+      countUnit: 'servers',
     },
 
     toolRegistry,
@@ -263,7 +263,7 @@ function run() {
 
     nonEssentialServers: toolRegistry.nonEssential.length > 0
       ? toolRegistry.nonEssential
-      : []
+      : [],
   };
 
   // Ensure output directory exists

package/.aiox-core/data/entity-registry.yaml

@@ -1,7 +1,7 @@
 metadata:
   version: 1.0.0
-  lastUpdated: '2026-03-11T00:48:55.982Z'
-  entityCount: 745
+  lastUpdated: '2026-05-07T00:08:59.095Z'
+  entityCount: 746
   checksumAlgorithm: sha256
   resolutionRate: 100
 entities:
@@ -12778,6 +12778,22 @@ entities:
         extensionPoints: []
       checksum: sha256:dd025894f8f0d3bd22a147dbc0debef8b83e96f3c59483653404b3cd5a01d5aa
       lastVerified: '2026-03-11T00:48:55.903Z'
+    pro-updater:
+      path: .aiox-core/core/pro/pro-updater.js
+      layer: L1
+      type: module
+      purpose: Entity at .aiox-core/core/pro/pro-updater.js
+      keywords:
+        - pro
+        - updater
+      usedBy: []
+      dependencies: []
+      adaptability:
+        score: 0.4
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:4fbdf590f1685d835fa5bef8e2307708ab1eeb49f5ea177d4f79c1629e35670a
+      lastVerified: '2026-05-07T00:08:58.904Z'
   agents:
     aiox-master:
       path: .aiox-core/development/agents/aiox-master.md

package/.aiox-core/data/registry-update-log.jsonl

@@ -0,0 +1,5 @@
+{"timestamp":"2026-05-06T18:32:31.287Z","action":"change","path":".aiox-core/development/scripts/unified-activation-pipeline.js","trigger":"watcher"}
+{"timestamp":"2026-05-07T00:04:12.320Z","action":"change","path":".aiox-core/core/pro/pro-updater.js","trigger":"watcher"}
+{"timestamp":"2026-05-07T00:05:09.664Z","action":"change","path":".aiox-core/core/pro/pro-updater.js","trigger":"watcher"}
+{"timestamp":"2026-05-07T00:05:54.694Z","action":"change","path":".aiox-core/core/pro/pro-updater.js","trigger":"watcher"}
+{"timestamp":"2026-05-07T00:08:58.920Z","action":"change","path":".aiox-core/core/pro/pro-updater.js","trigger":"watcher"}

package/.aiox-core/data/tok3-token-comparison.js

@@ -13,10 +13,6 @@
  * Reference: TOK-1.5 Baseline (docs/stories/epics/epic-token-optimization/story-TOK-1.5-baseline-metrics.md)
  */
 
-const fs = require('fs');
-const path = require('path');
-const yaml = require ? null : null; // yaml not required — we parse manually
-
 // --- Token estimation model ---
 // Based on tool-registry.yaml tokenCost and observed output patterns
 

package/.aiox-core/data/tool-search-validation.js

@@ -22,7 +22,7 @@ const TEST_QUERIES = [
   { query: 'analyze code dependencies', expectedTool: 'code-graph', category: 'code-intelligence' },
   { query: 'code analysis intelligence', expectedTool: 'nogic', category: 'code-intelligence' },
   { query: 'look up library documentation', expectedTool: 'context7', category: 'documentation' },
-  { query: 'database query optimization', expectedTool: 'supabase', category: 'database' }
+  { query: 'database query optimization', expectedTool: 'supabase', category: 'database' },
 ];
 
 function parseKeywords(content) {

package/.aiox-core/development/agents/aiox-master.md

@@ -116,100 +116,132 @@ persona:
 # All commands require * prefix when used (e.g., *help)
 commands:
   - name: help
+    visibility: [full, quick, key]
     description: 'Show all available commands with descriptions'
   - name: kb
+    visibility: [full, quick, key]
     description: 'Toggle KB mode (loads AIOX Method knowledge)'
   - name: status
+    visibility: [full, quick, key]
     description: 'Show current context and progress'
   - name: guide
+    visibility: [full, quick, key]
     description: 'Show comprehensive usage guide for this agent'
   - name: yolo
     visibility: [full]
     description: 'Toggle permission mode (cycle: ask > auto > explore)'
   - name: exit
+    visibility: [full]
     description: 'Exit agent mode'
   - name: create
+    visibility: [full, quick, key]
     description: 'Create new AIOX component (agent, task, workflow, template, checklist)'
   - name: modify
+    visibility: [full, quick, key]
     description: 'Modify existing AIOX component'
   - name: update-manifest
+    visibility: [full]
     description: 'Update team manifest'
   - name: validate-component
+    visibility: [full]
     description: 'Validate component security and standards'
   - name: deprecate-component
+    visibility: [full]
     description: 'Deprecate component with migration path'
   - name: propose-modification
+    visibility: [full]
     description: 'Propose framework modifications'
   - name: undo-last
+    visibility: [full]
     description: 'Undo last framework modification'
   - name: validate-workflow
     args: '{name|path} [--strict] [--all]'
     description: 'Validate workflow YAML structure, agents, artifacts, and logic'
-    visibility: full
+    visibility: [full]
   - name: run-workflow
     args: '{name} [start|continue|status|skip|abort] [--mode=guided|engine]'
     description: 'Workflow execution: guided (persona-switch) or engine (real subagent spawning)'
-    visibility: full
+    visibility: [full]
   - name: analyze-framework
+    visibility: [full]
     description: 'Analyze framework structure and patterns'
   - name: list-components
+    visibility: [full]
     description: 'List all framework components'
   - name: test-memory
+    visibility: [full]
     description: 'Test memory layer connection'
   - name: task
+    visibility: [full, quick, key]
     description: 'Execute specific task (or list available)'
   - name: execute-checklist
     args: '{checklist}'
+    visibility: [full]
     description: 'Run checklist (or list available)'
 
   # Workflow & Planning (Consolidated - Story 6.1.2.3)
   - name: workflow
     args: '{name} [--mode=guided|engine]'
+    visibility: [full, quick, key]
     description: 'Start workflow (guided=manual, engine=real subagent spawning)'
   - name: plan
     args: '[create|status|update] [id]'
+    visibility: [full, quick, key]
     description: 'Workflow planning (default: create)'
 
   # Document Operations
   - name: create-doc
     args: '{template}'
+    visibility: [full]
     description: 'Create document (or list templates)'
   - name: doc-out
+    visibility: [full]
     description: 'Output complete document'
   - name: shard-doc
     args: '{document} {destination}'
+    visibility: [full]
     description: 'Break document into parts'
   - name: document-project
+    visibility: [full]
     description: 'Generate project documentation'
   - name: add-tech-doc
     args: '{file-path} [preset-name]'
+    visibility: [full]
     description: 'Create tech-preset from documentation file'
 
   # Story Creation
   - name: create-next-story
+    visibility: [full]
     description: 'Create next user story'
   # NOTE: Epic/story creation delegated to @pm (brownfield-create-epic/story)
 
   # Facilitation
   - name: advanced-elicitation
+    visibility: [full]
     description: 'Execute advanced elicitation'
   - name: chat-mode
+    visibility: [full]
     description: 'Start conversational assistance'
   # NOTE: Brainstorming delegated to @analyst (*brainstorm)
 
   # Utilities
   - name: agent
     args: '{name}'
+    visibility: [full]
     description: 'Get info about specialized agent (use @ to transform)'
 
   # Tools
   - name: validate-agents
+    visibility: [full]
     description: 'Validate all agent definitions (YAML parse, required fields, dependencies, pipeline reference)'
   - name: correct-course
+    visibility: [full]
     description: 'Analyze and correct process/quality deviations'
   - name: index-docs
+    visibility: [full]
     description: 'Index documentation for search'
   - name: update-source-tree
+    visibility: [full]
     description: 'Validate data file governance (owners, fill rules, existence)'
   # NOTE: Test suite creation delegated to @qa (*create-suite)
   # NOTE: AI prompt generation delegated to @architect (*generate-ai-prompt)
@@ -217,21 +249,27 @@ commands:
   # IDS — Incremental Development System (Story IDS-7)
   - name: ids check
     args: '{intent} [--type {type}]'
+    visibility: [full]
     description: 'Pre-check registry for REUSE/ADAPT/CREATE recommendations (advisory)'
   - name: ids impact
     args: '{entity-id}'
+    visibility: [full]
     description: 'Impact analysis — direct/indirect consumers via usedBy BFS traversal'
   - name: ids register
     args: '{file-path} [--type {type}] [--agent {agent}]'
+    visibility: [full]
     description: 'Register new entity in registry after creation'
   - name: ids health
+    visibility: [full]
     description: 'Registry health check (graceful fallback if RegistryHealer unavailable)'
   - name: ids stats
+    visibility: [full]
     description: 'Registry statistics (entity count by type, categories, health score)'
 
   # Code Intelligence — Registry Enrichment (Story NOG-2)
   - name: sync-registry-intel
     args: '[--full]'
+    visibility: [full]
     description: 'Enrich entity registry with code intelligence data (usedBy, dependencies, codeIntelMetadata). Use --full to force full resync.'
 
 # IDS Pre-Action Hooks (Story IDS-7)
@@ -403,9 +441,9 @@ Type `*help` to see all commands, or `*kb` to enable KB mode.
 **Delegated responsibilities (Story 6.1.2.3):**
 
 - **Epic/Story creation** → @pm (*create-epic, *create-story)
-- **Brainstorming** → @analyst (\*brainstorm)
-- **Test suite creation** → @qa (\*create-suite)
-- **AI prompt generation** → @architect (\*generate-ai-prompt)
+- **Brainstorming** → @analyst (`*brainstorm`)
+- **Test suite creation** → @qa (`*create-suite`)
+- **AI prompt generation** → @architect (`*generate-ai-prompt`)
 
 **When to use specialized agents:**
 
@@ -440,7 +478,7 @@ Type `*help` to see all commands, or `*kb` to enable KB mode.
 
 ### Typical Workflow
 
-1. **Framework dev** → `*create-agent`, `*create-task`, `*create-workflow`
+1. **Framework dev** → `*create agent`, `*create task`, `*create workflow`
 2. **IDS check** → Before creating, `*ids check {intent}` checks for existing artifacts
 3. **Task execution** → `*task {task}` to run any task directly
 4. **Workflow** → `*workflow {name}` for multi-step processes

package/.aiox-core/development/agents/data-engineer.md

@@ -13,7 +13,7 @@ IDE-FILE-RESOLUTION:
   - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
   - Example: create-doc.md → .aiox-core/development/tasks/create-doc.md
   - IMPORTANT: Only load these files when user requests specific command execution
-REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "design schema"→create-schema, "run migration"→apply-migration, "check security"→rls-audit), ALWAYS ask for clarification if no clear match.
+REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "design schema"→create-schema, "run migration"→apply-migration, "check security"→security-audit), ALWAYS ask for clarification if no clear match.
 activation-instructions:
   - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
   - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
@@ -30,7 +30,7 @@ activation-instructions:
          - Append: "Story: {active story from docs/stories/}" if detected + "Branch: `{branch from gitStatus}`" if not main/master
       3. Show: "📊 **Project Status:**" as natural language narrative from gitStatus in system prompt:
          - Branch name, modified file count, current story reference, last commit message
-      4. Show: "**Available Commands:**" — list commands from the 'commands' section above that have 'key' in their visibility array
+      4. Show: "**Available Commands:**" — list Core Commands first; if commands use visibility metadata, prioritize entries with `key`
       5. Show: "Type `*guide` for comprehensive usage instructions."
       5.5. Check `.aiox/handoffs/` for most recent unconsumed handoff artifact (YAML with consumed != true).
            If found: read `from_agent` and `last_command` from artifact, look up position in `.aiox-core/data/workflow-chains.yaml` matching from_agent + last_command, and show: "💡 **Suggested:** `*{next_command} {args}`"
@@ -259,8 +259,8 @@ usage_tips:
   - 'Before any migration: `*snapshot baseline` to create rollback point'
   - 'Test migrations: `*dry-run path/to/migration.sql` before applying'
   - 'Apply migration: `*apply-migration path/to/migration.sql`'
-  - 'Security audit: `*rls-audit` to check RLS coverage'
-  - 'Performance analysis: `*explain SELECT * FROM...` or `*analyze-hotpaths`'
+  - 'Security audit: `*security-audit rls` to check RLS coverage'
+  - 'Performance analysis: `*analyze-performance query SELECT * FROM...` or `*analyze-performance hotpaths`'
   - 'Bootstrap new project: `*bootstrap` to create supabase/ structure'
 
 coderabbit_integration: