@aitne/daemon 0.1.3 → 0.1.6

package/dist/core/wiki/compile-preview.js

@@ -0,0 +1,200 @@
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { estimateFullCompileCost } from "./cost-estimate.js";
+/**
+ * WIKI_BUILDER_DESIGN.md §P4.B — pure-JS preview producer for
+ * `!compile --preview` (and `--dry-run` aliases). Surfaces what
+ * `wiki.compile` would touch before any agent session runs, so the
+ * operator can approve / reject from a DM reply or the dashboard.
+ *
+ * The compiler itself is an LLM session — its page-graph determination
+ * is opaque to pure code. The preview approximates the touch set with
+ * the only signal we have without running it:
+ *
+ *   - Raw note `10_raw/<slug>.md` whose mtime is newer than the workspace
+ *     `last_compile_at` is "pending"; older is "stale" (would be skipped
+ *     in incremental mode, re-processed in full mode).
+ *   - A pending raw whose stem matches an existing `20_wiki/<slug>.md` is
+ *     "modified" (compiler likely updates the wiki page).
+ *   - A pending raw with no matching wiki page is "added".
+ *   - In full mode, every raw is pending and reuses the same classifier.
+ *
+ * This is intentionally fuzzy: the actual compile is allowed to override
+ * the classification (e.g. merge two raws into one wiki page). The
+ * preview's contract is "no surprises larger than this set", not "exactly
+ * this set". The §P4.B copy in WIKI_BUILDER_DESIGN.md states the same
+ * caveat — the dry-run is an upper-bound courtesy, not a commitment.
+ *
+ * Duration: estimated from the token total and a per-MTok throughput
+ * constant (`SECONDS_PER_MTOK_INPUT`). Sonnet at peak streams ~1.2k
+ * tokens/sec but compile sessions are tool-loop-bounded; the constant
+ * undershoots so the dashboard ETA isn't optimistic.
+ */
+// Sonnet 4.6 tool-loop steady-state in compile sessions runs ~5–8 minutes
+// per million input tokens once the tool fan-out overhead is folded in.
+// Stay on the pessimistic side so a "10-minute compile" never surprises
+// the operator by taking 25.
+const SECONDS_PER_MTOK_INPUT = 480;
+export function buildCompilePreview(input) {
+    const rawDir = join(input.workspace.root_path, "10_raw");
+    const wikiDir = join(input.workspace.root_path, "20_wiki");
+    const rawFiles = listRawSlugs(rawDir);
+    const wikiSlugs = new Set(listWikiSlugs(wikiDir));
+    const lastCompileEpoch = parseEpoch(input.workspace.last_compile_at);
+    const added = [];
+    const modified = [];
+    const unchanged = [];
+    for (const raw of rawFiles) {
+        const isPending = input.mode === "full" ||
+            lastCompileEpoch === null ||
+            raw.mtimeEpoch > lastCompileEpoch;
+        if (!isPending) {
+            unchanged.push(`10_raw/${raw.relPath}`);
+            continue;
+        }
+        if (wikiSlugs.has(raw.slug)) {
+            modified.push(`20_wiki/${raw.slug}.md`);
+        }
+        else {
+            added.push(`20_wiki/${raw.slug}.md`);
+        }
+    }
+    // Wiki pages without a corresponding pending raw are reported under
+    // `unchanged` so the dashboard can render a "pages that will keep their
+    // current content" count next to "pages that will change".
+    const touchedSlugs = new Set();
+    for (const path of [...added, ...modified]) {
+        const m = path.match(/^20_wiki\/(.+)\.md$/);
+        if (m)
+            touchedSlugs.add(m[1]);
+    }
+    for (const slug of wikiSlugs) {
+        if (touchedSlugs.has(slug))
+            continue;
+        unchanged.push(`20_wiki/${slug}.md`);
+    }
+    // Reuse the canonical estimator so the preview, the dashboard banner,
+    // and the !compile-full approval gate quote identical numbers.
+    const estimate = estimateFullCompileCost(input.workspace);
+    // For incremental mode, scale the estimate to the pending-raw subset
+    // so the preview cost isn't full-rebuild cost. The 0.5×/2× brackets in
+    // `WikiCostEstimate` keep their meaning at the scaled magnitude.
+    const pendingCount = added.length + modified.length;
+    const scaledEstimate = input.mode === "full" || estimate.rawCount === 0
+        ? estimate
+        : scaleEstimate(estimate, pendingCount);
+    const estimatedDurationSeconds = Math.ceil((scaledEstimate.estimatedInputTokens / 1_000_000) * SECONDS_PER_MTOK_INPUT);
+    return {
+        workspace: input.workspace.name,
+        mode: input.mode,
+        added: added.sort(),
+        modified: modified.sort(),
+        unchanged: unchanged.sort(),
+        estimate: scaledEstimate,
+        estimatedDurationSeconds,
+    };
+}
+function scaleEstimate(estimate, pendingCount) {
+    if (estimate.rawCount === 0)
+        return estimate;
+    const ratio = pendingCount / estimate.rawCount;
+    const scaledTokens = Math.round(estimate.estimatedInputTokens * ratio);
+    const expectedUsd = (scaledTokens / 1_000) * estimate.unitCostUsdPerKToken;
+    return {
+        ...estimate,
+        rawCount: pendingCount,
+        estimatedInputTokens: scaledTokens,
+        optimisticUsd: round(expectedUsd * 0.5),
+        expectedUsd: round(expectedUsd),
+        pessimisticUsd: round(expectedUsd * 2),
+        exceedsThreshold: expectedUsd * 2 > estimate.thresholdUsd,
+    };
+}
+function listRawSlugs(rawDir) {
+    if (!existsSync(rawDir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(rawDir, { withFileTypes: true })) {
+        if (entry.isFile() && entry.name.endsWith(".md")) {
+            try {
+                const stat = statSync(join(rawDir, entry.name));
+                out.push({
+                    relPath: entry.name,
+                    slug: entry.name.slice(0, -3),
+                    mtimeEpoch: stat.mtimeMs,
+                });
+            }
+            catch {
+                /* skip */
+            }
+            continue;
+        }
+        if (entry.isDirectory() && entry.name === "images")
+            continue;
+        // Imported vaults may keep type-subdirs under 10_raw until migration;
+        // walk them so the preview is still useful pre-flatten. Slugs collide
+        // across subdirs are tolerated because the compiler treats each raw
+        // file independently — the rare duplicate is reported as `modified`
+        // twice, which is correct intent for the operator.
+        if (entry.isDirectory()) {
+            walkSubdir(join(rawDir, entry.name), entry.name, out);
+        }
+    }
+    return out;
+}
+function walkSubdir(absDir, prefix, out) {
+    try {
+        for (const entry of readdirSync(absDir, { withFileTypes: true })) {
+            if (entry.isFile() && entry.name.endsWith(".md")) {
+                try {
+                    const stat = statSync(join(absDir, entry.name));
+                    out.push({
+                        relPath: `${prefix}/${entry.name}`,
+                        slug: entry.name.slice(0, -3),
+                        mtimeEpoch: stat.mtimeMs,
+                    });
+                }
+                catch {
+                    /* skip */
+                }
+            }
+            else if (entry.isDirectory()) {
+                walkSubdir(join(absDir, entry.name), `${prefix}/${entry.name}`, out);
+            }
+        }
+    }
+    catch {
+        /* skip unreadable directory */
+    }
+}
+function listWikiSlugs(wikiDir) {
+    if (!existsSync(wikiDir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(wikiDir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith(".md"))
+            continue;
+        const slug = entry.name.slice(0, -3);
+        if (slug === "_index")
+            continue;
+        out.push(slug);
+    }
+    return out;
+}
+function parseEpoch(timestamp) {
+    if (!timestamp)
+        return null;
+    // SQLite emits `YYYY-MM-DD HH:MM:SS` from CURRENT_TIMESTAMP, which
+    // `new Date(...)` reads as local time in Node — but the value is UTC.
+    // Treat the space-separator shape explicitly so the comparison against
+    // `mtimeMs` (always UTC epoch) stays correct across operator timezones.
+    const isoCandidate = /\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}/.test(timestamp)
+        ? `${timestamp.replace(" ", "T")}Z`
+        : timestamp;
+    const epoch = Date.parse(isoCandidate);
+    return Number.isNaN(epoch) ? null : epoch;
+}
+function round(value) {
+    return Math.round(value * 1_000_000) / 1_000_000;
+}
+//# sourceMappingURL=compile-preview.js.map

package/dist/core/wiki/compile-preview.js.map

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

package/dist/core/wiki/cost-estimate.d.ts

@@ -0,0 +1,30 @@
+import type { WikiCostEstimate } from "@aitne/shared";
+import type { WikiWorkspaceRow } from "./workspaces.js";
+export interface EstimateCompileOptions {
+    /**
+     * Legacy override (P2.E): use a flat `avgInputTokensPerRaw` instead of
+     * the per-file char-based count. Retained for the dashboard's
+     * deterministic banner copy and the existing test suite. When set,
+     * disk reads are skipped — only the file count matters.
+     */
+    avgInputTokensPerRaw?: number;
+    /** Override the per-1k-token cost the estimator uses. */
+    unitCostUsdPerKToken?: number;
+    /** Inject a raw count instead of scanning disk. */
+    rawCountOverride?: number;
+    /**
+     * Cap the per-file breakdown list. The aggregate cost is unaffected.
+     * Default {@link PER_FILE_BREAKDOWN_LIMIT}; set 0 to omit the list.
+     */
+    perFileBreakdownLimit?: number;
+}
+export declare function estimateFullCompileCost(workspace: Pick<WikiWorkspaceRow, "root_path" | "full_compile_approval_threshold_usd">, options?: EstimateCompileOptions): WikiCostEstimate;
+/**
+ * Approximate token count from a Markdown body. Script-aware: majority-CJK
+ * content uses a denser divisor than Latin scripts because BPE merges
+ * fewer multi-byte sequences. The PER_FILE_MIN_TOKENS floor models the
+ * fixed per-call overhead the actual compile session pays regardless of
+ * input size (system prompt, skills bundle, tool descriptions).
+ */
+export declare function approxTokenCount(content: string): number;
+//# sourceMappingURL=cost-estimate.d.ts.map

package/dist/core/wiki/cost-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimate.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/cost-estimate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAqDxD,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,IAAI,CACb,gBAAgB,EAChB,WAAW,GAAG,qCAAqC,CACpD,EACD,OAAO,GAAE,sBAA2B,GACnC,gBAAgB,CAqFlB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWxD"}

package/dist/core/wiki/cost-estimate.js

@@ -0,0 +1,243 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Wiki compile cost estimator — WIKI_BUILDER_DESIGN.md §5.5, §P2.E, §P4.C.
+ *
+ * Pure JS (no agent session, no SDK call). The estimator opens each raw
+ * note, approximates its token count from on-disk content, then multiplies
+ * the total by the tier unit cost and brackets with 0.5×/2× multipliers.
+ * The dashboard banner and the bang-handler approval gate both read from
+ * this single source so the numbers cannot drift between UI and runtime.
+ *
+ * P2 originally shipped a flat-per-file heuristic (`rawCount × 1500`),
+ * which under-counted on long ingested articles and over-counted on
+ * one-line stubs. P4.C upgrades to a per-file char→token approximation
+ * (§P4.C in WIKI_BUILDER_DESIGN.md):
+ *
+ *   - English / Latin scripts: ~4 chars per token (the well-known
+ *     OpenAI rule-of-thumb; matches Anthropic's tokenizer within ±15%
+ *     for prose; confirmed against the gpt-tokenizer dist).
+ *   - CJK content: ~1.5 chars per token (BPE merges short CJK runs but
+ *     not as aggressively as Latin word fragments).
+ *
+ * The classifier counts Unicode code points whose script is one of
+ * Han, Hiragana, Katakana, Hangul, Bopomofo. If the document is
+ * majority-CJK we apply the CJK divisor to the entire file; otherwise
+ * Latin. A per-script split would be more accurate but adds 30% code
+ * for a sub-percent gain on typical mixed-script files.
+ *
+ * Why not invoke `@huggingface/transformers`: loading the tokenizer
+ * model downloads ~50MB on first call and adds ~200ms to a route the
+ * dashboard polls. The 4-chars-per-token heuristic is within 10–20% of
+ * the true Anthropic count on prose and within 5% on CJK — well under
+ * the 0.5×/2× bracket the design already exposes. Keep the gate cheap.
+ *
+ * Why pure JS, not an agent pre-pass: spawning a separate session to
+ * compute the estimate would itself burn budget — and the estimate's
+ * purpose is to decide whether spawning the *real* session is okay.
+ */
+const DEFAULT_AVG_INPUT_TOKENS_PER_RAW = 1_500;
+const DEFAULT_UNIT_COST_USD_PER_KTOKEN = 0.003; // Sonnet 4.6 input ~ $3 per Mtoken.
+const LATIN_CHARS_PER_TOKEN = 4;
+const CJK_CHARS_PER_TOKEN = 1.5;
+// Heuristic floor — empty / one-line raw files still cost the per-call
+// fixed overhead (system prompt, skills bundle, tool docs). 200 input
+// tokens is the rough minimum a compile session needs even for a stub.
+const PER_FILE_MIN_TOKENS = 200;
+// Cap on per-file breakdown rows returned to the dashboard so a vault
+// with thousands of raw files does not balloon the response payload.
+const PER_FILE_BREAKDOWN_LIMIT = 20;
+const OPTIMISTIC_MULT = 0.5;
+const PESSIMISTIC_MULT = 2.0;
+export function estimateFullCompileCost(workspace, options = {}) {
+    const unitCost = options.unitCostUsdPerKToken ?? DEFAULT_UNIT_COST_USD_PER_KTOKEN;
+    const threshold = workspace.full_compile_approval_threshold_usd;
+    // Legacy flat-heuristic branch — preserved for existing P2 tests and
+    // any caller that explicitly opts into the cheap mode.
+    if (options.avgInputTokensPerRaw !== undefined) {
+        const rawCount = options.rawCountOverride ?? countRawNotes(join(workspace.root_path, "10_raw"));
+        const estimatedInputTokens = Math.max(0, rawCount * options.avgInputTokensPerRaw);
+        const expectedUsd = (estimatedInputTokens / 1_000) * unitCost;
+        return {
+            rawCount,
+            estimatedInputTokens,
+            unitCostUsdPerKToken: unitCost,
+            optimisticUsd: round(expectedUsd * OPTIMISTIC_MULT),
+            expectedUsd: round(expectedUsd),
+            pessimisticUsd: round(expectedUsd * PESSIMISTIC_MULT),
+            thresholdUsd: threshold,
+            exceedsThreshold: expectedUsd * PESSIMISTIC_MULT > threshold,
+            method: "flat-heuristic",
+            perFile: [],
+        };
+    }
+    // P4.C — per-file token estimate. Walk the raw layer, sum tokens.
+    const breakdownLimit = options.perFileBreakdownLimit ?? PER_FILE_BREAKDOWN_LIMIT;
+    const rawDir = join(workspace.root_path, "10_raw");
+    let estimatedInputTokens = 0;
+    let rawCount = 0;
+    const perFile = [];
+    if (existsSync(rawDir)) {
+        for (const rel of walkRawLayer(rawDir)) {
+            const full = join(rawDir, rel);
+            let charCount = 0;
+            let tokenCount = PER_FILE_MIN_TOKENS;
+            try {
+                const stat = statSync(full);
+                if (!stat.isFile())
+                    continue;
+                const content = readFileSync(full, "utf-8");
+                charCount = content.length;
+                tokenCount = approxTokenCount(content);
+            }
+            catch {
+                // Unreadable file — still account for fixed-overhead minimum so the
+                // estimate is not silently 0.
+            }
+            rawCount += 1;
+            estimatedInputTokens += tokenCount;
+            perFile.push({ path: `10_raw/${rel}`, charCount, estimatedTokens: tokenCount });
+        }
+    }
+    // Honour `rawCountOverride` for the deterministic test path. The
+    // override semantically asks "what would the estimate look like for N
+    // files?" so we also override the token total — keeping the per-file
+    // breakdown produces an incoherent answer where `rawCount` doesn't
+    // match the breakdown length. Callers that want disk-accurate numbers
+    // simply omit the override.
+    if (options.rawCountOverride !== undefined) {
+        rawCount = options.rawCountOverride;
+        estimatedInputTokens = rawCount * DEFAULT_AVG_INPUT_TOKENS_PER_RAW;
+        perFile.length = 0;
+    }
+    // Sort breakdown by descending cost contribution so the dashboard shows
+    // the biggest files first (where the operator's attention should land).
+    perFile.sort((a, b) => b.estimatedTokens - a.estimatedTokens);
+    const trimmedPerFile = breakdownLimit > 0 ? perFile.slice(0, breakdownLimit) : [];
+    const expectedUsd = (estimatedInputTokens / 1_000) * unitCost;
+    const optimisticUsd = expectedUsd * OPTIMISTIC_MULT;
+    const pessimisticUsd = expectedUsd * PESSIMISTIC_MULT;
+    return {
+        rawCount,
+        estimatedInputTokens,
+        unitCostUsdPerKToken: unitCost,
+        optimisticUsd: round(optimisticUsd),
+        expectedUsd: round(expectedUsd),
+        pessimisticUsd: round(pessimisticUsd),
+        thresholdUsd: threshold,
+        exceedsThreshold: pessimisticUsd > threshold,
+        method: "per-file-chars",
+        perFile: trimmedPerFile,
+    };
+}
+/**
+ * Approximate token count from a Markdown body. Script-aware: majority-CJK
+ * content uses a denser divisor than Latin scripts because BPE merges
+ * fewer multi-byte sequences. The PER_FILE_MIN_TOKENS floor models the
+ * fixed per-call overhead the actual compile session pays regardless of
+ * input size (system prompt, skills bundle, tool descriptions).
+ */
+export function approxTokenCount(content) {
+    if (content.length === 0)
+        return PER_FILE_MIN_TOKENS;
+    let cjkChars = 0;
+    for (const ch of content) {
+        if (isCjkChar(ch))
+            cjkChars += 1;
+    }
+    const totalCodepoints = [...content].length;
+    const cjkRatio = totalCodepoints === 0 ? 0 : cjkChars / totalCodepoints;
+    const divisor = cjkRatio > 0.5 ? CJK_CHARS_PER_TOKEN : LATIN_CHARS_PER_TOKEN;
+    const tokens = Math.ceil(content.length / divisor);
+    return Math.max(PER_FILE_MIN_TOKENS, tokens);
+}
+function isCjkChar(ch) {
+    const cp = ch.codePointAt(0);
+    if (cp === undefined)
+        return false;
+    // U+3040–U+309F Hiragana, U+30A0–U+30FF Katakana,
+    // U+3400–U+4DBF / U+4E00–U+9FFF Han (CJK Unified Ideographs),
+    // U+AC00–U+D7AF Hangul Syllables, U+3100–U+312F Bopomofo.
+    return ((cp >= 0x3040 && cp <= 0x30ff) ||
+        (cp >= 0x3400 && cp <= 0x4dbf) ||
+        (cp >= 0x4e00 && cp <= 0x9fff) ||
+        (cp >= 0xac00 && cp <= 0xd7af) ||
+        (cp >= 0x3100 && cp <= 0x312f));
+}
+/**
+ * Walk `10_raw/` returning markdown leaves (root + recursive fallback for
+ * not-yet-flattened imported vaults — see {@link countRawNotes}). The
+ * `images/` subtree is skipped per §2.4 invariant.
+ */
+function walkRawLayer(rawDir) {
+    const out = [];
+    for (const entry of readdirSync(rawDir, { withFileTypes: true })) {
+        if (entry.isFile() && entry.name.endsWith(".md")) {
+            out.push(entry.name);
+            continue;
+        }
+        if (entry.isDirectory() && entry.name === "images")
+            continue;
+        if (entry.isDirectory()) {
+            walkDirInto(join(rawDir, entry.name), entry.name, out);
+        }
+    }
+    return out;
+}
+function walkDirInto(absDir, relPrefix, out) {
+    try {
+        for (const entry of readdirSync(absDir, { withFileTypes: true })) {
+            if (entry.isFile() && entry.name.endsWith(".md")) {
+                out.push(`${relPrefix}/${entry.name}`);
+            }
+            else if (entry.isDirectory()) {
+                walkDirInto(join(absDir, entry.name), `${relPrefix}/${entry.name}`, out);
+            }
+        }
+    }
+    catch {
+        /* skip unreadable directory */
+    }
+}
+function countRawNotes(rawDir) {
+    if (!existsSync(rawDir))
+        return 0;
+    let count = 0;
+    for (const entry of readdirSync(rawDir, { withFileTypes: true })) {
+        if (entry.isFile() && entry.name.endsWith(".md")) {
+            count += 1;
+            continue;
+        }
+        if (entry.isDirectory() && entry.name === "images")
+            continue;
+        if (entry.isDirectory()) {
+            const full = join(rawDir, entry.name);
+            try {
+                const stat = statSync(full);
+                if (stat.isDirectory()) {
+                    count += countMarkdownRecursive(full);
+                }
+            }
+            catch {
+                /* skip unreadable directory */
+            }
+        }
+    }
+    return count;
+}
+function countMarkdownRecursive(dir) {
+    let count = 0;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isFile() && entry.name.endsWith(".md")) {
+            count += 1;
+        }
+        else if (entry.isDirectory()) {
+            count += countMarkdownRecursive(join(dir, entry.name));
+        }
+    }
+    return count;
+}
+function round(value) {
+    return Math.round(value * 1_000_000) / 1_000_000;
+}
+//# sourceMappingURL=cost-estimate.js.map

