aios-core 4.0.2 → 4.1.0

package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.2-SUMMARY.md

@@ -9,14 +9,14 @@
 
 ## 🎯 PURPOSE OF THIS DOCUMENT
 
-This is a **delta document** highlighting **ONLY what changed in v2.2** compared to v2.1.
+This is a **delta document** highlighting **ONLY what changed in v2.2** compared to v4.0.4.
 
 For complete content:
 - ✅ **`AIOS-LIVRO-DE-OURO.md`** (v2.0 base)
-- ✅ **`AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md`** (v2.1 changes)
+- ✅ **`AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md`** (v4.0.4 changes)
 - ✅ **This document** (v2.2 changes ONLY)
 
-**Combined reading:** v2.0 base + v2.1 delta + v2.2 delta = Complete v2.2 understanding
+**Combined reading:** v2.0 base + v4.0.4 delta + v2.2 delta = Complete v2.2 understanding
 
 ---
 
@@ -24,7 +24,7 @@ For complete content:
 
 ### Memory Layer (The Game Changer)
 
-**v2.1:** Stateless agents (each execution isolated)  
+**v4.0.4:** Stateless agents (each execution isolated)  
 **v2.2:** Agents remember, learn, and improve
 
 ```yaml
@@ -59,7 +59,7 @@ Memory Types:
 
 ### Agent Lightning (RL Optimization)
 
-**v2.1:** Static workflows  
+**v4.0.4:** Static workflows  
 **v2.2:** Self-optimizing workflows
 
 ```yaml
@@ -96,7 +96,7 @@ Result:
 
 ### Advanced Features Matrix
 
-| Feature | v2.1 | v2.2 | Impact |
+| Feature | v4.0.4 | v2.2 | Impact |
 |---------|------|------|--------|
 | **Memory Layer** | ❌ Stateless | ✅ 4 memory types | Agents learn |
 | **Agent Lightning** | ❌ Static | ✅ RL optimization | 30% faster, 40% cheaper |
@@ -110,7 +110,7 @@ Result:
 
 ## 🧠 DEEP DIVE: Memory Layer
 
-### The Problem (v2.1)
+### The Problem (v4.0.4)
 
 ```yaml
 Scenario: Developer asks Dex (Dev Agent) to implement feature
@@ -298,10 +298,10 @@ Example:
 
 ## ⚡ DEEP DIVE: Agent Lightning
 
-### The Problem (v2.1)
+### The Problem (v4.0.4)
 
 ```yaml
-Static Workflow (v2.1):
+Static Workflow (v4.0.4):
   1. Developer creates story
   2. Dex implements (5 min)
   3. Quinn tests (3 min)
@@ -419,7 +419,7 @@ Result:
 
 ### Impact Metrics
 
-**Before Agent Lightning (v2.1):**
+**Before Agent Lightning (v4.0.4):**
 ```yaml
 Average workflow time: 11 minutes
 Average cost per story: $0.50 (LLM calls)
@@ -441,7 +441,7 @@ Learning rate: 10% improvement per week
 
 ### Shared Context
 
-**v2.1:** Each developer's agents isolated  
+**v4.0.4:** Each developer's agents isolated  
 **v2.2:** Team-wide shared memory
 
 ```yaml
@@ -637,11 +637,11 @@ responsavel_type: Clone
 
 ---
 
-## 📊 COMPARATIVE METRICS: v2.1 vs. v2.2
+## 📊 COMPARATIVE METRICS: v4.0.4 vs. v2.2
 
 ### Development Speed
 
-| Metric | v2.1 | v2.2 | Improvement |
+| Metric | v4.0.4 | v2.2 | Improvement |
 |--------|------|------|-------------|
 | Simple task time | 11 min | 1 min | **91% faster** |
 | Complex task time | 11 min | 26 min | Appropriately slower |
@@ -650,7 +650,7 @@ responsavel_type: Clone
 
 ### Cost Efficiency
 
