@miadi/inquiry-weave 0.16.6 → 0.17.1

package/dist/prototype.js

@@ -0,0 +1,286 @@
+/**
+ * The prototype seam — a prototype entering an episode, in the shape the
+ * review (jgwill/Miadi#630) and foundation (#713) seams set: one reusable
+ * `prototype:<slug>` node on the wheel, one `chronicle:<episode>` →
+ * `prototype:<slug>` edge whose relationship type names what the episode does
+ * with it (`is-prototyped-in` when nobody said), and an entry in
+ * `episode.yaml`'s `prototypes:` list.
+ *
+ * Two addresses, two reaches. The published address goes in the manifest
+ * and on the node (`public_url`). The editing address (a v0 chat, say) goes
+ * in the node's metadata only (`editor_url`) and is handed out by the door to
+ * a viewer who may edit the episode; it is never written in `episode.yaml`,
+ * which is served to every reader of the episode. Rules kept from the other
+ * seams: the manifest entry is written once and never overwritten, one
+ * ordered node pair is one edge, and the wheel projection never throws.
+ * Ref: jgwill/Miadi#769 (A2), jgwill/miadi-orchestration-kit#80.
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname } from "node:path";
+import { Scalar, isMap, isScalar, isSeq, parseDocument } from "yaml";
+import { DEFAULT_PROTOTYPE_RELATION, PROTOTYPE_ENTRY_KEYS, PROTOTYPE_NODE_KIND, isPrototypeSlug, prototypeNodeId, prototypeReference, prototypeSlugOf, prototypeUrlOf, toEpisodePrototypeEntry, } from "@miadi/episodic-memory-schema";
+import { missingManifestRemedy } from "./episode.js";
+import { edgesFrom, failure, wheelJson } from "./review.js";
+export class PrototypeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "PrototypeError";
+    }
+}
+/** The slug an input names: a slug or `miadi-prototype:<slug>`. */
+export function requirePrototypeSlug(raw) {
+    const text = typeof raw === "string" ? raw.trim() : "";
+    if (isPrototypeSlug(text))
+        return text;
+    const slug = prototypeSlugOf(text);
+    if (slug)
+        return slug;
+    throw new PrototypeError("invalid_prototype", `prototype '${String(raw)}' is not a slug or a miadi-prototype: reference`);
+}
+/** The published address an input names, or a refusal. */
+export function requirePrototypeUrl(raw) {
+    const url = prototypeUrlOf(raw);
+    if (!url)
+        throw new PrototypeError("invalid_prototype", `prototype address '${String(raw)}' must be an https URL`);
+    if (looksLikeEditor(url))
+        throw new PrototypeError("invalid_prototype", `'${url}' is an editing address; give the published address as url and this one as editor`);
+    return url;
+}
+/** A v0 chat page is where a prototype is edited, never where it is published. */
+export function looksLikeEditor(url) {
+    try {
+        const u = new URL(url);
+        return /(^|\.)v0\.(app|dev)$/i.test(u.hostname) && /\/chat\//.test(u.pathname);
+    }
+    catch {
+        return false;
+    }
+}
+/** The published and the editing address are two doors; one URL cannot be both. */
+export function assertDistinctPrototypeAddresses(url, editor) {
+    if (editor && editor === url)
+        throw new PrototypeError("invalid_prototype", "the editing address equals the published address; a reader would be handed the editor");
+}
+/** The editing address, when given: https, kept off the manifest. */
+export function optionalEditorUrl(raw) {
+    if (raw === undefined || raw === null || raw === "")
+        return undefined;
+    const url = prototypeUrlOf(raw);
+    if (url)
+        return url;
+    throw new PrototypeError("invalid_prototype", `editing address '${String(raw)}' must be an https URL`);
+}
+function quoted(doc, value) {
+    const node = doc.createNode(value);
+    node.type = Scalar.QUOTE_SINGLE;
+    return node;
+}
+function valueNode(doc, value) {
+    if (Array.isArray(value)) {
+        const seq = doc.createNode([]);
+        for (const item of value)
+            seq.items.push(quoted(doc, item));
+        return seq;
+    }
+    return quoted(doc, value);
+}
+function entryNode(doc, entry) {
+    const map = doc.createNode({});
+    for (const key of PROTOTYPE_ENTRY_KEYS) {
+        const value = entry[key];
+        if (value === undefined || value === "" || (Array.isArray(value) && value.length === 0))
+            continue;
+        map.set(key, valueNode(doc, value));
+    }
+    return map;
+}
+const sameEntry = (a, b) => a !== null && a.id === b.id;
+/**
+ * Add a prototype to `episode.yaml`'s `prototypes:` list, or fill the keys an
+ * existing entry lacks. Comments, key order and every other field survive.
+ * Refuses a `prototypes` key that is not a list. Never writes an editing address.
+ */
+export async function upsertEpisodePrototype(input) {
+    if (!existsSync(input.episodeYamlPath)) {
+        throw new PrototypeError("prototype_manifest_conflict", missingManifestRemedy(dirname(input.episodeYamlPath)));
+    }
+    const doc = parseDocument(await readFile(input.episodeYamlPath, "utf8"));
+    if (doc.errors.length > 0) {
+        throw new PrototypeError("prototype_manifest_conflict", `unreadable episode.yaml ${input.episodeYamlPath}: ${doc.errors[0].message}`);
+    }
+    if (!isMap(doc.contents)) {
+        throw new PrototypeError("prototype_manifest_conflict", `episode.yaml ${input.episodeYamlPath} is not a mapping`);
+    }
+    const list = doc.get("prototypes", true);
+    let created = false;
+    const filled = [];
+    let entry;
+    if (list === undefined || list === null || (isScalar(list) && (list.value === null || list.value === undefined))) {
+        created = true;
+        entry = input.entry;
+        const seq = doc.createNode([]);
+        seq.items.push(entryNode(doc, entry));
+        if (isScalar(list) && list.comment)
+            seq.comment = list.comment;
+        doc.set("prototypes", seq);
+    }
+    else if (!isSeq(list)) {
+        throw new PrototypeError("prototype_manifest_conflict", `prototypes in ${input.episodeYamlPath} is not a list — refusing to overwrite`);
+    }
+    else {
+        const index = list.items.findIndex((item) => sameEntry(toEpisodePrototypeEntry(isMap(item) ? item.toJSON() : item), input.entry));
+        if (index < 0) {
+            created = true;
+            entry = input.entry;
+            list.items.push(entryNode(doc, entry));
+        }
+        else {
+            const item = list.items[index];
+            if (!isMap(item)) {
+                entry = input.entry;
+            }
+            else {
+                for (const key of PROTOTYPE_ENTRY_KEYS) {
+                    const value = input.entry[key];
+                    if (value === undefined || value === "" || (Array.isArray(value) && value.length === 0))
+                        continue;
+                    const present = item.get(key);
+                    if (present === undefined || present === null || present === "") {
+                        item.set(key, valueNode(doc, value));
+                        filled.push(key);
+                    }
+                }
+                entry = toEpisodePrototypeEntry(item.toJSON()) ?? input.entry;
+            }
+        }
+    }
+    const wrote = (created || filled.length > 0) && !input.dryRun;
+    if (wrote)
+        await writeFile(input.episodeYamlPath, doc.toString(), "utf8");
+    return { entry, created, filled, wrote, dryRun: input.dryRun === true };
+}
+/** The relationship type of an episode→prototype edge already on the wheel. Never throws. */
+export async function existingPrototypeRelation(mwUrl, episodeNodeId, nodeId, options = {}) {
+    const listing = await wheelJson(options.fetchImpl ?? fetch, `${mwUrl.replace(/\/+$/, "")}/api/edges?limit=all`);
+    if (!listing.ok)
+        return undefined;
+    const edge = edgesFrom(listing.body).find((e) => String(e.from_id) === episodeNodeId && String(e.to_id) === nodeId);
+    return typeof edge?.relationship_type === "string" && edge.relationship_type ? edge.relationship_type : undefined;
+}
+/** The editing address a prototype node holds, for a viewer the door has already checked. Never throws. */
+export async function prototypeEditorUrl(mwUrl, slug, options = {}) {
+    const read = await wheelJson(options.fetchImpl ?? fetch, `${mwUrl.replace(/\/+$/, "")}/api/nodes/${encodeURIComponent(prototypeNodeId(slug))}`);
+    if (!read.ok)
+        return undefined;
+    const editor = read.body?.node?.metadata?.editor_url;
+    return typeof editor === "string" && editor ? editor : undefined;
+}
+/**
+ * Put the prototype node and the episode→prototype edge on the wheel. A
+ * prototype is a `knowledge` node. When the node exists, only an editing
+ * address it lacks is added, so a hand-written name and description stay.
+ */
+export async function projectEpisodePrototype(mwUrl, input, options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const base = mwUrl.replace(/\/+$/, "");
+    const nodeId = prototypeNodeId(input.entry.id);
+    const edgeId = `${input.episodeNodeId}:${nodeId}`;
+    const projection = {
+        node: { id: nodeId, state: "pending" },
+        edge: { id: edgeId, state: "pending", relationship_type: input.relation },
+    };
+    const nodeUrl = `${base}/api/nodes/${encodeURIComponent(nodeId)}`;
+    const read = await wheelJson(fetchImpl, nodeUrl);
+    if (read.ok) {
+        const node = read.body?.node;
+        if (!input.editor || node?.metadata?.editor_url) {
+            projection.node.state = "already-present";
+        }
+        else if (options.dryRun) {
+            projection.node.state = "skipped";
+        }
+        else {
+            const patched = await wheelJson(fetchImpl, nodeUrl, {
+                method: "PATCH",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({ metadata: { editor_url: input.editor } }),
+            });
+            projection.node = patched.ok ? { id: nodeId, state: "refreshed" } : { id: nodeId, state: "pending", error: failure("PATCH", nodeUrl, patched) };
+        }
+    }
+    else if (read.status === 404) {
+        if (options.dryRun) {
+            projection.node.state = "skipped";
+        }
+        else {
+            const title = input.entry.title ?? input.entry.id;
+            const created = await wheelJson(fetchImpl, `${base}/api/nodes`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({
+                    id: nodeId,
+                    type: "knowledge",
+                    name: `Prototype — ${title}`,
+                    description: `A prototype made from episode ${input.episodeFolder}: ${title}.`,
+                    direction: "south",
+                    metadata: {
+                        kind: PROTOTYPE_NODE_KIND,
+                        slug: input.entry.id,
+                        public_url: input.entry.url,
+                        address: prototypeReference(input.entry.id),
+                        episode_path: input.episodeFolder,
+                        ...(input.entry.made_with ? { made_with: input.entry.made_with } : {}),
+                        ...(input.entry.source ? { source: input.entry.source } : {}),
+                        ...(input.entry.commit ? { commit: input.entry.commit } : {}),
+                        ...(input.entry.issue ? { issue: input.entry.issue } : {}),
+                        ...(input.entry.reads?.length ? { reads: input.entry.reads } : {}),
+                        ...(input.editor ? { editor_url: input.editor } : {}),
+                    },
+                }),
+            });
+            projection.node = created.ok ? { id: nodeId, state: "created" } : { id: nodeId, state: "pending", error: failure("POST", `${base}/api/nodes`, created) };
+        }
+    }
+    else {
+        projection.node = { id: nodeId, state: "pending", error: failure("GET", nodeUrl, read) };
+    }
+    if (projection.node.state === "pending") {
+        projection.edge.error = "the prototype node is not on the wheel yet";
+        return projection;
+    }
+    const edgesUrl = `${base}/api/edges`;
+    const listing = await wheelJson(fetchImpl, `${edgesUrl}?limit=all`);
+    if (!listing.ok) {
+        projection.edge.error = failure("GET", edgesUrl, listing);
+        return projection;
+    }
+    const existing = edgesFrom(listing.body).find((edge) => String(edge.from_id) === input.episodeNodeId && String(edge.to_id) === nodeId);
+    if (existing) {
+        projection.edge = { id: edgeId, state: "already-present", relationship_type: String(existing.relationship_type ?? input.relation) };
+        return projection;
+    }
+    if (options.dryRun) {
+        projection.edge.state = "skipped";
+        return projection;
+    }
+    const posted = await wheelJson(fetchImpl, edgesUrl, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ from_id: input.episodeNodeId, to_id: nodeId, relationship_type: input.relation, strength: 1, obligations: [] }),
+    });
+    if (posted.ok && posted.body?.replaced === true) {
+        projection.edge = { id: edgeId, state: "pending", relationship_type: input.relation, error: "the wheel replaced an edge the listing did not show; check the edge by hand" };
+    }
+    else if (posted.ok)
+        projection.edge.state = "created";
+    else if (posted.status === 409)
+        projection.edge.state = "already-present";
+    else
+        projection.edge.error = failure("POST", edgesUrl, posted);
+    return projection;
+}
+export { DEFAULT_PROTOTYPE_RELATION };
+//# sourceMappingURL=prototype.js.map

