mulch-cli 0.1.0

package/dist/commands/prime.js

@@ -0,0 +1,107 @@
+import { writeFile } from "node:fs/promises";
+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";
+export function registerPrimeCommand(program) {
+    program
+        .command("prime")
+        .description("Generate a priming prompt from expertise records")
+        .argument("[domains...]", "optional domain(s) to scope output to")
+        .option("--full", "include full record details (classification, evidence)")
+        .option("--compact", "one-liner per record, no section headers")
+        .option("--mcp", "output in MCP-compatible JSON format")
+        .option("--domain <domains...>", "domain(s) to include")
+        .addOption(new Option("--format <format>", "output format")
+        .choices(["markdown", "xml", "plain"])
+        .default("markdown"))
+        .option("--export <path>", "export output to a file")
+        .action(async (domainsArg, options) => {
+        try {
+            const config = await readConfig();
+            const format = options.format ?? "markdown";
+            const requested = [...domainsArg, ...(options.domain ?? [])];
+            const unique = [...new Set(requested)];
+            for (const d of unique) {
+                if (!config.domains.includes(d)) {
+                    console.error(`Error: Domain "${d}" not found in config. Available domains: ${config.domains.join(", ")}`);
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            const targetDomains = unique.length > 0
+                ? unique
+                : config.domains;
+            let output;
+            if (options.mcp) {
+                const domains = [];
+                for (const domain of targetDomains) {
+                    const filePath = getExpertisePath(domain);
+                    const records = await readExpertiseFile(filePath);
+                    domains.push({ domain, entry_count: records.length, records });
+                }
+                output = formatMcpOutput(domains);
+            }
+            else {
+                const domainSections = [];
+                for (const domain of targetDomains) {
+                    const filePath = getExpertisePath(domain);
+                    const records = await readExpertiseFile(filePath);
+                    const lastUpdated = await getFileModTime(filePath);
+                    if (options.compact) {
+                        domainSections.push(formatDomainExpertiseCompact(domain, records, lastUpdated));
+                    }
+                    else {
+                        switch (format) {
+                            case "xml":
+                                domainSections.push(formatDomainExpertiseXml(domain, records, lastUpdated));
+                                break;
+                            case "plain":
+                                domainSections.push(formatDomainExpertisePlain(domain, records, lastUpdated));
+                                break;
+                            default:
+                                domainSections.push(formatDomainExpertise(domain, records, lastUpdated, {
+                                    full: options.full,
+                                }));
+                                break;
+                        }
+                    }
+                }
+                if (options.compact) {
+                    output = formatPrimeOutputCompact(domainSections);
+                }
+                else {
+                    switch (format) {
+                        case "xml":
+                            output = formatPrimeOutputXml(domainSections);
+                            break;
+                        case "plain":
+                            output = formatPrimeOutputPlain(domainSections);
+                            break;
+                        default:
+                            output = formatPrimeOutput(domainSections);
+                            break;
+                    }
+                }
+            }
+            if (options.export) {
+                await writeFile(options.export, output + "\n", "utf-8");
+                console.log(chalk.green(`Exported to ${options.export}`));
+            }
+            else {
+                console.log(output);
+            }
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                console.error("Error: No .mulch/ directory found. Run `mulch init` first.");
+            }
+            else {
+                console.error(`Error: ${err.message}`);
+            }
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=prime.js.map

package/dist/commands/prime.js.map

@@ -0,0 +1 @@
+{"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,GAChB,MAAM,oBAAoB,CAAC;AAY5B,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,WAAW,EAAE,0CAA0C,CAAC;SAC/D,MAAM,CAAC,OAAO,EAAE,sCAAsC,CAAC;SACvD,MAAM,CAAC,uBAAuB,EAAE,sBAAsB,CAAC;SACvD,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,iBAAiB,EAAE,yBAAyB,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,UAAoB,EAAE,OAAqB,EAAE,EAAE;QAC5D,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,OAAO,CAAC,KAAK,CACX,kBAAkB,CAAC,6CAA6C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5F,CAAC;oBACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;oBACrB,OAAO;gBACT,CAAC;YACH,CAAC;YAED,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC;gBACrC,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YAEnB,IAAI,MAAc,CAAC;YAEnB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAgB,EAAE,CAAC;gBAChC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;oBACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;oBAC1C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;oBAClD,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;gBACjE,CAAC;gBACD,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,MAAM,cAAc,GAAa,EAAE,CAAC;gBACpC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;oBACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;oBAC1C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;oBAClD,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;oBAEnD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;wBACpB,cAAc,CAAC,IAAI,CACjB,4BAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAC3D,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBACN,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;gBACH,CAAC;gBAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,GAAG,wBAAwB,CAAC,cAAc,CAAC,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACN,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;YACH,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;gBACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC5D,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,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAC9E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/prune.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerPruneCommand(program: Command): void;
+//# sourceMappingURL=prune.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../src/commands/prune.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwCpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgE3D"}

package/dist/commands/prune.js

@@ -0,0 +1,71 @@
+import chalk from "chalk";
+import { readConfig, getExpertisePath } from "../utils/config.js";
+import { readExpertiseFile, writeExpertiseFile } from "../utils/expertise.js";
+function isStale(record, now, shelfLife) {
+    const classification = record.classification;
+    if (classification === "foundational") {
+        return false;
+    }
+    const recordedAt = new Date(record.recorded_at);
+    const ageInDays = Math.floor((now.getTime() - recordedAt.getTime()) / (1000 * 60 * 60 * 24));
+    if (classification === "tactical") {
+        return ageInDays > shelfLife.tactical;
+    }
+    if (classification === "observational") {
+        return ageInDays > shelfLife.observational;
+    }
+    return false;
+}
+export function registerPruneCommand(program) {
+    program
+        .command("prune")
+        .description("Remove outdated or low-value expertise records")
+        .option("--dry-run", "Show what would be pruned without removing", false)
+        .action(async (options) => {
+        const config = await readConfig();
+        const now = new Date();
+        const shelfLife = config.classification_defaults.shelf_life;
+        const results = [];
+        let totalPruned = 0;
+        for (const domain of config.domains) {
+            const filePath = getExpertisePath(domain);
+            const records = await readExpertiseFile(filePath);
+            if (records.length === 0) {
+                continue;
+            }
+            const kept = [];
+            let pruned = 0;
+            for (const record of records) {
+                if (isStale(record, now, shelfLife)) {
+                    pruned++;
+                }
+                else {
+                    kept.push(record);
+                }
+            }
+            if (pruned > 0) {
+                results.push({
+                    domain,
+                    before: records.length,
+                    pruned,
+                    after: kept.length,
+                });
+                totalPruned += pruned;
+                if (!options.dryRun) {
+                    await writeExpertiseFile(filePath, kept);
+                }
+            }
+        }
+        if (totalPruned === 0) {
+            console.log(chalk.green("No stale entries found. All records are current."));
+            return;
+        }
+        const label = options.dryRun ? "Would prune" : "Pruned";
+        const prefix = options.dryRun ? chalk.yellow("[DRY RUN] ") : "";
+        for (const result of results) {
+            console.log(`${prefix}${chalk.cyan(result.domain)}: ${label} ${chalk.red(String(result.pruned))} of ${result.before} entries (${result.after} remaining)`);
+        }
+        console.log(`\n${prefix}${chalk.bold(`Total: ${label.toLowerCase()} ${totalPruned} stale ${totalPruned === 1 ? "entry" : "entries"}.`)}`);
+    });
+}
+//# sourceMappingURL=prune.js.map

package/dist/commands/prune.js.map

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

package/dist/commands/query.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerQueryCommand(program: Command): void;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuD3D"}

package/dist/commands/query.js

@@ -0,0 +1,58 @@
+import { readConfig, getExpertisePath } from "../utils/config.js";
+import { readExpertiseFile, getFileModTime, filterByType } from "../utils/expertise.js";
+import { formatDomainExpertise } from "../utils/format.js";
+export function registerQueryCommand(program) {
+    program
+        .command("query")
+        .argument("[domain]", "expertise domain to query")
+        .description("Query expertise records")
+        .option("--type <type>", "filter by record type")
+        .option("--all", "show all domains")
+        .action(async (domain, options) => {
+        try {
+            const config = await readConfig();
+            const domainsToQuery = [];
+            if (options.all) {
+                domainsToQuery.push(...config.domains);
+                if (domainsToQuery.length === 0) {
+                    console.log("No domains configured. Run `mulch add <domain>` to get started.");
+                    return;
+                }
+            }
+            else if (domain) {
+                if (!config.domains.includes(domain)) {
+                    console.error(`Error: Domain "${domain}" not found in config. Available domains: ${config.domains.join(", ") || "(none)"}`);
+                    process.exitCode = 1;
+                    return;
+                }
+                domainsToQuery.push(domain);
+            }
+            else {
+                console.error("Error: Please specify a domain or use --all to query all domains.");
+                process.exitCode = 1;
+                return;
+            }
+            const sections = [];
+            for (const d of domainsToQuery) {
+                const filePath = getExpertisePath(d);
+                let records = await readExpertiseFile(filePath);
+                const lastUpdated = await getFileModTime(filePath);
+                if (options.type) {
+                    records = filterByType(records, options.type);
+                }
+                sections.push(formatDomainExpertise(d, records, lastUpdated));
+            }
+            console.log(sections.join("\n\n"));
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                console.error("Error: No .mulch/ directory found. Run `mulch init` first.");
+            }
+            else {
+                console.error(`Error: ${err.message}`);
+            }
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;SACjD,WAAW,CAAC,yBAAyB,CAAC;SACtC,MAAM,CAAC,eAAe,EAAE,uBAAuB,CAAC;SAChD,MAAM,CAAC,OAAO,EAAE,kBAAkB,CAAC;SACnC,MAAM,CAAC,KAAK,EAAE,MAA0B,EAAE,OAAgC,EAAE,EAAE;QAC7E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;YAElC,MAAM,cAAc,GAAa,EAAE,CAAC;YAEpC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,cAAc,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBACvC,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAChC,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;oBAC/E,OAAO;gBACT,CAAC;YACH,CAAC;iBAAM,IAAI,MAAM,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrC,OAAO,CAAC,KAAK,CAAC,kBAAkB,MAAM,6CAA6C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;oBAC5H,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;oBACrB,OAAO;gBACT,CAAC;gBACD,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;gBACnF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;gBACrC,IAAI,OAAO,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;gBAChD,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;gBAEnD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,IAAc,CAAC,CAAC;gBAC1D,CAAC;gBAED,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;YAChE,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAC9E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/record.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerRecordCommand(program: Command): void;
+//# sourceMappingURL=record.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/commands/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAmB5C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyQ5D"}

package/dist/commands/record.js

@@ -0,0 +1,206 @@
+import { Option } from "commander";
+import _Ajv from "ajv";
+const Ajv = _Ajv.default ?? _Ajv;
+import chalk from "chalk";
+import { readConfig, getExpertisePath } from "../utils/config.js";
+import { appendRecord, readExpertiseFile, writeExpertiseFile, findDuplicate, } from "../utils/expertise.js";
+import { recordSchema } from "../schemas/record-schema.js";
+export function registerRecordCommand(program) {
+    program
+        .command("record")
+        .argument("<domain>", "expertise domain")
+        .argument("[content]", "record content")
+        .description("Record an expertise entry")
+        .addOption(new Option("--type <type>", "record type")
+        .choices(["convention", "pattern", "failure", "decision", "reference", "guide"])
+        .makeOptionMandatory())
+        .addOption(new Option("--classification <classification>", "classification level")
+        .choices(["foundational", "tactical", "observational"])
+        .default("tactical"))
+        .option("--name <name>", "name of the convention or pattern")
+        .option("--description <description>", "description of the record")
+        .option("--resolution <resolution>", "resolution for failure records")
+        .option("--title <title>", "title for decision records")
+        .option("--rationale <rationale>", "rationale for decision records")
+        .option("--files <files>", "related files (comma-separated)")
+        .option("--tags <tags>", "comma-separated tags")
+        .option("--evidence-commit <commit>", "evidence: commit hash")
+        .option("--evidence-issue <issue>", "evidence: issue reference")
+        .option("--evidence-file <file>", "evidence: file path")
+        .option("--force", "force recording even if duplicate exists")
+        .action(async (domain, content, options) => {
+        const config = await readConfig();
+        if (!config.domains.includes(domain)) {
+            console.error(chalk.red(`Error: domain "${domain}" not found in config.`));
+            console.error(chalk.red(`Available domains: ${config.domains.join(", ") || "(none)"}`));
+            process.exit(1);
+        }
+        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) {
+            evidence = {};
+            if (options.evidenceCommit)
+                evidence.commit = options.evidenceCommit;
+            if (options.evidenceIssue)
+                evidence.issue = options.evidenceIssue;
+            if (options.evidenceFile)
+                evidence.file = options.evidenceFile;
+        }
+        const tags = typeof options.tags === "string"
+            ? options.tags
+                .split(",")
+                .map((t) => t.trim())
+                .filter(Boolean)
+            : undefined;
+        let record;
+        switch (recordType) {
+            case "convention": {
+                const conventionContent = content ?? options.description;
+                if (!conventionContent) {
+                    console.error(chalk.red("Error: convention records require content (positional argument or --description)."));
+                    process.exit(1);
+                }
+                record = {
+                    type: "convention",
+                    content: conventionContent,
+                    classification,
+                    recorded_at: recordedAt,
+                    ...(evidence && { evidence }),
+                    ...(tags && tags.length > 0 && { tags }),
+                };
+                break;
+            }
+            case "pattern": {
+                const patternName = options.name;
+                const patternDesc = options.description ?? content;
+                if (!patternName || !patternDesc) {
+                    console.error(chalk.red("Error: pattern records require --name and --description (or positional content)."));
+                    process.exit(1);
+                }
+                record = {
+                    type: "pattern",
+                    name: patternName,
+                    description: patternDesc,
+                    classification,
+                    recorded_at: recordedAt,
+                    ...(evidence && { evidence }),
+                    ...(typeof options.files === "string" && {
+                        files: options.files.split(","),
+                    }),
+                    ...(tags && tags.length > 0 && { tags }),
+                };
+                break;
+            }
+            case "failure": {
+                const failureDesc = options.description;
+                const failureResolution = options.resolution;
+                if (!failureDesc || !failureResolution) {
+                    console.error(chalk.red("Error: failure records require --description and --resolution."));
+                    process.exit(1);
+                }
+                record = {
+                    type: "failure",
+                    description: failureDesc,
+                    resolution: failureResolution,
+                    classification,
+                    recorded_at: recordedAt,
+                    ...(evidence && { evidence }),
+                    ...(tags && tags.length > 0 && { tags }),
+                };
+                break;
+            }
+            case "decision": {
+                const decisionTitle = options.title;
+                const decisionRationale = options.rationale;
+                if (!decisionTitle || !decisionRationale) {
+                    console.error(chalk.red("Error: decision records require --title and --rationale."));
+                    process.exit(1);
+                }
+                record = {
+                    type: "decision",
+                    title: decisionTitle,
+                    rationale: decisionRationale,
+                    classification,
+                    recorded_at: recordedAt,
+                    ...(evidence && { evidence }),
+                    ...(tags && tags.length > 0 && { tags }),
+                };
+                break;
+            }
+            case "reference": {
+                const refName = options.name;
+                const refDesc = options.description ?? content;
+                if (!refName || !refDesc) {
+                    console.error(chalk.red("Error: reference records require --name and --description (or positional content)."));
+                    process.exit(1);
+                }
+                record = {
+                    type: "reference",
+                    name: refName,
+                    description: refDesc,
+                    classification,
+                    recorded_at: recordedAt,
+                    ...(evidence && { evidence }),
+                    ...(typeof options.files === "string" && {
+                        files: options.files.split(","),
+                    }),
+                    ...(tags && tags.length > 0 && { tags }),
+                };
+                break;
+            }
+            case "guide": {
+                const guideName = options.name;
+                const guideDesc = options.description ?? content;
+                if (!guideName || !guideDesc) {
+                    console.error(chalk.red("Error: guide records require --name and --description (or positional content)."));
+                    process.exit(1);
+                }
+                record = {
+                    type: "guide",
+                    name: guideName,
+                    description: guideDesc,
+                    classification,
+                    recorded_at: recordedAt,
+                    ...(evidence && { evidence }),
+                    ...(tags && tags.length > 0 && { tags }),
+                };
+                break;
+            }
+        }
+        // Validate against JSON schema
+        const ajv = new Ajv();
+        const validate = ajv.compile(recordSchema);
+        if (!validate(record)) {
+            console.error(chalk.red("Error: record failed schema validation:"));
+            for (const err of validate.errors ?? []) {
+                console.error(chalk.red(`  ${err.instancePath} ${err.message}`));
+            }
+            process.exit(1);
+        }
+        const filePath = getExpertisePath(domain);
+        const existing = await readExpertiseFile(filePath);
+        const dup = findDuplicate(existing, record);
+        if (dup && !options.force) {
+            const isNamed = record.type === "pattern" || record.type === "decision" ||
+                record.type === "reference" || record.type === "guide";
+            if (isNamed) {
+                // Upsert: replace in place
+                existing[dup.index] = record;
+                await writeExpertiseFile(filePath, existing);
+                console.log(chalk.green(`\u2714 Updated existing ${recordType} in ${domain} (record #${dup.index + 1})`));
+            }
+            else {
+                // Exact match: skip
+                console.log(chalk.yellow(`Duplicate ${recordType} already exists in ${domain} (record #${dup.index + 1}). Use --force to add anyway.`));
+            }
+        }
+        else {
+            await appendRecord(filePath, record);
+            console.log(chalk.green(`\u2714 Recorded ${recordType} in ${domain}`));
+        }
+    });
+}
+//# sourceMappingURL=record.js.map

package/dist/commands/record.js.map

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

package/dist/commands/search.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerSearchCommand(program: Command): void;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAM5C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6F5D"}

package/dist/commands/search.js

@@ -0,0 +1,80 @@
+import { Option } from "commander";
+import { readConfig, getExpertisePath } from "../utils/config.js";
+import { readExpertiseFile, getFileModTime, filterByType } from "../utils/expertise.js";
+import { searchRecords } from "../utils/expertise.js";
+import { formatDomainExpertise } from "../utils/format.js";
+export function registerSearchCommand(program) {
+    program
+        .command("search")
+        .argument("[query]", "search string (case-insensitive substring match)")
+        .description("Search expertise records across domains")
+        .option("--domain <domain>", "limit search to a specific domain")
+        .addOption(new Option("--type <type>", "filter by record type").choices([
+        "convention",
+        "pattern",
+        "failure",
+        "decision",
+        "reference",
+        "guide",
+    ]))
+        .option("--tag <tag>", "filter by tag")
+        .action(async (query, options) => {
+        try {
+            if (!query && !options.type && !options.domain && !options.tag) {
+                console.error("Error: Provide a search query or use --type, --domain, or --tag to filter.");
+                process.exitCode = 1;
+                return;
+            }
+            const config = await readConfig();
+            let domainsToSearch;
+            if (options.domain) {
+                if (!config.domains.includes(options.domain)) {
+                    console.error(`Error: Domain "${options.domain}" not found in config. Available domains: ${config.domains.join(", ")}`);
+                    process.exitCode = 1;
+                    return;
+                }
+                domainsToSearch = [options.domain];
+            }
+            else {
+                domainsToSearch = config.domains;
+            }
+            const sections = [];
+            let totalMatches = 0;
+            for (const domain of domainsToSearch) {
+                const filePath = getExpertisePath(domain);
+                let records = await readExpertiseFile(filePath);
+                const lastUpdated = await getFileModTime(filePath);
+                if (options.type) {
+                    records = filterByType(records, options.type);
+                }
+                if (options.tag) {
+                    const tagLower = options.tag.toLowerCase();
+                    records = records.filter((r) => r.tags?.some((t) => t.toLowerCase() === tagLower));
+                }
+                const matches = query ? searchRecords(records, query) : records;
+                if (matches.length > 0) {
+                    totalMatches += matches.length;
+                    sections.push(formatDomainExpertise(domain, matches, lastUpdated));
+                }
+            }
+            const label = query ? `matching "${query}"` : "matching filters";
+            if (sections.length === 0) {
+                console.log(`No records ${label} found.`);
+            }
+            else {
+                console.log(sections.join("\n\n"));
+                console.log(`\n${totalMatches} match${totalMatches === 1 ? "" : "es"} found.`);
+            }
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                console.error("Error: No .mulch/ directory found. Run `mulch init` first.");
+            }
+            else {
+                console.error(`Error: ${err.message}`);
+            }
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,29 @@
+import { Command } from "commander";
+/** Supported provider names. */
+declare const SUPPORTED_PROVIDERS: readonly ["claude", "cursor", "codex", "gemini", "windsurf", "aider"];
+type Provider = (typeof SUPPORTED_PROVIDERS)[number];
+/** Result of a provider recipe operation. */
+interface RecipeResult {
+    success: boolean;
+    message: string;
+}
+declare const MULCH_HOOK_SECTION = "# mulch:start\n# Run mulch validate before committing\nif command -v mulch >/dev/null 2>&1; then\n  mulch validate\n  if [ $? -ne 0 ]; then\n    echo \"mulch validate failed. Commit aborted.\"\n    exit 1\n  fi\nfi\n# mulch:end";
+declare function installGitHook(cwd: string): Promise<RecipeResult>;
+declare function checkGitHook(cwd: string): Promise<RecipeResult>;
+declare function removeGitHook(cwd: string): Promise<RecipeResult>;
+interface ProviderRecipe {
+    /** Install the integration (idempotent). */
+    install(cwd: string): Promise<RecipeResult>;
+    /** Check whether the integration is installed. */
+    check(cwd: string): Promise<RecipeResult>;
+    /** Remove the integration. */
+    remove(cwd: string): Promise<RecipeResult>;
+}
+declare const CLAUDE_HOOK_COMMAND = "mulch prime";
+declare const CURSOR_RULE_CONTENT = "---\ndescription: Mulch expertise integration\nglobs: *\nalwaysApply: true\n---\n\n# Mulch Expertise\n\nAt the start of every session, run the following command to load project expertise:\n\n```\nmulch prime\n```\n\nWhen you learn something new about this project (conventions, patterns, failures, decisions),\nrecord it with:\n\n```\nmulch record <domain> --type <convention|pattern|failure|decision> [options]\n```\n\nRun `mulch --help` for full usage.\n";
+declare const CODEX_SECTION = "<!-- mulch:start -->\n## Mulch Expertise\n\nAt the start of every session, run `mulch prime` to load project expertise.\n\nWhen you learn something new about this project, record it with:\n\n```\nmulch record <domain> --type <convention|pattern|failure|decision> [options]\n```\n<!-- mulch:end -->";
+declare const recipes: Record<Provider, ProviderRecipe>;
+export { recipes, SUPPORTED_PROVIDERS, CURSOR_RULE_CONTENT, CODEX_SECTION, CLAUDE_HOOK_COMMAND, MULCH_HOOK_SECTION, installGitHook, checkGitHook, removeGitHook, };
+export type { Provider, ProviderRecipe };
+export declare function registerSetupCommand(program: Command): void;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,gCAAgC;AAChC,QAAA,MAAM,mBAAmB,uEAOf,CAAC;AAEX,KAAK,QAAQ,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMrD,6CAA6C;AAC7C,UAAU,YAAY;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,QAAA,MAAM,kBAAkB,wOASL,CAAC;AAEpB,iBAAe,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA6BhE;AAED,iBAAe,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAY9D;AAED,iBAAe,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyB/D;AAMD,UAAU,cAAc;IACtB,4CAA4C;IAC5C,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,kDAAkD;IAClD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1C,8BAA8B;IAC9B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5C;AAqBD,QAAA,MAAM,mBAAmB,gBAAgB,CAAC;AAuI1C,QAAA,MAAM,mBAAmB,6cAsBxB,CAAC;AAkDF,QAAA,MAAM,aAAa,8SAUS,CAAC;AAkK7B,QAAA,MAAM,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,CAO7C,CAAC;AAIF,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,aAAa,GACd,CAAC;AAEF,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AAIzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmG3D"}