@miadi/inquiry-weave 0.6.0 → 0.6.1

package/README.md

@@ -67,7 +67,7 @@ state during a dry run. v0.4.2 restores the not-related guard on `sync --dry-run
 | `MIADI_CHRONICLE_ROOT` | — | `/srv/miadi/episodes/miadi-chronicle` |
 | `MIADI_INQUIRY_REPO` | — | `miadisabelle/Etuaptmumk-RSM` |
 | `INQUIRY_WEAVE_ISSUE_LIB` | → `/a/src/scripts/fn_github_issue.sh` → `/src/scripts/fn_github_issue.sh` | — |
-| `MW_API_URL` | — | `http://192.168.2.30:3940` |
+| `MW_API_URL` | — | `http://127.0.0.1:8040` |
 
 ## Metadata contract
 
@@ -131,10 +131,12 @@ Sync is one-way (artefact → episode): the episode copy is a snapshot, deletion
 propagate, and local edits to the copy are flagged as `episode-copy-diverged` before
 being overwritten.
 
-**Vercel API evaluation note:** `https://etuaptmumk.vercel.app/` exposes only
+**Deployment API evaluation note:** the deployment evaluated for this exposed only
 `/api/articles` and `/api/articles/seed` (which read `prototypes/artefacts` markdown into
-Redis) — there is no inquiry CRUD. It is a documented future interface; v0 has no
-dependency on it.
+Redis) — there is no inquiry CRUD. It is a documented future interface; **v0 has no
+dependency on it**, so no host is named here: the URL belongs to a deployment, not to the
+package, and hard-coding one into a published README ships someone's infrastructure to
+everybody who installs it. Set `INQUIRY_WEAVE_API_URL` if a future version needs it.
 
 **Deferred decision, explicitly named:** absorbing IAIP into Miadi packages is out of
 scope and not planned here.

package/dist/env.d.ts

@@ -8,7 +8,7 @@
 export declare const DEFAULT_INQUIRY_ROOT = "/src/IAIP/prototypes/artefacts";
 export declare const DEFAULT_CHRONICLE_ROOT = "/srv/miadi/episodes/miadi-chronicle";
 export declare const DEFAULT_INQUIRY_REPO = "miadisabelle/Etuaptmumk-RSM";
-export declare const DEFAULT_MW_URL = "http://192.168.2.30:3940";
+export declare const DEFAULT_MW_URL = "http://127.0.0.1:8040";
 export interface WeaveEnvOptions {
     inquiryRoot?: string;
     chronicleRoot?: string;

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,mCAAmC,CAAA;AACpE,eAAO,MAAM,sBAAsB,wCAAwC,CAAA;AAC3E,eAAO,MAAM,oBAAoB,gCAAgC,CAAA;AACjE,eAAO,MAAM,cAAc,6BAA6B,CAAA;AAExD,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AASD,wBAAgB,UAAU,CACxB,OAAO,GAAE,eAAoB,EAC7B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,QAAQ,CAUV"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,mCAAmC,CAAA;AACpE,eAAO,MAAM,sBAAsB,wCAAwC,CAAA;AAC3E,eAAO,MAAM,oBAAoB,gCAAgC,CAAA;AACjE,eAAO,MAAM,cAAc,0BAA0B,CAAA;AAErD,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AASD,wBAAgB,UAAU,CACxB,OAAO,GAAE,eAAoB,EAC7B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,QAAQ,CAUV"}

package/dist/env.js

@@ -8,7 +8,7 @@
 export const DEFAULT_INQUIRY_ROOT = "/src/IAIP/prototypes/artefacts";
 export const DEFAULT_CHRONICLE_ROOT = "/srv/miadi/episodes/miadi-chronicle";
 export const DEFAULT_INQUIRY_REPO = "miadisabelle/Etuaptmumk-RSM";
