@miadi/inquiry-weave 0.18.5 → 0.18.7

package/dist/capability-dsl.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The capability scheme: the address of one thing a git repository provides
+ * to others (Episode 568's Capability Registry; the scheme decided by William
+ * on 2026-11-01):
+ *
+ *   miadi-capability:<owner>/<repo>/<kind>/<name>
+ *
+ *   miadi-capability://jgwill/medicine-wheel/cli/mw
+ *   miadi-capability://jgwill/medicine-wheel/skill/fire-keeper-check
+ *   miadi-capability://jgwill/Miadi/package/@miadi/inquiry-weave
+ *
+ * `<kind>` is what the repository provides it as: `package`, `cli` and `skill`
+ * are what `miadi-repomap scan` reads today. The grammar takes any lowercase
+ * word, so a kind the registry adds later (an MCP tool, an API route, a
+ * plugin) parses before it resolves. `<name>` is the capability's own name and
+ * may hold `/`, as a scoped package does.
+ *
+ * An address carries an identity and never a location: the registry answers
+ * which file it was read from, at which commit, and what it says. The door is
+ * `/api/chronicle/open`, which sends the reader to the capability's page. The
+ * grammar follows the other artefact schemes: `//` accepted on input and
+ * dropped from the canonical form, `mc.*` options folded, control characters
+ * refused because a reference is printed into terminals.
+ */
+export declare const MIADI_CAPABILITY_SCHEME = "miadi-capability:";
+export interface CapabilityAddressParts {
+    owner: string;
+    repo: string;
+    /** `package`, `cli`, `skill`, … */
+    kind: string;
+    /** The capability's own name; a scoped package keeps its `/`. */
+    name: string;
+}
+export interface ParsedCapabilityUri extends CapabilityAddressParts {
+    /** The full original URI, exactly as given. */
+    uri: string;
+    /** The canonical spelling: no `//`, options and fragment preserved. */
+    canonical: string;
+    /** `<owner>/<repo>/<kind>/<name>`. */
+    id: string;
+    /** Query params minus the mc.* rendering options. */
+    query: Record<string, string>;
+    /** mc.* rendering options, prefix stripped (show, label, …). */
+    options: Record<string, string>;
+    fragment?: string;
+}
+export declare function isCapabilityUri(href: string | undefined): boolean;
+/** The canonical address of a capability, without options. */
+export declare function canonicalCapabilityRef(parts: CapabilityAddressParts): string;
+/** The address as a person cites it in prose, with the `//` a terminal links: `miadi-capability://owner/repo/kind/name`. */
+export declare function capabilityCitation(parts: CapabilityAddressParts): string;
+export declare function parseCapabilityUri(uri: string): ParsedCapabilityUri | null;
+/** The capability's page on a Miadi front: `/capabilities/<owner>/<repo>/<kind>/<name>`. */
+export declare function capabilityPageRoute(parts: CapabilityAddressParts): string;
+/** Where a chip points: the host's open door, which sends the reader to the page. */
+export declare function capabilityOpenRoute(parts: CapabilityAddressParts): string;
+/** Every capability address in a text, as written, in order of first appearance. Code is not a reference. */
+export declare function extractCapabilityUris(text: string): string[];
+//# sourceMappingURL=capability-dsl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-dsl.d.ts","sourceRoot":"","sources":["../src/capability-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,eAAO,MAAM,uBAAuB,sBAAsB,CAAA;AAE1D,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAUD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjE;AAqBD,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAE5E;AAED,4HAA4H;AAC5H,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAExE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAgC1E;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAEzE;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAEzE;AAED,6GAA6G;AAC7G,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAa5D"}

package/dist/capability-dsl.js

