briefops 1.0.0

package/dist/core/inbox.js

@@ -0,0 +1,56 @@
+import { listWorkLogs } from "./log.js";
+import { listMemory } from "./memory.js";
+import { listMemoryProposals } from "./memoryProposal.js";
+import { listSkillPatches } from "./patch.js";
+import { normalizeName } from "./paths.js";
+import { readWorker } from "./worker.js";
+import { requireWorkspace } from "./workspace.js";
+export async function getInboxSummary(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const project = options.project ? normalizeName(options.project) : undefined;
+    const workerName = options.worker ? normalizeName(options.worker) : undefined;
+    const worker = workerName ? await readWorker(cwd, workerName) : undefined;
+    const skill = options.skill ? normalizeName(options.skill) : undefined;
+    const workerSkills = new Set(worker?.default_skills ?? []);
+    const effectiveProject = project ?? worker?.project;
+    const memoryProposals = (await listMemoryProposals({
+        cwd,
+        status: "proposed",
+        project: effectiveProject,
+        skill
+    })).filter((proposal) => !workerName || !proposal.worker || proposal.worker === workerName);
+    const skillPatches = (await listSkillPatches(cwd))
+        .filter((patch) => patch.status === "proposed")
+        .filter((patch) => (skill ? patch.skill === skill : true))
+        .filter((patch) => (workerSkills.size > 0 ? workerSkills.has(patch.skill) : true));
+    const logs = await listWorkLogs({
+        cwd,
+        project: effectiveProject,
+        skill,
+        worker: workerName,
+        limit: 20
+    });
+    const memory = await listMemory({
+        cwd,
+        project: effectiveProject,
+        skill
+    });
+    const staleMemory = memory.filter((item) => item.status === "stale").length;
+    const deprecatedMemory = memory.filter((item) => item.status === "deprecated" || item.type === "deprecated").length;
+    const inspectProject = effectiveProject ?? "<project>";
+    const inspectWorker = workerName ?? "<worker>";
+    return {
+        pendingMemoryProposals: memoryProposals.length,
+        pendingSkillPatches: skillPatches.length,
+        openRisks: logs.flatMap((log) => log.open_risks).length,
+        staleMemory,
+        deprecatedMemory,
+        recommendedCommands: [
+            "briefops memory proposal-list --status proposed",
+            "briefops skill patch-list",
+            `briefops inspect continuity --project ${inspectProject} --worker ${inspectWorker}`
+        ]
+    };
+}
+//# sourceMappingURL=inbox.js.map

package/dist/core/inbox.js.map

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

package/dist/core/lock.d.ts

@@ -0,0 +1,11 @@
+export type WorkspaceLockOptions = {
+    cwd?: string;
+    name: string;
+    timeoutMs?: number;
+    staleMs?: number;
+};
+export declare function withWorkspaceLock<T>(options: WorkspaceLockOptions, callback: () => Promise<T>): Promise<T>;
+export declare function cleanStaleLocks(options?: {
+    cwd?: string;
+    staleMs?: number;
+}): Promise<string[]>;

package/dist/core/lock.js

