@aitne/daemon 0.1.8 → 0.1.10

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

@@ -58,4 +58,3 @@ export interface RewriteEntitySourceRenameDeps {
  * surface.
  */
 export declare function rewriteEntityFilesForSourceRename(deps: RewriteEntitySourceRenameDeps): Promise<RewriteResult>;
-//# sourceMappingURL=entity-source-rename.d.ts.map

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

@@ -242,4 +242,3 @@ export async function rewriteEntityFilesForSourceRename(deps) {
     }
     return result;
 }
-//# sourceMappingURL=entity-source-rename.js.map

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

@@ -17,9 +17,13 @@ export interface ReconcileResult {
 /**
  * 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.
+ * cycles on the next run.
+ *
+ * Keys are the path prefixes used after the CONTEXT_VAULT_REDESIGN
+ * six-class restructure (`journal/daily/`, `journal/weekly/`,
+ * `journal/monthly/`).
  */
-export declare const ROLLING_RETENTION: Record<"daily" | "weekly" | "monthly", number>;
+export declare const ROLLING_RETENTION: Record<"journal/daily" | "journal/weekly" | "journal/monthly", number>;
 /**
  * Returns true when the walker should include the given path in the
  * indexer snapshot. §4.2 — walker discovers every `.md` under contextDir,
@@ -54,8 +58,25 @@ export declare function defaultRowFor(entry: FilesystemSnapshotEntry): ContextIn
  */
 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.
+ * Render the reconciler-section block body (table + notes) without
+ * frontmatter or top-level heading. The host file (`_index.md`) owns
+ * those — V15 splices this body into the `<!-- reconciler-section -->`
+ * region while preserving user-curated content elsewhere.
+ *
+ * `updated` is recorded inline so the body itself is self-dating (the host
+ * frontmatter may have its own `updated:` field maintained by the user).
+ */
+export declare function renderReconcilerBlockBody(rows: ContextIndexRow[], updated: string): string;
+/**
+ * Default `_index.md` scaffold used when the file is absent. The reconciler
+ * splices the rendered body into the `<!-- reconciler-section -->` block; on
+ * subsequent runs the user's edits to the prose around it are preserved.
+ */
+export declare function defaultRootIndexScaffold(updated: string): string;
+/**
+ * @deprecated Retained for the migration's pre-V15 peer tests. Runtime
+ * callers must use `renderReconcilerBlockBody` + `mergeReconcilerBlock`
+ * so the user-curated portion of `_index.md` is preserved. Will be removed
+ * once all peer tests adopt the new shape.
  */
 export declare function renderContextIndex(rows: ContextIndexRow[], updated: string): string;
-//# sourceMappingURL=index-reconciler.d.ts.map

package/dist/core/context/index-reconciler.js

@@ -27,12 +27,16 @@ const REVIEW_FLOW_VOCAB = new Set([
 /**
  * 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.
+ * cycles on the next run.
+ *
+ * Keys are the path prefixes used after the CONTEXT_VAULT_REDESIGN
+ * six-class restructure (`journal/daily/`, `journal/weekly/`,
+ * `journal/monthly/`).
  */
 export const ROLLING_RETENTION = {
-    daily: 7,
-    weekly: 4,
-    monthly: 6,
+    "journal/daily": 7,
+    "journal/weekly": 4,
+    "journal/monthly": 6,
 };
 /**
  * Returns true when the walker should include the given path in the
@@ -42,17 +46,17 @@ export const ROLLING_RETENTION = {
 export function shouldIndexPath(relativePath) {
     if (!relativePath.endsWith(".md"))
         return false;
-    if (relativePath === CONTEXT_RELATIVE_PATHS.contextIndex)
+    if (relativePath === CONTEXT_RELATIVE_PATHS.rootIndex)
         return false;
     const segments = relativePath.split("/");
     const basename = segments[segments.length - 1];
     if (basename === "_index.md")
         return false;
-    if (relativePath.startsWith("agent/scratch/"))
+    if (relativePath.startsWith("state/scratch/"))
         return false;
-    if (relativePath.startsWith("inbox/"))
+    if (relativePath.startsWith("state/inbox/"))
         return false;
-    if (relativePath.startsWith("routines/custom/"))
+    if (relativePath.startsWith("policies/routines/custom/"))
         return false;
     if (relativePath === CONTEXT_RELATIVE_PATHS.today)
         return true;
@@ -62,21 +66,19 @@ export function shouldIndexPath(relativePath) {
         return true;
     if (relativePath === CONTEXT_RELATIVE_PATHS.agent.journal)
         return true;
-    if (relativePath.startsWith("user/"))
-        return true;
-    if (relativePath.startsWith("rules/"))
+    if (relativePath.startsWith("identity/"))
         return true;
-    if (relativePath.startsWith("routines/"))
+    if (relativePath.startsWith("policies/"))
         return true;
-    if (relativePath.startsWith("projects/"))
+    if (relativePath.startsWith("plans/projects/"))
         return true;
-    if (relativePath.startsWith("dossiers/"))
+    if (relativePath.startsWith("knowledge/dossiers/"))
         return true;
-    if (relativePath.startsWith("daily/"))
+    if (relativePath.startsWith("journal/daily/"))
         return true;
-    if (relativePath.startsWith("weekly/"))
+    if (relativePath.startsWith("journal/weekly/"))
         return true;
-    if (relativePath.startsWith("monthly/"))
+    if (relativePath.startsWith("journal/monthly/"))
         return true;
     return false;
 }
@@ -91,12 +93,12 @@ export function applyRollingRetention(snapshot) {
     const buckets = new Map();
     const passthrough = [];
     for (const entry of snapshot) {
-        const prefix = entry.path.startsWith("daily/")
-            ? "daily"
-            : entry.path.startsWith("weekly/")
-                ? "weekly"
-                : entry.path.startsWith("monthly/")
-                    ? "monthly"
+        const prefix = entry.path.startsWith("journal/daily/")
+            ? "journal/daily"
+            : entry.path.startsWith("journal/weekly/")
+                ? "journal/weekly"
+                : entry.path.startsWith("journal/monthly/")
+                    ? "journal/monthly"
                     : null;
         if (prefix === null) {
             passthrough.push(entry);
@@ -180,23 +182,20 @@ export function reconcileContextIndex(snapshot, currentRows) {
     return { rows: resultRows, added, removed, refreshedMtime, noOp };
 }
 /**
- * Render a full `context-index.md` file from a row list. `updated` goes
- * into the frontmatter; rows are emitted in the order supplied.
+ * Render the reconciler-section block body (table + notes) without
+ * frontmatter or top-level heading. The host file (`_index.md`) owns
+ * those — V15 splices this body into the `<!-- reconciler-section -->`
+ * region while preserving user-curated content elsewhere.
+ *
+ * `updated` is recorded inline so the body itself is self-dating (the host
+ * frontmatter may have its own `updated:` field maintained by the user).
  */
-export function renderContextIndex(rows, updated) {
+export function renderReconcilerBlockBody(rows, updated) {
     const lines = [];
-    lines.push("---");
-    lines.push("type: index");
-    lines.push("owner: agent");
-    lines.push(`updated: ${updated}`);
-    lines.push("---");
-    lines.push("# Context Index");
-    lines.push("");
-    lines.push("Prompt-injection hub for dossier-backed flows (B-004). This file stays in");
-    lines.push("English so review / routine prompts read a stable, backend-neutral summary.");
-    lines.push("");
     lines.push("## Files");
     lines.push("");
+    lines.push(`_Reconciled by daemon on ${updated}._`);
+    lines.push("");
     lines.push("| Path | Purpose | Review flows | Last touched |");
     lines.push("|---|---|---|---|");
     for (const row of rows) {
@@ -208,6 +207,57 @@ export function renderContextIndex(rows, updated) {
     lines.push("- Maintained by the daemon reconciler (`packages/daemon/src/core/context/index-reconciler.ts`).");
     lines.push("- `Review flows` tokens: `all`, `hourly`, `morning`, `evening`, `weekly`,");
     lines.push("  `monthly`, `roadmap`, or `-` when no flow should auto-load the file.");
+    return lines.join("\n");
+}
+/**
+ * Default `_index.md` scaffold used when the file is absent. The reconciler
+ * splices the rendered body into the `<!-- reconciler-section -->` block; on
+ * subsequent runs the user's edits to the prose around it are preserved.
+ */
+export function defaultRootIndexScaffold(updated) {
+    return [
+        "---",
+        "type: index",
+        "owner: shared",
+        `updated: ${updated}`,
+        "---",
+        "# Aitne Vault",
+        "",
+        "Six top-level folders sit under this root, each with a single",
+        "authority/lifecycle contract:",
+        "",
+        "- `identity/` — who the user is (user-authored, slow-change)",
+        "- `state/` — operational state, today, scratch (agent-authored)",
+        "- `plans/` — roadmap and active projects (mixed authorship)",
+        "- `journal/` — append-only narrative + reviews + per-repo journals",
+        "- `knowledge/` — wiki, dossiers, repos, management-registry entities",
+        "- `policies/` — rules, routines, integrations, user skills",
+        "",
+        "The block below is maintained by the daemon reconciler — edits inside",
+        "the `reconciler-section` markers are overwritten. Anything outside the",
+        "block is yours.",
+        "",
+        "<!-- reconciler-section -->",
+        "<!-- /reconciler-section -->",
+        "",
+    ].join("\n");
+}
+/**
+ * @deprecated Retained for the migration's pre-V15 peer tests. Runtime
+ * callers must use `renderReconcilerBlockBody` + `mergeReconcilerBlock`
+ * so the user-curated portion of `_index.md` is preserved. Will be removed
+ * once all peer tests adopt the new shape.
+ */
+export function renderContextIndex(rows, updated) {
+    const lines = [];
+    lines.push("---");
+    lines.push("type: index");
+    lines.push("owner: agent");
+    lines.push(`updated: ${updated}`);
+    lines.push("---");
+    lines.push("# Context Index");
+    lines.push("");
+    lines.push(renderReconcilerBlockBody(rows, updated));
     lines.push("");
     return lines.join("\n");
 }
@@ -248,56 +298,61 @@ function defaultCells(entry) {
             reviewFlows: "all",
         });
     }
-    if (path.startsWith("user/")) {
-        const area = path.slice("user/".length).replace(/\.md$/, "");
+    if (path.startsWith("identity/")) {
+        const area = path.slice("identity/".length).replace(/\.md$/, "");
         return emit({
-            purpose: title ?? `User ${area}`,
+            purpose: title ?? `Identity ${area}`,
             reviewFlows: "morning, monthly",
         });
     }
-    if (path.startsWith("rules/")) {
-        const name = path.slice("rules/".length).replace(/\.md$/, "");
-        return emit({
-            purpose: title ?? `Rule: ${name}`,
-            reviewFlows: "all",
-        });
-    }
-    if (path.startsWith("routines/")) {
-        const cadence = path.slice("routines/".length).replace(/\.md$/, "");
+    // policies/routines/ — before the generic policies/ branch.
+    if (path.startsWith("policies/routines/")) {
+        const cadence = path
+            .slice("policies/routines/".length)
+            .replace(/\.md$/, "");
         const flow = REVIEW_FLOW_VOCAB.has(cadence) ? cadence : "-";
         return emit({
             purpose: title ?? `${capitalize(cadence)} routine rulebook`,
             reviewFlows: flow,
         });
     }
-    if (path.startsWith("projects/")) {
-        const slug = path.slice("projects/".length).replace(/\.md$/, "");
+    if (path.startsWith("policies/")) {
+        const name = path.slice("policies/".length).replace(/\.md$/, "");
+        return emit({
+            purpose: title ?? `Rule: ${name}`,
+            reviewFlows: "all",
+        });
+    }
+    if (path.startsWith("plans/projects/")) {
+        const slug = path.slice("plans/projects/".length).replace(/\.md$/, "");
         return emit({
             purpose: title ?? `Project ${slug}`,
             reviewFlows: "weekly, monthly, roadmap",
         });
     }
-    if (path.startsWith("dossiers/")) {
-        const flow = path.slice("dossiers/".length).replace(/\.md$/, "");
+    if (path.startsWith("knowledge/dossiers/")) {
+        const flow = path
+            .slice("knowledge/dossiers/".length)
+            .replace(/\.md$/, "");
         const normalizedFlow = REVIEW_FLOW_VOCAB.has(flow) ? flow : "-";
         return emit({
             purpose: title ?? `${capitalize(flow)} dossier`,
             reviewFlows: normalizedFlow,
         });
     }
-    if (path.startsWith("daily/")) {
+    if (path.startsWith("journal/daily/")) {
         return emit({
             purpose: title ?? "Synthesized daily journal",
             reviewFlows: "-",
         });
     }
-    if (path.startsWith("weekly/")) {
+    if (path.startsWith("journal/weekly/")) {
         return emit({
             purpose: title ?? "Weekly review artifact",
             reviewFlows: "-",
         });
     }
-    if (path.startsWith("monthly/")) {
+    if (path.startsWith("journal/monthly/")) {
         return emit({
             purpose: title ?? "Monthly review artifact",
             reviewFlows: "-",
@@ -326,4 +381,3 @@ function escapeCell(value) {
 function capitalize(value) {
     return value.slice(0, 1).toUpperCase() + value.slice(1);
 }
-//# sourceMappingURL=index-reconciler.js.map

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

@@ -5,10 +5,10 @@
  * (`policy-index-runner.ts`) drives it.
  *
  * Scope:
- *   - Render `rules/policies/_index.md` body (table of active / paused +
+ *   - Render `policies/management-captures/_index.md` body (table of active / paused +
  *     a Removed table) from a snapshot of policy frontmatters.
  *   - Render the `## Active Policies` section content for
- *     `rules/management.md` (a shorter table — slug, status, cadence, why).
+ *     `policies/management.md` (a shorter table — slug, status, cadence, why).
  *   - Provide a section-aware upsert that splices the section into existing
  *     management.md content, mirroring `upsertManagementRulesAgentIdentity`.
  *
@@ -21,11 +21,11 @@
  */
 export type PolicyStatus = "active" | "paused" | "removed";
 export interface PolicySnapshotEntry {
-    /** Filename stem under `rules/policies/`. */
+    /** Filename stem under `policies/management-captures/`. */
     slug: string;
     status: PolicyStatus;
     /**
-     * Cron expression read from the linked `routines/custom/<slug>.md`'s
+     * Cron expression read from the linked `policies/routines/custom/<slug>.md`'s
      * frontmatter. Null when no routine is linked or the routine file is
      * missing. Frozen at snapshot time — manual cron edits to the routine
      * propagate on the next reconcile pass.
@@ -59,12 +59,12 @@ export declare const ACTIVE_POLICIES_SECTION_HEADER = "## Active Policies";
  */
 export declare function bucketPolicies(snapshots: PolicySnapshotEntry[]): PolicyIndexBuckets;
 /**
- * Render the body of `rules/policies/_index.md` (frontmatter + sections).
+ * Render the body of `policies/management-captures/_index.md` (frontmatter + sections).
  * `updated` populates the frontmatter `updated:` field.
  */
 export declare function renderPolicyIndex(buckets: PolicyIndexBuckets, updated: string): string;
 /**
- * Render the `## Active Policies` section of `rules/management.md`. The
+ * Render the `## Active Policies` section of `policies/management.md`. The
  * returned string starts with `## Active Policies\n` and does NOT include
  * a trailing newline (the upsert helper appends one).
  *
@@ -99,4 +99,3 @@ export declare function upsertManagementRulesActivePolicies(content: string, sec
  * section can re-acquire the on-disk version verbatim.
  */
 export declare function extractActivePoliciesSection(content: string): string | null;
-//# sourceMappingURL=policy-index-reconciler.d.ts.map

package/dist/core/context/policy-index-reconciler.js

@@ -5,10 +5,10 @@
  * (`policy-index-runner.ts`) drives it.
  *
  * Scope:
- *   - Render `rules/policies/_index.md` body (table of active / paused +
+ *   - Render `policies/management-captures/_index.md` body (table of active / paused +
  *     a Removed table) from a snapshot of policy frontmatters.
  *   - Render the `## Active Policies` section content for
- *     `rules/management.md` (a shorter table — slug, status, cadence, why).
+ *     `policies/management.md` (a shorter table — slug, status, cadence, why).
  *   - Provide a section-aware upsert that splices the section into existing
  *     management.md content, mirroring `upsertManagementRulesAgentIdentity`.
  *
@@ -51,7 +51,7 @@ export function bucketPolicies(snapshots) {
     return { active, paused, removed };
 }
 /**
- * Render the body of `rules/policies/_index.md` (frontmatter + sections).
+ * Render the body of `policies/management-captures/_index.md` (frontmatter + sections).
  * `updated` populates the frontmatter `updated:` field.
  */
 export function renderPolicyIndex(buckets, updated) {
@@ -65,7 +65,7 @@ export function renderPolicyIndex(buckets, updated) {
     lines.push("");
     lines.push("Auto-maintained by the daemon's policy-index reconciler. Direct edits");
     lines.push("are overwritten on the next reconcile pass — to add or modify a policy,");
-    lines.push("edit its `rules/policies/<slug>.md` file (or use the `management-policy`");
+    lines.push("edit its `policies/management-captures/<slug>.md` file (or use the `management-policy`");
     lines.push("skill).");
     lines.push("");
     lines.push("## Active");
@@ -87,7 +87,7 @@ export function renderPolicyIndex(buckets, updated) {
     return lines.join("\n");
 }
 /**
- * Render the `## Active Policies` section of `rules/management.md`. The
+ * Render the `## Active Policies` section of `policies/management.md`. The
  * returned string starts with `## Active Policies\n` and does NOT include
  * a trailing newline (the upsert helper appends one).
  *
@@ -100,7 +100,7 @@ export function renderActivePoliciesSection(buckets) {
     lines.push(ACTIVE_POLICIES_SECTION_HEADER);
     lines.push("");
     lines.push("Auto-maintained by the daemon (do not edit). Source files live under");
-    lines.push("`rules/policies/<slug>.md`; capture new policies via the");
+    lines.push("`policies/management-captures/<slug>.md`; capture new policies via the");
     lines.push("`management-policy` skill. Full index: [[rules/policies/_index.md]]");
     lines.push("");
     const visible = [...buckets.active, ...buckets.paused];
@@ -199,4 +199,3 @@ function formatLink(slug) {
 function escapeCell(value) {
     return value.replace(/\|/g, "\\|").replace(/\s+/g, " ").trim() || EM_DASH;
 }
-//# sourceMappingURL=policy-index-reconciler.js.map

package/dist/core/context/policy-index-runner.d.ts

@@ -9,7 +9,7 @@ export declare const POLICY_INDEX_RECONCILER_LAST_RUN_KEY = "reconciler.policy_i
  * MANAGEMENT-POLICY-CAPTURE-PLAN §9 P4 — drive one pass of the
  * policy-index reconciler:
  *
- *   1. Walk `rules/policies/<slug>.md` (excluding `_index.md`), parse each
+ *   1. Walk `policies/management-captures/<slug>.md` (excluding `_index.md`), parse each
  *      file's frontmatter + body, attach the linked routine's cron.
  *   2. Render the desired `_index.md` body and `## Active Policies`
  *      section content for `management.md`.
@@ -33,7 +33,7 @@ export interface RunPolicyIndexReconcilerOptions {
 }
 export declare function runPolicyIndexReconciler(opts: RunPolicyIndexReconcilerOptions): Promise<ReconcilerRunRecord>;
 /**
- * Walk `rules/policies/`, parse each policy file, attach linked-routine
+ * Walk `policies/management-captures/`, parse each policy file, attach linked-routine
  * cadence. Files that fail validation (missing kind, malformed slug, etc.)
  * are skipped with a warn — the API chokepoint is the authoritative
  * validator and would have rejected them at write time, so a malformed
@@ -63,4 +63,3 @@ interface ParsedPolicyFile {
  */
 export declare function parsePolicyFile(content: string): ParsedPolicyFile | null;
 export {};
-//# sourceMappingURL=policy-index-runner.d.ts.map

package/dist/core/context/policy-index-runner.js

@@ -136,7 +136,7 @@ async function runOnce(opts) {
     }
 }
 /**
- * Walk `rules/policies/`, parse each policy file, attach linked-routine
+ * Walk `policies/management-captures/`, parse each policy file, attach linked-routine
  * cadence. Files that fail validation (missing kind, malformed slug, etc.)
  * are skipped with a warn — the API chokepoint is the authoritative
  * validator and would have rejected them at write time, so a malformed
@@ -411,4 +411,3 @@ function persistRunRecord(db, record) {
         logger.warn({ err, record }, "Policy-index reconciler run record persistence failed");
     }
 }
-//# sourceMappingURL=policy-index-runner.js.map

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

@@ -41,4 +41,3 @@ export interface RunReconcilerOptions {
  *     Phase 2b gate (§2.2) can query the last run deterministically.
  */
 export declare function runReconciler(opts: RunReconcilerOptions): Promise<ReconcilerRunRecord>;
-//# sourceMappingURL=reconciler-runner.d.ts.map

package/dist/core/context/reconciler-runner.js

@@ -7,7 +7,8 @@ import { validateContextFileFrontmatter } from "../context-frontmatter.js";
 import { POLICY_FILE_MAX_BYTES } from "../policy-files.js";
 import { writeRuntimeState, getDegradedMode, } from "../../db/runtime-state.js";
 import { createLogger } from "../../logging.js";
-import { applyRollingRetention, reconcileContextIndex, renderContextIndex, shouldIndexPath, } from "./index-reconciler.js";
+import { applyRollingRetention, defaultRootIndexScaffold, reconcileContextIndex, renderReconcilerBlockBody, shouldIndexPath, } from "./index-reconciler.js";
+import { mergeReconcilerBlock } from "./reconciler-section.js";
 const logger = createLogger("context-index-reconciler");
 /** Runtime-state key for the minimum-viable run record — §5.6. */
 export const RECONCILER_LAST_RUN_KEY = "reconciler.context_index.last_run";
@@ -83,8 +84,23 @@ async function runOnce(opts) {
             persistRunRecord(opts.db, record);
             return record;
         }
-        const output = renderContextIndex(diff.rows, today);
-        const validationError = validateContextFileFrontmatter(output, CONTEXT_RELATIVE_PATHS.contextIndex);
+        // V15: render only the inner block body, then splice it into the host
+        // `_index.md` so user-curated content around the block is preserved.
+        const blockBody = renderReconcilerBlockBody(diff.rows, today);
+        const existing = readExistingIndexFile(opts.contextDir);
+        let baseTarget = existing ?? defaultRootIndexScaffold(today);
+        let output = mergeReconcilerBlock(baseTarget, blockBody);
+        let validationError = validateContextFileFrontmatter(output, CONTEXT_RELATIVE_PATHS.contextIndex);
+        if (validationError && existing) {
+            // Recovery path (§4.5): the host `_index.md` is corrupt — frontmatter
+            // missing, type/owner invalid, etc. Rebuild from the scaffold rather
+            // than refusing to reconcile. The user's broken content is replaced;
+            // the previous bytes survive in `md_file_snapshots` for restore.
+            logger.warn({ validation: validationError }, "Reconciler rebuilding _index.md from scaffold — host content failed validation");
+            baseTarget = defaultRootIndexScaffold(today);
+            output = mergeReconcilerBlock(baseTarget, blockBody);
+            validationError = validateContextFileFrontmatter(output, CONTEXT_RELATIVE_PATHS.contextIndex);
+        }
         if (validationError) {
             const record = {
                 ...recordBase,
@@ -238,10 +254,27 @@ function readCurrentRows(contextDir) {
         return parseContextIndexRows(content);
     }
     catch (err) {
-        logger.warn({ err }, "Reconciler could not read existing context-index.md — treating as empty");
+        logger.warn({ err }, "Reconciler could not read existing _index.md — treating as empty");
         return [];
     }
 }
+/**
+ * Return the host `_index.md` content verbatim so the reconciler can splice
+ * its block in without clobbering the user-curated prose. Returns `null`
+ * when the file does not exist (first-run case — the caller falls back to
+ * `defaultRootIndexScaffold`).
+ */
+function readExistingIndexFile(contextDir) {
+    const absolute = join(contextDir, CONTEXT_RELATIVE_PATHS.contextIndex);
+    if (!existsSync(absolute))
+        return null;
+    try {
+        return readFileSync(absolute, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
 function writeIndex(opts, content) {
     const absolute = join(opts.contextDir, CONTEXT_RELATIVE_PATHS.contextIndex);
     const directory = dirname(absolute);
@@ -278,4 +311,3 @@ function persistRunRecord(db, record) {
         logger.warn({ err, record }, "Reconciler run record persistence failed");
     }
 }
-//# sourceMappingURL=reconciler-runner.js.map

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

@@ -0,0 +1,30 @@
+/**
+ * Reconciler-section block helpers.
+ *
+ * CONTEXT_VAULT_REDESIGN_PLAN.md v4 V15 — the root `<contextDir>/_index.md`
+ * carries both user-curated content and a machine-rebuilt block. The block
+ * is delimited by HTML comments so the user's editor renders it as
+ * Markdown (Obsidian, GitHub) without exposing the markers.
+ *
+ * Both the boot migration (`db/migrations/context-vault-restructure.ts`) and
+ * the runtime reconciler (`core/context/reconciler-runner.ts`) splice the
+ * block via the helpers exported here so the two write paths cannot drift.
+ */
+export declare const RECONCILER_BLOCK_OPEN = "<!-- reconciler-section -->";
+export declare const RECONCILER_BLOCK_CLOSE = "<!-- /reconciler-section -->";
+/**
+ * Matches the entire reconciler-section block — open marker through close
+ * marker, inclusive. `[\s\S]` is required (not `.`) because the block body
+ * spans multiple lines.
+ */
+export declare const RECONCILER_BLOCK_RE: RegExp;
+/**
+ * Splice `blockBody` between `<!-- reconciler-section -->` markers inside
+ * `target`. If the target already contains a block, the body between the
+ * markers is replaced. Otherwise a new block is appended at the end of the
+ * target with a single blank-line separator.
+ *
+ * `blockBody` should be the body content only (no frontmatter, no top-level
+ * heading) — the host file owns those.
+ */
+export declare function mergeReconcilerBlock(target: string, blockBody: string): string;

package/dist/core/context/reconciler-section.js

@@ -0,0 +1,39 @@
+/**
+ * Reconciler-section block helpers.
+ *
+ * CONTEXT_VAULT_REDESIGN_PLAN.md v4 V15 — the root `<contextDir>/_index.md`
+ * carries both user-curated content and a machine-rebuilt block. The block
+ * is delimited by HTML comments so the user's editor renders it as
+ * Markdown (Obsidian, GitHub) without exposing the markers.
+ *
+ * Both the boot migration (`db/migrations/context-vault-restructure.ts`) and
+ * the runtime reconciler (`core/context/reconciler-runner.ts`) splice the
+ * block via the helpers exported here so the two write paths cannot drift.
+ */
+export const RECONCILER_BLOCK_OPEN = "<!-- reconciler-section -->";
+export const RECONCILER_BLOCK_CLOSE = "<!-- /reconciler-section -->";
+/**
+ * Matches the entire reconciler-section block — open marker through close
+ * marker, inclusive. `[\s\S]` is required (not `.`) because the block body
+ * spans multiple lines.
+ */
+export const RECONCILER_BLOCK_RE = /<!--\s*reconciler-section\s*-->[\s\S]*?<!--\s*\/reconciler-section\s*-->/;
+/**
+ * Splice `blockBody` between `<!-- reconciler-section -->` markers inside
+ * `target`. If the target already contains a block, the body between the
+ * markers is replaced. Otherwise a new block is appended at the end of the
+ * target with a single blank-line separator.
+ *
+ * `blockBody` should be the body content only (no frontmatter, no top-level
+ * heading) — the host file owns those.
+ */
+export function mergeReconcilerBlock(target, blockBody) {
+    const block = `${RECONCILER_BLOCK_OPEN}\n${blockBody.trim()}\n${RECONCILER_BLOCK_CLOSE}`;
+    if (RECONCILER_BLOCK_RE.test(target)) {
+        return target.replace(RECONCILER_BLOCK_RE, block);
+    }
+    if (target.length === 0)
+        return `${block}\n`;
+    const sep = target.endsWith("\n") ? "" : "\n";
+    return `${target}${sep}\n${block}\n`;
+}

package/dist/core/context-builder-calendar.d.ts

@@ -0,0 +1,36 @@
+import type Database from "better-sqlite3";
+import type { AgentConfig } from "../config.js";
+import type { ServiceRegistry } from "../services/service-registry.js";
+interface CalendarDeps {
+    db: Database.Database;
+    config: AgentConfig;
+    services: ServiceRegistry;
+}
+/**
+ * Build a `<calendar_events_*>` context block honouring every active
+ * provider's mode.
+ *
+ * docs/design/appendices/routine-data-acquisition.md §6.6 — the block wraps one
+ * `<provider key="…" mode="…">…</provider>` sub-block per active
+ * provider so the parent routine sees a uniform shape regardless of
+ * which provider(s) the operator has configured.
+ *
+ * `prepassCovers` — A8 / Finding 5. When `true`, the caller's
+ * `ROUTINE_WINDOWS` entry includes a calendar row, so the
+ * `routine.fetch_window` pre-pass has already POSTed events to
+ * `/api/observations` for every non-direct provider. Non-direct
+ * provider sub-blocks then emit a "read observations" hint instead
+ * of the legacy "fetch yourself" directive. Direct providers are
+ * unchanged — ContextBuilder still pre-fetches inline events via
+ * `services.calendar` (Google) and emits the fallback hint for
+ * Outlook (no daemon-side service yet). The flag has no effect on
+ * direct-mode sub-blocks. Default `false` for callers that don't
+ * have pre-pass coverage (today_refresh, weekly/monthly_review,
+ * roadmap_refresh).
+ */
+export declare function renderCalendarBlock(deps: CalendarDeps, args: {
+    days: number;
+    blockName: string;
+    prepassCovers?: boolean;
+}): Promise<string>;
+export {};