agentboot 0.1.0

package/scripts/dev-sync.ts

@@ -0,0 +1,149 @@
+/**
+ * Dev-only: syncs all platform distributions to their native locations
+ * in the current repo for local dogfooding. Gitignored output only.
+ *
+ * This is NOT the production sync script (sync.ts). This is a convenience
+ * for developing AgentBoot itself with its own personas loaded.
+ *
+ * Usage:
+ *   npm run dev-sync         (after npm run build)
+ *   npm run full-build && npm run dev-sync
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import chalk from "chalk";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, "..");
+const DIST = path.join(ROOT, "dist");
+
+function copyRecursive(src: string, dest: string): number {
+  let count = 0;
+  if (!fs.existsSync(src)) return count;
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      count += copyRecursive(srcPath, destPath);
+    } else {
+      fs.mkdirSync(path.dirname(destPath), { recursive: true });
+      fs.copyFileSync(srcPath, destPath);
+      count++;
+    }
+  }
+  return count;
+}
+
+/**
+ * Remove only files that exist in the source tree from the destination.
+ * This avoids destroying manually-created files (e.g., .claude/rules/ or
+ * .claude/settings.json that are checked into the repo).
+ */
+function cleanMatchingFiles(src: string, dest: string): void {
+  if (!fs.existsSync(src) || !fs.existsSync(dest)) return;
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const destPath = path.join(dest, entry.name);
+    if (!fs.existsSync(destPath)) continue;
+
+    if (entry.isDirectory()) {
+      cleanMatchingFiles(path.join(src, entry.name), destPath);
+      // Remove directory only if now empty
+      try {
+        const remaining = fs.readdirSync(destPath);
+        if (remaining.length === 0) fs.rmdirSync(destPath);
+      } catch { /* ignore */ }
+    } else {
+      fs.unlinkSync(destPath);
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Platform sync definitions
+// ---------------------------------------------------------------------------
+
+const platforms: Array<{
+  name: string;
+  distSubdir: string;
+  repoTarget: string;
+  available: boolean;
+}> = [
+  {
+    name: "claude",
+    distSubdir: "claude/core",
+    repoTarget: ".claude",
+    available: false,
+  },
+  {
+    name: "copilot",
+    distSubdir: "copilot/core",
+    repoTarget: ".github/copilot",
+    available: false,
+  },
+  {
+    name: "cursor",
+    distSubdir: "cursor/core",
+    repoTarget: ".cursor/agentboot",
+    available: false,
+  },
+  {
+    name: "skill",
+    distSubdir: "skill/core",
+    repoTarget: ".agentboot/skill",
+    available: false,
+  },
+  {
+    name: "gemini",
+    distSubdir: "gemini/core",
+    repoTarget: ".gemini/agentboot",
+    available: false,
+  },
+];
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+console.log(chalk.bold("\nAgentBoot — dev-sync"));
+
+if (!fs.existsSync(DIST)) {
+  console.error(chalk.red("✗ dist/ not found. Run `npm run build` first."));
+  process.exit(1);
+}
+
+let totalFiles = 0;
+
+for (const platform of platforms) {
+  const src = path.join(DIST, platform.distSubdir);
+  if (!fs.existsSync(src)) {
+    continue;
+  }
+
+  platform.available = true;
+  const dest = path.join(ROOT, platform.repoTarget);
+  cleanMatchingFiles(src, dest);
+  const count = copyRecursive(src, dest);
+  totalFiles += count;
+
+  console.log(`  ${chalk.green("✓")} ${platform.name} → ${platform.repoTarget}/ (${count} files)`);
+}
+
+const skipped = platforms.filter((p) => !p.available);
+if (skipped.length > 0) {
+  console.log(chalk.gray(`  (not built: ${skipped.map((p) => p.name).join(", ")})`));
+}
+
+console.log(
+  chalk.bold(`\n${chalk.green("✓")} Dev-synced ${totalFiles} files across ${platforms.filter((p) => p.available).length} platforms (gitignored)`)
+);
+
+if (totalFiles > 0) {
+  console.log(chalk.yellow("\n  ⚠ Restart Claude Code to pick up persona changes\n"));
+}

package/scripts/lib/config.ts

@@ -0,0 +1,137 @@
+/**
+ * Shared configuration types and utilities used by validate, compile, and sync scripts.
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface AgentBootConfig {
+  org: string;
+  orgDisplayName?: string;
+  groups?: Record<string, GroupConfig>;
+  personas?: {
+    enabled?: string[];
+    customDir?: string;
+    outputFormats?: string[];
+  };
+  traits?: {
+    enabled?: string[];
+  };
+  instructions?: {
+    enabled?: string[];
+  };
+  output?: {
+    distPath?: string;
+    provenanceHeaders?: boolean;
+    failOnDirtyDist?: boolean;
+    tokenBudget?: { warnAt?: number };
+  };
+  sync?: {
+    repos?: string;
+    targetDir?: string;
+    writePersonasIndex?: boolean;
+    dryRun?: boolean;
+    pr?: {
+      enabled?: boolean;
+      branchPrefix?: string;
+      titleTemplate?: string;
+    };
+  };
+  claude?: {
+    hooks?: Record<string, unknown>;
+    permissions?: { allow?: string[]; deny?: string[] };
+    mcpServers?: Record<string, unknown>;
+  };
+  validation?: {
+    secretPatterns?: string[];
+    strictMode?: boolean;
+  };
+}
+
+export interface GroupConfig {
+  teams?: string[];
+}
+
+export interface PersonaConfig {
+  name: string;
+  description: string;
+  invocation?: string;
+  model?: string;
+  permissionMode?: string;
+  traits?: string[];
+  groups?: Record<string, { traits?: string[] }>;
+  teams?: Record<string, { traits?: string[] }>;
+}
+
+// ---------------------------------------------------------------------------
+// JSONC stripping
+// ---------------------------------------------------------------------------
+
+/**
+ * Strip single-line // comments from a JSONC string, respecting string literals.
+ * Tracks whether we are inside a quoted string (handling escaped quotes) before
+ * deciding to truncate a line at a // comment.
+ */
+export function stripJsoncComments(raw: string): string {
+  const lines = raw.split("\n");
+  const result: string[] = [];
+
+  for (const line of lines) {
+    let inString = false;
+    let i = 0;
+    let out = "";
+
+    while (i < line.length) {
+      const ch = line[i]!;
+
+      if (inString) {
+        out += ch;
+        if (ch === "\\" && i + 1 < line.length) {
+          i++;
+          out += line[i]!;
+        } else if (ch === '"') {
+          inString = false;
+        }
+      } else {
+        if (ch === '"') {
+          inString = true;
+          out += ch;
+        } else if (ch === "/" && line[i + 1] === "/") {
+          break;
+        } else {
+          out += ch;
+        }
+      }
+      i++;
+    }
+
+    result.push(out.trimEnd());
+  }
+
+  return result.join("\n");
+}
+
+// ---------------------------------------------------------------------------
+// Config loading
+// ---------------------------------------------------------------------------
+
+export function resolveConfigPath(argv: string[], root: string): string {
+  const idx = argv.indexOf("--config");
+  if (idx !== -1 && argv[idx + 1]) {
+    return path.resolve(argv[idx + 1]!);
+  }
+  return path.join(root, "agentboot.config.json");
+}
+
+export function loadConfig(configPath: string): AgentBootConfig {
+  if (!fs.existsSync(configPath)) {
+    throw new Error(`Config file not found: ${configPath}`);
+  }
+  const raw = fs.readFileSync(configPath, "utf-8");
+  const stripped = stripJsoncComments(raw);
+  return JSON.parse(stripped) as AgentBootConfig;
+}

package/scripts/lib/frontmatter.ts

@@ -0,0 +1,61 @@
+/**
+ * Shared frontmatter and secret-scanning utilities.
+ *
+ * Used by both the validate script and the test suite.
+ */
+
+// ---------------------------------------------------------------------------
+// Frontmatter parsing
+// ---------------------------------------------------------------------------
+
+const FRONTMATTER_RE = /^---\n([\s\S]+?)\n---/;
+
+export function parseFrontmatter(content: string): Map<string, string> | null {
+  const match = FRONTMATTER_RE.exec(content);
+  if (!match) return null;
+
+  const lines = (match[1] ?? "").split("\n");
+  const fields = new Map<string, string>();
+
+  for (const line of lines) {
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) continue;
+    const key = line.slice(0, colonIdx).trim();
+    const value = line.slice(colonIdx + 1).trim();
+    fields.set(key, value);
+  }
+
+  return fields;
+}
+
+// ---------------------------------------------------------------------------
+// Secret scanning
+// ---------------------------------------------------------------------------
+
+export const DEFAULT_SECRET_PATTERNS: RegExp[] = [
+  /(?:password|passwd|pwd)\s*[:=]\s*['"][^'"]+['"]/i,
+  /(?:api[_-]?key|apikey)\s*[:=]\s*['"][^'"]+['"]/i,
+  /(?:secret|token)\s*[:=]\s*['"][^'"]+['"]/i,
+  /aws[_-]?(?:access[_-]?key|secret[_-]?key)/i,
+  /-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----/,
+  /(?:ghp|gho|ghu|ghs|ghr)_[A-Za-z0-9]{36}/,  // GitHub tokens
+  /xox[baprs]-[0-9A-Za-z-]+/,                   // Slack tokens
+];
+
+export function scanForSecrets(
+  content: string,
+  patterns: RegExp[] = DEFAULT_SECRET_PATTERNS
+): Array<{ line: number; pattern: string }> {
+  const hits: Array<{ line: number; pattern: string }> = [];
+  const lines = content.split("\n");
+
+  for (let i = 0; i < lines.length; i++) {
+    for (const pattern of patterns) {
+      if (pattern.test(lines[i]!)) {
+        hits.push({ line: i + 1, pattern: pattern.source });
+      }
+    }
+  }
+
+  return hits;
+}