@miadi/inquiry-weave 0.18.6 → 0.18.8

package/dist/capability-holding.d.ts

@@ -0,0 +1,134 @@
+/**
+ * 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>;
+export interface RemoveEpisodeCapabilityResult {
+    /** The entries taken out. */
+    removed: EpisodeCapabilityEntry[];
+    /** What the manifest still holds of this capability, in its order. */
+    remaining: EpisodeCapabilityEntry[];
+    wrote: boolean;
+}
+/**
+ * Take a capability's holdings out of `episode.yaml`: the one at `version`,
+ * or every one of the capability when no version is given. Removing what the
+ * episode does not hold changes nothing. Every other entry, comment and key survives.
+ */
+export declare function removeEpisodeCapabilityEntries(input: {
+    episodeYamlPath: string;
+    capability: string;
+    version?: string;
+    dryRun?: boolean;
+}): Promise<RemoveEpisodeCapabilityResult>;
+export interface AmendEpisodeCapabilityResult {
+    entry: EpisodeCapabilityEntry;
+    /** The keys whose value changed. */
+    changed: string[];
+    /** What the manifest holds of this capability after the change, in its order. */
+    held: EpisodeCapabilityEntry[];
+    wrote: boolean;
+}
+/**
+ * Change the holding at (`capability`, `version`): its relation, its evidence
+ * (replaced as given) or its title. Refuses a holding the episode does not have.
+ */
+export declare function amendEpisodeCapabilityEntry(input: {
+    episodeYamlPath: string;
+    capability: string;
+    version?: string;
+    relation?: EpisodeCapabilityEntry["relation"];
+    evidence?: string[];
+    title?: string;
+    dryRun?: boolean;
+}): Promise<AmendEpisodeCapabilityResult>;
+export interface CapabilityEdgeReconcile {
+    id: string;
+    /**
+     * `deleted` when no holding of the capability remains; `amended` when the
+     * edge took the first holding's relation; `matching` when it already had it;
+     * `absent` when there was no edge to delete; `skipped` on a dry run;
+     * `pending` when the wheel did not answer.
+     */
+    state: "deleted" | "amended" | "matching" | "absent" | "skipped" | "pending";
+    relationship_type?: string;
+    error?: string;
+}
+/**
+ * Make the episode→capability edge say what the manifest holds: gone when no
+ * holding of the capability remains, the first remaining holding's relation
+ * otherwise. The capability node stays: other episodes hold it too. Never throws.
+ */
+export declare function reconcileEpisodeCapabilityEdge(mwUrl: string, input: {
+    episodeNodeId: string;
+    episodeFolder: string;
+    episodeNumber?: number;
+    ref: CapabilityRef;
+    held: readonly EpisodeCapabilityEntry[];
+}, options?: {
+    fetchImpl?: typeof fetch;
+    dryRun?: boolean;
+}): Promise<CapabilityEdgeReconcile>;
+//# 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":"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"}

package/dist/capability-holding.js

