briefops 1.0.0

package/dist/core/adapter.js

@@ -0,0 +1,167 @@
+import path from "node:path";
+import { BriefOpsError } from "./errors.js";
+import { workspacePaths } from "./paths.js";
+import { pathExists, readTextFile } from "./storage.js";
+export const briefAdapters = ["generic", "codex", "claude-code"];
+const fallbackTemplates = {
+    generic: [
+        "# BriefOps Task Brief",
+        "",
+        "{{warnings}}",
+        "## Role",
+        "",
+        "You are operating as an AI coding agent prepared by BriefOps.",
+        "",
+        "{{workerSection}}",
+        "## Primary Skill",
+        "",
+        "{{skillText}}",
+        "",
+        "## Project Context",
+        "",
+        "{{projectText}}",
+        "",
+        "## Relevant Memory",
+        "",
+        "{{memoryText}}",
+        "",
+        "## Task",
+        "",
+        "{{taskText}}",
+        "",
+        "## Delivery Format",
+        "",
+        "{{outputContract}}",
+        "",
+        "## Read If Needed",
+        "",
+        "{{readIfNeeded}}",
+        "",
+        "## Token Budget Report",
+        "",
+        "{{tokenReport}}",
+        ""
+    ].join("\n"),
+    codex: [
+        "# BriefOps Task Brief",
+        "",
+        "{{warnings}}",
+        "## Role",
+        "",
+        "You are Codex operating with a BriefOps-prepared task brief. Follow the repository's existing patterns and verify your work before completion.",
+        "",
+        "{{workerSection}}",
+        "## Primary Skill",
+        "",
+        "{{skillText}}",
+        "",
+        "## Project Context",
+        "",
+        "{{projectText}}",
+        "",
+        "## Relevant Memory",
+        "",
+        "{{memoryText}}",
+        "",
+        "## Task",
+        "",
+        "{{taskText}}",
+        "",
+        "## Delivery Format",
+        "",
+        "{{outputContract}}",
+        "",
+        "## Read If Needed",
+        "",
+        "{{readIfNeeded}}",
+        "",
+        "## Token Budget Report",
+        "",
+        "{{tokenReport}}",
+        ""
+    ].join("\n"),
+    "claude-code": [
+        "# BriefOps Task Brief",
+        "",
+        "{{warnings}}",
+        "## Role",
+        "",
+        "You are Claude Code operating with a BriefOps-prepared task brief. Keep changes scoped, explain verification, and preserve user work.",
+        "",
+        "{{workerSection}}",
+        "## Primary Skill",
+        "",
+        "{{skillText}}",
+        "",
+        "## Project Context",
+        "",
+        "{{projectText}}",
+        "",
+        "## Relevant Memory",
+        "",
+        "{{memoryText}}",
+        "",
+        "## Task",
+        "",
+        "{{taskText}}",
+        "",
+        "## Delivery Format",
+        "",
+        "{{outputContract}}",
+        "",
+        "## Read If Needed",
+        "",
+        "{{readIfNeeded}}",
+        "",
+        "## Token Budget Report",
+        "",
+        "{{tokenReport}}",
+        ""
+    ].join("\n")
+};
+export function normalizeBriefAdapter(value) {
+    const adapter = (value ?? "generic").trim().toLowerCase();
+    if (briefAdapters.includes(adapter)) {
+        return adapter;
+    }
+    throw new BriefOpsError(`Invalid brief adapter: ${value}`);
+}
+function formatTokenReport(report, total, budget) {
+    return [
+        ...report.map((line) => `- ${line.label}: ${line.used} / ${line.budget}`),
+        `- Total: ${total} / ${budget}`
+    ].join("\n");
+}
+async function readTemplate(cwd, adapter) {
+    const templatePath = path.join(workspacePaths(cwd).templates, `brief.${adapter}.md`);
+    if (await pathExists(templatePath)) {
+        return readTextFile(templatePath);
+    }
+    return fallbackTemplates[adapter];
+}
+export async function renderBriefWithAdapter(options) {
+    const template = await readTemplate(options.cwd, options.adapter);
+    const workerSection = options.parts.workerText
+        ? `## Worker Profile\n\n${options.parts.workerText}\n`
+        : "";
+    const warnings = options.parts.warnings.length > 0
+        ? `${options.parts.warnings.map((warning) => `> Warning: ${warning}`).join("\n")}\n`
+        : "";
+    const replacements = {
+        warnings,
+        workerSection,
+        skillText: options.parts.skillText,
+        projectText: options.parts.projectText,
+        memoryText: options.parts.memoryText,
+        taskText: options.parts.taskText,
+        outputContract: options.parts.outputContract,
+        readIfNeeded: options.parts.readIfNeeded,
+        tokenReport: formatTokenReport(options.parts.report, options.parts.totalTokens, options.parts.budget)
+    };
+    let rendered = template;
+    for (const [name, value] of Object.entries(replacements)) {
+        rendered = rendered.replaceAll(`{{${name}}}`, value);
+    }
+    return `${rendered.replace(/\n{3,}/g, "\n\n").trimEnd()}\n`;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/core/adapter.js.map

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

package/dist/core/approval.d.ts

@@ -0,0 +1,26 @@
+import type { MemoryProposal } from "../schemas/memoryProposal.js";
+import type { SkillPatch } from "../schemas/patch.js";
+export type ApproveMemoryResult = {
+    kind: "memory";
+    proposal: MemoryProposal;
+    created: number;
+    skipped: number;
+};
+export type ApproveSkillPatchResult = {
+    kind: "skill-patch";
+    patch: SkillPatch;
+    skillPath: string;
+};
+export type ApproveResult = ApproveMemoryResult | ApproveSkillPatchResult;
+export declare function approveMemory(options: {
+    cwd?: string;
+    id: string;
+}): Promise<ApproveMemoryResult>;
+export declare function approveSkillPatch(options: {
+    cwd?: string;
+    id: string;
+}): Promise<ApproveSkillPatchResult>;
+export declare function approveAny(options: {
+    cwd?: string;
+    id: string;
+}): Promise<ApproveResult>;

package/dist/core/approval.js

@@ -0,0 +1,86 @@
+import { BriefOpsError } from "./errors.js";
+import { applyMemoryProposal, readLatestProposedMemoryProposal, readMemoryProposal } from "./memoryProposal.js";
+import { applySkillPatch, readLatestProposedSkillPatch, readSkillPatch } from "./patch.js";
+function isMemoryProposalNotFound(error) {
+    return error instanceof BriefOpsError && error.message.startsWith("Memory proposal not found:");
+}
+function isSkillPatchNotFound(error) {
+    return error instanceof BriefOpsError && error.message.startsWith("Skill patch not found:");
+}
+function isNoProposedMemoryProposal(error) {
+    return error instanceof BriefOpsError && error.message === "No proposed memory proposals found.";
+}
+function isNoProposedSkillPatch(error) {
+    return error instanceof BriefOpsError && error.message === "No proposed skill patches found.";
+}
+export async function approveMemory(options) {
+    const result = await applyMemoryProposal({
+        cwd: options.cwd,
+        id: options.id
+    });
+    return {
+        kind: "memory",
+        proposal: result.proposal,
+        created: result.created,
+        skipped: result.skipped
+    };
+}
+export async function approveSkillPatch(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const patch = options.id.trim().toLowerCase() === "latest"
+        ? await readLatestProposedSkillPatch(cwd)
+        : await readSkillPatch(cwd, options.id);
+    const result = await applySkillPatch({
+        cwd,
+        skill: patch.skill,
+        patch: patch.id
+    });
+    return {
+        kind: "skill-patch",
+        patch: result.patch,
+        skillPath: result.skillPath
+    };
+}
+export async function approveAny(options) {
+    const cwd = options.cwd ?? process.cwd();
+    if (options.id.trim().toLowerCase() === "latest") {
+        try {
+            const proposal = await readLatestProposedMemoryProposal(cwd);
+            return await approveMemory({ cwd, id: proposal.id });
+        }
+        catch (error) {
+            if (!isNoProposedMemoryProposal(error)) {
+                throw error;
+            }
+        }
+        try {
+            const patch = await readLatestProposedSkillPatch(cwd);
+            return await approveSkillPatch({ cwd, id: patch.id });
+        }
+        catch (error) {
+            if (isNoProposedSkillPatch(error)) {
+                throw new BriefOpsError("No proposed memory proposal or skill patch found for approval.");
+            }
+            throw error;
+        }
+    }
+    try {
+        await readMemoryProposal(cwd, options.id);
+        return await approveMemory({ cwd, id: options.id });
+    }
+    catch (error) {
+        if (!isMemoryProposalNotFound(error)) {
+            throw error;
+        }
+    }
+    try {
+        return await approveSkillPatch({ cwd, id: options.id });
+    }
+    catch (error) {
+        if (isSkillPatchNotFound(error)) {
+            throw new BriefOpsError(`No memory proposal or skill patch found for approval: ${options.id}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=approval.js.map

package/dist/core/approval.js.map

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

package/dist/core/brief.d.ts

@@ -0,0 +1,47 @@
+import type { GeneratedBrief, TokenReportLine } from "../schemas/brief.js";
+export type GenerateBriefOptions = {
+    cwd?: string;
+    skill?: string;
+    project?: string;
+    worker?: string;
+    task: string;
+    budget?: number;
+    adapter?: string;
+};
+export declare function generateBrief(input: GenerateBriefOptions): Promise<GeneratedBrief>;
+export declare function saveGeneratedBrief(options: {
+    cwd: string;
+    generated: GeneratedBrief;
+    project?: string;
+    skill?: string;
+    worker?: string;
+    outputPath?: string;
+    force?: boolean;
+}): Promise<string>;
+export declare function inspectBriefTokens(input: GenerateBriefOptions): Promise<{
+    skillName: string;
+    skillTokens: number;
+    projectName: string;
+    projectTokens: number;
+    workerName?: string;
+    workerTokens: number;
+    memoryTokens: number;
+    taskTokens: number;
+    totalTokens: number;
+    renderedTokens: number;
+    budget: number;
+    warnings: string[];
+    report: TokenReportLine[];
+}>;
+export declare function listSavedBriefs(cwd?: string): Promise<Array<{
+    id: string;
+    path: string;
+    tokens: number;
+}>>;
+export declare function showSavedBrief(cwd: string, idOrLatest: string): Promise<string>;
+export declare function inspectSavedBrief(cwd: string, idOrLatest: string): Promise<{
+    id: string;
+    path: string;
+    tokens: number;
+    characters: number;
+}>;