mulch-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jaymin West
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,104 @@
+# Mulch — Growing Expertise for Coding Agents
+
+Structured expertise files that accumulate over time, live in git, work with any agent, and run locally with zero dependencies.
+
+Agents start every session from zero. The pattern your agent discovered yesterday is forgotten today. Mulch fixes this: agents call `mulch record` to write learnings, and `mulch query` to read them. Expertise compounds across sessions, domains, and teammates.
+
+**Mulch is a passive layer.** It does not contain an LLM. Agents use Mulch — Mulch does not use agents.
+
+## Quick Start
+
+```bash
+npx mulch-cli init                                    # Create .mulch/ in your project
+mulch add database                                    # Add a domain
+mulch record database --type convention "Use WAL mode for SQLite"
+mulch record database --type failure \
+  --description "VACUUM inside a transaction causes silent corruption" \
+  --resolution "Always run VACUUM outside transaction boundaries"
+mulch query database                                  # See accumulated expertise
+mulch prime                                           # Get full context for agent injection
+mulch prime database                                  # Get context for one domain only
+```
+
+## How It Works
+
+```
+1. mulch init               → Creates .mulch/ with domain JSONL files
+2. Agent reads expertise     → Grounded in everything the project has learned
+3. Agent does work           → Normal task execution
+4. Agent calls mulch record  → Writes structured learnings back to .mulch/
+5. git push                  → Teammates' agents get smarter too
+```
+
+The critical insight: step 4 is **agent-driven**. The agent decides what's worth recording. Mulch provides the schema and file structure so those learnings land in a consistent, queryable format.
+
+## What's in `.mulch/`
+
+```
+.mulch/
+├── expertise/
+│   ├── database.jsonl        # All database knowledge
+│   ├── api.jsonl             # One JSONL file per domain
+│   └── testing.jsonl         # Each line is a typed, structured record
+└── mulch.config.yaml         # Config: domains, governance settings
+```
+
+Everything is git-tracked. Clone a repo and your agents immediately have the project's accumulated expertise.
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `mulch init` | Initialize `.mulch/` in the current project |
+| `mulch add <domain>` | Add a new expertise domain |
+| `mulch record <domain> --type <type>` | Record an expertise entry |
+| `mulch query [domain]` | Query expertise (use `--all` for all domains) |
+| `mulch prime [domain]` | Output AI-optimized expertise context (optionally scoped) |
+| `mulch search <query>` | Search records across domains (`--domain`, `--type` filters) |
+| `mulch status` | Show expertise freshness and counts |
+| `mulch validate` | Schema validation across all files |
+| `mulch setup <provider>` | Install provider-specific hooks |
+| `mulch onboard` | Generate AGENTS.md/CLAUDE.md snippet |
+| `mulch prune` | Remove stale tactical entries |
+
+## Record Types
+
+| Type | Required Fields | Use Case |
+|------|----------------|----------|
+| `convention` | content | "Use WAL mode for SQLite connections" |
+| `pattern` | name, description | Named patterns with optional file references |
+| `failure` | description, resolution | What went wrong and how to avoid it |
+| `decision` | title, rationale | Architectural decisions and their reasoning |
+
+All records support optional `--classification` (foundational / tactical / observational) and evidence flags (`--evidence-commit`, `--evidence-issue`, `--evidence-file`).
+
+## Example Output
+
+```
+$ mulch query database
+
+## database (6 entries, updated 2h ago)
+
+### Conventions
+- Use WAL mode for all SQLite connections
+- Migrations are sequential, never concurrent
+
+### Known Failures
+- VACUUM inside a transaction causes silent corruption
+  → Always run VACUUM outside transaction boundaries
+
+### Decisions
+- **SQLite over PostgreSQL**: Local-only product, no network dependency acceptable
+```
+
+## Design Principles
+
+- **Zero LLM dependency** — Mulch makes no LLM calls. Quality equals agent quality.
+- **Provider-agnostic** — Any agent with bash access can call the CLI.
+- **Git-native** — Everything lives in `.mulch/`, tracked in version control.
+- **Append-only JSONL** — Zero merge conflicts, trivial schema validation.
+- **Storage ≠ Delivery** — JSONL on disk, optimized markdown/XML for agents.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerInitCommand } from "./commands/init.js";
+import { registerAddCommand } from "./commands/add.js";
+import { registerRecordCommand } from "./commands/record.js";
+import { registerEditCommand } from "./commands/edit.js";
+import { registerQueryCommand } from "./commands/query.js";
+import { registerSetupCommand } from "./commands/setup.js";
+import { registerPrimeCommand } from "./commands/prime.js";
+import { registerOnboardCommand } from "./commands/onboard.js";
+import { registerStatusCommand } from "./commands/status.js";
+import { registerValidateCommand } from "./commands/validate.js";
+import { registerPruneCommand } from "./commands/prune.js";
+import { registerSearchCommand } from "./commands/search.js";
+const program = new Command();
+program
+    .name("mulch")
+    .description("Growing Expertise for Coding Agents")
+    .version("0.1.0");
+registerInitCommand(program);
+registerAddCommand(program);
+registerRecordCommand(program);
+registerEditCommand(program);
+registerQueryCommand(program);
+registerSetupCommand(program);
+registerPrimeCommand(program);
+registerOnboardCommand(program);
+registerStatusCommand(program);
+registerValidateCommand(program);
+registerPruneCommand(program);
+registerSearchCommand(program);
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,qCAAqC,CAAC;KAClD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/add.d.ts

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

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

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