@@ -0,0 +1,99 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { BriefOpsError } from "./errors.js";
+import { normalizeName, workspacePaths } from "./paths.js";
+import { ensureDirectory, pathExists, readTextFile } from "./storage.js";
+import { requireWorkspace } from "./workspace.js";
+const defaultTimeoutMs = 1000;
+const defaultStaleMs = 30 * 60 * 1000;
+function delay(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+function lockPath(cwd, name) {
+    return path.join(workspacePaths(cwd).root, ".locks", `${normalizeName(name)}.lock`);
+}
+function lockDir(cwd) {
+    return path.join(workspacePaths(cwd).root, ".locks");
+}
+async function isStale(filePath, staleMs) {
+    if (!(await pathExists(filePath))) {
+        return false;
+    }
+    try {
+        const raw = await readTextFile(filePath);
+        const createdAt = raw.match(/^created_at: (.+)$/m)?.[1]?.trim();
+        const created = createdAt ? Date.parse(createdAt) : Number.NaN;
+        return Number.isNaN(created) || Date.now() - created > staleMs;
+    }
+    catch {
+        return true;
+    }
+}
+async function acquireLock(options) {
+    await requireWorkspace(options.cwd);
+    const filePath = lockPath(options.cwd, options.name);
+    await ensureDirectory(path.dirname(filePath));
+    const start = Date.now();
+    while (true) {
+        try {
+            const handle = await fs.open(filePath, "wx");
+            await handle.writeFile([
+                `name: ${normalizeName(options.name)}`,
+                `pid: ${process.pid}`,
+                `created_at: ${new Date().toISOString()}`,
+                ""
+            ].join("\n"), "utf8");
+            await handle.close();
+            return filePath;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST") {
+                throw error;
+            }
+            if (await isStale(filePath, options.staleMs)) {
+                await fs.unlink(filePath).catch(() => undefined);
+                continue;
+            }
+            if (Date.now() - start >= options.timeoutMs) {
+                throw new BriefOpsError(`BriefOps workspace lock is already held: ${normalizeName(options.name)}`);
+            }
+            await delay(10);
+        }
+    }
+}
+export async function withWorkspaceLock(options, callback) {
+    const cwd = options.cwd ?? process.cwd();
+    const lockFile = await acquireLock({
+        cwd,
+        name: options.name,
+        timeoutMs: options.timeoutMs ?? defaultTimeoutMs,
+        staleMs: options.staleMs ?? defaultStaleMs
+    });
+    try {
+        return await callback();
+    }
+    finally {
+        await fs.unlink(lockFile).catch(() => undefined);
+    }
+}
+export async function cleanStaleLocks(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const dirPath = lockDir(cwd);
+    if (!(await pathExists(dirPath))) {
+        return [];
+    }
+    const removed = [];
+    const entries = await fs.readdir(dirPath);
+    for (const entry of entries.filter((item) => item.endsWith(".lock"))) {
+        const filePath = path.join(dirPath, entry);
+        if (await isStale(filePath, options.staleMs ?? defaultStaleMs)) {
+            await fs.unlink(filePath).catch(() => undefined);
+            removed.push(filePath);
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=lock.js.map

package/dist/core/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AASlD,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtC,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,QAAgB,EAAE,OAAe;IACtD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAChE,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC/D,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAuC;IAChE,MAAM,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC7C,MAAM,MAAM,CAAC,SAAS,CACpB;gBACE,SAAS,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACtC,QAAQ,OAAO,CAAC,GAAG,EAAE;gBACrB,eAAe,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;gBACzC,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ,MAAM,CACP,CAAC;YACF,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,MAAM,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7C,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACjD,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC5C,MAAM,IAAI,aAAa,CACrB,4CAA4C,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAC1E,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA6B,EAC7B,QAA0B;IAE1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC;QACjC,GAAG;QACH,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,gBAAgB;QAChD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc;KAC3C,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,EAAE,CAAC;IAC1B,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAGlC,EAAE;IACJ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,MAAM,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,EAAE,CAAC;YAC/D,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/log.d.ts

@@ -0,0 +1,38 @@
+import { type WorkLog } from "../schemas/log.js";
+export type AddWorkLogOptions = {
+    cwd?: string;
+    project?: string;
+    skill?: string;
+    worker?: string;
+    task: string;
+    result: string;
+    lessons?: string[];
+    openRisks?: string[];
+    nextSteps?: string[];
+    decisions?: string[];
+    incidents?: string[];
+    files?: string;
+    commands?: string;
+    notes?: string;
+};
+export type ListWorkLogFilters = {
+    cwd?: string;
+    project?: string;
+    skill?: string;
+    worker?: string;
+    limit?: number;
+};
+export declare function addWorkLog(options: AddWorkLogOptions): Promise<{
+    path: string;
+    log: WorkLog;
+}>;
+export declare function listWorkLogs(filters?: ListWorkLogFilters): Promise<WorkLog[]>;
+export declare function readWorkLog(cwd: string, idOrLatest: string): Promise<WorkLog>;
+export declare function summarizeRecentLogs(options: {
+    cwd?: string;
+    project?: string;
+    skill?: string;
+    worker?: string;
+    limit?: number;
+    budget?: number;
+}): Promise<string>;

package/dist/core/log.js

@@ -0,0 +1,93 @@
+import { randomBytes } from "node:crypto";
+import path from "node:path";
+import { formatDateStamp, normalizeName, slugForFilename, workspacePaths } from "./paths.js";
+import { listFilesBySuffix, parseCommaList, readTextFile, writeYamlFile } from "./storage.js";
+import { requireWorkspace } from "./workspace.js";
+import { workLogSchema } from "../schemas/log.js";
+import YAML from "yaml";
+import { BriefOpsError } from "./errors.js";
+export async function addWorkLog(options) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const createdAt = new Date().toISOString();
+    const project = options.project ? normalizeName(options.project) : undefined;
+    const skill = options.skill ? normalizeName(options.skill) : undefined;
+    const worker = options.worker ? normalizeName(options.worker) : undefined;
+    const log = workLogSchema.parse({
+        id: `log_${createdAt.replace(/[-:.TZ]/g, "").slice(0, 17)}_${randomBytes(3).toString("hex")}`,
+        created_at: createdAt,
+        project,
+        skill,
+        worker,
+        task: options.task.trim(),
+        result: options.result.trim(),
+        lessons: options.lessons ?? [],
+        open_risks: options.openRisks ?? [],
+        next_steps: options.nextSteps ?? [],
+        decisions: options.decisions ?? [],
+        incidents: options.incidents ?? [],
+        files_changed: parseCommaList(options.files),
+        commands_run: parseCommaList(options.commands),
+        notes: options.notes ?? ""
+    });
+    const filename = `${formatDateStamp()}-${slugForFilename(project ?? "global")}-${slugForFilename(worker ?? skill ?? "general")}.yaml`;
+    const filePath = path.join(workspacePaths(cwd).logs, filename);
+    await writeYamlFile(filePath, log);
+    return { path: filePath, log };
+}
+export async function listWorkLogs(filters = {}) {
+    const cwd = filters.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const project = filters.project ? normalizeName(filters.project) : undefined;
+    const skill = filters.skill ? normalizeName(filters.skill) : undefined;
+    const worker = filters.worker ? normalizeName(filters.worker) : undefined;
+    const limit = filters.limit ?? 20;
+    const files = await listFilesBySuffix(workspacePaths(cwd).logs, ".yaml");
+    const logs = await Promise.all(files.map(async (filePath) => {
+        const raw = await readTextFile(filePath);
+        const parsed = YAML.parse(raw);
+        const result = workLogSchema.safeParse(parsed);
+        if (!result.success) {
+            throw new BriefOpsError(`Invalid work log ${filePath}: ${result.error.message}`);
+        }
+        return result.data;
+    }));
+    return logs
+        .filter((log) => (project ? log.project === project : true))
+        .filter((log) => (skill ? log.skill === skill : true))
+        .filter((log) => (worker ? log.worker === worker : true))
+        .sort((a, b) => b.created_at.localeCompare(a.created_at))
+        .slice(0, limit);
+}
+export async function readWorkLog(cwd, idOrLatest) {
+    const normalized = idOrLatest.trim().toLowerCase();
+    const logs = await listWorkLogs({ cwd, limit: Number.MAX_SAFE_INTEGER });
+    if (normalized === "latest") {
+        const latest = logs[0];
+        if (!latest) {
+            throw new BriefOpsError("No work logs found.");
+        }
+        return latest;
+    }
+    const match = logs.find((log) => log.id === idOrLatest);
+    if (!match) {
+        throw new BriefOpsError(`Work log not found: ${idOrLatest}`);
+    }
+    return match;
+}
+export async function summarizeRecentLogs(options) {
+    const logs = await listWorkLogs(options);
+    if (logs.length === 0) {
+        return "No recent work logs found.";
+    }
+    const lines = logs.map((log) => {
+        const details = [
+            log.result,
+            ...log.open_risks.map((risk) => `open risk: ${risk}`),
+            ...log.next_steps.map((step) => `next: ${step}`)
+        ].join("; ");
+        return `- ${log.created_at.slice(0, 10)}: ${log.task}; ${details}`;
+    });
+    return lines.join("\n");
+}
+//# sourceMappingURL=log.js.map

package/dist/core/log.js.map

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

package/dist/core/memory.d.ts

@@ -0,0 +1,86 @@
+import { type MemoryCategory } from "./paths.js";
+import { type MemoryItem, type MemoryStatus, type MemoryVisibility } from "../schemas/memory.js";
+export type AddMemoryOptions = {
+    cwd?: string;
+    type: string;
+    project?: string;
+    skill?: string;
+    content: string;
+    status?: string;
+    tags?: string[] | string;
+    source?: string;
+    visibility?: string;
+    exportable?: boolean;
+};
+export type ListMemoryFilters = {
+    cwd?: string;
+    type?: string;
+    project?: string;
+    skill?: string;
+    status?: string;
+    tag?: string;
+};
+export type SelectRelevantMemoryOptions = {
+    cwd: string;
+    project?: string;
+    skill?: string;
+    skills?: string[];
+    worker?: string;
+    task?: string;
+    types?: string[];
+    maxTokens: number;
+    quotas?: Partial<Record<MemoryCategory, number>>;
+    includeDeprecated?: boolean;
+};
+export type MemorySelection = {
+    item: MemoryItem;
+    score: number;
+    tier: number;
+    reason: string;
+};
+export declare function normalizeMemoryCategory(value: string): MemoryCategory;
+export declare function normalizeMemoryStatus(value?: string): MemoryStatus;
+export declare function normalizeMemoryVisibility(value?: string): MemoryVisibility;
+export declare function addMemoryIfMissing(options: AddMemoryOptions): Promise<{
+    item: MemoryItem;
+    created: boolean;
+}>;
+export declare function addMemoryIfMissingUnlocked(options: AddMemoryOptions): Promise<{
+    item: MemoryItem;
+    created: boolean;
+}>;
+export declare function addMemory(options: AddMemoryOptions): Promise<MemoryItem>;
+export declare function addMemoryUnlocked(options: AddMemoryOptions): Promise<MemoryItem>;
+export declare function listMemory(filters?: ListMemoryFilters): Promise<MemoryItem[]>;
+export declare function showMemory(cwd: string, id: string): Promise<MemoryItem>;
+export declare function updateMemoryStatus(options: {
+    cwd?: string;
+    id: string;
+    status: string;
+}): Promise<MemoryItem>;
+export declare function formatMemoryItem(item: MemoryItem): string;
+export declare function taskKeywords(value?: string): Set<string>;
+export declare function scoreMemoryItem(options: {
+    item: MemoryItem;
+    project?: string;
+    skill?: string;
+    skills?: string[];
+    worker?: string;
+    task?: string;
+}): MemorySelection;
+export declare function selectRelevantMemory(options: SelectRelevantMemoryOptions): Promise<{
+    items: MemoryItem[];
+    text: string;
+    tokens: number;
+    omitted: number;
+    selections: MemorySelection[];
+    omittedSelections: MemorySelection[];
+}>;
+export declare function selectContinuityContext(options: SelectRelevantMemoryOptions): Promise<{
+    items: MemoryItem[];
+    text: string;
+    tokens: number;
+    omitted: number;
+    selections: MemorySelection[];
+    omittedSelections: MemorySelection[];
+}>;