@hasna/configs 0.1.5 → 0.2.1

package/dist/cli/index.js

@@ -2127,6 +2127,9 @@ function getDatabase(path) {
   _db = db;
   return db;
 }
+function resetDatabase() {
+  _db = null;
+}
 function applyMigrations(db) {
   let currentVersion = 0;
   try {
@@ -2391,6 +2394,12 @@ var init_snapshots = __esm(() => {
 });
 
 // src/lib/apply.ts
+var exports_apply = {};
+__export(exports_apply, {
+  expandPath: () => expandPath,
+  applyConfigs: () => applyConfigs,
+  applyConfig: () => applyConfig
+});
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, writeFileSync } from "fs";
 import { dirname as dirname2, resolve as resolve2 } from "path";
 import { homedir } from "os";
@@ -2715,17 +2724,81 @@ var exports_sync = {};
 __export(exports_sync, {
   syncToDisk: () => syncToDisk,
   syncToDir: () => syncToDir,
+  syncProject: () => syncProject,
   syncKnown: () => syncKnown,
   syncFromDir: () => syncFromDir,
   diffConfig: () => diffConfig,
   detectFormat: () => detectFormat,
   detectCategory: () => detectCategory,
   detectAgent: () => detectAgent,
+  PROJECT_CONFIG_FILES: () => PROJECT_CONFIG_FILES,
   KNOWN_CONFIGS: () => KNOWN_CONFIGS
 });
 import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync as readFileSync3 } from "fs";
 import { extname, join as join3 } from "path";
 import { homedir as homedir3 } from "os";
