@aitne/daemon 0.1.0

package/dist/core/context/entity-source-rename.d.ts

@@ -0,0 +1,61 @@
+import type Database from "better-sqlite3";
+import type { AgentWriteTracker } from "../../safety/agent-write-tracker.js";
+export type RenameOutcome = {
+    kind: "rewrote";
+    body: string;
+} | {
+    kind: "old_key_missing";
+} | {
+    kind: "new_key_exists";
+} | {
+    kind: "multiple_variants";
+    variants: string[];
+} | {
+    kind: "no_frontmatter";
+};
+/**
+ * Rewrite a single entity-file body so its `frontmatter.sources.<X>`
+ * line — where `LOWER(X) === LOWER(oldKey)` — is renamed to `<newKey>`.
+ * Returns the new body verbatim; the caller writes it.
+ */
+export declare function renameFrontmatterSourceKey(body: string, oldKey: string, newKey: string): RenameOutcome;
+export interface RewriteResult {
+    /** Files whose frontmatter was rewritten and re-saved. */
+    rewrote: string[];
+    /** Files where `<newKey>` already existed — manual resolution needed. */
+    skippedNewKeyExists: string[];
+    /** Files where multiple casing variants of `oldKey` co-exist. */
+    skippedMultipleVariants: {
+        path: string;
+        variants: string[];
+    }[];
+    /** Files where `<oldKey>` was absent (e.g. mirror lag); informational. */
+    skippedOldKeyMissing: string[];
+    /** Read / parse / write errors keyed by the offending path. */
+    errors: {
+        path: string;
+        reason: string;
+    }[];
+}
+export interface RewriteEntitySourceRenameDeps {
+    db: Database.Database;
+    contextDir: string;
+    oldKey: string;
+    newKey: string;
+    writeTracker?: AgentWriteTracker;
+}
+/**
+ * Walk every entity file referencing `oldKey` — via the
+ * `entity_source_keys` mirror's normalized index — and rewrite its
+ * frontmatter to use `newKey` instead. Casing variants (`zoom`, `Zoom`,
+ * `ZOOM`) all surface; the rewriter rewrites the canonical first
+ * single-variant case and SKIPS files whose multi-variant frontmatter
+ * would collide.
+ *
+ * Failures are isolated per-file: a single read/write error doesn't
+ * abort the whole rename. The result enumerates each outcome so the
+ * caller can append it to the audit row and the dashboard's history
+ * surface.
+ */
+export declare function rewriteEntityFilesForSourceRename(deps: RewriteEntitySourceRenameDeps): Promise<RewriteResult>;
+//# sourceMappingURL=entity-source-rename.d.ts.map

package/dist/core/context/entity-source-rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-source-rename.d.ts","sourceRoot":"","sources":["../../../src/core/context/entity-source-rename.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AA2C7E,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE/B;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,aAAa,CA2Ef;AAqBD,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yEAAyE;IACzE,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,iEAAiE;IACjE,uBAAuB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAChE,0EAA0E;IAC1E,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,aAAa,CAAC,CAwFxB"}

package/dist/core/context/entity-source-rename.js

