briefops 1.0.0

package/dist/core/exportTargets.d.ts

@@ -0,0 +1,25 @@
+import { type ExportPolicy } from "./exportPolicy.js";
+export type ExportTarget = "agents-md" | "claude-md" | "cursor-rules";
+export type ExportMode = "router";
+export type HarnessExportOptions = {
+    cwd?: string;
+    target: ExportTarget;
+    worker?: string;
+    project?: string;
+    exportPolicy?: ExportPolicy;
+    outputPath?: string;
+    force?: boolean;
+    dryRun?: boolean;
+    stdout?: boolean;
+};
+export type HarnessExportFile = {
+    path: string;
+    content: string;
+    tokens: number;
+    written: boolean;
+};
+export type HarnessExportResult = {
+    files: HarnessExportFile[];
+    warnings: string[];
+};
+export declare function renderHarnessExport(options: HarnessExportOptions): HarnessExportResult;

package/dist/core/exportTargets.js

@@ -0,0 +1,292 @@
+import path from "node:path";
+import { defaultContextBudgets, formatBudgetLine } from "./contextBudget.js";
+import { BriefOpsError } from "./errors.js";
+import { normalizeExportPolicy, sharedOnlyOmissionNote } from "./exportPolicy.js";
+import { estimateTokens } from "./tokens.js";
+function shellValue(value) {
+    return `"${value.replace(/(["\\$`])/g, "\\$1")}"`;
+}
+function workerFlag(worker) {
+    return worker ? ` --worker ${worker}` : " --worker <worker>";
+}
+function projectLine(project) {
+    return project ? ["", `Project: \`${project}\``] : [];
+}
+function policyLines(exportPolicy) {
+    return [
+        "",
+        `Export policy: \`${exportPolicy}\``,
+        exportPolicy === "shared-only"
+            ? "These instructions are safe to commit because they route agents to BriefOps instead of copying private local memory."
+            : "Local-private export was selected; keep this file local unless you review it before sharing."
+    ];
+}
+function renderAgentsMd(options) {
+    const worker = options.worker ?? "<worker>";
+    return [
+        "# BriefOps Agent Instructions",
+        "",
+        "This repository uses BriefOps for local AI coding continuity.",
+        ...projectLine(options.project),
+        ...policyLines(options.exportPolicy),
+        "",
+        "## Start Of Work",
+        "",
+        "Before broad repo/history inspection, run:",
+        "",
+        "```bash",
+        `briefops prime --format codex --task ${shellValue("<current task>")} --max-tokens 800`,
+        "```",
+        "",
+        "Use the output as a routing brief, not as a replacement for relevant code inspection.",
+        "",
+        "## Finish Of Work",
+        "",
+        "At the end of meaningful work, run:",
+        "",
+        "```bash",
+        `briefops finish --worker ${worker} --task ${shellValue("<completed task>")} --result ${shellValue("<result>")}`,
+        "```",
+        "",
+        "Add `--lesson`, `--decision`, `--open-risk`, or `--next-step` only when the item is durable and useful for future work.",
+        "",
+        "## Memory Approval",
+        "",
+        "Never apply memory automatically.",
+        "",
+        "Ask the user before running:",
+        "",
+        "```bash",
+        "briefops approve latest",
+        "```",
+        "",
+        "## Fresh Thread Resume",
+        "",
+        "When continuing in a fresh thread:",
+        "",
+        "```bash",
+        `briefops continue --worker ${worker} --task ${shellValue("<next task>")} --pack`,
+        "```",
+        "",
+        "## Boundaries",
+        "",
+        "- Do not dump the entire `.briefops/` directory.",
+        "- Do not auto-approve memory or skill patches.",
+        "- Do not treat BriefOps context as a substitute for code inspection.",
+        "- Prefer compact prime context before reading large history.",
+        ""
+    ].join("\n");
+}
+function renderClaudeMd(options) {
+    const worker = options.worker ?? "<worker>";
+    return [
+        "# Claude Code Instructions: BriefOps",
+        "",
+        "This project uses BriefOps for local work continuity.",
+        ...projectLine(options.project),
+        ...policyLines(options.exportPolicy),
+        "",
+        "## Before Starting Work",
+        "",
+        "Run:",
+        "",
+        "```bash",
+        `briefops prime --format markdown --task ${shellValue("<current task>")} --max-tokens 800`,
+        "```",
+        "",
+        "Use the result to understand the selected worker, relevant project context, approved memory, open risks, and pending review items.",
+        "",
+        "## During Work",
+        "",
+        "Inspect only files relevant to the current task.",
+        "",
+        "Do not read the entire `.briefops/` workspace unless explicitly asked.",
+        "",
+        "## After Meaningful Work",
+        "",
+        "Run:",
+        "",
+        "```bash",
+        `briefops finish --worker ${worker} --task ${shellValue("<task>")} --result ${shellValue("<result>")}`,
+        "```",
+        "",
+        "Use durable fields only when useful:",
+        "",
+        "```bash",
+        "--lesson",
+        "--decision",
+        "--open-risk",
+        "--next-step",
+        "```",
+        "",
+        "## Human Approval Required",
+        "",
+        "Never apply BriefOps memory or skill patches automatically.",
+        "",
+        "Ask before:",
+        "",
+        "```bash",
+        "briefops approve latest",
+        "```",
+        "",
+        "## Fresh Thread Resume",
+        "",
+        "For a fresh Claude/Codex thread:",
+        "",
+        "```bash",
+        `briefops continue --worker ${worker} --task ${shellValue("<next task>")} --pack`,
+        "```",
+        ""
+    ].join("\n");
+}
+function cursorRule(description, alwaysApply, body) {
+    return [
+        "---",
+        `description: ${description}`,
+        `alwaysApply: ${alwaysApply ? "true" : "false"}`,
+        "---",
+        "",
+        body.trim(),
+        ""
+    ].join("\n");
+}
+function renderCursorRules(options) {
+    const worker = options.worker ?? "<worker>";
+    const policyNote = options.exportPolicy === "shared-only" ? `\n\n${sharedOnlyOmissionNote}` : "";
+    return [
+        {
+            relativePath: ".cursor/rules/briefops-prime.mdc",
+            content: cursorRule("Use BriefOps to prime AI coding context before broad repo/history inspection.", true, [
+                "# BriefOps Prime",
+                "",
+                "This repository uses BriefOps for local AI coding continuity.",
+                policyNote.trim() ? policyNote.trimStart() : undefined,
+                "",
+                "Before broad repo/history inspection, run:",
+                "",
+                "```bash",
+                `briefops prime --format codex --task ${shellValue("<current task>")} --max-tokens 800`,
+                "```",
+                "",
+                "Use the result as a compact routing brief.",
+                "",
+                "Do not:",
+                "- dump the full `.briefops` workspace",
+                "- auto-approve memory or skill patches",
+                "- treat prime context as a replacement for relevant code inspection"
+            ].filter((line) => line !== undefined).join("\n"))
+        },
+        {
+            relativePath: ".cursor/rules/briefops-finish.mdc",
+            content: cursorRule("Use when finishing meaningful AI coding work and recording durable lessons, decisions, risks, or next steps.", false, [
+                "# BriefOps Finish",
+                "",
+                "At the end of meaningful work, run `briefops finish`.",
+                "",
+                `Default worker hint: \`${worker}\`.`,
+                "",
+                "Only record durable items that will help future work.",
+                "",
+                "Do not create memory that the user did not approve."
+            ].join("\n"))
+        },
+        {
+            relativePath: ".cursor/rules/briefops-memory-review.mdc",
+            content: cursorRule("Use when BriefOps reports pending memory proposals or skill patches that need human review.", false, [
+                "# BriefOps Memory Review",
+                "",
+                "Memory and skill patch changes are human-approved.",
+                "",
+                "Review first:",
+                "",
+                "```bash",
+                "briefops memory proposal-show latest",
+                "briefops inbox",
+                "```",
+                "",
+                "Apply only after explicit user confirmation:",
+                "",
+                "```bash",
+                "briefops approve latest",
+                "```"
+            ].join("\n"))
+        },
+        {
+            relativePath: ".cursor/rules/briefops-continue.mdc",
+            content: cursorRule("Use when continuing a BriefOps worker in a fresh thread.", false, [
+                "# BriefOps Continue",
+                "",
+                "When continuing prior work in a fresh thread, run:",
+                "",
+                "```bash",
+                `briefops continue --worker ${worker} --task ${shellValue("<next task>")} --pack`,
+                "```",
+                "",
+                "Use the generated pack as the continuity handoff.",
+                "",
+                "Do not treat it as permission to skip relevant code inspection."
+            ].join("\n"))
+        }
+    ];
+}
+function defaultRelativePath(target) {
+    if (target === "agents-md") {
+        return "AGENTS.md";
+    }
+    if (target === "claude-md") {
+        return "CLAUDE.md";
+    }
+    throw new BriefOpsError("--output is not supported for cursor-rules because it writes multiple files.");
+}
+function hardWarningBudget(target, tokens) {
+    if (target === "agents-md") {
+        return 800;
+    }
+    if (target === "claude-md") {
+        return 1000;
+    }
+    return defaultContextBudgets.exportCursorTotal;
+}
+export function renderHarnessExport(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const exportPolicy = normalizeExportPolicy(options.exportPolicy ?? "shared-only");
+    const renderOptions = {
+        worker: options.worker,
+        project: options.project,
+        exportPolicy
+    };
+    const rendered = options.target === "agents-md"
+        ? [{ relativePath: options.outputPath ?? defaultRelativePath(options.target), content: renderAgentsMd(renderOptions) }]
+        : options.target === "claude-md"
+            ? [{ relativePath: options.outputPath ?? defaultRelativePath(options.target), content: renderClaudeMd(renderOptions) }]
+            : renderCursorRules(renderOptions);
+    const files = rendered.map((file) => {
+        const resolvedPath = path.isAbsolute(file.relativePath)
+            ? file.relativePath
+            : path.join(cwd, file.relativePath);
+        return {
+            path: resolvedPath,
+            content: file.content,
+            tokens: estimateTokens(file.content),
+            written: false
+        };
+    });
+    const warnings = [];
+    for (const file of files) {
+        const perFileBudget = options.target === "agents-md"
+            ? defaultContextBudgets.exportAgentsMd
+            : options.target === "claude-md"
+                ? defaultContextBudgets.exportClaudeMd
+                : defaultContextBudgets.exportCursorRule;
+        if (file.tokens > perFileBudget) {
+            warnings.push(formatBudgetLine(path.basename(file.path), file.tokens, perFileBudget));
+        }
+    }
+    const total = files.reduce((sum, file) => sum + file.tokens, 0);
+    const hardBudget = hardWarningBudget(options.target, total);
+    if (total > hardBudget) {
+        warnings.push(formatBudgetLine("export total", total, hardBudget));
+    }
+    return { files, warnings };
+}
+//# sourceMappingURL=exportTargets.js.map

