briefops 1.0.0

package/dist/core/paths.js

@@ -0,0 +1,84 @@
+import path from "node:path";
+import { BriefOpsError } from "./errors.js";
+export const memoryCategories = [
+    "facts",
+    "decisions",
+    "lessons",
+    "incidents",
+    "deprecated"
+];
+export function normalizeName(name) {
+    const normalized = name.trim().toLowerCase().replace(/\s+/g, "-");
+    if (!/^[a-z0-9][a-z0-9._-]*$/.test(normalized)) {
+        throw new BriefOpsError(`Invalid name: ${name}. Use letters, numbers, dots, underscores, or hyphens.`);
+    }
+    return normalized;
+}
+export function workspacePaths(cwd = process.cwd()) {
+    const root = path.join(cwd, ".briefops");
+    return {
+        cwd,
+        root,
+        config: path.join(root, "config.yaml"),
+        skills: path.join(root, "skills"),
+        projects: path.join(root, "projects"),
+        memory: path.join(root, "memory"),
+        memoryProposals: path.join(root, "memory-proposals"),
+        workers: path.join(root, "workers"),
+        workerSummaries: path.join(root, "workers", "summaries"),
+        logs: path.join(root, "logs"),
+        handoffs: path.join(root, "handoffs"),
+        briefs: path.join(root, "briefs"),
+        codex: path.join(root, "codex"),
+        codexPrompts: path.join(root, "codex", "prompts"),
+        evals: path.join(root, "evals"),
+        evalResults: path.join(root, "evals", "results"),
+        patches: path.join(root, "patches"),
+        templates: path.join(root, "templates")
+    };
+}
+export function skillFilePath(cwd, name) {
+    return path.join(workspacePaths(cwd).skills, `${normalizeName(name)}.skill.md`);
+}
+export function projectFilePath(cwd, name) {
+    return path.join(workspacePaths(cwd).projects, `${normalizeName(name)}.project.md`);
+}
+export function memoryFilePath(cwd, category) {
+    return path.join(workspacePaths(cwd).memory, `${category}.yaml`);
+}
+export function memoryProposalFilePath(cwd, id) {
+    return path.join(workspacePaths(cwd).memoryProposals, `${normalizeName(id)}.memory-proposal.yaml`);
+}
+export function workerFilePath(cwd, name) {
+    return path.join(workspacePaths(cwd).workers, `${normalizeName(name)}.worker.yaml`);
+}
+export function workerSummaryFilePath(cwd, name) {
+    return path.join(workspacePaths(cwd).workerSummaries, `${normalizeName(name)}.summary.md`);
+}
+export function evalCaseFilePath(cwd, name) {
+    return path.join(workspacePaths(cwd).evals, `${normalizeName(name)}.eval.yaml`);
+}
+export function skillPatchFilePath(cwd, id) {
+    return path.join(workspacePaths(cwd).patches, `${normalizeName(id)}.patch.yaml`);
+}
+export function formatDateStamp(date = new Date()) {
+    const pad = (value, size = 2) => String(value).padStart(size, "0");
+    return [
+        date.getUTCFullYear(),
+        pad(date.getUTCMonth() + 1),
+        pad(date.getUTCDate()),
+        "_",
+        pad(date.getUTCHours()),
+        pad(date.getUTCMinutes()),
+        pad(date.getUTCSeconds()),
+        "_",
+        pad(date.getUTCMilliseconds(), 3)
+    ].join("");
+}
+export function slugForFilename(value) {
+    return normalizeName(value)
+        .replace(/[._]+/g, "-")
+        .replace(/-+/g, "-")
+        .slice(0, 80);
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

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

package/dist/core/prime.d.ts

@@ -0,0 +1,17 @@
+import { type ExportPolicy } from "./exportPolicy.js";
+export type PrimeContextOptions = {
+    cwd?: string;
+    worker?: string;
+    project?: string;
+    task?: string;
+    maxTokens?: number;
+    format?: "markdown" | "codex";
+    exportPolicy?: ExportPolicy;
+};
+export type PrimeContextResult = {
+    status: "ready" | "attention-required" | "setup-required";
+    content: string;
+    tokens: number;
+    warnings: string[];
+};
+export declare function primeContext(options?: PrimeContextOptions): Promise<PrimeContextResult>;

package/dist/core/prime.js

@@ -0,0 +1,298 @@
+import { readBriefOpsConfig } from "./config.js";
+import { inspectContinuityHealth } from "./continuity.js";
+import { filterMemoryForExport, normalizeExportPolicy, sharedOnlyOmissionNote } from "./exportPolicy.js";
+import { getInboxSummary } from "./inbox.js";
+import { listWorkLogs } from "./log.js";
+import { formatMemoryItem, selectContinuityContext } from "./memory.js";
+import { normalizeName, workspacePaths } from "./paths.js";
+import { estimateTokens, truncateToTokenBudget } from "./tokens.js";
+import { listWorkers, readWorker } from "./worker.js";
+import { pathExists } from "./storage.js";
+function quote(value) {
+    return `"${value.replace(/(["\\$`])/g, "\\$1")}"`;
+}
+function unique(values) {
+    return [...new Set(values.map((value) => value.trim()).filter(Boolean))];
+}
+function renderList(values, empty, limit) {
+    const items = unique(values).slice(0, limit);
+    return items.length > 0 ? items.map((item) => `- ${item}`).join("\n") : empty;
+}
+function setupRequiredContent(maxTokens) {
+    const content = truncateToTokenBudget([
+        "# BriefOps Prime Context",
+        "",
+        "Status: setup-required",
+        "",
+        "No `.briefops` workspace was found here.",
+        "",
+        "Run:",
+        "",
+        "```bash",
+        "briefops init",
+        "briefops codex install",
+        "briefops codex plugin install",
+        "briefops skill create <skill>",
+        "briefops project create <project>",
+        "briefops worker create <worker> --project <project> --skills \"<skill>\"",
+        "briefops worker use <worker>",
+        "```",
+        ""
+    ].join("\n"), maxTokens).text;
+    return {
+        status: "setup-required",
+        content,
+        tokens: estimateTokens(content),
+        warnings: ["BriefOps workspace not found."]
+    };
+}
+function attentionRequiredContent(options) {
+    const workerList = options.workers.length > 0
+        ? options.workers.map((worker) => `- ${worker}`).join("\n")
+        : "- No active workers found.";
+    const content = truncateToTokenBudget([
+        "# BriefOps Prime Context",
+        "",
+        "Status: attention-required",
+        "",
+        "## Current Task",
+        "",
+        options.task,
+        "",
+        "## Reason",
+        "",
+        options.reason,
+        "",
+        "## Available Workers",
+        "",
+        workerList,
+        "",
+        "## Recommended Commands",
+        "",
+        "```bash",
+        "briefops worker list",
+        "briefops worker use <worker>",
+        "```",
+        "",
+        "## Token Budget",
+        "",
+        `- Maximum: ${options.maxTokens}`,
+        ""
+    ].join("\n"), options.maxTokens).text;
+    return {
+        status: "attention-required",
+        content,
+        tokens: estimateTokens(content),
+        warnings: [options.reason]
+    };
+}
+async function resolvePrimeWorker(options) {
+    if (options.worker) {
+        return { worker: normalizeName(options.worker) };
+    }
+    const config = await readBriefOpsConfig(options.cwd);
+    if (config.defaults.worker) {
+        return { worker: config.defaults.worker };
+    }
+    const workers = await listWorkers({
+        cwd: options.cwd,
+        status: "active"
+    });
+    if (workers.length === 1) {
+        return { worker: workers[0].name };
+    }
+    return {
+        attention: attentionRequiredContent({
+            task: "No current task provided.",
+            maxTokens: 800,
+            workers: workers.map((worker) => worker.name),
+            reason: "Select a default worker before priming context."
+        })
+    };
+}
+export async function primeContext(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const maxTokens = options.maxTokens ?? 800;
+    const task = options.task?.trim() || "No current task provided.";
+    const format = options.format ?? "markdown";
+    const exportPolicy = normalizeExportPolicy(options.exportPolicy);
+    if (!(await pathExists(workspacePaths(cwd).root))) {
+        return setupRequiredContent(maxTokens);
+    }
+    const resolved = await resolvePrimeWorker({
+        cwd,
+        worker: options.worker
+    });
+    if (resolved.attention) {
+        return attentionRequiredContent({
+            task,
+            maxTokens,
+            workers: (await listWorkers({ cwd, status: "active" })).map((worker) => worker.name),
+            reason: "Select a default worker before priming context."
+        });
+    }
+    const workerName = resolved.worker;
+    const worker = await readWorker(cwd, workerName);
+    const project = options.project ? normalizeName(options.project) : worker.project;
+    if (!project) {
+        return attentionRequiredContent({
+            task,
+            maxTokens,
+            workers: [workerName],
+            reason: `Worker ${workerName} has no default project. Recreate it with --project or pass --project.`
+        });
+    }
+    const health = await inspectContinuityHealth({
+        cwd,
+        project,
+        worker: workerName
+    });
+    const inbox = await getInboxSummary({
+        cwd,
+        project,
+        worker: workerName
+    });
+    const memory = await selectContinuityContext({
+        cwd,
+        project,
+        skills: worker.default_skills,
+        worker: workerName,
+        task,
+        maxTokens: Math.max(120, Math.floor(maxTokens * 0.28)),
+        quotas: {
+            facts: 2,
+            decisions: 3,
+            lessons: 3,
+            incidents: 2,
+            deprecated: 0
+        }
+    });
+    const memoryItems = filterMemoryForExport(memory.items, exportPolicy);
+    const memoryText = memoryItems.length > 0
+        ? memoryItems.map(formatMemoryItem).join("\n")
+        : "No active matching memory selected.";
+    const logs = await listWorkLogs({
+        cwd,
+        project,
+        worker: workerName,
+        limit: 8
+    });
+    const openRisks = exportPolicy === "shared-only" ? [] : logs.flatMap((log) => log.open_risks);
+    const nextSteps = exportPolicy === "shared-only" ? [] : logs.flatMap((log) => log.next_steps);
+    const pendingReview = exportPolicy === "shared-only"
+        ? [
+            sharedOnlyOmissionNote,
+            "Local pending review counts are omitted by shared-only policy.",
+            format === "codex"
+                ? "Codex format is active; follow the operating note below before broad repo/history inspection."
+                : undefined
+        ].filter((item) => Boolean(item))
+        : [
+            inbox.pendingMemoryProposals > 0
+                ? `${inbox.pendingMemoryProposals} pending memory proposal(s).`
+                : undefined,
+            inbox.pendingSkillPatches > 0 ? `${inbox.pendingSkillPatches} pending skill patch(es).` : undefined,
+            "This context may include private local BriefOps memory. Review before sharing outside this machine.",
+            format === "codex"
+                ? "Codex format is active; follow the operating note below before broad repo/history inspection."
+                : undefined
+        ].filter((item) => Boolean(item));
+    const warnings = [
+        health.readiness === "WARN" ? "Continuity health is WARN." : undefined,
+        inbox.pendingMemoryProposals > 0 ? "Pending memory proposals should be reviewed." : undefined,
+        exportPolicy === "local-private" ? "Prime context may include private local memory." : undefined
+    ].filter((warning) => Boolean(warning));
+    const codexOperatingNote = format === "codex"
+        ? [
+            "## Codex Operating Note",
+            "",
+            "Use this as a routing brief before broad repo/history inspection.",
+            "",
+            "Do:",
+            "- Restate the current task.",
+            "- Use the selected worker/project context.",
+            "- Inspect only the files needed for the task.",
+            "- Review pending memory proposals with the user before applying.",
+            `- Use \`briefops continue --worker ${workerName} --task ${quote(task)} --pack\` when a fresh-thread resume is needed.`,
+            "",
+            "Do not:",
+            "- Dump the entire `.briefops` workspace.",
+            "- Apply memory or skill patches without user approval.",
+            "- Treat this prime context as a substitute for relevant code inspection.",
+            ""
+        ]
+        : [];
+    const content = [
+        "# BriefOps Prime Context",
+        "",
+        `Status: ready`,
+        "",
+        "## Token Budget",
+        "",
+        `- Maximum: ${maxTokens}`,
+        `- Export policy: ${exportPolicy}`,
+        "",
+        "## Current Task",
+        "",
+        task,
+        "",
+        "## Worker",
+        "",
+        `- Worker: ${workerName}`,
+        `- Project: ${project}`,
+        `- Skills: ${worker.default_skills.length > 0 ? worker.default_skills.join(", ") : "none"}`,
+        "",
+        ...codexOperatingNote,
+        "## Continuity Status",
+        "",
+        `- Readiness: ${health.readiness}`,
+        exportPolicy === "shared-only"
+            ? "- Work logs: omitted by shared-only policy"
+            : `- Work logs: ${health.history.workLogs}`,
+        exportPolicy === "shared-only"
+            ? "- Active memory: shared/exportable selected only"
+            : `- Active memory: ${Object.entries(health.memory).map(([key, value]) => `${key}=${value}`).join(", ")}`,
+        exportPolicy === "shared-only"
+            ? `- Shared/exportable memory selected: ${memoryItems.length}`
+            : undefined,
+        "",
+        "## Highest-Value Memory",
+        "",
+        memoryText,
+        "",
+        "## Open Risks And Next Steps",
+        "",
+        "Open risks:",
+        exportPolicy === "shared-only"
+            ? `- ${sharedOnlyOmissionNote}`
+            : renderList(openRisks, "- No open risks found.", 4),
+        "",
+        "Next steps:",
+        exportPolicy === "shared-only"
+            ? `- ${sharedOnlyOmissionNote}`
+            : renderList(nextSteps, "- No next steps found.", 4),
+        "",
+        "## Pending User Review",
+        "",
+        pendingReview.length > 0
+            ? pendingReview.map((item) => `- ${item}`).join("\n")
+            : "- No pending user review found.",
+        "",
+        "## Recommended Commands",
+        "",
+        "```bash",
+        `briefops prime --format ${format} --task ${quote(task)} --max-tokens ${maxTokens}`,
+        inbox.pendingMemoryProposals > 0 ? "briefops memory proposal-show latest" : undefined,
+        `briefops continue --worker ${workerName} --task ${quote(task)} --pack`,
+        "```",
+        ""
+    ].filter((line) => line !== undefined).join("\n");
+    const trimmed = truncateToTokenBudget(content, maxTokens).text;
+    return {
+        status: "ready",
+        content: trimmed,
+        tokens: estimateTokens(trimmed),
+        warnings
+    };
+}
+//# sourceMappingURL=prime.js.map

