@miadi/inquiry-weave 0.16.3 → 0.16.5

package/README.md

@@ -53,23 +53,33 @@ aliases for older environments.
 everywhere. `MW_API_URL_OVERRIDE` and `MW_API_URL` are legacy fallbacks, read
 only when it is unset.
 
-## Give an inquiry folder its thread, before any episode
+## Words
+
+- **artefact**: a folder on the shelf (`MIADI_INQUIRY_DIR`) where research is saved.
+- **inquiry**: what an artefact pursues. It is followed in one GitHub **issue**,
+  recorded in the artefact's `.weave.yaml`.
+- **weave**: make an artefact part of an episode. The episode keeps a copy under
+  `inquiry/<artefact>/`, both sides record the weave, and the wheel registers it.
+  `weave` (CLI), the episode door and the room's Inquiries card all do it. `relate`
+  is its first half (the records without the copy). `promote` is its older name.
+
+## Give an artefact its issue, before any episode
 
 ```bash
 cd "$MIADI_INQUIRY_DIR/a-question"
 inquiry-weave issue            # --title, --body/--body-file, --repo, --dry-run
 ```
 
-Creates the GitHub issue the folder is followed in (its thread) in
-`MIADI_INQUIRY_GITHUB_REPO` and records it in the folder's `.weave.yaml` with no
-episode. When the folder is later attached to an episode (the room's Inquiries
-card, the door, or `relate`), the thread comes with it. A folder whose
+Creates the GitHub issue the artefact's inquiry is followed in, in
+`MIADI_INQUIRY_GITHUB_REPO`, and records it in the artefact's `.weave.yaml` with no
+episode. When the artefact is later woven into an episode (the room's Inquiries
+card, the door, `weave` or `relate`), the issue comes with it. An artefact whose
 `.weave.yaml` already names its issue is left as it is. `--issue owner/repo#N`