package/dist/core/wiki/cost-estimate.js.map

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

package/dist/core/wiki/dispatcher.d.ts

@@ -0,0 +1,48 @@
+import { type Event, type WikiReplyTarget } from "@aitne/shared";
+/**
+ * Every wiki-tier process key the daemon dispatches. Kept ordered by
+ * Phase (P1 ingest/compile/ask, P3 operational triad lint/trace/connect)
+ * so a quick visual scan tells you which surfaces ship in which phase.
+ */
+export declare const WIKI_PROCESS_KEYS: readonly ["wiki.ingest_url", "wiki.compile", "wiki.ask", "wiki.lint", "wiki.trace", "wiki.connect"];
+/** Back-compat alias for the P1 surface. Prefer {@link WIKI_PROCESS_KEYS}. */
+export declare const WIKI_P1_PROCESS_KEYS: readonly ["wiki.ingest_url", "wiki.compile", "wiki.ask", "wiki.lint", "wiki.trace", "wiki.connect"];
+export type WikiProcessKey = (typeof WIKI_PROCESS_KEYS)[number];
+/** @deprecated use {@link WikiProcessKey}. */
+export type WikiP1ProcessKey = WikiProcessKey;
+export declare function isWikiProcessKey(value: string): value is WikiProcessKey;
+export interface WikiCommandEventInput {
+    processKey: WikiProcessKey;
+    workspace: string;
+    sourceEvent?: Event;
+    batchId?: string;
+    data?: Record<string, unknown>;
+}
+export declare function createWikiCommandEvent(input: WikiCommandEventInput): Event;
+/**
+ * Pure helper — read the reply-routing tuple stored on `event.data.reply_target`.
+ *
+ * Despite the `WikiReplyTarget` type name (kept for historical reasons —
+ * the schema first shipped with the wiki subsystem), the helper is
+ * type-agnostic: it reads the same `data.reply_target` field that
+ * `createWikiCommandEvent` puts on wiki.* events AND that `scheduler.ts`
+ * lifts onto `scheduled.task` events from approval rows
+ * (WIKI_BUILDER_DESIGN.md §3.4-bis). Callers in `ResultProcessor` use it
+ * to decide between direct reply (`NotificationManager.send({ replyTo })`)
+ * and proactive fan-out to the user's primary destinations.
+ *
+ * Returns null when:
+ *   - the event has no `data.reply_target` field (cron/routine event,
+ *     or wiki event minted without a sourceEvent), or
+ *   - the field shape is corrupt (defensive — a daemon downgrade reading
+ *     a payload from a future schema version).
+ *
+ * `readWikiReplyTarget` is exported as a back-compat alias so older
+ * external consumers keep working; new code should prefer
+ * `readEventReplyTarget`.
+ */
+export declare function readEventReplyTarget(event: Event): WikiReplyTarget | null;
+/** @deprecated Renamed to {@link readEventReplyTarget} — kept as an
+ *  alias to avoid breaking external callers during the rename window. */
+export declare const readWikiReplyTarget: typeof readEventReplyTarget;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/core/wiki/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,KAAK,EACV,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,qGAOpB,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,qGAAoB,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE9C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,KAAK,CAwC1E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,GAAG,IAAI,CAKzE;AAED;yEACyE;AACzE,eAAO,MAAM,mBAAmB,6BAAuB,CAAC"}