@@ -0,0 +1,237 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { writeFileAtomically } from "../atomic-write.js";
+import { createLogger } from "../../logging.js";
+const logger = createLogger("entity-source-rename");
+/**
+ * Entity-file rewriter for `management_task.app_renamed` consumers
+ * (docs/design/21-management-registry-and-entities.md §12, "Failure
+ * modes & recovery"; followups doc Issue 2 prerequisite).
+ *
+ * The DB-side rename mutates `managed_tasks.app` atomically. Without
+ * this rewriter, every entity file's `frontmatter.sources.<oldKey>`
+ * stays pointing at the now-deleted label — silently orphaning the
+ * §7.6 lookup contract for the renamed app.
+ *
+ * Match semantics — case-insensitive, single-variant per file:
+ *
+ *   - SQL: enumerate entity paths via `entity_source_keys.source_key_
+ *     normalized = LOWER(:oldKey)`. This catches every casing variant
+ *     (`zoom`, `Zoom`, `ZOOM`) the entity-mirror has ever indexed.
+ *   - Per file: scan the frontmatter `sources:` block for any key whose
+ *     lower-cased form matches `LOWER(oldKey)`. The chosen rewrite
+ *     target is the FIRST such match (for byte-determinism and to keep
+ *     the rewriter idempotent across reruns).
+ *   - When a single file holds **multiple** casing variants of `oldKey`
+ *     (e.g. both `sources.zoom` and `sources.ZOOM`), the rewriter
+ *     SKIPS the file with `skippedMultipleVariants`. Renaming all of
+ *     them to `newKey` would produce a duplicate-key YAML, and merging
+ *     their inner records is hard to do safely without surprising the
+ *     user. Manual reconciliation is the right escape hatch.
+ *   - When `<newKey>` (exact case) already exists in the file alongside
+ *     the matched old key, the rewriter SKIPS with `skippedNewKeyExists`
+ *     for the same merge-safety reason.
+ *
+ * The frontmatter pass is line-based (mirroring entity-mirror.ts's
+ * parser) — no full YAML round-trip. The trade-off: comments,
+ * anchors, and unusual quoting in the rest of the frontmatter are
+ * untouched (they don't intersect with the `sources:` block).
+ */
+const FRONTMATTER_FENCE = /^---\s*$/;
+/**
+ * Rewrite a single entity-file body so its `frontmatter.sources.<X>`
+ * line — where `LOWER(X) === LOWER(oldKey)` — is renamed to `<newKey>`.
+ * Returns the new body verbatim; the caller writes it.
+ */
+export function renameFrontmatterSourceKey(body, oldKey, newKey) {
+    if (oldKey === newKey)
+        return { kind: "old_key_missing" };
+    const oldNormalized = oldKey.toLowerCase();
+    const normalized = body.replace(/\r\n/g, "\n");
+    const lines = normalized.split("\n");
+    // `String.split('\n')` always returns at least one element, so
+    // `lines.length === 0` is unreachable and `lines[0] ?? ""` never
+    // triggers its fallback. The defensive guards keep the type-narrowing
+    // honest for downstream readers but cannot be hit at runtime.
+    /* c8 ignore next */
+    if (lines.length === 0 || !FRONTMATTER_FENCE.test(lines[0] ?? "")) {
+        return { kind: "no_frontmatter" };
+    }
+    const closeIdx = lines.findIndex((line, idx) => idx > 0 && FRONTMATTER_FENCE.test(line));
+    if (closeIdx < 0)
+        return { kind: "no_frontmatter" };
+    let inSourcesBlock = false;
+    const matchedKeyLines = [];
+    let newKeyExistsExact = false;
+    // Walk frontmatter lines, tracking the `sources:` block boundary.
+    // Top-level keys always start in column 0; child keys under `sources:`
+    // sit at 2-space indent. Anything deeper than 2 spaces is a field
+    // under a source — we skip those.
+    for (let i = 1; i < closeIdx; i++) {
+        const line = lines[i];
+        if (line === "" || /^\s*#/.test(line))
+            continue;
+        if (!/^\s/.test(line)) {
+            const topMatch = /^([A-Za-z0-9_-]+)\s*:/.exec(line);
+            inSourcesBlock = topMatch?.[1] === "sources";
+            continue;
+        }
+        if (!inSourcesBlock)
+            continue;
+        // `line` reached this point via `/^\s/.test(line)` above, so the
+        // leading-whitespace regex always matches; the `?? 0` fallback is
+        // defensive only.
+        /* c8 ignore next */
+        const indent = line.match(/^\s+/)?.[0].length ?? 0;
+        if (indent !== 2)
+            continue;
+        const keyName = parseChildKey(line);
+        if (keyName === null)
+            continue;
+        if (keyName === newKey)
+            newKeyExistsExact = true;
+        if (keyName.toLowerCase() === oldNormalized) {
+            matchedKeyLines.push({ lineIdx: i, key: keyName });
+        }
+    }
+    if (matchedKeyLines.length === 0)
+        return { kind: "old_key_missing" };
+    // Multiple casing variants in the same file (`zoom` and `ZOOM`) —
+    // renaming both would collide. Surface for manual reconciliation.
+    if (matchedKeyLines.length > 1) {
+        return {
+            kind: "multiple_variants",
+            variants: matchedKeyLines.map((m) => m.key),
+        };
+    }
+    // The exact target case already exists — refuse to merge two records
+    // even when one of them is the matched old key. The user can resolve
+    // by deleting the duplicate manually before retrying the rename.
+    if (newKeyExistsExact)
+        return { kind: "new_key_exists" };
+    // Rewrite the matched line. Preserve everything after the key colon
+    // (the inline value form `zoom: zm_xyz` keeps its value; the empty
+    // `zoom:` form remains an empty record marker for the children below).
+    const target = lines[matchedKeyLines[0].lineIdx];
+    const m = /^( {2})("?'?)([^:]+?)\2(\s*:.*)$/.exec(target);
+    /* c8 ignore start — `m` is guaranteed truthy here: the same pattern
+       matched in the walk above; defensive guard only. */
+    if (!m)
+        return { kind: "old_key_missing" };
+    /* c8 ignore stop */
+    lines[matchedKeyLines[0].lineIdx] =
+        `${m[1]}${quoteIfNeeded(newKey)}${m[4]}`;
+    return { kind: "rewrote", body: lines.join("\n") };
+}
+function parseChildKey(line) {
+    const match = /^ {2}("?'?)([^:]+?)\1\s*:/.exec(line);
+    if (!match)
+        return null;
+    return match[2].trim();
+}
+/**
+ * Quote a YAML key when it contains characters that would break the
+ * `key:` form (whitespace, colons, hashes, leading dashes). The entity-
+ * mirror's `stripQuotes` helper handles double + single quotes
+ * symmetrically; we always emit double quotes here for determinism.
+ */
+function quoteIfNeeded(key) {
+    if (/^[A-Za-z0-9_-]+$/.test(key))
+        return key;
+    return `"${key.replace(/"/g, '\\"')}"`;
+}
+/**
+ * Walk every entity file referencing `oldKey` — via the
+ * `entity_source_keys` mirror's normalized index — and rewrite its
+ * frontmatter to use `newKey` instead. Casing variants (`zoom`, `Zoom`,
+ * `ZOOM`) all surface; the rewriter rewrites the canonical first
+ * single-variant case and SKIPS files whose multi-variant frontmatter
+ * would collide.
+ *
+ * Failures are isolated per-file: a single read/write error doesn't
+ * abort the whole rename. The result enumerates each outcome so the
+ * caller can append it to the audit row and the dashboard's history
+ * surface.
+ */
+export async function rewriteEntityFilesForSourceRename(deps) {
+    const result = {
+        rewrote: [],
+        skippedNewKeyExists: [],
+        skippedMultipleVariants: [],
+        skippedOldKeyMissing: [],
+        errors: [],
+    };
+    if (deps.oldKey === deps.newKey)
+        return result;
+    // Use the normalized generated column so case variants of the old
+    // label all surface. The activity-view runner already keys on this
+    // index; staying consistent with it avoids one-off SQL drift.
+    const rows = deps.db
+        .prepare("SELECT DISTINCT path FROM entity_source_keys WHERE source_key_normalized = ? ORDER BY path ASC")
+        .all(deps.oldKey.toLowerCase());
+    for (const row of rows) {
+        const absolute = join(deps.contextDir, row.path);
+        let body;
+        try {
+            body = await readFile(absolute, "utf-8");
+        }
+        catch (err) {
+            // The `?? "read_error"` fallback fires only when the rejection
+            // has no `.code` field. Node's fs/promises.readFile always
+            // rejects with a NodeJS.ErrnoException whose `.code` is set, so
+            // the fallback is genuinely unreachable in production. Vitest's
+            // ESM-namespace immutability also blocks `vi.spyOn` on
+            // fs/promises, so we accept the unreachable arm.
+            /* c8 ignore next */
+            const reason = err.code ?? "read_error";
+            result.errors.push({ path: row.path, reason });
+            continue;
+        }
+        const outcome = renameFrontmatterSourceKey(body, deps.oldKey, deps.newKey);
+        switch (outcome.kind) {
+            case "rewrote":
+                try {
+                    writeFileAtomically(absolute, outcome.body);
+                    deps.writeTracker?.markWriting(absolute, outcome.body);
+                    result.rewrote.push(row.path);
+                }
+                catch (err) {
+                    const reason = err instanceof Error ? err.message : String(err);
+                    result.errors.push({ path: row.path, reason });
+                }
+                break;
+            case "new_key_exists":
+                result.skippedNewKeyExists.push(row.path);
+                break;
+            case "multiple_variants":
+                result.skippedMultipleVariants.push({
+                    path: row.path,
+                    variants: outcome.variants,
+                });
+                break;
+            case "old_key_missing":
+            case "no_frontmatter":
+                // Mirror lag — the sidecar row points at a key that no longer
+                // resides in the file. Surface it but don't error: the entity-
+                // mirror's chokidar watcher converges on the next file write.
+                result.skippedOldKeyMissing.push(row.path);
+                break;
+        }
+    }
+    if (result.rewrote.length > 0 ||
+        result.skippedNewKeyExists.length > 0 ||
+        result.skippedMultipleVariants.length > 0 ||
+        result.errors.length > 0) {
+        logger.info({
+            oldKey: deps.oldKey,
+            newKey: deps.newKey,
+            rewrote: result.rewrote.length,
+            skippedNewKeyExists: result.skippedNewKeyExists.length,
+            skippedMultipleVariants: result.skippedMultipleVariants.length,
+            skippedOldKeyMissing: result.skippedOldKeyMissing.length,
+            errors: result.errors.length,
+        }, "entity-source-rename: completed");
+    }
+    return result;
+}
+//# sourceMappingURL=entity-source-rename.js.map

package/dist/core/context/entity-source-rename.js.map

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

package/dist/core/context/index-reconciler.d.ts

@@ -0,0 +1,61 @@
+import type { ContextIndexRow } from "../review-context.js";
+export interface FilesystemSnapshotEntry {
+    /** Relative path under contextDir, forward-slashed, ending in `.md`. */
+    path: string;
+    /** YYYY-MM-DD derived from filesystem mtime in the agent's local tz. */
+    mtimeDate: string;
+    /** First H1 title found in the first N lines, or null. */
+    h1Title: string | null;
+}
+export interface ReconcileResult {
+    rows: ContextIndexRow[];
+    added: string[];
+    removed: string[];
+    refreshedMtime: string[];
+    noOp: boolean;
+}
+/**
+ * Retention caps for rolling journals. Applied at snapshot-build time so
+ * capped files neither appear in `add_set` nor churn through remove/add
+ * cycles on the next run. Values from §4.7.
+ */
+export declare const ROLLING_RETENTION: Record<"daily" | "weekly" | "monthly", number>;
+/**
+ * Returns true when the walker should include the given path in the
+ * indexer snapshot. §4.2 — walker discovers every `.md` under contextDir,
+ * this predicate narrows discovery to the set that should receive rows.
+ */
+export declare function shouldIndexPath(relativePath: string): boolean;
+/**
+ * Apply rolling-directory retention caps to a snapshot. Keeps the N
+ * lexicographically-largest paths in each capped directory — filenames
+ * are date-encoded (`YYYY-MM-DD`, `YYYY-Www`, `YYYY-MM`), so string-sort
+ * descending selects the most recent entries. Passes all other paths
+ * through untouched.
+ */
+export declare function applyRollingRetention(snapshot: FilesystemSnapshotEntry[]): FilesystemSnapshotEntry[];
+/**
+ * Produce a default row for a path the reconciler is seeing for the first
+ * time. Callers supply the snapshot entry so the default can read the
+ * filesystem mtime + H1 title without re-walking. The returned
+ * `reviewFlows` is guaranteed to contain only values from the review-flow
+ * vocabulary.
+ */
+export declare function defaultRowFor(entry: FilesystemSnapshotEntry): ContextIndexRow;
+/**
+ * Core diff. Returns the new row list and diff stats.
+ *
+ * Row ordering:
+ *  - Existing rows preserve their original position.
+ *  - Added rows are appended, sorted deterministically by path.
+ *
+ * `noOp` is true when every set is empty — callers skip the write entirely
+ * in that case (§4.3 early-return).
+ */
+export declare function reconcileContextIndex(snapshot: FilesystemSnapshotEntry[], currentRows: ContextIndexRow[]): ReconcileResult;
+/**
+ * Render a full `context-index.md` file from a row list. `updated` goes
+ * into the frontmatter; rows are emitted in the order supplied.
+ */
+export declare function renderContextIndex(rows: ContextIndexRow[], updated: string): string;
+//# sourceMappingURL=index-reconciler.d.ts.map

package/dist/core/context/index-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-reconciler.d.ts","sourceRoot":"","sources":["../../../src/core/context/index-reconciler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA6B5D,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,OAAO,GAAG,QAAQ,GAAG,SAAS,EAAE,MAAM,CAI5E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CA0B7D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,uBAAuB,EAAE,GAClC,uBAAuB,EAAE,CA6B3B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,uBAAuB,GAAG,eAAe,CAQ7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,uBAAuB,EAAE,EACnC,WAAW,EAAE,eAAe,EAAE,GAC7B,eAAe,CA2CjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,eAAe,EAAE,EACvB,OAAO,EAAE,MAAM,GACd,MAAM,CAqCR"}