-| Metric | v2.1 | v2.2 | Improvement |
+| Metric | v4.0.4 | v2.2 | Improvement |
 |--------|------|------|-------------|
 | Avg cost per story | $0.50 | $0.30 | **40% cheaper** |
 | Wasted LLM calls | 30% | 5% | **83% reduction** |
@@ -658,7 +658,7 @@ responsavel_type: Clone
 
 ### Quality & Learning
 
-| Metric | v2.1 | v2.2 | Improvement |
+| Metric | v4.0.4 | v2.2 | Improvement |
 |--------|------|------|-------------|
 | Issue catch rate | 80% (3 layers) | 85% (learning) | **+5 percentage points** |
 | False positive rate | 15% | 8% | **47% reduction** |
@@ -667,7 +667,7 @@ responsavel_type: Clone
 
 ### Team Collaboration
 
-| Metric | v2.1 | v2.2 | Improvement |
+| Metric | v4.0.4 | v2.2 | Improvement |
 |--------|------|------|-------------|
 | Handoff delay | 30 min avg | 0 min | **100% elimination** |
 | Coordination overhead | 2h/day | 15min/day | **87% reduction** |
@@ -716,7 +716,7 @@ Features:
 
 ## 🎯 SUMMARY: Evolution Path
 
-### v2.0 → v2.1 (The Foundation)
+### v2.0 → v4.0.4 (The Foundation)
 
 **Focus:** Installation + Discovery + Architecture
 - ✅ 5-minute installation
@@ -729,7 +729,7 @@ Features:
 
 ---
 
-### v2.1 → v2.2 (The Intelligence)
+### v4.0.4 → v2.2 (The Intelligence)
 
 **Focus:** Memory + Learning + Collaboration
 - ✅ Memory Layer (4 types)
@@ -756,7 +756,7 @@ Features:
 
 ## 📖 WHERE TO GO FROM HERE
 
