@miadi/inquiry-weave 0.7.0 → 0.8.0

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/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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"}

package/dist/chronicle-dsl.js

@@ -0,0 +1,327 @@
+/**
+ * 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 const MIADI_CHRONICLE_SCHEME = "miadi-chronicle:";
+/** Rendering options folded into the URI query under the reserved prefix. */
+export const OPTION_PREFIX = "mc.";
+// Numbered groups: [1]=path [2]=query [3]=fragment.
+//
+// `(?:\/\/)?` is the leniency rule: producers SHOULD emit rootless, parsers
+// MUST accept both. The scheme is case-insensitive per RFC 3986; the path is
+// not.
+//
+// The trailing `\/?` tolerates and normalizes away a trailing slash — RFC 3986
+// reads it as an empty final segment and people type it by reflex; refusing it
+// degraded the reference to raw `{{ }}` braces with nothing explaining why
+// (earned 2026-08-15, episode 103 on the film-media article).
+const URI_RE = /^miadi-chronicle:(?:\/\/)?([A-Za-z0-9._~-]+(?:\/[A-Za-z0-9._~-]+)*)\/?(?:\?([^#]*))?(?:#(.*))?$/i;
+/**
+ * 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 const ARTIFACT_SEGMENTS = {
+    "services-inventory": "inventory",
+    "state-machine": "state-machine",
+    // Wheel-backed kinds. These live in the medicine wheel's store rather than
+    // in the vessel, and every one of them is keyed by `episode_path` — the full
+    // folder name. Measured 2026-08-16: `?episode_number=320` returns 0 records
+    // for an episode whose `?episode_path=<folder>` returns 1, because the
+    // records carry no `episode_number` field and the filter compares strictly.
+    // The number is a nickname; the folder name is the key.
+    captures: "captures",
+    recordings: "captures", // deprecated alias on the wheel; same records
+    inquiry: "inquiry",
+    plans: "plans",
+};
+/** `mc.show=` values that name an artifact without using a path segment. */
+const SHOW_TO_KIND = {
+    inventory: "inventory",
+    "state-machine": "state-machine",
+    diagram: "state-machine",
+    captures: "captures",
+    recordings: "captures",
+    inquiry: "inquiry",
+    plans: "plans",
+};
+/** Kinds served by the medicine wheel rather than by the vessel on disk. */
+export const WHEEL_ARTIFACT_KINDS = ["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 function wheelNodeId(episodeFolder) {
+    return `chronicle:${episodeFolder}`;
+}
+export function isMiadiChronicleUri(href) {
+    return typeof href === "string" && /^miadi-chronicle:/i.test(href);
+}
+/** decodeURIComponent that shrugs at malformed escapes ("%zz", trailing "%")
+ *  instead of throwing — the parse contract is "never throws". */
+function safeDecode(s) {
+    try {
+        return decodeURIComponent(s);
+    }
+    catch {
+        return s;
+    }
+}
+/**
+ * The artifact this reference names, by either trigger, or null.
+ *
+ * Two triggers, deterministic and independent: a reserved segment in the LAST
+ * position, or `mc.show=`. The segment wins when both are present and disagree
+ * — it is the more explicit of the two.
+ *
+ * A lone `miadi-chronicle:state-machine` is NOT an artifact reference: with no
+ * episode before it there is nothing to resolve the artifact against, so it
+ * stays an ordinary (almost certainly unresolved) episode reference rather
+ * than becoming a reference to no machine in particular.
+ */
+function artifactOf(segments, options) {
+    const last = segments[segments.length - 1];
+    if (segments.length > 1 && last !== undefined && last in ARTIFACT_SEGMENTS) {
+        return ARTIFACT_SEGMENTS[last];
+    }
+    const show = options.show;
+    return (show !== undefined && SHOW_TO_KIND[show]) || null;
+}
+/** Strip a trailing reserved segment; what remains addresses an episode. */
+function episodeSegmentsOf(segments) {
+    const last = segments[segments.length - 1];
+    if (segments.length > 1 && last !== undefined && last in ARTIFACT_SEGMENTS) {
+        return segments.slice(0, -1);
+    }
+    return segments;
+}
+function buildCanonical(episodePath, query, options, fragment) {
+    const params = [];
+    for (const [k, v] of Object.entries(query)) {
+        params.push(`${encodeURIComponent(k)}=${encodeURIComponent(v)}`);
+    }
+    for (const [k, v] of Object.entries(options)) {
+        params.push(`${OPTION_PREFIX}${encodeURIComponent(k)}=${encodeURIComponent(v)}`);
+    }
+    const queryPart = params.length > 0 ? `?${params.join("&")}` : "";
+    const fragmentPart = fragment ? `#${fragment}` : "";
+    return `${MIADI_CHRONICLE_SCHEME}${episodePath}${queryPart}${fragmentPart}`;
+}
+/** Parse one URI. Returns null on anything malformed — never throws. */
+export function parseMiadiChronicleUri(uri) {
+    const m = URI_RE.exec(uri.trim());
+    if (!m || !m[1])
+        return null;
+    const query = {};
+    const options = {};
+    const rawQuery = m[2];
+    if (rawQuery) {
+        for (const pair of rawQuery.split("&")) {
+            if (!pair)
+                continue;
+            const eq = pair.indexOf("=");
+            const key = safeDecode(eq === -1 ? pair : pair.slice(0, eq));
+            const value = eq === -1 ? "" : safeDecode(pair.slice(eq + 1));
+            if (key.startsWith(OPTION_PREFIX))
+                options[key.slice(OPTION_PREFIX.length)] = value;
+            else
+                query[key] = value;
+        }
+    }
+    const segments = m[1].split("/");
+    const fragment = m[3] || undefined;
+    return {
+        uri: uri.trim(),
+        canonical: buildCanonical(m[1], query, options, fragment),
+        episodePath: m[1],
+        segments,
+        episodeSegments: episodeSegmentsOf(segments),
+        artifact: artifactOf(segments, options),
+        query,
+        options,
+        fragment,
+    };
+}
+// ---------------------------------------------------------------------------
+// Fragment durability (SPEC-TERMINAL §4.3)
+// ---------------------------------------------------------------------------
+/**
+ * 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 const DURABLE_FRAGMENT_KEYS = ["state", "event"];
+/** Positional keys, refused with a reason rather than silently ignored. */
+export const POSITIONAL_FRAGMENT_KEYS = [
+    "transition",
+    "parameter",
+    "action",
+    "source",
+];
+/**
+ * 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 function judgeFragment(fragment) {
+    if (!fragment)
+        return null;
+    const eq = fragment.indexOf("=");
+    if (eq === -1)
+        return { key: fragment, value: "", durable: true };
+    const key = fragment.slice(0, eq);
+    const value = fragment.slice(eq + 1);
+    if (DURABLE_FRAGMENT_KEYS.includes(key)) {
+        return { key, value, durable: true };
+    }
+    if (POSITIONAL_FRAGMENT_KEYS.includes(key)) {
+        return {
+            key,
+            value,
+            durable: false,
+            reason: `'${key}' is addressed positionally in SMDF, so this reference would ` +
+                `resolve to a different element after any sibling insert — silently. ` +
+                `Name a state or an event instead.`,
+        };
+    }
+    return { key, value, durable: true };
+}
+/**
+ * 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 const RENAME_POLICY = "alias-table-pending";
+/** Folder-name tail after date and episode-number prefixes: the true slug. */
+function folderSlug(name) {
+    return name.replace(/^\d{4}-\d{2}-\d{2}-/, "").replace(/^episode-\d+-*/, "");
+}
+/** Deterministic pick over possibly-multiple matches: lexicographically first
+ *  folder name (= earliest date), remaining matches surfaced as alternates. */
+function pick(matches, matchedBy) {
+    if (matches.length === 0)
+        return null;
+    const sorted = [...matches].sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        entry: sorted[0],
+        matchedBy,
+        alternates: sorted.length > 1 ? sorted.slice(1).map((e) => e.name) : undefined,
+    };
+}
+function matchSegment(segment, entries) {
+    const exact = entries.find((e) => e.name === segment);
+    if (exact)
+        return { entry: exact, matchedBy: "folder-name" };
+    if (/^\d+$/.test(segment)) {
+        const num = parseInt(segment, 10);
+        const byNumber = pick(entries.filter((e) => e.number === num), "number");
+        if (byNumber)
+            return byNumber;
+    }
+    const bySlug = pick(entries.filter((e) => e.slug === segment || folderSlug(e.name) === segment), "slug");
+    if (bySlug)
+        return bySlug;
+    if (/^\d{4}-\d{2}-\d{2}$/.test(segment)) {
+        const byDate = pick(entries.filter((e) => e.date === segment || e.name.startsWith(`${segment}-`)), "date");
+        if (byDate)
+            return byDate;
+    }
+    return null;
+}
+function toRef(segment, match, fragment) {
+    if (!match)
+        return { segment, resolved: false };
+    const { entry, matchedBy, alternates } = match;
+    const fragmentPart = fragment ? `#${fragment}` : "";
+    return {
+        segment,
+        resolved: true,
+        matchedBy,
+        name: entry.name,
+        number: entry.number,
+        title: entry.title,
+        date: entry.date,
+        direction: entry.direction,
+        theme: entry.theme,
+        route: `/chronicle/${encodeURIComponent(entry.name)}${fragmentPart}`,
+        alternates,
+    };
+}
+/**
+ * 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 function resolveChronicleRef(parsed, entries) {
+    const segments = parsed.episodeSegments;
+    const targetSegment = segments[segments.length - 1];
+    const target = toRef(targetSegment, matchSegment(targetSegment, entries), parsed.fragment);
+    const waypoints = segments.slice(0, -1).map((s) => toRef(s, matchSegment(s, entries)));
+    return { resolved: target.resolved, matchedBy: target.matchedBy, target, waypoints };
+}
+/** One-call convenience: raw URI string → resolution, or null if unparseable. */
+export function resolveChronicleUri(uri, entries) {
+    const parsed = parseMiadiChronicleUri(uri);
+    if (!parsed)
+        return null;
+    return { parsed, resolution: resolveChronicleRef(parsed, entries) };
+}
+//# sourceMappingURL=chronicle-dsl.js.map

package/dist/chronicle-dsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chronicle-dsl.js","sourceRoot":"","sources":["../src/chronicle-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAA;AAExD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAA;AAElC,oDAAoD;AACpD,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,OAAO;AACP,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,2EAA2E;AAC3E,8DAA8D;AAC9D,MAAM,MAAM,GACV,kGAAkG,CAAA;AAEpG;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,oBAAoB,EAAE,WAAW;IACjC,eAAe,EAAE,eAAe;IAChC,2EAA2E;IAC3E,6EAA6E;IAC7E,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAC5E,wDAAwD;IACxD,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,UAAU,EAAE,8CAA8C;IACtE,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACN,CAAA;AAIV,4EAA4E;AAC5E,MAAM,YAAY,GAAiC;IACjD,SAAS,EAAE,WAAW;IACtB,eAAe,EAAE,eAAe;IAChC,OAAO,EAAE,eAAe;IACxB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,UAAU;IACtB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACf,CAAA;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAU,CAAA;AAE7E;0DAC0D;AAC1D,MAAM,UAAU,WAAW,CAAC,aAAqB;IAC/C,OAAO,aAAa,aAAa,EAAE,CAAA;AACrC,CAAC;AAuBD,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IAC1D,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACpE,CAAC;AAED;kEACkE;AAClE,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAA;IACV,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,UAAU,CAAC,QAAkB,EAAE,OAA+B;IACrE,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC1C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,IAAI,iBAAiB,EAAE,CAAC;QAC3E,OAAO,iBAAiB,CAAC,IAAsC,CAAC,CAAA;IAClE,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IACzB,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAA;AAC3D,CAAC;AAED,4EAA4E;AAC5E,SAAS,iBAAiB,CAAC,QAAkB;IAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC1C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,IAAI,iBAAiB,EAAE,CAAC;QAC3E,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,cAAc,CACrB,WAAmB,EACnB,KAA6B,EAC7B,OAA+B,EAC/B,QAAiB;IAEjB,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAClE,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAClF,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACjE,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACnD,OAAO,GAAG,sBAAsB,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,EAAE,CAAA;AAC7E,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IACjC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAE5B,MAAM,KAAK,GAA2B,EAAE,CAAA;IACxC,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACrB,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI;gBAAE,SAAQ;YACnB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;YAC5D,MAAM,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;YAC7D,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAA;;gBAC9E,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACzB,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChC,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAA;IAClC,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE;QACf,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;QACzD,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QACjB,QAAQ;QACR,eAAe,EAAE,iBAAiB,CAAC,QAAQ,CAAC;QAC5C,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC;QACvC,KAAK;QACL,OAAO;QACP,QAAQ;KACT,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,OAAO,CAAU,CAAA;AAEhE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,QAAQ;CACA,CAAA;AASV;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,QAA4B;IACxD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACjE,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IACpC,IAAK,qBAA2C,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACtC,CAAC;IACD,IAAK,wBAA8C,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,GAAG;YACH,KAAK;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EACJ,IAAI,GAAG,+DAA+D;gBACtE,sEAAsE;gBACtE,mCAAmC;SACtC,CAAA;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,qBAA8B,CAAA;AAsD3D,8EAA8E;AAC9E,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;AAC9E,CAAC;AAQD;+EAC+E;AAC/E,SAAS,IAAI,CAAC,OAA4B,EAAE,SAAoB;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACrC,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IACxE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAChB,SAAS;QACT,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC/E,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,OAA4B;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAA;IACrD,IAAI,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,CAAA;IAE5D,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QACjC,MAAM,QAAQ,GAAG,IAAI,CACnB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,EACvC,QAAQ,CACT,CAAA;QACD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;IAC/B,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CACjB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,EAC3E,MAAM,CACP,CAAA;IACD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CACjB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,EAC7E,MAAM,CACP,CAAA;QACD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;IAC3B,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,KAAK,CACZ,OAAe,EACf,KAA0B,EAC1B,QAAiB;IAEjB,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;IAC/C,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;IAC9C,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACnD,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,IAAI;QACd,SAAS;QACT,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,cAAc,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,EAAE;QACpE,UAAU;KACX,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA0B,EAC1B,OAA4B;IAE5B,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,CAAA;IACvC,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,EAAE,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC1F,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AACtF,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,OAA4B;IAE5B,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;AACrE,CAAC"}