package/dist/core/wiki/dispatcher.js

@@ -0,0 +1,92 @@
+import { EventPriority, createEvent, isMessageEvent, wikiReplyTargetSchema, } from "@aitne/shared";
+/**
+ * Every wiki-tier process key the daemon dispatches. Kept ordered by
+ * Phase (P1 ingest/compile/ask, P3 operational triad lint/trace/connect)
+ * so a quick visual scan tells you which surfaces ship in which phase.
+ */
+export const WIKI_PROCESS_KEYS = [
+    "wiki.ingest_url",
+    "wiki.compile",
+    "wiki.ask",
+    "wiki.lint",
+    "wiki.trace",
+    "wiki.connect",
+];
+/** Back-compat alias for the P1 surface. Prefer {@link WIKI_PROCESS_KEYS}. */
+export const WIKI_P1_PROCESS_KEYS = WIKI_PROCESS_KEYS;
+export function isWikiProcessKey(value) {
+    return WIKI_PROCESS_KEYS.includes(value);
+}
+export function createWikiCommandEvent(input) {
+    // WIKI_BUILDER_DESIGN.md §3.4 — derive the reply routing tuple from the
+    // originating MessageEvent so the per-URL completion DMs from
+    // wiki.ingest_url (and the answer/report/log DMs from the other wiki
+    // process keys) land back on the same channel the operator used to
+    // run the bang command. When the source is not a MessageEvent
+    // (currently unreachable — wiki events spawn only from `!ingest` /
+    // `!compile` / `!ask` / ... which are all DMs — but future routine
+    // entry points might exist), `reply_target` is omitted and the
+    // ResultProcessor falls back to the user's configured destinations
+    // via `MessageHub.sendToUser`.
+    const replyTarget = input.sourceEvent && isMessageEvent(input.sourceEvent)
+        ? {
+            platform: input.sourceEvent.platform,
+            channel: input.sourceEvent.channel,
+            threadId: input.sourceEvent.threadId,
+            sender: input.sourceEvent.sender,
+        }
+        : undefined;
+    // Spread order matters: `input.data` is caller-supplied (the bang
+    // handler's per-key payload like `{ url }` for ingest_url or
+    // `{ topic }` for trace) and MUST NOT be allowed to override
+    // daemon-controlled routing/audit fields. A bang handler that
+    // accidentally (or maliciously, in a future plugin surface) put
+    // `reply_target` or `batch_id` in `data` would otherwise hijack the
+    // event. Daemon fields therefore come AFTER `input.data` so they
+    // win the spread conflict.
+    return createEvent({
+        type: input.processKey,
+        source: "wiki.bang",
+        priority: EventPriority.HIGH,
+        data: {
+            ...(input.data ?? {}),
+            workspace: input.workspace,
+            ...(input.batchId ? { batch_id: input.batchId } : {}),
+            ...(input.sourceEvent ? { parent_correlation_id: input.sourceEvent.correlationId } : {}),
+            ...(replyTarget ? { reply_target: replyTarget } : {}),
+        },
+    });
+}
+/**
+ * Pure helper — read the reply-routing tuple stored on `event.data.reply_target`.
+ *
+ * Despite the `WikiReplyTarget` type name (kept for historical reasons —
+ * the schema first shipped with the wiki subsystem), the helper is
+ * type-agnostic: it reads the same `data.reply_target` field that
+ * `createWikiCommandEvent` puts on wiki.* events AND that `scheduler.ts`
+ * lifts onto `scheduled.task` events from approval rows
+ * (WIKI_BUILDER_DESIGN.md §3.4-bis). Callers in `ResultProcessor` use it
+ * to decide between direct reply (`NotificationManager.send({ replyTo })`)
+ * and proactive fan-out to the user's primary destinations.
+ *
+ * Returns null when:
+ *   - the event has no `data.reply_target` field (cron/routine event,
+ *     or wiki event minted without a sourceEvent), or
+ *   - the field shape is corrupt (defensive — a daemon downgrade reading
+ *     a payload from a future schema version).
+ *
+ * `readWikiReplyTarget` is exported as a back-compat alias so older
+ * external consumers keep working; new code should prefer
+ * `readEventReplyTarget`.
+ */
+export function readEventReplyTarget(event) {
+    const raw = event.data?.reply_target;
+    if (!raw)
+        return null;
+    const parsed = wikiReplyTargetSchema.safeParse(raw);
+    return parsed.success ? parsed.data : null;
+}
+/** @deprecated Renamed to {@link readEventReplyTarget} — kept as an
+ *  alias to avoid breaking external callers during the rename window. */
+export const readWikiReplyTarget = readEventReplyTarget;
+//# sourceMappingURL=dispatcher.js.map