+async function syncProject(opts) {
+  const d = opts.db || getDatabase();
+  const absDir = expandPath(opts.projectDir);
+  const projectName = absDir.split("/").pop() || "project";
+  const result = { added: 0, updated: 0, unchanged: 0, skipped: [] };
+  const allConfigs = listConfigs(undefined, d);
+  for (const pf of PROJECT_CONFIG_FILES) {
+    const abs = join3(absDir, pf.file);
+    if (!existsSync4(abs))
+      continue;
+    try {
+      const rawContent = readFileSync3(abs, "utf-8");
+      if (rawContent.length > 500000) {
+        result.skipped.push(pf.file);
+        continue;
+      }
+      const { content, isTemplate } = redactContent(rawContent, pf.format);
+      const name = `${projectName}/${pf.file}`;
+      const targetPath = abs.replace(homedir3(), "~");
+      const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-");
+      const existing = allConfigs.find((c) => c.target_path === targetPath || c.slug === slug);
+      if (!existing) {
+        if (!opts.dryRun)
+          createConfig({ name, category: pf.category, agent: pf.agent, format: pf.format, content, target_path: targetPath, is_template: isTemplate }, d);
+        result.added++;
+      } else if (existing.content !== content) {
+        if (!opts.dryRun)
+          updateConfig(existing.id, { content, is_template: isTemplate }, d);
+        result.updated++;
+      } else {
+        result.unchanged++;
+      }
+    } catch {
+      result.skipped.push(pf.file);
+    }
+  }
+  const rulesDir = join3(absDir, ".claude", "rules");
+  if (existsSync4(rulesDir)) {
+    const mdFiles = readdirSync2(rulesDir).filter((f) => f.endsWith(".md"));
+    for (const f of mdFiles) {
+      const abs = join3(rulesDir, f);
+      const raw = readFileSync3(abs, "utf-8");
+      const { content, isTemplate } = redactContent(raw, "markdown");
+      const name = `${projectName}/rules/${f}`;
+      const targetPath = abs.replace(homedir3(), "~");
+      const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-");
+      const existing = allConfigs.find((c) => c.target_path === targetPath || c.slug === slug);
+      if (!existing) {
+        if (!opts.dryRun)
+          createConfig({ name, category: "rules", agent: "claude", format: "markdown", content, target_path: targetPath, is_template: isTemplate }, d);
+        result.added++;
+      } else if (existing.content !== content) {
+        if (!opts.dryRun)
+          updateConfig(existing.id, { content, is_template: isTemplate }, d);
+        result.updated++;
+      } else {
+        result.unchanged++;
+      }
+    }
+  }
+  return result;
+}
 async function syncKnown(opts = {}) {
   const d = opts.db || getDatabase();
   const result = { added: 0, updated: 0, unchanged: 0, skipped: [] };
@@ -2904,7 +2977,7 @@ function detectFormat(filePath) {
     return "ini";
   return "text";
 }
-var KNOWN_CONFIGS;
+var KNOWN_CONFIGS, PROJECT_CONFIG_FILES;
 var init_sync = __esm(() => {
   init_database();
   init_configs();
@@ -2931,6 +3004,15 @@ var init_sync = __esm(() => {
     { path: "~/.npmrc", name: "npmrc", category: "tools", agent: "npm", format: "ini" },
     { path: "~/.bunfig.toml", name: "bunfig", category: "tools", agent: "global", format: "toml" }
   ];
+  PROJECT_CONFIG_FILES = [
+    { file: "CLAUDE.md", category: "rules", agent: "claude", format: "markdown" },
+    { file: ".claude/settings.json", category: "agent", agent: "claude", format: "json" },
+    { file: ".claude/settings.local.json", category: "agent", agent: "claude", format: "json" },
+    { file: ".mcp.json", category: "mcp", agent: "claude", format: "json" },
+    { file: "AGENTS.md", category: "rules", agent: "codex", format: "markdown" },
+    { file: ".codex/AGENTS.md", category: "rules", agent: "codex", format: "markdown" },
+    { file: "GEMINI.md", category: "rules", agent: "gemini", format: "markdown" }
+  ];
 });
 
 // node_modules/commander/esm.mjs
@@ -3022,6 +3104,7 @@ function getProfileConfigs(profileIdOrSlug, db) {
 
 // src/cli/index.tsx
 init_snapshots();
+init_database();
 init_apply();
 init_sync();
 init_redact();
@@ -3171,7 +3254,8 @@ function fmtConfig(c, format) {
   ].filter(Boolean).join(`
 `);
 }
-program.command("list").alias("ls").description("List stored configs").option("-c, --category <cat>", "filter by category").option("-a, --agent <agent>", "filter by agent").option("-k, --kind <kind>", "filter by kind (file|reference)").option("-t, --tag <tag>", "filter by tag").option("-s, --search <query>", "search name/description/content").option("-f, --format <fmt>", "output format: table|json|compact", "table").action(async (opts) => {
+program.command("list").alias("ls").description("List stored configs").option("-c, --category <cat>", "filter by category").option("-a, --agent <agent>", "filter by agent").option("-k, --kind <kind>", "filter by kind (file|reference)").option("-t, --tag <tag>", "filter by tag").option("-s, --search <query>", "search name/description/content").option("-f, --format <fmt>", "output format: table|json|compact", "table").option("--brief", "shorthand for --format compact").action(async (opts) => {
+  const fmt = opts.brief ? "compact" : opts.format;
   const configs = listConfigs({
     category: opts.category,
     agent: opts.agent,
@@ -3183,13 +3267,13 @@ program.command("list").alias("ls").description("List stored configs").option("-
     console.log(chalk.dim("No configs found."));
     return;
   }
-  if (opts.format === "json") {
+  if (fmt === "json") {
     console.log(JSON.stringify(configs, null, 2));
     return;
   }
   for (const c of configs) {
-    console.log(fmtConfig(c, opts.format));
-    if (opts.format === "table")
+    console.log(fmtConfig(c, fmt));
+    if (fmt === "table")
       console.log();
   }
   console.log(chalk.dim(`${configs.length} config(s)`));
@@ -3256,17 +3340,33 @@ program.command("apply <id>").description("Apply a config to its target_path on
     process.exit(1);
   }
 });
-program.command("diff <id>").description("Show diff between stored config and disk").action(async (id) => {
+program.command("diff [id]").description("Show diff between stored config and disk (omit id for --all)").option("--all", "diff every known config against disk").action(async (id, opts) => {
   try {
-    const config = getConfig(id);
-    const diff = diffConfig(config);
-    console.log(diff);
+    if (id) {
+      const config = getConfig(id);
+      console.log(diffConfig(config));
+      return;
+    }
+    const configs = listConfigs({ kind: "file" });
+    let drifted = 0;
+    for (const c of configs) {
+      if (!c.target_path)
+        continue;
+      const diff = diffConfig(c);
+      if (diff.includes("no diff") || diff.includes("not found"))
+        continue;
+      drifted++;
+      console.log(chalk.bold(c.slug) + chalk.dim(` (${c.target_path})`));
+      console.log(diff);
+      console.log();
+    }
+    console.log(chalk.dim(`${drifted}/${configs.length} drifted`));
   } catch (e) {
     console.error(chalk.red(e instanceof Error ? e.message : String(e)));
     process.exit(1);
   }
 });
-program.command("sync").description("Sync known AI coding configs from disk into DB (claude, codex, gemini, zsh, git, npm)").option("-a, --agent <agent>", "only sync configs for this agent (claude|codex|gemini|zsh|git|npm)").option("-c, --category <cat>", "only sync configs in this category").option("--to-disk", "apply DB configs back to disk instead").option("--dry-run", "preview without writing").option("--list", "show which files would be synced without doing anything").action(async (opts) => {
+program.command("sync").description("Sync known AI coding configs from disk into DB (claude, codex, gemini, zsh, git, npm)").option("-a, --agent <agent>", "only sync configs for this agent (claude|codex|gemini|zsh|git|npm)").option("-c, --category <cat>", "only sync configs in this category").option("-p, --project [dir]", "sync project-scoped configs (CLAUDE.md, .mcp.json, etc.) from a project dir").option("--to-disk", "apply DB configs back to disk instead").option("--dry-run", "preview without writing").option("--list", "show which files would be synced without doing anything").action(async (opts) => {
   if (opts.list) {
     const targets = KNOWN_CONFIGS.filter((k) => {
       if (opts.agent && k.agent !== opts.agent)
@@ -3281,6 +3381,12 @@ program.command("sync").description("Sync known AI coding configs from disk into
     }
     return;
   }
+  if (opts.project) {
+    const dir = typeof opts.project === "string" ? opts.project : process.cwd();
+    const result = await syncProject({ projectDir: dir, dryRun: opts.dryRun });
+    console.log(chalk.green("\u2713") + ` Project sync: +${result.added} updated:${result.updated} unchanged:${result.unchanged} skipped:${result.skipped.length}`);
+    return;
+  }
   if (opts.toDisk) {
     const result = await syncToDisk({ dryRun: opts.dryRun, agent: opts.agent, category: opts.category });
     console.log(chalk.green("\u2713") + ` Written to disk: updated:${result.updated} unchanged:${result.unchanged} skipped:${result.skipped.length}`);
@@ -3332,13 +3438,22 @@ program.command("whoami").description("Show setup summary").action(async () => {
   }
 });
 var profileCmd = program.command("profile").description("Manage config profiles (named bundles)");
-profileCmd.command("list").description("List all profiles").action(async () => {
+profileCmd.command("list").description("List all profiles").option("--brief", "compact one-line output").option("-f, --format <fmt>", "table|json|compact", "table").action(async (opts) => {
+  const fmt = opts.brief ? "compact" : opts.format;
   const profiles = listProfiles();
   if (profiles.length === 0) {
     console.log(chalk.dim("No profiles."));
     return;
   }
+  if (fmt === "json") {
+    console.log(JSON.stringify(profiles, null, 2));
+    return;
+  }
   for (const p of profiles) {
+    if (fmt === "compact") {
+      console.log(`${p.slug} ${getProfileConfigs(p.id).length} configs`);
+      continue;
+    }
     const configs = getProfileConfigs(p.id);
     console.log(`${chalk.bold(p.name)} ${chalk.dim(`(${p.slug})`)} \u2014 ${configs.length} config(s)`);
     if (p.description)
@@ -3518,5 +3633,305 @@ program.command("scan [id]").description("Scan configs for secrets. Defaults to
 Run with --fix to redact in-place.`));
   }
 });
+var mcpCmd = program.command("mcp").description("Install/remove MCP server for AI agents");
+mcpCmd.command("install").alias("add").description("Install configs MCP server into an agent").option("--claude", "install into Claude Code").option("--codex", "install into Codex").option("--gemini", "install into Gemini").option("--all", "install into all agents").action(async (opts) => {
+  const targets = opts.all ? ["claude", "codex", "gemini"] : [
+    ...opts.claude ? ["claude"] : [],
+    ...opts.codex ? ["codex"] : [],
+    ...opts.gemini ? ["gemini"] : []
+  ];
+  if (targets.length === 0) {
+    console.log(chalk.dim("Specify --claude, --codex, --gemini, or --all"));
+    return;
+  }
+  for (const target of targets) {
+    try {
+      if (target === "claude") {
+        const proc = Bun.spawn(["claude", "mcp", "add", "--transport", "stdio", "--scope", "user", "configs", "--", "configs-mcp"], { stdout: "inherit", stderr: "inherit" });
+        await proc.exited;
+        console.log(chalk.green("\u2713") + " Installed into Claude Code");
+      } else if (target === "codex") {
+        const { appendFileSync, existsSync: ex } = await import("fs");
+        const { join: j } = await import("path");
+        const configPath = j(homedir4(), ".codex", "config.toml");
+        const block = `
+[mcp_servers.configs]
+command = "configs-mcp"
+args = []
+`;
+        if (ex(configPath)) {
+          const content = readFileSync5(configPath, "utf-8");
+          if (content.includes("[mcp_servers.configs]")) {
+            console.log(chalk.dim("= Already installed in Codex"));
+            continue;
+          }
+        }
+        appendFileSync(configPath, block);
+        console.log(chalk.green("\u2713") + " Installed into Codex");
+      } else if (target === "gemini") {
+        const { readFileSync: rf, writeFileSync: wf, existsSync: ex } = await import("fs");
+        const { join: j } = await import("path");
+        const configPath = j(homedir4(), ".gemini", "settings.json");
+        let settings = {};
+        if (ex(configPath)) {
+          try {
+            settings = JSON.parse(rf(configPath, "utf-8"));
+          } catch {}
+        }
+        const mcpServers = settings["mcpServers"] ?? {};
+        mcpServers["configs"] = { command: "configs-mcp", args: [] };
+        settings["mcpServers"] = mcpServers;
+        wf(configPath, JSON.stringify(settings, null, 2) + `
+`, "utf-8");
+        console.log(chalk.green("\u2713") + " Installed into Gemini");
+      }
+    } catch (e) {
+      console.error(chalk.red(`\u2717 Failed to install into ${target}: ${e instanceof Error ? e.message : String(e)}`));
+    }
+  }
+});
+mcpCmd.command("uninstall").alias("remove").description("Remove configs MCP server from agents").option("--claude", "remove from Claude Code").option("--all", "remove from all agents").action(async (opts) => {
+  if (opts.claude || opts.all) {
+    const proc = Bun.spawn(["claude", "mcp", "remove", "configs"], { stdout: "inherit", stderr: "inherit" });
+    await proc.exited;
+    console.log(chalk.green("\u2713") + " Removed from Claude Code");
+  }
+});
+program.command("init").description("First-time setup: sync all known configs, create default profile").option("--force", "delete existing DB and start fresh").action(async (opts) => {
+  const dbPath = join6(homedir4(), ".configs", "configs.db");
+  if (opts.force && existsSync7(dbPath)) {
+    const { rmSync: rmSync3 } = await import("fs");
+    rmSync3(dbPath);
+    console.log(chalk.dim("Deleted existing DB."));
+    resetDatabase();
+  }
+  console.log(chalk.bold(`@hasna/configs \u2014 initializing
+`));
+  const result = await syncKnown({});
+  console.log(chalk.green("\u2713") + ` Synced: +${result.added} updated:${result.updated} unchanged:${result.unchanged}`);
+  if (result.skipped.length > 0) {
+    console.log(chalk.dim("  skipped: " + result.skipped.join(", ")));
+  }
+  const refs = [
+    { slug: "workspace-structure", name: "Workspace Structure", category: "workspace", content: `# Workspace Structure
+
+See ~/.claude/rules/workspace.md for full conventions.`, desc: "~/Workspace/ hierarchy and naming" },
+    { slug: "secrets-schema", name: "Secrets Schema", category: "secrets_schema", content: `# .secrets Schema
+
+Location: ~/.secrets (sourced by ~/.zshrc)
+Format: export KEY_NAME="value"
+
+Keys: ANTHROPIC_API_KEY, OPENAI_API_KEY, EXA_API_KEY, NPM_TOKEN, GITHUB_TOKEN`, desc: "Shape of ~/.secrets (no values)" }
+  ];
+  for (const ref of refs) {
+    try {
+      getConfig(ref.slug);
+    } catch {
+      createConfig({ name: ref.name, category: ref.category, agent: "global", format: "markdown", content: ref.content, kind: "reference", description: ref.desc });
+    }
+  }
+  try {
+    getProfile("my-setup");
+  } catch {
+    const p = createProfile({ name: "my-setup", description: "Default profile with all known configs" });
+    const allConfigs = listConfigs();
+    for (const c of allConfigs)
+      addConfigToProfile(p.id, c.id);
+    console.log(chalk.green("\u2713") + ` Created profile "my-setup" with ${allConfigs.length} configs`);
+  }
+  const stats = getConfigStats();
+  console.log(chalk.bold(`
+DB stats:`));
+  for (const [key, count] of Object.entries(stats)) {
+    if (count > 0)
+      console.log(`  ${key.padEnd(18)} ${count}`);
+  }
+  console.log(chalk.dim(`
+DB: ${dbPath}`));
+});
+program.command("status").description("Health check: total configs, drift from disk, unredacted secrets").action(async () => {
+  const dbPath = join6(homedir4(), ".configs", "configs.db");
+  const stats = getConfigStats();
+  const { statSync: st } = await import("fs");
+  const dbSize = existsSync7(dbPath) ? st(dbPath).size : 0;
+  console.log(chalk.bold("@hasna/configs") + chalk.dim(` v${pkg.version}`));
+  console.log(chalk.cyan("DB:") + ` ${dbPath} (${(dbSize / 1024).toFixed(1)}KB)`);
+  console.log(chalk.cyan("Total:") + ` ${stats["total"] || 0} configs
+`);
+  const allKnown = listConfigs({ kind: "file" });
+  let drifted = 0;
+  let missing = 0;
+  let secrets = 0;
+  let templates = 0;
+  for (const c of allKnown) {
+    if (!c.target_path)
+      continue;
+    const path = expandPath(c.target_path);
+    if (!existsSync7(path)) {
+      missing++;
+      continue;
+    }
+    const disk = readFileSync5(path, "utf-8");
+    const { content: redactedDisk } = redactContent(disk, c.format);
+    if (redactedDisk !== c.content)
+      drifted++;
+    if (c.is_template)
+      templates++;
+    const found = scanSecrets(c.content, c.format);
+    secrets += found.length;
+  }
+  console.log(chalk.cyan("Drifted:") + ` ${drifted === 0 ? chalk.green("0") : chalk.yellow(String(drifted))} (stored \u2260 disk)`);
+  console.log(chalk.cyan("Missing:") + ` ${missing === 0 ? chalk.green("0") : chalk.yellow(String(missing))} (file not on disk)`);
+  console.log(chalk.cyan("Secrets:") + ` ${secrets === 0 ? chalk.green("0 \u2713") : chalk.red(String(secrets) + " \u26A0")} unredacted`);
+  console.log(chalk.cyan("Templates:") + ` ${templates} (with {{VAR}} placeholders)`);
+});
+program.command("backup").description("Export configs to a timestamped backup file").action(async () => {
+  const { mkdirSync: mk } = await import("fs");
+  const backupDir = join6(homedir4(), ".configs", "backups");
+  mk(backupDir, { recursive: true });
+  const ts = new Date().toISOString().replace(/[:.]/g, "-").replace("T", "-").slice(0, 19);
+  const outPath = join6(backupDir, `configs-${ts}.tar.gz`);
+  const result = await exportConfigs(outPath);
+  const { statSync: st } = await import("fs");
+  const size = st(outPath).size;
+  console.log(chalk.green("\u2713") + ` Backup: ${result.count} configs \u2192 ${outPath} (${(size / 1024).toFixed(1)}KB)`);
+});
+program.command("restore <file>").description("Restore configs from a backup file").option("--overwrite", "overwrite existing configs (default: skip)").action(async (file, opts) => {
+  const result = await importConfigs(file, { conflict: opts.overwrite ? "overwrite" : "skip" });
+  console.log(chalk.green("\u2713") + ` Restored: +${result.created} updated:${result.updated} skipped:${result.skipped}`);
+  if (result.errors.length > 0) {
+    for (const e of result.errors)
+      console.log(chalk.red("  " + e));
+  }
+});
+program.command("doctor").description("Validate configs: syntax, permissions, missing files, secrets").action(async () => {
+  let issues = 0;
+  const pass = (msg) => console.log(chalk.green("  \u2713 ") + msg);
+  const fail = (msg) => {
+    issues++;
+    console.log(chalk.red("  \u2717 ") + msg);
+  };
+  console.log(chalk.bold(`Config Doctor
+`));
+  console.log(chalk.cyan("Known files on disk:"));
+  for (const k of KNOWN_CONFIGS) {
+    if (k.rulesDir) {
+      existsSync7(expandPath(k.rulesDir)) ? pass(`${k.rulesDir}/ exists`) : fail(`${k.rulesDir}/ not found`);
+    } else {
+      existsSync7(expandPath(k.path)) ? pass(k.path) : fail(`${k.path} not found`);
+    }
+  }
+  const allConfigs = listConfigs();
+  console.log(chalk.cyan(`
+Stored configs (${allConfigs.length}):`));
+  let validCount = 0;
+  for (const c of allConfigs) {
+    if (c.format === "json") {
+      try {
+        JSON.parse(c.content);
+        validCount++;
+      } catch {
+        fail(`${c.slug}: invalid JSON`);
+      }
+    } else {
+      validCount++;
+    }
+  }
+  pass(`${validCount}/${allConfigs.length} valid syntax`);
+  let secretCount = 0;
+  for (const c of allConfigs) {
+    const found = scanSecrets(c.content, c.format);
+    secretCount += found.length;
+  }
+  secretCount === 0 ? pass("No unredacted secrets") : fail(`${secretCount} unredacted secret(s) \u2014 run \`configs scan --fix\``);
+  console.log(`
+${issues === 0 ? chalk.green("\u2713 All checks passed") : chalk.yellow(`${issues} issue(s) found`)}`);
+});
+program.command("completions [shell]").description("Output shell completion script (zsh or bash)").action(async (shell) => {
+  const sh = shell || "zsh";
+  if (sh === "zsh") {
+    console.log(`#compdef configs
+_configs() {
+  local -a commands
+  commands=(
+    'list:List stored configs'
+    'show:Show a config'
+    'add:Ingest a file into the DB'
+    'apply:Apply a config to disk'
+    'diff:Show diff stored vs disk'
+    'sync:Sync known configs from disk'
+    'export:Export as tar.gz'
+    'import:Import from tar.gz'
+    'whoami:Setup summary'
+    'status:Health check'
+    'init:First-time setup'
+    'scan:Scan for secrets'
+    'profile:Manage profiles'
+    'snapshot:Version history'
+    'template:Template operations'
+    'mcp:Install MCP server'
+    'backup:Export to timestamped backup'
+    'restore:Import from backup'
+    'doctor:Validate configs'
+    'completions:Output shell completions'
+  )
+  _describe 'command' commands
+}
+compdef _configs configs`);
+  } else {
+    console.log(`# bash completion for configs
+_configs_completions() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}"
+  local commands="list show add apply diff sync export import whoami status init scan profile snapshot template mcp backup restore doctor completions"
+  COMPREPLY=( $(compgen -W "\${commands}" -- "\${cur}") )
+}
+complete -F _configs_completions configs`);
+  }
+});
+program.command("watch").description("Watch known config files for changes and auto-sync to DB").option("-i, --interval <ms>", "poll interval in milliseconds", "3000").action(async (opts) => {
+  const interval = Number(opts.interval);
+  const { statSync: st } = await import("fs");
+  const { expandPath: expandPath2 } = await Promise.resolve().then(() => (init_apply(), exports_apply));
+  console.log(chalk.bold("@hasna/configs watch") + chalk.dim(` \u2014 polling every ${interval}ms`));
+  console.log(chalk.dim(`Watching known config files for changes\u2026
+`));
+  const mtimes = new Map;
+  for (const k of KNOWN_CONFIGS) {
+    if (k.rulesDir) {
+      const absDir = expandPath2(k.rulesDir);
+      if (!existsSync7(absDir))
+        continue;
+      const { readdirSync: readdirSync3 } = await import("fs");
+      for (const f of readdirSync3(absDir).filter((f2) => f2.endsWith(".md"))) {
+        const abs = join6(absDir, f);
+        mtimes.set(abs, st(abs).mtimeMs);
+      }
+    } else {
+      const abs = expandPath2(k.path);
+      if (existsSync7(abs))
+        mtimes.set(abs, st(abs).mtimeMs);
+    }
+  }
+  console.log(chalk.dim(`Tracking ${mtimes.size} files`));
+  const tick = async () => {
+    let changed = 0;
+    for (const [abs, oldMtime] of mtimes) {
+      if (!existsSync7(abs))
+        continue;
+      const newMtime = st(abs).mtimeMs;
+      if (newMtime !== oldMtime) {
+        changed++;
+        mtimes.set(abs, newMtime);
+      }
+    }
+    if (changed > 0) {
+      const result = await syncKnown({});
+      const ts = new Date().toLocaleTimeString();
+      console.log(`${chalk.dim(ts)} ${chalk.green("\u2713")} ${changed} file(s) changed \u2192 synced +${result.added} updated:${result.updated}`);
+    }
+  };
+  setInterval(tick, interval);
+  await new Promise(() => {});
+});
 program.version(pkg.version).name("configs");
 program.parse(process.argv);

package/dist/lib/sync.d.ts

@@ -11,6 +11,18 @@ export interface KnownConfig {
     rulesDir?: string;
 }
 export declare const KNOWN_CONFIGS: KnownConfig[];
+export declare const PROJECT_CONFIG_FILES: {
+    file: string;
+    category: ConfigCategory;
+    agent: ConfigAgent;
+    format: ConfigFormat;
+}[];
+export interface SyncProjectOptions {
+    db?: ReturnType<typeof getDatabase>;
+    dryRun?: boolean;
+    projectDir: string;
+}
+export declare function syncProject(opts: SyncProjectOptions): Promise<SyncResult>;
 export interface SyncKnownOptions {
     db?: ReturnType<typeof getDatabase>;
     dryRun?: boolean;

package/dist/lib/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/lib/sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACvG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EAiCtC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,wBAAsB,SAAS,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4EhF;AAGD,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgBlF;AAGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqBjD;AAGD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAU/D;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CASzD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAQ3D;AAGD,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/lib/sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACvG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EAiCtC,CAAC;AAIF,eAAO,MAAM,oBAAoB;;cAC2B,cAAc;WAAsB,WAAW;YAAwB,YAAY;GAO9I,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuD/E;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,wBAAsB,SAAS,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4EhF;AAGD,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgBlF;AAGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqBjD;AAGD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAU/D;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CASzD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAQ3D;AAGD,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";;;;;AA2MA,wBAAgD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";;;;;AAkPA,wBAAgD"}

package/dist/server/index.js

@@ -2083,14 +2083,64 @@ async function applyConfigs(configs, opts = {}) {
   return results;
 }
 
-// src/lib/sync.ts
-import { extname, join as join3 } from "path";
-import { homedir as homedir3 } from "os";
-
 // src/lib/sync-dir.ts
 import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync2, statSync } from "fs";
-import { join as join2, relative } from "path";
+import { join as join3, relative } from "path";
+import { homedir as homedir3 } from "os";
+
+// src/lib/sync.ts
+import { extname, join as join2 } from "path";
 import { homedir as homedir2 } from "os";
+function detectCategory(filePath) {
+  const p = filePath.toLowerCase().replace(homedir2(), "~");
+  if (p.includes("/.claude/rules/") || p.endsWith("claude.md") || p.endsWith("agents.md") || p.endsWith("gemini.md"))
+    return "rules";
+  if (p.includes("/.claude/") || p.includes("/.codex/") || p.includes("/.gemini/") || p.includes("/.cursor/"))
+    return "agent";
+  if (p.includes(".mcp.json") || p.includes("mcp"))
+    return "mcp";
+  if (p.includes(".zshrc") || p.includes(".zprofile") || p.includes(".bashrc") || p.includes(".bash_profile"))
+    return "shell";
+  if (p.includes(".gitconfig") || p.includes(".gitignore"))
+    return "git";
+  if (p.includes(".npmrc") || p.includes("tsconfig") || p.includes("bunfig"))
+    return "tools";
+  if (p.includes(".secrets"))
+    return "secrets_schema";
+  return "tools";
+}
+function detectAgent(filePath) {
+  const p = filePath.toLowerCase().replace(homedir2(), "~");
+  if (p.includes("/.claude/") || p.endsWith("claude.md"))
+    return "claude";
+  if (p.includes("/.codex/") || p.endsWith("agents.md"))
+    return "codex";
+  if (p.includes("/.gemini/") || p.endsWith("gemini.md"))
+    return "gemini";
+  if (p.includes(".zshrc") || p.includes(".zprofile") || p.includes(".bashrc"))
+    return "zsh";
+  if (p.includes(".gitconfig") || p.includes(".gitignore"))
+    return "git";
+  if (p.includes(".npmrc"))
+    return "npm";
+  return "global";
+}
+function detectFormat(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  if (ext === ".json")
+    return "json";
+  if (ext === ".toml")
+    return "toml";
+  if (ext === ".yaml" || ext === ".yml")
+    return "yaml";
+  if (ext === ".md" || ext === ".markdown")
+    return "markdown";
+  if (ext === ".ini" || ext === ".cfg")
+    return "ini";
+  return "text";
+}
+
+// src/lib/sync-dir.ts
 var SKIP = [".db", ".db-shm", ".db-wal", ".log", ".lock", ".DS_Store", "node_modules", ".git"];
 function shouldSkip(p) {
   return SKIP.some((s) => p.includes(s));
@@ -2100,9 +2150,9 @@ async function syncFromDir(dir, opts = {}) {
   const absDir = expandPath(dir);
   if (!existsSync3(absDir))
     return { added: 0, updated: 0, unchanged: 0, skipped: [`Not found: ${absDir}`] };
-  const files = opts.recursive !== false ? walkDir(absDir) : readdirSync(absDir).map((f) => join2(absDir, f)).filter((f) => statSync(f).isFile());
+  const files = opts.recursive !== false ? walkDir(absDir) : readdirSync(absDir).map((f) => join3(absDir, f)).filter((f) => statSync(f).isFile());
   const result = { added: 0, updated: 0, unchanged: 0, skipped: [] };
-  const home = homedir2();
+  const home = homedir3();
   const allConfigs = listConfigs(undefined, d);
   for (const file of files) {
     if (shouldSkip(file)) {
@@ -2136,7 +2186,7 @@ async function syncFromDir(dir, opts = {}) {
 }
 async function syncToDir(dir, opts = {}) {
   const d = opts.db || getDatabase();
-  const home = homedir2();
+  const home = homedir3();
   const absDir = expandPath(dir);
   const normalized = dir.startsWith("~/") ? dir : absDir.replace(home, "~");
   const configs = listConfigs(undefined, d).filter((c) => c.target_path && (c.target_path.startsWith(normalized) || c.target_path.startsWith(absDir)));
@@ -2155,7 +2205,7 @@ async function syncToDir(dir, opts = {}) {
 }
 function walkDir(dir, files = []) {
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    const full = join2(dir, entry.name);
+    const full = join3(dir, entry.name);
     if (shouldSkip(full))
       continue;
     if (entry.isDirectory())
@@ -2165,57 +2215,10 @@ function walkDir(dir, files = []) {
   }
   return files;
 }
-// src/lib/sync.ts
-function detectCategory(filePath) {
-  const p = filePath.toLowerCase().replace(homedir3(), "~");
-  if (p.includes("/.claude/rules/") || p.endsWith("claude.md") || p.endsWith("agents.md") || p.endsWith("gemini.md"))
-    return "rules";
-  if (p.includes("/.claude/") || p.includes("/.codex/") || p.includes("/.gemini/") || p.includes("/.cursor/"))
-    return "agent";
-  if (p.includes(".mcp.json") || p.includes("mcp"))
-    return "mcp";
-  if (p.includes(".zshrc") || p.includes(".zprofile") || p.includes(".bashrc") || p.includes(".bash_profile"))
-    return "shell";
-  if (p.includes(".gitconfig") || p.includes(".gitignore"))
-    return "git";
-  if (p.includes(".npmrc") || p.includes("tsconfig") || p.includes("bunfig"))
-    return "tools";
-  if (p.includes(".secrets"))
-    return "secrets_schema";
-  return "tools";
-}
-function detectAgent(filePath) {
-  const p = filePath.toLowerCase().replace(homedir3(), "~");
-  if (p.includes("/.claude/") || p.endsWith("claude.md"))
-    return "claude";
-  if (p.includes("/.codex/") || p.endsWith("agents.md"))
-    return "codex";
-  if (p.includes("/.gemini/") || p.endsWith("gemini.md"))
-    return "gemini";
-  if (p.includes(".zshrc") || p.includes(".zprofile") || p.includes(".bashrc"))
-    return "zsh";
-  if (p.includes(".gitconfig") || p.includes(".gitignore"))
-    return "git";
-  if (p.includes(".npmrc"))
-    return "npm";
-  return "global";
-}
-function detectFormat(filePath) {
-  const ext = extname(filePath).toLowerCase();
-  if (ext === ".json")
-    return "json";
-  if (ext === ".toml")
-    return "toml";
-  if (ext === ".yaml" || ext === ".yml")
-    return "yaml";
-  if (ext === ".md" || ext === ".markdown")
-    return "markdown";
-  if (ext === ".ini" || ext === ".cfg")
-    return "ini";
-  return "text";
-}
 
 // src/server/index.ts
+import { existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
+import { join as join4, extname as extname2 } from "path";
 var PORT = Number(process.env["CONFIGS_PORT"] ?? 3457);
 function pickFields(obj, fields) {
   if (!fields)
@@ -2376,8 +2379,38 @@ app.post("/api/machines", async (c) => {
     return c.json({ error: e instanceof Error ? e.message : String(e) }, 422);
   }
 });
-app.get("/health", (c) => c.json({ ok: true, version: "0.1.0" }));
-console.log(`configs-serve listening on http://localhost:${PORT}`);
+app.get("/health", (c) => c.json({ ok: true, version: "0.1.5" }));
+var MIME = { ".html": "text/html", ".js": "application/javascript", ".css": "text/css", ".json": "application/json", ".svg": "image/svg+xml", ".png": "image/png", ".ico": "image/x-icon" };
+function findDashboardDir() {
+  const candidates = [
+    join4(import.meta.dir, "../../dashboard/dist"),
+    join4(import.meta.dir, "../dashboard/dist"),
+    join4(import.meta.dir, "../../../dashboard/dist")
+  ];
+  for (const dir of candidates) {
+    if (existsSync4(join4(dir, "index.html")))
+      return dir;
+  }
+  return null;
+}
+var dashDir = findDashboardDir();
+if (dashDir) {
+  app.get("/*", (c) => {
+    const url = new URL(c.req.url);
+    let filePath = url.pathname === "/" ? "/index.html" : url.pathname;
+    let absPath = join4(dashDir, filePath);
+    if (!existsSync4(absPath))
+      absPath = join4(dashDir, "index.html");
+    if (!existsSync4(absPath))
+      return c.json({ error: "Not found" }, 404);
+    const content = readFileSync3(absPath);
+    const ext = extname2(absPath);
+    return new Response(content, {
+      headers: { "Content-Type": MIME[ext] || "application/octet-stream" }
+    });
+  });
+}
+console.log(`configs-serve listening on http://localhost:${PORT}${dashDir ? " (dashboard: /" : " (no dashboard found)"}`);
 var server_default = { port: PORT, fetch: app.fetch };
 export {
   server_default as default

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/configs",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "description": "AI coding agent configuration manager — store, version, apply, and share all your AI coding configs. CLI + MCP + REST API + Dashboard.",
   "type": "module",
   "main": "dist/index.js",