-records an issue that already exists. A folder whose `.hch/issue_<N>.env` (left by
+records an issue that already exists. An artefact whose `.hch/issue_<N>.env` (left by
 `issue_add`) names an issue is refused with that issue named, so it is recorded with
 `--issue` rather than duplicated. `--force` creates another anyway.
 
-The thread is then read and answered by the folder alone, with no issue number:
+The issue is then read and answered by the artefact alone, with no issue number:
 
 ```bash
 inquiry-weave issue view                     # title, state, body, comments, episodes woven
@@ -81,7 +91,7 @@ inquiry-weave issue comment --body "…"       # or --body-file notes.md; --dry-
 | `issue_add "<title>" "<body>"` | `issue [--title] [--body]` | `.weave.yaml` `issue`, `issue_url` |
 | `issue_info <id>` / `iuit` | `issue view` | reads `.weave.yaml` |
 | `issue_comment <id> "<body>"` | `issue comment --body` | the comment on GitHub |
-| `iut`, `iutg` (all issues of a repo) | MCP `inquiry_list_threads` | the IAIP app at `MIADI_INQUIRY_THREADS_BASE` |
+| `iut`, `iutg` (all issues of a repo) | MCP `inquiry_list_issues` | the IAIP app at `MIADI_INQUIRY_ISSUES_BASE` |
 
 The shell functions leave `.hch/` side files that no reader treats as a record.
 
@@ -258,13 +268,15 @@ the next authoring. `MIADI_EPISODE_DOOR=http` sends the MCP's episode tools
 through the app at `MIADI_INQUIRY_API_BASE` even on a host that holds the
 chronicle.
 
-## Inquiry threads over MCP
+## Inquiry issues over MCP
 
-`inquiry_list_threads` and `inquiry_get_thread` read the threads (the GitHub issues an
-inquiry is followed in) from the app that serves `/api/inquiry`, the IAIP app. Set
-`MIADI_INQUIRY_THREADS_BASE` to it, for example `http://127.0.0.1:9946`. The episode tools
+`inquiry_list_issues` and `inquiry_get_issue` read the GitHub issues inquiries are
+followed in from the app that serves `/api/inquiry`, the IAIP app. Set
+`MIADI_INQUIRY_ISSUES_BASE` to it, for example `http://127.0.0.1:9946`. The episode tools
 keep `MIADI_INQUIRY_API_BASE`, the Miadi episode door, which has no `/api/inquiry`. Without
-`MIADI_INQUIRY_THREADS_BASE` the threads tools fall back to `MIADI_INQUIRY_API_BASE`.
+it the issue tools read `MIADI_INQUIRY_THREADS_BASE` (the 0.16.2 name), then
+`MIADI_INQUIRY_API_BASE`. The 0.16.2 tool names `inquiry_list_threads` and
+`inquiry_get_thread` still answer, unlisted.
 
 ## Reviews in an episode
 

package/dist/artefact-issue.d.ts

@@ -0,0 +1,87 @@
+/**
+ * An artefact's issue: the GitHub issue the inquiry an artefact pursues is
+ * followed in. (An artefact is a folder on the shelf; the inquiry is what it
+ * pursues. Vocabulary decided 2026-10-06: issue, weave, artefact.)
+ *
+ * `openArtefactIssue` creates that issue from the artefact and records it in
+ * the artefact's `.weave.yaml`, the record every reader of the weave uses: the
+ * episode room, the episode door, `status`, `relate`. It needs no episode.
+ * When the artefact is later woven into an episode, `relate` (and the door's
+ * weave or sync) carries the issue into the episode's `inquiry/weave.yaml`.
+ *
+ * `viewArtefactIssue` and `commentOnArtefactIssue` read and answer that issue
+ * by the artefact alone: the issue number comes from `.weave.yaml`.
+ *
+ * Together they do for an inquiry folder what `issue_add`, `issue_info` and
+ * `issue_comment` in fn_github_issue.sh did. Those leave `.hch/` side files,
+ * which nothing reads as a record. Ref: jgwill/Miadi#722.
+ */
+import type { ArtefactIdentity } from "./artefact.js";
+import { type IssueView } from "./issue.js";
+export interface OpenArtefactIssueInput {
+    artefact: ArtefactIdentity;
+    /** owner/repo the issue is created in. */
+    repo: string;
+    /** Defaults to the artefact's absolute path, as `inquire` and `issue_add` title it. */
+    title?: string;
+    /** Defaults to the artefact's text documents (the body `inquire` derives). */
+    body?: string;
+    /** An issue that already exists (owner/repo#N): recorded, nothing is created. */
+    issue?: string;
+    /** Create even when a CLI side file names an issue for this artefact. */
+    force?: boolean;
+    dryRun?: boolean;
+    env?: NodeJS.ProcessEnv;
+}
+export interface OpenArtefactIssueResult {
+    artefact: string;
+    artefactDir: string;
+    /** `created`, `recorded` (an existing issue, given), `already-recorded` (nothing changed), or `dry-run`. */
+    status: "created" | "recorded" | "already-recorded" | "dry-run";
+    repo: string;
+    title: string;
+    issue?: string;
+    issue_url?: string;
+    bodyBytes?: number;
+    /** Episodes the artefact is already woven into; each still needs `relate` to carry the issue. */
+    episodes: Array<{
+        path: string;
+        number?: number;
+    }>;
+    dryRun: boolean;
+}
+export declare function openArtefactIssue(input: OpenArtefactIssueInput): Promise<OpenArtefactIssueResult>;
+/** Issues that `.hch/issue_<N>.env` files (fn_github_issue.sh's issue_add) name, newest number first. */
+export declare function issuesNamedBySideFiles(artefactDir: string): Promise<Array<{
+    issue: string;
+    file: string;
+}>>;
+export interface ArtefactIssueView {
+    artefact: string;
+    artefactDir: string;
+    issue: string;
+    episodes: Array<{
+        path: string;
+        number?: number;
+    }>;
+    view: IssueView;
+}
+export declare function viewArtefactIssue(artefact: ArtefactIdentity, env?: NodeJS.ProcessEnv): Promise<ArtefactIssueView>;
+export interface ArtefactIssueComment {
+    artefact: string;
+    issue: string;
+    url?: string;
+    dryRun: boolean;
+    bodyBytes: number;
+}
+export declare function commentOnArtefactIssue(artefact: ArtefactIdentity, body: string, options?: {
+    dryRun?: boolean;
+    env?: NodeJS.ProcessEnv;
+}): Promise<ArtefactIssueComment>;
+/** @deprecated 0.16.2 names, before "thread" gave way to "issue" (2026-10-06). */
+export declare const openArtefactThread: typeof openArtefactIssue;
+/** @deprecated */
+export declare const viewArtefactThread: typeof viewArtefactIssue;
+/** @deprecated */
+export declare const commentOnArtefactThread: typeof commentOnArtefactIssue;
+//# sourceMappingURL=artefact-issue.d.ts.map

package/dist/artefact-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artefact-issue.d.ts","sourceRoot":"","sources":["../src/artefact-issue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAErD,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAInF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,4GAA4G;IAC5G,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,kBAAkB,GAAG,SAAS,CAAA;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iGAAiG;IACjG,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAgDvG;AAED,yGAAyG;AACzG,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAejH;AAaD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD,IAAI,EAAE,SAAS,CAAA;CAChB;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GAC1D,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAED,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,0BAAoB,CAAA;AACnD,kBAAkB;AAClB,eAAO,MAAM,kBAAkB,0BAAoB,CAAA;AACnD,kBAAkB;AAClB,eAAO,MAAM,uBAAuB,+BAAyB,CAAA"}

package/dist/{thread.js → artefact-issue.js}

@@ -1,14 +1,16 @@
 /**
- * An inquiry's thread: the GitHub issue the inquiry is followed in.
+ * An artefact's issue: the GitHub issue the inquiry an artefact pursues is
+ * followed in. (An artefact is a folder on the shelf; the inquiry is what it
+ * pursues. Vocabulary decided 2026-10-06: issue, weave, artefact.)
  *
- * `openArtefactThread` creates that issue from the folder and records it in
- * the folder's `.weave.yaml`, the record every reader of the weave uses: the
+ * `openArtefactIssue` creates that issue from the artefact and records it in
+ * the artefact's `.weave.yaml`, the record every reader of the weave uses: the
  * episode room, the episode door, `status`, `relate`. It needs no episode.
- * When the folder is later woven into an episode, `relate` (and the door's
- * attach or sync) carries the thread into the episode's `inquiry/weave.yaml`.
+ * When the artefact is later woven into an episode, `relate` (and the door's
+ * weave or sync) carries the issue into the episode's `inquiry/weave.yaml`.
  *
- * `viewArtefactThread` and `commentOnArtefactThread` read and answer that
- * thread by the folder alone: the issue number comes from `.weave.yaml`.
+ * `viewArtefactIssue` and `commentOnArtefactIssue` read and answer that issue
+ * by the artefact alone: the issue number comes from `.weave.yaml`.
  *
  * Together they do for an inquiry folder what `issue_add`, `issue_info` and
  * `issue_comment` in fn_github_issue.sh did. Those leave `.hch/` side files,
@@ -20,7 +22,7 @@ import { formatIssueRef, issueRefFromUrl, issueUrlFromRef, parseIssueRef } from
 import { commentOnIssue, createIssue, viewIssue } from "./issue.js";
 import { issueBodyFromArtefact } from "./issue-content.js";
 import { newArtefactWeave, readArtefactWeave, writeArtefactWeave, WeaveError } from "./weave.js";
-export async function openArtefactThread(input) {
+export async function openArtefactIssue(input) {
     const weave = await readArtefactWeave(input.artefact.dir);
     const title = input.title?.trim() || input.artefact.dir;
     const base = {
@@ -31,7 +33,7 @@ export async function openArtefactThread(input) {
         episodes: (weave?.episodes ?? []).map((e) => ({ path: e.path, number: e.number })),
         dryRun: input.dryRun === true,
     };
-    // One folder, one thread: a recorded issue is never duplicated.
+    // One artefact, one issue: a recorded issue is never duplicated.
     if (weave?.issue) {
         return { ...base, status: "already-recorded", issue: weave.issue, issue_url: weave.issue_url };
     }
@@ -49,7 +51,7 @@ export async function openArtefactThread(input) {
         await writeArtefactWeave(input.artefact.dir, next);
         return { ...base, status: "recorded", issue, issue_url };
     }
-    // A folder `issue_add` already gave an issue would get a second one.
+    // An artefact `issue_add` already gave an issue would get a second one.
     if (!input.force) {
         const named = await issuesNamedBySideFiles(input.artefact.dir);
         if (named.length > 0) {
@@ -88,33 +90,39 @@ export async function issuesNamedBySideFiles(artefactDir) {
     }
     return [...found.values()].sort((a, b) => b.number - a.number).map(({ issue, file }) => ({ issue, file }));
 }
-/** The thread a folder's .weave.yaml records, or a WeaveError that says how to give it one. */
-async function recordedThread(artefact) {
+/** The issue an artefact's .weave.yaml records, or a WeaveError that says how to give it one. */
+async function recordedIssue(artefact) {
     const weave = await readArtefactWeave(artefact.dir);
     if (!weave?.issue) {
-        throw new WeaveError(`${artefact.name} has no thread recorded in .weave.yaml — run 'inquiry-weave issue' in the folder to create one`);
+        throw new WeaveError(`${artefact.name} has no issue recorded in .weave.yaml — run 'inquiry-weave issue' in the artefact to create one`);
     }
     return { weave, issue: weave.issue };
 }
-export async function viewArtefactThread(artefact, env) {
-    const { weave, issue } = await recordedThread(artefact);
-    const thread = await viewIssue(issue, { cwd: artefact.dir, env });
+export async function viewArtefactIssue(artefact, env) {
+    const { weave, issue } = await recordedIssue(artefact);
+    const view = await viewIssue(issue, { cwd: artefact.dir, env });
     return {
         artefact: artefact.name,
         artefactDir: artefact.dir,
         issue,
         episodes: weave.episodes.map((e) => ({ path: e.path, number: e.number })),
-        thread,
+        view,
     };
 }
-export async function commentOnArtefactThread(artefact, body, options = {}) {
+export async function commentOnArtefactIssue(artefact, body, options = {}) {
     if (!body.trim())
         throw new WeaveError("a comment needs a body (--body or --body-file)");
-    const { issue } = await recordedThread(artefact);
+    const { issue } = await recordedIssue(artefact);
     const base = { artefact: artefact.name, issue, dryRun: options.dryRun === true, bodyBytes: Buffer.byteLength(body, "utf8") };
     if (options.dryRun)
         return base;
     const posted = await commentOnIssue(issue, body, { cwd: artefact.dir, env: options.env });
     return { ...base, url: posted.url };
 }
-//# sourceMappingURL=thread.js.map
+/** @deprecated 0.16.2 names, before "thread" gave way to "issue" (2026-10-06). */
+export const openArtefactThread = openArtefactIssue;
+/** @deprecated */
+export const viewArtefactThread = viewArtefactIssue;
+/** @deprecated */
+export const commentOnArtefactThread = commentOnArtefactIssue;
+//# sourceMappingURL=artefact-issue.js.map

package/dist/artefact-issue.js.map

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

package/dist/captures.d.ts

@@ -12,7 +12,7 @@
  * schema's own observer, which is the single declaration of that shape, so
  * enumerating a bundle costs nothing more than reading its descriptor.
  */
-import { type CaptureManifestEntry, type CompatibilityDiagnostic } from "@miadi/episodic-memory-schema";
+import { type CaptureManifestEntry, type CompatibilityDiagnostic, type ScreenwalkRecord } from "@miadi/episodic-memory-schema";
 /** The folder captures live under, inside an episode. */
 export declare const CAPTURES_FOLDER = "captures";
 export interface BuildCaptureIndexOptions {
@@ -38,4 +38,22 @@ export declare function readEpisodeCaptures(episodeDir: string, options?: BuildC
  */
 export declare function buildEpisodeCaptureIndex(chronicleRoot: string, options?: BuildCaptureIndexOptions): Promise<Map<string, CaptureManifestEntry[]>>;
 export type { CaptureManifestEntry };
+/** A screenwalk as an episode holds it, with the file it was read from. */
+export interface EpisodeScreenwalk {
+    record: ScreenwalkRecord;
+    /** `captures/screenwalk-<id>/screenwalk.json`, or the `capture.json` written there by hand before that file existed. */
+    relativePath: string;
+    /** True when the record was read from the early hand-written `capture.json`. */
+    early: boolean;
+}
+/**
+ * Every screenwalk under one episode directory (`captures/screenwalk-<id>/`), in folder order.
+ * `screenwalk.json` is read first; a folder that has only the early hand-written `capture.json`
+ * is read through the same reader and marked `early`. A folder whose file names no screenwalk
+ * is reported and skipped.
+ */
+export declare function readEpisodeScreenwalks(episodeDir: string, options?: {
+    diagnostics?: CompatibilityDiagnostic[];
+    episode?: string;
+}): Promise<EpisodeScreenwalk[]>;
 //# sourceMappingURL=captures.d.ts.map

package/dist/captures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"captures.d.ts","sourceRoot":"","sources":["../src/captures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAE7B,MAAM,+BAA+B,CAAA;AAEtC,yDAAyD;AACzD,eAAO,MAAM,eAAe,aAAa,CAAA;AAEzC,MAAM,WAAW,wBAAwB;IACvC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,uBAAuB,EAAE,CAAA;IACvC,iDAAiD;IACjD,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAgDjC;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAmB9C;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"captures.d.ts","sourceRoot":"","sources":["../src/captures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAOL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAE5B,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAA;AAEtC,yDAAyD;AACzD,eAAO,MAAM,eAAe,aAAa,CAAA;AAEzC,MAAM,WAAW,wBAAwB;IACvC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,uBAAuB,EAAE,CAAA;IACvC,iDAAiD;IACjD,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAkDjC;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAmB9C;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAA;AAEpC,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,gBAAgB,CAAA;IACxB,wHAAwH;IACxH,YAAY,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1E,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA6C9B"}

package/dist/captures.js

@@ -14,7 +14,7 @@
  */
 import { readdir, readFile } from "node:fs/promises";
 import { join } from "node:path";
-import { EPISODE_CAPTURE_MANIFEST_FILENAME, captureManifestEntry, isEpisodeCaptureDescriptor, } from "@miadi/episodic-memory-schema";
+import { EPISODE_CAPTURE_MANIFEST_FILENAME, SCREENWALK_FILE, SCREENWALK_FOLDER_PREFIX, captureManifestEntry, isEpisodeCaptureDescriptor, toScreenwalkRecord, } from "@miadi/episodic-memory-schema";
 /** The folder captures live under, inside an episode. */
 export const CAPTURES_FOLDER = "captures";
 /**
@@ -38,6 +38,9 @@ export async function readEpisodeCaptures(episodeDir, options = {}) {
     }
     const entries = [];
     for (const stem of stems) {
+        // A screenwalk folder holds a screenwalk record, not a capture bundle (readEpisodeScreenwalks).
+        if (stem.startsWith(SCREENWALK_FOLDER_PREFIX))
+            continue;
         const relativePath = `${CAPTURES_FOLDER}/${stem}/${EPISODE_CAPTURE_MANIFEST_FILENAME}`;
         let descriptor;
         try {
@@ -96,4 +99,57 @@ export async function buildEpisodeCaptureIndex(chronicleRoot, options = {}) {
     }
     return index;
 }
+/**
+ * Every screenwalk under one episode directory (`captures/screenwalk-<id>/`), in folder order.
+ * `screenwalk.json` is read first; a folder that has only the early hand-written `capture.json`
+ * is read through the same reader and marked `early`. A folder whose file names no screenwalk
+ * is reported and skipped.
+ */
+export async function readEpisodeScreenwalks(episodeDir, options = {}) {
+    const capturesDir = join(episodeDir, CAPTURES_FOLDER);
+    let folders;
+    try {
+        folders = (await readdir(capturesDir, { withFileTypes: true }))
+            .filter((entry) => entry.isDirectory() && entry.name.startsWith(SCREENWALK_FOLDER_PREFIX))
+            .map((entry) => entry.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+    const screenwalks = [];
+    for (const folder of folders) {
+        for (const file of [SCREENWALK_FILE, EPISODE_CAPTURE_MANIFEST_FILENAME]) {
+            const relativePath = `${CAPTURES_FOLDER}/${folder}/${file}`;
+            let raw;
+            try {
+                raw = JSON.parse(await readFile(join(capturesDir, folder, file), "utf8"));
+            }
+            catch (error) {
+                if (error.code !== "ENOENT") {
+                    options.diagnostics?.push({
+                        level: "warning",
+                        code: "chronicle.screenwalk-unreadable",
+                        message: `${file} is present but could not be read (${String(error.message).split("\n")[0]})`,
+                        path: relativePath,
+                    });
+                }
+                continue;
+            }
+            const record = toScreenwalkRecord(raw, { id: folder, episode: options.episode });
+            if (!record) {
+                options.diagnostics?.push({
+                    level: "warning",
+                    code: "chronicle.screenwalk-unrecognized",
+                    message: `${file} names no screenwalk`,
+                    path: relativePath,
+                });
+                continue;
+            }
+            screenwalks.push({ record, relativePath, early: file !== SCREENWALK_FILE });
+            break;
+        }
+    }
+    return screenwalks;
+}
 //# sourceMappingURL=captures.js.map

package/dist/captures.js.map

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

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAIL,gBAAgB,EAIjB,MAAM,cAAc,CAAA;AAkCrB,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IACzC,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CAC1C;AAED,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,UAAU,CAAC;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AA4mCD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkEzF;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAIL,gBAAgB,EAIjB,MAAM,cAAc,CAAA;AAkCrB,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IACzC,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CAC1C;AAED,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,UAAU,CAAC;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAinCD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkEzF;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/cli.js

@@ -23,7 +23,7 @@ import { episodeNodeId, registerEpisodeNode, } from "./episode-node.js";
 import { installSkill, skillMarkdown, SkillInstallError } from "./skill.js";
 import { syncArtefact } from "./sync.js";
 import { artefactStatus, episodeStatus } from "./status.js";
-import { commentOnArtefactThread, openArtefactThread, viewArtefactThread } from "./thread.js";
+import { commentOnArtefactIssue, openArtefactIssue, viewArtefactIssue } from "./artefact-issue.js";
 import { registerArtefact, registerEpisode } from "./register.js";
 import { readArtefactWeave, readEpisodeWeave, WeaveError } from "./weave.js";
 class UsageError extends Error {
@@ -31,8 +31,12 @@ class UsageError extends Error {
 const USAGE = `Usage: inquiry-weave <command> [flags]
 
 Commands:
+  weave    --artefact <name|path> (--episode <ref> | --new-episode <slug> [--title <t>])
+           Weaves an artefact into an episode: records the weave on both sides
+           and copies the artefact into the episode's inquiry/ folder.
+           (promote is its older name.)
   relate   --artefact <name|path> --episode <num|name|path> [--issue owner/repo#N]
-  promote  --artefact <name|path> (--episode <ref> | --new-episode <slug> [--title <t>])
+           Records the weave on both sides without copying (weave's first half).
   inquire  (--episode <ref> | --new-episode <slug>)
            (--artefact <name|path> | --slug <new-artefact-slug>)
            [--title <t>] [--body <text> | --body-file <path>]
@@ -42,17 +46,17 @@ Commands:
            empty artefact vessel under the inquiry root.
   issue    [create] [--artefact <name|path>] [--title <t>] [--body <text> | --body-file <path>]
            [--repo owner/repo] [--issue owner/repo#N] [--force] [--dry-run]
-           Creates the GitHub issue an inquiry folder is followed in (its thread)
-           and records it in the folder's .weave.yaml. The folder defaults to the
-           current one, and no episode is needed. A folder whose .weave.yaml
+           Creates the GitHub issue the artefact's inquiry is followed in and
+           records it in the artefact's .weave.yaml. The artefact defaults to the
+           current folder, and no episode is needed. An artefact whose .weave.yaml
            already names its issue is left as it is. --issue records an issue
-           that already exists. A folder whose .hch/issue_<N>.env (issue_add)
+           that already exists. An artefact whose .hch/issue_<N>.env (issue_add)
            names an issue is refused unless --issue or --force is given.
   issue view [--artefact <name|path>] [--json]
-           The folder's recorded thread: title, state, body, comments, and the
-           episodes the folder is woven into.
+           The artefact's recorded issue: title, state, body, comments, and the
+           episodes the artefact is woven into.
   issue comment (--body <text> | --body-file <path>) [--artefact <name|path>] [--dry-run]
-           Adds a comment to the folder's recorded thread.
+           Adds a comment to the artefact's recorded issue.
   sync     (--artefact <ref> [--episode <ref>] | --episode <ref> [--all])
   status   (--episode <ref> | --artefact <ref>) [--json]
   register (--episode <ref> | --artefact <ref>) [--dry-run]
@@ -230,7 +234,7 @@ async function commandPromote(context) {
     const newSlug = stringFlag(context.flags, "new-episode");
     const episodeRef = stringFlag(context.flags, "episode");
     if ((newSlug === undefined) === (episodeRef === undefined)) {
-        throw new UsageError("promote needs exactly one of --episode or --new-episode <slug>");
+        throw new UsageError("weave (promote) needs exactly one of --episode or --new-episode <slug>");
     }
     const dryRun = context.flags.get("dry-run") === true;
     const episode = newSlug
@@ -249,7 +253,7 @@ async function commandPromote(context) {
     });
     emit(context, { related, synced }, [
         ...(newSlug ? [`${dryRun ? "would scaffold" : "scaffolded"} episode: ${episode.dir}`] : []),
-        ...relateLines(related, "promoted"),
+        ...relateLines(related, "woven"),
         ...syncLines(synced),
     ]);
     return 0;
@@ -395,7 +399,7 @@ async function commandSync(context) {
         else {
             const weave = await readArtefactWeave(artefact.dir);
             if (!weave || weave.episodes.length === 0) {
-                throw new WeaveError(`artefact ${artefact.name} has no related episodes — run 'relate' or 'promote' first`);
+                throw new WeaveError(`artefact ${artefact.name} is woven into no episode — run 'weave' or 'relate' first`);
             }
             for (const link of weave.episodes) {
                 const episodeDir = isAbsolute(link.path)
@@ -951,11 +955,11 @@ async function commandIssue(context) {
         throw new UsageError("use only one of --body or --body-file");
     }
     if (action === "view") {
-        const view = await viewArtefactThread(artefact, context.processEnv);
-        const t = view.thread;
+        const view = await viewArtefactIssue(artefact, context.processEnv);
+        const t = view.view;
         const lines = [
             `# ${t.title} (${t.state})`,
-            `  thread:   ${view.issue}  ${t.url}`,
+            `  issue:    ${view.issue}  ${t.url}`,
             `  artefact: ${view.artefactDir}`,
             `  author:   ${t.author?.login ?? "?"} · created ${t.createdAt ?? "?"} · updated ${t.updatedAt ?? "?"}`,
             ...(t.labels?.length ? [`  labels:   ${t.labels.map((l) => l.name).join(", ")}`] : []),
@@ -971,7 +975,7 @@ async function commandIssue(context) {
         const text = bodyFile !== undefined ? await readFile(resolve(bodyFile), "utf8") : body;
         if (text === undefined)
             throw new UsageError("issue comment needs --body <text> or --body-file <path>");
-        const posted = await commentOnArtefactThread(artefact, text, {
+        const posted = await commentOnArtefactIssue(artefact, text, {
             dryRun: context.flags.get("dry-run") === true,
             env: context.processEnv,
         });
@@ -984,7 +988,7 @@ async function commandIssue(context) {
     if (action !== "create") {
         throw new UsageError(`issue knows 'create' (the default), 'view' and 'comment', not '${action}'`);
     }
-    const result = await openArtefactThread({
+    const result = await openArtefactIssue({
         artefact,
         repo: context.env.repo,
         title: stringFlag(context.flags, "title"),
@@ -1005,7 +1009,7 @@ async function commandIssue(context) {
     if (result.status === "created" || result.status === "recorded")
         lines.push(`  recorded in ${result.artefactDir}/.weave.yaml`);
     for (const episode of result.episodes) {
-        lines.push(`  woven into ${episode.number !== undefined ? `episode ${episode.number}` : episode.path}: carry the thread there with \`inquiry-weave relate --artefact ${result.artefact} --episode ${episode.number ?? episode.path}\`, or Sync in the episode room`);
+        lines.push(`  woven into ${episode.number !== undefined ? `episode ${episode.number}` : episode.path}: carry the issue there with \`inquiry-weave relate --artefact ${result.artefact} --episode ${episode.number ?? episode.path}\`, or Sync in the episode room`);
     }
     emit(context, result, lines);
     return 0;
@@ -1013,6 +1017,7 @@ async function commandIssue(context) {
 const COMMANDS = {
     relate: commandRelate,
     issue: commandIssue,
+    weave: commandPromote,
     promote: commandPromote,
     inquire: commandInquire,
     sync: commandSync,