crewly 1.8.4 → 1.8.5

package/dist/backend/backend/src/services/wiki/wiki-bookkeep.service.js

@@ -0,0 +1,299 @@
+/**
+ * WikiBookkeepService — vault health metrics + consolidation signals.
+ *
+ * Per Steve's 2026-05-22 design point #5: "还要时不时让 agent 针对自己的
+ * vault 进行 bookkeeping (可以根据存入的 md 数量来 trigger), 譬如过去 N
+ * 天超过 X 个 md, 然后总结一下."
+ *
+ * This service produces the report the bookkeeping agent reads:
+ *   - md count per top-level llm-curated subfolder
+ *   - new mds in the last N days
+ *   - filename clusters (likely-duplicates by Jaccard of token sets)
+ *   - queue stats (so the agent sees pending items too)
+ *
+ * The agent uses this report (+ its LLM) to decide:
+ *   - which pages to consolidate / dedupe (calls wiki-ingest with a new
+ *     consolidated body + deletes the originals via a separate skill —
+ *     deletion is OUT of scope for Phase 1; surface as proposals).
+ *   - which topics deserve a summary "rollup" page.
+ *
+ * The service does NOT delete or rewrite anything. It reports.
+ *
+ * @module services/wiki/wiki-bookkeep.service
+ */
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import { existsSync } from 'fs';
+import { LoggerService } from '../core/logger.service.js';
+import { SchemaLoaderService } from './schema-loader.service.js';
+import { WikiQueueService } from './wiki-queue.service.js';
+const DEFAULT_WINDOW_DAYS = 7;
+const DEFAULT_MD_THRESHOLD = 10;
+const MAX_PAGES_SCANNED = 1000;
+/**
+ * Vault health + bookkeeping report generator. Stateless; uses the
+ * schema loader + queue services it composes.
+ */
+export class WikiBookkeepService {
+    static instance = null;
+    logger;
+    schemaLoader;
+    queue;
+    constructor(schemaLoader, queue) {
+        this.logger = LoggerService.getInstance().createComponentLogger('WikiBookkeep');
+        this.schemaLoader = schemaLoader ?? new SchemaLoaderService();
+        this.queue = queue ?? WikiQueueService.getInstance();
+    }
+    static getInstance() {
+        if (!this.instance)
+            this.instance = new WikiBookkeepService();
+        return this.instance;
+    }
+    /** Test-only reset. */
+    static _resetForTesting() {
+        this.instance = null;
+    }
+    /**
+     * Build the bookkeeping report. Caller (skill / cron / agent) decides
+     * whether to act on `shouldFire`. The service never writes; it reports.
+     */
+    async generate(input) {
+        if (!input.vaultPath || !path.isAbsolute(input.vaultPath)) {
+            return {
+                ok: false,
+                reason: 'invalid_input',
+                message: 'vaultPath must be absolute',
+            };
+        }
+        if (!existsSync(input.vaultPath)) {
+            return {
+                ok: false,
+                reason: 'vault_missing',
+                message: `vault directory does not exist: ${input.vaultPath}`,
+            };
+        }
+        let schema;
+        try {
+            schema = await this.schemaLoader.load(input.vaultPath);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                reason: 'schema_missing',
+                message: err.message,
+            };
+        }
+        const windowDays = input.windowDays ?? DEFAULT_WINDOW_DAYS;
+        const threshold = input.threshold ?? DEFAULT_MD_THRESHOLD;
+        const windowMs = windowDays * 24 * 3600 * 1000;
+        const now = Date.now();
+        const staleMs = 90 * 24 * 3600 * 1000;
+        const pages = await this.collectPages(input.vaultPath, schema.llm_curated.map((l) => l.path));
+        const totalMdCount = pages.length;
+        let recentMdCount = 0;
+        let staleCount = 0;
+        const countsByFolder = {};
+        for (const p of pages) {
+            const mtime = Date.parse(p.modifiedAt);
+            if (Number.isFinite(mtime)) {
+                if (now - mtime <= windowMs)
+                    recentMdCount++;
+                if (now - mtime > staleMs)
+                    staleCount++;
+            }
+            // Folder bucket: first directory segment under llm-curated/.
+            const rel = p.path;
+            const parts = rel.split('/').filter(Boolean);
+            // rel looks like "llm-curated/<folder>/<page>.md" → bucket = "llm-curated/<folder>".
+            if (parts.length >= 2) {
+                const bucket = `${parts[0]}/${parts[1]}`;
+                countsByFolder[bucket] = (countsByFolder[bucket] ?? 0) + 1;
+            }
+            else if (parts.length === 1) {
+                const bucket = parts[0];
+                countsByFolder[bucket] = (countsByFolder[bucket] ?? 0) + 1;
+            }
+        }
+        const duplicateCandidates = this.findDuplicateClusters(pages);
+        const queueStats = await this.queue.getStats(input.vaultPath);
+        const shouldFire = recentMdCount >= threshold || duplicateCandidates.length > 0;
+        const recommendations = this.buildRecommendations({
+            shouldFire,
+            recentMdCount,
+            threshold,
+            duplicates: duplicateCandidates,
+            countsByFolder,
+            staleCount,
+            queueStats,
+        });
+        const report = {
+            vault: {
+                scope: schema.vault_scope,
+                id: schema.vault_id,
+                path: input.vaultPath,
+            },
+            generatedAt: new Date().toISOString(),
+            windowDays,
+            threshold,
+            shouldFire,
+            totalMdCount,
+            recentMdCount,
+            countsByFolder,
+            duplicateCandidates,
+            staleCount,
+            queue: queueStats,
+            recommendations,
+        };
+        this.logger.info('WikiBookkeep generated', {
+            vault: input.vaultPath,
+            totalMd: totalMdCount,
+            recentMd: recentMdCount,
+            duplicates: duplicateCandidates.length,
+            shouldFire,
+        });
+        return { ok: true, report };
+    }
+    // ---------------------------------------------------------------------------
+    async collectPages(vaultPath, llmCuratedFolders) {
+        const pages = [];
+        let scanned = 0;
+        for (const folder of llmCuratedFolders) {
+            const root = path.join(vaultPath, folder.replace(/[/\\]+$/, ''));
+            if (!existsSync(root))
+                continue;
+            const stack = [root];
+            while (stack.length > 0 && scanned < MAX_PAGES_SCANNED) {
+                const current = stack.pop();
+                let entries;
+                try {
+                    entries = await fs.readdir(current, { withFileTypes: true });
+                }
+                catch {
+                    continue;
+                }
+                for (const entry of entries) {
+                    if (entry.name.startsWith('.'))
+                        continue;
+                    const full = path.join(current, entry.name);
+                    if (entry.isDirectory()) {
+                        stack.push(full);
+                        continue;
+                    }
+                    if (!entry.isFile() || !entry.name.endsWith('.md'))
+                        continue;
+                    scanned++;
+                    try {
+                        const stat = await fs.stat(full);
+                        pages.push({
+                            path: path.relative(vaultPath, full).replace(/\\/g, '/'),
+                            bytes: stat.size,
+                            modifiedAt: new Date(stat.mtimeMs).toISOString(),
+                        });
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+            }
+        }
+        return pages;
+    }
+    /**
+     * Find filename clusters by Jaccard over name tokens.
+     * Two pages with ≥ 0.6 overlap on their non-trivial filename tokens
+     * are flagged as potential duplicates. Token = anything ≥ 3 chars
+     * after splitting on `[-_./]`, lowercased, minus date prefix.
+     */
+    findDuplicateClusters(pages) {
+        if (pages.length < 2)
+            return [];
+        const tokens = pages.map((p) => ({
+            path: p.path,
+            tokens: this.tokenizeFilename(p.path),
+        }));
+        const used = new Set();
+        const clusters = [];
+        for (let i = 0; i < tokens.length; i++) {
+            if (used.has(i))
+                continue;
+            const peers = [i];
+            for (let j = i + 1; j < tokens.length; j++) {
+                if (used.has(j))
+                    continue;
+                if (this.jaccard(tokens[i].tokens, tokens[j].tokens) >= 0.6) {
+                    peers.push(j);
+                }
+            }
+            if (peers.length >= 2) {
+                peers.forEach((p) => used.add(p));
+                const memberPaths = peers.map((p) => tokens[p].path);
+                clusters.push({
+                    basis: this.longestCommonPrefix(memberPaths),
+                    pages: memberPaths,
+                });
+            }
+        }
+        return clusters;
+    }
+    tokenizeFilename(relPath) {
+        const basename = relPath.split('/').pop()?.replace(/\.md$/, '') ?? '';
+        // Strip ISO-date prefix (YYYY-MM-DD-)
+        const withoutDate = basename.replace(/^\d{4}-\d{2}-\d{2}-/, '');
+        const tokens = withoutDate
+            .toLowerCase()
+            .split(/[-_./\s]+/)
+            .filter((t) => t.length >= 3);
+        return new Set(tokens);
+    }
+    jaccard(a, b) {
+        if (a.size === 0 && b.size === 0)
+            return 0;
+        let inter = 0;
+        for (const x of a)
+            if (b.has(x))
+                inter++;
+        const union = a.size + b.size - inter;
+        return union === 0 ? 0 : inter / union;
+    }
+    longestCommonPrefix(paths) {
+        if (paths.length === 0)
+            return '';
+        let prefix = paths[0];
+        for (const p of paths.slice(1)) {
+            while (p.indexOf(prefix) !== 0) {
+                prefix = prefix.slice(0, -1);
+                if (!prefix)
+                    return '';
+            }
+        }
+        return prefix;
+    }
+    buildRecommendations(args) {
+        const recs = [];
+        if (!args.shouldFire) {
+            recs.push(`Quiet vault — only ${args.recentMdCount} new md(s) in the window (threshold ${args.threshold}). No action required.`);
+        }
+        else {
+            recs.push(`Window has ${args.recentMdCount} new md(s) — at or above threshold (${args.threshold}). Consider a consolidation pass.`);
+        }
+        if (args.duplicates.length > 0) {
+            recs.push(`${args.duplicates.length} likely-duplicate cluster(s) detected. Review each with your LLM and call wiki-ingest with a consolidated body when you can merge.`);
+            args.duplicates.slice(0, 3).forEach((c) => {
+                recs.push(`  • cluster "${c.basis}": ${c.pages.join(', ')}`);
+            });
+        }
+        if (args.queueStats.pending > 5) {
+            recs.push(`${args.queueStats.pending} pending queue items. Drain via wiki-process-queue before doing other bookkeeping.`);
+        }
+        const folderEntries = Object.entries(args.countsByFolder).sort((a, b) => b[1] - a[1]);
+        if (folderEntries.length > 0) {
+            const top = folderEntries[0];
+            recs.push(`Hottest folder: \`${top[0]}\` (${top[1]} pages). If it's grown >20 pages without a rollup, write a summary index page.`);
+        }
+        if (args.staleCount > 0) {
+            recs.push(`${args.staleCount} page(s) untouched in 90+ days. Consider whether they're still authoritative — flag stale or archive.`);
+        }
+        return recs;
+    }
+}
+//# sourceMappingURL=wiki-bookkeep.service.js.map

package/dist/backend/backend/src/services/wiki/wiki-bookkeep.service.js.map

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

package/dist/backend/backend/src/services/wiki/wiki-chat-subscriber.service.d.ts

@@ -0,0 +1,74 @@
+/**
+ * WikiChatSubscriberService — listens on chat-v2's `chat_message` event
+ * and fires `WikiIngestService.ingest` for every user-authored message.
+ *
+ * Phase A (rules-only routing):
+ *   senderType === 'user' → ingest into the Crewly project vault.
+ *   senderType === 'agent' | 'system' → skip.
+ *
+ * Phase B (per spec §4.5) will replace the project-only routing with an
+ * LLM-driven gate that picks team / project / global per source.
+ *
+ * Failure mode is FIRE-AND-FORGET: a malformed message, missing schema,
+ * or filesystem error MUST NOT block the live chat flow. Errors are
+ * logged at warn-level and swallowed.
+ *
+ * @module services/wiki/wiki-chat-subscriber.service
+ */
+import type { ChatV2Service } from '../chat-v2/chat-v2.service.js';
+import { WikiIngestService } from './wiki-ingest.service.js';
+/**
+ * Shape we consume from chat-v2's `chat_message` payload. Kept narrow so
+ * we don't take a heavy structural dep on the wire DTO; matches the
+ * fields produced by `toMessageDTO` (chat-v2.service.ts:1537).
+ */
+interface MinimalChatMessageDTO {
+    id: string;
+    channelId: string;
+    senderType: 'user' | 'agent' | 'system';
+    senderId: string;
+    content: string;
+    contentType: string;
+    createdAt: string | number;
+}
+export interface WikiChatSubscriberOptions {
+    /** chat-v2 singleton — `getChatV2Service()` at composition root. */
+    chatService: ChatV2Service;
+    /** Absolute path to the project vault. Default falls back to env / well-known location. */
+    projectVaultPath?: string;
+    /** Optional override for tests. */
+    ingestService?: WikiIngestService;
+}
+/**
+ * Process-singleton subscriber. Call `start()` once at server boot,
+ * `stop()` at shutdown.
+ */
+export declare class WikiChatSubscriberService {
+    private readonly logger;
+    private readonly chatService;
+    private readonly projectVaultPath;
+    private readonly ingestService;
+    private boundHandler;
+    private started;
+    constructor(opts: WikiChatSubscriberOptions);
+    /**
+     * Subscribe to `chat_message`. Idempotent — calling start() twice
+     * leaves a single listener.
+     */
+    start(): void;
+    /** Detach. Safe to call when not started. */
+    stop(): void;
+    /**
+     * Handle a single chat message. Public for tests.
+     */
+    handle(dto: MinimalChatMessageDTO): Promise<void>;
+    /**
+     * Decide whether a chat-v2 message should drive a wiki write.
+     * Public for tests; logic is conservative — only ingest user-authored
+     * text messages, skip agents/system, mentions-only pings, and slash
+     * commands.
+     */
+    isIngestable(dto: MinimalChatMessageDTO): boolean;
+}
+export {};
+//# sourceMappingURL=wiki-chat-subscriber.service.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki-chat-subscriber.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-chat-subscriber.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-chat-subscriber.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAsB,MAAM,0BAA0B,CAAC;AAEjF;;;;GAIG;AACH,UAAU,qBAAqB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,oEAAoE;IACpE,WAAW,EAAE,aAAa,CAAC;IAC3B,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,YAAY,CAAuD;IAC3E,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,yBAAyB;IAO3C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAgBb,6CAA6C;IAC7C,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDvD;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO;CAYlD"}

package/dist/backend/backend/src/services/wiki/wiki-chat-subscriber.service.js

@@ -0,0 +1,154 @@
+/**
+ * WikiChatSubscriberService — listens on chat-v2's `chat_message` event
+ * and fires `WikiIngestService.ingest` for every user-authored message.
+ *
+ * Phase A (rules-only routing):
+ *   senderType === 'user' → ingest into the Crewly project vault.
+ *   senderType === 'agent' | 'system' → skip.
+ *
+ * Phase B (per spec §4.5) will replace the project-only routing with an
+ * LLM-driven gate that picks team / project / global per source.
+ *
+ * Failure mode is FIRE-AND-FORGET: a malformed message, missing schema,
+ * or filesystem error MUST NOT block the live chat flow. Errors are
+ * logged at warn-level and swallowed.
+ *
+ * @module services/wiki/wiki-chat-subscriber.service
+ */
+import * as path from 'path';
+import { LoggerService } from '../core/logger.service.js';
+import { WikiIngestService, detectMessageShape } from './wiki-ingest.service.js';
+/**
+ * Process-singleton subscriber. Call `start()` once at server boot,
+ * `stop()` at shutdown.
+ */
+export class WikiChatSubscriberService {
+    logger;
+    chatService;
+    projectVaultPath;
+    ingestService;
+    boundHandler = null;
+    started = false;
+    constructor(opts) {
+        this.logger = LoggerService.getInstance().createComponentLogger('WikiChatSubscriber');
+        this.chatService = opts.chatService;
+        this.projectVaultPath = opts.projectVaultPath ?? resolveDefaultProjectVaultPath();
+        this.ingestService = opts.ingestService ?? WikiIngestService.getInstance();
+    }
+    /**
+     * Subscribe to `chat_message`. Idempotent — calling start() twice
+     * leaves a single listener.
+     */
+    start() {
+        if (this.started) {
+            this.logger.debug('start() called twice — ignoring');
+            return;
+        }
+        this.boundHandler = (dto) => {
+            // Fire-and-forget; any thrown error is logged + swallowed in handle().
+            void this.handle(dto);
+        };
+        this.chatService.on('chat_message', this.boundHandler);
+        this.started = true;
+        this.logger.info('WikiChatSubscriber started', {
+            vaultPath: this.projectVaultPath,
+        });
+    }
+    /** Detach. Safe to call when not started. */
+    stop() {
+        if (!this.started || !this.boundHandler)
+            return;
+        this.chatService.off('chat_message', this.boundHandler);
+        this.boundHandler = null;
+        this.started = false;
+        this.logger.info('WikiChatSubscriber stopped');
+    }
+    /**
+     * Handle a single chat message. Public for tests.
+     */
+    async handle(dto) {
+        try {
+            if (!this.isIngestable(dto)) {
+                return;
+            }
+            const ingestInput = {
+                vaultPath: this.projectVaultPath,
+                sourceType: 'user_chat',
+                sourceRef: `chat:${dto.channelId}:${dto.id}`,
+                sourceBody: dto.content,
+                callerSession: `user/${dto.senderId}`,
+            };
+            // Phase A rules-based promotion: decision-shaped chats land in
+            // BOTH log.md (audit) and llm-curated/decisions/<date>-<slug>.md
+            // (canonical). Phase B will replace `detectMessageShape` with an
+            // LLM gate per v2.1 §4.
+            const shape = detectMessageShape(dto.content);
+            if (shape === 'decision') {
+                const result = await this.ingestService.ingestDecision(ingestInput);
+                if (!result.log.ok) {
+                    this.logger.warn('WikiChatSubscriber decision-log ingest refused', {
+                        reason: result.log.reason,
+                        messageId: dto.id,
+                    });
+                }
+                if (!result.decision.ok) {
+                    this.logger.warn('WikiChatSubscriber decisions/ promotion refused', {
+                        reason: result.decision.reason,
+                        messageId: dto.id,
+                    });
+                }
+                return;
+            }
+            const outcome = await this.ingestService.ingest(ingestInput);
+            if (!outcome.ok) {
+                this.logger.warn('WikiChatSubscriber ingest refused', {
+                    reason: outcome.reason,
+                    messageId: dto.id,
+                });
+            }
+        }
+        catch (err) {
+            // Swallow — chat flow must not block on wiki write failures.
+            this.logger.warn('WikiChatSubscriber.handle threw (swallowed)', {
+                messageId: dto.id,
+                error: err.message,
+            });
+        }
+    }
+    /**
+     * Decide whether a chat-v2 message should drive a wiki write.
+     * Public for tests; logic is conservative — only ingest user-authored
+     * text messages, skip agents/system, mentions-only pings, and slash
+     * commands.
+     */
+    isIngestable(dto) {
+        if (dto.senderType !== 'user')
+            return false;
+        if (!dto.content || dto.content.trim().length === 0)
+            return false;
+        // Skip slash commands — they're orc-controls, not knowledge.
+        if (dto.content.trimStart().startsWith('/'))
+            return false;
+        // chat-v2 defaults `contentType` to 'markdown' when sendMessage doesn't
+        // supply one (chat-v2.service.ts ~line 1240). Accept the two readable
+        // text-bearing types; reject binary/system flavors like 'system_note'.
+        const acceptable = new Set(['text', 'markdown']);
+        if (dto.contentType && !acceptable.has(dto.contentType))
+            return false;
+        return true;
+    }
+}
+/**
+ * Resolve a sensible default vault path:
+ *   1. `CREWLY_PROJECT_VAULT_PATH` env var (explicit override)
+ *   2. `<cwd>/.crewly/wiki` if it exists
+ *   3. The Crewly repo's own project vault (the only one with SCHEMA.md today)
+ */
+function resolveDefaultProjectVaultPath() {
+    const fromEnv = process.env['CREWLY_PROJECT_VAULT_PATH'];
+    if (fromEnv && path.isAbsolute(fromEnv)) {
+        return fromEnv;
+    }
+    return path.join('/Users/yellowsunhy/Desktop/projects/crewly-projects/crewly', '.crewly/wiki');
+}
+//# sourceMappingURL=wiki-chat-subscriber.service.js.map

package/dist/backend/backend/src/services/wiki/wiki-chat-subscriber.service.js.map

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

package/dist/backend/backend/src/services/wiki/wiki-ingest.service.d.ts

@@ -0,0 +1,100 @@
+/**
+ * WikiIngestService — write canonical pages into a vault's `llm-curated/`.
+ *
+ * Phase A scope per v2.1 spec: append entries to `llm-curated/log.md` for
+ * every chat/spec/learning source. Decisions/pattern pages (separate files
+ * under `llm-curated/decisions/`) are gated behind the LLM routing layer
+ * which lands in Phase B.
+ *
+ * Frozen-path contract (§2): refuses ANY write whose target lives under a
+ * `hardcoded:` folder. SchemaLoaderService.isFrozenPath() is the gate.
+ *
+ * @module services/wiki/wiki-ingest.service
+ */
+import { SchemaLoaderService } from './schema-loader.service.js';
+/**
+ * Categories of sources that trigger ingest. Mirrors §4 (ingest trigger
+ * taxonomy) plus `user_chat` for the demo path.
+ */
+export type WikiSourceType = 'user_chat' | 'slack_message' | 'spec_file' | 'pr_merge' | 'record_learning' | 'task_verified';
+export interface WikiIngestInput {
+    /** Absolute path to the vault root (containing SCHEMA.md). */
+    vaultPath: string;
+    /** Where the content came from. */
+    sourceType: WikiSourceType;
+    /** Stable reference for audit (URL, file path, WI id, chat msg id). */
+    sourceRef: string;
+    /** Body content to ingest. Empty bodies are rejected. */
+    sourceBody: string;
+    /** Session/user that authored the source — appears in the log header. */
+    callerSession?: string;
+    /** Optional override of the relative target path; defaults to `llm-curated/log.md`. */
+    targetRelativePath?: string;
+}
+export interface WikiIngestResult {
+    ok: true;
+    pagesWritten: string[];
+    logEntry: string;
+    frozenPathsTouched: string[];
+}
+export interface WikiIngestRefusedFrozen {
+    ok: false;
+    reason: 'frozen_path';
+    attemptedPath: string;
+    frozenFolders: string[];
+}
+export interface WikiIngestRefusedInvalid {
+    ok: false;
+    reason: 'invalid_input' | 'schema_missing' | 'empty_body';
+    message: string;
+}
+export type WikiIngestOutcome = WikiIngestResult | WikiIngestRefusedFrozen | WikiIngestRefusedInvalid;
+/**
+ * Writes ingest pages to a vault. Construct one per process; stateless.
+ */
+export declare class WikiIngestService {
+    private static instance;
+    private readonly logger;
+    private readonly schemaLoader;
+    constructor(schemaLoader?: SchemaLoaderService);
+    static getInstance(): WikiIngestService;
+    /** Test-only reset. */
+    static _resetForTesting(): void;
+    /**
+     * Ingest a single source into the vault.
+     *
+     * Errors are returned as structured outcomes — this method never throws
+     * on legitimate refusals (frozen path, missing schema, empty body) so
+     * callers can fold the result into their normal control flow.
+     */
+    ingest(input: WikiIngestInput): Promise<WikiIngestOutcome>;
+    private validateInput;
+    /**
+     * Build the markdown entry. Format is chosen to be safely append-only
+     * (no preceding section to rewrite) and grep-friendly:
+     *
+     *   ## [<ISO>] <sourceType> | <callerSession or sourceRef>
+     *
+     *   ref: <sourceRef>
+     *
+     *   <body>
+     */
+    private formatLogEntry;
+    private appendOrCreate;
+    /**
+     * Pick the right header for a freshly-created page:
+     *   - `log.md`            → audit-log preamble (append-only)
+     *   - `decisions/*.md`    → decision-page title + provenance block
+     *   - anything else       → minimal title block from the source ref
+     */
+    private buildPageHeader;
+    /**
+     * Defuse markers a future skill might mis-route on: `[CHAT]`, `[NOTIFY]`,
+     * `[EVENT]`, `[ESCALATION]` get a zero-width space inserted so they're
+     * still human-readable but don't trigger regex matchers downstream.
+     * (Mirrors the escalation-router sanitizer from PR #606.)
+     */
+    private sanitizeBody;
+    private sanitizeOneLine;
+}
+//# sourceMappingURL=wiki-ingest.service.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki-ingest.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-ingest.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-ingest.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,eAAe,GACf,WAAW,GACX,UAAU,GACV,iBAAiB,GACjB,eAAe,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,UAAU,EAAE,cAAc,CAAC;IAC3B,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,eAAe,GAAG,gBAAgB,GAAG,YAAY,CAAC;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,uBAAuB,GACvB,wBAAwB,CAAC;AAc7B;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAEvC,YAAY,CAAC,EAAE,mBAAmB;IAK9C,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAOvC,uBAAuB;IACvB,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAI/B;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqDhE,OAAO,CAAC,aAAa;IAgCrB;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;YAgBR,cAAc;IAa5B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAuBvB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,eAAe;CAKxB"}