@miadi/inquiry-weave 0.6.9 → 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+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.

package/README.md

@@ -235,3 +235,116 @@ calls (`INQUIRY_WEAVE_ISSUE_LIB` injects a fake issue lib).
 ---
 🌸: A loom, not a pen — the weave holds artefact, issue, and episode in relation so none
 drifts from the others, while the question itself stays yours to ask.
+
+## `resolve` — one chronicle reference, answered
+
+```bash
+inquiry-weave resolve "miadi-chronicle:311/services-inventory"
+```
+
+```
+écoute factorisation logiciels — the relational software factory
+  [room·local] [room·tailnet] [room·public] [wheel·captures]
+  [wheel·graph] [wheel·node] [wheel·relations] [file·inventory]
+  <miadi-chronicle:311/services-inventory>
+  episode 311 · 2026-08-05-episode-311-coute-… · matched by number
+  path: /srv/miadi/episodes/…/services-inventory.json
+  modality: relational
+```
+
+Turns a `miadi-chronicle:` reference into every door it opens. Contract:
+`rispecs/miadi-chronicle-dsl/SPEC.md` (v1.1) and `SPEC-TERMINAL.md` (v1.2);
+grounding in `foundations/resource-addressing-and-terminal-hypermedia/`.
+
+Each bracket is its own OSC 8 hyperlink, and the canonical reference stays
+visible beside them — the OSC 8 specification says a hyperlink "should not be
+the only means of figuring out the target", and there is no way to detect
+whether a terminal supports them. `--raw` drops the escape for clean capture.
+
+**The reference is host-free.** `miadi-chronicle:311` is the name; a base is
+chosen at render time. That is ARK's Name Mapping Authority rule — the
+resolver's hostport is identity-inert — and it is why the same reference reads
+correctly from this host, the tailnet, or the public front.
+
+| flag | does |
+| --- | --- |
+| `--json` | the full result: `canonical`, `resolution`, `artifact`, `destinations[]`, `open`, `shareable`, `path`, `modality` |
+| `--base local\|internal\|public` | lead with one door. Reorders; never removes one |
+| `--local` | lead with the file on this disk |
+| `--verify` | ask the wheel whether the episode is really on it |
+| `--raw` | no escape sequences |
+
+**`--verify` exists because a 200 proves nothing.** The wheel's `/graph`,
+`/nodes` and `/relations` pages are client-routed, and so is forgewright's
+chronicle view: both return 200 for an episode name that does not exist
+(measured `?episode=9999-99-99-episode-000-nope` → 200). Only
+`GET /api/nodes/<id>` discriminates, and that is what `--verify` asks.
+
+**Two answers, never collapsed.** `open` is where a human click should land —
+the episode room. `path` is the bytes on this host. An earlier draft returned
+only the file, and clicking it opened a text editor on raw JSON: local-first is
+about data ownership and availability, not about presentation.
+
+### Forms
+
+```
+miadi-chronicle:092/126?view=wheel#scene=river   # canonical, rootless
+miadi-chronicle://092/126                        # accepted forever, normalized away
+```
+
+`//` is RFC 3986 §3.2's authority marker, so a conformant parser reads the
+first path segment as a host — `new URL("miadi-chronicle://126")` yields host
+`"126"` and an **empty path**. Producers emit rootless; parsers accept both.
+
+### Artifact segments
+
+`services-inventory` · `state-machine` · `captures` · `recordings` · `inquiry`
+· `plans`. The last four are served by the medicine wheel and are keyed by
+`episode_path` — the **full folder name**. The episode number is not a key
+there: `?episode_number=320` returns 0 records for an episode whose
+`?episode_path=<folder>` returns 1.
+
+### Fragments
+
+`#state=` and `#event=` are spellable; `#transition=`, `#parameter=`,
+`#action=` and `#source=` are not. State names are unique tree-wide (SMDF's
+V002) so they survive structural motion; transitions are addressed positionally
+and a sibling insert silently retargets the reference. Name-keyed fragments are
+durable against structural motion and **fragile against rename** — see
+`SPEC-TERMINAL.md` §4.3a.
+
+## `terminal install` — clickable references in Terminator
+
+```bash
+inquiry-weave terminal install --enable
+```
+
+Writes three files and one config line, each printed:
+
+| path | is |
+| --- | --- |
+| `~/.config/terminator/plugins/miadi_chronicle_url_handler.py` | the URL handler |
+| `~/.config/environment.d/50-miadi-chronicle.conf` | systemd user environment |
+| `~/bin/miadi-chronicle-open` | the resolver wrapper a click runs |
+| `enabled_plugins` in the Terminator config | only with `--enable`, after a backup |
+
+Then restart Terminator and **Ctrl+click** a `miadi-chronicle:` reference
+anywhere in its output. Plain click needs `link_single_click = True`.
+
+`--force` overwrites, `--dry-run` previews, `terminal uninstall` reverses it,
+`terminal show` prints the paths. Running install twice is safe.
+
+**Why a plugin when OSC 8 exists.** Terminator has two click paths: an OSC 8
+hyperlink calls `open_url(prepare=False)` and goes straight to `xdg-open`,
+while a regex match calls `prepare=True` — the only path that consults
+`url_handler` plugins. So the plugin covers what OSC 8 structurally cannot: a
+bare `miadi-chronicle:311` in output that knows nothing about miadi — a git
+log, a grep hit, an agent's raw text.
+
+**Why the environment drop-in.** A GUI process inherits nothing from your
+shell, so `MIADI_URL_BASE`, `MW_API_URL` and `MIADI_CHRONICLE_ROOT` are absent
+at click time and every click falls back to localhost. `environment.d` is the
+OS's own answer — read by systemd's user-environment generator at session
+start, so every GUI process in the session inherits it. Takes effect at the
+next login; the wrapper carries the same values as a fallback until then.
+Test with `env -i`, which is the real click condition. See `jgwill/Miadi#620`.

