code-warden 3.3.0 → 3.3.1

package/tools/auto-targets.js

@@ -1,104 +1,104 @@
-#!/usr/bin/env node
-/**
- * auto-targets.js
- * Target registry for the code-warden auto-installer.
- * Each entry describes one AI app, how to detect it, and where to install.
- *
- * format values:
- *   'skill-md'      - copy the full skill folder (SKILL.md + references/ + tools/)
- *   'windsurf-flat' - concatenate into a single .md file via auto-windsurf-adapter.js
- */
-
-const os   = require('os');
-const path = require('path');
-
-const HOME        = os.homedir();
-const LOCALAPPDATA = process.env.LOCALAPPDATA || '';
-const APPDATA      = process.env.APPDATA      || '';
-
-const TARGETS = [
-  {
-    id:        'claude',
-    name:      'Claude Code',
-    format:    'skill-md',
-    skillsDir: path.join(HOME, '.claude', 'skills'),
-    detect: {
-      binaries: ['claude'],
-      dirs:     [path.join(HOME, '.claude')],
-      apps: {
-        darwin: ['/Applications/Claude.app'],
-        win32:  [path.join(LOCALAPPDATA, 'Programs', 'claude', 'claude.exe')],
-        linux:  [],
-      },
-    },
-  },
-  {
-    id:        'cursor',
-    name:      'Cursor',
-    format:    'skill-md',
-    skillsDir: path.join(HOME, '.cursor', 'skills'),
-    detect: {
-      binaries: ['cursor'],
-      dirs:     [path.join(HOME, '.cursor')],
-      apps: {
-        darwin: ['/Applications/Cursor.app'],
-        win32:  [path.join(LOCALAPPDATA, 'Programs', 'cursor', 'Cursor.exe')],
-        linux:  [path.join(HOME, '.local', 'share', 'cursor')],
-      },
-    },
-  },
-  {
-    id:        'warp',
-    name:      'Warp',
-    format:    'skill-md',
-    skillsDir: path.join(HOME, '.warp', 'skills'),
-    detect: {
-      binaries: ['warp', 'warp-terminal'],
-      dirs:     [path.join(HOME, '.warp')],
-      apps: {
-        darwin: ['/Applications/Warp.app'],
-        win32:  [path.join(LOCALAPPDATA, 'Programs', 'Warp', 'Warp.exe')],
-        linux:  [],
-      },
-    },
-  },
-  {
-    id:        'codex',
-    name:      'OpenAI Codex',
-    format:    'skill-md',
-    skillsDir: path.join(HOME, '.codex', 'skills'),
-    detect: {
-      binaries: ['codex'],
-      dirs:     [path.join(HOME, '.codex')],
-      apps:     { darwin: [], win32: [], linux: [] },
-    },
-  },
-  {
-    id:        'agents',
-    name:      'Generic Agents',
-    format:    'skill-md',
-    skillsDir: path.join(HOME, '.agents', 'skills'),
-    detect: {
-      binaries: [],
-      dirs:     [path.join(HOME, '.agents')],
-      apps:     { darwin: [], win32: [], linux: [] },
-    },
-  },
-  {
-    id:        'windsurf',
-    name:      'Windsurf',
-    format:    'windsurf-flat',
-    skillsDir: path.join(HOME, '.windsurf', 'rules'),
-    detect: {
-      binaries: ['windsurf'],
-      dirs:     [path.join(HOME, '.windsurf')],
-      apps: {
-        darwin: ['/Applications/Windsurf.app'],
-        win32:  [path.join(LOCALAPPDATA, 'Programs', 'Windsurf', 'Windsurf.exe')],
-        linux:  [],
-      },
-    },
-  },
-];
-
-module.exports = { TARGETS };
+#!/usr/bin/env node
+/**
+ * auto-targets.js
+ * Target registry for the code-warden auto-installer.
+ * Each entry describes one AI app, how to detect it, and where to install.
+ *
+ * format values:
+ *   'skill-md'      - copy the full skill folder (SKILL.md + references/ + tools/)
+ *   'windsurf-flat' - concatenate into a single .md file via auto-windsurf-adapter.js
+ */
+
+const os   = require('os');
+const path = require('path');
+
+const HOME        = os.homedir();
+const LOCALAPPDATA = process.env.LOCALAPPDATA || '';
+const APPDATA      = process.env.APPDATA      || '';
+
+const TARGETS = [
+  {
+    id:        'claude',
+    name:      'Claude Code',
+    format:    'skill-md',
+    skillsDir: path.join(HOME, '.claude', 'skills'),
+    detect: {
+      binaries: ['claude'],
+      dirs:     [path.join(HOME, '.claude')],
+      apps: {
+        darwin: ['/Applications/Claude.app'],
+        win32:  [path.join(LOCALAPPDATA, 'Programs', 'claude', 'claude.exe')],
+        linux:  [],
+      },
+    },
+  },
+  {
+    id:        'cursor',
+    name:      'Cursor',
+    format:    'skill-md',
+    skillsDir: path.join(HOME, '.cursor', 'skills'),
+    detect: {
+      binaries: ['cursor'],
+      dirs:     [path.join(HOME, '.cursor')],
+      apps: {
+        darwin: ['/Applications/Cursor.app'],
+        win32:  [path.join(LOCALAPPDATA, 'Programs', 'cursor', 'Cursor.exe')],
+        linux:  [path.join(HOME, '.local', 'share', 'cursor')],
+      },
+    },
+  },
+  {
+    id:        'warp',
+    name:      'Warp',
+    format:    'skill-md',
+    skillsDir: path.join(HOME, '.warp', 'skills'),
+    detect: {
+      binaries: ['warp', 'warp-terminal'],
+      dirs:     [path.join(HOME, '.warp')],
+      apps: {
+        darwin: ['/Applications/Warp.app'],
+        win32:  [path.join(LOCALAPPDATA, 'Programs', 'Warp', 'Warp.exe')],
+        linux:  [],
+      },
+    },
+  },
+  {
+    id:        'codex',
+    name:      'OpenAI Codex',
+    format:    'skill-md',
+    skillsDir: path.join(HOME, '.codex', 'skills'),
+    detect: {
+      binaries: ['codex'],
+      dirs:     [path.join(HOME, '.codex')],
+      apps:     { darwin: [], win32: [], linux: [] },
+    },
+  },
+  {
+    id:        'agents',
+    name:      'Generic Agents',
+    format:    'skill-md',
+    skillsDir: path.join(HOME, '.agents', 'skills'),
+    detect: {
+      binaries: [],
+      dirs:     [path.join(HOME, '.agents')],
+      apps:     { darwin: [], win32: [], linux: [] },
+    },
+  },
+  {
+    id:        'windsurf',
+    name:      'Windsurf',
+    format:    'windsurf-flat',
+    skillsDir: path.join(HOME, '.windsurf', 'rules'),
+    detect: {
+      binaries: ['windsurf'],
+      dirs:     [path.join(HOME, '.windsurf')],
+      apps: {
+        darwin: ['/Applications/Windsurf.app'],
+        win32:  [path.join(LOCALAPPDATA, 'Programs', 'Windsurf', 'Windsurf.exe')],
+        linux:  [],
+      },
+    },
+  },
+];
+
+module.exports = { TARGETS };

