briefops 1.1.0 → 2.1.1

package/dist/schemas/memoryProposal.d.ts

@@ -9,6 +9,25 @@ export declare const memoryProposalEntrySchema: z.ZodEffects<z.ZodObject<{
     tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     visibility: z.ZodDefault<z.ZodEnum<["private", "shared", "public"]>>;
     exportable: z.ZodDefault<z.ZodBoolean>;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        start_line: z.ZodOptional<z.ZodNumber>;
+        end_line: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        start_line?: number | undefined;
+        end_line?: number | undefined;
+        sha256?: string | undefined;
+        note?: string | undefined;
+    }, {
+        path: string;
+        start_line?: number | undefined;
+        end_line?: number | undefined;
+        sha256?: string | undefined;
+        note?: string | undefined;
+    }>, "many">>;
     rationale: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "deprecated" | "fact" | "decision" | "lesson" | "incident";
@@ -17,6 +36,13 @@ export declare const memoryProposalEntrySchema: z.ZodEffects<z.ZodObject<{
     tags: string[];
     visibility: "private" | "shared" | "public";
     exportable: boolean;
+    evidence: {
+        path: string;
+        start_line?: number | undefined;
+        end_line?: number | undefined;
+        sha256?: string | undefined;
+        note?: string | undefined;
+    }[];
     rationale: string;
     source?: string | undefined;
     category?: "facts" | "decisions" | "lessons" | "incidents" | "deprecated" | undefined;
@@ -28,6 +54,13 @@ export declare const memoryProposalEntrySchema: z.ZodEffects<z.ZodObject<{
     tags?: string[] | undefined;
     visibility?: "private" | "shared" | "public" | undefined;
     exportable?: boolean | undefined;
+    evidence?: {
+        path: string;
+        start_line?: number | undefined;
+        end_line?: number | undefined;
+        sha256?: string | undefined;
+        note?: string | undefined;
+    }[] | undefined;
     category?: "facts" | "decisions" | "lessons" | "incidents" | "deprecated" | undefined;
     rationale?: string | undefined;
 }>, {
@@ -38,6 +71,13 @@ export declare const memoryProposalEntrySchema: z.ZodEffects<z.ZodObject<{
     tags: string[];
     visibility: "private" | "shared" | "public";
     exportable: boolean;
+    evidence: {
+        path: string;
+        start_line?: number | undefined;
+        end_line?: number | undefined;
+        sha256?: string | undefined;
+        note?: string | undefined;
+    }[];
     rationale: string;
     source?: string | undefined;
 }, {
@@ -48,6 +88,13 @@ export declare const memoryProposalEntrySchema: z.ZodEffects<z.ZodObject<{
     tags?: string[] | undefined;
     visibility?: "private" | "shared" | "public" | undefined;
     exportable?: boolean | undefined;
+    evidence?: {
+        path: string;
+        start_line?: number | undefined;
+        end_line?: number | undefined;
+        sha256?: string | undefined;
+        note?: string | undefined;
+    }[] | undefined;
     category?: "facts" | "decisions" | "lessons" | "incidents" | "deprecated" | undefined;
     rationale?: string | undefined;
 }>;
@@ -68,6 +115,25 @@ export declare const memoryProposalSchema: z.ZodEffects<z.ZodObject<{
         tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         visibility: z.ZodDefault<z.ZodEnum<["private", "shared", "public"]>>;
         exportable: z.ZodDefault<z.ZodBoolean>;
+        evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            start_line: z.ZodOptional<z.ZodNumber>;
+            end_line: z.ZodOptional<z.ZodNumber>;
+            sha256: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            sha256?: string | undefined;
+            note?: string | undefined;
+        }, {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            sha256?: string | undefined;
+            note?: string | undefined;
+        }>, "many">>;
         rationale: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         type: "deprecated" | "fact" | "decision" | "lesson" | "incident";
@@ -76,6 +142,13 @@ export declare const memoryProposalSchema: z.ZodEffects<z.ZodObject<{
         tags: string[];
         visibility: "private" | "shared" | "public";
         exportable: boolean;
+        evidence: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            sha256?: string | undefined;
+            note?: string | undefined;
+        }[];
         rationale: string;
         source?: string | undefined;
         category?: "facts" | "decisions" | "lessons" | "incidents" | "deprecated" | undefined;
@@ -87,6 +160,13 @@ export declare const memoryProposalSchema: z.ZodEffects<z.ZodObject<{
         tags?: string[] | undefined;
         visibility?: "private" | "shared" | "public" | undefined;
         exportable?: boolean | undefined;
+        evidence?: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            sha256?: string | undefined;
+            note?: string | undefined;
+        }[] | undefined;
         category?: "facts" | "decisions" | "lessons" | "incidents" | "deprecated" | undefined;
         rationale?: string | undefined;
     }>, {
@@ -97,6 +177,13 @@ export declare const memoryProposalSchema: z.ZodEffects<z.ZodObject<{
         tags: string[];
         visibility: "private" | "shared" | "public";
         exportable: boolean;
+        evidence: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            sha256?: string | undefined;
+            note?: string | undefined;
+        }[];
         rationale: string;
         source?: string | undefined;
     }, {
@@ -107,6 +194,13 @@ export declare const memoryProposalSchema: z.ZodEffects<z.ZodObject<{
         tags?: string[] | undefined;
         visibility?: "private" | "shared" | "public" | undefined;
         exportable?: boolean | undefined;
+        evidence?: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            sha256?: string | undefined;
+            note?: string | undefined;
+        }[] | undefined;
         category?: "facts" | "decisions" | "lessons" | "incidents" | "deprecated" | undefined;
         rationale?: string | undefined;
     }>, "many">>;
@@ -124,6 +218,13 @@ export declare const memoryProposalSchema: z.ZodEffects<z.ZodObject<{
         tags: string[];
         visibility: "private" | "shared" | "public";
         exportable: boolean;
+        evidence: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            sha256?: string | undefined;
+            note?: string | undefined;
+        }[];
         rationale: string;
         source?: string | undefined;
     }[];
@@ -149,6 +250,13 @@ export declare const memoryProposalSchema: z.ZodEffects<z.ZodObject<{
         tags?: string[] | undefined;
         visibility?: "private" | "shared" | "public" | undefined;
         exportable?: boolean | undefined;
+        evidence?: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            sha256?: string | undefined;
+            note?: string | undefined;
+        }[] | undefined;
         category?: "facts" | "decisions" | "lessons" | "incidents" | "deprecated" | undefined;
         rationale?: string | undefined;
     }[] | undefined;
