briefops 1.0.0

package/dist/core/codex.js

@@ -0,0 +1,286 @@
+import path from "node:path";
+import { generateBrief } from "./brief.js";
+import { generateCodexResumeFromHandoff } from "./handoff.js";
+import { BriefOpsError } from "./errors.js";
+import { withWorkspaceLock } from "./lock.js";
+import { writeGeneratedOutput } from "./output.js";
+import { readProject } from "./project.js";
+import { readWorker } from "./worker.js";
+import { formatDateStamp, normalizeName, slugForFilename, workspacePaths } from "./paths.js";
+import { ensureDirectory, pathExists, readTextFile, writeTextFile } from "./storage.js";
+import { estimateTokens } from "./tokens.js";
+import { requireWorkspace } from "./workspace.js";
+const AGENTS_BEGIN = "<!-- BRIEFOPS_CODEX_BEGIN -->";
+const AGENTS_END = "<!-- BRIEFOPS_CODEX_END -->";
+function normalizeCodexMode(value) {
+    const mode = (value ?? "loop").trim().toLowerCase();
+    if (mode === "loop" || mode === "execute" || mode === "plan") {
+        return mode;
+    }
+    throw new BriefOpsError(`Invalid Codex mode: ${value}`);
+}
+function codexGuidanceSection() {
+    return [
+        AGENTS_BEGIN,
+        "## BriefOps Codex Guidance",
+        "",
+        "This repository can use BriefOps to prepare token-aware Codex task briefs.",
+        "",
+        "Useful commands:",
+        "",
+        "```bash",
+        "briefops brief generate --worker <worker> --task \"<task>\" --adapter codex",
+        "briefops codex mission --worker <worker> --task \"<task>\" --save",
+        "briefops codex plan --project <project> --idea \"<what to build>\" --save",
+        "briefops log add --task \"<task>\" --result \"<result>\" --lesson \"<lesson>\"",
+        "briefops skill propose-patch --skill <skill> --from-log latest",
+        "```",
+        "",
+        "When using a BriefOps mission, follow its evidence gates before claiming completion.",
+        AGENTS_END,
+        ""
+    ].join("\n");
+}
+async function upsertAgentsGuidance(cwd, force = false) {
+    const agentsPath = path.join(cwd, "AGENTS.md");
+    const section = codexGuidanceSection();
+    if (!(await pathExists(agentsPath))) {
+        await writeTextFile(agentsPath, `# AGENTS.md\n\n${section}`);
+        return agentsPath;
+    }
+    const existing = await readTextFile(agentsPath);
+    const start = existing.indexOf(AGENTS_BEGIN);
+    const end = existing.indexOf(AGENTS_END);
+    if (start !== -1 && end !== -1 && end > start) {
+        const updated = `${existing.slice(0, start)}${section}${existing.slice(end + AGENTS_END.length).trimStart()}`;
+        await writeTextFile(agentsPath, updated, { force: true });
+        return agentsPath;
+    }
+    if (!force) {
+        throw new BriefOpsError("AGENTS.md already exists. Re-run with --force to append BriefOps Codex guidance.");
+    }
+    await writeTextFile(agentsPath, `${existing.trimEnd()}\n\n${section}`, { force: true });
+    return agentsPath;
+}
+export async function installCodexPack(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const paths = workspacePaths(cwd);
+    await ensureDirectory(paths.codexPrompts);
+    await writeTextFile(path.join(paths.codexPrompts, "mission.md"), [
+        "# BriefOps Codex Mission Prompt",
+        "",
+        "Generate a Codex mission with:",
+        "",
+        "```bash",
+        "briefops codex mission --worker <worker> --task \"<task>\" --save",
+        "```",
+        ""
+    ].join("\n"), { force: true });
+    await writeTextFile(path.join(paths.codexPrompts, "plan.md"), [
+        "# BriefOps Codex Plan Prompt",
+        "",
+        "Generate a Codex planning prompt with:",
+        "",
+        "```bash",
+        "briefops codex plan --project <project> --idea \"<what to build>\" --save",
+        "```",
+        ""
+    ].join("\n"), { force: true });
+    return {
+        agentsPath: await upsertAgentsGuidance(cwd, options.force),
+        promptDir: paths.codexPrompts
+    };
+}
+function renderMissionShell(options) {
+    const modeLine = options.mode === "loop"
+        ? "Work in a bounded loop: inspect, plan, act, verify, and continue if verification fails."
+        : options.mode === "execute"
+            ? "Execute the task directly, keeping a concise plan and verification evidence attached."
+            : "Produce a plan first. Do not modify product code unless the user explicitly approves the plan.";
+    return [
+        "# BriefOps Codex Mission",
+        "",
+        "## Mission",
+        "",
+        options.task,
+        "",
+        "## Completion Promise",
+        "",
+        options.completionPromise,
+        "",
+        "Only claim completion after the evidence gates below are satisfied.",
+        "",
+        "## Codex Operating Contract",
+        "",
+        modeLine,
+        "",
+        "1. Restate the objective in one short paragraph.",
+        "2. Inspect the relevant files before editing.",
+        "3. Keep changes scoped to the mission.",
+        "4. Run the strongest available verification for the changed surface.",
+        "5. If verification fails, diagnose and continue instead of ending with a hopeful status.",
+        "6. Finish with evidence: files changed, commands run, results, and remaining risk.",
+        "",
+        "## Evidence Gates",
+        "",
+        "- Context gate: name the files or docs inspected.",
+        "- Change gate: summarize the smallest useful change set.",
+        "- Verification gate: include command output or manual QA evidence.",
+        "- Risk gate: call out anything unverified or intentionally deferred.",
+        "",
+        "## Completion Signal",
+        "",
+        "When all gates pass, end with:",
+        "",
+        "```text",
+        "<briefops-complete>DONE</briefops-complete>",
+        "```",
+        "",
+        "## BriefOps Brief",
+        "",
+        options.brief.trim(),
+        ""
+    ].join("\n");
+}
+async function saveCodexPrompt(options) {
+    return withWorkspaceLock({ cwd: options.cwd, name: "codex-prompt" }, async () => {
+        return writeGeneratedOutput({
+            defaultPath: path.join(workspacePaths(options.cwd).codexPrompts, `${formatDateStamp()}-${options.kind}-${slugForFilename(options.name)}.md`),
+            outputPath: options.outputPath,
+            content: options.content,
+            force: options.force
+        });
+    });
+}
+export async function generateCodexMission(options) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const mode = normalizeCodexMode(options.mode);
+    const generated = await generateBrief({
+        cwd,
+        skill: options.skill,
+        project: options.project,
+        worker: options.worker,
+        task: options.task,
+        budget: options.budget ?? 2500,
+        adapter: "codex"
+    });
+    const content = renderMissionShell({
+        mode,
+        task: options.task.trim(),
+        completionPromise: options.completionPromise ??
+            "Deliver the requested change with verification evidence and no unresolved blocking risk.",
+        brief: generated.content
+    });
+    const savedPath = options.save
+        ? await saveCodexPrompt({
+            cwd,
+            kind: "mission",
+            name: options.worker ?? options.skill ?? "codex",
+            content,
+            outputPath: options.outputPath,
+            force: options.force
+        })
+        : undefined;
+    return {
+        content,
+        tokens: estimateTokens(content),
+        savedPath
+    };
+}
+export async function generateCodexPlan(options) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const projectName = options.project ? normalizeName(options.project) : undefined;
+    const workerName = options.worker ? normalizeName(options.worker) : undefined;
+    const project = projectName ? await readProject(cwd, projectName) : undefined;
+    const worker = workerName ? await readWorker(cwd, workerName) : undefined;
+    const content = [
+        "# BriefOps Codex Plan Prompt",
+        "",
+        "## Planning Mission",
+        "",
+        options.idea.trim(),
+        "",
+        "## Codex Planning Contract",
+        "",
+        "You are planning only. Do not edit product code in this response.",
+        "",
+        "Produce a decision-complete plan that another Codex run can execute without re-asking foundational questions.",
+        "",
+        "Return:",
+        "",
+        "1. Objective",
+        "2. Assumptions and open questions",
+        "3. Codebase areas to inspect",
+        "4. Implementation checklist",
+        "5. Verification checklist",
+        "6. Risks and rollback notes",
+        "",
+        worker
+            ? [
+                "## Worker Profile",
+                "",
+                `Name: ${worker.name}`,
+                worker.description ? `Description: ${worker.description}` : undefined,
+                worker.default_skills.length > 0
+                    ? `Default skills: ${worker.default_skills.join(", ")}`
+                    : undefined,
+                worker.style.length > 0 ? `Style: ${worker.style.join("; ")}` : undefined,
+                ""
+            ]
+                .filter((line) => Boolean(line))
+                .join("\n")
+            : "",
+        project
+            ? [
+                "## Project Context",
+                "",
+                project.body,
+                ""
+            ].join("\n")
+            : "## Project Context\n\nNo project context selected.\n",
+        "## Completion Signal",
+        "",
+        "End with a concise `PLAN READY` line and the recommended BriefOps command for execution.",
+        ""
+    ].join("\n");
+    const savedPath = options.save
+        ? await saveCodexPrompt({
+            cwd,
+            kind: "plan",
+            name: workerName ?? projectName ?? "codex",
+            content,
+            outputPath: options.outputPath,
+            force: options.force
+        })
+        : undefined;
+    return {
+        content,
+        tokens: estimateTokens(content),
+        savedPath
+    };
+}
+export async function generateCodexResume(options) {
+    const result = await generateCodexResumeFromHandoff({
+        cwd: options.cwd,
+        worker: options.worker,
+        project: options.project,
+        task: options.task,
+        fromHandoff: options.fromHandoff,
+        budget: options.budget ?? 3000,
+        mode: options.mode,
+        completionPromise: options.completionPromise,
+        exportPolicy: options.exportPolicy,
+        save: options.save,
+        outputPath: options.outputPath,
+        force: options.force
+    });
+    return {
+        content: result.content,
+        tokens: result.tokens,
+        savedPath: result.savedPath
+    };
+}
+//# sourceMappingURL=codex.js.map

