cli-jaw 2.2.15 → 2.2.17

package/dist/src/search/coordinator.js

@@ -0,0 +1,153 @@
+import { createHash } from 'node:crypto';
+const CORPORA = ['chat', 'memory', 'wiki'];
+const MAX_CURSOR_CHARS = 4096;
+const MAX_CURSOR_PROVIDERS = 32;
+const MAX_PROVIDER_ID_CHARS = 128;
+const MAX_CURSOR_OFFSET = 1_000_000;
+const invalidCursor = () => Object.assign(new Error('invalid_cursor'), { statusCode: 400, code: 'invalid_cursor' });
+// This SHA-256 binds a cursor to its query. It is not an HMAC or a tamper-resistance boundary.
+const hashOf = (query) => createHash('sha256').update(JSON.stringify(query)).digest('hex');
+function decodeCursor(raw) {
+    if (!raw)
+        return { v: 1, hash: '', providers: {} };
+    try {
+        if (!/^[A-Za-z0-9_-]+$/.test(raw))
+            throw invalidCursor();
+        // Bound the work before decoding: the cursor is client-supplied, and an
+        // oversized payload otherwise buys unbounded decode/parse/traversal.
+        if (raw.length > MAX_CURSOR_CHARS)
+            throw invalidCursor();
+        const decoded = Buffer.from(raw, 'base64url');
+        if (decoded.toString('base64url') !== raw)
+            throw invalidCursor();
+        const value = JSON.parse(decoded.toString('utf8'));
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            throw invalidCursor();
+        const row = value;
+        if (row['v'] !== 1 || typeof row['hash'] !== 'string' ||
+            !row['providers'] || typeof row['providers'] !== 'object' || Array.isArray(row['providers'])) {
+            throw invalidCursor();
+        }
+        const providers = row['providers'];
+        const providerIds = Object.keys(providers);
+        if (providerIds.length > MAX_CURSOR_PROVIDERS)
+            throw invalidCursor();
+        for (const id of providerIds) {
+            if (id.length > MAX_PROVIDER_ID_CHARS)
+                throw invalidCursor();
+            const state = providers[id];
+            if (!state || typeof state !== 'object' || Array.isArray(state))
+                throw invalidCursor();
+            const item = state;
+            // Number.isInteger(1e100) is true, so an absurd offset would sail
+            // through and reach the provider as a SQL OFFSET.
+            if (!Number.isSafeInteger(item['offset']) || Number(item['offset']) < 0 ||
+                Number(item['offset']) > MAX_CURSOR_OFFSET ||
+                typeof item['exhausted'] !== 'boolean')
+                throw invalidCursor();
+            for (const key of Object.keys(item)) {
+                if (key !== 'offset' && key !== 'exhausted')
+                    throw invalidCursor();
+            }
+        }
+        return row;
+    }
+    catch (error) {
+        if (error.code === 'invalid_cursor')
+            throw error;
+        throw invalidCursor();
+    }
+}
+const encodeCursor = (cursor) => Buffer.from(JSON.stringify(cursor)).toString('base64url');
+const returnedCount = (page) => page.groups.reduce((sum, group) => sum + group.hits.length, 0);
+/**
+ * Provider errors can carry SQL, filesystem paths, upstream bodies, or
+ * credentials. Log the detail server-side; return a stable message.
+ */
+const failureWarning = (provider, reason) => {
+    console.error('[search:provider]', provider.id, reason instanceof Error ? reason.message : String(reason));
+    return { code: 'provider_failed', provider: provider.id, message: 'search provider failed' };
+};
+export class SearchCoordinator {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async search(input) {
+        const query = {
+            ...input,
+            query: input.query.trim(),
+            limit: Math.min(input.limit ?? 20, 100),
+        };
+        if (!query.query)
+            throw Object.assign(new Error('q is required'), { statusCode: 400 });
+        const { cursor: _cursor, ...base } = query;
+        const hash = hashOf(base);
+        const cursor = decodeCursor(input.cursor);
+        if (input.cursor && cursor.hash !== hash)
+            throw invalidCursor();
+        const requested = input.corpus === 'all' ? CORPORA : [input.corpus];
+        const registered = input.corpus === 'all'
+            ? this.registry.list() : this.registry.list(input.corpus);
+        const missingWarnings = requested
+            .filter(corpus => !registered.some(provider => provider.corpus === corpus))
+            .map(corpus => ({
+            code: 'provider_failed', provider: corpus,
+            message: `${corpus} search provider is not registered`,
+        }));
+        const states = { ...cursor.providers };
+        // Every non-ready provider must be terminalized BEFORE hasMore is computed.
+        // hasMore asks "is any registered provider unexhausted?", so a provider that
+        // never appears in cursor state reads as unexhausted forever and offers a
+        // next page that can never contain anything.
+        const offProviders = registered.filter(provider => provider.status() === 'off');
+        const erroredProviders = registered.filter(provider => provider.status() === 'error');
+        for (const provider of [...offProviders, ...erroredProviders]) {
+            states[provider.id] = { offset: 0, exhausted: true };
+        }
+        const ready = registered.filter(provider => provider.status() === 'ready' && !cursor.providers[provider.id]?.exhausted);
+        const perProvider = Math.max(1, Math.ceil((query.limit ?? 20) / Math.max(1, ready.length)));
+        const settled = await Promise.allSettled(ready.map(provider => provider.search(query, {
+            limit: perProvider,
+            offset: cursor.providers[provider.id]?.offset ?? 0,
+            ...(query.instances !== undefined ? { instanceIds: query.instances } : {}),
+        })));
+        const pages = settled.flatMap((result, index) => result.status === 'fulfilled'
+            ? [{ provider: ready[index], page: result.value }] : []);
+        const rejected = settled.flatMap((result, index) => result.status === 'rejected'
+            ? [{ provider: ready[index], reason: result.reason }] : []);
+        settled.forEach((result, index) => {
+            const provider = ready[index];
+            const previous = states[provider.id] ?? { offset: 0, exhausted: false };
+            states[provider.id] = result.status === 'rejected'
+                ? { ...previous, exhausted: true }
+                : { offset: previous.offset + returnedCount(result.value), exhausted: !result.value.page.hasMore };
+        });
+        const hasMore = registered.some(provider => !states[provider.id]?.exhausted);
+        return {
+            query: base,
+            groups: pages.flatMap(({ page }) => page.groups),
+            warnings: [
+                ...missingWarnings,
+                ...rejected.map(({ provider, reason }) => failureWarning(provider, reason)),
+                ...offProviders.map(provider => ({
+                    code: 'provider_off', provider: provider.id,
+                    message: `${provider.corpus} search provider is disabled`,
+                })),
+                ...erroredProviders.map(provider => ({
+                    code: 'provider_failed', provider: provider.id,
+                    message: 'search provider failed',
+                })),
+                ...pages.flatMap(({ page }) => page.warnings),
+            ],
+            page: { hasMore, nextCursor: hasMore ? encodeCursor({ v: 1, hash, providers: states }) : null },
+            providers: [
+                ...pages.flatMap(({ page }) => page.providers),
+                ...rejected.map(({ provider }) => ({ id: provider.id, corpus: provider.corpus, status: 'error' })),
+                ...offProviders.map(provider => ({ id: provider.id, corpus: provider.corpus, status: 'off' })),
+                ...erroredProviders.map(provider => ({ id: provider.id, corpus: provider.corpus, status: 'error' })),
+            ],
+        };
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/src/search/coordinator.js.map

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

package/dist/src/search/provider.js

@@ -0,0 +1,40 @@
+export function providerEnvelope(provider, query, hits, warnings = [], hasMore = false) {
+    const { cursor: _cursor, ...base } = query;
+    return {
+        query: base,
+        groups: [{ corpus: provider.corpus, ranking: hits[0]?.ranking.mode ?? 'like', hits }],
+        warnings,
+        page: { nextCursor: null, hasMore },
+        providers: [{ id: provider.id, corpus: provider.corpus, status: provider.status() }],
+    };
+}
+export function createOffProvider(id, corpus) {
+    const provider = {
+        id,
+        corpus,
+        status: () => 'off',
+        async search(query) {
+            return providerEnvelope(provider, query, [], [{
+                    code: 'provider_off', provider: id, message: `${corpus} search provider is disabled`,
+                }]);
+        },
+    };
+    return provider;
+}
+export class SearchProviderRegistry {
+    providers = new Map();
+    register(provider) {
+        if (this.providers.has(provider.id)) {
+            throw new Error(`duplicate search provider: ${provider.id}`);
+        }
+        this.providers.set(provider.id, provider);
+        return () => {
+            if (this.providers.get(provider.id) === provider)
+                this.providers.delete(provider.id);
+        };
+    }
+    list(corpus) {
+        return [...this.providers.values()].filter(provider => !corpus || provider.corpus === corpus);
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/src/search/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/search/provider.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,gBAAgB,CAC5B,QAAwB,EACxB,KAAkB,EAClB,IAAiB,EACjB,WAA4B,EAAE,EAC9B,OAAO,GAAG,KAAK;IAEf,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAC3C,OAAO;QACH,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;QACrF,QAAQ;QACR,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;QACnC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;KACvF,CAAC;AACN,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU,EAAE,MAAsB;IAChE,MAAM,QAAQ,GAAmB;QAC7B,EAAE;QACF,MAAM;QACN,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK;QACnB,KAAK,CAAC,MAAM,CAAC,KAAK;YACd,OAAO,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;oBAC1C,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,8BAA8B;iBACvF,CAAC,CAAC,CAAC;QACR,CAAC;KACJ,CAAC;IACF,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,MAAM,OAAO,sBAAsB;IACd,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE/D,QAAQ,CAAC,QAAwB;QAC7B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE;YACR,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,QAAQ;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC,CAAC;IACN,CAAC;IAED,IAAI,CAAC,MAAuB;QACxB,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAClG,CAAC;CACJ"}

package/dist/src/search/providers/chat.js

@@ -0,0 +1,115 @@
+import { searchChatCandidates, } from '../../core/db.js';
+import { providerEnvelope } from '../provider.js';
+const CJK_PATTERN = /[\p{Script=Han}\p{Script=Hangul}\p{Script=Hiragana}\p{Script=Katakana}]/u;
+const WHITESPACE_PATTERN = /\s/u;
+function escapeLike(value) {
+    return value.replaceAll('\\', '\\\\').replaceAll('%', '\\%').replaceAll('_', '\\_');
+}
+function ftsPhrase(value) {
+    return `"${value.replaceAll('"', '""')}"`;
+}
+function toHits(rows, ranking, offset) {
+    return rows.map((row, index) => ({
+        corpus: 'chat',
+        provider: 'local-chat',
+        key: String(row.id),
+        session: row.session_id,
+        timestamp: row.created_at,
+        snippet: row.content,
+        ranking: {
+            mode: ranking,
+            sourceRank: offset + index + 1,
+            ...(typeof row.source_score === 'number' ? { sourceScore: row.source_score } : {}),
+        },
+        metadata: {
+            role: row.role,
+            cli: row.cli,
+            match_field: row.match_field,
+            tool_log: row.tool_log,
+        },
+    }));
+}
+export class ChatSearchProvider {
+    engine;
+    enabled;
+    id = 'local-chat';
+    corpus = 'chat';
+    constructor(engine = 'like', enabled = true) {
+        this.engine = engine;
+        this.enabled = enabled;
+    }
+    status() {
+        return this.enabled ? 'ready' : 'off';
+    }
+    async search(query, opts) {
+        if (!this.enabled) {
+            return providerEnvelope(this, query, [], [{
+                    code: 'provider_off', provider: this.id, message: 'chat search provider is disabled',
+                }]);
+        }
+        const text = query.query.trim();
+        const params = {
+            match: ftsPhrase(text),
+            like: escapeLike(text),
+            session_id: query.sessionFilter ?? null,
+            days: query.days ?? null,
+            recent: query.recent ?? null,
+            limit: opts.limit + 1,
+            offset: opts.offset,
+        };
+        let candidateEngine = 'like';
+        let ranking = 'like';
+        let warnings = [];
+        let rows;
+        if (this.engine === 'like' || Array.from(text).length < 3) {
+            rows = searchChatCandidates('like', params);
+        }
+        else if (CJK_PATTERN.test(text)) {
+            if (WHITESPACE_PATTERN.test(text)) {
+                rows = searchChatCandidates('like', params);
+            }
+            else {
+                candidateEngine = 'trigram';
+                ranking = 'trigram';
+                try {
+                    rows = searchChatCandidates(candidateEngine, params);
+                    if (rows.length === 0) {
+                        candidateEngine = 'like';
+                        ranking = 'like';
+                        rows = searchChatCandidates(candidateEngine, params);
+                    }
+                }
+                catch (error) {
+                    candidateEngine = 'like';
+                    ranking = 'like';
+                    rows = searchChatCandidates(candidateEngine, params);
+                    warnings = [{
+                            code: 'engine_fallback',
+                            provider: this.id,
+                            message: `chat FTS unavailable; LIKE fallback used: ${error instanceof Error ? error.message : String(error)}`,
+                        }];
+                }
+            }
+        }
+        else {
+            candidateEngine = 'unicode61';
+            ranking = 'bm25';
+            try {
+                rows = searchChatCandidates(candidateEngine, params);
+            }
+            catch (error) {
+                candidateEngine = 'like';
+                ranking = 'like';
+                rows = searchChatCandidates(candidateEngine, params);
+                warnings = [{
+                        code: 'engine_fallback',
+                        provider: this.id,
+                        message: `chat FTS unavailable; LIKE fallback used: ${error instanceof Error ? error.message : String(error)}`,
+                    }];
+            }
+        }
+        const selected = rows.slice(0, opts.limit);
+        return providerEnvelope(this, query, toHits(selected, ranking, opts.offset), warnings, rows.length > selected.length);
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/src/search/providers/chat.js.map

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

package/dist/src/search/providers/memory.js

@@ -0,0 +1,53 @@
+import { searchIndexForProvider } from '../../memory/indexing.js';
+import { providerEnvelope } from '../provider.js';
+export class MemorySearchProvider {
+    enabled;
+    id = 'local-memory';
+    corpus = 'memory';
+    constructor(enabled = true) {
+        this.enabled = enabled;
+    }
+    status() {
+        return this.enabled ? 'ready' : 'off';
+    }
+    async search(query, opts) {
+        if (!this.enabled) {
+            return providerEnvelope(this, query, [], [{
+                    code: 'provider_off', provider: this.id, message: 'memory search provider is disabled',
+                }]);
+        }
+        const result = searchIndexForProvider(query.query, opts);
+        const warnings = [
+            ...result.degraded.map(name => ({
+                code: 'engine_fallback',
+                provider: this.id,
+                message: `memory index degraded: ${name}`,
+            })),
+            ...(query.sessionFilter !== undefined ? [{
+                    code: 'session_filter_ignored',
+                    provider: this.id,
+                    message: 'memory is shared; sessionFilter does not restrict memory results',
+                }] : []),
+        ];
+        const hits = result.hits.map((hit, index) => ({
+            corpus: 'memory',
+            provider: this.id,
+            key: `${hit.relpath}:${hit.source_start_line}`,
+            ...(hit.sessionId ? { session: hit.sessionId } : {}),
+            location: {
+                path: hit.relpath || hit.path,
+                startLine: hit.source_start_line,
+                endLine: hit.source_end_line,
+            },
+            snippet: hit.snippet,
+            ranking: {
+                mode: 'rrf',
+                sourceRank: opts.offset + index + 1,
+                sourceScore: hit.score,
+            },
+            metadata: { kind: hit.kind, relpath: hit.relpath },
+        }));
+        return providerEnvelope(this, query, hits, warnings, result.hasMore);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/search/providers/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../src/search/providers/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAmD,MAAM,gBAAgB,CAAC;AAEnG,MAAM,OAAO,oBAAoB;IAIA;IAHpB,EAAE,GAAG,cAAc,CAAC;IACpB,MAAM,GAAG,QAAiB,CAAC;IAEpC,YAA6B,UAAU,IAAI;QAAd,YAAO,GAAP,OAAO,CAAO;IAAG,CAAC;IAE/C,MAAM;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAkB,EAAE,IAA2B;QACxD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;oBACtC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,oCAAoC;iBACzF,CAAC,CAAC,CAAC;QACR,CAAC;QAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAoB;YAC9B,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC5B,IAAI,EAAE,iBAA0B;gBAChC,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,OAAO,EAAE,0BAA0B,IAAI,EAAE;aAC5C,CAAC,CAAC;YACH,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;oBACrC,IAAI,EAAE,wBAAiC;oBACvC,QAAQ,EAAE,IAAI,CAAC,EAAE;oBACjB,OAAO,EAAE,kEAAkE;iBAC9E,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACX,CAAC;QACF,MAAM,IAAI,GAAgB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACvD,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,GAAG,EAAE,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,iBAAiB,EAAE;YAC9C,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,QAAQ,EAAE;gBACN,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI;gBAC7B,SAAS,EAAE,GAAG,CAAC,iBAAiB;gBAChC,OAAO,EAAE,GAAG,CAAC,eAAe;aAC/B;YACD,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,OAAO,EAAE;gBACL,IAAI,EAAE,KAAK;gBACX,UAAU,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,GAAG,CAAC;gBACnC,WAAW,EAAE,GAAG,CAAC,KAAK;aACzB;YACD,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;SACrD,CAAC,CAAC,CAAC;QACJ,OAAO,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzE,CAAC;CACJ"}

package/dist/src/search/providers/wiki.js

@@ -0,0 +1,80 @@
+// ─── Wiki search provider (devlog 040 §9) ─────────────
+// Reads the opt-in vault through the shared note search. Only search is reused: the
+// link graph and vault index stay with the manager, because this provider needs neither.
+import { searchNotes } from '../../notes/search.js';
+import { providerEnvelope } from '../provider.js';
+import { forbiddenWikiRoots, readUsableWikiConfig, wikiProviderStatus } from '../../wiki/config.js';
+// The shared note search refuses a request for more than this many results, so a page
+// deep enough to ask for more would throw rather than return an empty tail. Wiki search
+// therefore stops at that boundary and says so, instead of pretending a next page exists
+// that it can never fetch (040 §0c R3).
+export const WIKI_SEARCH_RESULT_CAP = 100;
+export class WikiSearchProvider {
+    readConfig;
+    id = 'local-wiki';
+    corpus = 'wiki';
+    // The config is read per call rather than captured, because enabling the vault must
+    // take effect without restarting the process that registered this provider.
+    // Reads the validated view rather than the raw one: the generic settings API can
+    // write this block without going through the enable route, so a root that route
+    // would have refused must not become readable by that back door.
+    constructor(readConfig = () => readUsableWikiConfig(forbiddenWikiRoots())) {
+        this.readConfig = readConfig;
+    }
+    config() {
+        try {
+            return this.readConfig();
+        }
+        catch {
+            // An unusable root is a configuration error, not a crash: status() reports it.
+            return { enabled: false, root: '', promptDigest: false };
+        }
+    }
+    status() {
+        return wikiProviderStatus(this.config());
+    }
+    async search(query, opts) {
+        const config = this.config();
+        const status = wikiProviderStatus(config);
+        if (status !== 'ready') {
+            // A disabled vault performs no filesystem read at all, which is what makes
+            // "off by default" mean something on disk and not just in the UI.
+            return providerEnvelope(this, query, [], [{
+                    code: status === 'off' ? 'provider_off' : 'provider_failed',
+                    provider: this.id,
+                    message: status === 'off'
+                        ? 'wiki search provider is disabled'
+                        : 'wiki vault is unavailable',
+                }]);
+        }
+        const warnings = query.sessionFilter === undefined ? [] : [{
+                code: 'session_filter_ignored',
+                provider: this.id,
+                message: 'the wiki is shared; sessionFilter does not restrict wiki results',
+            }];
+        // Ask for one more than this page needs so hasMore is observed rather than
+        // guessed, but never ask the shared search for more than it accepts.
+        const want = Math.min(opts.offset + opts.limit + 1, WIKI_SEARCH_RESULT_CAP);
+        const rows = await searchNotes(config.root, query.query, { limit: want });
+        const page = rows.slice(opts.offset, opts.offset + opts.limit);
+        const hasMore = rows.length > opts.offset + opts.limit;
+        if (!hasMore && rows.length >= WIKI_SEARCH_RESULT_CAP) {
+            warnings.push({
+                code: 'engine_fallback',
+                provider: this.id,
+                message: `wiki search stops at ${WIKI_SEARCH_RESULT_CAP} results`,
+            });
+        }
+        const hits = page.map((row, index) => ({
+            corpus: 'wiki',
+            provider: this.id,
+            key: `${row.path}:${row.line}`,
+            location: { path: row.path, startLine: row.line, endLine: row.line },
+            snippet: row.context || row.content,
+            ranking: { mode: 'like', sourceRank: opts.offset + index },
+            metadata: { kind: row.kind },
+        }));
+        return providerEnvelope(this, query, hits, warnings, hasMore);
+    }
+}
+//# sourceMappingURL=wiki.js.map

package/dist/src/search/providers/wiki.js.map

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

package/dist/src/slack/api.js

@@ -1,7 +1,7 @@
 // ─── Slack Web API Client ────────────────────────────
 // Thin fetch wrapper. No SDK: Slack's HTTP surface is small and cli-jaw's
 // Discord transport already establishes the house pattern (REST via fetch,
-// lazily imported). See devlog/_plan/260802_slack_channel/000_plan.md D-1.
+// lazily imported). See devlog/_fin/260802_slack_channel/000_plan.md D-1.
 //
 // The critical Slack-specific rule: Slack returns HTTP 200 with
 // {"ok": false, "error": "..."} for application errors. Checking response.ok
@@ -103,6 +103,15 @@ export async function slackApi(token, method, body, options = {}) {
     const url = `${SLACK_API_BASE}/${method}`;
     const headers = { Authorization: `Bearer ${token}` };
     const init = { method: 'POST', headers };
+    if (options.signal && options.timeoutMs !== undefined) {
+        init.signal = AbortSignal.any([options.signal, AbortSignal.timeout(options.timeoutMs)]);
+    }
+    else if (options.signal) {
+        init.signal = options.signal;
+    }
+    else if (options.timeoutMs !== undefined) {
+        init.signal = AbortSignal.timeout(options.timeoutMs);
+    }
     if (options.form && body) {
         const params = new URLSearchParams();
         for (const [k, v] of Object.entries(body)) {

package/dist/src/slack/api.js.map

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

package/dist/src/slack/attachment-recovery.js

@@ -0,0 +1,42 @@
+// ─── Slack Attachment Recovery ───────────────────────
+// app_mention 봉투에는 files 가 없다 — 문서화된 스키마에 부재하며, Slack은
+// 첨부가 필요하면 channel+ts 로 대화를 다시 조회하라고 안내한다.
+// https://docs.slack.dev/reference/events/app_mention/
+//
+// 같은 업로드의 message 사본은 events.ts 의 mention_via_app_mention 가
+// 드롭한다(한 멘션이 두 에이전트 실행이 되는 것을 막는 의도적 동작). 그래서
+// 멘션과 함께 올린 첨부는 어느 봉투로도 도달하지 못한다. 드롭을 되돌리는 대신
+// 첨부만 되찾는다. 설계 근거: devlog/_plan/260806_slack_multifile_ingest/020.
+import { fetchSlackHistory, fetchSlackReplies } from './history.js';
+/** 스레드 조회 상한. 한 스레드에서 대상 ts 를 찾기에 충분하다. */
+const THREAD_LOOKUP_LIMIT = 50;
+/**
+ * (channel, ts) 메시지의 첨부를 되찾는다. 스레드 안이면 replies, 아니면
+ * history 를 쓴다.
+ *
+ * 실패는 예외가 아니라 빈 배열이다: 첨부 복구는 보조 경로이고, 여기서 던지면
+ * 텍스트만 있는 평범한 멘션까지 처리가 중단된다.
+ */
+export async function recoverSlackAttachments(token, channel, ts, options = {}) {
+    if (!token || !channel || !ts)
+        return [];
+    const fetchOpts = options.fetchImpl ? { fetchImpl: options.fetchImpl } : {};
+    try {
+        const result = options.threadTs
+            ? await fetchSlackReplies(token, channel, options.threadTs, {
+                limit: THREAD_LOOKUP_LIMIT, ...fetchOpts,
+            })
+            // oldest 는 배타적이므로 inclusive 없이는 대상 메시지가 빠진다.
+            : await fetchSlackHistory(token, channel, {
+                oldest: ts, inclusive: true, limit: 1, ...fetchOpts,
+            });
+        if (!result.ok)
+            return [];
+        const match = result.messages.find(message => message.ts === ts);
+        return match?.files ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=attachment-recovery.js.map

package/dist/src/slack/attachment-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-recovery.js","sourceRoot":"","sources":["../../../src/slack/attachment-recovery.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,uDAAuD;AACvD,2CAA2C;AAC3C,uDAAuD;AACvD,EAAE;AACF,4DAA4D;AAC5D,8CAA8C;AAC9C,8CAA8C;AAC9C,mEAAmE;AAEnE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AASpE,2CAA2C;AAC3C,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,KAAa,EACb,OAAe,EACf,EAAU,EACV,UAAoC,EAAE;IAEtC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ;YAC3B,CAAC,CAAC,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;gBACxD,KAAK,EAAE,mBAAmB,EAAE,GAAG,SAAS;aAC3C,CAAC;YACF,6CAA6C;YAC7C,CAAC,CAAC,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE;gBACtC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS;aACtD,CAAC,CAAC;QACP,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,OAAO,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC"}