@@ -166,6 +274,13 @@ export declare const memoryProposalSchema: z.ZodEffects<z.ZodObject<{
         tags: string[];
         visibility: "private" | "shared" | "public";
         exportable: boolean;
+        evidence: {
+            path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+            sha256?: string | undefined;
+            note?: string | undefined;
+        }[];
         rationale: string;
         source?: string | undefined;
     }[];

package/dist/schemas/memoryProposal.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { memoryCategories } from "../core/paths.js";
-import { memoryItemTypes, memoryStatuses, memoryVisibilities } from "./memory.js";
+import { memoryEvidenceSchema, memoryItemTypes, memoryStatuses, memoryVisibilities } from "./memory.js";
 export const memoryProposalStatuses = ["proposed", "applied", "rejected"];
 export const memoryProposalEntrySchema = z.object({
     category: z.enum(memoryCategories).optional(),
@@ -11,6 +11,7 @@ export const memoryProposalEntrySchema = z.object({
     tags: z.array(z.string()).default([]),
     visibility: z.enum(memoryVisibilities).default("private"),
     exportable: z.boolean().default(false),
+    evidence: z.array(memoryEvidenceSchema).default([]),
     rationale: z.string().default("")
 }).transform((entry) => ({
     ...entry,

package/dist/schemas/memoryProposal.js.map

@@ -1 +1 @@
-{"version":3,"file":"memoryProposal.js","sourceRoot":"","sources":["../../src/schemas/memoryProposal.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memoryProposal.js","sourceRoot":"","sources":["../../src/schemas/memoryProposal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAEnF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACzD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAClC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvB,GAAG,KAAK;IACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAK;QAC3B,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,WAAW;QACrB,UAAU,EAAE,YAAY;KACf,CAAC,KAAK,CAAC,IAAI,CAAC;CACxB,CAAC,CAAC,CAAC;AAEJ,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;IACzD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,EAAE,uBAAuB,CAAC,CAAC"}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const briefopsVersion = "1.1.0";
+export declare const briefopsVersion = "2.1.1";

package/dist/version.js

@@ -1,3 +1,3 @@
 // Keep this version in sync with package.json.
-export const briefopsVersion = "1.1.0";
+export const briefopsVersion = "2.1.1";
 //# sourceMappingURL=version.js.map

package/docs/codex-resume.md

@@ -12,4 +12,4 @@ Shared-only resume output includes selected shared/exportable memory and omits p
 
 The generated prompt includes continuity rules, evidence gates, a completion signal, and after-completion logging instructions.
 
-Local-private resume output can include recent work-log lessons and decisions before they are promoted to durable memory. This keeps fresh-thread handoff usable while memory proposals remain pending for human review.
+Local-private resume output can include recent work-log lessons and decisions as immediate continuity. `briefops finish` promotes durable memory locally by default; older or review-mode pending proposals do not block fresh-thread handoff.

package/docs/compatibility.md

@@ -1,15 +1,19 @@
-# BriefOps 1.0 Compatibility Policy
+# BriefOps 2.1.1 Compatibility Policy
 
 BriefOps follows semantic versioning for the public CLI and local file formats.
 
-## Stable In 1.0
+## Stable In 2.1.x
 
 - Public commands documented in `README.md`.
 - `.briefops/` source file formats documented in `docs/file-format.md`.
 - `shared-only` and `local-private` export policy names.
-- Human-approved memory proposal and skill patch flow.
+- Directory-local memory promotion from `finish`, plus reviewable memory proposal and skill patch flows.
 - Workspace lock behavior for local write operations.
 - Harness router export targets: `agents-md`, `claude-md`, `cursor-rules`, and `all`.
+- Master Harness routing commands: `briefops harness route` and `briefops harness matrix`.
+- Read-only continuity observability through `briefops obs continuity`.
+- Strict local release-readiness aggregation through `briefops doctor --strict`.
+- Optional memory evidence anchors with safe defaults for older memory files.
 
 ## Compatible Changes
 
@@ -28,14 +32,14 @@ Breaking changes require a new major version. Examples:
 - Removing or renaming stable CLI commands or flags.
 - Changing required fields in documented `.briefops/` source formats.
 - Changing `shared-only` so it includes private local content or private metadata counts.
-- Auto-applying memory proposals or skill patches.
+- Auto-applying skill patches or exporting private memory outside the workspace.
 - Requiring a hosted service, network dependency, agent runtime, MCP server, vector database, or cloud sync.
 
 ## Workspace Version Support
 
 New 1.0 workspaces write `version: 1.0.0` in `.briefops/config.yaml`.
 
-BriefOps 1.0 can read legacy `0.x` workspace configs on a best-effort compatibility basis. Future `2.x` workspace configs fail with an explicit upgrade error instead of silently reading incompatible data.
+BriefOps 2.1.1 keeps the workspace schema at `1.0.0` and can read legacy `0.x` workspace configs on a best-effort compatibility basis. Future unsupported workspace schema major versions fail with an explicit upgrade error instead of silently reading incompatible data.
 
 ## Migration Policy
 
@@ -45,5 +49,5 @@ If a future release needs a migration, it must provide:
 
 - a documented command or manual procedure,
 - dry-run or inspection guidance,
-- no automatic approval of memory or skill patches,
+- no automatic skill patch application,
 - tests covering old fixtures.

package/docs/concept.md

@@ -7,7 +7,7 @@ It does not run Codex, Claude Code, or other agents. It prepares compact continu
 The core loop is:
 
 ```text
-brief -> work -> log -> proposal -> approved memory -> worker summary -> handoff/resume
+brief -> work -> log -> proposal audit -> local memory -> worker summary -> handoff/resume
 ```
 
-Raw logs remain audit records and immediate handoff input. Memory is curated operational knowledge that requires human approval.
+Raw logs remain audit records and immediate handoff input. Memory is curated operational knowledge stored inside the current repository's `.briefops/` directory.

package/docs/file-format.md

@@ -32,7 +32,8 @@ BriefOps stores all user data under `.briefops/`. Version 1.0 treats these files
 
 - `.briefops/memory/<category>.yaml`
   - Shape: `items: MemoryItem[]`.
-  - Stable item fields: `id`, `type`, `status`, `project`, `skill`, `content`, `source`, `created_at`, `tags`, `visibility`, `exportable`.
+  - Stable item fields: `id`, `type`, `status`, `project`, `skill`, `content`, `source`, `created_at`, `tags`, `visibility`, `exportable`, `evidence`.
+  - `evidence` is an optional array of path anchors with stable fields: `path`, `start_line`, `end_line`, `sha256`, `note`.
   - Supported statuses: `active`, `stale`, `deprecated`, `superseded`, `archived`.
   - Supported visibility values: `private`, `shared`, `public`.
 
@@ -46,6 +47,7 @@ BriefOps stores all user data under `.briefops/`. Version 1.0 treats these files
   - Stable fields: `id`, `created_at`, `from_log`, `status`, `project`, `skill`, `worker`, `items`, `applied_at`, `rejected_at`.
   - Legacy `proposals` arrays remain readable and are normalized to `items`.
   - Proposal entries use memory item fields plus `category` and `rationale`.
+  - Proposal entries may carry `evidence` anchors copied from changed-file paths in the source work log.
 
 - `.briefops/patches/*.patch.yaml`
   - Stable fields: `id`, `created_at`, `skill`, `from_log`, `status`, `target_section`, `lessons`, `additions`, `applied_at`, `rejected_at`.

package/docs/handoff-briefs.md

@@ -8,4 +8,4 @@ briefops handoff generate --worker quant-reviewer --task "Continue rebalance rev
 
 A handoff includes project context, worker summary, recent work, active decisions, lessons, incidents, deprecated notes when relevant, a recommended start, after-completion commands, and token accounting.
 
-Recent work is immediate continuity, not durable memory approval. Local handoffs include work-log results, lessons, decisions, open risks, incidents, and next steps even when the related memory proposal is still pending. Shared-only handoffs continue to omit raw work logs and private continuity details.
+Recent work is immediate continuity. Local handoffs include work-log results, lessons, decisions, open risks, incidents, and next steps even when an older or review-mode memory proposal is still pending. Shared-only handoffs continue to omit raw work logs and private continuity details.

package/docs/impact-report.md

@@ -0,0 +1,140 @@
+# BriefOps Impact Report v0
+
+Use this template to record whether BriefOps impact is measured, estimated, or
+unmeasured for one project task or reporting period. Keep the field names stable.
+
+## Report Values
+
+project:
+task_or_period:
+briefops_adoption_point:
+token_usage_status: unmeasured
+input_tokens:
+output_tokens:
+total_tokens:
+context_baseline:
+context_used:
+context_reduction_estimate:
+artifact_coverage:
+handoff_status:
+validation_status:
+conclusion: unmeasured
+
+## Field Definitions
+
+`project`: Project, repository, workspace, or product area being reported.
+
+`task_or_period`: The task, milestone, sprint, date range, or release covered by
+this report. Use one report per task or period.
+
+`briefops_adoption_point`: Where BriefOps entered the workflow, such as before
+planning, before implementation, during handoff, or after validation.
+
+`token_usage_status`: Evidence level for token usage values. Allowed values:
+`measured`, `estimated`, `unmeasured`.
+
+`input_tokens`: Input token count for the covered task or period. Leave blank or
+write `unmeasured` when no credible value exists.
+
+`output_tokens`: Output token count for the covered task or period. Leave blank
+or write `unmeasured` when no credible value exists.
+
+`total_tokens`: Input plus output tokens for the covered task or period. Leave
+blank or write `unmeasured` when no credible value exists.
+
+`context_baseline`: The size of the context that would otherwise have been used,
+limited to the whole repo, whole document set, full history dump, or other
+bounded source context. Include the unit used.
+
+`context_used`: The size of the actual BriefOps brief, spec, context pack, or
+other bounded context supplied to the agent. Use the same unit as
+`context_baseline`.
+
+`context_reduction_estimate`: Estimated context reduction, calculated only from
+`context_baseline` and `context_used`.
+
+`artifact_coverage`: Existence-only coverage for these eight artifacts:
+`brief`, `spec`, `plan`, `tasks`, `validation`, `review`, `handoff`,
+`decision-log`. Record as `<present_count>/8` plus present and missing names.
+
+`handoff_status`: Handoff readiness for the covered task or period. Suggested
+values: `complete`, `partial`, `absent`, `not_applicable`.
+
+`validation_status`: Validation evidence for the covered task or period.
+Suggested values: `validated`, `partial`, `unvalidated`, `blocked`,
+`not_applicable`.
+
+`conclusion`: Overall evidence conclusion. Allowed values only: `proven`,
+`partially supported`, `unmeasured`, `not supported`.
+
+## Measurement Rules
+
+### Token Usage And Token Savings
+
+- Mark `token_usage_status` as `measured` only when actual token usage logs exist
+  for the covered task or period.
+- Mark `token_usage_status` as `estimated` only when token counts are derived
+  from a deterministic approximation, such as a tokenizer or transcript count.
+- Mark `token_usage_status` as `unmeasured` when neither actual logs nor a
+  deterministic approximation are available.
+- If actual token usage logs do not exist, token savings must be reported as
+  `unmeasured`.
+- Do not use `context_reduction_estimate` as evidence of token savings.
+- Do not combine input, output, and total tokens from different tasks, agents, or
+  reporting periods.
+
+### Context Management
+
+- Treat context management as separate from token savings.
+- Estimate context reduction only by comparing `context_baseline` with
+  `context_used`.
+- Use the same unit for `context_baseline` and `context_used`, preferably tokens.
+  Bytes, lines, files, or pages are acceptable only when both values use the same
+  unit.
+- Calculate:
+  `(context_baseline - context_used) / context_baseline`.
+- Mark `context_reduction_estimate` as `unmeasured` when either side of the
+  comparison is unavailable or uses incompatible units.
+- A context reduction estimate supports a context management claim only. It does
+  not prove token savings or quality improvement.
+
+### Artifact Coverage
+
+- Calculate `artifact_coverage` only from whether each named artifact exists.
+- Do not score artifact quality, length, freshness, or correctness in
+  `artifact_coverage`.
+- Count an artifact as present only when it is discoverable in the project files
+  or attached work record for the covered task or period.
+- If an artifact has multiple files, count the artifact type once.
+
+### Conclusion
+
+- Use `proven` only when the claimed impact is backed by direct measured
+  evidence. Token savings can be `proven` only with actual token usage logs.
+- Use `partially supported` when measured evidence is incomplete, but deterministic
+  context comparison, artifact coverage, handoff status, or validation status
+  supports a narrower BriefOps benefit.
+- Use `unmeasured` when the report records adoption but lacks enough evidence to
+  support or reject impact.
+- Use `not supported` when the available evidence contradicts the claimed impact
+  or shows no meaningful BriefOps effect.
+- If token savings are unmeasured but context management is estimated, the
+  conclusion must not imply proven token savings.
+
+## 30-Minute Fill Procedure
+
+1. Identify the project and covered task or period.
+2. Check whether actual token usage logs exist.
+3. Fill token fields as measured, estimated, or unmeasured.
+4. Compare only the bounded baseline context with the actual BriefOps context
+   used.
+5. Count the eight artifact types by existence only.
+6. Record handoff and validation status from available work records.
+7. Choose exactly one allowed conclusion without merging token savings and
+   context management evidence.
+
+## Non-Goals
+
+This template does not define automatic collection, JSON schema, dashboards,
+cross-project comparison, migration guidance, sample reports, scoring, or a full
+Spec Kit workflow.

package/docs/integrations/harnesses.md

@@ -16,10 +16,10 @@ After meaningful work:
 
 ```bash
 briefops finish --worker <worker> --task "<task>" --result "<result>"
-briefops memory proposal-show latest
-briefops approve latest
 ```
 
+`finish` applies durable directory-local memory by default. Use `--memory-review` only when a pending local queue is desired.
+
 For a fresh thread:
 
 ```bash
@@ -44,20 +44,28 @@ briefops export all
 
 These files should stay compact. They teach harnesses how to call BriefOps and do not copy private memory, raw logs, handoffs, or worker summaries.
 
+For local readiness and context compression checks:
+
+```bash
+briefops doctor --strict --json
+briefops obs continuity --worker <worker> --task "<task>" --json
+```
+
+These commands are core CLI checks. They do not install MCP servers or hooks.
+
 ## LazyCodex / OmO
 
 Use LazyCodex or OmO for orchestration, hooks, LSP/MCP, and autonomous execution. Use BriefOps for durable local continuity.
 
-Suggested human workflow:
+Suggested local workflow:
 
 ```bash
 briefops prime --task "Implement the next scoped change." --format codex --max-tokens 800
 codex "Use the BriefOps prime context, then run ultrawork for this task."
 briefops finish --worker <worker> --task "Implement the next scoped change." --result "<verified result>"
-briefops memory proposal-show latest
 ```
 
-Do not let a harness auto-run `briefops approve latest`. Approval should remain human-confirmed.
+Do not let a harness export private `.briefops/` memory or apply skill patches without explicit direction.
 
 ## Codex App And Codex CLI
 
@@ -67,7 +75,7 @@ This command does not write to global Codex folders by default.
 
 ## Claude Code
 
-BriefOps can coexist with `CLAUDE.md`. Keep `CLAUDE.md` for always-loaded project instructions and use BriefOps for task history, approved memory, handoffs, and shared-only packs.
+BriefOps can coexist with `CLAUDE.md`. Keep `CLAUDE.md` for always-loaded project instructions and use BriefOps for task history, local memory, handoffs, and shared-only packs.
 
 ## Cursor