harnery 0.33.0 → 0.34.0

package/dist/lib/claude-desktop.js

@@ -1,8 +1,6 @@
-import { randomUUID } from "node:crypto";
-import { copyFileSync, createReadStream, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, join } from "node:path";
-import { createInterface } from "node:readline";
 const SESSIONS_DIRNAME = "claude-code-sessions";
 function isWsl() {
     if (process.env.WSL_DISTRO_NAME)
@@ -220,169 +218,3 @@ export function applyMirror(plan) {
     }
     return { copied };
 }
-/**
- * Read the latest durable lifecycle declaration for every Harnery session.
- *
- * The canonical ledger rotates into `events-*.ndjson` archives. Stream each
- * file rather than loading the whole history into one string, then compare
- * event timestamps because adapter replay may append an older event later.
- * Records are indexed by both session_id and instance_id so a desktop
- * cliSessionId can match either identity shape used by older adapters.
- */
-export async function readDesktopLifecycleIndex(coordRoot) {
-    const coordDir = join(coordRoot, ".harnery");
-    const archives = safeReaddir(coordDir)
-        .filter((name) => name.startsWith("events-") && name.endsWith(".ndjson"))
-        .sort();
-    const files = [...archives, "events.ndjson"]
-        .map((name) => join(coordDir, name))
-        .filter((path) => existsSync(path));
-    const records = new Map();
-    const timestamps = new Map();
-    for (const file of files) {
-        let lines = null;
-        try {
-            lines = createInterface({
-                input: createReadStream(file, { encoding: "utf8" }),
-                crlfDelay: Infinity,
-            });
-            for await (const line of lines) {
-                if (!line.trim())
-                    continue;
-                let raw;
-                try {
-                    raw = JSON.parse(line);
-                }
-                catch {
-                    continue;
-                }
-                if (!raw || typeof raw !== "object")
-                    continue;
-                const event = raw;
-                if (event.event_type !== "state.task_state" || typeof event.ts !== "string")
-                    continue;
-                const data = event.data;
-                if (!data || typeof data !== "object")
-                    continue;
-                const state = data.state;
-                if (state !== "active" && state !== "blocked" && state !== "done")
-                    continue;
-                const instanceId = typeof event.instance_id === "string" ? event.instance_id : null;
-                const sessionId = typeof event.session_id === "string" ? event.session_id : null;
-                const reasonValue = data.reason;
-                const record = {
-                    state,
-                    updatedAt: event.ts,
-                    instanceId,
-                    sessionId,
-                    reason: typeof reasonValue === "string" && reasonValue.length > 0 ? reasonValue : null,
-                };
-                const timestamp = Number.isFinite(Date.parse(event.ts)) ? Date.parse(event.ts) : 0;
-                for (const key of new Set([sessionId, instanceId].filter((value) => !!value))) {
-                    const priorTimestamp = timestamps.get(key);
-                    if (priorTimestamp !== undefined && priorTimestamp > timestamp)
-                        continue;
-                    timestamps.set(key, timestamp);
-                    records.set(key, record);
-                }
-            }
-        }
-        catch {
-            // A missing or concurrently rotated event file cannot make tidy unsafe:
-            // absent lifecycle evidence leaves entries unmatched and therefore skipped.
-        }
-        finally {
-            lines?.close();
-        }
-    }
-    return records;
-}
-/** Select desktop entries whose durable lifecycle is done. */
-export function planTidy(accounts, lifecycleBySession, opts = {}) {
-    const selectedAccounts = accounts.filter((account) => !opts.accounts?.length ||
-        opts.accounts.some((prefix) => account.accountUuid.startsWith(prefix)));
-    const actions = [];
-    const skipped = [];
-    for (const account of selectedAccounts) {
-        for (const entry of account.entries) {
-            const lifecycle = lifecycleForEntry(entry, lifecycleBySession);
-            if (entry.isArchived) {
-                skipped.push({ entry, reason: "already_archived", lifecycle });
-                continue;
-            }
-            if (hasLifecyclePrefix(entry.title, "BLOCKED")) {
-                skipped.push({ entry, reason: "blocked_title", lifecycle });
-                continue;
-            }
-            if (lifecycle) {
-                if (lifecycle.state === "done") {
-                    actions.push({ entry, source: "lifecycle", lifecycle });
-                }
-                else {
-                    skipped.push({ entry, reason: `lifecycle_${lifecycle.state}`, lifecycle });
-                }
-                continue;
-            }
-            if (opts.includeLegacyPrefix && hasLifecyclePrefix(entry.title, "DONE")) {
-                actions.push({ entry, source: "legacy-prefix", lifecycle: null });
-            }
-            else {
-                skipped.push({ entry, reason: "unmatched", lifecycle: null });
-            }
-        }
-    }
-    return { actions, skipped };
-}
-/** Apply a tidy plan with same-directory temp files and atomic renames. */
-export function applyTidy(plan) {
-    let archived = 0;
-    let alreadyArchived = 0;
-    for (const action of plan.actions) {
-        if (archiveEntry(action.entry.file))
-            archived++;
-        else
-            alreadyArchived++;
-    }
-    return { archived, alreadyArchived };
-}
-function lifecycleForEntry(entry, lifecycleBySession) {
-    if (entry.cliSessionId) {
-        const lifecycle = lifecycleBySession.get(entry.cliSessionId);
-        if (lifecycle)
-            return lifecycle;
-    }
-    return entry.sessionId ? (lifecycleBySession.get(entry.sessionId) ?? null) : null;
-}
-function hasLifecyclePrefix(title, state) {
-    if (!title)
-        return false;
-    return new RegExp(`^\\s*\\[${state}\\](?:\\s*-|\\s|$)`, "i").test(title);
-}
-function archiveEntry(file) {
-    const text = readFileSync(file, "utf8");
-    const raw = JSON.parse(text);
-    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-        throw new Error(`desktop entry is not a JSON object: ${file}`);
-    }
-    const entry = raw;
-    if (entry.isArchived === true)
-        return false;
-    entry.isArchived = true;
-    const pretty = text.includes("\n");
-    const trailingNewline = text.endsWith("\n") ? "\n" : "";
-    const next = `${JSON.stringify(entry, null, pretty ? 2 : undefined)}${trailingNewline}`;
-    const temp = join(dirname(file), `.${basename(file)}.${process.pid}.${randomUUID()}.tmp`);
-    try {
-        writeFileSync(temp, next, { encoding: "utf8", mode: statSync(file).mode });
-        renameSync(temp, file);
-    }
-    finally {
-        try {
-            unlinkSync(temp);
-        }
-        catch {
-            // rename already consumed the temp file, or creation failed before it existed
-        }
-    }
-    return true;
-}

