@hasna/configs 0.2.1 → 0.2.3

package/dist/cli/index.js

@@ -2064,7 +2064,7 @@ var require_commander = __commonJS((exports) => {
 });
 
 // src/types/index.ts
-var ConfigNotFoundError, ProfileNotFoundError, ConfigApplyError;
+var ConfigNotFoundError, ProfileNotFoundError, ConfigApplyError, TemplateRenderError;
 var init_types = __esm(() => {
   ConfigNotFoundError = class ConfigNotFoundError extends Error {
     constructor(id) {
@@ -2084,6 +2084,12 @@ var init_types = __esm(() => {
       this.name = "ConfigApplyError";
     }
   };
+  TemplateRenderError = class TemplateRenderError extends Error {
+    constructor(message) {
+      super(message);
+      this.name = "TemplateRenderError";
+    }
+  };
 });
 
 // src/db/database.ts
@@ -3015,6 +3021,61 @@ var init_sync = __esm(() => {
   ];
 });
 
+// src/lib/template.ts
+var exports_template = {};
+__export(exports_template, {
+  renderTemplate: () => renderTemplate,
+  parseTemplateVars: () => parseTemplateVars,
+  isTemplate: () => isTemplate,
+  extractTemplateVars: () => extractTemplateVars
+});
+function parseTemplateVars(content) {
+  const names = new Set;
+  let match;
+  VAR_PATTERN.lastIndex = 0;
+  while ((match = VAR_PATTERN.exec(content)) !== null) {
+    names.add(match[1]);
+  }
+  return Array.from(names);
+}
+function extractTemplateVars(content) {
+  const vars = new Map;
+  let match;
+  VAR_PATTERN.lastIndex = 0;
+  while ((match = VAR_PATTERN.exec(content)) !== null) {
+    const name = match[1];
+    const description = match[2] ?? null;
+    if (!vars.has(name)) {
+      vars.set(name, { name, description, required: true });
+    }
+  }
+  return Array.from(vars.values());
+}
+function renderTemplate(content, vars) {
+  const missing = [];
+  VAR_PATTERN.lastIndex = 0;
+  let match;
+  while ((match = VAR_PATTERN.exec(content)) !== null) {
+    const name = match[1];
+    if (!(name in vars))
+      missing.push(name);
+  }
+  if (missing.length > 0) {
+    throw new TemplateRenderError(`Missing required template variables: ${missing.join(", ")}`);
+  }
+  VAR_PATTERN.lastIndex = 0;
+  return content.replace(VAR_PATTERN, (_match, name) => vars[name] ?? "");
+}
+function isTemplate(content) {
+  VAR_PATTERN.lastIndex = 0;
+  return VAR_PATTERN.test(content);
+}
+var VAR_PATTERN;
+var init_template = __esm(() => {
+  init_types();
+  VAR_PATTERN = /\{\{([A-Z0-9_]+)(?::([^}]*))?\}\}/g;
+});
+
 // node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
 var {
@@ -3220,24 +3281,8 @@ async function importConfigs(bundlePath, opts = {}) {
   }
 }
 
-// src/lib/template.ts
-init_types();
-var VAR_PATTERN = /\{\{([A-Z0-9_]+)(?::([^}]*))?\}\}/g;
-function extractTemplateVars(content) {
-  const vars = new Map;
-  let match;
-  VAR_PATTERN.lastIndex = 0;
-  while ((match = VAR_PATTERN.exec(content)) !== null) {
-    const name = match[1];
-    const description = match[2] ?? null;
-    if (!vars.has(name)) {
-      vars.set(name, { name, description, required: true });
-    }
-  }
-  return Array.from(vars.values());
-}
-
 // src/cli/index.tsx
+init_template();
 import { createRequire } from "module";
 var pkg = createRequire(import.meta.url)("../../package.json");
 function fmtConfig(c, format) {
@@ -3307,7 +3352,7 @@ program.command("add <path>").description("Ingest a file into the config DB").op
   }
   const rawContent = readFileSync5(abs, "utf-8");
   const fmt = detectFormat(abs);
-  const { content, redacted, isTemplate } = redactContent(rawContent, fmt);
+  const { content, redacted, isTemplate: isTemplate2 } = redactContent(rawContent, fmt);
   const targetPath = abs.startsWith(homedir4()) ? abs.replace(homedir4(), "~") : abs;
   const name = opts.name || filePath.split("/").pop();
   const config = createConfig({
@@ -3318,7 +3363,7 @@ program.command("add <path>").description("Ingest a file into the config DB").op
     target_path: opts.kind === "reference" ? null : targetPath,
     format: fmt,
     content,
-    is_template: (opts.template ?? false) || isTemplate
+    is_template: (opts.template ?? false) || isTemplate2
   });
   console.log(chalk.green("\u2713") + ` Added: ${chalk.bold(config.name)} ${chalk.dim(`(${config.slug})`)}`);
   if (redacted.length > 0) {
@@ -3583,6 +3628,54 @@ templateCmd.command("vars <id>").description("Show template variables").action(a
     process.exit(1);
   }
 });