package/dist/core/codex.js.map

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

package/dist/core/codexPlugin.d.ts

@@ -0,0 +1,51 @@
+export type CodexPluginManifest = {
+    name: string;
+    version: string;
+    description: string;
+    author: {
+        name: string;
+        url: string;
+    };
+    homepage: string;
+    repository: string;
+    license: string;
+    keywords: string[];
+    skills: string;
+    interface: {
+        displayName: string;
+        shortDescription: string;
+        longDescription: string;
+        developerName: string;
+        category: string;
+        capabilities: string[];
+        defaultPrompt: string[];
+        websiteURL: string;
+        brandColor: string;
+        screenshots: string[];
+    };
+};
+export type CodexPluginFile = {
+    relativePath: string;
+    content: string;
+};
+export type CodexPluginFileStatus = "ok" | "missing" | "changed";
+export type CodexPluginInspection = {
+    root: string;
+    ok: boolean;
+    files: Array<{
+        relativePath: string;
+        status: CodexPluginFileStatus;
+    }>;
+};
+export declare function buildCodexPluginManifest(): CodexPluginManifest;
+export declare function codexPluginFiles(): CodexPluginFile[];
+export declare function installCodexPlugin(options?: {
+    cwd?: string;
+    force?: boolean;
+}): Promise<{
+    root: string;
+    files: string[];
+}>;
+export declare function inspectCodexPlugin(options?: {
+    cwd?: string;
+}): Promise<CodexPluginInspection>;

