@davesheffer/hunch 1.31.0 → 1.32.0

package/README.md

@@ -133,6 +133,7 @@ Read the [Project DNA contract](docs/project-dna.md) and broader [Project DNA vi
 | `hunch compare branch-a branch-b` | Rank candidate changes by invariant/decision conflicts |
 | `hunch prove origin/main --public-only` | Produce a publication-safe `hunch.change-proof/1` artifact for an exact committed change |
 | `hunch landscape review` | Inspect a hash-bound repository landscape without writing authority |
+| `hunch task start "<title>"` · `hunch report <id> --html` | See what Hunch contributed to a task: the lesson recalled, the agent's stated application, whether the lesson's own rule held on the changed files, and the command Hunch observed — separate evidence grades, in a local evidence view |
 | `hunch now` | See recent memory and live decision-backed roadmap |
 | `hunch escalations` | See questions that genuinely require a human answer |
 | `hunch doctor` | Diagnose setup, provider, index or overlay problems |
@@ -207,11 +208,7 @@ Hunch Memory service into Hunch.
 
 As of 1.27.0 a fourth verb, `records`, lists a subject's records for the first writers, and the per-scope ledger compacts and merges across clones. As of 1.28.0 reads are a union across writers, a supersede target must still be open (two racing writers can no longer leave two current records), state records are searchable and delivered by subject, and subjects are keyed by the external record rather than by the agent. Proven on an emulated organization: three agents over ten clinics and a generated year of mail, chat and CRM, one organization drawer, 96 cited summaries, 24 verified receipts, 24 commitments, zero contradictions.
 
-<<<<<<< HEAD
-As of 1.30.0 subject identity is by external reference: one active entity per external record per partition, a subject written as an entity's external key refused with the entity id named, reads resolving one explicit hop — so two agents over one CRM record land on one subject. Replay determinism is a check, not a claim: `hunch serve replay --partition <kind:id>` (or `--root <dir>`) folds a partition's ledger into the state it implies and compares it hash for hash to the records on file, exits 1 on any divergence, and runs on every agent-farm run; and a human correction outranks later agent writes — a record a human confirmed is never overwritten or superseded by an agent or service principal (replay, stale-with-cause and closure by receipt are the only agent moves, each keeping the human's provenance).
-=======
-As of 1.30.0 replay determinism is a check, not a claim: `hunch serve replay --partition <kind:id>` (or `--root <dir>`) folds a partition's ledger into the state it implies and compares it hash for hash to the records on file, exits 1 on any divergence, runs inside `hunch drift` when the partition has a ledger, and runs on every agent-farm run; and a human correction outranks later agent writes — a record a human confirmed is never overwritten or superseded by an agent or service principal (replay, stale-with-cause and closure by receipt are the only agent moves, each keeping the human's provenance).
->>>>>>> feat/replay-determinism
+As of 1.30.0 subject identity is by external reference: one active entity per external record per partition, a subject written as an entity's external key refused with the entity id named, reads resolving one explicit hop — so two agents over one CRM record land on one subject. Replay determinism is a check, not a claim: `hunch serve replay --partition <kind:id>` (or `--root <dir>`) folds a partition's ledger into the state it implies and compares it hash for hash to the records on file, exits 1 on any divergence, runs inside `hunch drift` when the partition has a ledger, and runs on every agent-farm run; and a human correction outranks later agent writes — a record a human confirmed is never overwritten or superseded by an agent or service principal (replay, stale-with-cause and closure by receipt are the only agent moves, each keeping the human's provenance).
 
 Read [Deterministic organizational state](docs/deterministic-state.md), the [roadmap](ROADMAP.md) and the dated [competitive landscape](docs/competitive-landscape.md).
 
@@ -286,4 +283,4 @@ See the [changelog](CHANGELOG.md) for release detail and the [roadmap](ROADMAP.m
 - [Architecture benchmark](bench/architectural-conformance.md)
 - [Contributing](CONTRIBUTING.md)
 
-Apache-2.0
+Apache-2.0

package/dist/cli/automaticReviewMemory.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from "commander";
+import type { Constraint } from "../core/types.js";
+export interface ReviewMemoryContext {
+    root: string;
+    existing: Constraint[];
+}
+/** Only bounded tracked files inside this checkout may enter model context. */
+export declare function readReviewCode(root: string, file: string): string;
+export declare function registerAutomaticReviewMemory(command: Command, context: (repository: string, privateOnly?: boolean) => ReviewMemoryContext, capture: (records: Constraint[], repository: string, privateOnly: boolean) => void, chooseProvider?: (root: string, configFile?: string, initiator?: string) => Promise<{
+    name: string;
+    draftProse(prompt: string): Promise<string>;
+    providersUsed?: () => string[];
+}>): void;

package/dist/cli/dna.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * `hunch` CLI (DESIGN.md §6). Subcommands:
+ *   init      scaffold .hunch/, install hook, write .mcp.json + CLAUDE.md + slash cmds
+ *   index     parse repo -> symbol/dependency graph + components (no LLM)
+ *   backfill  replay git history -> seed decisions (cold-start fix)
+ *   sync      commit diff -> Claude/heuristic -> decision write-back (post-commit hook)
+ *   query     FTS + graph query over Hunch
+ *   why       decisions/bugs/constraints explaining a file/symbol
+ *   fragile   ranked fragility report with evidence
+ *   record-bug  capture a Bug from a (failing) test
+ *   test      run the suite, auto-capture failures as Bugs, resolve fixed ones
+ *   mcp       start the MCP server (Claude Code connects here)
+ *   doctor    environment diagnostics
+ */
+import "./preflight.js";