marcos-ai-bootstrap 0.1.0 → 0.1.2

package/src/bin/ai-bootstrap.js

@@ -1,115 +1,115 @@
-#!/usr/bin/env node
-"use strict";
-
-const path = require("path");
-const { materialize, TOOLS } = require("../lib/materialize");
-
-const TOOL_NAMES = Object.keys(TOOLS);
-
-const HELP = `
-marcos-ai-bootstrap - materialise a tool-agnostic AI agent/skill network into any repository
-
-Usage:
-  marcos-ai-bootstrap [--claude] [--codex] [--copilot] [--all] [options]
-
-Tool flags (combine as many as you like):
-  --claude          Claude Code agents (.claude/agents), skills (.claude/skills), CLAUDE.md
-  --codex           Codex agents (.codex/agents), skills (.agents/skills)
-  --copilot         GitHub Copilot CLI agents (.github/agents), skills (.github/skills),
-                     .github/copilot-instructions.md
-  --all             All of the above
-
-Always written alongside any tool flag:
-  AGENTS.md, HUMAN.md (tool-agnostic rules + human guide)
-
-Options:
-  --dest <path>     Target directory (default: current working directory)
-  --force           Overwrite files that already exist (default: skip existing files)
-  --dry-run         Show what would be written without writing anything
-  -h, --help        Show this help text
-
-Examples:
-  npx marcos-ai-bootstrap --copilot
-  npx marcos-ai-bootstrap --claude --codex --dry-run
-  npx marcos-ai-bootstrap --all --force
-`;
-
-function parseArgs(argv) {
-  const opts = { tools: [], dest: undefined, force: false, dryRun: false, help: false };
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    switch (arg) {
-      case "--all":
-        opts.tools = TOOL_NAMES.slice();
-        break;
-      case "--claude":
-      case "--codex":
-      case "--copilot":
-        opts.tools.push(arg.slice(2));
-        break;
-      case "--dest":
-        opts.dest = argv[++i];
-        break;
-      case "--force":
-        opts.force = true;
-        break;
-      case "--dry-run":
-        opts.dryRun = true;
-        break;
-      case "-h":
-      case "--help":
-        opts.help = true;
-        break;
-      default:
-        console.error(`Unknown argument: ${arg}\n`);
-        opts.help = true;
-        opts.unknown = true;
-    }
-  }
-  opts.tools = Array.from(new Set(opts.tools));
-  return opts;
-}
-
-function main() {
-  const opts = parseArgs(process.argv.slice(2));
-
-  if (opts.help || opts.tools.length === 0) {
-    console.log(HELP);
-    process.exit(opts.unknown || opts.tools.length === 0 ? 1 : 0);
-  }
-
-  const destRoot = path.resolve(opts.dest || process.cwd());
-  const { results } = materialize(opts.tools, {
-    destRoot,
-    force: opts.force,
-    dryRun: opts.dryRun,
-  });
-
-  const toolLabels = opts.tools.map((t) => TOOLS[t].label).join(", ");
-  console.log(
-    `${opts.dryRun ? "[dry-run] " : ""}Materialising ${toolLabels} into ${destRoot}\n`
-  );
-
-  const byStatus = { created: [], overwritten: [], "skipped-exists": [], "missing-source": [] };
-  for (const r of results) {
-    (byStatus[r.status] || (byStatus[r.status] = [])).push(r.relPath);
-  }
-
-  for (const r of byStatus.created) console.log(`  created      ${r}`);
-  for (const r of byStatus.overwritten) console.log(`  overwritten  ${r}`);
-  for (const r of byStatus["skipped-exists"]) console.log(`  skipped      ${r} (already exists, use --force to overwrite)`);
-  for (const r of byStatus["missing-source"]) console.log(`  MISSING      ${r} (not bundled in this package)`);
-
-  console.log(
-    `\n${byStatus.created.length} created, ${byStatus.overwritten.length} overwritten, ` +
-      `${byStatus["skipped-exists"].length} skipped, ${results.length} total.`
-  );
-
-  if (!opts.dryRun) {
-    console.log(
-      `\nDone. Open AGENTS.md / HUMAN.md, then start your AI tool in ${destRoot} to begin.`
-    );
-  }
-}
-
-main();
+#!/usr/bin/env node
+"use strict";
+
+const path = require("path");
+const { materialize, TOOLS } = require("../lib/materialize");
+
+const TOOL_NAMES = Object.keys(TOOLS);
+
+const HELP = `
+marcos-ai-bootstrap - materialise a tool-agnostic AI agent/skill network into any repository
+
+Usage:
+  marcos-ai-bootstrap [--claude] [--codex] [--copilot] [--all] [options]
+
+Tool flags (combine as many as you like):
+  --claude          Claude Code agents (.claude/agents), skills (.claude/skills), CLAUDE.md
+  --codex           Codex agents (.codex/agents), skills (.agents/skills)
+  --copilot         GitHub Copilot CLI agents (.github/agents), skills (.github/skills),
+                     .github/copilot-instructions.md
+  --all             All of the above
+
+Always written alongside any tool flag:
+  AGENTS.md, HUMAN.md (tool-agnostic rules + human guide)
+
+Options:
+  --dest <path>     Target directory (default: current working directory)
+  --force           Overwrite files that already exist (default: skip existing files)
+  --dry-run         Show what would be written without writing anything
+  -h, --help        Show this help text
+
+Examples:
+  npx marcos-ai-bootstrap --copilot
+  npx marcos-ai-bootstrap --claude --codex --dry-run
+  npx marcos-ai-bootstrap --all --force
+`;
+
+function parseArgs(argv) {
+  const opts = { tools: [], dest: undefined, force: false, dryRun: false, help: false };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    switch (arg) {
+      case "--all":
+        opts.tools = TOOL_NAMES.slice();
+        break;
+      case "--claude":
+      case "--codex":
+      case "--copilot":
+        opts.tools.push(arg.slice(2));
+        break;
+      case "--dest":
+        opts.dest = argv[++i];
+        break;
+      case "--force":
+        opts.force = true;
+        break;
+      case "--dry-run":
+        opts.dryRun = true;
+        break;
+      case "-h":
+      case "--help":
+        opts.help = true;
+        break;
+      default:
+        console.error(`Unknown argument: ${arg}\n`);
+        opts.help = true;
+        opts.unknown = true;
+    }
+  }
+  opts.tools = Array.from(new Set(opts.tools));
+  return opts;
+}
+
+function main() {
+  const opts = parseArgs(process.argv.slice(2));
+
+  if (opts.help || opts.tools.length === 0) {
+    console.log(HELP);
+    process.exit(opts.unknown || opts.tools.length === 0 ? 1 : 0);
+  }
+
+  const destRoot = path.resolve(opts.dest || process.cwd());
+  const { results } = materialize(opts.tools, {
+    destRoot,
+    force: opts.force,
+    dryRun: opts.dryRun,
+  });
+
+  const toolLabels = opts.tools.map((t) => TOOLS[t].label).join(", ");
+  console.log(
+    `${opts.dryRun ? "[dry-run] " : ""}Materialising ${toolLabels} into ${destRoot}\n`
+  );
+
+  const byStatus = { created: [], overwritten: [], "skipped-exists": [], "missing-source": [] };
+  for (const r of results) {
+    (byStatus[r.status] || (byStatus[r.status] = [])).push(r.relPath);
+  }
+
+  for (const r of byStatus.created) console.log(`  created      ${r}`);
+  for (const r of byStatus.overwritten) console.log(`  overwritten  ${r}`);
+  for (const r of byStatus["skipped-exists"]) console.log(`  skipped      ${r} (already exists, use --force to overwrite)`);
+  for (const r of byStatus["missing-source"]) console.log(`  MISSING      ${r} (not bundled in this package)`);
+
+  console.log(
+    `\n${byStatus.created.length} created, ${byStatus.overwritten.length} overwritten, ` +
+      `${byStatus["skipped-exists"].length} skipped, ${results.length} total.`
+  );
+
+  if (!opts.dryRun) {
+    console.log(
+      `\nDone. Open AGENTS.md / HUMAN.md, then start your AI tool in ${destRoot} to begin.`
+    );
+  }
+}
+
+main();

