@zebralabs/context-cli 0.1.5 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zebralabs/context-cli",
-    "version": "0.1.5",
+    "version": "0.1.7",
     "description": "Context-as-Code CLI (help/list/compile/validate)",
     "license": "MIT",
     "type": "module",

package/src/context.js

@@ -23,10 +23,14 @@ Usage:
 
 Pack install:
   ctx pack install <packId> [--repo-root <path>] [--mode SkipExisting|Overwrite]
+                           [--install-option KEY=VALUE] ...
                            ([--zip <path>] | [--registry <url> [--version <x.y.z>] --token <token>])
 
+  Install options are pack-specific (e.g. --install-option Flavour=ReviewOnly). See the pack's INSTALLATION.md for supported options.
+
 Examples (local zip test):
   ctx pack install pack-01-documentation-management --zip D:\\packs\\pack-01-documentation-management-v0.1.0.zip
+  ctx pack install pack-01-documentation-management --zip <path> --install-option Flavour=ReviewOnly
 
 Examples (registry download):
   ctx pack install pack-01-documentation-management --registry https://example.com --token YOURTOKEN
@@ -520,6 +524,31 @@ function ensureDir(p) {
   fs.mkdirSync(p, { recursive: true });
 }
 
+/**
+ * After pack install: ensure docs/local/ exists and .gitignore has /docs/local/
+ * (create .gitignore if missing; append entry if present but pattern not found).
+ */
+function ensureDocsLocalAndGitignore(repoRoot) {
+  const docsLocalDir = path.join(repoRoot, "docs", "local");
+  ensureDir(docsLocalDir);
+
+  const gitignorePath = path.join(repoRoot, ".gitignore");
+  const entry = "\n# Local-only documentation (excluded from AI context and version control)\n/docs/local/\n";
+  const pattern = "/docs/local/";
+
+  if (!fs.existsSync(gitignorePath)) {
+    fs.writeFileSync(gitignorePath, entry.trimStart(), "utf8");
+    return;
+  }
+
+  const content = fs.readFileSync(gitignorePath, "utf8");
+  if (content.includes(pattern) || content.includes("docs/local/")) return;
+
+  const trimmed = content.trimEnd();
+  const suffix = trimmed.endsWith("\n") ? entry : "\n" + entry;
+  fs.writeFileSync(gitignorePath, trimmed + suffix, "utf8");
+}
+
 function writeYamlFile(filePath, obj) {
   const text = YAML.stringify(obj, { indent: 2 });
   fs.writeFileSync(filePath, text.endsWith("\n") ? text : (text + "\n"), "utf8");
@@ -712,11 +741,24 @@ async function cmdPackInstall(repoRoot, packId, opts) {
       if (!version) version = "0.0.0";
     }
     
-    // Run installer
-    console.log(`Installing (mode=${mode})...`);
-    const installCmd = `& "${installer}" -TargetRoot "${repoRoot}" -PackId "${packId}" -Mode "${mode}"`;
+    // Run installer: fixed args + pack-specific install options (passed through as -Key "Value")
+    const installOpts = opts.installOptions || [];
+    const escapePsQuoted = (s) => (s || "").replace(/`/g, "``").replace(/"/g, '`"');
+    let installArgs = `-TargetRoot "${escapePsQuoted(repoRoot)}" -PackId "${escapePsQuoted(packId)}" -Mode "${mode}"`;
+    for (const pair of installOpts) {
+      const eq = pair.indexOf("=");
+      const key = pair.slice(0, eq).trim();
+      const value = (pair.slice(eq + 1) || "").trim();
+      const psKey = toPascalCase(key);
+      installArgs += ` -${psKey} "${escapePsQuoted(value)}"`;
+    }
+    console.log(`Installing (mode=${mode}${installOpts.length ? ", " + installOpts.length + " install option(s)" : ""})...`);
+    const installCmd = `& "${escapePsQuoted(installer)}" ${installArgs}`;
     runPwsh(installCmd, { cwd: extractDir });
 
+    // Ensure docs/local/ exists and .gitignore has /docs/local/
+    ensureDocsLocalAndGitignore(repoRoot);
+
     // Update context.yaml (safe read + repair)
     let ctx2 = readYamlFileSafe(ctxPath);
     if (!ctx2) {
@@ -749,8 +791,17 @@ async function cmdPackInstall(repoRoot, packId, opts) {
   }
 }
 
+/** Convert install-option key to PowerShell PascalCase param name (e.g. flavour -> Flavour, some-key -> SomeKey). */
+function toPascalCase(key) {
+  if (!key || typeof key !== "string") return key;
+  return key
+    .split(/[-_]/)
+    .map((s) => (s.charAt(0).toUpperCase() + s.slice(1).toLowerCase()))
+    .join("");
+}
+
 function parseOpts(args) {
-  const opts = {};
+  const opts = { installOptions: [] };
   for (let i = 0; i < args.length; i++) {
     const a = args[i];
     if (a === "--token") opts.token = args[++i];
@@ -759,7 +810,11 @@ function parseOpts(args) {
     else if (a === "--zip") opts.zip = args[++i];
     else if (a === "--mode") opts.mode = args[++i];
     else if (a === "--repo-root") opts.repoRoot = args[++i];
-    else die(`Unknown option: ${a}`);
+    else if (a === "--install-option") {
+      const pair = args[++i];
+      if (!pair || !pair.includes("=")) die("--install-option requires KEY=VALUE (e.g. Flavour=ReviewOnly)");
+      opts.installOptions.push(pair);
+    } else die(`Unknown option: ${a}`);
   }
   return opts;
 }
@@ -772,7 +827,7 @@ async function main() {
 
   if (cmd === "--version" || cmd === "-v" || cmd === "version") {
     // Make sure package.json has version (or hardcode a constant)
-    console.log("0.1.5");
+    console.log("0.1.7");
     return;
   }
 
@@ -785,7 +840,7 @@ async function main() {
     }
 
     const packId = process.argv[4];
-    if (!packId) die("Usage: ctx pack install <packId> [--zip <path>] | [--registry <url> --token <token> ...]");
+    if (!packId) die("Usage: ctx pack install <packId> [--zip <path>] [--install-option KEY=VALUE ...] | [--registry <url> --token <token> ...]");
 
     const opts = parseOpts(process.argv.slice(5));