package/dist/prototype.js.map

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

package/dist/references.d.ts

@@ -7,6 +7,8 @@
  */
 export * from "./chronicle-dsl.js";
 export * from "./foundation-dsl.js";
+export * from "./artefact-dsl.js";
+export * from "./rise-dsl.js";
 export * from "./text-references.js";
 export * from "./markdown-directives.js";
 //# sourceMappingURL=references.d.ts.map

package/dist/references.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA"}
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA"}

package/dist/references.js

@@ -7,6 +7,8 @@
  */
 export * from "./chronicle-dsl.js";
 export * from "./foundation-dsl.js";
+export * from "./artefact-dsl.js";
+export * from "./rise-dsl.js";
 export * from "./text-references.js";
 export * from "./markdown-directives.js";
 //# sourceMappingURL=references.js.map

package/dist/references.js.map

@@ -1 +1 @@
-{"version":3,"file":"references.js","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA"}
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA"}

package/dist/rise-dsl.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The RISE address — a specification, wherever its repository is checked out
+ * (jgwill/Miadi#769, A4; Guillaume, 2026-10-10: "rise://<owner>/<repo>/<filepath>
+ * that way we just have to wire something locally of where the repo is").
+ *
+ *   rise://<owner>/<repo>/<path>[@<commit>]
+ *
+ *   rise://jgwill/Miadi/rispecs/AGENTS.md
+ *   rise://jgwill/llms-txt/llms-rise-framework.txt@27cf18f
+ *   rise://jgwill/episodes/miadi-chronicle/2026-10-10-episode-552-x/rispecs/what-an-episode-holds/SPEC.md
+ *
+ * The address names the repository and the file, never a host path. Where
+ * that repository is checked out on this host is a local map, read by the
+ * server-only `rise-workspaces.ts` (exported from the package root, never from
+ * `./references`, which stays free of Node so a browser can take it). A host
+ * with no checkout opens the file on GitHub.
+ * Grounding: foundations/resource-addressing-and-terminal-hypermedia/.
+ */
+export declare const RISE_SCHEME = "rise:";
+export interface ParsedRiseUri {
+    uri: string;
+    canonical: string;
+    owner: string;
+    repo: string;
+    /** Repository-relative path, forward slashes, no leading slash. */
+    path: string;
+    /** A commit, tag or branch the address pins. */
+    commit?: string;
+    query: Record<string, string>;
+    options: Record<string, string>;
+    fragment?: string;
+}
+export declare function isRiseUri(href: string | undefined): boolean;
+export declare function canonicalRiseRef(owner: string, repo: string, path: string, commit?: string): string;
+export declare function parseRiseUri(uri: string): ParsedRiseUri | null;
+/** The wheel node id a spec address names: `rise:<owner>/<repo>/<path>` (no commit: one node per file). */
+export declare function riseNodeId(parsed: Pick<ParsedRiseUri, "owner" | "repo" | "path">): string;
+/** Repositories whose remote is not GitHub: `jgwill/episodes` lives on gaia (`/srv/git/jgwill/episodes.git`). */
+export declare const RISE_REPOS_WITHOUT_GITHUB: ReadonlySet<string>;
+/** The file on GitHub, at the pinned commit or at HEAD of the default branch; null when the repository has no GitHub page. */
+export declare function riseGithubUrl(parsed: Pick<ParsedRiseUri, "owner" | "repo" | "path" | "commit" | "fragment">, defaultRef?: string): string | null;
+/** Every `rise:` address in a text, as written, in order of first appearance; code is skipped. */
+export declare function extractRiseUris(text: string): string[];
+//# sourceMappingURL=rise-dsl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rise-dsl.d.ts","sourceRoot":"","sources":["../src/rise-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,eAAO,MAAM,WAAW,UAAU,CAAA;AAElC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AASD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE3D;AAUD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnG;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAyB9D;AAED,2GAA2G;AAC3G,wBAAgB,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAEzF;AAED,iHAAiH;AACjH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAAgC,CAAA;AAE1F,8HAA8H;AAC9H,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC,EAAE,UAAU,SAAS,GAAG,MAAM,GAAG,IAAI,CAKhJ;AAED,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAatD"}

package/dist/rise-dsl.js

@@ -0,0 +1,99 @@
+/**
+ * The RISE address — a specification, wherever its repository is checked out
+ * (jgwill/Miadi#769, A4; Guillaume, 2026-10-10: "rise://<owner>/<repo>/<filepath>
+ * that way we just have to wire something locally of where the repo is").
+ *
+ *   rise://<owner>/<repo>/<path>[@<commit>]
+ *
+ *   rise://jgwill/Miadi/rispecs/AGENTS.md
+ *   rise://jgwill/llms-txt/llms-rise-framework.txt@27cf18f
+ *   rise://jgwill/episodes/miadi-chronicle/2026-10-10-episode-552-x/rispecs/what-an-episode-holds/SPEC.md
+ *
+ * The address names the repository and the file, never a host path. Where
+ * that repository is checked out on this host is a local map, read by the
+ * server-only `rise-workspaces.ts` (exported from the package root, never from
+ * `./references`, which stays free of Node so a browser can take it). A host
+ * with no checkout opens the file on GitHub.
+ * Grounding: foundations/resource-addressing-and-terminal-hypermedia/.
+ */
+import { OPTION_PREFIX } from "./chronicle-dsl.js";
+export const RISE_SCHEME = "rise:";
+const NAME = "[A-Za-z0-9][A-Za-z0-9._-]{0,99}";
+// [1]=owner [2]=repo [3]=path [4]=commit [5]=query [6]=fragment
+const RISE_URI_RE = new RegExp(`^rise:(?:\\/\\/)?(${NAME})\\/(${NAME})\\/((?:[A-Za-z0-9._~-]{1,128}\\/){0,16}[A-Za-z0-9._~-]{1,128})(?:@([A-Za-z0-9._\\/-]{1,80}))?(?:\\?([^#\\u0000-\\u001f\\u007f-\\u009f]*))?(?:#([^\\u0000-\\u001f\\u007f-\\u009f]*))?$`, "i");
+export function isRiseUri(href) {
+    return typeof href === "string" && /^rise:/i.test(href.trim());
+}
+function safeDecode(s) {
+    try {
+        return decodeURIComponent(s);
+    }
+    catch {
+        return s;
+    }
+}
+export function canonicalRiseRef(owner, repo, path, commit) {
+    return `${RISE_SCHEME}//${owner}/${repo}/${path}${commit ? `@${commit}` : ""}`;
+}
+export function parseRiseUri(uri) {
+    const trimmed = uri.trim();
+    const m = RISE_URI_RE.exec(trimmed);
+    if (!m || !m[1] || !m[2] || !m[3])
+        return null;
+    const [, owner, repo, path, commit] = m;
+    const segments = path.split("/");
+    if (segments.some((s) => s === "." || s === ".." || s.startsWith(".")))
+        return null;
+    if (owner.includes("..") || repo.includes(".."))
+        return null;
+    const query = {};
+    const options = {};
+    for (const pair of (m[5] ?? "").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 fragment = m[6] || undefined;
+    const params = [
+        ...Object.entries(query).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`),
+        ...Object.entries(options).map(([k, v]) => `${OPTION_PREFIX}${encodeURIComponent(k)}=${encodeURIComponent(v)}`),
+    ];
+    const canonical = canonicalRiseRef(owner, repo, path, commit) + (params.length > 0 ? `?${params.join("&")}` : "") + (fragment ? `#${fragment}` : "");
+    return { uri: trimmed, canonical, owner: owner, repo: repo, path: path, ...(commit ? { commit } : {}), query, options, ...(fragment ? { fragment } : {}) };
+}
+/** The wheel node id a spec address names: `rise:<owner>/<repo>/<path>` (no commit: one node per file). */
+export function riseNodeId(parsed) {
+    return `rise:${parsed.owner}/${parsed.repo}/${parsed.path}`;
+}
+/** Repositories whose remote is not GitHub: `jgwill/episodes` lives on gaia (`/srv/git/jgwill/episodes.git`). */
+export const RISE_REPOS_WITHOUT_GITHUB = new Set(["jgwill/episodes"]);
+/** The file on GitHub, at the pinned commit or at HEAD of the default branch; null when the repository has no GitHub page. */
+export function riseGithubUrl(parsed, defaultRef = "HEAD") {
+    if (RISE_REPOS_WITHOUT_GITHUB.has(`${parsed.owner}/${parsed.repo}`))
+        return null;
+    const ref = parsed.commit ?? defaultRef;
+    const path = parsed.path.split("/").map(encodeURIComponent).join("/");
+    return `https://github.com/${encodeURIComponent(parsed.owner)}/${encodeURIComponent(parsed.repo)}/blob/${encodeURIComponent(ref)}/${path}${parsed.fragment ? `#${encodeURI(parsed.fragment)}` : ""}`;
+}
+/** Every `rise:` address in a text, as written, in order of first appearance; code is skipped. */
+export function extractRiseUris(text) {
+    const prose = text.replace(/```[\s\S]*?```/g, " ").replace(/`[^`\n]*`/g, " ");
+    const re = /(?<![\w/?=&%.~+:@#!-])rise:(?:\/\/)?[A-Za-z0-9._~:/?=&%#+@-]{1,600}/gi;
+    const seen = new Set();
+    const out = [];
+    for (const m of prose.matchAll(re)) {
+        const raw = m[0].replace(/[.,;:)\]]+$/, "");
+        if (!seen.has(raw) && parseRiseUri(raw)) {
+            seen.add(raw);
+            out.push(raw);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=rise-dsl.js.map

package/dist/rise-dsl.js.map

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

package/dist/rise-workspaces.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Where a `rise://` repository is checked out on this host — server-only
+ * (reads the filesystem), exported from the package root and never from
+ * `./references` (jgwill/Miadi#769, A4; review F1).
+ *
+ * Order: `MIADI_RISE_WORKSPACES` (JSON, `{ "owner/repo": "/path" }`), then
+ * `config/stc-workspaces.json` (its `workspaces[].repository` → `localPath`),
+ * then the `/workspace/repos/<owner>/<repo>` convention, then the checkouts
+ * this host is known to keep. `KNOWN_HOST_PATHS` is the reverse map, for
+ * manifests that cite a host path instead of an address.
+ */
+import type { HostPathRepository } from "@miadi/episodic-memory-schema";
+import type { ParsedRiseUri } from "./rise-dsl.js";
+/** Host paths older manifests cite, read as the repository they are checkouts of (gaia's layout). */
+export declare const KNOWN_HOST_PATHS: ReadonlyArray<HostPathRepository>;
+/** The checkouts this host keeps for repositories the workspace map may not list. */
+export declare const KNOWN_RISE_WORKSPACES: Record<string, string>;
+export interface RiseWorkspaceOptions {
+    env?: NodeJS.ProcessEnv;
+    /** The `config/stc-workspaces.json` to read; default is the Miadi checkout's. */
+    workspacesFile?: string;
+    /** The folder the `/workspace/repos/<owner>/<repo>` convention lives under. */
+    reposRoot?: string;
+    known?: Record<string, string>;
+}
+/**
+ * Where `<owner>/<repo>` is checked out on this host, or null. Order:
+ * `MIADI_RISE_WORKSPACES`, the stc workspaces map, `/workspace/repos`, the
+ * known checkouts. A path is answered only when it exists.
+ */
+export declare function riseWorkspacePath(owner: string, repo: string, options?: RiseWorkspaceOptions): string | null;
+/** The file a spec address names on this host, or null when the repository is not checked out here. */
+export declare function riseLocalPath(parsed: Pick<ParsedRiseUri, "owner" | "repo" | "path">, options?: RiseWorkspaceOptions): string | null;
+//# sourceMappingURL=rise-workspaces.d.ts.map

package/dist/rise-workspaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rise-workspaces.d.ts","sourceRoot":"","sources":["../src/rise-workspaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,qGAAqG;AACrG,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,kBAAkB,CAM9D,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIxD,CAAA;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,GAAG,IAAI,CAwBhH;AAED,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,GAAG,IAAI,CAKvI"}

package/dist/rise-workspaces.js

@@ -0,0 +1,73 @@
+/**
+ * Where a `rise://` repository is checked out on this host — server-only
+ * (reads the filesystem), exported from the package root and never from
+ * `./references` (jgwill/Miadi#769, A4; review F1).
+ *
+ * Order: `MIADI_RISE_WORKSPACES` (JSON, `{ "owner/repo": "/path" }`), then
+ * `config/stc-workspaces.json` (its `workspaces[].repository` → `localPath`),
+ * then the `/workspace/repos/<owner>/<repo>` convention, then the checkouts
+ * this host is known to keep. `KNOWN_HOST_PATHS` is the reverse map, for
+ * manifests that cite a host path instead of an address.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** Host paths older manifests cite, read as the repository they are checkouts of (gaia's layout). */
+export const KNOWN_HOST_PATHS = [
+    { prefix: "/src/Miadi/", owner: "jgwill", repo: "Miadi" },
+    { prefix: "/a/src/Miadi/", owner: "jgwill", repo: "Miadi" },
+    { prefix: "/a/src/Miadi-18/", owner: "jgwill", repo: "Miadi" },
+    { prefix: "/etc/claude-code/", owner: "jgwill", repo: "etc-claude-code" },
+    { prefix: "/srv/miadi/episodes/", owner: "jgwill", repo: "episodes" },
+];
+/** The checkouts this host keeps for repositories the workspace map may not list. */
+export const KNOWN_RISE_WORKSPACES = {
+    "jgwill/Miadi": "/a/src/Miadi",
+    "jgwill/etc-claude-code": "/etc/claude-code",
+    "jgwill/episodes": "/srv/miadi/episodes",
+};
+/**
+ * Where `<owner>/<repo>` is checked out on this host, or null. Order:
+ * `MIADI_RISE_WORKSPACES`, the stc workspaces map, `/workspace/repos`, the
+ * known checkouts. A path is answered only when it exists.
+ */
+export function riseWorkspacePath(owner, repo, options = {}) {
+    const env = options.env ?? process.env;
+    const key = `${owner}/${repo}`;
+    const candidates = [];
+    try {
+        const fromEnv = env.MIADI_RISE_WORKSPACES ? JSON.parse(env.MIADI_RISE_WORKSPACES) : {};
+        if (typeof fromEnv[key] === "string")
+            candidates.push(fromEnv[key]);
+    }
+    catch {
+        // an unreadable env map is no map
+    }
+    const file = options.workspacesFile ?? join(env.MIADI_SRC ?? "/a/src/Miadi", "config", "stc-workspaces.json");
+    try {
+        const doc = JSON.parse(readFileSync(file, "utf8"));
+        for (const w of doc.workspaces ?? []) {
+            if (w.repository === key && typeof w.localPath === "string")
+                candidates.push(w.localPath);
+        }
+    }
+    catch {
+        // no map on this host
+    }
+    candidates.push(join(options.reposRoot ?? "/workspace/repos", owner, repo));
+    const known = options.known ?? KNOWN_RISE_WORKSPACES;
+    if (known[key])
+        candidates.push(known[key]);
+    for (const candidate of candidates)
+        if (existsSync(candidate))
+            return candidate;
+    return null;
+}
+/** The file a spec address names on this host, or null when the repository is not checked out here. */
+export function riseLocalPath(parsed, options = {}) {
+    const root = riseWorkspacePath(parsed.owner, parsed.repo, options);
+    if (!root)
+        return null;
+    const file = join(root, ...parsed.path.split("/"));
+    return existsSync(file) ? file : null;
+}
+//# sourceMappingURL=rise-workspaces.js.map

package/dist/rise-workspaces.js.map

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