-### If You're on v2.1
+### If You're on v4.0.4
 
 1. ✅ Read this summary (done!)
 2. → Review [Memory Layer Architecture](#memory-layer)
@@ -782,7 +782,7 @@ Features:
 
 ---
 
-**Full v2.2 Documentation:** Combine v2.0 base + v2.1 delta + v2.2 delta
+**Full v2.2 Documentation:** Combine v2.0 base + v4.0.4 delta + v2.2 delta
 
 **Next Version:** v2.3 (Q3 2026) - Enterprise & Scale
 
@@ -988,7 +988,7 @@ Features:
 │   ├── research/
 │   ├── epics/
 │   ├── stories/
-│   │   ├── v2.1/                      # v2.1 stories (completed)
+│   │   ├── v4.0.4/                      # v4.0.4 stories (completed)
 │   │   ├── v2.2/                      # ⭐ v2.2 stories (in progress)
 │   │   │   ├── sprint-1/              # Memory Layer
 │   │   │   ├── sprint-2/              # Agent Lightning
@@ -1093,7 +1093,7 @@ Features:
 
 ---
 
-### Key Changes from v2.1 → v2.2
+### Key Changes from v4.0.4 → v2.2
 
 **1. Memory Layer:**
 ```
@@ -1192,7 +1192,7 @@ ENHANCED: .aios-core/core/validation/learning-feedback-loop.js
   - False positive reduction
   - Accuracy improvement over time
 
-Impact: 85% catch rate (vs. 80% in v2.1), 8% false positives (vs. 15%)
+Impact: 85% catch rate (vs. 80% in v4.0.4), 8% false positives (vs. 15%)
 ```
 
 **7. Local Development Environment:**
@@ -1221,7 +1221,7 @@ Impact: Never lose institutional knowledge
 
 ### Storage Requirements Comparison
 
-| Component | v2.1 | v2.2 | Additional Storage |
+| Component | v4.0.4 | v2.2 | Additional Storage |
 |-----------|------|------|-------------------|
 | Base Framework | ~50MB | ~50MB | 0MB |
 | Workers | ~5MB | ~5MB | 0MB |
@@ -1237,7 +1237,7 @@ Impact: Never lose institutional knowledge
 
 ### Performance Comparison
 
-| Metric | v2.1 | v2.2 | Improvement |
+| Metric | v4.0.4 | v2.2 | Improvement |
 |--------|------|------|-------------|
 | Simple task time | 1 min | 30s | **50% faster** |
 | Complex task time | 26 min | 22 min | **15% faster** |

package/.aios-core/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md

@@ -3,7 +3,7 @@
 **Version:** 2.1.0
 **Date:** 2025-12-09
 **Purpose:** Document differences between AIOS open-source and AIOS service implementations
-**Status:** ⚠️ Needs Review - Updated for v2.1 Multi-Repo Strategy
+**Status:** ⚠️ Needs Review - Updated for v4.0.4 Multi-Repo Strategy
 
 ---
 
@@ -17,7 +17,7 @@ This document clarifies which features apply to which context.
 
 ---
 
-## Multi-Repo Strategy (v2.1)
+## Multi-Repo Strategy (v4.0.4)
 
 ### Repository Organization
 
@@ -489,7 +489,7 @@ function validateTask(task) {
 
 ## Related Documents
 
-- [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) - Complete v2.1 framework guide
+- [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) - Complete v4.0.4 framework guide
 - [STANDARDS-INDEX.md](./STANDARDS-INDEX.md) - Standards navigation
 - [TASK-FORMAT-SPECIFICATION-V1.md](./TASK-FORMAT-SPECIFICATION-V1.md) - Complete task format spec
 - [AGENT-PERSONALIZATION-STANDARD-V1.md](./AGENT-PERSONALIZATION-STANDARD-V1.md) - Personality guidelines
@@ -508,4 +508,4 @@ function validateTask(task) {
 
 **Last Updated:** 2025-12-09
 **Version:** 2.1.0
-**Applies to:** AIOS v2.1+
+**Applies to:** AIOS v4.0.4+

package/.aios-core/docs/standards/QUALITY-GATES-SPECIFICATION.md

@@ -1,4 +1,4 @@
-# Quality Gates Specification v2.1
+# Quality Gates Specification v4.0.4
 
 **Version:** 2.1.0
 **Last Updated:** 2025-12-09
@@ -481,7 +481,7 @@ reviews:
         Verify:
         - Terminology uses 'Squad' not 'Expansion Pack'
         - All internal links work
-        - Version numbers are v2.1
+        - Version numbers are v4.0.4
 
     - path: "squads/**"
       instructions: |
@@ -512,7 +512,7 @@ reviews:
 | Issues escaping to production | ~15% |
 | Developer context switches | High |
 
-### After Quality Gates (v2.1)
+### After Quality Gates (v4.0.4)
 
 | Metric | Value | Improvement |
 |--------|-------|-------------|

package/.aios-core/docs/standards/STANDARDS-INDEX.md

@@ -16,18 +16,18 @@
 
 ### For Existing Users
 
-- **v2.0 → v2.1 Migration:** See "What's New" section in [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md)
+- **v2.0 → v4.0.4 Migration:** See "What's New" section in [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md)
 - **Architecture Changes:** Review [ARCHITECTURE-INDEX.md](../../docs/architecture/ARCHITECTURE-INDEX.md)
 
 ---
 
 ## 📚 Standards by Category
 
-### Core Framework Standards (Current v2.1)
+### Core Framework Standards (Current v4.0.4)
 
 | Document | Description | Status | Version |
 |----------|-------------|--------|---------|
-| [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) | **Complete v2.1 framework guide** | ✅ Current | 2.1.0 |
+| [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) | **Complete v4.0.4 framework guide** | ✅ Current | 2.1.0 |
 | [QUALITY-GATES-SPECIFICATION.md](./QUALITY-GATES-SPECIFICATION.md) | 3-layer quality gates system | ✅ Current | 2.1.0 |
 | [STORY-TEMPLATE-V2-SPECIFICATION.md](./STORY-TEMPLATE-V2-SPECIFICATION.md) | Story template v2.0 specification | ✅ Current | 2.0.0 |
 | [TASK-FORMAT-SPECIFICATION-V1.md](./TASK-FORMAT-SPECIFICATION-V1.md) | Task-First architecture format | ✅ Current | 1.0.0 |
@@ -52,21 +52,21 @@
 | Document | Description | Status | Superseded By |
 |----------|-------------|--------|---------------|
 | [AIOS-LIVRO-DE-OURO.md](./AIOS-LIVRO-DE-OURO.md) | v2.0.0 base document | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
-| [AIOS-LIVRO-DE-OURO-V2.1.md](./AIOS-LIVRO-DE-OURO-V2.1.md) | v2.1 delta (partial) | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
-| [AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md](./AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md) | v2.1 summary | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
+| [AIOS-LIVRO-DE-OURO-V2.1.md](./AIOS-LIVRO-DE-OURO-V2.1.md) | v4.0.4 delta (partial) | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
+| [AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md](./AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md) | v4.0.4 summary | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
 | [AIOS-LIVRO-DE-OURO-V2.2-SUMMARY.md](./AIOS-LIVRO-DE-OURO-V2.2-SUMMARY.md) | Future v2.2 planning | 📋 Draft | N/A |
 | [AIOS-FRAMEWORK-MASTER.md](./AIOS-FRAMEWORK-MASTER.md) | v2.0.0 framework doc | ⚠️ Deprecated | AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md |
 | [V3-ARCHITECTURAL-DECISIONS.md](./V3-ARCHITECTURAL-DECISIONS.md) | Old architectural decisions | 📦 Archive Candidate | Current architecture docs |
 
 ---
 
-## 🔄 What Changed in v2.1
+## 🔄 What Changed in v4.0.4
 
 ### New Documents Created
 
 | Document | Purpose |
 |----------|---------|
-| AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md | Consolidated v2.1 documentation |
+| AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md | Consolidated v4.0.4 documentation |
 | QUALITY-GATES-SPECIFICATION.md | 3-layer quality gates |
 | STORY-TEMPLATE-V2-SPECIFICATION.md | Story template v2.0 |
 | STANDARDS-INDEX.md | This navigation document |
@@ -101,8 +101,8 @@
 .aios-core/docs/standards/
 ├── STANDARDS-INDEX.md                     # This file - navigation
 │
-├── Current v2.1 Standards
-│   ├── AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md  # Complete v2.1 guide
+├── Current v4.0.4 Standards
+│   ├── AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md  # Complete v4.0.4 guide
 │   ├── QUALITY-GATES-SPECIFICATION.md       # Quality gates
 │   ├── STORY-TEMPLATE-V2-SPECIFICATION.md   # Story template
 │   ├── TASK-FORMAT-SPECIFICATION-V1.md      # Task format
@@ -113,8 +113,8 @@
 │
 ├── Legacy (Reference Only)
 │   ├── AIOS-LIVRO-DE-OURO.md              # v2.0.0 base (deprecated)
-│   ├── AIOS-LIVRO-DE-OURO-V2.1.md         # v2.1 delta (deprecated)
-│   ├── AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md # v2.1 summary (deprecated)
+│   ├── AIOS-LIVRO-DE-OURO-V2.1.md         # v4.0.4 delta (deprecated)
+│   ├── AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md # v4.0.4 summary (deprecated)
 │   ├── AIOS-FRAMEWORK-MASTER.md           # v2.0.0 (deprecated)
 │   └── V3-ARCHITECTURAL-DECISIONS.md      # Archive candidate
 │
@@ -156,7 +156,7 @@ Located in `docs/`:
 
 | Status | Meaning | Action |
 |--------|---------|--------|
-| ✅ Current | Up-to-date with v2.1 | Use as reference |
+| ✅ Current | Up-to-date with v4.0.4 | Use as reference |
 | ⚠️ Deprecated | Superseded by newer document | Refer to replacement |
 | ⚠️ Needs Update | Content outdated | Update planned |
 | 📦 Archive Candidate | Should be archived | Move to _archived/ |
@@ -201,7 +201,7 @@ grep -r "v2.0" .aios-core/docs/standards --include="*.md"
 
 | Date | Version | Changes | Author |
 |------|---------|---------|--------|
-| 2025-12-09 | 2.1.0 | Initial STANDARDS-INDEX creation for v2.1 | @dev (Dex) |
+| 2025-12-09 | 2.1.0 | Initial STANDARDS-INDEX creation for v4.0.4 | @dev (Dex) |
 
 ---
 

package/.aios-core/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md

@@ -476,7 +476,7 @@ Use this checklist when creating or reviewing stories:
 #### Terminology
 - [ ] Uses "Squad" not "Expansion Pack"
 - [ ] Uses "@aios/" npm scope
-- [ ] References v2.1 architecture
+- [ ] References v4.0.4 architecture
 
 ---
 

package/.aios-core/framework-config.yaml

@@ -123,6 +123,10 @@ ide_sync_system:
       enabled: true
       path: ".claude/commands/AIOS/agents"
       format: "full-markdown-yaml"
+    codex:
+      enabled: true
+      path: ".codex/agents"
+      format: "full-markdown-yaml"
     cursor:
       enabled: true
       path: ".cursor/rules/agents"

package/.aios-core/infrastructure/scripts/codex-skills-sync/index.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs-extra');
+const path = require('path');
+const os = require('os');
+
+const {
+  parseAllAgents,
+  normalizeCommands,
+  getVisibleCommands,
+} = require('../ide-sync/agent-parser');
+
+function getCodexHome() {
+  return process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
+}
+
+function getDefaultOptions() {
+  const projectRoot = process.cwd();
+  const envLocalDir = process.env.AIOS_CODEX_LOCAL_SKILLS_DIR;
+  const envGlobalDir = process.env.AIOS_CODEX_GLOBAL_SKILLS_DIR;
+  return {
+    projectRoot,
+    sourceDir: path.join(projectRoot, '.aios-core', 'development', 'agents'),
+    localSkillsDir: envLocalDir || path.join(projectRoot, '.codex', 'skills'),
+    globalSkillsDir: envGlobalDir || path.join(getCodexHome(), 'skills'),
+    global: false,
+    globalOnly: false,
+    dryRun: false,
+    quiet: false,
+  };
+}
+
+function trimText(text, max = 220) {
+  const normalized = String(text || '').replace(/\s+/g, ' ').trim();
+  if (normalized.length <= max) return normalized;
+  return `${normalized.slice(0, max - 3).trim()}...`;
+}
+
+function getSkillId(agentId) {
+  const id = String(agentId || '').trim();
+  if (id.startsWith('aios-')) return id;
+  return `aios-${id}`;
+}
+
+function buildSkillContent(agentData) {
+  const agent = agentData.agent || {};
+  const name = agent.name || agentData.id;
+  const title = agent.title || 'AIOS Agent';
+  const whenToUse = trimText(agent.whenToUse || `Use @${agentData.id} for specialized tasks.`);
+
+  const allCommands = normalizeCommands(agentData.commands || []);
+  const quick = getVisibleCommands(allCommands, 'quick');
+  const key = getVisibleCommands(allCommands, 'key');
+  const commands = [...quick, ...key.filter(k => !quick.some(q => q.name === k.name))]
+    .slice(0, 8)
+    .map(c => `- \`*${c.name}\` - ${c.description || 'No description'}`)
+    .join('\n');
+
+  const skillName = getSkillId(agentData.id);
+  const description = trimText(`${title} (${name}). ${whenToUse}`, 180);
+
+  return `---
+name: ${skillName}
+description: ${description}
+---
+
+# AIOS ${title} Activator
+
+## When To Use
+${whenToUse}
+
+## Activation Protocol
+1. Load \`.aios-core/development/agents/${agentData.filename}\` as source of truth (fallback: \`.codex/agents/${agentData.filename}\`).
+2. Adopt this agent persona and command system.
+3. Generate greeting via \`node .aios-core/development/scripts/generate-greeting.js ${agentData.id}\` and show it first.
+4. Stay in this persona until the user asks to switch or exit.
+
+## Starter Commands
+${commands || '- `*help` - List available commands'}
+
+## Non-Negotiables
+- Follow \`.aios-core/constitution.md\`.
+- Execute workflows/tasks only from declared dependencies.
+- Do not invent requirements outside the project artifacts.
+`;
+}
+
+function buildSkillPlan(agents, skillsDir) {
+  return agents
+    .filter(a => !a.error || a.error === 'YAML parse failed, using fallback extraction')
+    .map(agentData => {
+      const skillId = getSkillId(agentData.id);
+      const targetDir = path.join(skillsDir, skillId);
+      const targetFile = path.join(targetDir, 'SKILL.md');
+      return {
+        agentId: agentData.id,
+        skillId,
+        targetDir,
+        targetFile,
+        content: buildSkillContent(agentData),
+      };
+    });
+}
+
+function writeSkillPlan(plan, options) {
+  for (const item of plan) {
+    if (!options.dryRun) {
+      try {
+        fs.ensureDirSync(item.targetDir);
+        fs.writeFileSync(item.targetFile, item.content, 'utf8');
+      } catch (error) {
+        throw new Error(`Failed to write skill ${item.skillId} at ${item.targetFile}: ${error.message}`);
+      }
+    }
+  }
+}
+
+function syncSkills(options = {}) {
+  const resolved = { ...getDefaultOptions(), ...options };
+  if (resolved.globalOnly) {
+    resolved.global = true;
+  }
+  const agents = parseAllAgents(resolved.sourceDir);
+  const plan = buildSkillPlan(agents, resolved.localSkillsDir);
+
+  if (!resolved.globalOnly) {
+    writeSkillPlan(plan, resolved);
+  }
+
+  if (resolved.global) {
+    const globalPlan = buildSkillPlan(agents, resolved.globalSkillsDir);
+    writeSkillPlan(globalPlan, resolved);
+  }
+
+  return {
+    generated: plan.length,
+    localSkillsDir: resolved.localSkillsDir,
+    globalSkillsDir: resolved.global || resolved.globalOnly ? resolved.globalSkillsDir : null,
+    dryRun: resolved.dryRun,
+  };
+}
+
+function parseArgs(argv = process.argv.slice(2)) {
+  const args = new Set(argv);
+  return {
+    global: args.has('--global'),
+    globalOnly: args.has('--global-only'),
+    dryRun: args.has('--dry-run'),
+    quiet: args.has('--quiet') || args.has('-q'),
+  };
+}
+
+function main() {
+  const options = parseArgs();
+  const result = syncSkills(options);
+
+  if (!options.quiet) {
+    if (!options.globalOnly) {
+      console.log(`✅ Generated ${result.generated} Codex skills in ${result.localSkillsDir}`);
+    }
+    if (result.globalSkillsDir) {
+      console.log(`✅ Installed ${result.generated} Codex skills in ${result.globalSkillsDir}`);
+    }
+    if (result.dryRun) {
+      console.log('ℹ️ Dry-run mode: no files written');
+    }
+  }
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  buildSkillContent,
+  buildSkillPlan,
+  syncSkills,
+  parseArgs,
+  getCodexHome,
+  getSkillId,
+};