-export const DEFAULT_MW_URL = "http://192.168.2.30:3940";
+export const DEFAULT_MW_URL = "http://127.0.0.1:8040";
 function firstNonEmpty(...values) {
     for (const value of values) {
         if (value !== undefined && value.trim() !== "")

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,gCAAgC,CAAA;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,qCAAqC,CAAA;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAA;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAA;AAgBxD,SAAS,aAAa,CAAC,GAAG,MAA8B;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,KAAK,CAAA;IAC9D,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,UAA2B,EAAE,EAC7B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO;QACL,WAAW,EACT,aAAa,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,kBAAkB,EAAE,GAAG,CAAC,YAAY,CAAC;YAC5E,oBAAoB;QACtB,aAAa,EACX,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,oBAAoB,CAAC,IAAI,sBAAsB;QAC1F,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,kBAAkB,CAAC,IAAI,oBAAoB;QACjF,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,cAAc;KACtE,CAAA;AACH,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,gCAAgC,CAAA;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,qCAAqC,CAAA;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAA;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAA;AAgBrD,SAAS,aAAa,CAAC,GAAG,MAA8B;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,KAAK,CAAA;IAC9D,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,UAA2B,EAAE,EAC7B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO;QACL,WAAW,EACT,aAAa,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,kBAAkB,EAAE,GAAG,CAAC,YAAY,CAAC;YAC5E,oBAAoB;QACtB,aAAa,EACX,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,oBAAoB,CAAC,IAAI,sBAAsB;QAC1F,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,kBAAkB,CAAC,IAAI,oBAAoB;QACjF,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,cAAc;KACtE,CAAA;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@miadi/inquiry-weave",
-  "version": "0.6.0",
-  "description": "Relate and sync IAIP inquiry artefacts, their GitHub issues, and miadi-chronicle episodes. Creates vessels and relations only — never inquiry content.",
+  "version": "0.6.1",
+  "description": "Relate and sync IAIP inquiry artefacts, their GitHub issues, and miadi-chronicle episodes. Creates vessels and relations only \u2014 never inquiry content.",
   "publishConfig": {
     "access": "public"
   },
@@ -23,9 +23,14 @@
     "README.md",
     "rispecs"
   ],
+  "scripts": {
+    "build": "../../node_modules/.bin/tsc -p tsconfig.build.json",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepublishOnly": "npm run build"
+  },
   "dependencies": {
-    "yaml": "^2.5.0",
-    "@miadi/episodic-memory-schema": "0.5.1"
+    "@miadi/episodic-memory-schema": "workspace:*",
+    "yaml": "^2.5.0"
   },
   "devDependencies": {
     "typescript": "^5.4.0"
@@ -43,9 +48,5 @@
     "url": "git+https://github.com/jgwill/Miadi.git",
     "directory": "packages/inquiry-weave"
   },
-  "license": "MIT",
-  "scripts": {
-    "build": "../../node_modules/.bin/tsc -p tsconfig.build.json",
-    "test": "npm run build && node --test test/*.test.mjs"
-  }
-}
+  "license": "MIT"
+}

package/rispecs/foundation-weave.proposal.spec.md

