clckernel 1.2.6 → 1.2.9

package/src/adapters/agent-os.js

@@ -0,0 +1,206 @@
+/**
+ * CLC Kernel — Agent-OS & Domain Workflows Stack Adapter
+ * Supports AI Agent Operating Systems (Marketing OS, Content Ops, Research OS)
+ * featuring Dual-Layer Governance and Domain Integrity Safeguards.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const BaseAdapter = require('./base');
+
+class AgentOSAdapter extends BaseAdapter {
+  constructor() {
+    super('Agent-OS (Domain & AI Workflows)', 'agent-os', 'Playbook / Contract Test');
+  }
+
+  detect(targetDir) {
+    // 1. package.json check
+    const pkgPath = path.join(targetDir, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        const name = (pkg.name || '').toLowerCase();
+        const desc = (pkg.description || '').toLowerCase();
+        const keywords = Array.isArray(pkg.keywords) ? pkg.keywords.map(k => k.toLowerCase()) : [];
+        if (
+          name.includes('agent-os') || name.includes('marketing-os') || name.includes('laila-mos') ||
+          desc.includes('agent-os') || desc.includes('marketing operating system') ||
+          keywords.includes('agent-os') || keywords.includes('marketing-os') || keywords.includes('ai-agents')
+        ) {
+          return true;
+        }
+      } catch {}
+    }
+
+    // 2. skills/ or .agents/skills/ directory check
+    const skillsDir = path.join(targetDir, 'skills');
+    const agentSkillsDir = path.join(targetDir, '.agents', 'skills');
+    if (fs.existsSync(skillsDir) || fs.existsSync(agentSkillsDir)) {
+      const dirToCheck = fs.existsSync(skillsDir) ? skillsDir : agentSkillsDir;
+      try {
+        const files = fs.readdirSync(dirToCheck);
+        if (files.some(f => f.endsWith('.md'))) {
+          return true;
+        }
+      } catch {}
+    }
+
+    // 3. brand/ or templates/ check alongside README referencing agents/workflows
+    const brandPath = path.join(targetDir, 'brand');
+    const templatesPath = path.join(targetDir, 'templates');
+    const readmePath = path.join(targetDir, 'README.md');
+    if ((fs.existsSync(brandPath) || fs.existsSync(templatesPath)) && fs.existsSync(readmePath)) {
+      try {
+        const readme = fs.readFileSync(readmePath, 'utf-8').toLowerCase();
+        if (readme.includes('subagent') || readme.includes('operating system') || readme.includes('agent')) {
+          return true;
+        }
+      } catch {}
+    }
+
+    return false;
+  }
+
+  getSafeguards() {
+    return [
+      'Dual-Layer Architecture: Layer 1 (Engineering) & Layer 2 (Domain Runtime)',
+      'Mandatory Human-in-the-Loop (HITL) Checkpoints',
+      'Symlink Interoperability (.cursorrules, CLAUDE.md, GEMINI.md, .windsurfrules)',
+      'Domain Data Integrity & Clean Creation State (No Hallucinated Metrics)',
+      'Single Source of Truth (SSOT) Memory Primacy',
+      'Local-only Spec Driven Development (sdds/)'
+    ];
+  }
+
+  getTools() {
+    return [
+      {
+        name: 'check_symlinks',
+        language: 'node',
+        path: 'tools/check_symlinks.js',
+        command: 'node tools/check_symlinks.js',
+        description: 'AI IDE symlinks and rule mirror verification'
+      },
+      {
+        name: 'check_hitl',
+        language: 'node',
+        path: 'tools/check_hitl.js',
+        command: 'node tools/check_hitl.js',
+        description: 'Human-in-the-Loop review checkpoint validator'
+      },
+      {
+        name: 'check_domain_data',
+        language: 'node',
+        path: 'tools/check_domain_data.js',
+        command: 'node tools/check_domain_data.js',
+        description: 'Domain deliverables schema and clean state integrity'
+      },
+      {
+        name: 'check_test_calendar_sync',
+        language: 'node',
+        path: 'tools/check_test_calendar_sync.js',
+        command: 'node tools/check_test_calendar_sync.js',
+        description: 'Test calendar harness synchronization and parity check'
+      },
+      {
+        name: 'scan_secrets',
+        language: 'node',
+        path: 'tools/scan_secrets.js',
+        command: 'node tools/scan_secrets.js',
+        description: 'Security & API key leak scanner'
+      }
+    ];
+  }
+
+  provision(targetDir, config) {
+    // 1. Create docs/, sdds/, and tools/
+    super.provision(targetDir, config);
+
+    // 2. Write Dual-Layer AGENTS.md
+    const dualLayerAgents = `# Standard Operating Procedure (SOP) — AGENTS
+Governed by **CLC Kernel: The Universal AI Agent Governance Engine**.
+Target System: **${this.name}**
+
+---
+
+## 🛠️ Layer 1: Development & Maintenance Governance (Engineering)
+All AI Agents (Antigravity, OpenCode, Claude Code, Cursor, Windsurf, Copilot) developing or maintaining this codebase MUST adhere to strict engineering standards:
+
+> 🚨 **RULE #0: MANDATORY EXECUTION OVERRIDE RULE (UNBYPASSABLE)**
+> Even when the user issues a direct or urgent fix request ("fix this bug", "fix this error", "quick fix"):
+> YOU ARE STRICTLY FORBIDDEN from modifying source code or workflows directly without completing the full quality harness:
+> 1. **Research & Root Cause Analysis:** Investigate tracebacks and affected files before editing.
+> 2. **SDD Specification:** Document non-trivial changes in \`sdds/{change-name}/01-spec.md\` (gitignored).
+> 3. **Verification (Red Phase):** Write a failing test or contract validation first.
+> 4. **Clean Implementation (Green Phase):** Make tests pass maintaining strict layer isolation.
+> 5. **Mandatory Audit Gate:** Execute \`node tools/audit.js\` and output summary to stdout.
+
+### Engineering Rules
+1. **Conventional Commits Only**: Commits must use Conventional Commits (e.g. \`feat(...): ...\`, \`fix(...): ...\`). NEVER add \`Co-Authored-By\` or AI attribution.
+2. **Mirror Links Interoperability**: \`CLAUDE.md\`, \`GEMINI.md\`, \`.cursorrules\`, and \`.windsurfrules\` must remain valid symlinks to \`AGENTS.md\`.
+3. **No Superficial Symptom Patches**: Always address root causes.
+
+---
+
+## 🚀 Layer 2: Domain Runtime Directives (Agent Workflows & Operations)
+When operating as domain agents for end-users and non-technical operators:
+
+1. **Non-Technical Operator Friendly**: Interact naturally with the operator. Guide step-by-step through conversational prompts without technical jargon.
+2. **Mandatory Human-in-the-Loop (HITL) Checkpoints**: Always pause phase-by-phase during multi-step pipelines. Present draft output and WAIT for explicit user confirmation before executing irreversible steps.
+3. **SSOT Memory Primacy**: Always read from and persist to designated single-source-of-truth memory files (e.g. \`brand/client-profile.md\` or \`docs/\`).
+4. **Clean Creation State (No Hallucinated Data)**: When new records, calendars, or deliverables are drafted, metric fields must initialize as \`null\` / empty. Never invent fictional stats.
+5. **Deterministic Output Standard**: Outputs must strictly follow valid Markdown, JSON schema, or domain templates.
+
+---
+
+## 🎮 Universal Command Interface (All LLMs & Agents)
+When given a command matching \`clckernel <action>\` or \`/clckernel <action>\`, execute the deterministic state machine below:
+
+| Command | Lifecycle Phase | Mandatory Execution Protocol |
+|---|---|---|
+| \`clckernel feature <name>\` | New Feature | 1. Research affected layers.<br>2. Author local spec in \`sdds/{name}/spec.md\`.<br>3. Present HIT review to user and wait for approval.<br>4. Write failing test (Red Phase).<br>5. Implement clean code (Green Phase).<br>6. Run \`node tools/audit.js\` (or \`audit.py\`). |
+| \`clckernel fix <issue>\` | Bug Fix | 1. Investigate root cause (no code edits).<br>2. Reproduce with failing test (Red Phase).<br>3. Minimal surgical fix respecting Clean Arch (Green Phase).<br>4. Run audit gate without skipping. |
+| \`clckernel test\` | Verification | Run test suite and verify clean pass (exit code 0). |
+| \`clckernel audit\` | Verification | Run \`node tools/audit.js\` or \`python tools/audit.py\` and output the Educational Summary. |
+| \`clckernel doctor\` | Diagnostics | Check git pre-commit hooks, IDE symlinks, and AST engine integrity. |
+| \`clckernel commit <message>\` | Version Control | Run full audit, verify tests pass, ensure no changes outside SDD scope, and commit with conventional commits (never add AI attribution). |
+| \`clckernel guard create <name>\` | Safeguards | Scaffold a new AST guard in the stack's native language in \`tools/guards/\`. |
+| \`clckernel start\` | Setup | Scan codebase, propose governance plan, and materialize \`.clckernel.yaml\`. |
+
+---
+
+## 🛡️ Core AI Safeguards
+${this.getSafeguards().map(s => `- ${s}`).join('\n')}
+`;
+
+    fs.writeFileSync(path.join(targetDir, 'AGENTS.md'), dualLayerAgents, 'utf-8');
+
+    // 3. Create AI IDE mirror symlinks
+    const mirrors = ['CLAUDE.md', 'GEMINI.md', '.cursorrules', '.windsurfrules'];
+    for (const mirror of mirrors) {
+      const mirrorPath = path.join(targetDir, mirror);
+      try {
+        if (!fs.existsSync(mirrorPath)) {
+          fs.symlinkSync('AGENTS.md', mirrorPath);
+        }
+      } catch {}
+    }
+
+    // 4. Copy domain guard tools into tools/
+    const srcToolsDir = path.join(__dirname, '..', '..', 'tools');
+    const targetToolsDir = path.join(targetDir, 'tools');
+    const toolsToCopy = ['check_symlinks.js', 'check_hitl.js', 'check_domain_data.js', 'scan_secrets.js', 'audit.js'];
+
+    for (const toolFile of toolsToCopy) {
+      const srcFile = path.join(srcToolsDir, toolFile);
+      const destFile = path.join(targetToolsDir, toolFile);
+      if (fs.existsSync(srcFile) && !fs.existsSync(destFile)) {
+        try {
+          fs.copyFileSync(srcFile, destFile);
+        } catch {}
+      }
+    }
+  }
+}
+
+module.exports = AgentOSAdapter;

package/src/catalog.js

@@ -110,6 +110,21 @@ const SAFEGUARD_CATALOG = [
     applies_when: 'docker', severity: 'error', gate_mode: 'hard', config_keys: ['scope', 'exclude_paths'],
     phase: 'audit', file: 'docker_guard.py', manifest: true, planned: false },
 
+  { name: 'check_symlinks', labels: ['check_symlinks', 'check_symlinks.js'],
+    checks: 'AI IDE symlinks and rule mirror verification', verify: ['verify_symlinks', 'verify_rule_mirrors'],
+    applies_when: 'agent-os', severity: 'error', gate_mode: 'hard', config_keys: ['scope'],
+    phase: 'audit', file: 'check_symlinks.js', manifest: true, planned: false },
+
+  { name: 'check_hitl', labels: ['check_hitl', 'check_hitl.js'],
+    checks: 'Human-in-the-Loop review checkpoint validator in subagent skills', verify: ['verify_hitl', 'verify_human_review_checkpoints'],
+    applies_when: 'agent-os', severity: 'error', gate_mode: 'hard', config_keys: ['scope'],
+    phase: 'audit', file: 'check_hitl.js', manifest: true, planned: false },
+
+  { name: 'check_domain_data', labels: ['check_domain_data', 'check_domain_data.js'],
+    checks: 'Domain deliverables schema and clean state integrity', verify: ['verify_domain_data', 'verify_clean_state_metrics'],
+    applies_when: 'agent-os', severity: 'error', gate_mode: 'hard', config_keys: ['scope'],
+    phase: 'audit', file: 'check_domain_data.js', manifest: true, planned: false },
+
   { name: 'ruff', labels: ['ruff'],
     checks: 'Python AST linter (external CLI)', verify: ['verify_python_lint'],
     applies_when: 'backend', severity: 'warning', gate_mode: 'advisory', config_keys: [],
@@ -172,6 +187,7 @@ const VALID_PHASES = ['audit', 'test', 'review', 'handover'];
 const VALID_APPLIES_WHEN = [
   'always', 'frontend', 'backend', 'fastapi', 'django', 'django|sqlalchemy',
   'celery', 'redis', 'postgresql', 'docker', 'frontend,backend', 'backend,fastapi,django',
+  'agent-os',
 ];
 
 /** Normalize an input label for catalog lookup. */

