briefops 1.0.0

package/dist/commands/doctor.js

@@ -0,0 +1,90 @@
+import { cleanStaleLocks } from "../core/lock.js";
+import { memoryCategories, workspacePaths } from "../core/paths.js";
+import { fixBriefOpsGitignore, runPrivacyDoctor } from "../core/privacyDoctor.js";
+import { runSecurityDoctor } from "../core/securityDoctor.js";
+import { pathExists } from "../core/storage.js";
+import { printTable } from "./shared.js";
+export function registerDoctorCommand(program) {
+    program
+        .command("doctor")
+        .description("Check the local BriefOps workspace structure.")
+        .option("--security", "Run security, export, and local conflict checks.")
+        .option("--fix-stale-locks", "Remove stale BriefOps workspace locks before reporting security checks.")
+        .option("--privacy", "Run privacy checks for local memory and share safety.")
+        .option("--fix-gitignore", "Add `.briefops/` to .gitignore when running --privacy.")
+        .action(async (options) => {
+        if (options.privacy) {
+            if (options.fixGitignore) {
+                const path = await fixBriefOpsGitignore();
+                console.log(`Updated gitignore: ${path}`);
+                console.log("");
+            }
+            const result = await runPrivacyDoctor();
+            printTable([
+                ["Check", "Status", "Detail"],
+                ...result.checks.map((check) => [check.name, check.status, check.detail])
+            ]);
+            if (!result.ok) {
+                process.exitCode = 1;
+            }
+            return;
+        }
+        if (options.security) {
+            if (options.fixStaleLocks) {
+                const removed = await cleanStaleLocks();
+                if (removed.length > 0) {
+                    console.log("Removed stale lock files:");
+                    for (const filePath of removed) {
+                        console.log(`- ${filePath}`);
+                    }
+                    console.log("");
+                }
+                else {
+                    console.log("No stale lock files removed.");
+                    console.log("");
+                }
+            }
+            const result = await runSecurityDoctor();
+            printTable([
+                ["Check", "Status", "Detail"],
+                ...result.checks.map((check) => [check.name, check.status, check.detail])
+            ]);
+            if (!result.ok) {
+                process.exitCode = 1;
+            }
+            return;
+        }
+        const paths = workspacePaths(process.cwd());
+        const checks = [
+            ["Workspace", paths.root],
+            ["Config", paths.config],
+            ["Skills", paths.skills],
+            ["Projects", paths.projects],
+            ["Memory", paths.memory],
+            ...memoryCategories.map((category) => [
+                `Memory/${category}`,
+                `${paths.memory}/${category}.yaml`
+            ]),
+            ["Workers", paths.workers],
+            ["Logs", paths.logs],
+            ["Briefs", paths.briefs],
+            ["Codex", paths.codex],
+            ["Codex Prompts", paths.codexPrompts],
+            ["Evals", paths.evals],
+            ["Eval Results", paths.evalResults],
+            ["Patches", paths.patches],
+            ["Templates", paths.templates]
+        ];
+        const rows = await Promise.all(checks.map(async ([label, filePath]) => [
+            label,
+            (await pathExists(filePath)) ? "ok" : "missing",
+            filePath
+        ]));
+        const missing = rows.filter((row) => row[1] === "missing");
+        printTable([["Check", "Status", "Path"], ...rows]);
+        if (missing.length > 0) {
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/eval.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerEvalCommands(program: Command): void;

package/dist/commands/eval.js

@@ -0,0 +1,89 @@
+import { createEvalCase, listEvalCases, runEval, showEval } from "../core/eval.js";
+import { collectRepeated, parsePositiveInt, printTable } from "./shared.js";
+export function registerEvalCommands(program) {
+    const evalCommand = program.command("eval").description("Manage checklist-based eval cases.");
+    evalCommand
+        .command("create <name>")
+        .description("Create a checklist eval case.")
+        .option("--skill <skill>", "Skill name.")
+        .option("--project <project>", "Project name.")
+        .option("--worker <worker>", "Worker profile name.")
+        .option("--description <description>", "Case description.")
+        .option("--input <input>", "Task input for brief generation.")
+        .option("--expected <text>", "Expected phrase/check. Can be repeated.", collectRepeated, [])
+        .option("--pass-threshold <count>", "Minimum expected checks required to pass.", parsePositiveInt)
+        .option("--force", "Overwrite an existing eval case.")
+        .action(async (name, options) => {
+        const result = await createEvalCase({
+            name,
+            skill: options.skill,
+            project: options.project,
+            worker: options.worker,
+            description: options.description,
+            input: options.input,
+            expected: options.expected,
+            passThreshold: options.passThreshold,
+            force: Boolean(options.force)
+        });
+        console.log(`Created eval case: ${result.evalCase.id}`);
+        console.log(result.path);
+    });
+    evalCommand
+        .command("list")
+        .description("List eval cases.")
+        .action(async () => {
+        const cases = await listEvalCases(process.cwd());
+        if (cases.length === 0) {
+            console.log("No eval cases found.");
+            return;
+        }
+        printTable([
+            ["ID", "Skill", "Project", "Worker", "Expected"],
+            ...cases.map((item) => [
+                item.id,
+                item.skill ?? "",
+                item.project ?? "",
+                item.worker ?? "",
+                String(item.expected.length)
+            ])
+        ]);
+    });
+    evalCommand
+        .command("run")
+        .description("Run matching checklist eval cases.")
+        .option("--skill <skill>", "Filter/run with skill.")
+        .option("--project <project>", "Filter/run with project.")
+        .option("--worker <worker>", "Filter/run with worker.")
+        .option("--budget <tokens>", "Brief token budget.", parsePositiveInt, 2000)
+        .option("--adapter <adapter>", "generic|codex|claude-code", "generic")
+        .action(async (options) => {
+        const summary = await runEval({
+            skill: options.skill,
+            project: options.project,
+            worker: options.worker,
+            budget: options.budget,
+            adapter: options.adapter
+        });
+        console.log(`${summary.cases.length} cases run`);
+        console.log(`${summary.passed} passed`);
+        console.log(`${summary.failed} failed`);
+        console.log("");
+        printTable([
+            ["Case", "Result", "Score", "Missing"],
+            ...summary.cases.map((item) => [
+                item.case.id,
+                item.result.passed ? "pass" : "fail",
+                `${item.result.score}/${item.case.expected.length}`,
+                item.result.missing.join(",")
+            ])
+        ]);
+        console.error(`Saved eval result: ${summary.resultPath}`);
+    });
+    evalCommand
+        .command("show <id>")
+        .description("Show an eval case or saved result.")
+        .action(async (id) => {
+        console.log(await showEval(process.cwd(), id));
+    });
+}
+//# sourceMappingURL=eval.js.map

package/dist/commands/eval.js.map

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

package/dist/commands/export.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerExportCommands(program: Command): void;

package/dist/commands/export.js

@@ -0,0 +1,105 @@
+import path from "node:path";
+import { renderHarnessExport } from "../core/exportTargets.js";
+import { normalizeExportPolicy } from "../core/exportPolicy.js";
+import { BriefOpsError } from "../core/errors.js";
+import { pathExists, writeTextFile } from "../core/storage.js";
+function renderTarget(target, options) {
+    return renderHarnessExport({
+        target,
+        worker: options.worker,
+        project: options.project,
+        exportPolicy: normalizeExportPolicy(options.exportPolicy ?? "shared-only"),
+        outputPath: options.output
+            ? path.resolve(process.cwd(), options.output)
+            : undefined,
+        force: Boolean(options.force),
+        dryRun: Boolean(options.dryRun),
+        stdout: Boolean(options.stdout)
+    });
+}
+async function writeResult(result, options) {
+    if (options.stdout) {
+        for (const file of result.files) {
+            console.log(`--- ${path.relative(process.cwd(), file.path)} ---`);
+            console.log(file.content.trimEnd());
+            console.log("");
+        }
+        return;
+    }
+    if (options.dryRun) {
+        for (const file of result.files) {
+            console.log(`Would write: ${file.path} (${file.tokens} tokens)`);
+        }
+        return;
+    }
+    const existing = [];
+    for (const file of result.files) {
+        if (!options.force && await pathExists(file.path)) {
+            existing.push(file.path);
+        }
+    }
+    if (existing.length > 0) {
+        throw new BriefOpsError(`Output file already exists: ${existing.join(", ")}. Use --force to overwrite.`);
+    }
+    for (const file of result.files) {
+        await writeTextFile(file.path, file.content, { force: Boolean(options.force) });
+        file.written = true;
+        console.log(`Wrote: ${file.path} (${file.tokens} tokens)`);
+    }
+}
+async function runExport(target, options) {
+    if (options.output && target === "cursor-rules") {
+        throw new BriefOpsError("--output is only supported for single-file exports.");
+    }
+    const result = renderTarget(target, options);
+    await writeResult(result, options);
+    if (result.warnings.length > 0) {
+        console.error("Warnings:");
+        for (const warning of result.warnings) {
+            console.error(`- ${warning}`);
+        }
+    }
+}
+function addCommonOptions(command, includeOutput = true) {
+    command
+        .option("--worker <worker>", "Worker profile name.")
+        .option("--project <project>", "Project name.")
+        .option("--export-policy <policy>", "local-private|shared-only", "shared-only")
+        .option("--force", "Overwrite existing generated files.")
+        .option("--dry-run", "Print target paths without writing files.")
+        .option("--stdout", "Print generated content instead of writing files.");
+    if (includeOutput) {
+        command.option("--output <path>", "Write the export to a specific path.");
+    }
+    return command;
+}
+export function registerExportCommands(program) {
+    const exportCommand = program
+        .command("export")
+        .description("Generate local AI harness router files without dumping BriefOps memory.");
+    addCommonOptions(exportCommand.command("agents-md").description("Generate AGENTS.md."))
+        .action(async (options) => runExport("agents-md", options));
+    addCommonOptions(exportCommand.command("claude-md").description("Generate CLAUDE.md."))
+        .action(async (options) => runExport("claude-md", options));
+    addCommonOptions(exportCommand.command("cursor-rules").description("Generate Cursor .mdc rule routers."), false).action(async (options) => runExport("cursor-rules", options));
+    addCommonOptions(exportCommand.command("all").description("Generate AGENTS.md, CLAUDE.md, and Cursor rules."), false)
+        .action(async (options) => {
+        const results = [
+            renderTarget("agents-md", options),
+            renderTarget("claude-md", options),
+            renderTarget("cursor-rules", options)
+        ];
+        const merged = {
+            files: results.flatMap((result) => result.files),
+            warnings: results.flatMap((result) => result.warnings)
+        };
+        await writeResult(merged, options);
+        if (merged.warnings.length > 0) {
+            console.error("Warnings:");
+            for (const warning of merged.warnings) {
+                console.error(`- ${warning}`);
+            }
+        }
+    });
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,mBAAmB,EAGpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAY/D,SAAS,YAAY,CAAC,MAAoB,EAAE,OAA6B;IACvE,OAAO,mBAAmB,CAAC;QACzB,MAAM;QACN,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,YAAY,EAAE,qBAAqB,CAAC,OAAO,CAAC,YAAY,IAAI,aAAa,CAAC;QAC1E,UAAU,EAAE,OAAO,CAAC,MAAM;YACxB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC;YAC7C,CAAC,CAAC,SAAS;QACb,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7B,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/B,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;KAChC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,MAA2B,EAAE,OAA6B;IACnF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,UAAU,CAAC,CAAC;QACnE,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,aAAa,CACrB,+BAA+B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAChF,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,UAAU,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,MAAoB,EAAE,OAA6B;IAC1E,IAAI,OAAO,CAAC,MAAM,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAChD,MAAM,IAAI,aAAa,CAAC,qDAAqD,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB,EAAE,aAAa,GAAG,IAAI;IAC9D,OAAO;SACJ,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;SACnD,MAAM,CAAC,qBAAqB,EAAE,eAAe,CAAC;SAC9C,MAAM,CAAC,0BAA0B,EAAE,2BAA2B,EAAE,aAAa,CAAC;SAC9E,MAAM,CAAC,SAAS,EAAE,qCAAqC,CAAC;SACxD,MAAM,CAAC,WAAW,EAAE,2CAA2C,CAAC;SAChE,MAAM,CAAC,UAAU,EAAE,mDAAmD,CAAC,CAAC;IAC3E,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,sCAAsC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,aAAa,GAAG,OAAO;SAC1B,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,yEAAyE,CAAC,CAAC;IAE1F,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;SACpF,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpF,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;SACpF,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpF,gBAAgB,CACd,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,WAAW,CAAC,oCAAoC,CAAC,EACvF,KAAK,CACN,CAAC,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IAEtF,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,kDAAkD,CAAC,EAAE,KAAK,CAAC;SAClH,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE;QAC9C,MAAM,OAAO,GAAG;YACd,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC;YAClC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC;YAClC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC;SACtC,CAAC;QACF,MAAM,MAAM,GAAwB;YAClC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;YAChD,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;SACvD,CAAC;QACF,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC3B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACtC,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/finish.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerFinishCommand(program: Command): void;

package/dist/commands/finish.js

@@ -0,0 +1,71 @@
+import { finishWork } from "../core/workflow.js";
+import { collectRepeated } from "./shared.js";
+export function registerFinishCommand(program) {
+    program
+        .command("finish")
+        .description("Finish a task: log work, propose memory, and print the next continue command.")
+        .option("--project <project>", "Project name.")
+        .option("--skill <skill>", "Skill name.")
+        .option("--worker <worker>", "Worker profile name.")
+        .requiredOption("--task <task>", "Completed task description.")
+        .requiredOption("--result <result>", "Work result.")
+        .option("--lesson <lesson>", "Lesson learned. Can be repeated.", collectRepeated, [])
+        .option("--open-risk <text>", "Unresolved risk. Can be repeated.", collectRepeated, [])
+        .option("--next-step <text>", "Suggested next step. Can be repeated.", collectRepeated, [])
+        .option("--decision <text>", "Decision made. Can be repeated.", collectRepeated, [])
+        .option("--incident <text>", "Incident or failure pattern. Can be repeated.", collectRepeated, [])
+        .option("--files <files>", "Comma-separated files changed.")
+        .option("--commands <commands>", "Comma-separated commands run.")
+        .option("--notes <notes>", "Additional notes.")
+        .option("--importance <importance>", "trivial|normal|durable|incident", "normal")
+        .option("--no-memory-proposal", "Skip memory proposal generation.")
+        .option("--propose-skill-patch", "Also propose a skill patch from log lessons.")
+        .option("--refresh-worker", "Refresh the worker summary after logging.")
+        .option("--continue-task <task>", "Task text to use in the printed continue command.")
+        .action(async (options) => {
+        const result = await finishWork({
+            project: options.project,
+            skill: options.skill,
+            worker: options.worker,
+            task: options.task,
+            result: options.result,
+            lessons: options.lesson,
+            openRisks: options.openRisk,
+            nextSteps: options.nextStep,
+            decisions: options.decision,
+            incidents: options.incident,
+            files: options.files,
+            commands: options.commands,
+            notes: options.notes,
+            importance: options.importance,
+            noMemoryProposal: Boolean(options.noMemoryProposal),
+            proposeSkillPatch: Boolean(options.proposeSkillPatch),
+            refreshWorker: Boolean(options.refreshWorker),
+            continueTask: options.continueTask
+        });
+        console.log(`Added work log: ${result.logId}`);
+        console.log(result.logPath);
+        if (result.memoryProposalId && result.memoryProposalPath) {
+            console.log(`Created memory proposal: ${result.memoryProposalId}`);
+            console.log(result.memoryProposalPath);
+        }
+        if (result.skillPatchId && result.skillPatchPath) {
+            console.log(`Created skill patch: ${result.skillPatchId}`);
+            console.log(result.skillPatchPath);
+        }
+        if (result.workerSummaryPath) {
+            console.log(`Refreshed worker summary: ${result.workerSummaryPath}`);
+        }
+        if (result.warnings.length > 0) {
+            console.log("");
+            console.log("Warnings:");
+            for (const warning of result.warnings) {
+                console.log(`- ${warning}`);
+            }
+        }
+        console.log("");
+        console.log("Next command:");
+        console.log(result.nextCommand);
+    });
+}
+//# sourceMappingURL=finish.js.map

package/dist/commands/finish.js.map

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

package/dist/commands/handoff.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerHandoffCommands(program: Command): void;

package/dist/commands/handoff.js

@@ -0,0 +1,77 @@
+import path from "node:path";
+import { generateHandoff, inspectSavedHandoff, listSavedHandoffs, showSavedHandoff } from "../core/handoff.js";
+import { normalizeExportPolicy } from "../core/exportPolicy.js";
+import { parsePositiveInt, printTable } from "./shared.js";
+export function registerHandoffCommands(program) {
+    const handoff = program
+        .command("handoff")
+        .description("Generate continuity handoff briefs for fresh AI coding threads.");
+    handoff
+        .command("generate")
+        .description("Compile project, worker, memory, and recent work into a handoff.")
+        .option("--project <project>", "Project name.")
+        .option("--worker <worker>", "Worker profile name.")
+        .option("--task <task>", "Optional next task.")
+        .option("--budget <tokens>", "Overall token budget.", parsePositiveInt, 2500)
+        .option("--export-policy <policy>", "local-private|shared-only", "local-private")
+        .option("--save", "Save to .briefops/handoffs.")
+        .option("--output <path>", "Write the handoff to a specific path.")
+        .option("--force", "Overwrite an existing explicit output file.")
+        .action(async (options) => {
+        const result = await generateHandoff({
+            project: options.project,
+            worker: options.worker,
+            task: options.task,
+            budget: options.budget,
+            exportPolicy: normalizeExportPolicy(options.exportPolicy),
+            save: Boolean(options.save) || Boolean(options.output),
+            outputPath: options.output
+                ? path.resolve(process.cwd(), options.output)
+                : undefined,
+            force: Boolean(options.force)
+        });
+        console.log(result.content);
+        if (result.savedPath) {
+            console.error(`Saved handoff: ${result.savedPath}`);
+        }
+        console.error(`Estimated tokens: ${result.tokens}`);
+    });
+    handoff
+        .command("list")
+        .description("List saved handoffs.")
+        .action(async () => {
+        const handoffs = await listSavedHandoffs(process.cwd());
+        if (handoffs.length === 0) {
+            console.log("No saved handoffs found.");
+            return;
+        }
+        printTable([
+            ["ID", "Tokens", "Path"],
+            ...handoffs.map((item) => [item.id, String(item.tokens), item.path])
+        ]);
+    });
+    handoff
+        .command("show <id>")
+        .description("Show a saved handoff by id or latest.")
+        .action(async (id) => {
+        console.log(await showSavedHandoff(process.cwd(), id));
+    });
+    handoff
+        .command("inspect <id>")
+        .description("Inspect a saved handoff by id or latest.")
+        .action(async (id) => {
+        const result = await inspectSavedHandoff(process.cwd(), id);
+        printTable([
+            ["Field", "Value"],
+            ["ID", result.metadata.id],
+            ["Path", result.path],
+            ["Project", result.metadata.project ?? ""],
+            ["Worker", result.metadata.worker ?? ""],
+            ["Characters", String(result.characters)],
+            ["Estimated Tokens", String(result.metadata.total_tokens)],
+            ["Budget", String(result.metadata.budget)],
+            ["Warnings", result.metadata.warnings.join("; ")]
+        ]);
+    });
+}
+//# sourceMappingURL=handoff.js.map

package/dist/commands/handoff.js.map

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

package/dist/commands/inbox.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerInboxCommand(program: Command): void;

package/dist/commands/inbox.js

@@ -0,0 +1,36 @@
+import { getInboxSummary } from "../core/inbox.js";
+export function registerInboxCommand(program) {
+    program
+        .command("inbox")
+        .description("Summarize the local BriefOps operational queue.")
+        .option("--project <project>", "Filter by project.")
+        .option("--worker <worker>", "Filter by worker.")
+        .option("--skill <skill>", "Filter by skill.")
+        .action(async (options) => {
+        const summary = await getInboxSummary({
+            project: options.project,
+            worker: options.worker,
+            skill: options.skill
+        });
+        console.log("BriefOps Inbox");
+        console.log("");
+        console.log("Pending:");
+        console.log(`- memory proposals: ${summary.pendingMemoryProposals}`);
+        console.log(`- skill patches: ${summary.pendingSkillPatches}`);
+        console.log("");
+        console.log("Open Risks:");
+        console.log(`- ${summary.openRisks} unresolved risk item(s) found in recent logs`);
+        if (summary.staleMemory > 0 || summary.deprecatedMemory > 0) {
+            console.log("");
+            console.log("Memory Maintenance:");
+            console.log(`- stale memory: ${summary.staleMemory}`);
+            console.log(`- deprecated memory: ${summary.deprecatedMemory}`);
+        }
+        console.log("");
+        console.log("Recommended:");
+        for (const command of summary.recommendedCommands) {
+            console.log(`- ${command}`);
+        }
+    });
+}
+//# sourceMappingURL=inbox.js.map

package/dist/commands/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../../src/commands/inbox.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,iDAAiD,CAAC;SAC9D,MAAM,CAAC,qBAAqB,EAAE,oBAAoB,CAAC;SACnD,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;SAChD,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,EAAE;QACjD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;YACpC,OAAO,EAAE,OAAO,CAAC,OAA6B;YAC9C,MAAM,EAAE,OAAO,CAAC,MAA4B;YAC5C,KAAK,EAAE,OAAO,CAAC,KAA2B;SAC3C,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,SAAS,+CAA+C,CAAC,CAAC;QACnF,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,wBAAwB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerInitCommand(program: Command): void;

package/dist/commands/init.js

@@ -0,0 +1,13 @@
+import { initWorkspace } from "../core/workspace.js";
+export function registerInitCommand(program) {
+    program
+        .command("init")
+        .description("Create a local .briefops workspace.")
+        .action(async () => {
+        const result = await initWorkspace(process.cwd());
+        console.log(`BriefOps workspace ready: ${result.root}`);
+        console.log(`Created: ${result.created.length}`);
+        console.log(`Existing: ${result.existing.length}`);
+    });
+}
+//# 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":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,6BAA6B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/inspect.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerInspectCommands(program: Command): void;