briefops 1.0.0

package/dist/core/securityDoctor.js

@@ -0,0 +1,96 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { readBriefOpsConfig } from "./config.js";
+import { listMemory } from "./memory.js";
+import { listMemoryProposals } from "./memoryProposal.js";
+import { memoryCategories, memoryFilePath, workspacePaths } from "./paths.js";
+import { listSkillPatches } from "./patch.js";
+import { pathExists, readTextFile, readYamlFile } from "./storage.js";
+import { readWorker } from "./worker.js";
+import { memoryFileSchema } from "../schemas/memory.js";
+function check(name, status, detail) {
+    return { name, status, detail };
+}
+async function listStaleLocks(cwd, staleMs) {
+    const lockDir = path.join(workspacePaths(cwd).root, ".locks");
+    if (!(await pathExists(lockDir))) {
+        return [];
+    }
+    const entries = await fs.readdir(lockDir);
+    const stale = [];
+    for (const entry of entries.filter((item) => item.endsWith(".lock"))) {
+        const filePath = path.join(lockDir, entry);
+        const raw = await readTextFile(filePath);
+        const createdAt = raw.match(/^created_at: (.+)$/m)?.[1]?.trim();
+        const created = createdAt ? Date.parse(createdAt) : Number.NaN;
+        if (Number.isNaN(created) || Date.now() - created > staleMs) {
+            stale.push(entry);
+        }
+    }
+    return stale;
+}
+export async function runSecurityDoctor(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const paths = workspacePaths(cwd);
+    const checks = [];
+    if (!(await pathExists(paths.root))) {
+        return {
+            ok: false,
+            checks: [check("Workspace", "fail", ".briefops workspace not found.")]
+        };
+    }
+    checks.push(check("Workspace", "ok", paths.root));
+    let config;
+    try {
+        config = await readBriefOpsConfig(cwd);
+        checks.push(check("Config YAML", "ok", paths.config));
+    }
+    catch (error) {
+        checks.push(check("Config YAML", "fail", error instanceof Error ? error.message : String(error)));
+    }
+    const invalidMemory = [];
+    for (const category of memoryCategories) {
+        try {
+            await readYamlFile(memoryFilePath(cwd, category), memoryFileSchema, { items: [] });
+        }
+        catch (error) {
+            invalidMemory.push(`${category}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    checks.push(invalidMemory.length === 0
+        ? check("Memory YAML", "ok", "All memory files are valid.")
+        : check("Memory YAML", "fail", invalidMemory.join("; ")));
+    if (config?.defaults.worker) {
+        try {
+            await readWorker(cwd, config.defaults.worker);
+            checks.push(check("Default worker", "ok", config.defaults.worker));
+        }
+        catch (error) {
+            checks.push(check("Default worker", "fail", error instanceof Error ? error.message : String(error)));
+        }
+    }
+    else {
+        checks.push(check("Default worker", "warn", "No default worker selected."));
+    }
+    const pendingMemory = await listMemoryProposals({ cwd, status: "proposed" });
+    checks.push(pendingMemory.length > 0
+        ? check("Pending memory proposals", "warn", `${pendingMemory.length} proposal(s) need review.`)
+        : check("Pending memory proposals", "ok", "No pending memory proposals."));
+    const pendingPatches = (await listSkillPatches(cwd)).filter((patch) => patch.status === "proposed");
+    checks.push(pendingPatches.length > 0
+        ? check("Pending skill patches", "warn", `${pendingPatches.length} patch(es) need review.`)
+        : check("Pending skill patches", "ok", "No pending skill patches."));
+    const privateExportable = (await listMemory({ cwd })).filter((item) => item.visibility === "private" && item.exportable);
+    checks.push(privateExportable.length > 0
+        ? check("Private exportable memory", "warn", `${privateExportable.length} private item(s) are exportable.`)
+        : check("Private exportable memory", "ok", "No private exportable memory."));
+    const staleLocks = await listStaleLocks(cwd, options.staleMs ?? 30 * 60 * 1000);
+    checks.push(staleLocks.length > 0
+        ? check("Stale lock files", "fail", staleLocks.join(", "))
+        : check("Stale lock files", "ok", "No stale lock files."));
+    return {
+        ok: checks.every((item) => item.status !== "fail"),
+        checks
+    };
+}
+//# sourceMappingURL=securityDoctor.js.map

package/dist/core/securityDoctor.js.map

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

package/dist/core/skill.d.ts

@@ -0,0 +1,16 @@
+import { type SkillDocument } from "../schemas/skill.js";
+export type CreateSkillOptions = {
+    cwd?: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+    maxTokens?: number;
+    force?: boolean;
+};
+export declare function createSkill(options: CreateSkillOptions): Promise<{
+    path: string;
+    name: string;
+}>;
+export declare function readSkill(cwd: string, name: string): Promise<SkillDocument>;
+export declare function showSkill(cwd: string, name: string): Promise<string>;
+export declare function listSkills(cwd?: string): Promise<SkillDocument[]>;

package/dist/core/skill.js

@@ -0,0 +1,81 @@
+import { BriefOpsError } from "./errors.js";
+import { normalizeName, skillFilePath, workspacePaths } from "./paths.js";
+import { listFilesBySuffix, parseMarkdownWithFrontmatter, readTextFile, stringifyMarkdownWithFrontmatter, writeTextFile } from "./storage.js";
+import { requireWorkspace } from "./workspace.js";
+import { skillFrontmatterSchema } from "../schemas/skill.js";
+export async function createSkill(options) {
+    const cwd = options.cwd ?? process.cwd();
+    await requireWorkspace(cwd);
+    const name = normalizeName(options.name);
+    const filePath = skillFilePath(cwd, name);
+    const data = skillFrontmatterSchema.parse({
+        name,
+        version: "0.1.0",
+        description: options.description ?? "",
+        max_tokens: options.maxTokens ?? 700,
+        tags: options.tags ?? []
+    });
+    const body = [
+        `# Skill: ${name}`,
+        "",
+        "## Purpose",
+        "",
+        options.description || "Describe when and how this skill should be used.",
+        "",
+        "## Check",
+        "",
+        "- Add concrete checks this skill should perform.",
+        "",
+        "## Reject if",
+        "",
+        "- Add conditions that should block the work.",
+        "",
+        "## Output",
+        "",
+        "1. Summary",
+        "2. Findings or implementation notes",
+        "3. Required fixes",
+        "4. Verification performed"
+    ].join("\n");
+    await writeTextFile(filePath, stringifyMarkdownWithFrontmatter(data, body), {
+        force: options.force
+    });
+    return { path: filePath, name };
+}
+export async function readSkill(cwd, name) {
+    await requireWorkspace(cwd);
+    const normalized = normalizeName(name);
+    const filePath = skillFilePath(cwd, normalized);
+    try {
+        const raw = await readTextFile(filePath);
+        return parseMarkdownWithFrontmatter(raw, skillFrontmatterSchema, filePath);
+    }
+    catch (error) {
+        if (error instanceof BriefOpsError && error.message.startsWith("File not found")) {
+            throw new BriefOpsError(`Skill not found: ${normalized}`);
+        }
+        throw error;
+    }
+}
+export async function showSkill(cwd, name) {
+    await requireWorkspace(cwd);
+    const normalized = normalizeName(name);
+    try {
+        return await readTextFile(skillFilePath(cwd, normalized));
+    }
+    catch (error) {
+        if (error instanceof BriefOpsError && error.message.startsWith("File not found")) {
+            throw new BriefOpsError(`Skill not found: ${normalized}`);
+        }
+        throw error;
+    }
+}
+export async function listSkills(cwd = process.cwd()) {
+    await requireWorkspace(cwd);
+    const files = await listFilesBySuffix(workspacePaths(cwd).skills, ".skill.md");
+    return Promise.all(files.map(async (filePath) => {
+        const raw = await readTextFile(filePath);
+        return parseMarkdownWithFrontmatter(raw, skillFrontmatterSchema, filePath);
+    }));
+}
+//# sourceMappingURL=skill.js.map

package/dist/core/skill.js.map

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

package/dist/core/storage.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare function pathExists(filePath: string): Promise<boolean>;
+export declare function ensureDirectory(dirPath: string): Promise<void>;
+export declare function writeFileIfAbsent(filePath: string, content: string): Promise<boolean>;
+export declare function writeTextFile(filePath: string, content: string, options?: {
+    force?: boolean;
+}): Promise<void>;
+export declare function writeTextFileAtomic(filePath: string, content: string): Promise<void>;
+export declare function readTextFile(filePath: string): Promise<string>;
+export declare function readYamlFile<TSchema extends z.ZodTypeAny>(filePath: string, schema: TSchema, fallback: z.input<TSchema>): Promise<z.output<TSchema>>;
+export declare function writeYamlFile(filePath: string, value: unknown): Promise<void>;
+export declare function writeYamlFileAtomic(filePath: string, value: unknown): Promise<void>;
+export declare function stringifyMarkdownWithFrontmatter(data: unknown, body: string): string;
+export declare function parseMarkdownWithFrontmatter<TSchema extends z.ZodTypeAny>(raw: string, schema: TSchema, sourceName: string): {
+    data: z.output<TSchema>;
+    body: string;
+    raw: string;
+};
+export declare function listFilesBySuffix(dirPath: string, suffix: string): Promise<string[]>;
+export declare function parseCommaList(value?: string): string[];

package/dist/core/storage.js

@@ -0,0 +1,112 @@
+import { promises as fs } from "node:fs";
+import { randomBytes } from "node:crypto";
+import path from "node:path";
+import YAML from "yaml";
+import { BriefOpsError } from "./errors.js";
+export async function pathExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function ensureDirectory(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+export async function writeFileIfAbsent(filePath, content) {
+    if (await pathExists(filePath)) {
+        return false;
+    }
+    await ensureDirectory(path.dirname(filePath));
+    await fs.writeFile(filePath, content, "utf8");
+    return true;
+}
+export async function writeTextFile(filePath, content, options = {}) {
+    if (!options.force && (await pathExists(filePath))) {
+        throw new BriefOpsError(`File already exists: ${filePath}`);
+    }
+    await ensureDirectory(path.dirname(filePath));
+    await writeTextFileAtomic(filePath, content);
+}
+export async function writeTextFileAtomic(filePath, content) {
+    await ensureDirectory(path.dirname(filePath));
+    const tempPath = path.join(path.dirname(filePath), `.tmp-${path.basename(filePath)}-${process.pid}-${randomBytes(4).toString("hex")}`);
+    try {
+        await fs.writeFile(tempPath, content, "utf8");
+        await fs.rename(tempPath, filePath);
+    }
+    catch (error) {
+        await fs.unlink(tempPath).catch(() => undefined);
+        throw error;
+    }
+}
+export async function readTextFile(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            throw new BriefOpsError(`File not found: ${filePath}`);
+        }
+        throw error;
+    }
+}
+export async function readYamlFile(filePath, schema, fallback) {
+    if (!(await pathExists(filePath))) {
+        return schema.parse(fallback);
+    }
+    const raw = await readTextFile(filePath);
+    const parsed = YAML.parse(raw) ?? fallback;
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+        throw new BriefOpsError(`Invalid YAML in ${filePath}: ${result.error.message}`);
+    }
+    return result.data;
+}
+export async function writeYamlFile(filePath, value) {
+    await writeYamlFileAtomic(filePath, value);
+}
+export async function writeYamlFileAtomic(filePath, value) {
+    await writeTextFileAtomic(filePath, `${YAML.stringify(value).trim()}\n`);
+}
+export function stringifyMarkdownWithFrontmatter(data, body) {
+    return `---\n${YAML.stringify(data).trim()}\n---\n\n${body.trim()}\n`;
+}
+export function parseMarkdownWithFrontmatter(raw, schema, sourceName) {
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match) {
+        throw new BriefOpsError(`Missing frontmatter in ${sourceName}`);
+    }
+    const parsed = YAML.parse(match[1] ?? "") ?? {};
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+        throw new BriefOpsError(`Invalid frontmatter in ${sourceName}: ${result.error.message}`);
+    }
+    return {
+        data: result.data,
+        body: (match[2] ?? "").trim(),
+        raw
+    };
+}
+export async function listFilesBySuffix(dirPath, suffix) {
+    if (!(await pathExists(dirPath))) {
+        return [];
+    }
+    const entries = await fs.readdir(dirPath);
+    return entries
+        .filter((entry) => entry.endsWith(suffix))
+        .sort()
+        .map((entry) => path.join(dirPath, entry));
+}
+export function parseCommaList(value) {
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=storage.js.map

package/dist/core/storage.js.map

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

package/dist/core/tokens.d.ts

@@ -0,0 +1,5 @@
+export declare function estimateTokens(value: string): number;
+export declare function truncateToTokenBudget(value: string, maxTokens: number): {
+    text: string;
+    trimmed: boolean;
+};

package/dist/core/tokens.js

@@ -0,0 +1,24 @@
+export function estimateTokens(value) {
+    if (value.length === 0) {
+        return 0;
+    }
+    return Math.ceil(value.length / 4);
+}
+export function truncateToTokenBudget(value, maxTokens) {
+    if (maxTokens <= 0) {
+        return { text: "", trimmed: value.length > 0 };
+    }
+    if (estimateTokens(value) <= maxTokens) {
+        return { text: value, trimmed: false };
+    }
+    const suffix = "\n\n[Trimmed to fit token budget.]";
+    const maxChars = Math.max(1, maxTokens * 4 - suffix.length);
+    const slice = value.slice(0, maxChars);
+    const boundary = slice.lastIndexOf("\n") > 80 ? slice.lastIndexOf("\n") : slice.lastIndexOf(" ");
+    const trimmed = slice.slice(0, boundary > 40 ? boundary : maxChars).trimEnd();
+    return {
+        text: `${trimmed}${suffix}`,
+        trimmed: true
+    };
+}
+//# sourceMappingURL=tokens.js.map

package/dist/core/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/core/tokens.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,SAAiB;IAEjB,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAG,oCAAoC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjG,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;IAE9E,OAAO;QACL,IAAI,EAAE,GAAG,OAAO,GAAG,MAAM,EAAE;QAC3B,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/core/worker.d.ts

@@ -0,0 +1,51 @@
+import { type WorkerProfile } from "../schemas/worker.js";
+export type CreateWorkerOptions = {
+    cwd?: string;
+    name: string;
+    description?: string;
+    project?: string;
+    skills?: string[] | string;
+    style?: string[] | string;
+    maxTokens?: number;
+    force?: boolean;
+};
+export type ListWorkerFilters = {
+    cwd?: string;
+    status?: string;
+};
+export declare function createWorker(options: CreateWorkerOptions): Promise<{
+    path: string;
+    worker: WorkerProfile;
+}>;
+export declare function readWorker(cwd: string, name: string): Promise<WorkerProfile>;
+export declare function showWorker(cwd: string, name: string): Promise<string>;
+export declare function listWorkers(filters?: ListWorkerFilters): Promise<WorkerProfile[]>;
+export declare function summarizeWorker(cwd: string, name: string, limit?: number): Promise<string>;
+export declare function refreshWorkerSummary(options: {
+    cwd?: string;
+    name: string;
+    limit?: number;
+}): Promise<{
+    path: string;
+    content: string;
+    tokens: number;
+}>;
+export declare function refreshWorkerSummaryUnlocked(options: {
+    cwd?: string;
+    name: string;
+    limit?: number;
+}): Promise<{
+    path: string;
+    content: string;
+    tokens: number;
+}>;
+export declare function generateWorkerIntelligence(options: {
+    cwd?: string;
+    name: string;
+    budget?: number;
+}): Promise<{
+    content: string;
+    tokens: number;
+}>;
+export declare function readWorkerSummary(cwd: string, name: string): Promise<string | undefined>;
+export declare function formatWorkerForBrief(cwd: string, name: string): Promise<string>;