package/dist/core/codexPlugin.js

@@ -0,0 +1,228 @@
+import path from "node:path";
+import { briefopsVersion } from "../version.js";
+import { BriefOpsError } from "./errors.js";
+import { workspacePaths } from "./paths.js";
+import { pathExists, readTextFile, writeTextFile } from "./storage.js";
+import { requireWorkspace } from "./workspace.js";
+export function buildCodexPluginManifest() {
+    return {
+        name: "briefops",
+        version: briefopsVersion,
+        description: "Local-first, token-aware persistent work history for Codex workflows.",
+        author: {
+            name: "BriefOps contributors",
+            url: "https://github.com/simony-816/briefops"
+        },
+        homepage: "https://github.com/simony-816/briefops",
+        repository: "https://github.com/simony-816/briefops",
+        license: "MIT",
+        keywords: ["codex", "local-first", "context", "memory", "handoff", "workflow"],
+        skills: "./skills/",
+        interface: {
+            displayName: "BriefOps",
+            shortDescription: "local-first context priming and continuity for Codex",
+            longDescription: "Use BriefOps to prime Codex with compact local context, record task outcomes, review durable memory proposals, and resume persistent workers without hosted services.",
+            developerName: "BriefOps contributors",
+            category: "Developer Tools",
+            capabilities: ["Read", "Write"],
+            defaultPrompt: [
+                "Start this task with the smallest useful BriefOps context.",
+                "Finish this task and prepare memory for the next thread."
+            ],
+            websiteURL: "https://github.com/simony-816/briefops",
+            brandColor: "#2563EB",
+            screenshots: []
+        }
+    };
+}
+function pluginManifestContent() {
+    return `${JSON.stringify(buildCodexPluginManifest(), null, 2)}\n`;
+}
+function trustBoundaryLines() {
+    return [
+        "The BriefOps plugin is a local CLI helper. It does not require network access, does not publish to a marketplace, and should not auto-approve memory or skill patches.",
+        "",
+        "Use `--export-policy shared-only` before copying context outside the local workspace.",
+        ""
+    ];
+}
+function briefopsPrimeContextSkill() {
+    return [
+        "---",
+        "name: briefops-prime-context",
+        "description: Use when starting work in any Codex project or fresh thread to load the smallest useful BriefOps context before reading large history files",
+        "---",
+        "",
+        "# BriefOps Prime Context",
+        "",
+        ...trustBoundaryLines(),
+        "Use BriefOps before broad repo/history inspection when a `.briefops` workspace exists or may exist.",
+        "",
+        "Run:",
+        "",
+        "```bash",
+        "briefops prime --format codex --task \"<current user task>\" --max-tokens 800",
+        "```",
+        "",
+        "If the command reports that no workspace exists, keep the response short and suggest `briefops init`.",
+        "",
+        "Never apply memory automatically. If pending proposals exist, show the review command.",
+        "",
+        "Treat the prime output as a compact routing brief, not as permission to skip relevant code inspection.",
+        ""
+    ].join("\n");
+}
+function briefopsFinishTaskSkill() {
+    return [
+        "---",
+        "name: briefops-finish-task",
+        "description: Use when finishing a Codex task to record the outcome, propose durable memory, and prepare the next thread without auto-approving memory",
+        "---",
+        "",
+        "# BriefOps Finish Task",
+        "",
+        ...trustBoundaryLines(),
+        "Use BriefOps at the end of meaningful work so future Codex threads do not spend tokens rediscovering the same decisions, risks, and lessons.",
+        "",
+        "Run a scoped finish command with the actual result and any durable candidates:",
+        "",
+        "```bash",
+        "briefops finish --worker <worker> --task \"<task>\" --result \"<result>\" --lesson \"<lesson>\" --next-step \"<next step>\"",
+        "```",
+        "",
+        "Only include lessons, decisions, incidents, open risks, and next steps that will help future work. Do not store secrets or personal data.",
+        "",
+        "If a memory proposal is created, ask the user to review it. Never run `briefops approve` without explicit user confirmation.",
+        ""
+    ].join("\n");
+}
+function briefopsReviewMemorySkill() {
+    return [
+        "---",
+        "name: briefops-review-memory",
+        "description: Use when BriefOps reports pending memory proposals or skill patches that need human review before becoming durable local memory",
+        "---",
+        "",
+        "# BriefOps Review Memory",
+        "",
+        ...trustBoundaryLines(),
+        "BriefOps memory is human-approved. Pending proposals are local drafts until the user accepts or rejects them.",
+        "",
+        "Inspect proposals before applying:",
+        "",
+        "```bash",
+        "briefops memory proposal-show latest",
+        "briefops inbox",
+        "```",
+        "",
+        "Apply only after explicit user confirmation:",
+        "",
+        "```bash",
+        "briefops approve latest",
+        "```",
+        "",
+        "Reject inaccurate, duplicate, sensitive, or overly broad proposals instead of carrying noisy context into future threads.",
+        ""
+    ].join("\n");
+}
+function briefopsContinueWorkerSkill() {
+    return [
+        "---",
+        "name: briefops-continue-worker",
+        "description: Use when continuing a persistent BriefOps worker in a fresh Codex thread with a handoff, resume prompt, or portable pack",
+        "---",
+        "",
+        "# BriefOps Continue Worker",
+        "",
+        ...trustBoundaryLines(),
+        "Use this workflow when the user wants a fresh Codex thread to continue prior work with the same worker identity, project constraints, memory, and risks.",
+        "",
+        "Prepare a resume prompt and optional portable pack:",
+        "",
+        "```bash",
+        "briefops continue --worker <worker> --task \"<next task>\" --pack",
+        "```",
+        "",
+        "If BriefOps reports pending memory proposals, surface the review command before continuing. Do not apply memory automatically.",
+        "",
+        "Use portable packs only as explicit local user artifacts. They may include private local memory and should be reviewed before sharing.",
+        ""
+    ].join("\n");
+}
+export function codexPluginFiles() {
+    return [
+        {
+            relativePath: ".codex-plugin/plugin.json",
+            content: pluginManifestContent()
+        },
+        {
+            relativePath: "skills/briefops-prime-context/SKILL.md",
+            content: briefopsPrimeContextSkill()
+        },
+        {
+            relativePath: "skills/briefops-finish-task/SKILL.md",
+            content: briefopsFinishTaskSkill()
+        },
+        {
+            relativePath: "skills/briefops-review-memory/SKILL.md",
+            content: briefopsReviewMemorySkill()
+        },
+        {
+            relativePath: "skills/briefops-continue-worker/SKILL.md",
+            content: briefopsContinueWorkerSkill()
+        }
+    ];
+}
+async function writeGeneratedPluginFile(options) {
+    if (await pathExists(options.target)) {
+        const existing = await readTextFile(options.target);
+        if (existing === options.content) {
+            return;
+        }
+        if (!options.force) {
+            throw new BriefOpsError(`Generated plugin file has local changes: ${options.target}. Re-run with --force to overwrite.`);
+        }
+    }
+    await writeTextFile(options.target, options.content, { force: true });
+}
+export async function installCodexPlugin(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const root = path.join(workspacePaths(cwd).codex, "plugin", "briefops");
+    const files = [];
+    for (const file of codexPluginFiles()) {
+        const target = path.join(root, file.relativePath);
+        await writeGeneratedPluginFile({
+            target,
+            content: file.content,
+            force: Boolean(options.force)
+        });
+        files.push(file.relativePath);
+    }
+    return { root, files };
+}
+export async function inspectCodexPlugin(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const root = path.join(workspacePaths(cwd).codex, "plugin", "briefops");
+    const files = await Promise.all(codexPluginFiles().map(async (file) => {
+        const target = path.join(root, file.relativePath);
+        if (!(await pathExists(target))) {
+            return {
+                relativePath: file.relativePath,
+                status: "missing"
+            };
+        }
+        const status = (await readTextFile(target)) === file.content ? "ok" : "changed";
+        return {
+            relativePath: file.relativePath,
+            status
+        };
+    }));
+    return {
+        root,
+        ok: files.every((file) => file.status === "ok"),
+        files
+    };
+}
+//# sourceMappingURL=codexPlugin.js.map

