@miadi/inquiry-weave 0.16.6 → 0.17.1

package/dist/notebook.js

@@ -0,0 +1,258 @@
+/**
+ * The notebook seam — a Deep Diver notebook entering an episode, in the shape
+ * the review (jgwill/Miadi#630) and foundation (#713) seams set: one reusable
+ * `notebook:<uuid>` node on the wheel, one `chronicle:<episode>` →
+ * `notebook:<uuid>` edge whose relationship type names what the episode does
+ * with it (`cites` when nobody said), and an entry in `episode.yaml`'s
+ * `notebooks:` list keeping the episode's own record.
+ *
+ * Episodes 120, 140 and 550 wrote that list by hand before this seam existed
+ * (`/deepdive` step 6). The rules kept from the other seams make that safe:
+ * the manifest entry is written once and never overwritten (a later call
+ * fills missing keys only), one ordered node pair is one edge so a hand-made
+ * edge keeps its relation, and the wheel projection never throws — a wheel
+ * that is down answers `pending`. The notebook's files under
+ * `captures/notebook-<uuid>/` are read for their names and the README's
+ * title, never written. Ref: jgwill/miadi-orchestration-kit#80 (A1).
+ */
+import { readFile, readdir, stat, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { Scalar, isMap, isScalar, isSeq, parseDocument } from "yaml";
+import { DEFAULT_NOTEBOOK_RELATION, NOTEBOOK_ENTRY_KEYS, NOTEBOOK_NODE_KIND, notebookFolder, notebookNodeId, notebookReference, parseNotebookRef, toEpisodeNotebookEntry, } from "@miadi/episodic-memory-schema";
+import { missingManifestRemedy } from "./episode.js";
+import { readmeTitle } from "./foundation.js";
+import { edgesFrom, failure, wheelJson } from "./review.js";
+export class NotebookError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "NotebookError";
+    }
+}
+/** Read the notebook an input names: its Gemini Notebook URL, `miadi-notebook:<uuid>`, `notebook:<uuid>` or a bare uuid. */
+export function requireNotebookRef(raw) {
+    const ref = parseNotebookRef(raw);
+    if (ref)
+        return ref;
+    throw new NotebookError("invalid_notebook", `notebook '${String(raw)}' is not a Gemini Notebook address, a miadi-notebook: reference or a uuid`);
+}
+/** The folder a notebook's files live in, read for names and the README title. Never writes. */
+export async function readNotebookFolder(episodeDir, id) {
+    const path = notebookFolder(id);
+    const dir = join(episodeDir, path);
+    try {
+        if (!(await stat(dir)).isDirectory())
+            return { files: [] };
+    }
+    catch {
+        return { files: [] };
+    }
+    // Top-level files first, then what keep/ holds, each in name order.
+    const entries = (await readdir(dir, { withFileTypes: true })).filter((e) => !e.name.startsWith("."));
+    const files = entries.filter((e) => e.isFile()).map((e) => e.name).sort((a, b) => a.localeCompare(b));
+    if (entries.some((e) => e.isDirectory() && e.name === "keep")) {
+        const kept = (await readdir(join(dir, "keep"), { withFileTypes: true })).filter((e) => e.isFile() && !e.name.startsWith("."));
+        files.push(...kept.map((e) => `keep/${e.name}`).sort((a, b) => a.localeCompare(b)));
+    }
+    let title;
+    try {
+        title = readmeTitle(await readFile(join(dir, "README.md"), "utf8"));
+    }
+    catch {
+        title = undefined;
+    }
+    return { path, ...(title ? { title } : {}), files };
+}
+function quoted(doc, value) {
+    const node = doc.createNode(value);
+    node.type = Scalar.QUOTE_SINGLE;
+    return node;
+}
+/** A value as the manifest writes it: strings quoted (#713 review, F13), lists as block sequences of quoted strings. */
+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 NOTEBOOK_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 notebook to `episode.yaml`'s `notebooks:` list, or fill the keys an
+ * existing entry lacks. Comments, key order and every other field survive.
+ * Refuses a `notebooks` key that is not a list.
+ */
+export async function upsertEpisodeNotebook(input) {
+    if (!existsSync(input.episodeYamlPath)) {
+        throw new NotebookError("notebook_manifest_conflict", missingManifestRemedy(dirname(input.episodeYamlPath)));
+    }
+    const doc = parseDocument(await readFile(input.episodeYamlPath, "utf8"));
+    if (doc.errors.length > 0) {
+        throw new NotebookError("notebook_manifest_conflict", `unreadable episode.yaml ${input.episodeYamlPath}: ${doc.errors[0].message}`);
+    }
+    if (!isMap(doc.contents)) {
+        throw new NotebookError("notebook_manifest_conflict", `episode.yaml ${input.episodeYamlPath} is not a mapping`);
+    }
+    const list = doc.get("notebooks", 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("notebooks", seq);
+    }
+    else if (!isSeq(list)) {
+        throw new NotebookError("notebook_manifest_conflict", `notebooks in ${input.episodeYamlPath} is not a list — refusing to overwrite`);
+    }
+    else {
+        const index = list.items.findIndex((item) => sameEntry(toEpisodeNotebookEntry(isMap(item) ? item.toJSON() : item?.value ?? 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)) {
+                // A bare url written by hand already holds the notebook. Left as written.
+                entry = toEpisodeNotebookEntry(isScalar(item) ? item.value : item) ?? input.entry;
+            }
+            else {
+                for (const key of NOTEBOOK_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 = toEpisodeNotebookEntry(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→notebook edge already on the wheel. Never throws. */
+export async function existingNotebookRelation(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;
+}
+/**
+ * Put the notebook node and the episode→notebook edge on the wheel. A
+ * notebook is a `knowledge` node. When the node exists it is left as it is,
+ * so a hand-written name and description stay.
+ */
+export async function projectEpisodeNotebook(mwUrl, input, options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const base = mwUrl.replace(/\/+$/, "");
+    const nodeId = notebookNodeId(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) {
+        projection.node.state = "already-present";
+    }
+    else if (read.status === 404) {
+        if (options.dryRun) {
+            projection.node.state = "skipped";
+        }
+        else {
+            const title = input.title ?? `notebook ${input.entry.id.slice(0, 8)}`;
+            const created = await wheelJson(fetchImpl, `${base}/api/nodes`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({
+                    id: nodeId,
+                    type: "knowledge",
+                    name: `Notebook — ${title}`,
+                    description: `A Deep Diver notebook built for episode ${input.episodeFolder}: ${title}.`,
+                    direction: "east",
+                    metadata: {
+                        kind: NOTEBOOK_NODE_KIND,
+                        notebook_id: input.entry.id,
+                        public_url: input.entry.url,
+                        address: notebookReference(input.entry.id),
+                        episode_path: input.episodeFolder,
+                        ...(input.entry.path ? { path: input.entry.path } : {}),
+                        ...(input.entry.made_by ? { made_by: input.entry.made_by } : {}),
+                        ...(input.entry.sources?.length ? { sources: input.entry.sources } : {}),
+                        service: "gemini-notebook",
+                    },
+                }),
+            });
+            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 notebook node is not on the wheel yet";
+        return projection;
+    }
+    const edgesUrl = `${base}/api/edges`;
+    // POST replaces a pair the wheel already holds: read the whole list first,
+    // so an edge someone wrote by hand is never overwritten.
+    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_NOTEBOOK_RELATION };
+//# sourceMappingURL=notebook.js.map

package/dist/notebook.js.map

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

package/dist/pde.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The decompositions an episode holds (jgwill/Miadi#778): the episode's own
+ * `.pde/` read from disk, and the `pdes:` list in `episode.yaml` for a PDE
+ * kept in a repository. The contract is `@miadi/episodic-memory-schema`'s
+ * episode-pde; this module reads the folder and writes the list.
+ */
+import { type EpisodePdeEntry } from "@miadi/episodic-memory-schema";
+export type PdeErrorCode = "invalid_pde" | "pde_manifest_conflict";
+export declare class PdeError extends Error {
+    readonly code: PdeErrorCode;
+    constructor(code: PdeErrorCode, message: string);
+}
+export declare function requirePdeUuid(raw: unknown): string;
+/** A PDE found in an episode's `.pde/` folder. */
+export interface FolderPde {
+    uuid: string;
+    /** The folder's `YYMMDDHHmm`. */
+    stamp: string;
+    /** The folder, relative to the episode: `.pde/<stamp>--<uuid>` (children nest below their parent). */
+    path: string;
+    /** For a nested PDE, the uuid of the PDE it was decomposed from. */
+    parent?: string;
+    title?: string;
+    engine?: string;
+    model?: string;
+    /** When the decomposition was made, from `pde-<uuid>.json`. */
+    made?: string;
+}
+/**
+ * Every PDE under `<episodeDir>/.pde`, parents before children, oldest first.
+ * A folder that does not carry miaco's `<stamp>--<uuid>` name is not a PDE and
+ * is not entered. Nothing outside the `.pde/` folder is read.
+ */
+export declare function readEpisodePdeFolder(episodeDir: string): Promise<FolderPde[]>;
+export interface UpsertEpisodePdeResult {
+    entry: EpisodePdeEntry;
+    created: boolean;
+    /** Keys an existing entry lacked and now has. */
+    filled: string[];
+    wrote: boolean;
+    dryRun: boolean;
+}
+/**
+ * Add a PDE to `episode.yaml`'s `pdes:` list, or fill the keys an existing
+ * entry for the same uuid lacks. Comments, key order and every other field
+ * survive. Refuses a `pdes` key that is not a list, and an entry whose path is
+ * absolute or climbs out.
+ */
+export declare function upsertEpisodePde(input: {
+    episodeYamlPath: string;
+    entry: EpisodePdeEntry;
+    dryRun?: boolean;
+}): Promise<UpsertEpisodePdeResult>;
+//# sourceMappingURL=pde.d.ts.map

package/dist/pde.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pde.d.ts","sourceRoot":"","sources":["../src/pde.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAOL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAA;AAGtC,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,uBAAuB,CAAA;AAElE,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,YAAY;gBAAlB,IAAI,EAAE,YAAY,EAClC,OAAO,EAAE,MAAM;CAKlB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAInD;AAID,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,sGAAsG;IACtG,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAeD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA+BnF;AAID,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,eAAe,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,iDAAiD;IACjD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;CAChB;AAkBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAwDpJ"}

package/dist/pde.js

@@ -0,0 +1,165 @@
+/**
+ * The decompositions an episode holds (jgwill/Miadi#778): the episode's own
+ * `.pde/` read from disk, and the `pdes:` list in `episode.yaml` for a PDE
+ * kept in a repository. The contract is `@miadi/episodic-memory-schema`'s
+ * episode-pde; this module reads the folder and writes the list.
+ */
+import { readFile, readdir, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { Scalar, isMap, isScalar, isSeq, parseDocument } from "yaml";
+import { PDE_ENTRY_KEYS, isRelativePdePath, pdeFolderOf, pdeTitleOf, pdeUuidOf, toEpisodePdeEntry, } from "@miadi/episodic-memory-schema";
+import { missingManifestRemedy } from "./episode.js";
+export class PdeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "PdeError";
+    }
+}
+export function requirePdeUuid(raw) {
+    const uuid = pdeUuidOf(raw);
+    if (!uuid)
+        throw new PdeError("invalid_pde", `'${String(raw)}' is not a PDE uuid or a miadi-pde: reference`);
+    return uuid;
+}
+const MAX_DEPTH = 5;
+const str = (value) => (typeof value === "string" && value.trim() ? value.trim() : undefined);
+async function readJson(file) {
+    try {
+        const parsed = JSON.parse(await readFile(file, "utf8"));
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Every PDE under `<episodeDir>/.pde`, parents before children, oldest first.
+ * A folder that does not carry miaco's `<stamp>--<uuid>` name is not a PDE and
+ * is not entered. Nothing outside the `.pde/` folder is read.
+ */
+export async function readEpisodePdeFolder(episodeDir) {
+    const out = [];
+    const walk = async (dir, rel, parent, depth) => {
+        if (depth > MAX_DEPTH)
+            return;
+        let names;
+        try {
+            names = (await readdir(dir, { withFileTypes: true })).filter((d) => d.isDirectory()).map((d) => d.name).sort();
+        }
+        catch {
+            return;
+        }
+        for (const name of names) {
+            const folder = pdeFolderOf(name);
+            if (!folder)
+                continue;
+            const path = `${rel}/${name}`;
+            const json = await readJson(join(dir, name, `pde-${folder.uuid}.json`));
+            const meta = await readJson(join(dir, name, "meta.json"));
+            const pde = { uuid: folder.uuid, stamp: folder.stamp, path, ...(parent ? { parent } : {}) };
+            const title = pdeTitleOf(json);
+            if (title)
+                pde.title = title;
+            const engine = str(json?.engine) ?? str(meta?.engine);
+            if (engine)
+                pde.engine = engine;
+            const model = str(json?.model) ?? str(meta?.model);
+            if (model)
+                pde.model = model;
+            const made = str(json?.timestamp) ?? str(meta?.created_at);
+            if (made)
+                pde.made = made;
+            out.push(pde);
+            await walk(join(dir, name), path, folder.uuid, depth + 1);
+        }
+    };
+    await walk(join(episodeDir, ".pde"), ".pde", undefined, 1);
+    return out;
+}
+function quoted(doc, value) {
+    const node = doc.createNode(value);
+    node.type = Scalar.QUOTE_SINGLE;
+    return node;
+}
+function entryNode(doc, entry) {
+    const map = doc.createNode({});
+    for (const key of PDE_ENTRY_KEYS) {
+        const value = entry[key];
+        if (value === undefined || value === "")
+            continue;
+        map.set(key, quoted(doc, value));
+    }
+    return map;
+}
+/**
+ * Add a PDE to `episode.yaml`'s `pdes:` list, or fill the keys an existing
+ * entry for the same uuid lacks. Comments, key order and every other field
+ * survive. Refuses a `pdes` key that is not a list, and an entry whose path is
+ * absolute or climbs out.
+ */
+export async function upsertEpisodePde(input) {
+    if (input.entry.path !== undefined && !isRelativePdePath(input.entry.path)) {
+        throw new PdeError("invalid_pde", `path '${input.entry.path}' must be relative to its repository or to the episode folder`);
+    }
+    if (!existsSync(input.episodeYamlPath)) {
+        throw new PdeError("pde_manifest_conflict", missingManifestRemedy(dirname(input.episodeYamlPath)));
+    }
+    const doc = parseDocument(await readFile(input.episodeYamlPath, "utf8"));
+    if (doc.errors.length > 0) {
+        throw new PdeError("pde_manifest_conflict", `unreadable episode.yaml ${input.episodeYamlPath}: ${doc.errors[0].message}`);
+    }
+    if (!isMap(doc.contents)) {
+        throw new PdeError("pde_manifest_conflict", `episode.yaml ${input.episodeYamlPath} is not a mapping`);
+    }
+    const list = doc.get("pdes", 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("pdes", seq);
+    }
+    else if (!isSeq(list)) {
+        throw new PdeError("pde_manifest_conflict", `pdes in ${input.episodeYamlPath} is not a list — refusing to overwrite`);
+    }
+    else {
+        const index = list.items.findIndex((item) => toEpisodePdeEntry(isMap(item) ? item.toJSON() : item)?.uuid === input.entry.uuid);
+        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 PDE_ENTRY_KEYS) {
+                    const value = input.entry[key];
+                    if (value === undefined || value === "")
+                        continue;
+                    const present = item.get(key);
+                    if (present === undefined || present === null || present === "") {
+                        item.set(key, quoted(doc, value));
+                        filled.push(key);
+                    }
+                }
+                entry = toEpisodePdeEntry(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 };
+}
+//# sourceMappingURL=pde.js.map

package/dist/pde.js.map

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

package/dist/prototype.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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 { DEFAULT_PROTOTYPE_RELATION, type EpisodePrototypeEntry } from "@miadi/episodic-memory-schema";
+export type PrototypeErrorCode = "invalid_prototype" | "prototype_manifest_conflict";
+export declare class PrototypeError extends Error {
+    readonly code: PrototypeErrorCode;
+    constructor(code: PrototypeErrorCode, message: string);
+}
+/** The slug an input names: a slug or `miadi-prototype:<slug>`. */
+export declare function requirePrototypeSlug(raw: unknown): string;
+/** The published address an input names, or a refusal. */
+export declare function requirePrototypeUrl(raw: unknown): string;
+/** A v0 chat page is where a prototype is edited, never where it is published. */
+export declare function looksLikeEditor(url: string): boolean;
+/** The published and the editing address are two doors; one URL cannot be both. */
+export declare function assertDistinctPrototypeAddresses(url: string, editor: string | undefined): void;
+/** The editing address, when given: https, kept off the manifest. */
+export declare function optionalEditorUrl(raw: unknown): string | undefined;
+export interface UpsertEpisodePrototypeResult {
+    entry: EpisodePrototypeEntry;
+    created: boolean;
+    filled: string[];
+    wrote: boolean;
+    dryRun: boolean;
+}
+/**
+ * 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 declare function upsertEpisodePrototype(input: {
+    episodeYamlPath: string;
+    entry: EpisodePrototypeEntry;
+    dryRun?: boolean;
+}): Promise<UpsertEpisodePrototypeResult>;
+export type PrototypeProjectionState = "created" | "refreshed" | "already-present" | "skipped" | "pending";
+export interface PrototypeProjection {
+    node: {
+        id: string;
+        state: PrototypeProjectionState;
+        error?: string;
+    };
+    edge: {
+        id: string;
+        state: PrototypeProjectionState;
+        relationship_type: string;
+        error?: string;
+    };
+}
+/** The relationship type of an episode→prototype edge already on the wheel. Never throws. */
+export declare function existingPrototypeRelation(mwUrl: string, episodeNodeId: string, nodeId: string, options?: {
+    fetchImpl?: typeof fetch;
+}): Promise<string | undefined>;
+/** The editing address a prototype node holds, for a viewer the door has already checked. Never throws. */
+export declare function prototypeEditorUrl(mwUrl: string, slug: string, options?: {
+    fetchImpl?: typeof fetch;
+}): Promise<string | 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 declare function projectEpisodePrototype(mwUrl: string, input: {
+    episodeNodeId: string;
+    episodeFolder: string;
+    entry: EpisodePrototypeEntry;
+    /** Kept in the node's metadata only. */
+    editor?: string;
+    relation: string;
+}, options?: {
+    fetchImpl?: typeof fetch;
+    dryRun?: boolean;
+}): Promise<PrototypeProjection>;
+export { DEFAULT_PROTOTYPE_RELATION };
+//# sourceMappingURL=prototype.d.ts.map

package/dist/prototype.d.ts.map

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