package/dist/attention-node.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Attention-node projection — make "what needs a human" visible on the wheel.
+ *
+ * Mirrors episode-node.ts: the vessel's `attention.json` stays authoritative;
+ * each item projects as ONE dedicated node (`attention:<episode>/<item-id>`),
+ * riding `knowledge` facing SOUTH — a decision ask is consent work. Per-item
+ * nodes are deliberate: medicine-wheel PATCH replaces the whole metadata
+ * object (storage-provider jsonl.ts `metadata: patch.metadata`, no merge), so
+ * items sharing a node would race every concurrent writer; one item, one
+ * writer, one node. forgewright's chronicle view is wheel-fed only, so this
+ * projection IS how attention reaches ilex.
+ *
+ * POST upserts by id on medicine-wheel ≥0.5.0, so registration preflights GET
+ * and UPDATES an existing node via PATCH instead of silently overwriting.
+ * Fail-open boundary exactly like registerEpisodeNode: network failure
+ * resolves to `pending`, never a throw — the file write upstream must never
+ * be lost to a wheel outage.
+ */
+import type { AttentionItem } from "@miadi/episodic-memory-schema";
+import { ATTENTION_SCHEMA_VERSION } from "@miadi/episodic-memory-schema";
+export interface AttentionNodeRecord {
+    id: string;
+    type: "knowledge";
+    name: string;
+    description: string;
+    direction: "south";
+    metadata: {
+        contract: "miadi.artifact-ref.v1";
+        kind: "attention";
+        schema_version: typeof ATTENTION_SCHEMA_VERSION;
+        root: "MIADI_CHRONICLE_ROOT";
+        relative_path: string;
+        parent_id: string;
+        item_id: string;
+        state: "open" | "answered";
+        asked?: string;
+        unlocks?: string;
+        answer?: string;
+        answered_at?: string;
+    };
+}
+export type AttentionNodeState = "registered" | "updated" | "pending";
+export interface AttentionNodeOutcome {
+    state: AttentionNodeState;
+    node_id: string;
+    /** True only when a read-back confirmed the stored state matches the item. */
+    verified: boolean;
+    error?: string;
+}
+export declare function attentionNodeId(episodeName: string, itemId: string): string;
+export declare function projectAttentionNode(episodeName: string, item: AttentionItem): AttentionNodeRecord;
+export interface RegisterAttentionNodeOptions {
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Create or update the wheel node for one item, then read it back.
+ * `verified: true` means the wheel now SERVES the item's state — reached,
+ * not merely configured.
+ */
+export declare function registerAttentionNode(mwUrl: string, episodeName: string, item: AttentionItem, options?: RegisterAttentionNodeOptions): Promise<AttentionNodeOutcome>;
+export interface SyncAttentionOutcome {
+    outcomes: AttentionNodeOutcome[];
+    registered: number;
+    updated: number;
+    pending: number;
+    verified: number;
+}
+/** Project every item of one episode; never throws past its boundary. */
+export declare function syncEpisodeAttention(mwUrl: string, episodeName: string, items: readonly AttentionItem[], options?: RegisterAttentionNodeOptions): Promise<SyncAttentionOutcome>;
+//# sourceMappingURL=attention-node.d.ts.map

package/dist/attention-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention-node.d.ts","sourceRoot":"","sources":["../src/attention-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAExE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE;QACR,QAAQ,EAAE,uBAAuB,CAAA;QACjC,IAAI,EAAE,WAAW,CAAA;QACjB,cAAc,EAAE,OAAO,wBAAwB,CAAA;QAC/C,IAAI,EAAE,sBAAsB,CAAA;QAC5B,aAAa,EAAE,MAAM,CAAA;QACrB,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,MAAM,GAAG,UAAU,CAAA;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAA;AAErE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,kBAAkB,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,aAAa,GAClB,mBAAmB,CAuBrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAgBD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAwG/B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,oBAAoB,EAAE,CAAA;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,yEAAyE;AACzE,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,oBAAoB,CAAC,CAY/B"}

package/dist/attention-node.js

@@ -0,0 +1,194 @@
+/**
+ * Attention-node projection — make "what needs a human" visible on the wheel.
+ *
+ * Mirrors episode-node.ts: the vessel's `attention.json` stays authoritative;
+ * each item projects as ONE dedicated node (`attention:<episode>/<item-id>`),
+ * riding `knowledge` facing SOUTH — a decision ask is consent work. Per-item
+ * nodes are deliberate: medicine-wheel PATCH replaces the whole metadata
+ * object (storage-provider jsonl.ts `metadata: patch.metadata`, no merge), so
+ * items sharing a node would race every concurrent writer; one item, one
+ * writer, one node. forgewright's chronicle view is wheel-fed only, so this
+ * projection IS how attention reaches ilex.
+ *
+ * POST upserts by id on medicine-wheel ≥0.5.0, so registration preflights GET
+ * and UPDATES an existing node via PATCH instead of silently overwriting.
+ * Fail-open boundary exactly like registerEpisodeNode: network failure
+ * resolves to `pending`, never a throw — the file write upstream must never
+ * be lost to a wheel outage.
+ */
+import { ATTENTION_SCHEMA_VERSION } from "@miadi/episodic-memory-schema";
+export function attentionNodeId(episodeName, itemId) {
+    return `attention:${episodeName}/${itemId}`;
+}
+export function projectAttentionNode(episodeName, item) {
+    const metadata = {
+        contract: "miadi.artifact-ref.v1",
+        kind: "attention",
+        schema_version: ATTENTION_SCHEMA_VERSION,
+        root: "MIADI_CHRONICLE_ROOT",
+        relative_path: `${episodeName}/attention.json`,
+        parent_id: `chronicle:${episodeName}`,
+        item_id: item.id,
+        state: item.state,
+    };
+    if (item.asked)
+        metadata.asked = item.asked;
+    if (item.unlocks)
+        metadata.unlocks = item.unlocks;
+    if (item.answer)
+        metadata.answer = item.answer;
+    if (item.answered_at)
+        metadata.answered_at = item.answered_at;
+    return {
+        id: attentionNodeId(episodeName, item.id),
+        type: "knowledge",
+        name: item.question,
+        description: item.unlocks ? `unlocks: ${item.unlocks}` : "",
+        direction: "south",
+        metadata,
+    };
+}
+function describeFailure(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function readErrorBody(response) {
+    try {
+        const body = (await response.json());
+        if (body && typeof body.error === "string")
+            return body.error;
+    }
+    catch {
+        // Non-JSON body — the status line is all we can report.
+    }
+    return "";
+}
+/**
+ * Create or update the wheel node for one item, then read it back.
+ * `verified: true` means the wheel now SERVES the item's state — reached,
+ * not merely configured.
+ */
+export async function registerAttentionNode(mwUrl, episodeName, item, options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const base = mwUrl.replace(/\/+$/, "");
+    const record = projectAttentionNode(episodeName, item);
+    const node_id = record.id;
+    const nodeUrl = `${base}/api/nodes/${encodeURIComponent(node_id)}`;
+    let existing;
+    try {
+        existing = await fetchImpl(nodeUrl);
+    }
+    catch (error) {
+        return {
+            state: "pending",
+            node_id,
+            verified: false,
+            error: `medicine-wheel unreachable at ${base}: ${describeFailure(error)}`,
+        };
+    }
+    let state;
+    if (existing.ok) {
+        // Full-metadata PATCH by design: the store replaces, so we always send the
+        // complete projection — never a partial that would erase sibling fields.
+        let patched;
+        try {
+            patched = await fetchImpl(nodeUrl, {
+                method: "PATCH",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({
+                    name: record.name,
+                    description: record.description,
+                    metadata: record.metadata,
+                }),
+            });
+        }
+        catch (error) {
+            return {
+                state: "pending",
+                node_id,
+                verified: false,
+                error: `PATCH ${nodeUrl}: ${describeFailure(error)}`,
+            };
+        }
+        if (!patched.ok) {
+            const detail = await readErrorBody(patched);
+            return {
+                state: "pending",
+                node_id,
+                verified: false,
+                error: `PATCH ${nodeUrl}: HTTP ${patched.status}${detail ? ` — ${detail}` : ""}`,
+            };
+        }
+        state = "updated";
+    }
+    else if (existing.status === 404) {
+        let created;
+        try {
+            created = await fetchImpl(`${base}/api/nodes`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(record),
+            });
+        }
+        catch (error) {
+            return {
+                state: "pending",
+                node_id,
+                verified: false,
+                error: `medicine-wheel unreachable at ${base}: ${describeFailure(error)}`,
+            };
+        }
+        if (!created.ok) {
+            const detail = await readErrorBody(created);
+            return {
+                state: "pending",
+                node_id,
+                verified: false,
+                error: `POST ${base}/api/nodes: HTTP ${created.status}${detail ? ` — ${detail}` : ""}`,
+            };
+        }
+        state = "registered";
+    }
+    else {
+        const detail = await readErrorBody(existing);
+        return {
+            state: "pending",
+            node_id,
+            verified: false,
+            error: `GET ${nodeUrl}: HTTP ${existing.status}${detail ? ` — ${detail}` : ""}`,
+        };
+    }
+    // The verify leg — the boot-law applied to the write path.
+    try {
+        const back = await fetchImpl(nodeUrl);
+        if (!back.ok)
+            return { state, node_id, verified: false, error: `verify GET: HTTP ${back.status}` };
+        const body = (await back.json());
+        const served = body.node?.metadata?.state ?? body.metadata?.state;
+        if (served === item.state)
+            return { state, node_id, verified: true };
+        return {
+            state,
+            node_id,
+            verified: false,
+            error: `verify: wheel serves state=${String(served)}, item is ${item.state}`,
+        };
+    }
+    catch (error) {
+        return { state, node_id, verified: false, error: `verify GET: ${describeFailure(error)}` };
+    }
+}
+/** Project every item of one episode; never throws past its boundary. */
+export async function syncEpisodeAttention(mwUrl, episodeName, items, options = {}) {
+    const outcomes = [];
+    for (const item of items) {
+        outcomes.push(await registerAttentionNode(mwUrl, episodeName, item, options));
+    }
+    return {
+        outcomes,
+        registered: outcomes.filter((o) => o.state === "registered").length,
+        updated: outcomes.filter((o) => o.state === "updated").length,
+        pending: outcomes.filter((o) => o.state === "pending").length,
+        verified: outcomes.filter((o) => o.verified).length,
+    };
+}
+//# sourceMappingURL=attention-node.js.map

package/dist/attention-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention-node.js","sourceRoot":"","sources":["../src/attention-node.ts"],"names":[],"mappings":"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"}

package/dist/chronicle-dsl.d.ts

@@ -0,0 +1,191 @@
+/**
+ * miadi-chronicle URI parsing, artifact registry, and episode resolution.
+ *
+ * Contract: rispecs/miadi-chronicle-dsl/SPEC.md (v1.1) and SPEC-TERMINAL.md
+ * (v1.2). Grounded in foundations/resource-addressing-and-terminal-hypermedia/.
+ *
+ * This is the app's three pure modules (`app/chronicle/lib/{dsl,resolveRef,
+ * inventoryRef}.ts`) brought into a package that already ships built ESM, so
+ * one resolver can answer the browser, the HTTP route, and a terminal. It
+ * stays pure — no fs, no fetch, no React. The catalog arrives as an argument.
+ *
+ * Two changes v1.1 does not have, both from the foundations packet:
+ *
+ *  1. ROOTLESS FORM. `//` is RFC 3986 §3.2's authority marker, so every
+ *     conformant parser reads the first path segment as a host:
+ *       new URL("miadi-chronicle://126")  → host "126", pathname ""
+ *     The most common reference has an EMPTY PATH, stock parsers disagree
+ *     with this file, and SPEC §8's reserved `//root@…/` growth slot is
+ *     unreachable because episode data already occupies it. Every non-HTTP
+ *     scheme that survived — did:, urn:, ark:, swh:, tag:, info: — is
+ *     rootless. So: `miadi-chronicle:092/126` is canonical, `//` is accepted
+ *     forever on input and normalized away on output.
+ *
+ *  2. ARTIFACT REGISTRY. v1.1's "registry" was one const string compared by
+ *     `===` in three places. It is a map now, with `state-machine` as the
+ *     second entry.
+ */
+export declare const MIADI_CHRONICLE_SCHEME = "miadi-chronicle:";
+/** Rendering options folded into the URI query under the reserved prefix. */
+export declare const OPTION_PREFIX = "mc.";
+/**
+ * Reserved artifact segments — the registry SPEC §7.1 named itself after.
+ * Each key is a name no episode folder can carry (folder names are
+ * date-prefixed); each value is the artifact kind the resolver dispatches on.
+ */
+export declare const ARTIFACT_SEGMENTS: {
+    readonly "services-inventory": "inventory";
+    readonly "state-machine": "state-machine";
+    readonly captures: "captures";
+    readonly recordings: "captures";
+    readonly inquiry: "inquiry";
+    readonly plans: "plans";
+};
+export type ArtifactKind = (typeof ARTIFACT_SEGMENTS)[keyof typeof ARTIFACT_SEGMENTS];
+/** Kinds served by the medicine wheel rather than by the vessel on disk. */
+export declare const WHEEL_ARTIFACT_KINDS: readonly ["captures", "inquiry", "plans"];
+/** The wheel node id for an episode. The observed format, not the expected one:
+ *  `chronicle:2026-08-05-episode-311-coute-…-factory`. */
+export declare function wheelNodeId(episodeFolder: string): string;
+export interface ParsedChronicleUri {
+    /** The full original URI, exactly as given. */
+    uri: string;
+    /** Canonical rootless form with `mc.*` options and fragment preserved. */
+    canonical: string;
+    /** Raw slash-joined path as written, e.g. "092/126" or "311/state-machine". */
+    episodePath: string;
+    /** Path split into segments, artifact segment included when present. */
+    segments: string[];
+    /** Segments that address an EPISODE — the artifact segment stripped. */
+    episodeSegments: string[];
+    /** Which artifact this reference names, or null for a plain episode ref. */
+    artifact: ArtifactKind | null;
+    /** Query params minus the mc.* rendering options. */
+    query: Record<string, string>;
+    /** mc.* rendering options, prefix stripped (show, label, highlight, as, …). */
+    options: Record<string, string>;
+    /** In-episode navigation hint, e.g. "scene=river" or "state=Gathering". */
+    fragment?: string;
+}
+export declare function isMiadiChronicleUri(href: string | undefined): boolean;
+/** Parse one URI. Returns null on anything malformed — never throws. */
+export declare function parseMiadiChronicleUri(uri: string): ParsedChronicleUri | null;
+/**
+ * Keys a `state-machine` fragment may use.
+ *
+ * `state` and `event` are name-keyed: SMDF's validation rule V002 forces
+ * tree-wide unique state names, and events are keyed by id, so both survive
+ * structural motion. Transitions, parameters, actions and event sources are
+ * addressed POSITIONALLY (`{state, index}`) — an index shifts the moment a
+ * sibling is inserted, and the reference then resolves to the wrong thing
+ * without raising anything. Content drift outruns link rot roughly 3:1
+ * (Jones et al. 2016, doi:10.1371/journal.pone.0167475) and the silent
+ * variant is the damaging one, so a form that cannot be durable is not
+ * spellable here.
+ *
+ * The narrow claim, precisely: a BARE `{state, index}` pair carries no content
+ * by which a shifted reference could be re-matched or a mis-resolution
+ * detected. Positional addressing can be hardened (Phelps & Wilensky carry
+ * node tags alongside the index and resolve by approximate match) — but
+ * hardening it here would amount to describing the transition, at which point
+ * the index is doing no work. The sanctioned way to address one is therefore
+ * by description, from V002-unique names, which inherits their durability:
+ *   #transition=(from:<State>,on:<Event>,to:<State>)
+ * That form EXTENDS this rule rather than breaching it. It is not implemented.
+ *
+ * Conditional by design: transitions are positional IN SMDF TODAY. OMG XMI
+ * gives every model element an `xmi:id`; if SMDF ever mints author-assigned
+ * transition ids under the same uniqueness constraint, `#transition=` becomes
+ * durable and this rule's own principle would then REQUIRE permitting it.
+ */
+export declare const DURABLE_FRAGMENT_KEYS: readonly ["state", "event"];
+/** Positional keys, refused with a reason rather than silently ignored. */
+export declare const POSITIONAL_FRAGMENT_KEYS: readonly ["transition", "parameter", "action", "source"];
+export interface FragmentVerdict {
+    key: string;
+    value: string;
+    durable: boolean;
+    reason?: string;
+}
+/**
+ * Judge a `key=value` fragment against the durability rule. An unknown key is
+ * neither endorsed nor refused — it is passed through, per SPEC §1's rule that
+ * unknown parameters are preserved and never fatal.
+ */
+export declare function judgeFragment(fragment: string | undefined): FragmentVerdict | null;
+/**
+ * Rename is the hole V002 does not cover.
+ *
+ * V002 gives tree-wide unique state names AT A POINT IN TIME. It says nothing
+ * about immutability: under rename, `#state=Foo` fails exactly as a positional
+ * reference fails under insertion, and the worse variant — a name reused for a
+ * different state — resolves successfully to the wrong element.
+ *
+ * The policy this package implements is the middle of the three the packet
+ * lists: an alias table. A machine MAY carry `former-names`, and a reference
+ * to a former name resolves WITH A DEPRECATION SIGNAL rather than failing.
+ * That is XPointer's ordered-fallback pattern applied locally, and Memento's
+ * idea (reach a prior state) without an archive. Until SMDF carries
+ * `former-names`, the honest status is: name-keyed fragments are durable
+ * against structural motion and fragile against rename, and this is stated
+ * rather than implied.
+ */
+export declare const RENAME_POLICY: "alias-table-pending";
+export type MatchedBy = "folder-name" | "number" | "slug" | "date";
+/** The seven fields resolution actually reads. Structurally satisfied by
+ *  `EpisodeManifestEntry` from the catalog, and by the app's richer view. */
+export interface ResolvableEpisode {
+    name: string;
+    number?: number;
+    slug?: string;
+    date?: string;
+    title?: string;
+    direction?: string;
+    theme?: string;
+}
+export interface ResolvedEpisodeRef {
+    segment: string;
+    resolved: boolean;
+    matchedBy?: MatchedBy;
+    name?: string;
+    number?: number;
+    title?: string;
+    date?: string;
+    direction?: string;
+    theme?: string;
+    /** App route to the episode room, fragment already attached for targets. */
+    route?: string;
+    /**
+     * Folder names of OTHER episodes the segment also matched. The catalog
+     * really does hold duplicate numbers; resolution stays deterministic and
+     * the ambiguity is surfaced instead of hidden.
+     *
+     * Note what this does NOT yet solve: the tie-break is lexicographically
+     * first, so backfilling a newly-discovered OLDER episode with a duplicate
+     * number silently retargets every existing reference. Non-reassignment is a
+     * primary dimension of identifier validity (Kunze et al. 2017); ARK and DOI
+     * forbid reassignment outright. Deterministic-at-an-instant is not
+     * stable-over-time, and `alternates` reports the ambiguity without fixing it.
+     */
+    alternates?: string[];
+}
+export interface ChronicleResolution {
+    resolved: boolean;
+    matchedBy?: MatchedBy;
+    target: ResolvedEpisodeRef;
+    waypoints: ResolvedEpisodeRef[];
+}
+/**
+ * Resolve an already-parsed URI against the catalog.
+ *
+ * Resolution runs over `episodeSegments`, so an artifact reference resolves
+ * its episode exactly as a plain reference does — the reserved segment is
+ * stripped before matching, never matched against a folder.
+ */
+export declare function resolveChronicleRef(parsed: ParsedChronicleUri, entries: ResolvableEpisode[]): ChronicleResolution;
+/** One-call convenience: raw URI string → resolution, or null if unparseable. */
+export declare function resolveChronicleUri(uri: string, entries: ResolvableEpisode[]): {
+    parsed: ParsedChronicleUri;
+    resolution: ChronicleResolution;
+} | null;
+//# sourceMappingURL=chronicle-dsl.d.ts.map

package/dist/chronicle-dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chronicle-dsl.d.ts","sourceRoot":"","sources":["../src/chronicle-dsl.ts"],"names":[],"mappings":"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"}