@@ -0,0 +1,126 @@
+/**
+ * The capability scheme: the address of one thing a git repository provides
+ * to others (Episode 568's Capability Registry; the scheme decided by William
+ * on 2026-11-01):
+ *
+ *   miadi-capability:<owner>/<repo>/<kind>/<name>
+ *
+ *   miadi-capability://jgwill/medicine-wheel/cli/mw
+ *   miadi-capability://jgwill/medicine-wheel/skill/fire-keeper-check
+ *   miadi-capability://jgwill/Miadi/package/@miadi/inquiry-weave
+ *
+ * `<kind>` is what the repository provides it as: `package`, `cli` and `skill`
+ * are what `miadi-repomap scan` reads today. The grammar takes any lowercase
+ * word, so a kind the registry adds later (an MCP tool, an API route, a
+ * plugin) parses before it resolves. `<name>` is the capability's own name and
+ * may hold `/`, as a scoped package does.
+ *
+ * An address carries an identity and never a location: the registry answers
+ * which file it was read from, at which commit, and what it says. The door is
+ * `/api/chronicle/open`, which sends the reader to the capability's page. The
+ * grammar follows the other artefact schemes: `//` accepted on input and
+ * dropped from the canonical form, `mc.*` options folded, control characters
+ * refused because a reference is printed into terminals.
+ */
+import { OPTION_PREFIX } from "./chronicle-dsl.js";
+export const MIADI_CAPABILITY_SCHEME = "miadi-capability:";
+// [1]=path [2]=query [3]=fragment
+const CAPABILITY_URI_RE = /^miadi-capability:(?:\/\/)?([^?#\s\u0000-\u001f\u007f-\u009f]{1,400})(?:\?([^#\u0000-\u001f\u007f-\u009f]*))?(?:#([^\u0000-\u001f\u007f-\u009f]*))?$/i;
+/** A git owner or repository name, as GitHub and a host's bare repositories spell them. */
+const OWNER_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/;
+const KIND_RE = /^[a-z][a-z0-9-]{0,31}$/;
+/** One segment of a name: an npm name segment, a command, a skill name. */
+const NAME_SEGMENT_RE = /^[A-Za-z0-9@._~+-]{1,214}$/;
+export function isCapabilityUri(href) {
+    return typeof href === "string" && /^miadi-capability:/i.test(href.trim());
+}
+function safeDecode(s) {
+    try {
+        return decodeURIComponent(s);
+    }
+    catch {
+        return s;
+    }
+}
+/** `<owner>/<repo>/<kind>/<name>`, or null when the parts are not an address. */
+function partsOf(path) {
+    const segments = path.replace(/\/$/, "").split("/").map(safeDecode);
+    if (segments.length < 4)
+        return null;
+    const [owner, repo, kindWord, ...nameSegments] = segments;
+    const kind = kindWord.toLowerCase();
+    if (!OWNER_RE.test(owner) || !OWNER_RE.test(repo) || repo.endsWith(".git") || !KIND_RE.test(kind))
+        return null;
+    if (nameSegments.some((s) => !NAME_SEGMENT_RE.test(s) || s === "." || s === ".."))
+        return null;
+    return { owner, repo, kind, name: nameSegments.join("/") };
+}
+/** The canonical address of a capability, without options. */
+export function canonicalCapabilityRef(parts) {
+    return `${MIADI_CAPABILITY_SCHEME}${parts.owner}/${parts.repo}/${parts.kind}/${parts.name}`;
+}
+/** The address as a person cites it in prose, with the `//` a terminal links: `miadi-capability://owner/repo/kind/name`. */
+export function capabilityCitation(parts) {
+    return `${MIADI_CAPABILITY_SCHEME}//${parts.owner}/${parts.repo}/${parts.kind}/${parts.name}`;
+}
+export function parseCapabilityUri(uri) {
+    const trimmed = uri.trim();
+    const m = CAPABILITY_URI_RE.exec(trimmed);
+    if (!m || !m[1])
+        return null;
+    const parts = partsOf(m[1]);
+    if (!parts)
+        return null;
+    const query = {};
+    const options = {};
+    for (const pair of (m[2] ?? "").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[3] || 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 = canonicalCapabilityRef(parts) + (params.length > 0 ? `?${params.join("&")}` : "") + (fragment ? `#${fragment}` : "");
+    return {
+        uri: trimmed,
+        canonical,
+        ...parts,
+        id: `${parts.owner}/${parts.repo}/${parts.kind}/${parts.name}`,
+        query,
+        options,
+        ...(fragment ? { fragment } : {}),
+    };
+}
+/** The capability's page on a Miadi front: `/capabilities/<owner>/<repo>/<kind>/<name>`. */
+export function capabilityPageRoute(parts) {
+    return `/capabilities/${[parts.owner, parts.repo, parts.kind, ...parts.name.split("/")].map(encodeURIComponent).join("/")}`;
+}
+/** Where a chip points: the host's open door, which sends the reader to the page. */
+export function capabilityOpenRoute(parts) {
+    return `/api/chronicle/open?uri=${encodeURIComponent(canonicalCapabilityRef(parts))}`;
+}
+/** Every capability address in a text, as written, in order of first appearance. Code is not a reference. */
+export function extractCapabilityUris(text) {
+    const seen = new Set();
+    const out = [];
+    const re = /(?<![\w/?=&%.~+:@#!-])miadi-capability:(?:\/\/)?[A-Za-z0-9._~/?=&%#+@-]{1,512}/gi;
+    const prose = text.replace(/```[\s\S]*?```/g, " ").replace(/`[^`\n]*`/g, " ");
+    for (const m of prose.matchAll(re)) {
+        const raw = m[0].replace(/[.,;:)\]]+$/, "");
+        if (!seen.has(raw) && parseCapabilityUri(raw)) {
+            seen.add(raw);
+            out.push(raw);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=capability-dsl.js.map

package/dist/capability-dsl.js.map

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

package/dist/capability-holding.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The capability seam: what an episode did with a capability, in the shape
+ * the rispec seam set (rispec.ts). One reusable capability node on the wheel
+ * (`capability:<kind>-<slug>`, the registry's id, `knowledge` with
+ * `metadata.kind: "capability"`), one episode→capability edge whose
+ * relationship type is the relation (`uses`, `revises`, `brings-into-being`),
+ * and an entry per capability and version in `episode.yaml`'s
+ * `capabilities:` list with the evidence of the work.
+ *
+ * Episode 568's Capability Registry, `EpisodeCapabilityHolding` (P12).
+ */
+import { type CapabilityRef, type EpisodeCapabilityEntry } from "@miadi/episodic-memory-schema";
+export type CapabilityHoldingErrorCode = "invalid_capability" | "capability_manifest_conflict";
+export declare class CapabilityHoldingError extends Error {
+    readonly code: CapabilityHoldingErrorCode;
+    constructor(code: CapabilityHoldingErrorCode, message: string);
+}
+/** The capability an input names: `miadi-capability:<owner>/<repo>/<kind>/<name>`, `//` accepted. */
+export declare function requireCapabilityRef(raw: unknown): CapabilityRef;
+export interface UpsertEpisodeCapabilityResult {
+    entry: EpisodeCapabilityEntry;
+    created: boolean;
+    filled: string[];
+    wrote: boolean;
+    dryRun: boolean;
+}
+/**
+ * Add a holding to `episode.yaml`'s `capabilities:` list, or complete the one
+ * that holds this capability at this version: keys it lacks are filled and
+ * new evidence is appended. The relation an entry already records is kept.
+ * Comments, key order and every other field survive. Refuses a
+ * `capabilities` key that is not a list.
+ */
+export declare function upsertEpisodeCapability(input: {
+    episodeYamlPath: string;
+    entry: EpisodeCapabilityEntry;
+    dryRun?: boolean;
+}): Promise<UpsertEpisodeCapabilityResult>;
+export type CapabilityProjectionState = "created" | "already-present" | "skipped" | "pending";
+export interface CapabilityProjection {
+    node: {
+        id: string;
+        state: CapabilityProjectionState;
+        error?: string;
+    };
+    edge: {
+        id: string;
+        state: CapabilityProjectionState;
+        relationship_type: string;
+        error?: string;
+    };
+}
+/**
+ * Put the capability node and the episode→capability edge on the wheel. A
+ * node that exists is left as it is. One edge joins an episode and a
+ * capability whatever the versions; the first relation recorded names it.
+ */
+export declare function projectEpisodeCapability(mwUrl: string, input: {
+    episodeNodeId: string;
+    episodeFolder: string;
+    episodeNumber?: number;
+    ref: CapabilityRef;
+    entry: EpisodeCapabilityEntry;
+}, options?: {
+    fetchImpl?: typeof fetch;
+    dryRun?: boolean;
+}): Promise<CapabilityProjection>;
+//# sourceMappingURL=capability-holding.d.ts.map

package/dist/capability-holding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-holding.d.ts","sourceRoot":"","sources":["../src/capability-holding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAA;AAItC,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,GAAG,8BAA8B,CAAA;AAE9F,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,IAAI,EAAE,0BAA0B;gBAAhC,IAAI,EAAE,0BAA0B,EAChD,OAAO,EAAE,MAAM;CAKlB;AAED,qGAAqG;AACrG,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAIhE;AAID,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,sBAAsB,CAAA;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;CAChB;AA8BD;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA6DzK;AAID,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,GAAG,SAAS,CAAA;AAE7F,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,yBAAyB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtE,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,yBAAyB,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAClG;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,EAClI,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3D,OAAO,CAAC,oBAAoB,CAAC,CA+E/B"}

package/dist/capability-holding.js

@@ -0,0 +1,229 @@
+/**
+ * The capability seam: what an episode did with a capability, in the shape
+ * the rispec seam set (rispec.ts). One reusable capability node on the wheel
+ * (`capability:<kind>-<slug>`, the registry's id, `knowledge` with
+ * `metadata.kind: "capability"`), one episode→capability edge whose
+ * relationship type is the relation (`uses`, `revises`, `brings-into-being`),
+ * and an entry per capability and version in `episode.yaml`'s
+ * `capabilities:` list with the evidence of the work.
+ *
+ * Episode 568's Capability Registry, `EpisodeCapabilityHolding` (P12).
+ */
+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 { CAPABILITY_ENTRY_KEYS, CAPABILITY_NODE_KIND, capabilityHoldingKey, capabilityNodeId, parseCapabilityRef, toEpisodeCapabilityEntry, } from "@miadi/episodic-memory-schema";
+import { missingManifestRemedy } from "./episode.js";
+import { edgesFrom, failure, wheelJson } from "./review.js";
+export class CapabilityHoldingError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "CapabilityHoldingError";
+    }
+}
+/** The capability an input names: `miadi-capability:<owner>/<repo>/<kind>/<name>`, `//` accepted. */
+export function requireCapabilityRef(raw) {
+    const ref = parseCapabilityRef(raw);
+    if (ref)
+        return ref;
+    throw new CapabilityHoldingError("invalid_capability", `capability '${String(raw)}' is not a miadi-capability:<owner>/<repo>/<kind>/<name> address`);
+}
+function quoted(doc, value) {
+    const node = doc.createNode(value);
+    node.type = Scalar.QUOTE_SINGLE;
+    return node;
+}
+function evidenceNode(doc, evidence) {
+    const seq = doc.createNode([]);
+    for (const e of evidence)
+        seq.items.push(quoted(doc, e));
+    return seq;
+}
+function entryNode(doc, entry) {
+    const map = doc.createNode({});
+    for (const key of CAPABILITY_ENTRY_KEYS) {
+        const value = entry[key];
+        if (value === undefined || value === "")
+            continue;
+        if (key === "evidence") {
+            if (Array.isArray(value) && value.length > 0)
+                map.set(key, evidenceNode(doc, value));
+            continue;
+        }
+        map.set(key, quoted(doc, value));
+    }
+    return map;
+}
+const plain = (item) => (isMap(item) ? item.toJSON() : isScalar(item) ? item.value : item);
+/**
+ * Add a holding to `episode.yaml`'s `capabilities:` list, or complete the one
+ * that holds this capability at this version: keys it lacks are filled and
+ * new evidence is appended. The relation an entry already records is kept.
+ * Comments, key order and every other field survive. Refuses a
+ * `capabilities` key that is not a list.
+ */
+export async function upsertEpisodeCapability(input) {
+    if (!existsSync(input.episodeYamlPath)) {
+        throw new CapabilityHoldingError("capability_manifest_conflict", missingManifestRemedy(dirname(input.episodeYamlPath)));
+    }
+    const doc = parseDocument(await readFile(input.episodeYamlPath, "utf8"));
+    if (doc.errors.length > 0) {
+        throw new CapabilityHoldingError("capability_manifest_conflict", `unreadable episode.yaml ${input.episodeYamlPath}: ${doc.errors[0].message}`);
+    }
+    if (!isMap(doc.contents)) {
+        throw new CapabilityHoldingError("capability_manifest_conflict", `episode.yaml ${input.episodeYamlPath} is not a mapping`);
+    }
+    const key = capabilityHoldingKey(input.entry);
+    const list = doc.get("capabilities", 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));
+        doc.set("capabilities", seq);
+    }
+    else if (!isSeq(list)) {
+        throw new CapabilityHoldingError("capability_manifest_conflict", `capabilities in ${input.episodeYamlPath} is not a list — refusing to overwrite`);
+    }
+    else {
+        const index = list.items.findIndex((item) => {
+            const read = toEpisodeCapabilityEntry(plain(item));
+            return read !== null && capabilityHoldingKey(read) === key;
+        });
+        if (index < 0) {
+            created = true;
+            entry = input.entry;
+            list.items.push(entryNode(doc, entry));
+        }
+        else {
+            const item = list.items[index];
+            if (!isMap(item)) {
+                entry = toEpisodeCapabilityEntry(plain(item)) ?? input.entry;
+            }
+            else {
+                for (const k of CAPABILITY_ENTRY_KEYS) {
+                    if (k === "evidence" || k === "relation")
+                        continue;
+                    const value = input.entry[k];
+                    if (value === undefined || value === "")
+                        continue;
+                    const present = item.get(k);
+                    if (present === undefined || present === null || present === "") {
+                        item.set(k, quoted(doc, value));
+                        filled.push(k);
+                    }
+                }
+                const had = toEpisodeCapabilityEntry(item.toJSON())?.evidence ?? [];
+                const more = (input.entry.evidence ?? []).filter((e) => !had.includes(e));
+                if (more.length > 0) {
+                    item.set("evidence", evidenceNode(doc, [...had, ...more]));
+                    filled.push("evidence");
+                }
+                entry = toEpisodeCapabilityEntry(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 };
+}
+/**
+ * Put the capability node and the episode→capability edge on the wheel. A
+ * node that exists is left as it is. One edge joins an episode and a
+ * capability whatever the versions; the first relation recorded names it.
+ */
+export async function projectEpisodeCapability(mwUrl, input, options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const base = mwUrl.replace(/\/+$/, "");
+    const nodeId = capabilityNodeId(input.ref);
+    const relation = input.entry.relation;
+    const projection = {
+        node: { id: nodeId, state: "pending" },
+        edge: { id: `${input.episodeNodeId}:${nodeId}`, state: "pending", relationship_type: relation },
+    };
+    const nodeUrl = `${base}/api/nodes/${encodeURIComponent(nodeId)}`;
+    const read = await wheelJson(fetchImpl, nodeUrl);
+    if (read.ok) {
+        projection.node.state = "already-present";
+    }
+    else if (read.status === 404) {
+        if (options.dryRun) {
+            projection.node.state = "skipped";
+        }
+        else {
+            const created = await wheelJson(fetchImpl, `${base}/api/nodes`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({
+                    id: nodeId,
+                    type: "knowledge",
+                    name: `Capability — ${input.ref.kind} ${input.ref.name}`,
+                    description: `One thing ${input.ref.owner}/${input.ref.repo} provides: the ${input.ref.kind} ${input.ref.name}. Its address is ${input.ref.reference}.`,
+                    metadata: {
+                        kind: CAPABILITY_NODE_KIND,
+                        address: input.ref.reference,
+                        owner: input.ref.owner,
+                        repo: input.ref.repo,
+                        capability_kind: input.ref.kind,
+                        name: input.ref.name,
+                        provided_by: `repository:${input.ref.owner}/${input.ref.repo}`,
+                    },
+                }),
+            });
+            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 capability 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 = { ...projection.edge, state: "already-present", relationship_type: String(existing.relationship_type ?? relation) };
+        return projection;
+    }
+    if (options.dryRun) {
+        projection.edge.state = "skipped";
+        return projection;
+    }
+    const who = input.episodeNumber !== undefined ? `Episode ${input.episodeNumber}` : input.episodeFolder;
+    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: relation,
+            description: `${who} ${relation.replace(/-/g, " ")} ${input.ref.name}${input.entry.version ? ` ${input.entry.version}` : ""}.`,
+            strength: 1,
+            obligations: [],
+        }),
+    });
+    if (posted.ok && posted.body?.replaced === true) {
+        projection.edge = { ...projection.edge, state: "pending", 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;
+}
+//# sourceMappingURL=capability-holding.js.map

package/dist/capability-holding.js.map

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

package/dist/chronicle-terminal.d.ts

@@ -371,4 +371,29 @@ export declare function resolveFoundationRefForTerminal(uri: string, options?: {
     prefer?: BaseKind | "local-file";
     foundationsRoot?: string;
 }): Promise<FoundationRefResolveResult | null>;
+export interface CapabilityRefResolveResult {
+    ok: boolean;
+    uri: string;
+    canonical: string;
+    /** The address as a person cites it, with `//`. */
+    citation: string;
+    owner: string;
+    repo: string;
+    kind: string;
+    name: string;
+    /** The capability's page on each front. */
+    destinations: Destination[];
+    open: string | null;
+    shareable: string | null;
+}
+/**
+ * Where a capability address opens: its page on each front this host knows.
+ * The page asks the registry, as the reader, what the capability is, which
+ * file and commit it was read from, and what consumes it. Nothing is fetched
+ * here: an address is opened, not proven, by a terminal.
+ */
+export declare function resolveCapabilityRefForTerminal(uri: string, options?: {
+    bases?: WebBases;
+    prefer?: BaseKind;
+}): CapabilityRefResolveResult | null;
 //# sourceMappingURL=chronicle-terminal.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"chronicle-terminal.d.ts","sourceRoot":"","sources":["../src/chronicle-terminal.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chronicle-terminal.d.ts","sourceRoot":"","sources":["../src/chronicle-terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAA;AA0B3B,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAEtC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAajD;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;OASG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAKlF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,WAAgB,GACxB,MAAM,CAER;AAMD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAA;AAE3D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAA;IAClB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB;iFAC6E;IAC7E,UAAU,CAAC,EAAE,aAAa,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ;AAoBD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,0BAA0B,CAAA;AAEzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEtD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,QAAQ,CAM3E;AAUD,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAC/F,oDAAoD;IACpD,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;;;;OAQG;IACH,GAAG,EAAE,WAAW,EAAE,CAAA;IAClB,kEAAkE;IAClE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;IACtC;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,GAAE,MAAmB,GAAG,MAAM,CAM/E;AA+DD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA0BhC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAInB,CAAA;AAEV,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAkBf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,SAAS,SAAO,GACf,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,mBAAmB,EAC/B,MAAM,EAAE,kBAAkB,EAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACtF,OAAO,CAAC;IAAE,YAAY,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CAAC,CAmI1E;AAcD,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX;oFACgF;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;QAClB,eAAe,EAAE,MAAM,EAAE,CAAA;QACzB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;QAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,UAAU,EAAE,mBAAmB,CAAA;IAC/B,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IAC/B,kCAAkC;IAClC,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;IAClC,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,iDAAiD;IACjD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,QAAQ,CAAA;IAClB,iEAAiE;IACjE,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,YAAY,CAAA;CACrB;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,iBAAiB,EAAE,EAC5B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAA;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;CACZ,GACL,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAuCxC;AAoDD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,YAAY,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,uDAAuD;IACvD,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,oGAAoG;IACpG,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5G;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACzF,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAqCvC;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qFAAqF;IACrF,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,oFAAoF;IACpF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7F,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAoC5C;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;CAAO,GACpD,0BAA0B,GAAG,IAAI,CA4BnC"}

package/dist/chronicle-terminal.js

@@ -27,6 +27,7 @@ import { parse as parseYaml } from "yaml";
 import { resolveMwUrl } from "./env.js";
 import { parseMiadiChronicleUri, parseWheelRefUri, wheelNodeId, WHEEL_ARTIFACT_KINDS, resolveChronicleRef, judgeFragment, EPISODE_FOUNDATION_SEGMENT, } from "./chronicle-dsl.js";
 import { foundationRoute, parseFoundationUri } from "./foundation-dsl.js";
+import { capabilityCitation, capabilityPageRoute, parseCapabilityUri } from "./capability-dsl.js";
 // ---------------------------------------------------------------------------
 // OSC 8
 // ---------------------------------------------------------------------------
@@ -663,4 +664,41 @@ export async function resolveFoundationRefForTerminal(uri, options = {}) {
         path,
     };
 }
+/**
+ * Where a capability address opens: its page on each front this host knows.
+ * The page asks the registry, as the reader, what the capability is, which
+ * file and commit it was read from, and what consumes it. Nothing is fetched
+ * here: an address is opened, not proven, by a terminal.
+ */
+export function resolveCapabilityRefForTerminal(uri, options = {}) {
+    const parsed = parseCapabilityUri(uri);
+    if (!parsed)
+        return null;
+    const bases = options.bases ?? readWebBases();
+    const route = capabilityPageRoute(parsed);
+    const LABEL = { local: "local", internal: "tailnet", public: "public" };
+    const doors = [];
+    for (const kind of ["local", "internal", "public"]) {
+        const base = bases[kind];
+        if (base)
+            doors.push({ kind: "room", base: kind, label: `capability·${LABEL[kind]}`, url: `${base.replace(/\/$/, "")}${route}` });
+    }
+    if (options.prefer) {
+        const prefer = options.prefer;
+        doors.sort((a, b) => Number(b.base === prefer) - Number(a.base === prefer));
+    }
+    return {
+        ok: true,
+        uri: parsed.uri,
+        canonical: parsed.canonical,
+        citation: capabilityCitation(parsed),
+        owner: parsed.owner,
+        repo: parsed.repo,
+        kind: parsed.kind,
+        name: parsed.name,
+        destinations: doors,
+        open: doors[0]?.url ?? null,
+        shareable: doors.find((d) => d.base === "public")?.url ?? doors.find((d) => d.base === "internal")?.url ?? null,
+    };
+}
 //# sourceMappingURL=chronicle-terminal.js.map