package/tools/auto-windsurf-adapter.js

@@ -1,75 +1,75 @@
-#!/usr/bin/env node
-/**
- * auto-windsurf-adapter.js
- * Converts the modular code-warden skill into a single flat markdown file
- * compatible with Windsurf's rules format (.windsurf/rules/).
- *
- * Concatenation order:
- *   SKILL.md -> planning-gates -> architecture -> safety -> cognition -> cleanup
- *             -> anti-drift -> operations -> research-and-fit
- */
-
-const fs   = require('fs');
-const path = require('path');
-
-const REFERENCE_ORDER = [
-  'planning-gates',
-  'architecture',
-  'safety',
-  'cognition',
-  'cleanup',
-  'anti-drift',
-  'operations',
-  'research-and-fit',
-];
-
-const OUTPUT_FILENAME = 'code-warden.md';
-
-/**
- * Reads a file and returns its content.
- * - SKILL.md missing: throws (hard fail — output is meaningless without it)
- * - Reference missing: warns to stderr, inserts a comment, continues
- */
-function readSafe(filePath, label) {
-  if (!fs.existsSync(filePath)) {
-    if (label === 'SKILL.md') {
-      throw new Error(`SKILL.md not found at ${filePath} — cannot generate Windsurf output.`);
-    }
-    console.warn(`[CodeWarden] WARN  ${label} not found, skipping.`);
-    return `\n<!-- [CodeWarden] WARNING: ${label} not found — section omitted -->\n`;
-  }
-  return fs.readFileSync(filePath, 'utf8');
-}
-
-/**
- * Builds and writes the flat Windsurf rules file.
- * @param {string} sourceDir - root of the code-warden skill source
- * @param {string} destDir   - target directory (e.g. ~/.windsurf/rules)
- * @returns {string} - full path of the written file
- */
-function installWindsurf(sourceDir, destDir) {
-  const sections = [];
-
-  sections.push('<!-- Generated by code-warden auto-installer. Do not edit manually. -->');
-  sections.push('<!-- Source: https://github.com/Kodaxadev/Code-Warden -->');
-  sections.push('');
-
-  const skillMdPath = path.join(sourceDir, 'SKILL.md');
-  sections.push(readSafe(skillMdPath, 'SKILL.md'));
-
-  for (const ref of REFERENCE_ORDER) {
-    const refPath = path.join(sourceDir, 'references', `${ref}.md`);
-    sections.push(`\n---\n`);
-    sections.push(readSafe(refPath, `references/${ref}.md`));
-  }
-
-  const output = sections.join('\n');
-
-  fs.mkdirSync(destDir, { recursive: true });
-  const outPath = path.join(destDir, OUTPUT_FILENAME);
-  fs.writeFileSync(outPath, output, 'utf8');
-
-  return outPath;
-}
-
-module.exports = { installWindsurf };
+#!/usr/bin/env node
+/**
+ * auto-windsurf-adapter.js
+ * Converts the modular code-warden skill into a single flat markdown file
+ * compatible with Windsurf's rules format (.windsurf/rules/).
+ *
+ * Concatenation order:
+ *   SKILL.md -> planning-gates -> architecture -> safety -> cognition -> cleanup
+ *             -> anti-drift -> operations -> research-and-fit
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const REFERENCE_ORDER = [
+  'planning-gates',
+  'architecture',
+  'safety',
+  'cognition',
+  'cleanup',
+  'anti-drift',
+  'operations',
+  'research-and-fit',
+];
+
+const OUTPUT_FILENAME = 'code-warden.md';
+
+/**
+ * Reads a file and returns its content.
+ * - SKILL.md missing: throws (hard fail — output is meaningless without it)
+ * - Reference missing: warns to stderr, inserts a comment, continues
+ */
+function readSafe(filePath, label) {
+  if (!fs.existsSync(filePath)) {
+    if (label === 'SKILL.md') {
+      throw new Error(`SKILL.md not found at ${filePath} — cannot generate Windsurf output.`);
+    }
+    console.warn(`[CodeWarden] WARN  ${label} not found, skipping.`);
+    return `\n<!-- [CodeWarden] WARNING: ${label} not found — section omitted -->\n`;
+  }
+  return fs.readFileSync(filePath, 'utf8');
+}
+
+/**
+ * Builds and writes the flat Windsurf rules file.
+ * @param {string} sourceDir - root of the code-warden skill source
+ * @param {string} destDir   - target directory (e.g. ~/.windsurf/rules)
+ * @returns {string} - full path of the written file
+ */
+function installWindsurf(sourceDir, destDir) {
+  const sections = [];
+
+  sections.push('<!-- Generated by code-warden auto-installer. Do not edit manually. -->');
+  sections.push('<!-- Source: https://github.com/Kodaxadev/Code-Warden -->');
+  sections.push('');
+
+  const skillMdPath = path.join(sourceDir, 'SKILL.md');
+  sections.push(readSafe(skillMdPath, 'SKILL.md'));
+
+  for (const ref of REFERENCE_ORDER) {
+    const refPath = path.join(sourceDir, 'references', `${ref}.md`);
+    sections.push(`\n---\n`);
+    sections.push(readSafe(refPath, `references/${ref}.md`));
+  }
+
+  const output = sections.join('\n');
+
+  fs.mkdirSync(destDir, { recursive: true });
+  const outPath = path.join(destDir, OUTPUT_FILENAME);
+  fs.writeFileSync(outPath, output, 'utf8');
+
+  return outPath;
+}
+
+module.exports = { installWindsurf };

