@davesheffer/hunch 1.18.0 → 1.18.1

package/README.md

@@ -23,6 +23,9 @@ then a deterministic check of the change against the rules your team has explici
 > relationships survive pre-render syntax without weakening fail-closed handling for ordinary
 > invalid YAML.
 
+Read the [v1.18 release story](https://hunch-pi.vercel.app/blog/post?slug=configuration-joins-the-graph)
+for the graph semantics, chart boundaries, honest limits, and Oliver Sampson's contribution.
+
 See the public [roadmap](ROADMAP.md) for what is next and what is deliberately out of scope.
 
 ## Start in five minutes
@@ -89,7 +92,7 @@ Git repo that every teammate can access, install the Matrix release on team mach
 have one maintainer run:
 
 ```bash
-npm i -g @davesheffer/hunch@1.18.0
+npm i -g @davesheffer/hunch@1.18.1
 hunch shared --repo git@github.com:acme/project-hunch-memory.git
 git add .gitignore .hunch/team.json
 git commit -m "chore: connect shared Hunch memory"
@@ -104,7 +107,7 @@ printed by Hunch. Omit `--migrate` for a new setup.
 After the pointer commit lands, teammates need Hunch installed and Git access to the memory repo:
 
 ```bash
-npm i -g @davesheffer/hunch@1.18.0
+npm i -g @davesheffer/hunch@1.18.1
 git pull
 hunch init
 hunch doctor

package/dist/extractors/adrImport.js

@@ -7,7 +7,10 @@
  *   accepted            -> status accepted (live)
  *   proposed/draft      -> status proposed
  *   rejected            -> status rejected
- *   superseded/deprecated -> status superseded, valid_to closed (bi-temporal)
+ *   superseded           -> status superseded, valid_to closed (bi-temporal)
+ *   deprecated + successor -> status superseded, closed at the successor date
+ *   deprecated, bare     -> status accepted with a loud review warning; the raw
+ *                           lifecycle remains in provenance evidence
  *   "Considered Options" minus the chosen one -> alternatives_rejected
  *   file slug           -> topic `adr.<slug>` (namespaced so an import can never
  *                          collide with a live hand-captured topic; the CLI still
@@ -102,7 +105,14 @@ function refNumbers(text) {
 }
 function mapStatus(raw) {
     const s = raw.toLowerCase();
-    if (/supersed|deprecat/.test(s))
+    // MADR permits a bare `deprecated` lifecycle with no replacement relation.
+    // Hunch has no deprecated Decision status, and inventing `superseded` would
+    // silently fabricate a history edge and remove the record from live recall.
+    // Keep it advisory/live unless an explicit successor below proves closure;
+    // provenance retains the source status and the mapper emits a warning.
+    if (/deprecat/.test(s))
+        return "accepted";
+    if (/supersed/.test(s))
         return "superseded";
     if (/reject/.test(s))
         return "rejected";
@@ -225,6 +235,9 @@ export function mapAdrCorpus(sources) {
     }
     const decisions = parsed.map((p) => {
         const successor = p.supersededByNumbers.map((n) => byNumber.get(n)).find(Boolean) ?? null;
+        if (/deprecat/i.test(p.statusRaw) && !successor) {
+            warnings.push(`${p.relPath}: deprecated status names no resolvable successor — kept in force as accepted; raw status remains in provenance evidence, review and record an explicit successor or rejection`);
+        }
         const superseded = p.status === "superseded" || !!successor;
         const validTo = superseded ? (successor?.date ?? p.date) : null;
         const alternatives = p.consideredOptions.filter((o) => !p.chosenOption || o.toLowerCase() !== p.chosenOption.toLowerCase());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@davesheffer/hunch",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "mcpName": "io.github.davesheffer/hunch",
   "license": "Apache-2.0",
   "author": "Dave Sheffer <dave.sheffer1@gmail.com>",

package/server.json

@@ -7,13 +7,13 @@
     "source": "github"
   },
   "websiteUrl": "https://hunch-pi.vercel.app",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@davesheffer/hunch",
-      "version": "1.18.0",
+      "version": "1.18.1",
       "runtimeHint": "npx",
       "packageArguments": [
         {