package/dist/core/codexPlugin.js.map

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

package/dist/core/compatibility.d.ts

@@ -0,0 +1,2 @@
+export declare const workspaceSchemaVersion = "1.0.0";
+export declare function assertCompatibleWorkspaceVersion(version: string): void;

package/dist/core/compatibility.js

@@ -0,0 +1,16 @@
+import { BriefOpsError } from "./errors.js";
+export const workspaceSchemaVersion = "1.0.0";
+function parseMajorVersion(version) {
+    const match = version.trim().match(/^(\d+)(?:\.|$)/);
+    return match ? Number(match[1]) : undefined;
+}
+export function assertCompatibleWorkspaceVersion(version) {
+    const major = parseMajorVersion(version);
+    if (major === undefined) {
+        throw new BriefOpsError(`Invalid BriefOps workspace version: ${version}`);
+    }
+    if (major > 1) {
+        throw new BriefOpsError(`Unsupported BriefOps workspace version: ${version}. Upgrade BriefOps before using this workspace.`);
+    }
+}
+//# sourceMappingURL=compatibility.js.map

package/dist/core/compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../../src/core/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C,SAAS,iBAAiB,CAAC,OAAe;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,OAAe;IAC9D,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,aAAa,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,aAAa,CACrB,2CAA2C,OAAO,iDAAiD,CACpG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,19 @@
+export type BriefOpsConfig = {
+    version: string;
+    created_at?: string;
+    defaults: {
+        project?: string;
+        worker?: string;
+    };
+    token_budgets: {
+        prime: number;
+        resume: number;
+    };
+    memory_categories: string[];
+};
+export declare function readBriefOpsConfig(cwd?: string): Promise<BriefOpsConfig>;
+export declare function writeBriefOpsConfig(cwd: string, config: BriefOpsConfig): Promise<BriefOpsConfig>;
+export declare function setDefaultWorker(options: {
+    cwd?: string;
+    worker: string;
+}): Promise<BriefOpsConfig>;