@miadi/inquiry-weave 0.1.0

package/dist/issue.js

@@ -0,0 +1,55 @@
+/**
+ * GitHub issue creation — delegated to the sourced functions in
+ * fn_github_issue.sh (gh CLI wrappers), the successor of issue_add_V2.sh.
+ *
+ * The functions write their own `.hch/` cache in the cwd; this package treats
+ * that as fn's private cache and records the issue identity into .weave.yaml
+ * from the parsed stdout, so nothing downstream depends on `.hch`.
+ */
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { promisify } from "node:util";
+import { issueRefFromUrl, formatIssueRef, issueUrlFromRef, parseIssueRef } from "./legacy-hch.js";
+const execFileAsync = promisify(execFile);
+export const ISSUE_LIB_CANDIDATES = [
+    "/a/src/scripts/fn_github_issue.sh",
+    "/src/scripts/fn_github_issue.sh",
+];
+export class IssueCreationError extends Error {
+}
+export function resolveIssueLib(env = process.env) {
+    const override = env.INQUIRY_WEAVE_ISSUE_LIB;
+    if (override && override.trim() !== "")
+        return override;
+    return ISSUE_LIB_CANDIDATES.find((candidate) => existsSync(candidate));
+}
+export async function createIssue(input) {
+    const env = input.env ?? process.env;
+    const lib = resolveIssueLib(env);
+    if (!lib || !existsSync(lib)) {
+        throw new IssueCreationError(`fn_github_issue.sh not found (tried INQUIRY_WEAVE_ISSUE_LIB, ${ISSUE_LIB_CANDIDATES.join(", ")}). ` +
+            `Install it or pass --no-issue and create the issue manually.`);
+    }
+    let stdout;
+    try {
+        const result = await execFileAsync("bash", ["-c", '. "$0" && issue_add "$1" "$2" "$3"', lib, input.title, input.body, input.repo], { cwd: input.cwd, env: { ...env } });
+        stdout = result.stdout;
+    }
+    catch (error) {
+        const failure = error;
+        throw new IssueCreationError(`issue_add failed (is 'gh' installed and authenticated?): ${failure.stderr || failure.stdout || failure.message}`);
+    }
+    // issue_add prints `* owner/repo#N` on success — authoritative capture.
+    const refMatch = /\*\s+([A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+#\d+)/.exec(stdout);
+    const ref = refMatch ? parseIssueRef(refMatch[1]) : undefined;
+    if (ref) {
+        return { issue: formatIssueRef(ref), issue_url: issueUrlFromRef(ref), stdout };
+    }
+    const urlMatch = /https:\/\/github\.com\/[^\s]+\/issues\/\d+/.exec(stdout);
+    const fromUrl = urlMatch ? issueRefFromUrl(urlMatch[0]) : undefined;
+    if (fromUrl) {
+        return { issue: formatIssueRef(fromUrl), issue_url: issueUrlFromRef(fromUrl), stdout };
+    }
+    throw new IssueCreationError(`could not parse issue reference from issue_add output:\n${stdout}`);
+}
+//# sourceMappingURL=issue.js.map

package/dist/issue.js.map

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

package/dist/legacy-hch.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Best-effort reader for the legacy `.hch/` issue-harness cache.
+ *
+ * `.hch` is NOT a contract of this package: it is read once to seed
+ * `.weave.yaml` when relating a pre-existing artefact, and never written.
+ * Its fate (formalize / map / retire) is an open decision — see README.
+ *
+ * Tolerated shapes:
+ *  - correct:   .hch/issue_<N>.env with issue_id / issue_title / issue_url
+ *  - V2-era bug: literal .hch/issue_.env, no issue_url line
+ *  - fallback:  newest .hch/issue_add__<tlid>.json (gh/REST issue payload)
+ */
+export interface IssueRef {
+    owner: string;
+    repo: string;
+    number: number;
+}
+export interface LegacyIssueSeed {
+    issue?: string;
+    issue_url?: string;
+    diagnostics: string[];
+}
+export declare function parseIssueRef(ref: string): IssueRef | undefined;
+export declare function formatIssueRef(ref: IssueRef): string;
+export declare function issueRefFromUrl(url: string): IssueRef | undefined;
+export declare function issueUrlFromRef(ref: IssueRef): string;
+export declare function readLegacyHch(artefactDir: string, fallbackRepo?: string): Promise<LegacyIssueSeed | undefined>;
+//# sourceMappingURL=legacy-hch.d.ts.map

package/dist/legacy-hch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-hch.d.ts","sourceRoot":"","sources":["../src/legacy-hch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAID,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAI/D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAIjE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAErD;AAmBD,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CA2EtC"}

package/dist/legacy-hch.js

@@ -0,0 +1,120 @@
+/**
+ * Best-effort reader for the legacy `.hch/` issue-harness cache.
+ *
+ * `.hch` is NOT a contract of this package: it is read once to seed
+ * `.weave.yaml` when relating a pre-existing artefact, and never written.
+ * Its fate (formalize / map / retire) is an open decision — see README.
+ *
+ * Tolerated shapes:
+ *  - correct:   .hch/issue_<N>.env with issue_id / issue_title / issue_url
+ *  - V2-era bug: literal .hch/issue_.env, no issue_url line
+ *  - fallback:  newest .hch/issue_add__<tlid>.json (gh/REST issue payload)
+ */
+import { readdir, readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+const ISSUE_URL_PATTERN = /github\.com\/([^/\s]+)\/([^/\s]+)\/issues\/(\d+)/;
+export function parseIssueRef(ref) {
+    const match = /^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)#(\d+)$/.exec(ref.trim());
+    if (!match)
+        return undefined;
+    return { owner: match[1], repo: match[2], number: Number(match[3]) };
+}
+export function formatIssueRef(ref) {
+    return `${ref.owner}/${ref.repo}#${ref.number}`;
+}
+export function issueRefFromUrl(url) {
+    const match = ISSUE_URL_PATTERN.exec(url);
+    if (!match)
+        return undefined;
+    return { owner: match[1], repo: match[2], number: Number(match[3]) };
+}
+export function issueUrlFromRef(ref) {
+    return `https://github.com/${ref.owner}/${ref.repo}/issues/${ref.number}`;
+}
+function parseEnvLines(content) {
+    const values = {};
+    for (const line of content.split("\n")) {
+        const match = /^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/.exec(line.trim());
+        if (!match)
+            continue;
+        let value = match[2].trim();
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        values[match[1]] = value;
+    }
+    return values;
+}
+export async function readLegacyHch(artefactDir, fallbackRepo) {
+    const hchDir = join(artefactDir, ".hch");
+    if (!existsSync(hchDir))
+        return undefined;
+    const entries = await readdir(hchDir);
+    const diagnostics = [];
+    const envFiles = entries.filter((name) => /^issue_\d*\.env$/.test(name)).sort();
+    let issueId;
+    for (const name of envFiles) {
+        const values = parseEnvLines(await readFile(join(hchDir, name), "utf8"));
+        if (values.issue_url) {
+            const ref = issueRefFromUrl(values.issue_url);
+            if (ref) {
+                return { issue: formatIssueRef(ref), issue_url: values.issue_url, diagnostics };
+            }
+            diagnostics.push(`.hch/${name}: unparseable issue_url ${values.issue_url}`);
+        }
+        if (values.issue_id && /^\d+$/.test(values.issue_id)) {
+            issueId = Number(values.issue_id);
+            if (name === "issue_.env") {
+                diagnostics.push(".hch/issue_.env found (issue_add_V2-era bug shape, no issue_url recorded)");
+            }
+        }
+    }
+    const jsonFiles = entries
+        .filter((name) => /^issue_add__.*\.json$/.test(name))
+        .sort()
+        .reverse();
+    for (const name of jsonFiles) {
+        let payload;
+        try {
+            payload = JSON.parse(await readFile(join(hchDir, name), "utf8"));
+        }
+        catch {
+            diagnostics.push(`.hch/${name}: unreadable JSON, skipped`);
+            continue;
+        }
+        const record = payload;
+        const url = typeof record.url === "string"
+            ? record.url
+            : typeof record.html_url === "string"
+                ? record.html_url
+                : undefined;
+        if (url) {
+            const ref = issueRefFromUrl(url);
+            if (ref) {
+                diagnostics.push(`issue identity recovered from .hch/${name}`);
+                return { issue: formatIssueRef(ref), issue_url: url, diagnostics };
+            }
+        }
+        if (issueId === undefined && typeof record.number === "number")
+            issueId = record.number;
+    }
+    if (issueId !== undefined && fallbackRepo) {
+        const ref = parseIssueRef(`${fallbackRepo}#${issueId}`);
+        if (ref) {
+            diagnostics.push(`issue_url missing in legacy .hch; repo ${fallbackRepo} assumed from configuration`);
+            return {
+                issue: formatIssueRef(ref),
+                issue_url: issueUrlFromRef(ref),
+                diagnostics,
+            };
+        }
+    }
+    if (issueId !== undefined) {
+        diagnostics.push(`legacy .hch knows issue #${issueId} but no repo could be determined`);
+        return { diagnostics };
+    }
+    return undefined;
+}
+//# sourceMappingURL=legacy-hch.js.map

package/dist/legacy-hch.js.map

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

package/dist/relate.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The relate operation — records the three-identity relation on both sides
+ * and appends the artefact's AGENTS.md back-link. No copying, no content.
+ */
+import { type ArtefactIdentity } from "./artefact.js";
+import type { EpisodeIdentity } from "./episode.js";
+export type IssueSeedSource = "flag" | "created" | "artefact-weave" | "legacy-hch";
+export interface RelateInput {
+    artefact: ArtefactIdentity;
+    episode: EpisodeIdentity;
+    /** Explicit owner/repo#N — from --issue or a just-created issue. */
+    issue?: string;
+    issueUrl?: string;
+    issueSource?: IssueSeedSource;
+    /** Repo assumed when legacy .hch knows only an issue id. */
+    fallbackRepo: string;
+    now?: () => Date;
+}
+export interface RelateResult {
+    artefact: string;
+    artefactDir: string;
+    episodePath: string;
+    episodeDir: string;
+    issue?: string;
+    issue_url?: string;
+    issueSource?: IssueSeedSource;
+    backLinkAppended: boolean;
+    diagnostics: string[];
+}
+export declare function relate(input: RelateInput): Promise<RelateResult>;
+//# sourceMappingURL=relate.d.ts.map

package/dist/relate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relate.d.ts","sourceRoot":"","sources":["../src/relate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAcnD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,YAAY,CAAA;AAElF,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,OAAO,EAAE,eAAe,CAAA;IACxB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,gBAAgB,EAAE,OAAO,CAAA;IACzB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,wBAAsB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAiFtE"}

package/dist/relate.js

@@ -0,0 +1,79 @@
+/**
+ * The relate operation — records the three-identity relation on both sides
+ * and appends the artefact's AGENTS.md back-link. No copying, no content.
+ */
+import { appendBackLink } from "./artefact.js";
+import { parseIssueRef, issueUrlFromRef, readLegacyHch } from "./legacy-hch.js";
+import { newArtefactWeave, newEpisodeWeave, readArtefactWeave, readEpisodeWeave, upsertEpisodeLink, upsertInquiry, writeArtefactWeave, writeEpisodeWeave, WeaveError, } from "./weave.js";
+export async function relate(input) {
+    const diagnostics = [];
+    const relatedAt = (input.now?.() ?? new Date()).toISOString();
+    let issue = input.issue;
+    let issueUrl = input.issueUrl;
+    let issueSource = input.issueSource ?? (input.issue ? "flag" : undefined);
+    if (issue && !parseIssueRef(issue)) {
+        throw new WeaveError(`invalid issue reference '${issue}' — expected owner/repo#N`);
+    }
+    if (issue && !issueUrl) {
+        issueUrl = issueUrlFromRef(parseIssueRef(issue));
+    }
+    const artefactWeave = (await readArtefactWeave(input.artefact.dir)) ?? newArtefactWeave(input.artefact.dir);
+    if (!issue && artefactWeave.issue) {
+        issue = artefactWeave.issue;
+        issueUrl = artefactWeave.issue_url;
+        issueSource = "artefact-weave";
+    }
+    if (!issue) {
+        const seed = await readLegacyHch(input.artefact.dir, input.fallbackRepo);
+        if (seed) {
+            diagnostics.push(...seed.diagnostics);
+            if (seed.issue) {
+                issue = seed.issue;
+                issueUrl = seed.issue_url;
+                issueSource = "legacy-hch";
+            }
+        }
+    }
+    if (!issue) {
+        diagnostics.push("no GitHub issue is woven yet — pass --issue owner/repo#N or use 'inquire' to create one");
+    }
+    if (issue) {
+        artefactWeave.issue = issue;
+        artefactWeave.issue_url = issueUrl;
+    }
+    upsertEpisodeLink(artefactWeave, {
+        path: input.episode.path,
+        number: input.episode.number,
+        related_at: relatedAt,
+    });
+    await writeArtefactWeave(input.artefact.dir, artefactWeave);
+    const episodeWeave = (await readEpisodeWeave(input.episode.dir)) ??
+        newEpisodeWeave({
+            number: input.episode.number,
+            slug: input.episode.slug,
+            path: input.episode.path,
+        });
+    upsertInquiry(episodeWeave, {
+        artefact: input.artefact.name,
+        issue,
+        issue_url: issueUrl,
+        related_at: relatedAt,
+    });
+    await writeEpisodeWeave(input.episode.dir, episodeWeave);
+    const backLinkAppended = await appendBackLink(input.artefact.dir, {
+        episodeAbsPath: input.episode.dir,
+        issue,
+    });
+    return {
+        artefact: input.artefact.name,
+        artefactDir: input.artefact.dir,
+        episodePath: input.episode.path,
+        episodeDir: input.episode.dir,
+        issue,
+        issue_url: issueUrl,
+        issueSource,
+        backLinkAppended,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=relate.js.map

package/dist/relate.js.map

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

package/dist/status.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Three-identity status report with sync freshness.
+ *
+ * episode.yaml is read-only here: parsed with yaml, observed through
+ * @miadi/episodic-memory-schema's compatibility layer, and only ever the
+ * source of warnings (e.g. an issue missing from issue_anchors).
+ */
+import type { WeaveEnv } from "./env.js";
+import type { EpisodeIdentity } from "./episode.js";
+import type { ArtefactIdentity } from "./artefact.js";
+import { type Freshness } from "./sync.js";
+import { type EpisodeIdentityBlock } from "./weave.js";
+export interface InquiryStatus {
+    artefact: string;
+    artefactDir: string;
+    artefactExists: boolean;
+    issue?: string;
+    issue_url?: string;
+    freshness: Freshness;
+    diagnostics: string[];
+}
+export interface EpisodeStatusReport {
+    kind: "episode";
+    episode: EpisodeIdentityBlock;
+    episodeDir: string;
+    inquiries: InquiryStatus[];
+    warnings: string[];
+}
+export interface ArtefactEpisodeStatus {
+    path: string;
+    episodeDir: string;
+    episodeExists: boolean;
+    freshness: Freshness;
+    diagnostics: string[];
+}
+export interface ArtefactStatusReport {
+    kind: "artefact";
+    artefact: string;
+    artefactDir: string;
+    issue?: string;
+    issue_url?: string;
+    episodes: ArtefactEpisodeStatus[];
+    warnings: string[];
+}
+export declare function episodeStatus(env: WeaveEnv, episode: EpisodeIdentity): Promise<EpisodeStatusReport>;
+export declare function artefactStatus(env: WeaveEnv, artefact: ArtefactIdentity): Promise<ArtefactStatusReport>;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,EAAuC,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAE3F,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,OAAO,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,oBAAoB,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,qBAAqB,EAAE,CAAA;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAiCD,wBAAsB,aAAa,CACjC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAuC9B;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAyD/B"}

package/dist/status.js

@@ -0,0 +1,142 @@
+/**
+ * Three-identity status report with sync freshness.
+ *
+ * episode.yaml is read-only here: parsed with yaml, observed through
+ * @miadi/episodic-memory-schema's compatibility layer, and only ever the
+ * source of warnings (e.g. an issue missing from issue_anchors).
+ */
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+import { parse } from "yaml";
+import { observeEpisodeYamlManifest } from "@miadi/episodic-memory-schema";
+import { classifyFreshness } from "./sync.js";
+import { readArtefactWeave, readEpisodeWeave } from "./weave.js";
+function episodeDirFromPath(chronicleRoot, path) {
+    return isAbsolute(path) ? path : join(chronicleRoot, path);
+}
+async function episodeYamlWarnings(episodeDir, issues) {
+    const warnings = [];
+    const yamlPath = join(episodeDir, "episode.yaml");
+    if (!existsSync(yamlPath))
+        return warnings;
+    const raw = await readFile(yamlPath, "utf8");
+    for (const issue of issues) {
+        if (!raw.includes(issue)) {
+            warnings.push(`episode.yaml does not reference ${issue} — consider adding it to issue_anchors (manually; this package never rewrites episode.yaml)`);
+        }
+    }
+    try {
+        const observation = observeEpisodeYamlManifest(parse(raw), {
+            relativePath: "episode.yaml",
+        });
+        for (const diagnostic of observation.diagnostics) {
+            if (diagnostic.level !== "info") {
+                warnings.push(`episode.yaml (${diagnostic.level}): ${diagnostic.message}`);
+            }
+        }
+    }
+    catch {
+        warnings.push("episode.yaml could not be parsed as YAML");
+    }
+    return warnings;
+}
+export async function episodeStatus(env, episode) {
+    const weave = await readEpisodeWeave(episode.dir);
+    const warnings = [];
+    if (!weave) {
+        warnings.push("no inquiry/weave.yaml — nothing is related to this episode yet");
+        return {
+            kind: "episode",
+            episode: { number: episode.number, slug: episode.slug, path: episode.path },
+            episodeDir: episode.dir,
+            inquiries: [],
+            warnings,
+        };
+    }
+    const inquiries = [];
+    for (const entry of weave.inquiries) {
+        const artefactDir = join(env.inquiryRoot, entry.artefact);
+        const artefactExists = existsSync(artefactDir);
+        const freshness = await classifyFreshness(artefactDir, episode.dir, entry);
+        inquiries.push({
+            artefact: entry.artefact,
+            artefactDir,
+            artefactExists,
+            issue: entry.issue,
+            issue_url: entry.issue_url,
+            freshness: freshness.state,
+            diagnostics: freshness.diagnostics,
+        });
+    }
+    const wovenIssues = weave.inquiries
+        .map((entry) => entry.issue)
+        .filter((issue) => issue !== undefined);
+    warnings.push(...(await episodeYamlWarnings(episode.dir, wovenIssues)));
+    return {
+        kind: "episode",
+        episode: weave.episode,
+        episodeDir: episode.dir,
+        inquiries,
+        warnings,
+    };
+}
+export async function artefactStatus(env, artefact) {
+    const weave = await readArtefactWeave(artefact.dir);
+    const warnings = [];
+    if (!weave) {
+        warnings.push("no .weave.yaml — this artefact is not related to any episode yet");
+        return {
+            kind: "artefact",
+            artefact: artefact.name,
+            artefactDir: artefact.dir,
+            episodes: [],
+            warnings,
+        };
+    }
+    const episodes = [];
+    for (const link of weave.episodes) {
+        const episodeDir = episodeDirFromPath(env.chronicleRoot, link.path);
+        const episodeExists = existsSync(episodeDir);
+        if (!episodeExists) {
+            episodes.push({
+                path: link.path,
+                episodeDir,
+                episodeExists,
+                freshness: "never-synced",
+                diagnostics: ["episode directory not found under the chronicle root"],
+            });
+            continue;
+        }
+        const episodeWeave = await readEpisodeWeave(episodeDir);
+        const entry = episodeWeave?.inquiries.find((inquiry) => inquiry.artefact === artefact.name);
+        if (!entry) {
+            episodes.push({
+                path: link.path,
+                episodeDir,
+                episodeExists,
+                freshness: "never-synced",
+                diagnostics: ["episode weave.yaml has no entry for this artefact (one-sided relation)"],
+            });
+            continue;
+        }
+        const freshness = await classifyFreshness(artefact.dir, episodeDir, entry);
+        episodes.push({
+            path: link.path,
+            episodeDir,
+            episodeExists,
+            freshness: freshness.state,
+            diagnostics: freshness.diagnostics,
+        });
+    }
+    return {
+        kind: "artefact",
+        artefact: weave.artefact,
+        artefactDir: artefact.dir,
+        issue: weave.issue,
+        issue_url: weave.issue_url,
+        episodes,
+        warnings,
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

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

package/dist/sync.d.ts

@@ -0,0 +1,28 @@
+/**
+ * One-way artefact → episode mirror sync.
+ *
+ * The inquiry root (IAIP tree) is the system-of-record: the episode copy is a
+ * snapshot, deletions propagate, and local edits to the copy are flagged as
+ * divergence (a warning that sync will overwrite them).
+ */
+import { type TreeManifest } from "./tree.js";
+import { type InquiryEntry } from "./weave.js";
+export type Freshness = "in-sync" | "stale" | "never-synced" | "episode-copy-diverged";
+export interface SyncResult {
+    status: "synced" | "up-to-date" | "dry-run";
+    artefact: string;
+    episodeDir: string;
+    copyDir: string;
+    manifest: TreeManifest;
+}
+export interface FreshnessReport {
+    state: Freshness;
+    diagnostics: string[];
+}
+export interface SyncOptions {
+    dryRun?: boolean;
+    now?: () => Date;
+}
+export declare function syncArtefact(artefactDir: string, episodeDir: string, options?: SyncOptions): Promise<SyncResult>;
+export declare function classifyFreshness(artefactDir: string, episodeDir: string, entry: InquiryEntry): Promise<FreshnessReport>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EAIL,KAAK,YAAY,EAElB,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,GAAG,uBAAuB,CAAA;AAEtF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAA;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,YAAY,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAA;IAChB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAYD,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CA+BrB;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,eAAe,CAAC,CA6B1B"}