@@ -0,0 +1,363 @@
+/**
+ * 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;
+}
+async function readManifestDoc(path) {
+    if (!existsSync(path))
+        throw new CapabilityHoldingError("capability_manifest_conflict", missingManifestRemedy(dirname(path)));
+    const doc = parseDocument(await readFile(path, "utf8"));
+    if (doc.errors.length > 0)
+        throw new CapabilityHoldingError("capability_manifest_conflict", `unreadable episode.yaml ${path}: ${doc.errors[0].message}`);
+    if (!isMap(doc.contents))
+        throw new CapabilityHoldingError("capability_manifest_conflict", `episode.yaml ${path} is not a mapping`);
+    return doc;
+}
+function heldOf(doc) {
+    const list = doc.get("capabilities", true);
+    if (list === undefined || list === null || (isScalar(list) && (list.value === null || list.value === undefined)))
+        return { list: null, entries: [] };
+    if (!isSeq(list))
+        throw new CapabilityHoldingError("capability_manifest_conflict", "capabilities in episode.yaml is not a list — refusing to change it");
+    const entries = [];
+    list.items.forEach((item, index) => {
+        const entry = toEpisodeCapabilityEntry(plain(item));
+        if (entry)
+            entries.push({ index, entry });
+    });
+    return { list, entries };
+}
+/**
+ * Take a capability's holdings out of `episode.yaml`: the one at `version`,
+ * or every one of the capability when no version is given. Removing what the
+ * episode does not hold changes nothing. Every other entry, comment and key survives.
+ */
+export async function removeEpisodeCapabilityEntries(input) {
+    const doc = await readManifestDoc(input.episodeYamlPath);
+    const { list, entries } = heldOf(doc);
+    const ofCapability = entries.filter((e) => e.entry.capability === input.capability);
+    const removed = ofCapability.filter((e) => input.version === undefined || (e.entry.version ?? "") === input.version);
+    const remaining = ofCapability.filter((e) => !removed.includes(e)).map((e) => e.entry);
+    if (removed.length === 0 || list === null)
+        return { removed: [], remaining, wrote: false };
+    for (const { index } of [...removed].sort((a, b) => b.index - a.index))
+        list.items.splice(index, 1);
+    if (!input.dryRun)
+        await writeFile(input.episodeYamlPath, doc.toString(), "utf8");
+    return { removed: removed.map((e) => e.entry), remaining, wrote: !input.dryRun };
+}
+/**
+ * Change the holding at (`capability`, `version`): its relation, its evidence
+ * (replaced as given) or its title. Refuses a holding the episode does not have.
+ */
+export async function amendEpisodeCapabilityEntry(input) {
+    const doc = await readManifestDoc(input.episodeYamlPath);
+    const { list, entries } = heldOf(doc);
+    const found = entries.find((e) => e.entry.capability === input.capability && (e.entry.version ?? "") === (input.version ?? ""));
+    if (!found || list === null) {
+        throw new CapabilityHoldingError("invalid_capability", `the episode holds no ${input.capability}${input.version ? ` at ${input.version}` : " without a version"}`);
+    }
+    const item = list.items[found.index];
+    const changed = [];
+    const map = isMap(item) ? item : doc.createNode({ capability: found.entry.capability });
+    if (!isMap(item))
+        list.items[found.index] = map;
+    if (input.relation && input.relation !== found.entry.relation) {
+        map.set("relation", quoted(doc, input.relation));
+        changed.push("relation");
+    }
+    if (input.evidence) {
+        const next = [...new Set(input.evidence)];
+        if (JSON.stringify(next) !== JSON.stringify(found.entry.evidence ?? [])) {
+            if (next.length > 0)
+                map.set("evidence", evidenceNode(doc, next));
+            else
+                map.delete("evidence");
+            changed.push("evidence");
+        }
+    }
+    if (input.title !== undefined && input.title !== (found.entry.title ?? "")) {
+        if (input.title)
+            map.set("title", quoted(doc, input.title));
+        else
+            map.delete("title");
+        changed.push("title");
+    }
+    const wrote = changed.length > 0 && !input.dryRun;
+    if (wrote)
+        await writeFile(input.episodeYamlPath, doc.toString(), "utf8");
+    const entry = toEpisodeCapabilityEntry(map.toJSON()) ?? found.entry;
+    const held = heldOf(doc).entries.filter((e) => e.entry.capability === input.capability).map((e) => e.entry);
+    return { entry, changed, held, wrote };
+}
+/** The wheel names one edge by its ordered pair. */
+const pairQuery = (from, to) => new URLSearchParams({ from, to }).toString();
+/**
+ * Make the episode→capability edge say what the manifest holds: gone when no
+ * holding of the capability remains, the first remaining holding's relation
+ * otherwise. The capability node stays: other episodes hold it too. Never throws.
+ */
+export async function reconcileEpisodeCapabilityEdge(mwUrl, input, options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const nodeId = capabilityNodeId(input.ref);
+    const id = `${input.episodeNodeId}:${nodeId}`;
+    const edgesUrl = `${mwUrl.replace(/\/+$/, "")}/api/edges`;
+    const listing = await wheelJson(fetchImpl, `${edgesUrl}?limit=all`);
+    if (!listing.ok)
+        return { id, state: "pending", error: failure("GET", edgesUrl, listing) };
+    const existing = edgesFrom(listing.body).find((edge) => String(edge.from_id) === input.episodeNodeId && String(edge.to_id) === nodeId);
+    const first = input.held[0];
+    if (!first) {
+        if (!existing)
+            return { id, state: "absent" };
+        if (options.dryRun)
+            return { id, state: "skipped" };
+        const deleted = await wheelJson(fetchImpl, `${edgesUrl}?${pairQuery(input.episodeNodeId, nodeId)}`, { method: "DELETE" });
+        if (deleted.ok)
+            return { id, state: "deleted" };
+        const said = deleted.body?.error;
+        if (deleted.status === 404 && typeof said === "string")
+            return { id, state: "absent" };
+        return { id, state: "pending", error: failure("DELETE", edgesUrl, deleted) };
+    }
+    if (!existing)
+        return { id, state: "absent" };
+    if (String(existing.relationship_type ?? "") === first.relation)
+        return { id, state: "matching", relationship_type: first.relation };
+    if (options.dryRun)
+        return { id, state: "skipped", relationship_type: first.relation };
+    const who = input.episodeNumber !== undefined ? `Episode ${input.episodeNumber}` : input.episodeFolder;
+    const patched = await wheelJson(fetchImpl, `${edgesUrl}?${pairQuery(input.episodeNodeId, nodeId)}`, {
+        method: "PATCH",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+            relationship_type: first.relation,
+            description: `${who} ${first.relation.replace(/-/g, " ")} ${input.ref.name}${first.version ? ` ${first.version}` : ""}.`,
+        }),
+    });
+    return patched.ok ? { id, state: "amended", relationship_type: first.relation } : { id, state: "pending", error: failure("PATCH", edgesUrl, patched) };
+}
+//# 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/index.d.ts