package/dist/commands/add.js

@@ -0,0 +1,30 @@
+import { existsSync } from "node:fs";
+import chalk from "chalk";
+import { getMulchDir, readConfig, writeConfig, getExpertisePath } from "../utils/config.js";
+import { createExpertiseFile } from "../utils/expertise.js";
+export function registerAddCommand(program) {
+    program
+        .command("add")
+        .argument("<domain>", "expertise domain to add")
+        .description("Add a new expertise domain")
+        .action(async (domain) => {
+        const mulchDir = getMulchDir();
+        if (!existsSync(mulchDir)) {
+            console.error(chalk.red("No .mulch/ directory found. Run `mulch init` first."));
+            process.exitCode = 1;
+            return;
+        }
+        const config = await readConfig();
+        if (config.domains.includes(domain)) {
+            console.error(chalk.red(`Domain "${domain}" already exists.`));
+            process.exitCode = 1;
+            return;
+        }
+        const expertisePath = getExpertisePath(domain);
+        await createExpertiseFile(expertisePath);
+        config.domains.push(domain);
+        await writeConfig(config);
+        console.log(chalk.green(`Added domain "${domain}".`));
+    });
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;SAC/C,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;QAC/B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAE/B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,qDAAqD,CAAC,CACjE,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;QAElC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,WAAW,MAAM,mBAAmB,CAAC,CAChD,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,mBAAmB,CAAC,aAAa,CAAC,CAAC;QAEzC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAE1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,MAAM,IAAI,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/edit.d.ts

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

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

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

package/dist/commands/edit.js

@@ -0,0 +1,128 @@
+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 { readExpertiseFile, writeExpertiseFile, } from "../utils/expertise.js";
+import { recordSchema } from "../schemas/record-schema.js";
+export function registerEditCommand(program) {
+    program
+        .command("edit")
+        .argument("<domain>", "expertise domain")
+        .argument("<index>", "1-based record index")
+        .description("Edit an existing expertise record")
+        .addOption(new Option("--classification <classification>", "update classification").choices(["foundational", "tactical", "observational"]))
+        .option("--content <content>", "update content (convention)")
+        .option("--name <name>", "update name (pattern)")
+        .option("--description <description>", "update description")
+        .option("--resolution <resolution>", "update resolution (failure)")
+        .option("--title <title>", "update title (decision)")
+        .option("--rationale <rationale>", "update rationale (decision)")
+        .option("--files <files>", "update related files (comma-separated)")
+        .action(async (domain, indexStr, options) => {
+        try {
+            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.exitCode = 1;
+                return;
+            }
+            const index = parseInt(indexStr, 10);
+            if (isNaN(index) || index < 1) {
+                console.error(chalk.red("Error: index must be a positive integer (1-based)."));
+                process.exitCode = 1;
+                return;
+            }
+            const filePath = getExpertisePath(domain);
+            const records = await readExpertiseFile(filePath);
+            if (index > records.length) {
+                console.error(chalk.red(`Error: index ${index} out of range. Domain "${domain}" has ${records.length} record(s).`));
+                process.exitCode = 1;
+                return;
+            }
+            const record = { ...records[index - 1] };
+            // Apply updates based on record type
+            if (options.classification) {
+                record.classification = options.classification;
+            }
+            switch (record.type) {
+                case "convention":
+                    if (options.content) {
+                        record.content = options.content;
+                    }
+                    break;
+                case "pattern":
+                    if (options.name) {
+                        record.name = options.name;
+                    }
+                    if (options.description) {
+                        record.description = options.description;
+                    }
+                    if (typeof options.files === "string") {
+                        record.files = options.files.split(",");
+                    }
+                    break;
+                case "failure":
+                    if (options.description) {
+                        record.description = options.description;
+                    }
+                    if (options.resolution) {
+                        record.resolution = options.resolution;
+                    }
+                    break;
+                case "decision":
+                    if (options.title) {
+                        record.title = options.title;
+                    }
+                    if (options.rationale) {
+                        record.rationale = options.rationale;
+                    }
+                    break;
+                case "reference":
+                    if (options.name) {
+                        record.name = options.name;
+                    }
+                    if (options.description) {
+                        record.description = options.description;
+                    }
+                    if (typeof options.files === "string") {
+                        record.files = options.files.split(",");
+                    }
+                    break;
+                case "guide":
+                    if (options.name) {
+                        record.name = options.name;
+                    }
+                    if (options.description) {
+                        record.description = options.description;
+                    }
+                    break;
+            }
+            // Validate the updated record
+            const ajv = new Ajv();
+            const validate = ajv.compile(recordSchema);
+            if (!validate(record)) {
+                console.error(chalk.red("Error: updated record failed schema validation:"));
+                for (const err of validate.errors ?? []) {
+                    console.error(chalk.red(`  ${err.instancePath} ${err.message}`));
+                }
+                process.exitCode = 1;
+                return;
+            }
+            records[index - 1] = record;
+            await writeExpertiseFile(filePath, records);
+            console.log(chalk.green(`\u2714 Updated ${record.type} #${index} in ${domain}`));
+        }
+        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=edit.js.map

package/dist/commands/edit.js.map

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

package/dist/commands/init.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB1D"}

package/dist/commands/init.js

@@ -0,0 +1,20 @@
+import { existsSync } from "node:fs";
+import chalk from "chalk";
+import { getMulchDir, initMulchDir } from "../utils/config.js";
+export function registerInitCommand(program) {
+    program
+        .command("init")
+        .description("Initialize .mulch/ in the current project")
+        .action(async () => {
+        const mulchDir = getMulchDir();
+        const alreadyExists = existsSync(mulchDir);
+        await initMulchDir();
+        if (alreadyExists) {
+            console.log(chalk.green("Updated .mulch/ — filled in any missing artifacts."));
+        }
+        else {
+            console.log(chalk.green(`Initialized .mulch/ in ${process.cwd()}`));
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,2CAA2C,CAAC;SACxD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE3C,MAAM,YAAY,EAAE,CAAC;QAErB,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAClE,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,0BAA0B,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/onboard.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+export declare function runOnboard(options: {
+    stdout?: boolean;
+    provider?: string;
+    cwd?: string;
+}): Promise<void>;
+export declare function registerOnboardCommand(program: Command): void;
+//# sourceMappingURL=onboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6GpC,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BhB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmB7D"}

package/dist/commands/onboard.js

@@ -0,0 +1,144 @@
+import { readFile, writeFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+const SNIPPET_DEFAULT = `## Project Expertise (Mulch)
+
+This project uses [Mulch](https://github.com/jayminwest/mulch) for structured expertise management.
+
+**Before starting work**, run:
+\`\`\`bash
+mulch prime
+\`\`\`
+
+**After completing work**, record learnings:
+\`\`\`bash
+mulch record <domain> --type <convention|pattern|failure|decision> --description "..."
+\`\`\`
+
+Run \`mulch status\` to see available domains and expertise health.
+
+### Session Completion Checklist
+
+1. Record learnings:
+   \`\`\`bash
+   mulch record <domain> --type <convention|pattern|failure|decision> --description "..."
+   \`\`\`
+2. Validate records:
+   \`\`\`bash
+   mulch validate
+   \`\`\`
+3. Commit changes:
+   \`\`\`bash
+   git add .mulch/ && git commit -m "Update expertise"
+   \`\`\`
+4. Push to share:
+   \`\`\`bash
+   git push
+   \`\`\`
+`;
+function getSnippet(provider) {
+    if (!provider || provider === "default") {
+        return SNIPPET_DEFAULT;
+    }
+    // Provider-specific snippets customize the phrasing slightly
+    if (provider === "claude") {
+        return `## Project Expertise (Mulch)
+
+This project uses [Mulch](https://github.com/jayminwest/mulch) for structured expertise management.
+
+**At the start of every session**, run:
+\`\`\`bash
+mulch prime
+\`\`\`
+
+This injects project-specific conventions, patterns, and decisions into your context.
+
+**After completing work**, record what you learned:
+\`\`\`bash
+mulch record <domain> --type <convention|pattern|failure|decision> --description "..."
+\`\`\`
+
+Run \`mulch status\` to check domain health and entry counts.
+
+### Session Completion Checklist
+
+1. Record learnings:
+   \`\`\`bash
+   mulch record <domain> --type <convention|pattern|failure|decision> --description "..."
+   \`\`\`
+2. Validate records:
+   \`\`\`bash
+   mulch validate
+   \`\`\`
+3. Commit changes:
+   \`\`\`bash
+   git add .mulch/ && git commit -m "Update expertise"
+   \`\`\`
+4. Push to share:
+   \`\`\`bash
+   git push
+   \`\`\`
+`;
+    }
+    // For any other provider, use the default snippet
+    return SNIPPET_DEFAULT;
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function detectTargetFile(cwd) {
+    // If CLAUDE.md exists, prefer it
+    if (await fileExists(join(cwd, "CLAUDE.md"))) {
+        return "CLAUDE.md";
+    }
+    // Otherwise default to AGENTS.md
+    return "AGENTS.md";
+}
+export async function runOnboard(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const snippet = getSnippet(options.provider);
+    if (options.stdout) {
+        process.stdout.write(snippet);
+        return;
+    }
+    const targetFileName = await detectTargetFile(cwd);
+    const targetPath = join(cwd, targetFileName);
+    // Check if snippet is already present
+    if (await fileExists(targetPath)) {
+        const existing = await readFile(targetPath, "utf-8");
+        if (existing.includes("## Project Expertise (Mulch)")) {
+            console.log(chalk.yellow(`Mulch snippet already exists in ${targetFileName}. No changes made.`));
+            return;
+        }
+        // Append to existing file
+        await writeFile(targetPath, existing + "\n" + snippet, "utf-8");
+    }
+    else {
+        // Create new file
+        await writeFile(targetPath, snippet, "utf-8");
+    }
+    console.log(chalk.green(`Mulch onboarding snippet written to ${targetFileName}`));
+}
+export function registerOnboardCommand(program) {
+    program
+        .command("onboard")
+        .description("Generate an AGENTS.md/CLAUDE.md snippet pointing to mulch prime")
+        .option("--stdout", "print snippet to stdout instead of writing to file")
+        .option("--provider <provider>", "customize snippet for a specific provider (e.g. claude)")
+        .action(async (options) => {
+        try {
+            await runOnboard(options);
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=onboard.js.map

package/dist/commands/onboard.js.map

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

package/dist/commands/prime.d.ts

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

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

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