package/src/lib/materialize.js

@@ -1,140 +1,140 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-
-const PACKAGE_ROOT = path.resolve(__dirname, "..", "..");
-
-// Canonical, shipped source-of-truth core files live under src/ so they stay
-// separate from this repo's own self-hosting AGENTS.md/HUMAN.md at the root.
-// Each entry maps the package-relative source to the target-relative destination.
-const CORE_FILES = [
-  { src: "src/AGENTS.md", dest: "AGENTS.md" },
-  { src: "src/HUMAN.md", dest: "HUMAN.md" },
-];
-
-const TOOLS = {
-  claude: {
-    label: "Claude Code",
-    dirs: [".claude/agents", ".claude/skills"],
-    entry: {
-      file: "CLAUDE.md",
-      content: "@AGENTS.md\n",
-    },
-  },
-  codex: {
-    label: "Codex",
-    dirs: [".codex/agents", ".agents/skills"],
-    // Codex loads AGENTS.md directly from the workspace root; no separate
-    // config entry-point file is required.
-  },
-  copilot: {
-    label: "GitHub Copilot CLI",
-    dirs: [".github/agents", ".github/skills"],
-    entry: {
-      file: path.join(".github", "copilot-instructions.md"),
-      content:
-        "# Copilot instructions\n\n" +
-        "See [AGENTS.md](../AGENTS.md) for the agent rules and the agent/skill " +
-        "network that has been materialised into this repository.\n",
-    },
-  },
-};
-
-/**
- * Recursively list files under a directory (relative posix-ish paths).
- */
-function listFiles(dir) {
-  const results = [];
-  if (!fs.existsSync(dir)) return results;
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      results.push(...listFiles(full));
-    } else {
-      results.push(full);
-    }
-  }
-  return results;
-}
-
-/**
- * Copy a single file from the package root to the destination root. The source
- * and destination relative paths may differ (e.g. src/AGENTS.md -> AGENTS.md).
- * Returns a status object keyed by the destination path.
- */
-function copyOne(srcRel, destRel, destRoot, { force, dryRun }) {
-  const src = path.join(PACKAGE_ROOT, srcRel);
-  const dest = path.join(destRoot, destRel);
-
-  if (!fs.existsSync(src)) {
-    return { relPath: destRel, status: "missing-source" };
-  }
-
-  const exists = fs.existsSync(dest);
-  if (exists && !force) {
-    return { relPath: destRel, status: "skipped-exists" };
-  }
-
-  if (!dryRun) {
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.copyFileSync(src, dest);
-  }
-  return { relPath: destRel, status: exists ? "overwritten" : "created" };
-}
-
-/**
- * Write a small generated entry-point file (e.g. CLAUDE.md,
- * .github/copilot-instructions.md) rather than copying from the package.
- */
-function writeEntry(entry, destRoot, { force, dryRun }) {
-  const dest = path.join(destRoot, entry.file);
-  const exists = fs.existsSync(dest);
-  if (exists && !force) {
-    return { relPath: entry.file, status: "skipped-exists" };
-  }
-  if (!dryRun) {
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.writeFileSync(dest, entry.content, "utf8");
-  }
-  return { relPath: entry.file, status: exists ? "overwritten" : "created" };
-}
-
-/**
- * Materialise the requested tools' agent/skill files, plus the tool-agnostic
- * core files (AGENTS.md, HUMAN.md), into destRoot.
- *
- * @param {string[]} tools - subset of Object.keys(TOOLS)
- * @param {object} opts - { destRoot, force, dryRun }
- * @returns {{results: Array, tools: string[]}}
- */
-function materialize(tools, opts = {}) {
-  const destRoot = path.resolve(opts.destRoot || process.cwd());
-  const force = !!opts.force;
-  const dryRun = !!opts.dryRun;
-
-  const results = [];
-
-  for (const cf of CORE_FILES) {
-    results.push(copyOne(cf.src, cf.dest, destRoot, { force, dryRun }));
-  }
-
-  for (const toolName of tools) {
-    const tool = TOOLS[toolName];
-    if (!tool) continue;
-    for (const dir of tool.dirs) {
-      const files = listFiles(path.join(PACKAGE_ROOT, dir));
-      for (const abs of files) {
-        const relPath = path.relative(PACKAGE_ROOT, abs);
-        results.push(copyOne(relPath, relPath, destRoot, { force, dryRun }));
-      }
-    }
-    if (tool.entry) {
-      results.push(writeEntry(tool.entry, destRoot, { force, dryRun }));
-    }
-  }
-
-  return { results, tools, destRoot };
-}
-
-module.exports = { materialize, TOOLS, CORE_FILES, PACKAGE_ROOT };
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+const PACKAGE_ROOT = path.resolve(__dirname, "..", "..");
+
+// Canonical, shipped source-of-truth core files live under src/ so they stay
+// separate from this repo's own self-hosting AGENTS.md/HUMAN.md at the root.
+// Each entry maps the package-relative source to the target-relative destination.
+const CORE_FILES = [
+  { src: "src/AGENTS.md", dest: "AGENTS.md" },
+  { src: "src/HUMAN.md", dest: "HUMAN.md" },
+];
+
+const TOOLS = {
+  claude: {
+    label: "Claude Code",
+    dirs: [".claude/agents", ".claude/skills"],
+    entry: {
+      file: "CLAUDE.md",
+      content: "@AGENTS.md\n",
+    },
+  },
+  codex: {
+    label: "Codex",
+    dirs: [".codex/agents", ".agents/skills"],
+    // Codex loads AGENTS.md directly from the workspace root; no separate
+    // config entry-point file is required.
+  },
+  copilot: {
+    label: "GitHub Copilot CLI",
+    dirs: [".github/agents", ".github/skills"],
+    entry: {
+      file: path.join(".github", "copilot-instructions.md"),
+      content:
+        "# Copilot instructions\n\n" +
+        "See [AGENTS.md](../AGENTS.md) for the agent rules and the agent/skill " +
+        "network that has been materialised into this repository.\n",
+    },
+  },
+};
+
+/**
+ * Recursively list files under a directory (relative posix-ish paths).
+ */
+function listFiles(dir) {
+  const results = [];
+  if (!fs.existsSync(dir)) return results;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...listFiles(full));
+    } else {
+      results.push(full);
+    }
+  }
+  return results;
+}
+
+/**
+ * Copy a single file from the package root to the destination root. The source
+ * and destination relative paths may differ (e.g. src/AGENTS.md -> AGENTS.md).
+ * Returns a status object keyed by the destination path.
+ */
+function copyOne(srcRel, destRel, destRoot, { force, dryRun }) {
+  const src = path.join(PACKAGE_ROOT, srcRel);
+  const dest = path.join(destRoot, destRel);
+
+  if (!fs.existsSync(src)) {
+    return { relPath: destRel, status: "missing-source" };
+  }
+
+  const exists = fs.existsSync(dest);
+  if (exists && !force) {
+    return { relPath: destRel, status: "skipped-exists" };
+  }
+
+  if (!dryRun) {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(src, dest);
+  }
+  return { relPath: destRel, status: exists ? "overwritten" : "created" };
+}
+
+/**
+ * Write a small generated entry-point file (e.g. CLAUDE.md,
+ * .github/copilot-instructions.md) rather than copying from the package.
+ */
+function writeEntry(entry, destRoot, { force, dryRun }) {
+  const dest = path.join(destRoot, entry.file);
+  const exists = fs.existsSync(dest);
+  if (exists && !force) {
+    return { relPath: entry.file, status: "skipped-exists" };
+  }
+  if (!dryRun) {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, entry.content, "utf8");
+  }
+  return { relPath: entry.file, status: exists ? "overwritten" : "created" };
+}
+
+/**
+ * Materialise the requested tools' agent/skill files, plus the tool-agnostic
+ * core files (AGENTS.md, HUMAN.md), into destRoot.
+ *
+ * @param {string[]} tools - subset of Object.keys(TOOLS)
+ * @param {object} opts - { destRoot, force, dryRun }
+ * @returns {{results: Array, tools: string[]}}
+ */
+function materialize(tools, opts = {}) {
+  const destRoot = path.resolve(opts.destRoot || process.cwd());
+  const force = !!opts.force;
+  const dryRun = !!opts.dryRun;
+
+  const results = [];
+
+  for (const cf of CORE_FILES) {
+    results.push(copyOne(cf.src, cf.dest, destRoot, { force, dryRun }));
+  }
+
+  for (const toolName of tools) {
+    const tool = TOOLS[toolName];
+    if (!tool) continue;
+    for (const dir of tool.dirs) {
+      const files = listFiles(path.join(PACKAGE_ROOT, dir));
+      for (const abs of files) {
+        const relPath = path.relative(PACKAGE_ROOT, abs);
+        results.push(copyOne(relPath, relPath, destRoot, { force, dryRun }));
+      }
+    }
+    if (tool.entry) {
+      results.push(writeEntry(tool.entry, destRoot, { force, dryRun }));
+    }
+  }
+
+  return { results, tools, destRoot };
+}
+
+module.exports = { materialize, TOOLS, CORE_FILES, PACKAGE_ROOT };