@aitne/daemon 0.1.3 → 0.1.6

package/dist/core/output-language-policy.js.map

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

package/dist/core/prompts.d.ts

@@ -7,7 +7,7 @@
  * Flows are injected as part of the user message by the dispatcher.
  * The {context} placeholder is replaced with the ContextBuilder output.
  */
-import { type IntegrationKey, type IntegrationState } from "@aitne/shared";
+import { type BackendId, type IntegrationKey, type IntegrationState } from "@aitne/shared";
 /**
  * Initialize the task-flow loader.
  *
@@ -37,6 +37,8 @@ export declare function resetTaskFlowsForTest(): void;
  * treats null as "no override layer present".
  */
 export declare function getUserTaskFlowsDir(): string | null;
+export declare function expandPartialIncludes(content: string): string;
+export declare function renderPartialForFanOut(filename: string, integrations: Partial<Record<IntegrationKey, IntegrationState>>, backendId: BackendId): string;
 /**
  * Get the task flow template for a given event type.
  *

package/dist/core/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/core/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAavB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAI1E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAgBD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEnD;AAuED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,GAC/D,MAAM,CAWR;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IACJ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kBAAkB,CAAC,EAAE;QACnB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC7D,GACL,MAAM,CAoBR;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,aAAa,IAAI,iBAAiB,EAAE,CAWnD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG;IAChD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAcA"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/core/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAcvB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAI1E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAgBD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEnD;AA+JD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU7D;AAkCD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,EAC/D,SAAS,EAAE,SAAS,GACnB,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,GAC/D,MAAM,CA2BR;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IACJ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kBAAkB,CAAC,EAAE;QACnB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC7D,GACL,MAAM,CAoBR;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,aAAa,IAAI,iBAAiB,EAAE,CAWnD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG;IAChD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAcA"}

package/dist/core/prompts.js

@@ -13,6 +13,7 @@ import { fileURLToPath } from "node:url";
 import { applyIntegrationModeFilter, isCustomRoutineKey, selectTaskFlowVariantSuffix, substituteBrandTokens, } from "@aitne/shared";
 import { appendPolicyBlocks, createPromptInjectionBudget, } from "./policy-files.js";
 import { appendReviewContextBlocks } from "./review-context.js";
+import { substituteIntegrationRoutingTables } from "./management-md.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 let taskFlowsDir = null;
 let userTaskFlowsDir = null;
@@ -124,11 +125,152 @@ function loadFlowVariant(eventType, backendId, integrations) {
     if (suffix !== "direct") {
         const variant = readFlowFile(`${eventType}.${suffix}.md`);
         if (variant !== null)
-            return variant;
+            return expandTaskFlowPartials(variant, eventType);
     }
     // Fall back to the canonical file (covers direct mode and missing variants)
     return loadFlow(eventType);
 }
+/**
+ * INTEGRATION_NATIVE_MODE_DESIGN.md §8.2 — a task-flow variant may
+ * include the canonical base flow via the `{{> base }}` directive,
+ * mirroring `renderPartialIncludes` for skills (skills-compiler.ts:1296).
+ * The directive is replaced with the body of `<eventType>.md` with the
+ * leading `{context}\n\n` block stripped — the variant carries its own
+ * `{context}` at the top, and duplicating the token would double the
+ * context-builder output once `resolveTemplate` fills both occurrences.
+ *
+ * Missing / empty base flow → directive collapses to the empty string
+ * (mirrors `renderPartialIncludes`'s missing-base behaviour). Pure
+ * function on the file content; no caching beyond the loader's existing
+ * `flowCache`.
+ */
+function expandTaskFlowPartials(content, eventType) {
+    if (!content.includes("{{> base }}"))
+        return content;
+    // Resolve against the BUNDLED base file only — the user-override
+    // resolution layer is one-way (variants may override; partial includes
+    // pin to canonical assets so a malformed override doesn't cascade into
+    // every variant that includes it). This matches the skill partial
+    // resolver's "read from src verbatim" stance (skills-compiler.ts:612).
+    const dir = resolveTaskFlowsDir();
+    const basePath = join(dir, `${eventType}.md`);
+    if (!existsSync(basePath))
+        return content.replaceAll("{{> base }}", "");
+    const baseRaw = substituteBrandTokens(readFileSync(basePath, "utf-8"));
+    // Strip the leading `{context}\n\n` (or `{context}\n` for unix-style
+    // files that omit the second newline) so the merged body has exactly
+    // one context block at the very top — the one the variant author put
+    // there. Anchored at start with `^` so a `{context}` token appearing
+    // mid-flow (none today, but defensive) is preserved.
+    const baseStripped = baseRaw.replace(/^\{context\}\n\n?/, "");
+    return content.replaceAll("{{> base }}", baseStripped);
+}
+/**
+ * ROUTINE_DATA_ACQUISITION_DESIGN.md Phase 1 / F0 — resolve
+ * `{include:_partials/<name>.md}` directives in a task-flow body by
+ * inlining the verbatim contents of `agent-assets/task-flows/_partials/
+ * <name>.md`. Runs BEFORE `applyIntegrationModeFilter` so any
+ * `<!-- mode:...:... -->` blocks the partial carries are filtered
+ * normally for the current integration state.
+ *
+ * Behaviour:
+ *  - Partials live at `agent-assets/task-flows/_partials/`. The
+ *    user-override layer (`<dataDir>/task-flows/_partials/`) wins per
+ *    file, matching `readFlowFile`'s contract.
+ *  - The leading YAML frontmatter block (`---\n…\n---\n`) is stripped
+ *    so authors may carry editorial metadata in partials without it
+ *    leaking into the prompt body.
+ *  - **Depth cap = 1.** Includes inside an included partial are NOT
+ *    expanded — the include directive there is left visible so a
+ *    runaway recursion shows up as a verbatim `{include:...}` token in
+ *    the rendered prompt rather than silently looping. Tests / authors
+ *    can grep for the directive to detect cycles.
+ *  - Missing partials collapse to the empty string, matching
+ *    `{{> base }}`'s missing-base behaviour. The lint pass (R2/F8)
+ *    catches references to non-existent partials at test time.
+ *  - Filename safety: `<name>` is constrained to
+ *    `[A-Za-z0-9][A-Za-z0-9._-]*` — no slashes, no `..` — so an attacker
+ *    or buggy authoring tool cannot path-traverse out of `_partials/`.
+ *    Directives with invalid names are left verbatim, which means the
+ *    raw token shows up in the prompt (visible failure) rather than
+ *    silently disappearing.
+ */
+const PARTIAL_INCLUDE_RE = /\{include:_partials\/([A-Za-z0-9][A-Za-z0-9._-]*\.md)\}/g;
+const FRONTMATTER_STRIP_RE = /^---\r?\n[\s\S]*?\r?\n---\r?\n?/;
+function readPartialFile(name) {
+    // User-override layer first (mirrors readFlowFile). The file lives at
+    // `<dataDir>/task-flows/_partials/<name>` — same nesting as the
+    // bundled layout so an author can override one partial without
+    // disturbing the rest.
+    if (userTaskFlowsDir) {
+        const userPath = join(userTaskFlowsDir, "_partials", name);
+        if (existsSync(userPath)) {
+            try {
+                return substituteBrandTokens(readFileSync(userPath, "utf-8"));
+            }
+            catch {
+                // Corrupt override falls through to the bundled file.
+            }
+        }
+    }
+    const bundledPath = join(resolveTaskFlowsDir(), "_partials", name);
+    if (!existsSync(bundledPath))
+        return null;
+    return substituteBrandTokens(readFileSync(bundledPath, "utf-8"));
+}
+export function expandPartialIncludes(content) {
+    if (!content.includes("{include:_partials/"))
+        return content;
+    return content.replace(PARTIAL_INCLUDE_RE, (_match, filename) => {
+        const raw = readPartialFile(filename);
+        if (raw === null)
+            return "";
+        // Strip leading frontmatter block, then trim a single trailing
+        // newline so the substitution doesn't accumulate blank-line drift
+        // across multiple sibling includes.
+        return raw.replace(FRONTMATTER_STRIP_RE, "").replace(/\n+$/, "\n");
+    });
+}
+/**
+ * PRE_PASS_FAN_OUT_DESIGN.md §4.2 Path (a) — load a single
+ * `_partials/<name>.md` body for runner-side substitution into the
+ * `{integration_partial}` placeholder of `routine.fetch_window.md`.
+ * Reuses the same lookup as `expandPartialIncludes` (user-override →
+ * bundled, brand-token substitution, frontmatter strip, single-newline
+ * tail) so authoring conventions stay consistent across the two
+ * consumers.
+ *
+ * The runner passes a per-integration slice of the integrations
+ * snapshot so the partial's `<!-- mode:...:... -->` blocks collapse to
+ * the single branch that applies to this sub-session's
+ * `(integration, mode)` cell. Filtering happens here, not after
+ * substitution, because the surrounding `routine.fetch_window.md` body
+ * has already been through `applyIntegrationModeFilter` via the
+ * standard `getTaskFlow` path — running the filter again on the merged
+ * string would be a no-op for the host body but could mis-fire if a
+ * partial used `<!-- mode:... -->` markers for an integration other
+ * than its own (the partials lint forbids that, but the defence keeps
+ * the runner robust to future authoring drift).
+ *
+ * Missing partials collapse to the empty string (mirroring
+ * `expandPartialIncludes`'s missing-partial behaviour); the
+ * `routine-partials.test.ts` lint catches references to non-existent
+ * partials at test time so this never fires in a healthy build.
+ *
+ * Filename safety: same `[A-Za-z0-9][A-Za-z0-9._-]*` constraint as the
+ * include directive — a malformed name returns the empty string
+ * instead of path-traversing out of `_partials/`.
+ */
+const PARTIAL_FILENAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*\.md$/;
+export function renderPartialForFanOut(filename, integrations, backendId) {
+    if (!PARTIAL_FILENAME_RE.test(filename))
+        return "";
+    const raw = readPartialFile(filename);
+    if (raw === null)
+        return "";
+    const stripped = raw.replace(FRONTMATTER_STRIP_RE, "").replace(/\n+$/, "\n");
+    return applyIntegrationModeFilter(stripped, integrations, backendId);
+}
 /**
  * Get the task flow template for a given event type.
  *
@@ -151,14 +293,30 @@ export function getTaskFlow(eventType, backendId, integrations) {
     const raw = resolveTaskFlowSource(eventType, backendId, integrations);
     if (!raw)
         return raw;
+    // ROUTINE_DATA_ACQUISITION_DESIGN.md F0 — expand
+    // `{include:_partials/<name>.md}` directives BEFORE mode filtering so
+    // the partial's `<!-- mode:... -->` blocks participate in the same
+    // filter pass as the host body. Depth cap = 1; nested includes inside
+    // a partial are left verbatim (visible failure on cycles).
+    let rendered = expandPartialIncludes(raw);
     // Mode-conditional sections are stripped only when we know the session
     // backend (from `backendId`). Tooling that doesn't carry one (legacy
     // tests, prompt previews) keeps the markers visible — better than
     // collapsing them with a placeholder backend that may misroute prose.
     if (backendId && integrations) {
-        return applyIntegrationModeFilter(raw, integrations, backendId);
+        rendered = applyIntegrationModeFilter(rendered, integrations, backendId);
+    }
+    // INTEGRATION_NATIVE_MODE_DESIGN.md §6.5.2 / §7.3 — substitute the
+    // `<integration-routing-table>` and `<integration-routing-table-actionable>`
+    // placeholders the native variants and (Phase C onwards) the direct/
+    // delegated variants embed. Runs AFTER mode-conditional filtering so
+    // a placeholder inside a struck branch is dropped before substitution.
+    // Pure no-op when neither placeholder is present, so legacy task-flow
+    // files that pre-date the placeholder syntax are unaffected.
+    if (integrations) {
+        rendered = substituteIntegrationRoutingTables(rendered, integrations);
     }
-    return raw;
+    return rendered;
 }
 function resolveTaskFlowSource(eventType, backendId, integrations) {
     if (backendId && integrations) {

package/dist/core/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/core/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,GAItB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,IAAI,YAAY,GAAkB,IAAI,CAAC;AACvC,IAAI,gBAAgB,GAAkB,IAAI,CAAC;AAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,YAAoB,EAAE,OAAgB;IAClE,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;IAChE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,YAAY,GAAG,IAAI,CAAC;IACpB,gBAAgB,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC;AAED,SAAS,mBAAmB;IAC1B,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IACtC,2FAA2F;IAC3F,mEAAmE;IACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;IACvF,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,YAAY,GAAG,QAAQ,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,QAAQ,GAAG,YAAY,QAAQ,EAAE,CAAC;IACxC,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,OAAO,qBAAqB,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACP,6DAA6D;gBAC7D,8DAA8D;gBAC9D,8DAA8D;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,OAAO,GAAG,qBAAqB,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1E,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,SAAiB;IACjC,OAAO,YAAY,CAAC,GAAG,SAAS,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,eAAe,CACtB,SAAiB,EACjB,SAAoB,EACpB,YAA+D;IAE/D,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IAE/E,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,SAAS,IAAI,MAAM,KAAK,CAAC,CAAC;QAC1D,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC;IACvC,CAAC;IAED,4EAA4E;IAC5E,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CACzB,SAAiB,EACjB,SAAkB,EAClB,YAAgE;IAEhE,MAAM,GAAG,GAAG,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACtE,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,uEAAuE;IACvE,qEAAqE;IACrE,kEAAkE;IAClE,sEAAsE;IACtE,IAAI,SAAS,IAAI,YAAY,EAAE,CAAC;QAC9B,OAAO,0BAA0B,CAAC,GAAG,EAAE,YAAY,EAAE,SAAsB,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAC5B,SAAiB,EACjB,SAA6B,EAC7B,YAEa;IAEb,IAAI,SAAS,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,EAAE,SAAsB,EAAE,YAAY,CAAC,CAAC;QACjF,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC;IACvC,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAC1C,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;IACrC,CAAC;IACD,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,OAUI,EAAE;IAEN,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACvE,IAAI,CAAC,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,MAAM,GAAG,2BAA2B,EAAE,CAAC;IAC7C,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,EAAE;QAC5C,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,SAAS;QACxC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM;KACP,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,IAAI;QAC7C,iBAAiB,EAAE,KAAK;QACxB,eAAe,EAAE,KAAK;KACvB,CAAC;IACF,OAAO,yBAAyB,CAAC,YAAY,EAAE;QAC7C,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,SAAS;QACxC,KAAK,EAAE,WAAW;QAClB,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAwBD,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC;IAC5F,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,OAAO,CAAC;SAChB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SAClC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,GAAG;QACH,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QAC5B,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;KAChC,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAI7C,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE;QACpB,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC,CAAC,EAAE,CAAC;IACL,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE;QACrB,IAAI,CAAC,gBAAgB;YAAE,OAAO,IAAI,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CACZ,WAAW,CAAC,GAAG,CAAC;aACb,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;aACtC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACf,kEAAkE;YAClE,IAAI,CAAC;gBACH,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CACpC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/core/prompts.ts"],"names":[],"mappings":"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"}

package/dist/core/repository-management-docs.d.ts

@@ -189,6 +189,30 @@ export declare function runRepositoryManagementScan(deps: RepositoryManagementDo
  * without writing.
  */
 export declare function runRepositoryArchitectureSectionReplace(deps: RepositoryManagementDocDeps, markdown: string): Promise<ArchitectureSectionReplaceResult>;