package/dist/lib/context/index.d.ts

@@ -58,8 +58,6 @@ export interface SelfSection {
     instance_id: string;
     session_age_secs: number;
     task: string | null;
-    last_tool: string | null;
-    last_tool_target: string | null;
     files_held: string[];
 }
 export interface TimeSection {
@@ -91,7 +89,6 @@ export interface PeersSection {
         instance_id_short: string;
         age_min: number;
         files: number;
-        last_tool: string | null;
         task: string | null;
     }[];
 }

package/dist/lib/context/index.d.ts.map

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

package/dist/lib/context/index.js

@@ -1,6 +1,7 @@
-import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { monorepoRoot, readHeartbeat, resolveOwner, } from "../../core/agents/index.js";
+import { monorepoRoot, resolveOwner } from "../../core/agents/index.js";
+import { readLiveCoordinationRow, readLiveCoordinationRows, } from "../../core/agents/state/live-coordination-view.js";
 import { exec } from "../exec.js";
 import { NO_DATA } from "../format.js";
 export const DEFAULT_SECTIONS = [
@@ -48,17 +49,14 @@ function buildSelf() {
     const owner = resolveOwner();
     if (!owner)
         throw new Error("not in an agent session (no pid-map entry)");
-    const hb = readHeartbeat(owner);
-    // Full id, never abbreviated: this message exists to hand the reader an id to
-    // pass back (to `agents heal --owner`, say), and an 8-char prefix is not that
-    // id. Healing the truncated form writes `.harnery/active/<prefix>.json`, a
-    // heartbeat no reader ever resolves — so the session still looks unhealable
-    // and now has a junk file shadowing it. Same rule as `noHeartbeatMessage` in
-    // the agents command.
+    const root = monorepoRoot();
+    const hb = root ? readLiveCoordinationRow(root, owner) : null;
+    // Full id, never abbreviated: command surfaces pass this identity back to
+    // the authority-safe V3 coordination projection.
     if (!hb) {
-        throw new Error(`pid-map resolved owner=${owner} but no heartbeat exists at .harnery/active/${owner}.json`);
+        throw new Error(`pid-map resolved owner=${owner} but no live V3 generation exists for it`);
     }
-    const startedMs = Date.parse(hb.started_at);
+    const startedMs = Date.parse(hb.started_at ?? "");
     const ageSecs = Number.isFinite(startedMs)
         ? Math.max(0, Math.floor((Date.now() - startedMs) / 1000))
         : 0;
@@ -67,8 +65,6 @@ function buildSelf() {
         instance_id: hb.instance_id,
         session_age_secs: ageSecs,
         task: hb.task ?? null,
-        last_tool: hb.last_tool ?? null,
-        last_tool_target: hb.last_tool_target ?? null,
         files_held: hb.files_touched ?? [],
     };
 }
@@ -183,38 +179,20 @@ function buildPeers() {
     const root = monorepoRoot();
     if (!root)
         throw new Error("coord_root() returned null");
-    const activeDir = resolve(root, ".harnery", "active");
-    if (!existsSync(activeDir))
-        return { rows: [] };
     const myOwner = resolveOwner();
-    // No freshness filter; matches the SessionStart/UserPromptSubmit snapshot.
-    // Stale entries get swept by the SessionStart janitor on the next session start.
     const rows = [];
-    for (const f of readdirSync(activeDir)) {
-        if (!f.endsWith(".json"))
+    for (const row of readLiveCoordinationRows(root)) {
+        if (row.instance_id === myOwner || row.kind === "transient")
             continue;
-        try {
-            const hb = JSON.parse(readFileSync(resolve(activeDir, f), "utf8"));
-            if (!hb || typeof hb.instance_id !== "string")
-                continue;
-            if (hb.instance_id === myOwner)
-                continue;
-            if ((hb.kind ?? "") === "transient")
-                continue;
-            const startedMs = Date.parse(hb.started_at);
-            const ageMin = Number.isFinite(startedMs) ? Math.floor((Date.now() - startedMs) / 60000) : 0;
-            rows.push({
-                name: hb.name ?? "unknown",
-                instance_id_short: hb.instance_id.slice(0, 8),
-                age_min: ageMin,
-                files: hb.files_touched?.length ?? 0,
-                last_tool: hb.last_tool ?? null,
-                task: hb.task ?? null,
-            });
-        }
-        catch {
-            // skip
-        }
+        const startedMs = Date.parse(row.started_at ?? row.last_heartbeat);
+        const ageMin = Number.isFinite(startedMs) ? Math.floor((Date.now() - startedMs) / 60000) : 0;
+        rows.push({
+            name: row.name ?? "unknown",
+            instance_id_short: row.instance_id.slice(0, 8),
+            age_min: ageMin,
+            files: row.files_touched.length,
+            task: row.task ?? null,
+        });
     }
     // Sort: file-holders first (more activity), then by recency (younger age first).
     rows.sort((a, b) => b.files - a.files || a.age_min - b.age_min);

package/dist/lib/council/index.d.ts

@@ -98,14 +98,14 @@ export declare function setCouncilSteward(councilId: string, steward: string | n
 export interface KnownAgent {
     /** `agent-<Name>` canonical handle. */
     name: string;
-    /** `active` = currently has a heartbeat in `.harnery/active/`. `stale` =
+    /** `active` = currently has an authority-eligible V3 generation. `stale` =
      * recently ended (journal archived within the lookback window). */
     state: "active" | "stale";
     /** ISO timestamp of the most-recent signal. */
     last_seen: string;
 }
 /**
- * Active heartbeats + recently-archived journals, deduped by name.
+ * Active V3 generations + recently-archived journals, deduped by name.
  * Used by `agents council set-steward` to refuse arbitrary names;
  * pass `--allow-unknown` to bypass when bootstrapping a new agent.
  */

package/dist/lib/council/index.d.ts.map

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

package/dist/lib/council/index.js

@@ -9,6 +9,7 @@ import { createHash, randomBytes } from "node:crypto";
 import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
 import { basename, resolve } from "node:path";
 import { monorepoRoot } from "../../core/agents/index.js";
+import { readLiveCoordinationRows } from "../../core/agents/state/live-coordination-view.js";
 import { resolveBinName } from "../../core/config.js";
 import { ensureIdentity, lookupById as lookupIdentityById } from "../identities/index.js";
 export const COUNCIL_SCHEMA_VERSION = 2;
@@ -176,7 +177,7 @@ export function setCouncilSteward(councilId, steward) {
  * next-app's same-named constant. */
 const KNOWN_AGENT_STALE_WINDOW_MS = 30 * 24 * 60 * 60 * 1000;
 /**
- * Active heartbeats + recently-archived journals, deduped by name.
+ * Active V3 generations + recently-archived journals, deduped by name.
  * Used by `agents council set-steward` to refuse arbitrary names;
  * pass `--allow-unknown` to bypass when bootstrapping a new agent.
  */
@@ -184,27 +185,15 @@ export function listKnownAgents() {
     const root = monorepoRoot();
     if (!root)
         return [];
-    const activeDir = resolve(root, ".harnery", "active");
     const archiveDir = resolve(root, ".harnery", "journal", "archived");
     const byName = new Map();
-    if (existsSync(activeDir)) {
-        for (const f of readdirSync(activeDir)) {
-            if (!f.endsWith(".json"))
-                continue;
-            try {
-                const hb = JSON.parse(readFileSync(resolve(activeDir, f), "utf8"));
-                if (!hb.name)
-                    continue;
-                const name = hb.name.startsWith("agent-") ? hb.name : `agent-${hb.name}`;
-                const last_seen = hb.last_heartbeat ?? new Date().toISOString();
-                const existing = byName.get(name);
-                if (existing?.state !== "active") {
-                    byName.set(name, { name, state: "active", last_seen });
-                }
-            }
-            catch {
-                /* skip unreadable */
-            }
+    for (const row of readLiveCoordinationRows(root)) {
+        if (!row.name)
+            continue;
+        const name = row.name.startsWith("agent-") ? row.name : `agent-${row.name}`;
+        const existing = byName.get(name);
+        if (existing?.state !== "active") {
+            byName.set(name, { name, state: "active", last_seen: row.last_heartbeat });
         }
     }
     const cutoff = Date.now() - KNOWN_AGENT_STALE_WINDOW_MS;

package/dist/lib/docs-frontmatter.d.ts

@@ -19,12 +19,7 @@ export type DocKind = "plan" | "issue" | "handoff";
  * stripped from `body`, so status readers do not need try/catch.
  */
 export declare function parseFrontmatter(text: string): ParsedFrontmatter;
-/**
- * Normalize a raw status token to the canonical enum for its kind.
- * Returns null when the token can't be mapped (caller may fail loud).
- */
-export declare function normalizeStatus(raw: string, kind?: DocKind): string | null;
-/** Read and normalize a doc's YAML lifecycle status, or null when absent/invalid. */
+/** Read a canonical v2 lifecycle status, or null when absent or invalid. */
 export declare function readDocStatus(filePath: string, kind?: DocKind): string | null;
 /** Same as {@link readDocStatus} but from an in-memory string (testable). */
 export declare function readDocStatusFromText(content: string, kind?: DocKind): string | null;

package/dist/lib/docs-frontmatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-frontmatter.d.ts","sourceRoot":"","sources":["../../src/lib/docs-frontmatter.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,+CAA+C;AAC/C,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAKnD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAgBhE;AA+DD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAW1E;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ7E;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOpF;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGtD"}
+{"version":3,"file":"docs-frontmatter.d.ts","sourceRoot":"","sources":["../../src/lib/docs-frontmatter.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,+CAA+C;AAC/C,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAKnD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAgBhE;AAOD,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ7E;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASpF;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGtD"}

package/dist/lib/docs-frontmatter.js

@@ -26,84 +26,12 @@ export function parseFrontmatter(text) {
     }
     return { data, body: text.slice(m[0].length), raw: m[1] };
 }
-/**
- * Kind-independent token normalization (spacing / casing / punctuation
- * variants). Kind-specific collapses (done -> shipped vs resolved) are applied
- * in `normalizeStatus`.
- */
-const GENERIC_NORMALIZE = {
-    in_progress: "in-progress",
-    inprogress: "in-progress",
-    "in progress": "in-progress",
-    "in-progress": "in-progress",
-    wip: "in-progress",
-    "wont-fix": "wontfix",
-    wontfix: "wontfix",
-    proposed: "proposed",
-    abandoned: "abandoned",
-    open: "open",
-    resolved: "resolved",
-    shipped: "shipped",
-};
-// "done"-family tokens collapse to different canonical values per kind.
-const DONE_FAMILY = new Set(["done", "complete", "completed", "finished"]);
-const KIND_NORMALIZE = {
-    plan: {
-        planning: "proposed",
-        draft: "proposed",
-        approved: "proposed",
-        plan: "proposed",
-        open: "proposed",
-        deferred: "proposed",
-        implemented: "shipped",
-        resolved: "shipped",
-        fixed: "shipped",
-        archived: "shipped",
-        shelved: "abandoned",
-    },
-    issue: {
-        "in progress": "open",
-        in_progress: "open",
-        "in-progress": "open",
-        blocked: "open",
-        mitigated: "open",
-        fixed: "resolved",
-        shipped: "resolved",
-    },
-    handoff: {
-        "in progress": "open",
-        in_progress: "open",
-        "in-progress": "open",
-        blocked: "open",
-        fixed: "resolved",
-        shipped: "resolved",
-    },
-};
 const ALLOWED_BY_KIND = {
     plan: new Set(["proposed", "in-progress", "shipped", "abandoned"]),
     issue: new Set(["open", "resolved", "wontfix"]),
     handoff: new Set(["open", "resolved", "abandoned"]),
 };
-const ALL_CANONICAL = new Set(Object.values(ALLOWED_BY_KIND).flatMap((values) => [...values]));
-/**
- * Normalize a raw status token to the canonical enum for its kind.
- * Returns null when the token can't be mapped (caller may fail loud).
- */
-export function normalizeStatus(raw, kind) {
-    const t = raw.trim().toLowerCase();
-    if (!t)
-        return null;
-    if (DONE_FAMILY.has(t)) {
-        // plans ship; issues/handoffs resolve. Default to "shipped" when unknown.
-        return kind === "issue" || kind === "handoff" ? "resolved" : "shipped";
-    }
-    const normalized = (kind ? KIND_NORMALIZE[kind][t] : undefined) ?? GENERIC_NORMALIZE[t];
-    if (!normalized)
-        return null;
-    const allowed = kind ? ALLOWED_BY_KIND[kind] : ALL_CANONICAL;
-    return allowed.has(normalized) ? normalized : null;
-}
-/** Read and normalize a doc's YAML lifecycle status, or null when absent/invalid. */
+/** Read a canonical v2 lifecycle status, or null when absent or invalid. */
 export function readDocStatus(filePath, kind) {
     let content;
     try {
@@ -117,11 +45,17 @@ export function readDocStatus(filePath, kind) {
 /** Same as {@link readDocStatus} but from an in-memory string (testable). */
 export function readDocStatusFromText(content, kind) {
     const { data } = parseFrontmatter(content);
-    const yamlStatus = data.status;
-    if (typeof yamlStatus === "string" && yamlStatus.trim()) {
-        return normalizeStatus(yamlStatus, kind);
-    }
-    return null;
+    if (data.schema !== "harnery-doc/v2")
+        return null;
+    if (kind && data.type !== kind)
+        return null;
+    if (typeof data.status !== "string")
+        return null;
+    if (kind)
+        return ALLOWED_BY_KIND[kind].has(data.status) ? data.status : null;
+    return Object.values(ALLOWED_BY_KIND).some((allowed) => allowed.has(data.status))
+        ? data.status
+        : null;
 }
 /** Whether a doc carries a non-empty status in leading YAML frontmatter. */
 export function hasYamlStatus(content) {

package/dist/lib/docs-index.d.ts

@@ -7,6 +7,10 @@ export declare function initDocsContext(opts: {
  * Idempotent: safe to run on every commit. Reads the first ~30 lines of
  * each dated file to extract title and (for issues) status.
  *
+ * Targets: the host root, every initialized git submodule, and first-level
+ * in-tree packages that keep `docs/audits` or `docs/issues` without being
+ * git submodules. Marker rules are unchanged.
+ *
  * Preserves hand-written preambles. The command updates only the section
  * between `<!-- BEGIN INDEX -->` and `<!-- END INDEX -->` markers. If a
  * README exists without markers, the command refuses to overwrite it and
@@ -25,5 +29,10 @@ export interface IndexResult {
     after: string;
 }
 export declare function extractStatus(content: string): string | undefined;
+/** Root + initialized submodules + first-level in-tree packages with docs indexes. */
+export declare function collectIndexTargets(): {
+    name: string;
+    path: string;
+}[];
 export declare function runIndex(opts: IndexOpts): Promise<IndexResult[]>;
 //# sourceMappingURL=docs-index.d.ts.map

package/dist/lib/docs-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-index.d.ts","sourceRoot":"","sources":["../../src/lib/docs-index.ts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAG/F;AAeD;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC;AAEhF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAkBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE;AAgGD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA+CtE"}
+{"version":3,"file":"docs-index.d.ts","sourceRoot":"","sources":["../../src/lib/docs-index.ts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAG/F;AAeD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC;AAEhF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAkBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE;AAsGD,sFAAsF;AACtF,wBAAgB,mBAAmB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAqBtE;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA2CtE"}

package/dist/lib/docs-index.js

@@ -122,13 +122,42 @@ function hasMarkers(existing) {
 function buildNewReadme(kind, body) {
     return `${defaultPreamble(kind)}\n${BEGIN_MARKER}\n${body}${END_MARKER}\n`;
 }
-export async function runIndex(opts) {
-    const targets = [{ name: "(root)", path: REPO_ROOT }];
+const SKIP_NESTED_DIR_NAMES = new Set(["node_modules", "dist", "target"]);
+function hasIndexableDocs(path) {
+    return existsSync(join(path, "docs", "audits")) || existsSync(join(path, "docs", "issues"));
+}
+/** Root + initialized submodules + first-level in-tree packages with docs indexes. */
+export function collectIndexTargets() {
+    const byPath = new Map();
+    const add = (name, path) => {
+        byPath.set(path, { name, path });
+    };
+    add("(root)", REPO_ROOT);
     for (const name of SUBMODULES) {
         if (!isSubmoduleInitialized(name))
             continue;
-        targets.push({ name, path: submodulePath(name) });
+        add(name, submodulePath(name));
+    }
+    if (!existsSync(REPO_ROOT))
+        return [...byPath.values()];
+    for (const ent of readdirSync(REPO_ROOT, { withFileTypes: true })) {
+        if (!ent.isDirectory() && !ent.isSymbolicLink())
+            continue;
+        if (ent.name.startsWith("."))
+            continue;
+        if (SKIP_NESTED_DIR_NAMES.has(ent.name))
+            continue;
+        if (isSubmoduleInitialized(ent.name))
+            continue;
+        const child = join(REPO_ROOT, ent.name);
+        if (!hasIndexableDocs(child))
+            continue;
+        add(ent.name, child);
     }
+    return [...byPath.values()];
+}
+export async function runIndex(opts) {
+    const targets = collectIndexTargets();
     const filter = opts.repo === "." ? "(root)" : opts.repo;
     const filtered = filter ? targets.filter((t) => t.name === filter) : targets;
     const results = [];

package/dist/lib/docs-lint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-lint.d.ts","sourceRoot":"","sources":["../../src/lib/docs-lint.ts"],"names":[],"mappings":"AAcA,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,GAAG,IAAI,CAKP;AAaD;;;;;;GAMG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0HD,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrD;AAsQD,wBAAsB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAqBlE"}
+{"version":3,"file":"docs-lint.d.ts","sourceRoot":"","sources":["../../src/lib/docs-lint.ts"],"names":[],"mappings":"AAeA,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,GAAG,IAAI,CAMP;AAaD;;;;;;GAMG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0HD,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrD;AA0OD,wBAAsB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAiClE"}