@@ -31,6 +31,7 @@ export * from "./prototype.js";
 export * from "./pde.js";
 export * from "./tracing.js";
 export * from "./rispec.js";
+export * from "./capability-holding.js";
 export * from "./rise-workspaces.js";
 export * from "./rise-resolve.js";
 export * from "./chronicle-terminal.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,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,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,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,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"}
+{"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,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,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,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,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

@@ -31,6 +31,7 @@ export * from "./prototype.js";
 export * from "./pde.js";
 export * from "./tracing.js";
 export * from "./rispec.js";
+export * from "./capability-holding.js";
 export * from "./rise-workspaces.js";
 export * from "./rise-resolve.js";
 export * from "./chronicle-terminal.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,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,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,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,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"}
+{"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,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,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,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,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/mcp-server.js

@@ -49,7 +49,7 @@ import { isFoundationUri } from "./foundation-dsl.js";
 import { isCapabilityUri } from "./capability-dsl.js";
 import { readWebBases, resolveCapabilityRefForTerminal, resolveForTerminal, resolveFoundationRefForTerminal, resolveWheelRefForTerminal } from "./chronicle-terminal.js";
 import { answerChronicleAttention, getChronicleAttention, listChronicleAttention, } from "./attention.js";
-import { attachEpisodeFoundation, attachEpisodeNotebook, attachEpisodePrototype, attachEpisodePde, listEpisodePdes, attachEpisodeTracing, attachEpisodeRispec, attachEpisodeReview, authorEpisodeLineage, checkEpisodeNumber, episodeDoorStatus, landEpisode, mintEpisode, previewAllocation, redeemEpisodeRegistration, resolveDoorContext, weaveEpisodeInquiry, } from "./mint.js";
+import { attachEpisodeFoundation, attachEpisodeNotebook, attachEpisodePrototype, attachEpisodePde, listEpisodePdes, attachEpisodeTracing, attachEpisodeRispec, attachEpisodeCapability, amendEpisodeCapability, removeEpisodeCapability, attachEpisodeReview, authorEpisodeLineage, checkEpisodeNumber, episodeDoorStatus, landEpisode, mintEpisode, previewAllocation, redeemEpisodeRegistration, resolveDoorContext, weaveEpisodeInquiry, } from "./mint.js";
 const API_BASE = (process.env.MIADI_INQUIRY_API_BASE || "").replace(/\/$/, "");
 const ISSUES_BASE = (process.env.MIADI_INQUIRY_ISSUES_BASE ||
     process.env.MIADI_INQUIRY_THREADS_BASE ||
@@ -439,6 +439,25 @@ const TOOLS = [
             required: ["episode", "spec"],
         },
     },
+    {
+        name: "chronicle_episode_capability",
+        description: "Hold a capability in an episode (Episode 568's Capability Registry): record under capabilities: in episode.yaml what the episode did with it at one version (uses, revises or brings-into-being) and the evidence of the work (owner/repo#n, owner/repo@<sha>, session:<uuid>, npm:<package>@<version>); put the capability node (knowledge, kind capability, the registry's id capability:<kind>-<slug>) and the episode→capability edge on the wheel; land. One entry per capability and version; repeating the call adds only evidence it lacks. action amend corrects one holding (relation, evidence replaced as given, title); action remove stops holding it at version, or at every version when none is given. Both then make the wheel edge agree: removed once no holding remains, the first holding's relation otherwise.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                episode: { type: "string", description: "Episode number, epNNN, or folder name." },
+                capability: { type: "string", description: "miadi-capability:<owner>/<repo>/<kind>/<name>; // is accepted." },
+                action: { type: "string", enum: ["hold", "amend", "remove"], default: "hold", description: "hold (default) adds or completes a holding; amend corrects one; remove stops holding it." },
+                relation: { type: "string", enum: ["uses", "revises", "brings-into-being"], description: "What the episode did with it (default: uses)." },
+                version: { type: "string", description: "The version the episode used or released, e.g. 0.5.1." },
+                evidence: { type: "array", items: { type: "string" }, description: "owner/repo#n, owner/repo@<sha>, session:<uuid>, npm:<package>@<version>" },
+                title: { type: "string" },
+                land: { type: "boolean", default: true },
+                dryRun: { type: "boolean", default: false },
+            },
+            required: ["episode", "capability"],
+        },
+    },
     {
         name: "chronicle_episode_status",
         description: "The five-stage closing proof for one episode — created, committed, pushed, registered, receipt-verified — each with its probe and what it said, plus drift shapes and owed actions.",
@@ -753,6 +772,36 @@ async function callTool(name, args) {
                 return apiCall("POST", `/api/chronicle/episodes/${encodeURIComponent(ref)}/rispecs`, input);
             return attachEpisodeRispec(door.context, ref, input);
         }
+        case "chronicle_episode_capability": {
+            const door = episodeDoor();
+            const ref = episodeRefArg(args);
+            const str = (key) => (typeof args[key] === "string" ? args[key] : undefined);
+            const input = {
+                capability: str("capability") ?? "",
+                relation: str("relation"),
+                version: str("version"),
+                evidence: Array.isArray(args.evidence) ? args.evidence.filter((e) => typeof e === "string") : undefined,
+                title: str("title"),
+                land: args.land !== false,
+                dryRun: args.dryRun === true,
+            };
+            const action = args.action === "amend" || args.action === "remove" ? args.action : "hold";
+            const path = `/api/chronicle/episodes/${encodeURIComponent(ref)}/capabilities`;
+            if (action === "remove") {
+                const removal = { capability: input.capability, version: input.version, land: input.land, dryRun: input.dryRun };
+                if (door.mode === "http")
+                    return apiCall("DELETE", path, removal);
+                return removeEpisodeCapability(door.context, ref, removal);
+            }
+            if (action === "amend") {
+                if (door.mode === "http")
+                    return apiCall("PATCH", path, input);
+                return amendEpisodeCapability(door.context, ref, input);
+            }
+            if (door.mode === "http")
+                return apiCall("POST", path, input);
+            return attachEpisodeCapability(door.context, ref, input);
+        }
         case "chronicle_episode_status": {
             const door = episodeDoor();
             const ref = episodeRefArg(args);