package/dist/core/prime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prime.js","sourceRoot":"","sources":["../../src/core/prime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmB1C,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC;AACpD,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC9B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,UAAU,CAAC,MAAgB,EAAE,KAAa,EAAE,KAAa;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAChF,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB;IAC7C,MAAM,OAAO,GAAG,qBAAqB,CACnC;QACE,0BAA0B;QAC1B,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,0CAA0C;QAC1C,EAAE;QACF,MAAM;QACN,EAAE;QACF,SAAS;QACT,eAAe;QACf,wBAAwB;QACxB,+BAA+B;QAC/B,+BAA+B;QAC/B,mCAAmC;QACnC,0EAA0E;QAC1E,8BAA8B;QAC9B,KAAK;QACL,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ,SAAS,CACV,CAAC,IAAI,CAAC;IAEP,OAAO;QACL,MAAM,EAAE,gBAAgB;QACxB,OAAO;QACP,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC;QAC/B,QAAQ,EAAE,CAAC,+BAA+B,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,OAKjC;IACC,MAAM,UAAU,GACd,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACxB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3D,CAAC,CAAC,4BAA4B,CAAC;IACnC,MAAM,OAAO,GAAG,qBAAqB,CACnC;QACE,0BAA0B;QAC1B,EAAE;QACF,4BAA4B;QAC5B,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,OAAO,CAAC,IAAI;QACZ,EAAE;QACF,WAAW;QACX,EAAE;QACF,OAAO,CAAC,MAAM;QACd,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,UAAU;QACV,EAAE;QACF,yBAAyB;QACzB,EAAE;QACF,SAAS;QACT,sBAAsB;QACtB,8BAA8B;QAC9B,KAAK;QACL,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,cAAc,OAAO,CAAC,SAAS,EAAE;QACjC,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ,OAAO,CAAC,SAAS,CAClB,CAAC,IAAI,CAAC;IAEP,OAAO;QACL,MAAM,EAAE,oBAAoB;QAC5B,OAAO;QACP,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC;QAC/B,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,OAGjC;IACC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,QAAQ;KACjB,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,OAAO;QACL,SAAS,EAAE,wBAAwB,CAAC;YAClC,IAAI,EAAE,2BAA2B;YACjC,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;YAC7C,MAAM,EAAE,iDAAiD;SAC1D,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAA+B,EAAE;IAClE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,2BAA2B,CAAC;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC;IAC5C,MAAM,YAAY,GAAG,qBAAqB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEjE,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;QACxC,GAAG;QACH,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,OAAO,wBAAwB,CAAC;YAC9B,IAAI;YACJ,SAAS;YACT,OAAO,EAAE,CAAC,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;YACpF,MAAM,EAAE,iDAAiD;SAC1D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAgB,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;IAClF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,wBAAwB,CAAC;YAC9B,IAAI;YACJ,SAAS;YACT,OAAO,EAAE,CAAC,UAAU,CAAC;YACrB,MAAM,EAAE,UAAU,UAAU,wEAAwE;SACrG,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC;QAC3C,GAAG;QACH,OAAO;QACP,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC;QAClC,GAAG;QACH,OAAO;QACP,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC;QAC3C,GAAG;QACH,OAAO;QACP,MAAM,EAAE,MAAM,CAAC,cAAc;QAC7B,MAAM,EAAE,UAAU;QAClB,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;QACtD,MAAM,EAAE;YACN,KAAK,EAAE,CAAC;YACR,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,CAAC;SACd;KACF,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACtE,MAAM,UAAU,GACd,WAAW,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,qCAAqC,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC;QAC9B,GAAG;QACH,OAAO;QACP,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,CAAC;KACT,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,YAAY,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9F,MAAM,SAAS,GAAG,YAAY,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9F,MAAM,aAAa,GAAa,YAAY,KAAK,aAAa;QAC5D,CAAC,CAAC;YACE,sBAAsB;YACtB,gEAAgE;YAChE,MAAM,KAAK,OAAO;gBAChB,CAAC,CAAC,+FAA+F;gBACjG,CAAC,CAAC,SAAS;SACd,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC;YACE,KAAK,CAAC,sBAAsB,GAAG,CAAC;gBAC9B,CAAC,CAAC,GAAG,KAAK,CAAC,sBAAsB,8BAA8B;gBAC/D,CAAC,CAAC,SAAS;YACb,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,mBAAmB,2BAA2B,CAAC,CAAC,CAAC,SAAS;YACnG,qGAAqG;YACrG,MAAM,KAAK,OAAO;gBAChB,CAAC,CAAC,+FAA+F;gBACjG,CAAC,CAAC,SAAS;SACd,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG;QACf,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,SAAS;QACtE,KAAK,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,CAAC,8CAA8C,CAAC,CAAC,CAAC,SAAS;QAC7F,YAAY,KAAK,eAAe,CAAC,CAAC,CAAC,iDAAiD,CAAC,CAAC,CAAC,SAAS;KACjG,CAAC,MAAM,CAAC,CAAC,OAAO,EAAqB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,MAAM,kBAAkB,GAAG,MAAM,KAAK,OAAO;QAC3C,CAAC,CAAC;YACE,yBAAyB;YACzB,EAAE;YACF,mEAAmE;YACnE,EAAE;YACF,KAAK;YACL,6BAA6B;YAC7B,4CAA4C;YAC5C,+CAA+C;YAC/C,kEAAkE;YAClE,sCAAsC,UAAU,WAAW,KAAK,CAAC,IAAI,CAAC,iDAAiD;YACvH,EAAE;YACF,SAAS;YACT,0CAA0C;YAC1C,wDAAwD;YACxD,0EAA0E;YAC1E,EAAE;SACH;QACH,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,OAAO,GAAG;QACd,0BAA0B;QAC1B,EAAE;QACF,eAAe;QACf,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,cAAc,SAAS,EAAE;QACzB,oBAAoB,YAAY,EAAE;QAClC,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,IAAI;QACJ,EAAE;QACF,WAAW;QACX,EAAE;QACF,aAAa,UAAU,EAAE;QACzB,cAAc,OAAO,EAAE;QACvB,aAAa,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;QAC3F,EAAE;QACF,GAAG,kBAAkB;QACrB,sBAAsB;QACtB,EAAE;QACF,gBAAgB,MAAM,CAAC,SAAS,EAAE;QAClC,YAAY,KAAK,aAAa;YAC5B,CAAC,CAAC,4CAA4C;YAC9C,CAAC,CAAC,gBAAgB,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE;QAC7C,YAAY,KAAK,aAAa;YAC5B,CAAC,CAAC,kDAAkD;YACpD,CAAC,CAAC,oBAAoB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC3G,YAAY,KAAK,aAAa;YAC5B,CAAC,CAAC,wCAAwC,WAAW,CAAC,MAAM,EAAE;YAC9D,CAAC,CAAC,SAAS;QACb,EAAE;QACF,yBAAyB;QACzB,EAAE;QACF,UAAU;QACV,EAAE;QACF,8BAA8B;QAC9B,EAAE;QACF,aAAa;QACb,YAAY,KAAK,aAAa;YAC5B,CAAC,CAAC,KAAK,sBAAsB,EAAE;YAC/B,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,wBAAwB,EAAE,CAAC,CAAC;QACtD,EAAE;QACF,aAAa;QACb,YAAY,KAAK,aAAa;YAC5B,CAAC,CAAC,KAAK,sBAAsB,EAAE;YAC/B,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,wBAAwB,EAAE,CAAC,CAAC;QACtD,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,aAAa,CAAC,MAAM,GAAG,CAAC;YACtB,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACrD,CAAC,CAAC,iCAAiC;QACrC,EAAE;QACF,yBAAyB;QACzB,EAAE;QACF,SAAS;QACT,2BAA2B,MAAM,WAAW,KAAK,CAAC,IAAI,CAAC,iBAAiB,SAAS,EAAE;QACnF,KAAK,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,SAAS;QACrF,8BAA8B,UAAU,WAAW,KAAK,CAAC,IAAI,CAAC,SAAS;QACvE,KAAK;QACL,EAAE;KACH,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC;IAE/D,OAAO;QACL,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC;QAC/B,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/core/privacyDoctor.d.ts

