@davesheffer/hunch 1.43.0 → 1.45.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -16
- package/dist/cli/index.js +267 -89
- package/dist/core/agenthook.d.ts +1 -0
- package/dist/core/agenthook.js +11 -0
- package/dist/core/changeProof.js +2 -1
- package/dist/core/commitrepair.d.ts +9 -3
- package/dist/core/commitrepair.js +23 -6
- package/dist/core/correction.d.ts +1 -1
- package/dist/core/correction.js +4 -3
- package/dist/core/docanchors.d.ts +11 -2
- package/dist/core/docanchors.js +232 -65
- package/dist/core/drift.d.ts +1 -1
- package/dist/core/drift.js +10 -3
- package/dist/core/eol.d.ts +2 -0
- package/dist/core/eol.js +6 -0
- package/dist/core/escalations.d.ts +20 -0
- package/dist/core/escalations.js +47 -0
- package/dist/core/hookText.js +1 -1
- package/dist/core/procstart.d.ts +15 -4
- package/dist/core/procstart.js +56 -18
- package/dist/core/runbookDraft.d.ts +7 -0
- package/dist/core/runbookDraft.js +43 -0
- package/dist/core/taskTouched.d.ts +2 -0
- package/dist/core/taskTouched.js +1 -1
- package/dist/extractors/git.d.ts +36 -6
- package/dist/extractors/git.js +86 -9
- package/dist/extractors/indexer.js +53 -14
- package/dist/extractors/k8sManifest.d.ts +31 -1
- package/dist/extractors/k8sManifest.js +133 -8
- package/dist/integrations/claudemd.d.ts +2 -0
- package/dist/integrations/claudemd.js +5 -3
- package/dist/integrations/gitignore.d.ts +23 -0
- package/dist/integrations/gitignore.js +48 -0
- package/dist/integrations/hooks.d.ts +15 -0
- package/dist/integrations/hooks.js +49 -1
- package/dist/integrations/mergeDriver.d.ts +2 -0
- package/dist/integrations/mergeDriver.js +2 -2
- package/dist/integrations/providers.d.ts +16 -0
- package/dist/integrations/providers.js +35 -6
- package/dist/integrations/scaffold.d.ts +5 -0
- package/dist/integrations/scaffold.js +13 -8
- package/dist/integrations/uninstall.d.ts +40 -0
- package/dist/integrations/uninstall.js +435 -0
- package/dist/mcp/leanToolList.d.ts +9 -0
- package/dist/mcp/leanToolList.js +89 -0
- package/dist/mcp/server.d.ts +2 -1
- package/dist/mcp/server.js +62 -6
- package/dist/serve/mcpHttp.js +2 -0
- package/dist/serve/writelock.d.ts +7 -0
- package/dist/serve/writelock.js +30 -3
- package/dist/store/changeLedger.d.ts +5 -2
- package/dist/store/changeLedger.js +88 -37
- package/dist/store/hunchStore.js +4 -1
- package/package.json +3 -6
- package/server.json +2 -2
- package/tooling/md1-benchmark.mjs +1 -1
- package/tooling/competitive-watch.mjs +0 -142
package/README.md
CHANGED
|
@@ -106,6 +106,16 @@ hunch integrations check --harness codex --require context
|
|
|
106
106
|
|
|
107
107
|
The first command checks configuration. The probe starts a fresh MCP process and reads memory. The context check requires observed hook delivery on the expected version, so run it after the new assistant session begins. `--require` fails when the named capability is not verified; none of these checks proves that a model followed the advice.
|
|
108
108
|
|
|
109
|
+
## Remove Hunch from a repository
|
|
110
|
+
|
|
111
|
+
```bash
|
|
112
|
+
hunch uninstall --dry-run # show what would change
|
|
113
|
+
hunch uninstall # remove what Hunch installed; keep .hunch/ (your memory)
|
|
114
|
+
hunch uninstall --purge # also delete .hunch/, the derived cache and Hunch's .gitignore blocks
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
It removes the instruction blocks, MCP entries, agent and git hooks, merge driver, slash commands and CI workflow that Hunch installed, and leaves your own content in those files alone. If a file it needs to edit can't be parsed, it changes nothing and says which file. It writes `.hunch-removed`: while that file exists, no Hunch command sets Hunch up here again. Commit it so every clone stays opted out; to reinstall, delete it and run `hunch init`. Close running `hunch mcp` / `hunch serve` processes first, so they can't recreate files.
|
|
118
|
+
|
|
109
119
|
## See what Hunch contributed
|
|
110
120
|
|
|
111
121
|
Task reports answer: what memory reached this task, what did the agent say it used, and what checks actually ran?
|
|
@@ -117,7 +127,7 @@ hunch task list
|
|
|
117
127
|
hunch report <task-id> --html
|
|
118
128
|
```
|
|
119
129
|
|
|
120
|
-
A delivered lesson, an agent's claim, and a passing test are different evidence. Hunch keeps them separate. Automatic presentation depends on the host following the task lifecycle; missing evidence stays unverified.
|
|
130
|
+
A delivered lesson, an agent's claim, and a passing test are different evidence. Hunch keeps them separate. Automatic presentation depends on the host following the task lifecycle; missing evidence stays unverified.
|
|
121
131
|
|
|
122
132
|
## Share one living repository memory with your team
|
|
123
133
|
|
|
@@ -142,19 +152,19 @@ Hunch ships `hunch serve`: a self-hosted HTTP service for organization, team, us
|
|
|
142
152
|
|
|
143
153
|
Open `/operator` on your server to inspect current records, completed work and commitments in a read-only browser view. Writer-supplied citations can point to an exact summary field or text passage and its recorded sources. They show traceability; they do not prove that a source supports a claim.
|
|
144
154
|
|
|
145
|
-
Agents can use the same contract through MCP, `hunch state read|write|records|subscribe`, the `@davesheffer/hunch/state` TypeScript client, or the
|
|
155
|
+
Agents can use the same contract through MCP, `hunch state read|write|records|subscribe`, the `@davesheffer/hunch/state` TypeScript client, or the Python client. The Python package is built and tested from this repository; it is not yet published to PyPI. Scoped conventions let a person record sourced user, team or organization preferences. Those preferences remain advisory and do not silently become blocking rules.
|
|
146
156
|
|
|
147
157
|
Records can describe decisions, action outcomes, commitments, entities, relationships, and summaries that name their dependencies. Actions retain their status, including unknown or unverified outcomes. Repeated writes have stable identities, conflicting current decisions are refused, and confirmed human records receive protections against agent overwrites. These are defined checks on structured records; Hunch cannot establish every fact in the outside world on its own.
|
|
148
158
|
|
|
149
159
|
This is what **deterministic state** means here: explicit rules govern the stored record, rather than having each agent reconstruct it from scratch. Git holds the durable data; SQLite is a rebuildable index. The server binds to loopback and requires deployment and agent integration by its operator. Hunch does not provide a managed CRM or email connector service.
|
|
150
160
|
|
|
151
|
-
|
|
161
|
+
See the [full documentation](https://www.hunchmemory.com/docs).
|
|
152
162
|
|
|
153
163
|
### The vision, and what is still being tested
|
|
154
164
|
|
|
155
165
|
The vision is continuity across people, tools, and agents: an operations agent records a customer issue, a coding agent finds the relevant decision and fixes the cause, and the operations agent closes the commitment using evidence of the fix.
|
|
156
166
|
|
|
157
|
-
The underlying memory and state tools ship today. The broader claim—that different agents reliably use that shared state and avoid contradictory work—is still being measured
|
|
167
|
+
The underlying memory and state tools ship today. The broader claim—that different agents reliably use that shared state and avoid contradictory work—is still being measured.
|
|
158
168
|
|
|
159
169
|
**Hunch remains the product name.** The `nuryel.state/1` protocol and `nuryel_*` tool names are existing technical identifiers; a possible future rename is undecided.
|
|
160
170
|
|
|
@@ -168,7 +178,7 @@ hunch dna context
|
|
|
168
178
|
hunch dna diff <older-ref> <newer-ref>
|
|
169
179
|
```
|
|
170
180
|
|
|
171
|
-
Profiles retain their revision, sources, confidence, and freshness.
|
|
181
|
+
Profiles retain their revision, sources, confidence, and freshness.
|
|
172
182
|
|
|
173
183
|
## Your data and your authority
|
|
174
184
|
|
|
@@ -182,18 +192,8 @@ Profiles retain their revision, sources, confidence, and freshness. [Project DNA
|
|
|
182
192
|
|
|
183
193
|
- [Full documentation](https://www.hunchmemory.com/docs)
|
|
184
194
|
- [Copy-paste cookbook](https://www.hunchmemory.com/cookbook)
|
|
185
|
-
- [
|
|
186
|
-
- [Deterministic organizational state](docs/deterministic-state.md)
|
|
187
|
-
- [Project DNA](docs/project-dna.md)
|
|
188
|
-
- [Native change proof](docs/change-proof.md)
|
|
189
|
-
- [Engineering Landscape](docs/engineering-landscape.md)
|
|
190
|
-
- [Review memory](docs/review-memory.md)
|
|
191
|
-
- [Agent-origin handling](docs/agent-origin.md)
|
|
192
|
-
- [Autonomy ladder](docs/autonomy-ladder.md)
|
|
193
|
-
- [Autonomous development](https://github.com/davesheffer/hunch-private/blob/main/projects/hunch/docs/autonomous-development.md)
|
|
194
|
-
- [Changelog](CHANGELOG.md) · [Roadmap](ROADMAP.md)
|
|
195
|
+
- [Changelog](CHANGELOG.md)
|
|
195
196
|
- [VS Code extension](vscode-extension/README.md)
|
|
196
|
-
- [Architecture benchmark](bench/architectural-conformance.md)
|
|
197
197
|
- [Contributing](CONTRIBUTING.md)
|
|
198
198
|
|
|
199
199
|
Apache-2.0
|