clckernel 1.2.18 → 1.2.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clckernel",
-  "version": "1.2.18",
+  "version": "1.2.19",
   "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/base.js

@@ -68,13 +68,9 @@ class BaseAdapter {
     fs.mkdirSync(path.join(targetDir, 'sdds'), { recursive: true });
     fs.mkdirSync(path.join(targetDir, 'tools'), { recursive: true });
 
-    // 2. Gitignore sdds/*
-    const gitignorePath = path.join(targetDir, '.gitignore');
-    let gitignore = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf-8') : '';
-    if (!gitignore.includes('sdds/*')) {
-      gitignore += '\n\n# Local Spec-Driven Development (SDD) files\nsdds/*\n!sdds/.gitkeep\nopenspec/*\n!openspec/.gitkeep\n.ruff_cache/\n';
-      fs.writeFileSync(gitignorePath, gitignore, 'utf-8');
-    }
+    // 2. Gitignore local SDD specs, ephemeral artifacts, and AI IDE mirrors
+    const { ensureGitignoreEntries } = require('../gitignore');
+    ensureGitignoreEntries(targetDir);
     fs.writeFileSync(path.join(targetDir, 'sdds', '.gitkeep'), '', 'utf-8');
 
     // 3. Write AGENTS.md

package/src/generator.js

@@ -330,12 +330,8 @@ function generateHarness(targetDir, configOrNull) {
     fs.mkdirSync(path.join(targetDir, 'sdds'), { recursive: true });
     fs.mkdirSync(path.join(targetDir, 'tools'), { recursive: true });
 
-    const gitignorePath = path.join(targetDir, '.gitignore');
-    let gitignoreContent = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf-8') : '';
-    if (!gitignoreContent.includes('sdds/*')) {
-      gitignoreContent += '\n\n# Local Spec-Driven Development (SDD) files\nsdds/*\n!sdds/.gitkeep\nopenspec/*\n!openspec/.gitkeep\n.ruff_cache/\n';
-      fs.writeFileSync(gitignorePath, gitignoreContent, 'utf-8');
-    }
+    const { ensureGitignoreEntries } = require('./gitignore');
+    ensureGitignoreEntries(targetDir);
     fs.writeFileSync(path.join(targetDir, 'sdds', '.gitkeep'), '', 'utf-8');
 
     const agentsContent = `# CLC Kernel ${config.framework || 'Generic'} (${(config.projectType || 'unknown').toUpperCase()}) — AGENTS

package/src/gitignore.js

@@ -0,0 +1,98 @@
+/**
+ * CLC Kernel — Gitignore Provisioning Engine
+ * Ensures AI IDE mirror symlinks, local SDD specs, and ephemeral runtime artifacts
+ * are safely ignored in consumer repositories to preserve AGENTS.md as the SSOT.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const MANAGED_GITIGNORE_SECTIONS = [
+  {
+    header: '# CLC Kernel: Local AI IDE Mirror Symlinks (SSOT: AGENTS.md)',
+    entries: [
+      'CLAUDE.md',
+      'GEMINI.md',
+      '.cursorrules',
+      '.windsurfrules',
+      '.cursor/',
+      '.antigravity/',
+      '.github/copilot-instructions.md',
+    ],
+  },
+  {
+    header: '# CLC Kernel: CLI Agent Skills & Playbooks',
+    entries: [
+      '.agents/skills/clckernel_cli/',
+      '.agents/skills/clc_forge_cli/',
+    ],
+  },
+  {
+    header: '# CLC Kernel: Local SDD Specs & Ephemeral Harness Artifacts',
+    entries: [
+      'sdds/*',
+      '!sdds/.gitkeep',
+      'openspec/*',
+      '!openspec/.gitkeep',
+      '.clckernel.resolved.json',
+      '.clc-forge.resolved.json',
+      '.husky/_/',
+      '.ruff_cache/',
+    ],
+  },
+];
+
+/**
+ * Idempotently appends missing CLC Kernel entries to target project's .gitignore.
+ *
+ * @param {string} targetDir - Target project root
+ * @returns {boolean} True if .gitignore was created or modified, false if already complete.
+ */
+function ensureGitignoreEntries(targetDir) {
+  const gitignorePath = path.join(targetDir, '.gitignore');
+  let currentContent = '';
+  if (fs.existsSync(gitignorePath)) {
+    try {
+      currentContent = fs.readFileSync(gitignorePath, 'utf-8');
+    } catch (e) {
+      currentContent = '';
+    }
+  }
+
+  const existingLines = new Set(
+    currentContent
+      .split('\n')
+      .map(line => line.trim())
+      .filter(line => line.length > 0)
+  );
+
+  const sectionsToAppend = [];
+
+  for (const section of MANAGED_GITIGNORE_SECTIONS) {
+    const missingEntries = section.entries.filter(entry => !existingLines.has(entry.trim()));
+    if (missingEntries.length > 0) {
+      sectionsToAppend.push(`${section.header}\n${missingEntries.join('\n')}`);
+    }
+  }
+
+  if (sectionsToAppend.length === 0) {
+    return false;
+  }
+
+  let newContent = currentContent;
+  if (newContent.length > 0 && !newContent.endsWith('\n')) {
+    newContent += '\n';
+  }
+  if (newContent.length > 0) {
+    newContent += '\n';
+  }
+  newContent += sectionsToAppend.join('\n\n') + '\n';
+
+  fs.writeFileSync(gitignorePath, newContent, 'utf-8');
+  return true;
+}
+
+module.exports = {
+  ensureGitignoreEntries,
+  MANAGED_GITIGNORE_SECTIONS,
+};

package/src/updater.js

@@ -32,6 +32,8 @@ function updateHarness(targetDir = process.cwd(), options = {}) {
 
   // 3. Run harness generation (refreshes tools, hooks, skills, and symlinks)
   generateHarness(resolvedDir, detected);
+  const { ensureGitignoreEntries } = require('./gitignore');
+  ensureGitignoreEntries(resolvedDir);
 
   // 4. Ensure AGENTS.md documents the update command in its command table.
   // Non-destructive: only inject into a file that already carries the CLC