package/src/detector.js

@@ -15,9 +15,11 @@ const RailsAdapter = require('./adapters/rails');
 const GoAdapter = require('./adapters/go');
 const RustAdapter = require('./adapters/rust');
 const LaravelAdapter = require('./adapters/laravel');
+const AgentOSAdapter = require('./adapters/agent-os');
 const { TechnologyDetector } = require('./technologies/detector');
 
 const adapters = [
+  new AgentOSAdapter(),
   new NextjsAdapter(),
   new FastApiAdapter(),
   new DjangoAdapter(),

package/src/generator.js

@@ -325,6 +325,20 @@ ${isFront ? `- UI Component Reuse First (components/ui/ & semantic tokens)
 - Database Efficiency & N+1 Performance Guard
 - Database Migration Idempotency Guard
 - Memory Guard (Engram / Graphify)`}
+
+## 3. Universal Command Interface (All LLMs & Agents)
+When given a command matching \`clckernel <action>\` or \`/clckernel <action>\`, execute the deterministic state machine below:
+
+| Command | Lifecycle Phase | Mandatory Execution Protocol |
+|---|---|---|
+| \`clckernel feature <name>\` | New Feature | 1. Research affected layers.<br>2. Author local spec in \`sdds/{name}/spec.md\`.<br>3. Present HIT review to user and wait for approval.<br>4. Write failing test (Red Phase).<br>5. Implement clean code (Green Phase).<br>6. Run \`node tools/audit.js\` (or \`audit.py\`). |
+| \`clckernel fix <issue>\` | Bug Fix | 1. Investigate root cause (no code edits).<br>2. Reproduce with failing test (Red Phase).<br>3. Minimal surgical fix respecting Clean Arch (Green Phase).<br>4. Run audit gate without skipping. |
+| \`clckernel test\` | Verification | Run test suite (\`${config.testRunner || 'npm test'}\`) and verify clean pass (exit code 0). |
+| \`clckernel audit\` | Verification | Run \`node tools/audit.js\` or \`python tools/audit.py\` and output the Educational Summary. |
+| \`clckernel doctor\` | Diagnostics | Check git pre-commit hooks, IDE symlinks, and AST engine integrity. |
+| \`clckernel commit <message>\` | Version Control | Run full audit, verify tests pass, ensure no changes outside SDD scope, and commit with conventional commits (never add AI attribution). |
+| \`clckernel guard create <name>\` | Safeguards | Scaffold a new AST guard in the stack's native language in \`tools/guards/\`. |
+| \`clckernel start\` | Setup | Scan codebase, propose governance plan, and materialize \`.clckernel.yaml\`. |
 `;
     fs.writeFileSync(path.join(targetDir, 'AGENTS.md'), agentsContent, 'utf-8');
   }
