mulch-cli 0.2.4 → 0.3.0

package/dist/commands/diff.js

@@ -0,0 +1,170 @@
+import { execFileSync } from "node:child_process";
+import chalk from "chalk";
+import { isGitRepo } from "../utils/git.js";
+import { getRecordSummary } from "../utils/format.js";
+import { outputJson, outputJsonError } from "../utils/json-output.js";
+export function parseExpertiseDiff(diffOutput) {
+    const lines = diffOutput.split("\n");
+    const entriesMap = new Map();
+    let currentDomain = null;
+    for (const line of lines) {
+        // Extract domain from 'diff --git' headers
+        if (line.startsWith("diff --git")) {
+            const match = line.match(/\.mulch\/expertise\/([^/]+)\.jsonl/);
+            if (match) {
+                currentDomain = match[1];
+                if (!entriesMap.has(currentDomain)) {
+                    entriesMap.set(currentDomain, {
+                        domain: currentDomain,
+                        added: [],
+                        removed: [],
+                    });
+                }
+            }
+            continue;
+        }
+        // Skip file metadata lines
+        if (line.startsWith("+++") || line.startsWith("---") || line.startsWith("@@")) {
+            continue;
+        }
+        // Parse added records (lines starting with '+')
+        if (line.startsWith("+") && currentDomain) {
+            const jsonStr = line.slice(1);
+            try {
+                const record = JSON.parse(jsonStr);
+                const entry = entriesMap.get(currentDomain);
+                if (entry) {
+                    entry.added.push(record);
+                }
+            }
+            catch {
+                // Skip lines that fail JSON.parse (context lines, hunk headers, etc.)
+            }
+            continue;
+        }
+        // Parse removed records (lines starting with '-')
+        if (line.startsWith("-") && currentDomain) {
+            const jsonStr = line.slice(1);
+            try {
+                const record = JSON.parse(jsonStr);
+                const entry = entriesMap.get(currentDomain);
+                if (entry) {
+                    entry.removed.push(record);
+                }
+            }
+            catch {
+                // Skip lines that fail JSON.parse (context lines, hunk headers, etc.)
+            }
+            continue;
+        }
+    }
+    // Return entries sorted by domain, filtered to non-empty
+    return [...entriesMap.values()]
+        .filter((entry) => entry.added.length > 0 || entry.removed.length > 0)
+        .sort((a, b) => a.domain.localeCompare(b.domain));
+}
+export function formatDiffOutput(entries, since) {
+    const lines = [];
+    lines.push(`Expertise changes since ${since}`);
+    lines.push("");
+    for (const entry of entries) {
+        const changeCount = entry.added.length + entry.removed.length;
+        const plural = changeCount === 1 ? "change" : "changes";
+        lines.push(`${entry.domain} (${changeCount} ${plural}):`);
+        for (const record of entry.added) {
+            const summary = getRecordSummary(record);
+            lines.push(`  + [${record.type}] ${record.id} ${summary}`);
+        }
+        for (const record of entry.removed) {
+            const summary = getRecordSummary(record);
+            lines.push(`  - [${record.type}] ${record.id} ${summary}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+}
+export function registerDiffCommand(program) {
+    program
+        .command("diff")
+        .description("Show expertise record changes since a git ref")
+        .option("--since <ref>", "git ref to diff against", "HEAD~1")
+        .action(async (options) => {
+        const jsonMode = program.opts().json === true;
+        const cwd = process.cwd();
+        if (!isGitRepo(cwd)) {
+            if (jsonMode) {
+                outputJsonError("diff", "Not in a git repository. Run this command from within a git repository.");
+            }
+            else {
+                console.error(chalk.red("Error: not in a git repository."));
+            }
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            let diffOutput;
+            try {
+                diffOutput = execFileSync("git", ["diff", options.since, "--", ".mulch/expertise/"], {
+                    cwd,
+                    encoding: "utf-8",
+                    stdio: ["pipe", "pipe", "pipe"],
+                });
+            }
+            catch {
+                // ref doesn't exist or no changes, treat as empty diff
+                diffOutput = "";
+            }
+            const entries = parseExpertiseDiff(diffOutput);
+            if (entries.length === 0) {
+                if (jsonMode) {
+                    outputJson({
+                        success: true,
+                        command: "diff",
+                        since: options.since,
+                        domains: [],
+                        message: "No expertise changes found.",
+                    });
+                }
+                else {
+                    console.log("No expertise changes found.");
+                }
+                return;
+            }
+            if (jsonMode) {
+                outputJson({
+                    success: true,
+                    command: "diff",
+                    since: options.since,
+                    domains: entries,
+                });
+                return;
+            }
+            // Plain text output with colors
+            console.log(chalk.bold(`\nExpertise changes since ${options.since}\n`));
+            for (const entry of entries) {
+                const changeCount = entry.added.length + entry.removed.length;
+                const plural = changeCount === 1 ? "change" : "changes";
+                console.log(chalk.cyan(`${entry.domain} (${changeCount} ${plural}):`));
+                for (const record of entry.added) {
+                    const summary = getRecordSummary(record);
+                    console.log(chalk.green(`  + [${record.type}] ${record.id} ${summary}`));
+                }
+                for (const record of entry.removed) {
+                    const summary = getRecordSummary(record);
+                    console.log(chalk.red(`  - [${record.type}] ${record.id} ${summary}`));
+                }
+                console.log("");
+            }
+        }
+        catch (err) {
+            if (jsonMode) {
+                outputJsonError("diff", err.message);
+            }
+            else {
+                console.error(chalk.red(`Error: ${err.message}`));
+            }
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"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"}

package/dist/commands/prime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prime.d.ts","sourceRoot":"","sources":["../../src/commands/prime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AA6B5C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoK3D"}
+{"version":3,"file":"prime.d.ts","sourceRoot":"","sources":["../../src/commands/prime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAiE5C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoO3D"}

package/dist/commands/prime.js

@@ -3,9 +3,34 @@ import { Option } from "commander";
 import chalk from "chalk";
 import { readConfig, getExpertisePath } from "../utils/config.js";
 import { readExpertiseFile, getFileModTime } from "../utils/expertise.js";
-import { formatDomainExpertise, formatPrimeOutput, formatDomainExpertiseXml, formatPrimeOutputXml, formatDomainExpertisePlain, formatPrimeOutputPlain, formatDomainExpertiseCompact, formatPrimeOutputCompact, formatMcpOutput, } from "../utils/format.js";
+import { formatDomainExpertise, formatPrimeOutput, formatDomainExpertiseXml, formatPrimeOutputXml, formatDomainExpertisePlain, formatPrimeOutputPlain, formatDomainExpertiseCompact, formatPrimeOutputCompact, formatMcpOutput, getSessionEndReminder, } from "../utils/format.js";
 import { outputJsonError } from "../utils/json-output.js";
 import { isGitRepo, getChangedFiles, filterByContext } from "../utils/git.js";
+import { DEFAULT_BUDGET, applyBudget, formatBudgetSummary, } from "../utils/budget.js";
+/**
+ * Produce a rough text representation of a record for token estimation.
+ * Uses a simple format similar to compact lines.
+ */
+function estimateRecordText(record) {
+    switch (record.type) {
+        case "convention":
+            return `[convention] ${record.content}`;
+        case "pattern": {
+            const files = record.files && record.files.length > 0 ? ` (${record.files.join(", ")})` : "";
+            return `[pattern] ${record.name}: ${record.description}${files}`;
+        }
+        case "failure":
+            return `[failure] ${record.description} -> ${record.resolution}`;
+        case "decision":
+            return `[decision] ${record.title}: ${record.rationale}`;
+        case "reference": {
+            const refFiles = record.files && record.files.length > 0 ? `: ${record.files.join(", ")}` : `: ${record.description}`;
+            return `[reference] ${record.name}${refFiles}`;
+        }
+        case "guide":
+            return `[guide] ${record.name}: ${record.description}`;
+    }
+}
 export function registerPrimeCommand(program) {
     program
         .command("prime")
@@ -15,11 +40,15 @@ export function registerPrimeCommand(program) {
         .option("-v, --verbose", "full output with section headers and recording instructions")
         .option("--mcp", "output in MCP-compatible JSON format")
         .option("--domain <domains...>", "domain(s) to include")
+        .option("--exclude-domain <domains...>", "domain(s) to exclude")
         .addOption(new Option("--format <format>", "output format")
         .choices(["markdown", "xml", "plain"])
         .default("markdown"))
         .option("--context", "filter records to only those relevant to changed files")
+        .option("--files <paths...>", "filter records to only those relevant to specified files")
         .option("--export <path>", "export output to a file")
+        .option("--budget <tokens>", `token budget for output (default: ${DEFAULT_BUDGET})`)
+        .option("--no-limit", "disable token budget limit")
         .action(async (domainsArg, options) => {
         const jsonMode = program.opts().json === true;
         try {
@@ -39,11 +68,25 @@ export function registerPrimeCommand(program) {
                     return;
                 }
             }
-            const targetDomains = unique.length > 0
+            const excluded = options.excludeDomain ?? [];
+            for (const d of excluded) {
+                if (!config.domains.includes(d)) {
+                    if (jsonMode) {
+                        outputJsonError("prime", `Excluded domain "${d}" not found in config. Available domains: ${config.domains.join(", ")}`);
+                    }
+                    else {
+                        console.error(`Error: Excluded domain "${d}" not found in config. Available domains: ${config.domains.join(", ")}`);
+                    }
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            let targetDomains = unique.length > 0
                 ? unique
                 : config.domains;
-            // Resolve changed files for --context filtering
-            let changedFiles;
+            targetDomains = targetDomains.filter(d => !excluded.includes(d));
+            // Resolve changed files for --context or --files filtering
+            let filesToFilter;
             if (options.context) {
                 const cwd = process.cwd();
                 if (!isGitRepo(cwd)) {
@@ -57,8 +100,8 @@ export function registerPrimeCommand(program) {
                     process.exitCode = 1;
                     return;
                 }
-                changedFiles = getChangedFiles(cwd, "HEAD~1");
-                if (changedFiles.length === 0) {
+                filesToFilter = getChangedFiles(cwd, "HEAD~1");
+                if (filesToFilter.length === 0) {
                     if (jsonMode) {
                         outputJsonError("prime", "No changed files found. Nothing to filter by.");
                     }
@@ -68,34 +111,63 @@ export function registerPrimeCommand(program) {
                     return;
                 }
             }
+            else if (options.files && options.files.length > 0) {
+                filesToFilter = options.files;
+            }
+            // Determine budget settings
+            const isMachineOutput = options.mcp === true || jsonMode;
+            const budgetEnabled = !isMachineOutput && options.noLimit !== true;
+            const budget = options.budget ? parseInt(options.budget, 10) : DEFAULT_BUDGET;
             let output;
-            if (options.mcp || jsonMode) {
-                // --json and --mcp produce the same structured output
+            if (isMachineOutput) {
+                // --json and --mcp produce the same structured output — no budget
                 const domains = [];
                 for (const domain of targetDomains) {
                     const filePath = getExpertisePath(domain);
                     let records = await readExpertiseFile(filePath);
-                    if (changedFiles) {
-                        records = filterByContext(records, changedFiles);
+                    if (filesToFilter) {
+                        records = filterByContext(records, filesToFilter);
                     }
-                    if (!changedFiles || records.length > 0) {
+                    if (!filesToFilter || records.length > 0) {
                         domains.push({ domain, entry_count: records.length, records });
                     }
                 }
                 output = formatMcpOutput(domains);
             }
             else {
-                const domainSections = [];
+                // Load all records per domain
+                const allDomainRecords = [];
+                const modTimes = new Map();
                 for (const domain of targetDomains) {
                     const filePath = getExpertisePath(domain);
                     let records = await readExpertiseFile(filePath);
-                    if (changedFiles) {
-                        records = filterByContext(records, changedFiles);
+                    if (filesToFilter) {
+                        records = filterByContext(records, filesToFilter);
                         if (records.length === 0)
                             continue;
                     }
+                    allDomainRecords.push({ domain, records });
                     const lastUpdated = await getFileModTime(filePath);
-                    if (options.verbose || format !== "markdown") {
+                    modTimes.set(domain, lastUpdated);
+                }
+                // Apply budget filtering
+                let domainRecordsToFormat;
+                let droppedCount = 0;
+                let droppedDomainCount = 0;
+                if (budgetEnabled) {
+                    const result = applyBudget(allDomainRecords, budget, (record) => estimateRecordText(record));
+                    domainRecordsToFormat = result.kept;
+                    droppedCount = result.droppedCount;
+                    droppedDomainCount = result.droppedDomainCount;
+                }
+                else {
+                    domainRecordsToFormat = allDomainRecords;
+                }
+                // Format domain sections
+                const domainSections = [];
+                for (const { domain, records } of domainRecordsToFormat) {
+                    const lastUpdated = modTimes.get(domain) ?? null;
+                    if (options.verbose || options.full || format !== "markdown") {
                         switch (format) {
                             case "xml":
                                 domainSections.push(formatDomainExpertiseXml(domain, records, lastUpdated));
@@ -114,7 +186,7 @@ export function registerPrimeCommand(program) {
                         domainSections.push(formatDomainExpertiseCompact(domain, records, lastUpdated));
                     }
                 }
-                if (options.verbose || format !== "markdown") {
+                if (options.verbose || options.full || format !== "markdown") {
                     switch (format) {
                         case "xml":
                             output = formatPrimeOutputXml(domainSections);
@@ -130,6 +202,11 @@ export function registerPrimeCommand(program) {
                 else {
                     output = formatPrimeOutputCompact(domainSections);
                 }
+                // Append truncation summary before session reminder
+                if (droppedCount > 0) {
+                    output += "\n\n" + formatBudgetSummary(droppedCount, droppedDomainCount);
+                }
+                output += "\n\n" + getSessionEndReminder(format);
             }
             if (options.export) {
                 await writeFile(options.export, output + "\n", "utf-8");

package/dist/commands/prime.js.map

@@ -1 +1 @@
-{"version":3,"file":"prime.js","sourceRoot":"","sources":["../../src/commands/prime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prime.js","sourceRoot":"","sources":["../../src/commands/prime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAW,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,eAAe,EACf,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EACL,cAAc,EACd,WAAW,EACX,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAiB5B;;;GAGG;AACH,SAAS,kBAAkB,CAAC,MAAsD;IAChF,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,YAAY;YACf,OAAO,gBAAgB,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1C,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7F,OAAO,aAAa,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,GAAG,KAAK,EAAE,CAAC;QACnE,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,aAAa,MAAM,CAAC,WAAW,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;QACnE,KAAK,UAAU;YACb,OAAO,cAAc,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3D,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;YACtH,OAAO,eAAe,MAAM,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;QACjD,CAAC;QACD,KAAK,OAAO;YACV,OAAO,WAAW,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,kDAAkD,CAAC;SAC/D,QAAQ,CAAC,cAAc,EAAE,uCAAuC,CAAC;SACjE,MAAM,CAAC,QAAQ,EAAE,wDAAwD,CAAC;SAC1E,MAAM,CAAC,eAAe,EAAE,6DAA6D,CAAC;SACtF,MAAM,CAAC,OAAO,EAAE,sCAAsC,CAAC;SACvD,MAAM,CAAC,uBAAuB,EAAE,sBAAsB,CAAC;SACvD,MAAM,CAAC,+BAA+B,EAAE,sBAAsB,CAAC;SAC/D,SAAS,CACR,IAAI,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC;SAC7C,OAAO,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;SACrC,OAAO,CAAC,UAAU,CAAC,CACvB;SACA,MAAM,CAAC,WAAW,EAAE,wDAAwD,CAAC;SAC7E,MAAM,CAAC,oBAAoB,EAAE,0DAA0D,CAAC;SACxF,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;SACpD,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,cAAc,GAAG,CAAC;SACnF,MAAM,CAAC,YAAY,EAAE,4BAA4B,CAAC;SAClD,MAAM,CAAC,KAAK,EAAE,UAAoB,EAAE,OAAqB,EAAE,EAAE;QAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC;YAE5C,MAAM,SAAS,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;YAEvC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChC,IAAI,QAAQ,EAAE,CAAC;wBACb,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,6CAA6C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACjH,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,KAAK,CACX,kBAAkB,CAAC,6CAA6C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5F,CAAC;oBACJ,CAAC;oBACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;oBACrB,OAAO;gBACT,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;YAC7C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChC,IAAI,QAAQ,EAAE,CAAC;wBACb,eAAe,CAAC,OAAO,EAAE,oBAAoB,CAAC,6CAA6C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC1H,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,KAAK,CACX,2BAA2B,CAAC,6CAA6C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrG,CAAC;oBACJ,CAAC;oBACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;oBACrB,OAAO;gBACT,CAAC;YACH,CAAC;YAED,IAAI,aAAa,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC;gBACnC,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YAEnB,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAEjE,2DAA2D;YAC3D,IAAI,aAAmC,CAAC;YACxC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpB,MAAM,GAAG,GAAG,kDAAkD,CAAC;oBAC/D,IAAI,QAAQ,EAAE,CAAC;wBACb,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;oBAChC,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;oBACjC,CAAC;oBACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;oBACrB,OAAO;gBACT,CAAC;gBACD,aAAa,GAAG,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBAC/C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC/B,IAAI,QAAQ,EAAE,CAAC;wBACb,eAAe,CAAC,OAAO,EAAE,+CAA+C,CAAC,CAAC;oBAC5E,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;oBAC/D,CAAC;oBACD,OAAO;gBACT,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrD,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;YAChC,CAAC;YAED,4BAA4B;YAC5B,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,KAAK,IAAI,IAAI,QAAQ,CAAC;YACzD,MAAM,aAAa,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC;YACnE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;YAE9E,IAAI,MAAc,CAAC;YAEnB,IAAI,eAAe,EAAE,CAAC;gBACpB,kEAAkE;gBAClE,MAAM,OAAO,GAAgB,EAAE,CAAC;gBAChC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;oBACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;oBAC1C,IAAI,OAAO,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;oBAChD,IAAI,aAAa,EAAE,CAAC;wBAClB,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;oBACpD,CAAC;oBACD,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;oBACjE,CAAC;gBACH,CAAC;gBACD,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,8BAA8B;gBAC9B,MAAM,gBAAgB,GAAoB,EAAE,CAAC;gBAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;gBAEhD,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;oBACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;oBAC1C,IAAI,OAAO,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;oBAChD,IAAI,aAAa,EAAE,CAAC;wBAClB,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;wBAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;4BAAE,SAAS;oBACrC,CAAC;oBACD,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC3C,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;oBACnD,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gBACpC,CAAC;gBAED,yBAAyB;gBACzB,IAAI,qBAAsC,CAAC;gBAC3C,IAAI,YAAY,GAAG,CAAC,CAAC;gBACrB,IAAI,kBAAkB,GAAG,CAAC,CAAC;gBAE3B,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,MAAM,GAAG,WAAW,CACxB,gBAAgB,EAChB,MAAM,EACN,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CACvC,CAAC;oBACF,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAC;oBACpC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;oBACnC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;gBACjD,CAAC;qBAAM,CAAC;oBACN,qBAAqB,GAAG,gBAAgB,CAAC;gBAC3C,CAAC;gBAED,yBAAyB;gBACzB,MAAM,cAAc,GAAa,EAAE,CAAC;gBACpC,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,qBAAqB,EAAE,CAAC;oBACxD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;oBAEjD,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;wBAC7D,QAAQ,MAAM,EAAE,CAAC;4BACf,KAAK,KAAK;gCACR,cAAc,CAAC,IAAI,CACjB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CACvD,CAAC;gCACF,MAAM;4BACR,KAAK,OAAO;gCACV,cAAc,CAAC,IAAI,CACjB,0BAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CACzD,CAAC;gCACF,MAAM;4BACR;gCACE,cAAc,CAAC,IAAI,CACjB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;oCAClD,IAAI,EAAE,OAAO,CAAC,IAAI;iCACnB,CAAC,CACH,CAAC;gCACF,MAAM;wBACV,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,cAAc,CAAC,IAAI,CACjB,4BAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAC3D,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;oBAC7D,QAAQ,MAAM,EAAE,CAAC;wBACf,KAAK,KAAK;4BACR,MAAM,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;4BAC9C,MAAM;wBACR,KAAK,OAAO;4BACV,MAAM,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;4BAChD,MAAM;wBACR;4BACE,MAAM,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;4BAC3C,MAAM;oBACV,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,wBAAwB,CAAC,cAAc,CAAC,CAAC;gBACpD,CAAC;gBAED,oDAAoD;gBACpD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;oBACrB,MAAM,IAAI,MAAM,GAAG,mBAAmB,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;gBAC3E,CAAC;gBAED,MAAM,IAAI,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;YACnD,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;gBACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,IAAI,QAAQ,EAAE,CAAC;oBACb,eAAe,CAAC,OAAO,EAAE,qDAAqD,CAAC,CAAC;gBAClF,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,QAAQ,EAAE,CAAC;oBACb,eAAe,CAAC,OAAO,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;gBACnD,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;YACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/record.d.ts

@@ -1,3 +1,13 @@
 import { Command } from "commander";
+/**
+ * Process records from stdin (JSON single object or array)
+ * Validates, dedups, and appends with file locking
+ */
+export declare function processStdinRecords(domain: string, jsonMode: boolean, force: boolean, stdinData?: string, cwd?: string): Promise<{
+    created: number;
+    updated: number;
+    skipped: number;
+    errors: string[];
+}>;
 export declare function registerRecordCommand(program: Command): void;
 //# sourceMappingURL=record.d.ts.map

package/dist/commands/record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/commands/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAqB5C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqX5D"}
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/commands/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAsB5C;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA+FlF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6b5D"}

package/dist/commands/record.js

@@ -7,6 +7,92 @@ import { appendRecord, readExpertiseFile, writeExpertiseFile, findDuplicate, } f
 import { withFileLock } from "../utils/lock.js";
 import { recordSchema } from "../schemas/record-schema.js";
 import { outputJson, outputJsonError } from "../utils/json-output.js";
+import { readFileSync } from "node:fs";
+/**
+ * Process records from stdin (JSON single object or array)
+ * Validates, dedups, and appends with file locking
+ */
+export async function processStdinRecords(domain, jsonMode, force, stdinData, cwd) {
+    const config = await readConfig(cwd);
+    if (!config.domains.includes(domain)) {
+        throw new Error(`Domain "${domain}" not found in config. Available domains: ${config.domains.join(", ") || "(none)"}`);
+    }
+    // Read stdin (or use provided data for testing)
+    const inputData = stdinData ?? readFileSync(0, "utf-8");
+    let inputRecords;
+    try {
+        const parsed = JSON.parse(inputData);
+        inputRecords = Array.isArray(parsed) ? parsed : [parsed];
+    }
+    catch (err) {
+        throw new Error(`Failed to parse JSON from stdin: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Validate each record against schema
+    const ajv = new Ajv();
+    const validate = ajv.compile(recordSchema);
+    const errors = [];
+    const validRecords = [];
+    for (let i = 0; i < inputRecords.length; i++) {
+        const record = inputRecords[i];
+        // Ensure recorded_at and classification are set
+        if (typeof record === "object" && record !== null) {
+            if (!("recorded_at" in record)) {
+                record.recorded_at = new Date().toISOString();
+            }
+            if (!("classification" in record)) {
+                record.classification = "tactical";
+            }
+        }
+        if (!validate(record)) {
+            const validationErrors = (validate.errors ?? [])
+                .map((err) => `${err.instancePath} ${err.message}`)
+                .join("; ");
+            errors.push(`Record ${i}: ${validationErrors}`);
+            continue;
+        }
+        validRecords.push(record);
+    }
+    if (validRecords.length === 0) {
+        return { created: 0, updated: 0, skipped: 0, errors };
+    }
+    // Process valid records with file locking
+    const filePath = getExpertisePath(domain, cwd);
+    let created = 0;
+    let updated = 0;
+    let skipped = 0;
+    await withFileLock(filePath, async () => {
+        const existing = await readExpertiseFile(filePath);
+        let currentRecords = [...existing];
+        for (const record of validRecords) {
+            const dup = findDuplicate(currentRecords, record);
+            if (dup && !force) {
+                const isNamed = record.type === "pattern" ||
+                    record.type === "decision" ||
+                    record.type === "reference" ||
+                    record.type === "guide";
+                if (isNamed) {
+                    // Upsert: replace in place
+                    currentRecords[dup.index] = record;
+                    updated++;
+                }
+                else {
+                    // Exact match: skip
+                    skipped++;
+                }
+            }
+            else {
+                // New record: append
+                currentRecords.push(record);
+                created++;
+            }
+        }
+        // Write all changes at once
+        if (created > 0 || updated > 0) {
+            await writeExpertiseFile(filePath, currentRecords);
+        }
+    });
+    return { created, updated, skipped, errors };
+}
 export function registerRecordCommand(program) {
     program
         .command("record")
@@ -14,8 +100,7 @@ export function registerRecordCommand(program) {
         .argument("[content]", "record content")
         .description("Record an expertise record")
         .addOption(new Option("--type <type>", "record type")
-        .choices(["convention", "pattern", "failure", "decision", "reference", "guide"])
-        .makeOptionMandatory())
+        .choices(["convention", "pattern", "failure", "decision", "reference", "guide"]))
         .addOption(new Option("--classification <classification>", "classification level")
         .choices(["foundational", "tactical", "observational"])
         .default("tactical"))
@@ -29,11 +114,65 @@ export function registerRecordCommand(program) {
         .option("--evidence-commit <commit>", "evidence: commit hash")
         .option("--evidence-issue <issue>", "evidence: issue reference")
         .option("--evidence-file <file>", "evidence: file path")
+        .option("--evidence-bead <bead>", "evidence: bead ID")
         .option("--relates-to <ids>", "comma-separated record IDs this relates to")
         .option("--supersedes <ids>", "comma-separated record IDs this supersedes")
         .option("--force", "force recording even if duplicate exists")
+        .option("--stdin", "read JSON record(s) from stdin (single object or array)")
         .action(async (domain, content, options) => {
         const jsonMode = program.opts().json === true;
+        // Handle --stdin mode
+        if (options.stdin === true) {
+            try {
+                const result = await processStdinRecords(domain, jsonMode, options.force === true);
+                if (result.errors.length > 0) {
+                    if (jsonMode) {
+                        outputJsonError("record", `Validation errors: ${result.errors.join("; ")}`);
+                    }
+                    else {
+                        console.error(chalk.red("Validation errors:"));
+                        for (const error of result.errors) {
+                            console.error(chalk.red(`  ${error}`));
+                        }
+                    }
+                }
+                if (jsonMode) {
+                    outputJson({
+                        success: result.errors.length === 0 || result.created + result.updated > 0,
+                        command: "record",
+                        domain,
+                        created: result.created,
+                        updated: result.updated,
+                        skipped: result.skipped,
+                        errors: result.errors,
+                    });
+                }
+                else {
+                    if (result.created > 0) {
+                        console.log(chalk.green(`✔ Created ${result.created} record(s) in ${domain}`));
+                    }
+                    if (result.updated > 0) {
+                        console.log(chalk.green(`✔ Updated ${result.updated} record(s) in ${domain}`));
+                    }
+                    if (result.skipped > 0) {
+                        console.log(chalk.yellow(`Skipped ${result.skipped} duplicate(s) in ${domain}`));
+                    }
+                }
+                if (result.errors.length > 0 && result.created + result.updated === 0) {
+                    process.exitCode = 1;
+                }
+            }
+            catch (err) {
+                if (jsonMode) {
+                    outputJsonError("record", err instanceof Error ? err.message : String(err));
+                }
+                else {
+                    console.error(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+                }
+                process.exitCode = 1;
+            }
+            return;
+        }
         const config = await readConfig();
         if (!config.domains.includes(domain)) {
             if (jsonMode) {
@@ -46,12 +185,23 @@ export function registerRecordCommand(program) {
             process.exitCode = 1;
             return;
         }
+        // Validate --type is provided for non-stdin mode
+        if (!options.type) {
+            if (jsonMode) {
+                outputJsonError("record", "--type is required (convention, pattern, failure, decision, reference, guide)");
+            }
+            else {
+                console.error(chalk.red("Error: --type is required (convention, pattern, failure, decision, reference, guide)"));
+            }
+            process.exitCode = 1;
+            return;
+        }
         const recordType = options.type;
         const classification = options.classification ?? "tactical";
         const recordedAt = new Date().toISOString();
         // Build evidence if any evidence option is provided
         let evidence;
-        if (options.evidenceCommit || options.evidenceIssue || options.evidenceFile) {
+        if (options.evidenceCommit || options.evidenceIssue || options.evidenceFile || options.evidenceBead) {
             evidence = {};
             if (options.evidenceCommit)
                 evidence.commit = options.evidenceCommit;
@@ -59,6 +209,8 @@ export function registerRecordCommand(program) {
                 evidence.issue = options.evidenceIssue;
             if (options.evidenceFile)
                 evidence.file = options.evidenceFile;
+            if (options.evidenceBead)
+                evidence.bead = options.evidenceBead;
         }
         const tags = typeof options.tags === "string"
             ? options.tags