crewly 1.8.4 → 1.8.6

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"}

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

@@ -0,0 +1,212 @@
+/**
+ * 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 * 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';
+const DEFAULT_LOG_RELATIVE_PATH = 'llm-curated/log.md';
+const MAX_BODY_BYTES = 64 * 1024;
+// Spec note (Steve, 2026-05-22): the earlier keyword-based
+// `detectMessageShape` heuristic + `buildDecisionSlug` + `ingestDecision`
+// dual-write were REMOVED. Routing into `llm-curated/<folder>/<page>.md`
+// is now agent-driven via `wiki-process-queue` + the agent's own LLM gate
+// — see WikiQueueService for the queue + the orchestrator system prompt
+// for the rule that says "queue worth-saving content as you see it." This
+// service stays low-level: it only writes the path the caller (skill,
+// route, queue processor) specifies, after the frozen-path gate.
+/**
+ * Writes ingest pages to a vault. Construct one per process; stateless.
+ */
+export class WikiIngestService {
+    static instance = null;
+    logger;
+    schemaLoader;
+    constructor(schemaLoader) {
+        this.logger = LoggerService.getInstance().createComponentLogger('WikiIngest');
+        this.schemaLoader = schemaLoader ?? new SchemaLoaderService();
+    }
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new WikiIngestService();
+        }
+        return this.instance;
+    }
+    /** Test-only reset. */
+    static _resetForTesting() {
+        this.instance = null;
+    }
+    /**
+     * 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.
+     */
+    async ingest(input) {
+        const validation = this.validateInput(input);
+        if (validation) {
+            return validation;
+        }
+        let schema;
+        try {
+            schema = await this.schemaLoader.load(input.vaultPath);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                reason: 'schema_missing',
+                message: err.message,
+            };
+        }
+        const target = input.targetRelativePath ?? DEFAULT_LOG_RELATIVE_PATH;
+        if (this.schemaLoader.isFrozenPath(schema, target)) {
+            return {
+                ok: false,
+                reason: 'frozen_path',
+                attemptedPath: target,
+                frozenFolders: this.schemaLoader.getFrozenPaths(schema),
+            };
+        }
+        const absoluteTarget = path.join(input.vaultPath, target);
+        await fs.mkdir(path.dirname(absoluteTarget), { recursive: true });
+        const logEntry = this.formatLogEntry(input);
+        await this.appendOrCreate(absoluteTarget, logEntry, input);
+        this.logger.info('WikiIngest wrote log entry', {
+            vault: input.vaultPath,
+            target,
+            sourceType: input.sourceType,
+            sourceRef: input.sourceRef,
+            bodyBytes: input.sourceBody.length,
+        });
+        return {
+            ok: true,
+            pagesWritten: [target],
+            logEntry,
+            frozenPathsTouched: [],
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Internals
+    // ---------------------------------------------------------------------------
+    validateInput(input) {
+        if (!input.vaultPath || !path.isAbsolute(input.vaultPath)) {
+            return {
+                ok: false,
+                reason: 'invalid_input',
+                message: `vaultPath must be an absolute path, got "${input.vaultPath ?? ''}"`,
+            };
+        }
+        if (!input.sourceType) {
+            return { ok: false, reason: 'invalid_input', message: 'sourceType is required' };
+        }
+        if (!input.sourceRef) {
+            return { ok: false, reason: 'invalid_input', message: 'sourceRef is required' };
+        }
+        const body = input.sourceBody ?? '';
+        if (body.trim().length === 0) {
+            return {
+                ok: false,
+                reason: 'empty_body',
+                message: 'sourceBody is empty after trimming whitespace',
+            };
+        }
+        if (Buffer.byteLength(body, 'utf8') > MAX_BODY_BYTES) {
+            return {
+                ok: false,
+                reason: 'invalid_input',
+                message: `sourceBody exceeds ${MAX_BODY_BYTES} bytes`,
+            };
+        }
+        return null;
+    }
+    /**
+     * 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>
+     */
+    formatLogEntry(input) {
+        const ts = new Date().toISOString();
+        const header = this.sanitizeOneLine(input.callerSession ?? input.sourceRef, 80);
+        const body = this.sanitizeBody(input.sourceBody);
+        const ref = this.sanitizeOneLine(input.sourceRef, 200);
+        return [
+            '',
+            `## [${ts}] ${input.sourceType} | ${header}`,
+            '',
+            `ref: ${ref}`,
+            '',
+            body,
+            '',
+        ].join('\n');
+    }
+    async appendOrCreate(absolutePath, entry, input) {
+        if (!existsSync(absolutePath)) {
+            const header = this.buildPageHeader(absolutePath, input);
+            await fs.writeFile(absolutePath, header + entry, 'utf8');
+            return;
+        }
+        await fs.appendFile(absolutePath, entry, 'utf8');
+    }
+    /**
+     * 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
+     */
+    buildPageHeader(absolutePath, input) {
+        const basename = absolutePath.split(/[/\\]/).pop() ?? '';
+        if (basename === 'log.md') {
+            return '# Activity log\n\nAppend-only log of ingested sources. Each entry: `## [<ISO>] <sourceType> | <caller>`.\n';
+        }
+        if (absolutePath.includes('/decisions/')) {
+            const title = this.sanitizeOneLine(input.sourceBody, 80);
+            const caller = input.callerSession ?? input.sourceRef;
+            return [
+                `# ${title}`,
+                '',
+                `> **source:** \`${this.sanitizeOneLine(input.sourceRef, 200)}\`  `,
+                `> **caller:** \`${this.sanitizeOneLine(caller, 80)}\`  `,
+                `> **recorded:** ${new Date().toISOString()}`,
+                '',
+                '---',
+                '',
+            ].join('\n');
+        }
+        // Generic non-log target: minimal title block.
+        return `# ${this.sanitizeOneLine(input.sourceRef, 80)}\n\n`;
+    }
+    /**
+     * 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.)
+     */
+    sanitizeBody(body) {
+        const trimmed = body.replace(/\r\n/g, '\n').trim();
+        return trimmed.replace(/\[(CHAT|NOTIFY|EVENT|ESCALATION)\]/g, (_match, tag) => `[​${tag}]`);
+    }
+    sanitizeOneLine(value, maxLen) {
+        const flat = value.replace(/[\r\n]+/g, ' ').replace(/\s+/g, ' ').trim();
+        if (flat.length <= maxLen)
+            return flat;
+        return flat.slice(0, maxLen - 1) + '…';
+    }
+}
+//# sourceMappingURL=wiki-ingest.service.js.map

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

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

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