package/dist/core/exportTargets.js.map

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

package/dist/core/handoff.d.ts

@@ -0,0 +1,48 @@
+import { type ExportPolicy } from "./exportPolicy.js";
+import { type HandoffMetadata } from "../schemas/handoff.js";
+import type { TokenReportLine } from "../schemas/brief.js";
+export type GenerateHandoffOptions = {
+    cwd?: string;
+    project?: string;
+    worker?: string;
+    task?: string;
+    budget?: number;
+    fromHandoff?: string;
+    mode?: string;
+    completionPromise?: string;
+    exportPolicy?: ExportPolicy;
+    save?: boolean;
+    outputPath?: string;
+    force?: boolean;
+};
+export type HandoffResult = {
+    id: string;
+    content: string;
+    tokens: number;
+    budget: number;
+    warnings: string[];
+    report: TokenReportLine[];
+    savedPath?: string;
+};
+export declare function generateHandoff(options: GenerateHandoffOptions): Promise<HandoffResult>;
+export declare function saveGeneratedHandoff(options: {
+    cwd: string;
+    id: string;
+    project?: string;
+    worker?: string;
+    content: string;
+    outputPath?: string;
+    force?: boolean;
+}): Promise<string>;
+export declare function listSavedHandoffs(cwd?: string): Promise<Array<{
+    id: string;
+    path: string;
+    tokens: number;
+}>>;
+export declare function showSavedHandoff(cwd: string, idOrLatest: string): Promise<string>;
+export declare function inspectSavedHandoff(cwd: string, idOrLatest: string): Promise<{
+    metadata: HandoffMetadata;
+    path: string;
+    characters: number;
+}>;
+export declare function generateCodexResumeFromHandoff(options: GenerateHandoffOptions): Promise<HandoffResult>;