+templateCmd.command("render <id>").description("Render a template config with variables and optionally apply to disk").option("--var <vars...>", "set variables as KEY=VALUE pairs").option("--env", "use environment variables to fill template vars").option("--apply", "write rendered output to target_path").option("--dry-run", "preview rendered output without writing").action(async (id, opts) => {
+  try {
+    const { renderTemplate: renderTemplate2 } = await Promise.resolve().then(() => (init_template(), exports_template));
+    const c = getConfig(id);
+    const vars = {};
+    if (opts.var) {
+      for (const kv of opts.var) {
+        const eq = kv.indexOf("=");
+        if (eq === -1) {
+          console.error(chalk.red(`Invalid --var: ${kv} (expected KEY=VALUE)`));
+          process.exit(1);
+        }
+        vars[kv.slice(0, eq)] = kv.slice(eq + 1);
+      }
+    }
+    if (opts.env) {
+      const { extractTemplateVars: extractTemplateVars2 } = await Promise.resolve().then(() => (init_template(), exports_template));
+      for (const v of extractTemplateVars2(c.content)) {
+        if (!(v.name in vars) && process.env[v.name]) {
+          vars[v.name] = process.env[v.name];
+        }
+      }
+    }
+    const rendered = renderTemplate2(c.content, vars);
+    if (opts.apply || opts.dryRun) {
+      if (!c.target_path) {
+        console.error(chalk.red("No target_path \u2014 cannot apply reference configs"));
+        process.exit(1);
+      }
+      if (opts.dryRun) {
+        console.log(chalk.yellow("[dry-run]") + ` Would write to ${expandPath(c.target_path)}`);
+        console.log(rendered);
+      } else {
+        const { writeFileSync: writeFileSync3, mkdirSync: mkdirSync5 } = await import("fs");
+        const { dirname: dirname3 } = await import("path");
+        const path = expandPath(c.target_path);
+        mkdirSync5(dirname3(path), { recursive: true });
+        writeFileSync3(path, rendered, "utf-8");
+        console.log(chalk.green("\u2713") + ` Rendered and applied to ${path}`);
+      }
+    } else {
+      console.log(rendered);
+    }
+  } catch (e) {
+    console.error(chalk.red(e instanceof Error ? e.message : String(e)));
+    process.exit(1);
+  }
+});
 program.command("scan [id]").description("Scan configs for secrets. Defaults to known configs only.").option("--fix", "redact found secrets in-place").option("--all", "scan every config in the DB (slow on large DBs)").option("-c, --category <cat>", "scan only a specific category").action(async (id, opts) => {
   let configs;
   if (id) {
@@ -3620,8 +3713,8 @@ program.command("scan [id]").description("Scan configs for secrets. Defaults to
       for (const s of secrets)
         console.log(`  line ${s.line}: ${chalk.red(s.varName)} \u2014 ${s.reason}`);
       if (opts.fix) {
-        const { content, isTemplate } = redactContent(c.content, fmt);
-        updateConfig(c.id, { content, is_template: isTemplate });
+        const { content, isTemplate: isTemplate2 } = redactContent(c.content, fmt);
+        updateConfig(c.id, { content, is_template: isTemplate2 });
         console.log(chalk.green("  \u2713 Redacted."));
       }
     }
@@ -3888,6 +3981,47 @@ _configs_completions() {
 complete -F _configs_completions configs`);
   }
 });
+program.command("compare <a> <b>").description("Diff two stored configs against each other").action(async (a, b) => {
+  try {
+    const configA = getConfig(a);
+    const configB = getConfig(b);
+    console.log(chalk.bold(`${configA.slug}`) + chalk.dim(` (${configA.category}/${configA.agent})`));
+    console.log(chalk.bold(`${configB.slug}`) + chalk.dim(` (${configB.category}/${configB.agent})`));
+    console.log();
+    const linesA = configA.content.split(`
+`);
+    const linesB = configB.content.split(`
+`);
+    const maxLen = Math.max(linesA.length, linesB.length);
+    const lines = [`--- ${configA.slug}`, `+++ ${configB.slug}`];
+    let diffs = 0;
+    for (let i = 0;i < maxLen; i++) {
+      const la = linesA[i];
+      const lb = linesB[i];
+      if (la === lb) {
+        if (la !== undefined)
+          lines.push(` ${la}`);
+      } else {
+        diffs++;
+        if (la !== undefined)
+          lines.push(chalk.red(`-${la}`));
+        if (lb !== undefined)
+          lines.push(chalk.green(`+${lb}`));
+      }
+    }
+    if (diffs === 0) {
+      console.log(chalk.green("\u2713") + " Identical content");
+    } else {
+      console.log(lines.join(`
+`));
+      console.log(chalk.dim(`
+${diffs} difference(s)`));
+    }
+  } catch (e) {
+    console.error(chalk.red(e instanceof Error ? e.message : String(e)));
+    process.exit(1);
+  }
+});
 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");
@@ -3933,5 +4067,13 @@ program.command("watch").description("Watch known config files for changes and a
   setInterval(tick, interval);
   await new Promise(() => {});
 });
+program.command("pull").description("Alias for sync (read from disk into DB)").option("-a, --agent <agent>", "only sync this agent").option("--dry-run", "preview without writing").action(async (opts) => {
+  const result = await syncKnown({ dryRun: opts.dryRun, agent: opts.agent });
+  console.log(chalk.green("\u2713") + ` Pulled: +${result.added} updated:${result.updated} unchanged:${result.unchanged}`);
+});
+program.command("push").description("Alias for sync --to-disk (write DB configs to disk)").option("-a, --agent <agent>", "only push this agent").option("--dry-run", "preview without writing").action(async (opts) => {
+  const result = await syncToDisk({ dryRun: opts.dryRun, agent: opts.agent });
+  console.log(chalk.green("\u2713") + ` Pushed: updated:${result.updated} unchanged:${result.unchanged} skipped:${result.skipped.length}`);
+});
 program.version(pkg.version).name("configs");
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/configs",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "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",