@@ -0,0 +1,14 @@
+export type PrivacyDoctorStatus = "ok" | "warn" | "fail";
+export type PrivacyDoctorCheck = {
+    name: string;
+    status: PrivacyDoctorStatus;
+    detail: string;
+};
+export type PrivacyDoctorResult = {
+    ok: boolean;
+    checks: PrivacyDoctorCheck[];
+};
+export declare function fixBriefOpsGitignore(cwd?: string): Promise<string>;
+export declare function runPrivacyDoctor(options?: {
+    cwd?: string;
+}): Promise<PrivacyDoctorResult>;

package/dist/core/privacyDoctor.js

@@ -0,0 +1,59 @@
+import path from "node:path";
+import { listMemory } from "./memory.js";
+import { pathExists, readTextFile, writeTextFile } from "./storage.js";
+import { requireWorkspace } from "./workspace.js";
+function check(name, status, detail) {
+    return { name, status, detail };
+}
+const secretPatterns = [
+    /\bsk-[A-Za-z0-9_-]{16,}\b/,
+    /\bghp_[A-Za-z0-9_]{20,}\b/,
+    /\bgithub_pat_[A-Za-z0-9_]{20,}\b/,
+    /\bAKIA[0-9A-Z]{16}\b/,
+    /\b(password|passwd|secret|token|api[_-]?key)\s*[:=]\s*\S+/i
+];
+async function gitignoreStatus(cwd) {
+    const gitignorePath = path.join(cwd, ".gitignore");
+    if (!(await pathExists(gitignorePath))) {
+        return check("Gitignore", "warn", ".gitignore not found; add `.briefops/` before public use.");
+    }
+    const raw = await readTextFile(gitignorePath);
+    const ignoresBriefOps = raw
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .some((line) => line === ".briefops" || line === ".briefops/" || line === "/.briefops/");
+    return ignoresBriefOps
+        ? check("Gitignore", "ok", ".briefops is ignored.")
+        : check("Gitignore", "warn", ".briefops is not ignored.");
+}
+export async function fixBriefOpsGitignore(cwd = process.cwd()) {
+    const gitignorePath = path.join(cwd, ".gitignore");
+    const existing = await pathExists(gitignorePath) ? await readTextFile(gitignorePath) : "";
+    const lines = existing.split(/\r?\n/).map((line) => line.trim());
+    if (!lines.includes(".briefops/") && !lines.includes(".briefops") && !lines.includes("/.briefops/")) {
+        const next = `${existing.trimEnd()}${existing.trim() ? "\n" : ""}.briefops/\n`;
+        await writeTextFile(gitignorePath, next, { force: true });
+    }
+    return gitignorePath;
+}
+export async function runPrivacyDoctor(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const memory = await listMemory({ cwd });
+    const privateExportable = memory.filter((item) => item.visibility === "private" && item.exportable);
+    const secretLike = memory.filter((item) => secretPatterns.some((pattern) => pattern.test(item.content)));
+    const checks = [
+        await gitignoreStatus(cwd),
+        privateExportable.length > 0
+            ? check("Private exportable memory", "warn", `${privateExportable.length} private item(s) are exportable.`)
+            : check("Private exportable memory", "ok", "No private exportable memory."),
+        secretLike.length > 0
+            ? check("Secret-like local memory", "warn", `${secretLike.length} memory item(s) look like secrets.`)
+            : check("Secret-like local memory", "ok", "No secret-like memory found.")
+    ];
+    return {
+        ok: checks.every((item) => item.status !== "fail"),
+        checks
+    };
+}
+//# sourceMappingURL=privacyDoctor.js.map

