briefops 2.0.0 → 2.1.2

package/dist/core/codexPlugin.js

@@ -26,6 +26,7 @@ export function buildCodexPluginManifest() {
             category: "Developer Tools",
             capabilities: ["Read", "Write"],
             defaultPrompt: [
+                "Route this task through the BriefOps Master Harness.",
                 "Start this task with the smallest useful BriefOps context.",
                 "Finish this task and prepare memory for the next thread."
             ],
@@ -42,10 +43,47 @@ function trustBoundaryLines() {
     return [
         "The BriefOps plugin is a local CLI helper. It does not require network access and does not publish to a marketplace.",
         "",
+        "Before any BriefOps command, run `command -v briefops`. If `briefops` is not on `PATH`, stop and report `Status: setup-required`. Do not continue by silently skipping BriefOps. Ask the user to install `briefops`, use `npx briefops@latest`, or explicitly continue from an already supplied Brief/Spec/Plan.",
+        "",
         "BriefOps may update directory-local `.briefops/` memory. Use `--export-policy shared-only` before copying context outside the local workspace, and ask before applying skill patches.",
         ""
     ];
 }
+function briefopsRouteTaskSkill() {
+    return [
+        "---",
+        "name: briefops-route-task",
+        "description: Use when starting Codex development work to classify the task and choose the smallest sufficient BriefOps Master Harness workflow",
+        "---",
+        "",
+        "# BriefOps Route Task",
+        "",
+        ...trustBoundaryLines(),
+        "Use this before implementation when the task may need memory, specification, planning, findings, verification, or handoff discipline.",
+        "",
+        "Run:",
+        "",
+        "```bash",
+        "briefops harness route --task \"<current user task>\"",
+        "```",
+        "",
+        "For explicit routing, pass a task type:",
+        "",
+        "```bash",
+        "briefops harness route --task \"<current user task>\" --type large-feature",
+        "```",
+        "",
+        "Use the route as a workflow contract:",
+        "",
+        "- Do not force full specification on tiny tasks.",
+        "- Do not skip goal ledgers, findings, visual evidence, or handoff when the route requires them.",
+        "- If repository evidence contradicts the inferred route, choose the safer route and say why.",
+        "- Treat `briefops prime` as the memory intake step and `briefops finish` as the work-log/memory closeout step.",
+        "",
+        "Supported task types: small-bug-fix, medium-feature, large-feature, refactor, dependency-upgrade, ui-change, test-repair, production-incident, documentation-task, architecture-decision, exploratory-research, code-review, release-preparation.",
+        ""
+    ].join("\n");
+}
 function briefopsPrimeContextSkill() {
     return [
         "---",
@@ -58,7 +96,13 @@ function briefopsPrimeContextSkill() {
         ...trustBoundaryLines(),
         "Use BriefOps before broad repo/history inspection when a `.briefops` workspace exists or may exist.",
         "",
-        "Run:",
+        "Run the environment gate first:",
+        "",
+        "```bash",
+        "command -v briefops",
+        "```",
+        "",
+        "If the CLI is present, run:",
         "",
         "```bash",
         "briefops prime --format codex --task \"<current user task>\" --max-tokens 800",
@@ -156,6 +200,10 @@ export function codexPluginFiles() {
             relativePath: ".codex-plugin/plugin.json",
             content: pluginManifestContent()
         },
+        {
+            relativePath: "skills/briefops-route-task/SKILL.md",
+            content: briefopsRouteTaskSkill()
+        },
         {
             relativePath: "skills/briefops-prime-context/SKILL.md",
             content: briefopsPrimeContextSkill()

package/dist/core/codexPlugin.js.map

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

package/dist/core/exportTargets.js

@@ -21,6 +21,17 @@ function policyLines(exportPolicy) {
             : "Local-private export was selected; keep this file local unless you review it before sharing."
     ];
 }
+function environmentGateLines() {
+    return [
+        "Before any BriefOps command, run the environment gate:",
+        "",
+        "```bash",
+        "command -v briefops >/dev/null 2>&1",
+        "```",
+        "",
+        "If `briefops` is not on `PATH`, stop and report `Status: setup-required`. Do not continue by silently skipping BriefOps; ask the user to install `briefops`, use `npx briefops@latest`, or explicitly continue from an already supplied Brief/Spec/Plan."
+    ];
+}
 function renderAgentsMd(options) {
     const worker = options.worker ?? "<worker>";
     return [
@@ -32,7 +43,9 @@ function renderAgentsMd(options) {
         "",
         "## Start Of Work",
         "",
-        "Before broad repo/history inspection, run:",
+        ...environmentGateLines(),
+        "",
+        "After the environment gate passes, run before broad repo/history inspection:",
         "",
         "```bash",
         `briefops prime --format codex --task ${shellValue("<current task>")} --max-tokens 800`,
@@ -88,7 +101,9 @@ function renderClaudeMd(options) {
         "",
         "## Before Starting Work",
         "",
-        "Run:",
+        ...environmentGateLines(),
+        "",
+        "After the environment gate passes, run:",
         "",
         "```bash",
         `briefops prime --format markdown --task ${shellValue("<current task>")} --max-tokens 800`,
@@ -164,7 +179,9 @@ function renderCursorRules(options) {
                 "This repository uses BriefOps for local AI coding continuity.",
                 policyNote.trim() ? policyNote.trimStart() : undefined,
                 "",
-                "Before broad repo/history inspection, run:",
+                ...environmentGateLines(),
+                "",
+                "After the environment gate passes and before broad repo/history inspection, run:",
                 "",
                 "```bash",
                 `briefops prime --format codex --task ${shellValue("<current task>")} --max-tokens 800`,

package/dist/core/exportTargets.js.map

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

package/dist/core/harness.d.ts

@@ -0,0 +1,27 @@
+export type HarnessTaskType = "small-bug-fix" | "medium-feature" | "large-feature" | "refactor" | "dependency-upgrade" | "ui-change" | "test-repair" | "production-incident" | "documentation-task" | "architecture-decision" | "exploratory-research" | "code-review" | "release-preparation";
+export type HarnessRoute = {
+    taskType: HarnessTaskType;
+    label: string;
+    spec: string;
+    plan: string;
+    goalLedger: string;
+    findings: string;
+    verification: string;
+    memoryUpdate: string;
+    artifacts: string[];
+    exitCriteria: string[];
+    finalResponse: string[];
+};
+export type HarnessRouteResult = {
+    task: string;
+    route: HarnessRoute;
+    inferred: boolean;
+    signals: string[];
+};
+export declare function harnessRoutes(): HarnessRoute[];
+export declare function normalizeHarnessTaskType(value: string): HarnessTaskType;
+export declare function routeHarnessTask(options: {
+    task: string;
+    taskType?: string;
+}): HarnessRouteResult;
+export declare function renderHarnessRoute(result: HarnessRouteResult): string;

package/dist/core/harness.js

@@ -0,0 +1,342 @@
+import { BriefOpsError } from "./errors.js";
+const routeTable = {
+    "small-bug-fix": {
+        taskType: "small-bug-fix",
+        label: "Small bug fix",
+        spec: "No",
+        plan: "Light",
+        goalLedger: "Optional",
+        findings: "Yes if debugging",
+        verification: "Level 2 targeted test",
+        memoryUpdate: "Work log",
+        artifacts: ["work log", "targeted verification evidence"],
+        exitCriteria: [
+            "Root cause or bounded symptom is understood.",
+            "Patch is scoped to the failing behavior.",
+            "Targeted verification passes or the limitation is explicit."
+        ],
+        finalResponse: ["changed behavior", "files changed", "targeted verification", "residual risk"]
+    },
+    "medium-feature": {
+        taskType: "medium-feature",
+        label: "Medium feature",
+        spec: "Light",
+        plan: "Yes",
+        goalLedger: "Yes",
+        findings: "Optional",
+        verification: "Level 2 or 3 based on surface area",
+        memoryUpdate: "Work log plus decisions",
+        artifacts: ["brief spec", "plan", "goal ledger", "verification evidence"],
+        exitCriteria: [
+            "Acceptance criteria are explicit.",
+            "Implementation follows repo conventions.",
+            "Relevant tests or checks pass."
+        ],
+        finalResponse: ["summary", "files changed", "acceptance coverage", "verification", "risks"]
+    },
+    "large-feature": {
+        taskType: "large-feature",
+        label: "Large feature",
+        spec: "Yes",
+        plan: "Yes",
+        goalLedger: "Yes",
+        findings: "Yes",
+        verification: "Level 3 full project verification",
+        memoryUpdate: "Decision, project state, handoff",
+        artifacts: ["spec", "plan", "tasks", "goal ledger", "findings log", "handoff"],
+        exitCriteria: [
+            "Spec and task decomposition exist.",
+            "All blocking findings are resolved.",
+            "Full relevant project verification has evidence."
+        ],
+        finalResponse: ["feature outcome", "files changed", "verification evidence", "open risks", "handoff"]
+    },
+    refactor: {
+        taskType: "refactor",
+        label: "Refactor",
+        spec: "No unless behavior changes",
+        plan: "Yes",
+        goalLedger: "Yes for multi-file",
+        findings: "Optional",
+        verification: "Level 3 regression verification",
+        memoryUpdate: "Work log plus decision if architecture changes",
+        artifacts: ["scope boundary", "risk notes", "goal ledger", "regression evidence"],
+        exitCriteria: [
+            "Behavior-preservation boundary is clear.",
+            "Diff is incremental and reviewable.",
+            "Regression checks cover touched behavior."
+        ],
+        finalResponse: ["refactor scope", "behavior preserved", "verification", "risks"]
+    },
+    "dependency-upgrade": {
+        taskType: "dependency-upgrade",
+        label: "Dependency upgrade",
+        spec: "No",
+        plan: "Yes",
+        goalLedger: "Yes",
+        findings: "Yes if breakage appears",
+        verification: "Level 3 full project verification",
+        memoryUpdate: "Decision plus work log",
+        artifacts: ["upgrade plan", "compatibility notes", "verification evidence"],
+        exitCriteria: [
+            "Upgrade scope and migration notes are recorded.",
+            "Lockfile/package changes are intentional.",
+            "Build, tests, and relevant runtime checks pass."
+        ],
+        finalResponse: ["dependency changes", "migration notes", "verification", "known risks"]
+    },
+    "ui-change": {
+        taskType: "ui-change",
+        label: "UI change",
+        spec: "Light",
+        plan: "Light",
+        goalLedger: "Optional",
+        findings: "Yes for visual defects",
+        verification: "Level 4 visual evidence",
+        memoryUpdate: "Work log, decision if design pattern changes",
+        artifacts: ["visual target", "screenshot or render evidence", "verification notes"],
+        exitCriteria: [
+            "UI renders in its natural environment.",
+            "Responsive or target viewport behavior is inspected.",
+            "Visual evidence backs the completion claim."
+        ],
+        finalResponse: ["UI outcome", "files changed", "visual evidence", "remaining visual risk"]
+    },
+    "test-repair": {
+        taskType: "test-repair",
+        label: "Test repair",
+        spec: "No",
+        plan: "Light",
+        goalLedger: "Optional",
+        findings: "Yes if failure cause is uncertain",
+        verification: "Level 2 targeted test",
+        memoryUpdate: "Work log",
+        artifacts: ["failure reproduction", "targeted test output"],
+        exitCriteria: [
+            "Failure is reproduced or clearly explained.",
+            "The test now asserts intended behavior.",
+            "Targeted test command passes."
+        ],
+        finalResponse: ["failure fixed", "tests changed", "verification", "risk of brittleness"]
+    },
+    "production-incident": {
+        taskType: "production-incident",
+        label: "Production incident",
+        spec: "No",
+        plan: "Incident plan",
+        goalLedger: "Yes",
+        findings: "Yes",
+        verification: "Level 4 evidence-based verification",
+        memoryUpdate: "Incident, decision, handoff",
+        artifacts: ["incident log", "findings log", "mitigation evidence", "handoff"],
+        exitCriteria: [
+            "Impact and mitigation are explicit.",
+            "Blocking findings are tracked.",
+            "Verification evidence matches the incident risk."
+        ],
+        finalResponse: ["impact", "mitigation", "verification evidence", "follow-up risks"]
+    },
+    "documentation-task": {
+        taskType: "documentation-task",
+        label: "Documentation task",
+        spec: "No",
+        plan: "No or light",
+        goalLedger: "No",
+        findings: "No",
+        verification: "Level 0 or 1 static inspection",
+        memoryUpdate: "Work log only if durable",
+        artifacts: ["doc diff", "link or render check if relevant"],
+        exitCriteria: [
+            "Docs match current behavior.",
+            "Links, examples, or commands are checked when practical."
+        ],
+        finalResponse: ["doc change", "files changed", "inspection or skipped verification reason"]
+    },
+    "architecture-decision": {
+        taskType: "architecture-decision",
+        label: "Architecture decision",
+        spec: "Yes",
+        plan: "Yes",
+        goalLedger: "Optional",
+        findings: "Research findings",
+        verification: "Level 1 source inspection",
+        memoryUpdate: "Decision plus architecture memory",
+        artifacts: ["decision record", "tradeoff table", "source evidence"],
+        exitCriteria: [
+            "Options and tradeoffs are explicit.",
+            "Decision is grounded in repo constraints.",
+            "Durable rationale is recorded."
+        ],
+        finalResponse: ["decision", "rationale", "sources", "follow-up implementation step"]
+    },
+    "exploratory-research": {
+        taskType: "exploratory-research",
+        label: "Exploratory research",
+        spec: "No",
+        plan: "Research plan",
+        goalLedger: "Optional",
+        findings: "Yes",
+        verification: "Level 1 source inspection",
+        memoryUpdate: "Findings or decision if durable",
+        artifacts: ["source notes", "findings", "recommendation"],
+        exitCriteria: [
+            "Sources are inspected directly.",
+            "Confirmed facts and interpretation are separated.",
+            "Recommendation names uncertainty."
+        ],
+        finalResponse: ["findings", "sources", "recommendation", "open questions"]
+    },
+    "code-review": {
+        taskType: "code-review",
+        label: "Code review",
+        spec: "No",
+        plan: "Review plan",
+        goalLedger: "Optional",
+        findings: "Yes",
+        verification: "Level 1 or 2 depending on reviewed change",
+        memoryUpdate: "Known issue if durable",
+        artifacts: ["findings log", "file and line evidence"],
+        exitCriteria: [
+            "Findings are actionable and severity-ordered.",
+            "No open finding is hidden in the summary.",
+            "Verification gaps are explicit."
+        ],
+        finalResponse: ["findings first", "open questions", "test gaps", "brief summary"]
+    },
+    "release-preparation": {
+        taskType: "release-preparation",
+        label: "Release preparation",
+        spec: "No",
+        plan: "Yes",
+        goalLedger: "Yes",
+        findings: "Yes",
+        verification: "Level 4 evidence-based verification",
+        memoryUpdate: "Project state plus handoff",
+        artifacts: ["release checklist", "verification evidence", "handoff"],
+        exitCriteria: [
+            "Release checklist is complete or exceptions are approved.",
+            "Build/test/audit evidence is recorded.",
+            "Remaining risks and rollback notes are clear."
+        ],
+        finalResponse: ["release readiness", "checks run", "evidence", "remaining blockers"]
+    }
+};
+const taskTypeAliases = {
+    bug: "small-bug-fix",
+    fix: "small-bug-fix",
+    "small-bug": "small-bug-fix",
+    feature: "medium-feature",
+    "medium-feature": "medium-feature",
+    "large-feature": "large-feature",
+    refactor: "refactor",
+    dependency: "dependency-upgrade",
+    deps: "dependency-upgrade",
+    "dependency-upgrade": "dependency-upgrade",
+    ui: "ui-change",
+    "ui-change": "ui-change",
+    test: "test-repair",
+    "test-repair": "test-repair",
+    incident: "production-incident",
+    "production-incident": "production-incident",
+    docs: "documentation-task",
+    documentation: "documentation-task",
+    "documentation-task": "documentation-task",
+    architecture: "architecture-decision",
+    adr: "architecture-decision",
+    "architecture-decision": "architecture-decision",
+    research: "exploratory-research",
+    "exploratory-research": "exploratory-research",
+    review: "code-review",
+    "code-review": "code-review",
+    release: "release-preparation",
+    "release-preparation": "release-preparation"
+};
+export function harnessRoutes() {
+    return Object.values(routeTable);
+}
+export function normalizeHarnessTaskType(value) {
+    const key = value.trim().toLowerCase().replace(/_/g, "-");
+    const taskType = taskTypeAliases[key];
+    if (!taskType) {
+        throw new BriefOpsError(`Unknown harness task type: ${value}`);
+    }
+    return taskType;
+}
+function matchTask(task) {
+    const text = task.toLowerCase();
+    const checks = [
+        ["production-incident", /\b(prod|production|incident|outage|rollback|hotfix|sev[0-9])\b/, "incident signal"],
+        ["release-preparation", /\b(release|ship|publish|npm pack|changelog|version bump|cut a release)\b/, "release signal"],
+        ["code-review", /\b(review|audit|pr|pull request|diff)\b/, "review signal"],
+        ["dependency-upgrade", /\b(upgrade|bump|dependency|dependencies|lockfile|package-lock|npm update|pnpm update|yarn upgrade)\b/, "dependency signal"],
+        ["ui-change", /\b(ui|visual|css|style|layout|responsive|screenshot|frontend|component)\b/, "ui signal"],
+        ["test-repair", /\b(test failure|failing test|flake|vitest|jest|pytest|unit test|integration test)\b/, "test signal"],
+        ["refactor", /\b(refactor|cleanup|restructure|rename|extract|split)\b/, "refactor signal"],
+        ["architecture-decision", /\b(architecture|adr|design decision|tradeoff|system design)\b/, "architecture signal"],
+        ["exploratory-research", /\b(research|investigate|compare|evaluate|look up|survey)\b/, "research signal"],
+        ["documentation-task", /\b(docs|documentation|readme|guide|manual)\b/, "documentation signal"],
+        ["large-feature", /\b(large feature|new module|major feature|multi-phase|end-to-end)\b/, "large feature signal"],
+        ["medium-feature", /\b(feature|add support|implement|build)\b/, "feature signal"],
+        ["small-bug-fix", /\b(bug|fix|broken|error|crash|regression)\b/, "bug signal"]
+    ];
+    for (const [taskType, pattern, signal] of checks) {
+        if (pattern.test(text)) {
+            return { taskType, signals: [signal] };
+        }
+    }
+    return { taskType: "medium-feature", signals: ["default medium-feature route"] };
+}
+export function routeHarnessTask(options) {
+    const task = options.task.trim();
+    if (!task) {
+        throw new BriefOpsError("Harness routing requires --task.");
+    }
+    if (options.taskType) {
+        const taskType = normalizeHarnessTaskType(options.taskType);
+        return {
+            task,
+            route: routeTable[taskType],
+            inferred: false,
+            signals: ["explicit task type"]
+        };
+    }
+    const matched = matchTask(task);
+    return {
+        task,
+        route: routeTable[matched.taskType],
+        inferred: true,
+        signals: matched.signals
+    };
+}
+export function renderHarnessRoute(result) {
+    return [
+        "# BriefOps Harness Route",
+        "",
+        `Task: ${result.task}`,
+        `Route: ${result.route.label}${result.inferred ? " (inferred)" : ""}`,
+        `Signals: ${result.signals.join(", ")}`,
+        "",
+        "## Workflow Depth",
+        "",
+        `- Spec: ${result.route.spec}`,
+        `- Plan: ${result.route.plan}`,
+        `- Goal ledger: ${result.route.goalLedger}`,
+        `- Findings: ${result.route.findings}`,
+        `- Verification: ${result.route.verification}`,
+        `- Memory update: ${result.route.memoryUpdate}`,
+        "",
+        "## Required Artifacts",
+        "",
+        ...result.route.artifacts.map((artifact) => `- ${artifact}`),
+        "",
+        "## Exit Criteria",
+        "",
+        ...result.route.exitCriteria.map((criterion) => `- ${criterion}`),
+        "",
+        "## Final Response Must Include",
+        "",
+        ...result.route.finalResponse.map((item) => `- ${item}`),
+        ""
+    ].join("\n");
+}
+//# sourceMappingURL=harness.js.map

package/dist/core/harness.js.map

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

package/dist/core/lock.d.ts

@@ -4,6 +4,7 @@ export type WorkspaceLockOptions = {
     timeoutMs?: number;
     staleMs?: number;
 };
+export declare function isStaleLockFile(filePath: string, staleMs: number): Promise<boolean>;
 export declare function withWorkspaceLock<T>(options: WorkspaceLockOptions, callback: () => Promise<T>): Promise<T>;
 export declare function cleanStaleLocks(options?: {
     cwd?: string;

package/dist/core/lock.js

@@ -17,7 +17,7 @@ function lockPath(cwd, name) {
 function lockDir(cwd) {
     return path.join(workspacePaths(cwd).root, ".locks");
 }
-async function isStale(filePath, staleMs) {
+export async function isStaleLockFile(filePath, staleMs) {
     if (!(await pathExists(filePath))) {
         return false;
     }
@@ -25,9 +25,23 @@ async function isStale(filePath, staleMs) {
         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;
+        if (!Number.isNaN(created)) {
+            return Date.now() - created > staleMs;
+        }
     }
     catch {
+        // Fall back to mtime below. A competing writer may have created the lock
+        // before its metadata is readable, and fresh malformed locks must not be
+        // removed while still active.
+    }
+    try {
+        const stat = await fs.stat(filePath);
+        return Date.now() - stat.mtimeMs > staleMs;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return false;
+        }
         return true;
     }
 }
@@ -52,7 +66,7 @@ async function acquireLock(options) {
             if (error.code !== "EEXIST") {
                 throw error;
             }
-            if (await isStale(filePath, options.staleMs)) {
+            if (await isStaleLockFile(filePath, options.staleMs)) {
                 await fs.unlink(filePath).catch(() => undefined);
                 continue;
             }
@@ -89,7 +103,7 @@ export async function cleanStaleLocks(options = {}) {
     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)) {
+        if (await isStaleLockFile(filePath, options.staleMs ?? defaultStaleMs)) {
             await fs.unlink(filePath).catch(() => undefined);
             removed.push(filePath);
         }