@@ -0,0 +1,84 @@
+/**
+ * WikiProcessService — bundles "claim a pending item + build the
+ * system-context the agent's LLM needs to classify it."
+ *
+ * Per Steve's 2026-05-22 redesign:
+ *   - the skill DOES NOT pick a target folder. The agent picks.
+ *   - there is NO preset taxonomy beyond the frozen folders (sop/,
+ *     team-norm/, memory/, sop-overrides/). Everything under
+ *     llm-curated/* is fair game; the agent invents folder names.
+ *   - the agent reads the queue item's `reason` (which we forced it to
+ *     write at queue-add time) PLUS the existing vault state (so it
+ *     doesn't re-classify into a duplicate of an existing page).
+ *
+ * Lifecycle this service participates in:
+ *   pending → (this service)  → claimed + context payload returned
+ *           → (agent's LLM, outside the skill) picks target path
+ *           → (agent calls wiki-ingest)         → page written
+ *           → (agent calls queue/:id/process)   → status=processed
+ *
+ * @module services/wiki/wiki-process.service
+ */
+import { WikiQueueService, WikiQueueItem } from './wiki-queue.service.js';
+import { WikiQueryService, WikiQuerySystemContext } from './wiki-query.service.js';
+export interface WikiProcessClaimInput {
+    /** Agent session claiming the item. */
+    claimedBy: string;
+    /** Filter the queue to a specific vault (default: any). */
+    vaultPath?: string;
+    /** Skip this many leading pending items. Lets the agent re-roll after a skip. */
+    offset?: number;
+    /** For the vault context: how many candidate pages to include. */
+    topK?: number;
+    /** For the vault context: how many recent log entries. */
+    recentLogEntries?: number;
+}
+export interface WikiProcessClaimResult {
+    /** The claimed queue item. */
+    item: WikiQueueItem;
+    /**
+     * System-context the agent's LLM should classify against. Includes the
+     * vault SCHEMA, frozen-path list, recent log, and top-K candidate pages
+     * by keyword overlap with the queue item's content.
+     *
+     * `null` if the vault has no SCHEMA.md (rare — vault wasn't initialized).
+     */
+    vaultContext: WikiQuerySystemContext | null;
+    /** Synthesis instructions for the agent's LLM. */
+    classifierNotes: string[];
+}
+export type WikiProcessClaimOutcome = {
+    ok: true;
+    result: WikiProcessClaimResult;
+} | {
+    ok: false;
+    reason: 'no_pending_items' | 'vault_query_failed';
+    message: string;
+};
+/**
+ * Stateless façade — both backing services (queue, query) are singletons.
+ */
+export declare class WikiProcessService {
+    private readonly queue;
+    private readonly query;
+    private static instance;
+    private readonly logger;
+    constructor(queue?: WikiQueueService, query?: WikiQueryService);
+    static getInstance(): WikiProcessService;
+    /** Test-only reset. */
+    static _resetForTesting(): void;
+    /**
+     * Claim the next pending item + return the vault context the agent
+     * needs to classify it. The caller (agent runtime) then runs an LLM
+     * call against this context + the item's content/reason, picks a
+     * target page, and calls `wiki-ingest` + `/queue/:id/process` to
+     * commit.
+     */
+    claimNext(input: WikiProcessClaimInput): Promise<WikiProcessClaimOutcome>;
+    /**
+     * The contract the agent's LLM must honor when classifying. Kept
+     * short so it can be inlined into the runtime's task-instruction.
+     */
+    private classifierNotes;
+}
+//# sourceMappingURL=wiki-process.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-process.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-process.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB;;;;;;OAMG;IACH,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,kDAAkD;IAClD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF;;GAEG;AACH,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAGtB,KAAK,GAAE,gBAAiD,EACxD,KAAK,GAAE,gBAAiD;IAK3E,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAKxC,uBAAuB;IACvB,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAI/B;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA2E/E;;;OAGG;IACH,OAAO,CAAC,eAAe;CAUxB"}