package/tools/get-context.js

@@ -1,50 +1,50 @@
-#!/usr/bin/env node
-const fs = require('fs');
-const path = require('path');
-
-const candidates = [
-  'AGENTS.md',
-  '.codex/AGENTS.md',
-  'ARCHITECTURE.md',
-  'docs/ARCHITECTURE.md',
-  '.agents/AGENTS.md',
-  '.claude/CLAUDE.md',
-  'CLAUDE.md',
-  'README.md',
-  'docs/README.md',
-  'PRD.md',
-];
-
-function findContextFile(startDir) {
-  let currDir = path.resolve(startDir);
-
-  while (true) {
-    for (const candidate of candidates) {
-      const fullPath = path.join(currDir, candidate);
-      if (fs.existsSync(fullPath)) {
-        return fullPath;
-      }
-    }
-
-    const parentDir = path.dirname(currDir);
-    if (parentDir === currDir) {
-      return null;
-    }
-    currDir = parentDir;
-  }
-}
-
-const contextFile = findContextFile(process.cwd());
-
-if (contextFile) {
-  console.log(`Found architectural context at: ${contextFile}\n`);
-  const content = fs.readFileSync(contextFile, 'utf8');
-  if (content.length > 5000) {
-    console.log(`${content.substring(0, 5000)}\n...[Content truncated]`);
-  } else {
-    console.log(content);
-  }
-} else {
-  console.log('[WARN] No AGENTS.md, architecture doc, CLAUDE.md, PRD, or README found in the repository hierarchy.');
-  process.exit(1);
-}
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+const candidates = [
+  'AGENTS.md',
+  '.codex/AGENTS.md',
+  'ARCHITECTURE.md',
+  'docs/ARCHITECTURE.md',
+  '.agents/AGENTS.md',
+  '.claude/CLAUDE.md',
+  'CLAUDE.md',
+  'README.md',
+  'docs/README.md',
+  'PRD.md',
+];
+
+function findContextFile(startDir) {
+  let currDir = path.resolve(startDir);
+
+  while (true) {
+    for (const candidate of candidates) {
+      const fullPath = path.join(currDir, candidate);
+      if (fs.existsSync(fullPath)) {
+        return fullPath;
+      }
+    }
+
+    const parentDir = path.dirname(currDir);
+    if (parentDir === currDir) {
+      return null;
+    }
+    currDir = parentDir;
+  }
+}
+
+const contextFile = findContextFile(process.cwd());
+
+if (contextFile) {
+  console.log(`Found architectural context at: ${contextFile}\n`);
+  const content = fs.readFileSync(contextFile, 'utf8');
+  if (content.length > 5000) {
+    console.log(`${content.substring(0, 5000)}\n...[Content truncated]`);
+  } else {
+    console.log(content);
+  }
+} else {
+  console.log('[WARN] No AGENTS.md, architecture doc, CLAUDE.md, PRD, or README found in the repository hierarchy.');
+  process.exit(1);
+}