@miadi/inquiry-weave 0.14.3 → 0.15.0

package/dist/index.d.ts

@@ -16,6 +16,10 @@ export * from "./attention-node.js";
 export * from "./attention.js";
 export * from "./captures.js";
 export * from "./catalog.js";
+export * from "./readings.js";
+export * from "./text-references.js";
+export * from "./chronicle-dsl.js";
+export * from "./chronicle-terminal.js";
 export * from "./story-library.js";
 export * from "./git-landing.js";
 export * from "./closing.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -16,6 +16,10 @@ export * from "./attention-node.js";
 export * from "./attention.js";
 export * from "./captures.js";
 export * from "./catalog.js";
+export * from "./readings.js";
+export * from "./text-references.js";
+export * from "./chronicle-dsl.js";
+export * from "./chronicle-terminal.js";
 export * from "./story-library.js";
 export * from "./git-landing.js";
 export * from "./closing.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,MAAM,EAAuC,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,MAAM,EAAuC,MAAM,UAAU,CAAA"}

package/dist/readings.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Episode readings: the theme, direction and arc a surface groups an episode
+ * under (jgwill/Miadi#506, moved here by jgwill/Miadi#706).
+ *
+ * The catalog (`buildChronicleCatalog`) carries no direction, theme or arc.
+ * Those are *readings* of an episode, not facts on disk: keyword guesses over
+ * its folder name, slug, title, type and status. They live here so the web
+ * room (`app/chronicle`) and the terminal browser read an episode by the same
+ * rule. Pure and deterministic, with no I/O, so it is safe in a client bundle
+ * through the `@miadi/inquiry-weave/readings` subpath.
+ */
+import type { EpisodeManifestEntry } from "@miadi/episodic-memory-schema";
+export type DirectionKey = "east" | "south" | "west" | "north";
+export type ArcKey = "Book I · The Threshold" | "Book II · The Orchard" | "Book III · The Council";
+export interface EpisodeReadings {
+    theme: string;
+    direction: DirectionKey;
+    arc: ArcKey;
+}
+/** The part of a catalog entry a reading looks at. */
+export type ReadableEntry = Pick<EpisodeManifestEntry, "name" | "slug" | "title" | "type" | "status" | "number">;
+export declare const DIRECTION_ORDER: readonly DirectionKey[];
+/** First match wins, in this order. No match reads as "chronicle". */
+export declare const THEME_KEYWORDS: ReadonlyArray<readonly [string, readonly string[]]>;
+/** First match wins, in this order. No match falls back to the number's turn of the wheel. */
+export declare const DIRECTION_KEYWORDS: ReadonlyArray<readonly [DirectionKey, readonly string[]]>;
+/** Arcs in order. `maxNumber` is the inclusive last episode number; the last arc is open-ended. */
+export declare const ARC_BOUNDARIES: ReadonlyArray<{
+    key: ArcKey;
+    maxNumber?: number;
+}>;
+export declare function inferTheme(entry: ReadableEntry): string;
+export declare function inferDirection(entry: ReadableEntry): DirectionKey;
+export declare function inferArc(entry: ReadableEntry): ArcKey;
+export declare function readEpisode(entry: ReadableEntry): EpisodeReadings;
+//# sourceMappingURL=readings.d.ts.map

package/dist/readings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readings.d.ts","sourceRoot":"","sources":["../src/readings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAEzE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;AAC9D,MAAM,MAAM,MAAM,GACd,wBAAwB,GACxB,uBAAuB,GACvB,wBAAwB,CAAA;AAE5B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,YAAY,CAAA;IACvB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,sDAAsD;AACtD,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAA;AAEhH,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAAuC,CAAA;AAE1F,sEAAsE;AACtE,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAQ9E,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,SAAS,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC,CAKxF,CAAA;AAED,mGAAmG;AACnG,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAI7E,CAAA;AASD,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAMvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAQjE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAOrD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,CAEjE"}

package/dist/readings.js

@@ -0,0 +1,73 @@
+/**
+ * Episode readings: the theme, direction and arc a surface groups an episode
+ * under (jgwill/Miadi#506, moved here by jgwill/Miadi#706).
+ *
+ * The catalog (`buildChronicleCatalog`) carries no direction, theme or arc.
+ * Those are *readings* of an episode, not facts on disk: keyword guesses over
+ * its folder name, slug, title, type and status. They live here so the web
+ * room (`app/chronicle`) and the terminal browser read an episode by the same
+ * rule. Pure and deterministic, with no I/O, so it is safe in a client bundle
+ * through the `@miadi/inquiry-weave/readings` subpath.
+ */
+export const DIRECTION_ORDER = ["east", "south", "west", "north"];
+/** First match wins, in this order. No match reads as "chronicle". */
+export const THEME_KEYWORDS = [
+    ["ceremony", ["ceremony", "ceremonial", "medicine-wheel", "medicine wheel", "fire-keeper", "sacred", "relational", "council-table", "wheel"]],
+    ["orchestration", ["orchestrat", "conductor", "herd", "dispatch", "coordination", "delegation", "multi-agent", "pane", "tmux", "consolidat"]],
+    ["runtime", ["runtime", "hermes", "tide", "socket", "boundary", "launch", "server", "a2a", "gateway"]],
+    ["agents", ["agent", "skill", "copilot", "claude", "ava", "navigator", "operator", "witness"]],
+    ["inquiry", ["inquiry", "pde", "decompos", "question", "qmd", "tension", "structural", "glossary"]],
+    ["memory", ["memory", "episodic", "continuity", "ledger", "redis", "data-layer", "data layer", "persistence"]],
+    ["portal", ["portal", "house", "threshold", "tushell", "lantern", "tree"]],
+];
+/** First match wins, in this order. No match falls back to the number's turn of the wheel. */
+export const DIRECTION_KEYWORDS = [
+    ["east", ["portal", "threshold", "vision", "outline", "glossary", "plan", "foundation", "begin", "prelude", "lantern", "seed"]],
+    ["south", ["orchestrat", "runtime", "build", "agent", "delegation", "pipeline", "integration", "evolution", "growth", "gateway", "dispatch"]],
+    ["west", ["reflection", "review", "witness", "narration", "revision", "retrospect", "editor", "closure", "note", "triage", "media"]],
+    ["north", ["wisdom", "council", "memory", "ledger", "accountab", "security", "governance", "snapshot", "chronicle-data", "witness-layer"]],
+];
+/** Arcs in order. `maxNumber` is the inclusive last episode number; the last arc is open-ended. */
+export const ARC_BOUNDARIES = [
+    { key: "Book I · The Threshold", maxNumber: 27 },
+    { key: "Book II · The Orchard", maxNumber: 103 },
+    { key: "Book III · The Council" },
+];
+function haystack(entry) {
+    return [entry.name, entry.slug, entry.title, entry.type, entry.status]
+        .filter(Boolean)
+        .join(" ")
+        .toLowerCase();
+}
+export function inferTheme(entry) {
+    const h = haystack(entry);
+    for (const [theme, kws] of THEME_KEYWORDS) {
+        if (kws.some((k) => h.includes(k)))
+            return theme;
+    }
+    return "chronicle";
+}
+export function inferDirection(entry) {
+    const h = haystack(entry);
+    for (const [dir, kws] of DIRECTION_KEYWORDS) {
+        if (kws.some((k) => h.includes(k)))
+            return dir;
+    }
+    // No keyword: rotate by number so episodes still flow through all four
+    // directions. This is why a reading is not a fact the episode declared.
+    return DIRECTION_ORDER[(entry.number ?? 0) % 4];
+}
+export function inferArc(entry) {
+    const n = entry.number;
+    if (n === undefined)
+        return "Book II · The Orchard";
+    for (const arc of ARC_BOUNDARIES) {
+        if (arc.maxNumber === undefined || n <= arc.maxNumber)
+            return arc.key;
+    }
+    return ARC_BOUNDARIES[ARC_BOUNDARIES.length - 1].key;
+}
+export function readEpisode(entry) {
+    return { theme: inferTheme(entry), direction: inferDirection(entry), arc: inferArc(entry) };
+}
+//# sourceMappingURL=readings.js.map

package/dist/readings.js.map

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

package/dist/text-references.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Find the chronicle, ceremony and circle references in a piece of text
+ * (jgwill/Miadi#706).
+ *
+ * A web page folds `{{ … }}` directives into links and lets its markdown
+ * parser hand it each href (`app/chronicle/lib/dsl.ts`). A terminal has no
+ * such parser, so this module scans the text once and returns every reference
+ * with its position, in the forms SPEC.md §3 and §9 allow:
+ *
+ * - directive: `{{ miadi-chronicle:126 | label="Mila" }}`, `{{ ceremony:cede9d8f }}`,
+ *   `{{ circle:1790153219791:zv10r2 }}`, `{{ miadi-circle:… }}`
+ * - link: `[text](miadi-chronicle:126)`
+ * - autolink: `<miadi-ceremony:…>`
+ * - bare: `**Episode:** miadi-chronicle://349`, as ceremony notes are written
+ *
+ * Code spans and fenced blocks are skipped, and every candidate must parse
+ * with `parseMiadiChronicleUri` or `parseWheelRefUri`, so nothing malformed
+ * becomes a chip. Short wheel forms expand by syntax alone, as the app does:
+ * a ceremony UUID prefix stays a prefix, for the wheel to match or refuse.
+ * Pure, no I/O.
+ */
+import { type WheelRefKind } from "./chronicle-dsl.js";
+export type TextReferenceKind = "chronicle" | WheelRefKind;
+export type TextReferenceForm = "directive" | "link" | "autolink" | "bare";
+export interface TextReference {
+    /** Offset of the first character of `raw` in the text. */
+    start: number;
+    /** Offset just past `raw`. */
+    end: number;
+    /** The source text of the whole reference, brackets and braces included. */
+    raw: string;
+    kind: TextReferenceKind;
+    form: TextReferenceForm;
+    /** The reference to resolve: a `miadi-chronicle:` URI as written, or a canonical `miadi-ceremony:` / `miadi-circle:` URI. */
+    uri: string;
+    /** The words the author gave it (link text or `label=`), if any. */
+    label?: string;
+    /** Rendering options (`show`, `label`, …) from a directive tail or `mc.*` params. */
+    options: Record<string, string>;
+}
+/** The wheel id a short form names: `circle:<rest>`, a ceremony UUID (or prefix), or `ceremony:<rest>`. */
+export declare function expandWheelShortForm(kind: WheelRefKind, rest: string): string;
+/** Every reference in `text`, in reading order. Code spans and fences are skipped. */
+export declare function findTextReferences(text: string): TextReference[];
+//# sourceMappingURL=text-references.d.ts.map

package/dist/text-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-references.d.ts","sourceRoot":"","sources":["../src/text-references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,YAAY,CAAA;AAC1D,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAA;AAE1E,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,iBAAiB,CAAA;IACvB,IAAI,EAAE,iBAAiB,CAAA;IACvB,6HAA6H;IAC7H,GAAG,EAAE,MAAM,CAAA;IACX,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAqBD,2GAA2G;AAC3G,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7E;AAqDD,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAShE"}

package/dist/text-references.js

@@ -0,0 +1,106 @@
+/**
+ * Find the chronicle, ceremony and circle references in a piece of text
+ * (jgwill/Miadi#706).
+ *
+ * A web page folds `{{ … }}` directives into links and lets its markdown
+ * parser hand it each href (`app/chronicle/lib/dsl.ts`). A terminal has no
+ * such parser, so this module scans the text once and returns every reference
+ * with its position, in the forms SPEC.md §3 and §9 allow:
+ *
+ * - directive: `{{ miadi-chronicle:126 | label="Mila" }}`, `{{ ceremony:cede9d8f }}`,
+ *   `{{ circle:1790153219791:zv10r2 }}`, `{{ miadi-circle:… }}`
+ * - link: `[text](miadi-chronicle:126)`
+ * - autolink: `<miadi-ceremony:…>`
+ * - bare: `**Episode:** miadi-chronicle://349`, as ceremony notes are written
+ *
+ * Code spans and fenced blocks are skipped, and every candidate must parse
+ * with `parseMiadiChronicleUri` or `parseWheelRefUri`, so nothing malformed
+ * becomes a chip. Short wheel forms expand by syntax alone, as the app does:
+ * a ceremony UUID prefix stays a prefix, for the wheel to match or refuse.
+ * Pure, no I/O.
+ */
+import { canonicalWheelRef, parseMiadiChronicleUri, parseWheelRefUri, } from "./chronicle-dsl.js";
+// Directives are single-line, and their option tail is one quantifier (the
+// app's review found a cubic backtrack with three: jgwill/Miadi#680, F2).
+const CHRONICLE_DIRECTIVE_RE = /\{\{[ \t]*(miadi-chronicle:(?:\/\/)?[^|}\s]+)[ \t]*(?:\|([^}\n]*))?\}\}/gi;
+const WHEEL_DIRECTIVE_RE = /\{\{[ \t]*(miadi-)?(ceremony|circle):(?:\/\/)?([A-Za-z0-9._~:-]+)\/?[ \t]*(?:\|([^}\n]*))?\}\}/gi;
+const LINK_RE = /\[((?:\\.|[^\]\\\n])*)\]\((miadi-(?:chronicle|ceremony|circle):[^)\s]+)\)/gi;
+const AUTOLINK_RE = /<(miadi-(?:chronicle|ceremony|circle):[^>\s]+)>/gi;
+const BARE_RE = /miadi-(?:chronicle|ceremony|circle):(?:\/\/)?[A-Za-z0-9._~:/?=&%#+-]+/gi;
+const CODE_RE = /```[\s\S]*?(?:```|$(?![\s\S]))|~~~[\s\S]*?(?:~~~|$(?![\s\S]))|`[^`\n]+`/g;
+const HEX_ID_RE = /^[0-9a-f][0-9a-f-]*$/i;
+const OPTION_RE = /([A-Za-z0-9._~-]+)\s*=\s*(?:"([^"\n]*)"|([A-Za-z0-9._~/-]+))/g;
+function parseOptionTail(tail) {
+    const options = {};
+    if (!tail)
+        return options;
+    for (const m of tail.matchAll(OPTION_RE))
+        options[m[1]] = m[2] !== undefined ? m[2] : m[3];
+    return options;
+}
+/** The wheel id a short form names: `circle:<rest>`, a ceremony UUID (or prefix), or `ceremony:<rest>`. */
+export function expandWheelShortForm(kind, rest) {
+    if (kind === "circle")
+        return `circle:${rest}`;
+    return HEX_ID_RE.test(rest) ? rest : `ceremony:${rest}`;
+}
+/** Parse one href or bare mention into a reference, or null. */
+function fromUri(uri, form, label) {
+    const chronicle = parseMiadiChronicleUri(uri);
+    if (chronicle) {
+        const authored = label ?? chronicle.options.label;
+        return { kind: "chronicle", form, uri: chronicle.uri, options: chronicle.options, ...(authored ? { label: authored } : {}) };
+    }
+    const wheel = parseWheelRefUri(uri);
+    if (wheel) {
+        const authored = label ?? wheel.options.label;
+        return { kind: wheel.kind, form, uri: wheel.canonical, options: wheel.options, ...(authored ? { label: authored } : {}) };
+    }
+    return null;
+}
+function scan(text, offset, out) {
+    const taken = [];
+    const free = (start, end) => taken.every(([s, e]) => end <= s || start >= e);
+    const add = (start, raw, candidate) => {
+        const end = start + raw.length;
+        if (!candidate || !free(start, end))
+            return;
+        taken.push([start, end]);
+        out.push({ start: offset + start, end: offset + end, raw, ...candidate });
+    };
+    for (const m of text.matchAll(CHRONICLE_DIRECTIVE_RE)) {
+        const options = parseOptionTail(m[2]);
+        const found = fromUri(m[1], "directive", options.label);
+        add(m.index, m[0], found && { ...found, options: { ...found.options, ...options } });
+    }
+    for (const m of text.matchAll(WHEEL_DIRECTIVE_RE)) {
+        const kind = m[2].toLowerCase();
+        const id = m[1] ? m[3] : expandWheelShortForm(kind, m[3]);
+        const options = parseOptionTail(m[4]);
+        const found = fromUri(canonicalWheelRef(kind, id), "directive", options.label);
+        add(m.index, m[0], found && { ...found, options: { ...found.options, ...options } });
+    }
+    for (const m of text.matchAll(LINK_RE)) {
+        const label = m[1].replace(/\\([\\[\]])/g, "$1");
+        add(m.index, m[0], fromUri(m[2], "link", label || undefined));
+    }
+    for (const m of text.matchAll(AUTOLINK_RE))
+        add(m.index, m[0], fromUri(m[1], "autolink"));
+    for (const m of text.matchAll(BARE_RE)) {
+        // Sentence punctuation after a bare mention is not part of it.
+        const raw = m[0].replace(/[.,;:!?)\]'"~_-]+$/, "");
+        add(m.index, raw, fromUri(raw, "bare"));
+    }
+}
+/** Every reference in `text`, in reading order. Code spans and fences are skipped. */
+export function findTextReferences(text) {
+    const out = [];
+    let at = 0;
+    for (const m of text.matchAll(CODE_RE)) {
+        scan(text.slice(at, m.index), at, out);
+        at = m.index + m[0].length;
+    }
+    scan(text.slice(at), at, out);
+    return out.sort((left, right) => left.start - right.start);
+}
+//# sourceMappingURL=text-references.js.map

package/dist/text-references.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/inquiry-weave",
-  "version": "0.14.3",
+  "version": "0.15.0",
   "description": "Relate and sync IAIP inquiry artefacts, their GitHub issues, and miadi-chronicle episodes. Creates vessels and relations only — never inquiry content.",
   "publishConfig": {
     "access": "public"
@@ -14,6 +14,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./readings": {
+      "types": "./dist/readings.d.ts",
+      "import": "./dist/readings.js",
+      "default": "./dist/readings.js"
+    },
     "./package.json": "./package.json"
   },
   "bin": {