@@ -0,0 +1,104 @@
+# Proposal — Foundation as a fourth weave identity
+
+**Status:** proposal (not implemented) · **Date:** 2026-07-24 · **Package:** `@miadi/inquiry-weave`
+**Companion:** `@miadi/episodic-memory-schema`, `@miadi/foundations`
+**Related:** jgwill/Miadi#546 (packet), jgwill/Miadi#547 (`@miadi/foundations`), jgwill/Miadi#483, #506, #507
+
+## Context (current reality)
+
+`inquiry-weave` weaves **three identities** of one inquiry and never generates content:
+
+```
+inquiry artefact  ◄──►  GitHub issue  ◄──►  chronicle episode
+```
+
+Separately, `foundations/<topic>/` packets (skill `deep-research-foundations`, now bundled by
+`@miadi/foundations`) carry the **academic grounding** a decision stands on. Today nothing
+relates a packet to the episode/issue/artefact it grounds — the grounding is discoverable only
+by prose cross-reference. A chronicle episode cannot answer "what fields does this stand on?"
+
+## Desired state
+
+A **foundation** is a first-class, weavable identity — the *grounding* relation — so an
+episode (or issue, or artefact) can declare the packets that legitimize its decisions, and
+forgewright/`/chronicle` can render "grounded by …" the same way they render woven inquiries.
+
+```
+inquiry artefact ◄──► GitHub issue ◄──► chronicle episode
+                          ▲
+                          │ grounds
+                          ▼
+                 foundation packet  (foundations/<slug>/ or @miadi/foundations)
+```
+
+## Proposed surface (additive, non-breaking)
+
+### 1. `weave.yaml` gains a `foundations:` block
+
+Episode side (`<episode>/inquiry/weave.yaml`) and artefact side (`.weave.yaml`):
+
+```yaml
+foundations:
+  - slug: software-supply-chain-and-release-engineering
+    source: repo            # repo | package
+    packet_path: foundations/software-supply-chain-and-release-engineering   # when source=repo
+    package: "@miadi/foundations"                                            # when source=package
+    issue: jgwill/Miadi#546
+    fields:
+      - Software Supply-Chain Security
+      - Release Engineering & Continuous Delivery
+    grounded_at: 2026-07-24T00:00:00.000Z
+```
+
+The package stays true to its mystery boundary: it records the **relation**, never authors the
+packet. Resolution is read-only (a repo path or a published `@miadi/foundations` slug).
+
+### 2. New verb `ground` (mirrors `relate`)
+
+```
+inquiry-weave ground --episode <ref> --foundation <slug>
+                      [--source repo|package] [--issue owner/repo#N] [--dry-run]
+```
+
+- Validates the packet exists (repo `foundations/<slug>/` or `@miadi/foundations` manifest).
+- Appends to `weave.yaml`/`.weave.yaml` (append-if-missing, never overwrite) and to the
+  artefact's `AGENTS.md` back-link (`grounded by foundation <slug>`), matching `relate`.
+- `--dry-run` previews with `would ground:` and writes nothing (per the global dry-run contract).
+
+### 3. `register` projects a foundation edge into medicine-wheel
+
+`inquiry-weave register` gains a `miadi.foundation-ref.v1` record + a `grounds` edge from the
+foundation node to the episode node (`chronicle:<episode-dir>`), so forgewright renders the
+grounding on the episode card. Metadata-only, fail-open — identical guarantees to the existing
+inquiry-weave registration (jgwill/Miadi#490).
+
+### 4. Schema companion (`@miadi/episodic-memory-schema`)
+
+`EpisodeManifestEntry` gains an **optional** field so both renderers read groundings identically:
+
+```ts
+/** Foundation packets this episode declares as its academic grounding. */
+foundations?: FoundationRef[]
+```
+
+`FoundationRef = { slug: string; fields?: string[]; issue?: string; source: "repo" | "package" }`.
+Optional and additive → backward-compatible; the enumerator (`catalog.ts`) fills it from
+`weave.yaml`, keeping the read-side unforked.
+
+## Boundaries / non-goals
+
+- No packet authoring — `ground` records a relation to an existing packet only.
+- No IAIP absorption; no change to the three existing identities.
+- Whether groundings live on the episode, the issue, or the artefact primarily is settled at
+  implementation: this proposal writes them wherever `relate` already writes, keyed by episode.
+
+## Structural tension resolved
+
+Between grounding that is **narratively asserted** (prose says "this stands on field X") and
+grounding that is **structurally woven** (machine-readable, renderable, queryable). The `ground`
+verb + `foundations:` block turns a claim into a relation the chronicle can show and QMD can index.
+
+## Decision requested
+
+Approve the surface (verb name `ground` vs `relate --foundation`; block shape; schema field), then
+implement behind the existing dry-run/register guarantees. Until then this file is proposal-only.

package/rispecs/medicine-wheel-registration.spec.md

@@ -16,7 +16,7 @@ Status: **implemented in v0.2** — `register` targets `POST {MW_API_URL}/api/in
   number/slug/path) plus `lastSync` — and `toWeaveRecords(episodeWeave, inquiryRoot)`.
 - A medicine-wheel MCP server is already configured for chronicle work:
   `/a/src/Miadi/etc/mcp-config-mw-ilex.json`, server `medicine-wheel-miadi-chronicle`
-  (`npx ${MWCV}`, `MW_API_URL=http://192.168.2.30:3940`). It is the candidate storage
+  (`npx ${MWCV}`, `MW_API_URL=http://127.0.0.1:8040`). It is the candidate storage
   interface; nothing registers weaves into it today.
 - forgewright renders episode data from medicine-wheel but has no notion of an Inquiry
   Weave.

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 Miadi
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.