+/**
+ * Replace the marker-bracketed Architecture block in an overview file with
+ * a freshly composed body. Exported solely so the unit suite can pin edge
+ * cases (code-fence collisions, CRLF, orphan markers) without having to
+ * stand up a full SQLite + filesystem fixture for every shape.
+ *
+ * Contract:
+ *   - Marker matches inside fenced code blocks (``` or ~~~) are ignored —
+ *     the daemon's own README, an Architecture body that includes example
+ *     fences, or a paste from a chat could otherwise mis-anchor the merge
+ *     and overwrite Summary / Notable Changes / Daily Activity Log.
+ *   - CRLF input is preserved (LF input stays LF).
+ *   - Orphan markers (only `:start` or only `:end` present) are stripped
+ *     and a clean block is re-injected under `## Architecture` — never
+ *     left to drift in the file where the next refresh might mis-bind to
+ *     them.
+ *   - `## Architecture` / `## Notable Changes` headings are matched with
+ *     a line-anchored regex that tolerates trailing whitespace and either
+ *     line ending. The previous literal-`indexOf` match silently fell
+ *     through on `## Architecture \n` (trailing space) or `## Architecture\r\n`.
+ *   - Final fallback is append-before-Notable-Changes-or-EOF, identical
+ *     to the original contract.
+ */
+export declare function mergeArchitectureSection(current: string, markdown: string): string;
 /**
  * Re-copy the repository's README.* into `git/<slug>/README.md`,
  * snapshotting the previous mirror to `md_file_snapshots`. Used by both

package/dist/core/repository-management-docs.d.ts.map

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

package/dist/core/repository-management-docs.js

@@ -743,41 +743,225 @@ export async function runRepositoryArchitectureSectionReplace(deps, markdown) {
         return { status: "written", overviewPath, absolutePath, refreshedAt };
     });
 }
-function mergeArchitectureSection(current, markdown) {
-    const beginIdx = current.indexOf(ARCHITECTURE_BEGIN_MARKER);
-    const endIdx = current.indexOf(ARCHITECTURE_END_MARKER);
+/**
+ * Replace the marker-bracketed Architecture block in an overview file with
+ * a freshly composed body. Exported solely so the unit suite can pin edge
+ * cases (code-fence collisions, CRLF, orphan markers) without having to
+ * stand up a full SQLite + filesystem fixture for every shape.
+ *
+ * Contract:
+ *   - Marker matches inside fenced code blocks (``` or ~~~) are ignored —
+ *     the daemon's own README, an Architecture body that includes example
+ *     fences, or a paste from a chat could otherwise mis-anchor the merge
+ *     and overwrite Summary / Notable Changes / Daily Activity Log.
+ *   - CRLF input is preserved (LF input stays LF).
+ *   - Orphan markers (only `:start` or only `:end` present) are stripped
+ *     and a clean block is re-injected under `## Architecture` — never
+ *     left to drift in the file where the next refresh might mis-bind to
+ *     them.
+ *   - `## Architecture` / `## Notable Changes` headings are matched with
+ *     a line-anchored regex that tolerates trailing whitespace and either
+ *     line ending. The previous literal-`indexOf` match silently fell
+ *     through on `## Architecture \n` (trailing space) or `## Architecture\r\n`.
+ *   - Final fallback is append-before-Notable-Changes-or-EOF, identical
+ *     to the original contract.
+ */
+export function mergeArchitectureSection(current, markdown) {
+    // Normalize line endings for internal processing; remember the original
+    // shape so we can hand it back unchanged. Treating CRLF and LF the
+    // same throughout simplifies every offset calculation below.
+    const wasCrlf = /\r\n/.test(current);
+    const normalized = wasCrlf ? current.replace(/\r\n/g, "\n") : current;
+    const merged = mergeArchitectureSectionLf(normalized, markdown);
+    return wasCrlf ? merged.replace(/\n/g, "\r\n") : merged;
+}
+function mergeArchitectureSectionLf(content, markdown) {
     const body = markdown.trim();
     const block = `${ARCHITECTURE_BEGIN_MARKER}\n\n${body}\n\n${ARCHITECTURE_END_MARKER}`;
+    const fences = computeFenceRanges(content);
+    const beginIdx = indexOfOutsideFences(content, ARCHITECTURE_BEGIN_MARKER, fences);
+    const endIdx = indexOfOutsideFences(content, ARCHITECTURE_END_MARKER, fences);
+    // Happy path — both markers present and in the right order, outside
+    // any fence. Replace between them.
     if (beginIdx >= 0 && endIdx > beginIdx) {
-        return (current.slice(0, beginIdx)
+        return (content.slice(0, beginIdx)
             + block
-            + current.slice(endIdx + ARCHITECTURE_END_MARKER.length));
-    }
-    // Fallback: inject the block right after `## Architecture` if the
-    // markers were stripped, or append a new Architecture section before
-    // the next canonical section. Either path keeps the file usable
-    // without manual repair.
-    const headingIdx = current.indexOf("\n## Architecture\n");
-    if (headingIdx >= 0) {
-        const afterHeading = headingIdx + "\n## Architecture\n".length;
-        const nextSectionRel = findNextSectionOffset(current.slice(afterHeading));
-        const sliceEnd = nextSectionRel >= 0 ? afterHeading + nextSectionRel : current.length;
-        return (current.slice(0, afterHeading)
+            + content.slice(endIdx + ARCHITECTURE_END_MARKER.length));
+    }
+    // Orphan-marker repair. An end marker without a begin (or vice versa)
+    // is left over from a partial edit or an earlier bug. Strip the orphan
+    // line entirely so the re-injection below can plant a clean block
+    // without two `:end` markers staring at each other on the next refresh.
+    let cleaned = content;
+    if (beginIdx >= 0 && endIdx < 0) {
+        cleaned = stripLineContaining(cleaned, ARCHITECTURE_BEGIN_MARKER, fences);
+    }
+    else if (endIdx >= 0 && beginIdx < 0) {
+        cleaned = stripLineContaining(cleaned, ARCHITECTURE_END_MARKER, fences);
+    }
+    else if (beginIdx >= 0 && endIdx >= 0 && endIdx <= beginIdx) {
+        // Markers are out of order (end before begin) — treat both as orphans.
+        cleaned = stripLineContaining(cleaned, ARCHITECTURE_BEGIN_MARKER, fences);
+        cleaned = stripLineContaining(cleaned, ARCHITECTURE_END_MARKER, computeFenceRanges(cleaned));
+    }
+    // Re-inject under `## Architecture` if the heading still exists outside
+    // a fence, otherwise plant a fresh section before `## Notable Changes`
+    // or at EOF.
+    return injectArchitectureBlock(cleaned, block);
+}
+function injectArchitectureBlock(content, block) {
+    const fences = computeFenceRanges(content);
+    const architectureHeading = findHeadingLine(content, "Architecture", fences);
+    if (architectureHeading) {
+        const afterHeading = architectureHeading.lineEndOffset; // offset of '\n' just after heading
+        const tail = content.slice(afterHeading + 1); // skip the newline
+        const fencesTail = shiftFenceRanges(fences, -(afterHeading + 1));
+        const nextSectionRel = findNextSectionOffsetOutsideFences(tail, fencesTail);
+        const sliceEnd = nextSectionRel >= 0
+            ? afterHeading + 1 + nextSectionRel
+            : content.length;
+        return (content.slice(0, afterHeading + 1)
             + `\n${block}\n\n`
-            + current.slice(sliceEnd));
+            + content.slice(sliceEnd));
     }
-    // No Architecture section at all — append before Notable Changes / EOF.
-    const insertAt = current.indexOf("\n## Notable Changes\n");
+    const notableHeading = findHeadingLine(content, "Notable Changes", fences);
     const newSection = `\n## Architecture\n\n${block}\n`;
-    if (insertAt >= 0) {
-        return current.slice(0, insertAt) + newSection + current.slice(insertAt);
+    if (notableHeading) {
+        return (content.slice(0, notableHeading.lineStartOffset)
+            + newSection
+            + "\n"
+            + content.slice(notableHeading.lineStartOffset));
+    }
+    return content.trimEnd() + "\n" + newSection;
+}
+/**
+ * Compute byte ranges (inclusive of opening fence line through closing
+ * fence line) that are part of fenced code blocks. Matching inside one
+ * of these ranges is ignored. The fence delimiters themselves are also
+ * considered fenced so an ``` ```text\n<!-- architecture:start --> ``` ``` example doesn't slip through on the
+ * opening line's info-string position.
+ *
+ * An unclosed fence at EOF is treated as fenced through EOF — the
+ * conservative choice (we'd rather refuse to touch ambiguous content
+ * than risk corrupting it). For a well-formed daemon-generated overview
+ * file this branch is unreachable.
+ */
+function computeFenceRanges(content) {
+    const ranges = [];
+    let inFence = false;
+    let fenceStart = 0;
+    let fenceMarker = "```";
+    let offset = 0;
+    const lines = content.split("\n");
+    for (const text of lines) {
+        const trimmed = text.replace(/^\s*/, "");
+        const opensTriple = /^```/.test(trimmed);
+        const opensTilde = /^~~~/.test(trimmed);
+        if (!inFence && (opensTriple || opensTilde)) {
+            inFence = true;
+            fenceStart = offset;
+            fenceMarker = opensTriple ? "```" : "~~~";
+        }
+        else if (inFence
+            && ((fenceMarker === "```" && opensTriple)
+                || (fenceMarker === "~~~" && opensTilde))) {
+            ranges.push([fenceStart, offset + text.length]);
+            inFence = false;
+        }
+        offset += text.length + 1; // +1 for \n
+    }
+    if (inFence) {
+        ranges.push([fenceStart, content.length]);
+    }
+    return ranges;
+}
+function shiftFenceRanges(ranges, delta) {
+    const out = [];
+    for (const [s, e] of ranges) {
+        const ns = s + delta;
+        const ne = e + delta;
+        if (ne <= 0)
+            continue;
+        out.push([Math.max(0, ns), ne]);
+    }
+    return out;
+}
+function isInsideFence(offset, ranges) {
+    for (const [s, e] of ranges) {
+        if (offset >= s && offset < e)
+            return true;
+    }
+    return false;
+}
+function indexOfOutsideFences(content, needle, ranges) {
+    let from = 0;
+    while (from <= content.length) {
+        const idx = content.indexOf(needle, from);
+        if (idx < 0)
+            return -1;
+        if (!isInsideFence(idx, ranges))
+            return idx;
+        from = idx + 1;
+    }
+    return -1;
+}
+function findHeadingLine(content, headingText, ranges) {
+    // Match a line that IS `## <heading>` with optional trailing whitespace.
+    // `^` is enforced by tracking the start-of-line offset; trailing `\s*`
+    // accommodates the `## Architecture ` (trailing space) form that the
+    // previous literal `\n## Architecture\n` indexOf silently dropped.
+    const pattern = new RegExp(`^[ \\t]*##[ \\t]+${escapeRegex(headingText)}[ \\t]*$`);
+    let offset = 0;
+    for (const text of content.split("\n")) {
+        if (!isInsideFence(offset, ranges) && pattern.test(text)) {
+            return { lineStartOffset: offset, lineEndOffset: offset + text.length };
+        }
+        offset += text.length + 1;
+    }
+    return null;
+}
+function findNextSectionOffsetOutsideFences(s, ranges) {
+    // Find the line-start offset of the next top-level `## ` heading. Same
+    // line-aware walk as `findHeadingLine` but unconstrained on the heading
+    // text. Matches at offset 0 too — the caller slices the tail starting
+    // *after* the Architecture heading's newline, so a `## Foo` at offset
+    // 0 is genuinely "the very next section" (pathological back-to-back
+    // headings collapse to a clean replace).
+    let offset = 0;
+    for (const text of s.split("\n")) {
+        if (!isInsideFence(offset, ranges) && /^[ \t]*##[ \t]+/.test(text)) {
+            return offset;
+        }
+        offset += text.length + 1;
+    }
+    return -1;
+}
+function stripLineContaining(content, needle, ranges) {
+    // Remove the entire line that contains `needle` (outside fences), plus
+    // any single trailing blank line so we don't accumulate ghost blank
+    // lines on repeated orphan repairs.
+    const out = [];
+    let offset = 0;
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const text = lines[i];
+        const skipThis = !isInsideFence(offset, ranges) && text.includes(needle);
+        if (!skipThis) {
+            out.push(text);
+        }
+        else if (i + 1 < lines.length
+            && lines[i + 1].trim() === ""
+            && out.length > 0
+            && out[out.length - 1].trim() === "") {
+            // Drop the trailing blank too to avoid `\n\n\n` accumulation.
+            i++;
+        }
+        offset += text.length + 1;
     }
-    return current.trimEnd() + "\n" + newSection;
+    return out.join("\n");
 }
-function findNextSectionOffset(s) {
-    // Match the start of the next `## ` heading, anchored on a newline.
-    const match = /\n## /.exec(s);
-    return match ? match.index : -1;
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function updateArchitectureFrontmatter(content, params) {
     const setField = (text, key, value) => {