clckernel 1.2.10 → 1.2.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clckernel",
-  "version": "1.2.10",
+  "version": "1.2.12",
   "description": "CLC Kernel — The Universal Polyglot AI Agent Governance Engine (Next.js, FastAPI, Django, Astro, Rails, Go, Rust, Laravel).",
   "main": "./bin/cli.js",
   "files": [

package/src/adapters/agent-os.js

@@ -113,8 +113,11 @@ class AgentOSAdapter extends BaseAdapter {
   }
 
   provision(targetDir, config) {
-    // 1. Create docs/, sdds/, and tools/
-    super.provision(targetDir, config);
+    // 1. Create docs/, sdds/, and tools/. AGENTS.md is owned by this adapter
+    // (dual-layer template below), so BaseAdapter must not write its generic
+    // law file — otherwise the generic one lands first and, being present,
+    // would make the guard below skip the dual-layer render entirely.
+    super.provision(targetDir, { ...(config || {}), skipAgentsMd: true });
 
     // 2. Write Dual-Layer AGENTS.md
     const dualLayerAgents = `# Standard Operating Procedure (SOP) — AGENTS
@@ -174,7 +177,12 @@ When given a command matching \`clckernel <action>\` or \`/clckernel <action>\`,
 ${this.getSafeguards().map(s => `- ${s}`).join('\n')}
 `;
 
-    fs.writeFileSync(path.join(targetDir, 'AGENTS.md'), dualLayerAgents, 'utf-8');
+    // Guard: never overwrite a project-customized AGENTS.md (e.g. a Laila MOS
+    // law file carrying domain invariants the template cannot know about).
+    const dualAgentsPath = path.join(targetDir, 'AGENTS.md');
+    if (!fs.existsSync(dualAgentsPath)) {
+      fs.writeFileSync(dualAgentsPath, dualLayerAgents, 'utf-8');
+    }
 
     // 3. Create AI IDE mirror symlinks
     const mirrors = ['CLAUDE.md', 'GEMINI.md', '.cursorrules', '.windsurfrules'];

package/src/adapters/base.js

@@ -57,6 +57,10 @@ class BaseAdapter {
   }
 
   provision(targetDir, config) {
+    // Subclasses that render their own AGENTS.md pass { skipAgentsMd: true }
+    // so this generic law file is never written alongside (or over) theirs.
+    const skipAgentsMd = !!(config && config.skipAgentsMd);
+
     // 1. Create docs/ and sdds/
     fs.mkdirSync(path.join(targetDir, 'docs', 'Journal'), { recursive: true });
     fs.mkdirSync(path.join(targetDir, 'docs', 'Architecture'), { recursive: true });
@@ -75,7 +79,7 @@ class BaseAdapter {
 
     // 3. Write AGENTS.md
     const isFront = this.projectType === 'frontend';
-    const agentsContent = `# 🔨 CLC Kernel ${this.name} (${this.projectType.toUpperCase()}) — AGENTS
+    const agentsContent = skipAgentsMd ? '' : `# 🔨 CLC Kernel ${this.name} (${this.projectType.toUpperCase()}) — AGENTS
 
 This document is the **authoritative law** for AI agents working in this repository.
 Forged by **CLC Kernel: The AI Agent Governance Engine**.
@@ -102,7 +106,14 @@ Forged by **CLC Kernel: The AI Agent Governance Engine**.
 ## 2. Core AI Safeguards (${this.name})
 ${this.getSafeguards().map(s => `- ${s}`).join('\n')}
 `;
-    fs.writeFileSync(path.join(targetDir, 'AGENTS.md'), agentsContent, 'utf-8');
+    // Guard: never overwrite a project-customized AGENTS.md.
+    if (skipAgentsMd) {
+      return;
+    }
+    const agentsPath = path.join(targetDir, 'AGENTS.md');
+    if (!fs.existsSync(agentsPath)) {
+      fs.writeFileSync(agentsPath, agentsContent, 'utf-8');
+    }
   }
 }
 

package/src/generator.js

@@ -341,7 +341,13 @@ When given a command matching \`clckernel <action>\` or \`/clckernel <action>\`,
 | \`clckernel update\` | Maintenance | Non-destructive update: refresh core tools, playbooks & symlinks (preserves SDDs & custom guards). |
 | \`clckernel start\` | Setup | Scan codebase, propose governance plan, and materialize \`.clckernel.yaml\`. |
 `;
-    fs.writeFileSync(path.join(targetDir, 'AGENTS.md'), agentsContent, 'utf-8');
+    // Guard: never overwrite an existing project-customized AGENTS.md.
+    // This prevents clckernel update from replacing Laila MOS invariants
+    // (carousel format, one-question-onboarding, dynamic calendar, immutability).
+    if (!fs.existsSync(path.join(targetDir, 'AGENTS.md'))) {
+      fs.writeFileSync(path.join(targetDir, 'AGENTS.md'), agentsContent, 'utf-8');
+    }
+
   }
 
   // Step 2: Install tools (manifest-driven or fallback)

package/src/updater.js

@@ -33,7 +33,10 @@ function updateHarness(targetDir = process.cwd(), options = {}) {
   // 3. Run harness generation (refreshes tools, hooks, skills, and symlinks)
   generateHarness(resolvedDir, detected);
 
-  // 4. Ensure AGENTS.md includes the update command in the command table
+  // 4. Ensure AGENTS.md documents the update command in its command table.
+  // Non-destructive: only inject into a file that already carries the CLC
+  // Kernel command table, and only when the row is missing (idempotent).
+  // A project-customized AGENTS.md without that structure is left untouched.
   const agentsPath = path.join(resolvedDir, 'AGENTS.md');
   if (fs.existsSync(agentsPath)) {
     let agentsContent = fs.readFileSync(agentsPath, 'utf-8');