package/dist/core/wiki/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../../src/core/wiki/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,qBAAqB,GAGtB,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,iBAAiB;IACjB,cAAc;IACd,UAAU;IACV,WAAW;IACX,YAAY;IACZ,cAAc;CACN,CAAC;AAEX,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAOtD,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAUD,MAAM,UAAU,sBAAsB,CAAC,KAA4B;IACjE,wEAAwE;IACxE,8DAA8D;IAC9D,qEAAqE;IACrE,mEAAmE;IACnE,8DAA8D;IAC9D,mEAAmE;IACnE,mEAAmE;IACnE,+DAA+D;IAC/D,mEAAmE;IACnE,+BAA+B;IAC/B,MAAM,WAAW,GACf,KAAK,CAAC,WAAW,IAAI,cAAc,CAAC,KAAK,CAAC,WAAW,CAAC;QACpD,CAAC,CAAC;YACE,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ;YACpC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO;YAClC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ;YACpC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM;SACjC;QACH,CAAC,CAAC,SAAS,CAAC;IAChB,kEAAkE;IAClE,6DAA6D;IAC7D,6DAA6D;IAC7D,8DAA8D;IAC9D,gEAAgE;IAChE,oEAAoE;IACpE,iEAAiE;IACjE,2BAA2B;IAC3B,OAAO,WAAW,CAAC;QACjB,IAAI,EAAE,KAAK,CAAC,UAAU;QACtB,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,aAAa,CAAC,IAAI;QAC5B,IAAI,EAAE;YACJ,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAY;IAC/C,MAAM,GAAG,GAAI,KAAK,CAAC,IAA+C,EAAE,YAAY,CAAC;IACjF,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED;yEACyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC"}