@@ -372,68 +386,31 @@ function installAgenticCLI(targetDir) {
   // 1. Crear el Directorio de Skills
   const skillDir = path.join(targetDir, '.agents', 'skills', 'clckernel_cli');
   const legacySkillDir = path.join(targetDir, '.agents', 'skills', 'clc_forge_cli');
-  fs.mkdirSync(skillDir, { recursive: true });
-  fs.mkdirSync(legacySkillDir, { recursive: true });
-
-  // 2. Inyectar el SKILL.md Maestro
-  const skillContent = `---
-name: clckernel_cli
-description: Conversational CLI Orchestrator for the CLC Kernel AI Agent Governance Engine.
-triggers:
-  - clckernel start
-  - clckernel create_guard
-  - clckernel remove_guard
-  - clckernel add_phase
-  - clckernel remove_phase
-  - clc_forge start
-  - clc_forge create_guard
----
-
-# 🤖 CLC Kernel — Conversational CLI
-
-You are the internal runtime engine of CLC Kernel (AIUP Orchestrator). 
-DO NOT suggest terminal bash commands for these triggers; YOU are the execution environment. Your job is to guide the user through the agent governance lifecycle via chat, dynamically discovering the environment, and manipulating configuration files.
-
-## 🚀 INTENT: \`clckernel start\` (or \`clc_forge start\`)
-Execute this exact sequence without skipping steps:
-
-### Phase 1: Silent Discovery
-Scan the current project using your file-reading capabilities. Identify the primary tech stack by looking for signature files (e.g., \`package.json\`, \`Gemfile\`, \`Cargo.toml\`, \`go.mod\`). 
-*Golden Rule: Do not assume the language. Read the files to establish context.*
-
-### Phase 2: Interview & Proposal
-Introduce yourself as CLC Kernel and state the detected stack.
-Propose a standard governance plan for that ecosystem (SDD + TDD + stack-specific Safeguards).
-ASK the user directly: 
-1. "Should we activate these standard phases, or do you want to define custom ones?"
-2. "Do you have any specific security needs that require a custom Guard?"
-**STOP.** Wait for the user's response.
-
-### Phase 3: Materialization
-Based on user approval, generate and write the \`.clckernel.yaml\` file in the project root.
-
----
-
-## 🛠️ INTENT: \`clckernel create_guard\`
-1. Ask the user what behavior they want to audit or block. **STOP.** Wait for technical details.
-2. Based on the detected stack, write the linter/guard script in the **NATIVE ECOSYSTEM LANGUAGE** (Ruby for Rails, Go \`ast\` for Golang, Python \`ast\` for FastAPI, JS for Node). Save it in \`tools/guards/\`.
-3. Update the \`.clckernel.yaml\` file to include the new Guard.
-
----
-
-## 🗑️ INTENT: \`clckernel remove_guard\`
-1. Ask which guard to remove and if the script should be deleted. **STOP.** Wait for response.
-2. Update \`.clckernel.yaml\` and delete the script from \`tools/guards/\` if requested.
-
----
-
-## 🔄 INTENT: \`clckernel add_phase\` / \`clckernel remove_phase\`
-1. Ask for details of the lifecycle phase to add or remove. **STOP.** Wait for response.
-2. Update the \`execution_phases\` block in \`.clckernel.yaml\`, preserving the logical sequence.
-`;
-  
-  fs.writeFileSync(path.join(skillDir, 'SKILL.md'), skillContent, 'utf-8');
-  fs.writeFileSync(path.join(legacySkillDir, 'SKILL.md'), skillContent, 'utf-8');
+  const skillRefDir = path.join(skillDir, 'reference');
+  const legacySkillRefDir = path.join(legacySkillDir, 'reference');
+  fs.mkdirSync(skillRefDir, { recursive: true });
+  fs.mkdirSync(legacySkillRefDir, { recursive: true });
+
+  // 2. Inyectar el SKILL.md Maestro y Playbooks de Referencia
+  const bundledSkillDir = path.join(__dirname, '..', '.agents', 'skills', 'clckernel_cli');
+  const bundledSkillFile = path.join(bundledSkillDir, 'SKILL.md');
+  const bundledRefDir = path.join(bundledSkillDir, 'reference');
+
+  if (fs.existsSync(bundledSkillFile)) {
+    fs.copyFileSync(bundledSkillFile, path.join(skillDir, 'SKILL.md'));
+    fs.copyFileSync(bundledSkillFile, path.join(legacySkillDir, 'SKILL.md'));
+  }
+
+  if (fs.existsSync(bundledRefDir)) {
+    const playbooks = fs.readdirSync(bundledRefDir);
+    for (const pb of playbooks) {
+      const srcPb = path.join(bundledRefDir, pb);
+      if (fs.statSync(srcPb).isFile()) {
+        fs.copyFileSync(srcPb, path.join(skillRefDir, pb));
+        fs.copyFileSync(srcPb, path.join(legacySkillRefDir, pb));
+      }
+    }
+  }
 
   // 3. Crear Symlinks Dinámicos al AGENTS.md (El Single Source of Truth)
   const sourceFile = 'AGENTS.md';

package/src/index.js

@@ -43,8 +43,19 @@ async function runCli() {
   const finalConfig = await promptOptions(detected);
 
   // 5. Generate Harness & Safeguards
+  let s;
+  if (Boolean(process.stdin.isTTY) && !process.env.CI) {
+    const p = require('@clack/prompts');
+    s = p.spinner();
+    s.start('Configurando salvaguardas y motor de gobernanza...');
+  }
+
   generateHarness(targetDir, finalConfig);
 
+  if (s) {
+    s.stop('Salvaguardas y motor de gobernanza configurados.');
+  }
+
   // 6. Render Pro Success Card
   printSuccess(targetDir, finalConfig.projectType === 'frontend', finalConfig);
 }

package/src/ui.js

@@ -3,7 +3,7 @@
  * Brand Identity: The AI Agent Governance & Quality Engineering Engine
  */
 
-const readline = require('readline');
+const p = require('@clack/prompts');
 
 // ANSI Color Palette
 const colors = {
@@ -33,7 +33,7 @@ function printBanner() {
   ╚██████╗███████╗╚██████╗     ██║ ╚██╗███████╗██║  ██║██║ ╚████║███████╗███████╗
    ╚═════╝╚══════╝ ╚═════╝     ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝
 ${colors.reset}`);
-  console.log(`  ${colors.bgCyan} CLC KERNEL ${colors.reset} ${colors.bold}The AI Agent Governance & Quality Engineering Engine${colors.reset} ${colors.gray}v1.2.4${colors.reset}\n`);
+  console.log(`  ${colors.bgCyan} CLC KERNEL ${colors.reset} ${colors.bold}The AI Agent Governance & Quality Engineering Engine${colors.reset} ${colors.gray}v1.2.6${colors.reset}\n`);
 }
 
 function printBox(title, items) {
@@ -52,44 +52,88 @@ function printBox(title, items) {
   console.log(`${colors.dim}└${'─'.repeat(width)}┘${colors.reset}\n`);
 }
 
-function promptOptions(detected) {
-  return new Promise((resolve) => {
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-
-    console.log(`${colors.bold}   \x1b[32m[1]\x1b[0m Confirmar e Instalar CLC Kernel ${colors.dim}(Recomendado)${colors.reset}`);
-    console.log(`   \x1b[33m[2]\x1b[0m Forzar modo FRONTEND`);
-    console.log(`   \x1b[33m[3]\x1b[0m Forzar modo BACKEND`);
-    console.log(`   \x1b[90m[4] Cancelar${colors.reset}\n`);
-
-    rl.question(`${colors.cyan}${colors.bold}➔ Seleccioná una opción [1]: ${colors.reset}`, (answer) => {
-      const choice = answer.trim() || '1';
-      rl.close();
-
-      if (choice === '1') {
-        resolve(detected);
-      } else if (choice === '2') {
-        detected.projectType = 'frontend';
-        resolve(detected);
-      } else if (choice === '3') {
-        detected.projectType = 'backend';
-        resolve(detected);
-      } else {
-        console.log(`\n${colors.red}❌ Instalación de CLC Kernel cancelada.${colors.reset}`);
-        process.exit(0);
+async function promptOptions(detected) {
+  const isInteractive = Boolean(process.stdin.isTTY) &&
+    !process.env.CI &&
+    !process.argv.includes('--yes') &&
+    !process.argv.includes('-y');
+
+  if (!isInteractive) {
+    return detected;
+  }
+
+  p.intro(`${colors.cyan}${colors.bold}CLC Kernel Setup${colors.reset}`);
+
+  const choice = await p.select({
+    message: '¿Cómo deseas inicializar CLC Kernel en este proyecto?',
+    initialValue: 'confirm',
+    options: [
+      {
+        value: 'confirm',
+        label: 'Confirmar e Instalar CLC Kernel',
+        hint: `Recomendado (${detected.projectType.toUpperCase()} - ${detected.framework})`
+      },
+      {
+        value: 'frontend',
+        label: 'Forzar modo FRONTEND',
+        hint: 'Salvaguardas A11y, Zod, Next/Image, UI Reuse'
+      },
+      {
+        value: 'backend',
+        label: 'Forzar modo BACKEND',
+        hint: 'Salvaguardas TDD, Clean Arch, N+1, Secrets'
+      },
+      {
+        value: 'agent-os',
+        label: 'Forzar modo AGENT-OS',
+        hint: 'Salvaguardas HITL, Symlinks, Schemas, Memoria SSOT'
+      },
+      {
+        value: 'cancel',
+        label: 'Cancelar',
+        hint: 'Salir sin realizar cambios'
       }
-    });
+    ]
   });
+
+  if (p.isCancel(choice) || choice === 'cancel') {
+    p.cancel('Instalación de CLC Kernel cancelada.');
+    process.exit(0);
+  }
+
+  if (choice === 'frontend') {
+    detected.projectType = 'frontend';
+  } else if (choice === 'backend') {
+    detected.projectType = 'backend';
+  } else if (choice === 'agent-os') {
+    detected.projectType = 'agent-os';
+  }
+
+  return detected;
 }
 
 function printSuccess(targetDir, isFront, config) {
-  console.log(`\n${colors.bgEmerald} SUCCESS ${colors.reset} ${colors.bold}${colors.emerald}¡CLC Kernel instalado exitosamente!${colors.reset}\n`);
-  console.log(` 🔨 ${colors.bold}Proyecto Inicializado:${colors.reset} ${colors.cyan}${targetDir}${colors.reset}`);
-  console.log(` 🛡️  ${colors.bold}Salvaguardas:${colors.reset} ${isFront ? `${colors.emerald}10 Guardias Frontend (A11y, Zod, Next/Image, UI Reuse, Storybook)` : `${colors.violet}7 Guardias Backend (TDD, Architecture, Scope, Secret Scan)`}${colors.reset}`);
-  console.log(` 📝 ${colors.bold}Leyes & SDD:${colors.reset} AGENTS.md, sdds/, docs/Journal/ precargados`);
-  console.log(` 🔒 ${colors.bold}Git Hooks:${colors.reset} Configurados en ${colors.amber}${config.gitHooks === 'husky' ? '.husky/pre-commit' : '.githooks/pre-commit'}${colors.reset}\n`);
+  const isAgentOS = config.projectType === 'agent-os';
+  const guardsDesc = isAgentOS
+    ? `${colors.cyan}6 Guardias Agent-OS (HITL, Symlinks, Schemas, Memoria, Secrets)${colors.reset}`
+    : isFront
+    ? `${colors.emerald}10 Guardias Frontend (A11y, Zod, Image, UI Reuse, Storybook)${colors.reset}`
+    : `${colors.violet}7 Guardias Backend (TDD, Architecture, Scope, Secret Scan)${colors.reset}`;
+
+  const summary = [
+    `🔨 ${colors.bold}Proyecto Inicializado:${colors.reset} ${colors.cyan}${targetDir}${colors.reset}`,
+    `🛡️  ${colors.bold}Salvaguardas:${colors.reset} ${guardsDesc}`,
+    `📝 ${colors.bold}Leyes & SDD:${colors.reset} AGENTS.md, sdds/, docs/Journal/ precargados`,
+    `🔒 ${colors.bold}Git Hooks:${colors.reset} Configurados en ${colors.amber}${config.gitHooks === 'husky' ? '.husky/pre-commit' : '.githooks/pre-commit'}${colors.reset}`
+  ].join('\n');
+
+  if (p.note && p.outro) {
+    p.note(summary, '🚀 Resumen de Instalación');
+    p.outro(`${colors.emerald}${colors.bold}¡CLC Kernel instalado exitosamente!${colors.reset}`);
+  } else {
+    console.log(`\n${colors.bgEmerald} SUCCESS ${colors.reset} ${colors.bold}${colors.emerald}¡CLC Kernel instalado exitosamente!${colors.reset}\n`);
+    console.log(summary + '\n');
+  }
 }
 
 module.exports = {

package/tools/check_domain_data.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/**
+ * Domain Data Integrity & Clean State Guard
+ * Validates domain deliverables (content.json, calendar.json, voc.json)
+ * to ensure valid JSON structure and clean creation state (no fake hallucinated metrics on pending posts).
+ * Self-contained: uses only Node.js built-ins.
+ *
+ * @param {string} targetDir - Directory to scan (defaults to cwd)
+ * @returns {{ exitCode: number, skipped: boolean, name: string, data: object }}
+ */
+const check = async function checkDomainData(targetDir) {
+  const fs = require('fs');
+  const path = require('path');
+
+  const dir = targetDir || process.cwd();
+  const searchDirs = [
+    dir,
+    path.join(dir, 'output'),
+    path.join(dir, 'content-calendar'),
+    path.join(dir, 'data')
+  ];
+
+  const jsonFiles = [];
+  for (const sDir of searchDirs) {
+    if (fs.existsSync(sDir)) {
+      try {
+        const files = fs.readdirSync(sDir);
+        for (const file of files) {
+          if (file.endsWith('.json') && !file.includes('package') && !file.includes('tsconfig')) {
+            jsonFiles.push(path.join(sDir, file));
+          }
+        }
+      } catch {}
+    }
+  }
+
+  if (jsonFiles.length === 0) {
+    return {
+      exitCode: 0,
+      skipped: true,
+      name: 'check_domain_data',
+      data: { violations: [], message: 'No domain data JSON files to validate' }
+    };
+  }
+
+  const violations = [];
+  for (const file of jsonFiles) {
+    try {
+      const raw = fs.readFileSync(file, 'utf-8');
+      const data = JSON.parse(raw);
+
+      // Clean Creation State Check: If array of posts/calendar entries
+      const entries = Array.isArray(data) ? data : (data.posts || data.items || data.calendar || []);
+      if (Array.isArray(entries)) {
+        for (let i = 0; i < entries.length; i++) {
+          const item = entries[i];
+          if (item && (item.status === 'pending' || item.status === 'draft')) {
+            // Check if metrics are falsely pre-filled with non-null numbers
+            if (item.metrics && typeof item.metrics === 'object') {
+              const fakeMetrics = Object.entries(item.metrics).filter(([_, val]) => typeof val === 'number' && val > 0);
+              if (fakeMetrics.length > 0) {
+                violations.push({
+                  file: path.relative(dir, file),
+                  message: `Entry #${i + 1} (${item.title || item.id || 'draft'}) has pre-filled fake metrics on pending/draft post`
+                });
+              }
+            }
+          }
+        }
+      }
+    } catch (err) {
+      violations.push({
+        file: path.relative(dir, file),
+        message: `JSON syntax or structural error: ${err.message}`
+      });
+    }
+  }
+
+  const exitCode = violations.length > 0 ? 1 : 0;
+  return {
+    exitCode,
+    skipped: false,
+    name: 'check_domain_data',
+    data: {
+      violations,
+      message: violations.length > 0
+        ? `${violations.length} domain data integrity violation(s) found`
+        : 'All domain deliverables & state data verified'
+    }
+  };
+};
+
+module.exports = check;
+
+if (require.main === module) {
+  check(process.argv[2]).then(result => {
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(result.exitCode);
+  });
+}