package/dist/core/privacyDoctor.js.map

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

package/dist/core/project.d.ts

@@ -0,0 +1,16 @@
+import { type ProjectDocument } from "../schemas/project.js";
+export type CreateProjectOptions = {
+    cwd?: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+    maxTokens?: number;
+    force?: boolean;
+};
+export declare function createProject(options: CreateProjectOptions): Promise<{
+    path: string;
+    name: string;
+}>;
+export declare function readProject(cwd: string, name: string): Promise<ProjectDocument>;
+export declare function showProject(cwd: string, name: string): Promise<string>;
+export declare function listProjects(cwd?: string): Promise<ProjectDocument[]>;

package/dist/core/project.js

@@ -0,0 +1,73 @@
+import { BriefOpsError } from "./errors.js";
+import { normalizeName, projectFilePath, workspacePaths } from "./paths.js";
+import { listFilesBySuffix, parseMarkdownWithFrontmatter, readTextFile, stringifyMarkdownWithFrontmatter, writeTextFile } from "./storage.js";
+import { requireWorkspace } from "./workspace.js";
+import { projectFrontmatterSchema } from "../schemas/project.js";
+export async function createProject(options) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const name = normalizeName(options.name);
+    const filePath = projectFilePath(cwd, name);
+    const data = projectFrontmatterSchema.parse({
+        name,
+        description: options.description ?? "",
+        max_tokens: options.maxTokens ?? 500,
+        tags: options.tags ?? []
+    });
+    const body = [
+        `# Project: ${name}`,
+        "",
+        "## Active Facts",
+        "",
+        options.description ? `- ${options.description}` : "- Add durable project facts here.",
+        "",
+        "## Active Constraints",
+        "",
+        "- Add constraints the agent must respect.",
+        "",
+        "## Read If Needed",
+        "",
+        "- Add source files or docs to inspect when relevant."
+    ].join("\n");
+    await writeTextFile(filePath, stringifyMarkdownWithFrontmatter(data, body), {
+        force: options.force
+    });
+    return { path: filePath, name };
+}
+export async function readProject(cwd, name) {
+    await requireWorkspace(cwd);
+    const normalized = normalizeName(name);
+    const filePath = projectFilePath(cwd, normalized);
+    try {
+        const raw = await readTextFile(filePath);
+        return parseMarkdownWithFrontmatter(raw, projectFrontmatterSchema, filePath);
+    }
+    catch (error) {
+        if (error instanceof BriefOpsError && error.message.startsWith("File not found")) {
+            throw new BriefOpsError(`Project not found: ${normalized}`);
+        }
+        throw error;
+    }
+}
+export async function showProject(cwd, name) {
+    await requireWorkspace(cwd);
+    const normalized = normalizeName(name);
+    try {
+        return await readTextFile(projectFilePath(cwd, normalized));
+    }
+    catch (error) {
+        if (error instanceof BriefOpsError && error.message.startsWith("File not found")) {
+            throw new BriefOpsError(`Project not found: ${normalized}`);
+        }
+        throw error;
+    }
+}
+export async function listProjects(cwd = process.cwd()) {
+    await requireWorkspace(cwd);
+    const files = await listFilesBySuffix(workspacePaths(cwd).projects, ".project.md");
+    return Promise.all(files.map(async (filePath) => {
+        const raw = await readTextFile(filePath);
+        return parseMarkdownWithFrontmatter(raw, projectFrontmatterSchema, filePath);
+    }));
+}
+//# sourceMappingURL=project.js.map

package/dist/core/project.js.map

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

package/dist/core/securityDoctor.d.ts

@@ -0,0 +1,14 @@
+export type SecurityDoctorStatus = "ok" | "warn" | "fail";
+export type SecurityDoctorCheck = {
+    name: string;
+    status: SecurityDoctorStatus;
+    detail: string;
+};
+export type SecurityDoctorResult = {
+    ok: boolean;
+    checks: SecurityDoctorCheck[];
+};
+export declare function runSecurityDoctor(options?: {
+    cwd?: string;
+    staleMs?: number;
+}): Promise<SecurityDoctorResult>;