@coralai/sps-cli 0.50.24 → 0.51.0

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

@@ -0,0 +1,42 @@
+export interface InitWikiOptions {
+    /** Project name used in templates */
+    readonly projectName: string;
+    /** ISO date for created/updated fields (default: today) */
+    readonly today?: string;
+    /** Skip writing .gitignore (default: false) */
+    readonly skipGitignore?: boolean;
+}
+export interface InitWikiReport {
+    /** Wiki dir absolute path */
+    readonly wikiDir: string;
+    /** Subdirs created (already-existing skipped) */
+    readonly created: string[];
+    /** Files written (already-existing skipped) */
+    readonly filesWritten: string[];
+    /** Files left untouched because they already existed */
+    readonly filesSkipped: string[];
+    /** Was .gitignore touched? */
+    readonly gitignoreUpdated: boolean;
+}
+/**
+ * Idempotently scaffold wiki/ in the given repo.
+ *
+ * Creates:
+ *   - wiki/, wiki/{modules,concepts,decisions,lessons,sources}/, wiki/.raw/, wiki/_attachments/
+ *   - wiki/WIKI.md, wiki/index.md, wiki/overview.md, wiki/.hot.md
+ *   - .gitignore: appends per-instance drift entries if missing
+ *
+ * Does NOT write .manifest.json — that's owned by `sps wiki update` and is empty
+ * until first ingest.
+ *
+ * Re-runnable safely: existing files are preserved.
+ */
+export declare function initWiki(repoDir: string, opts: InitWikiOptions): InitWikiReport;
+/**
+ * Append wiki drift entries to .gitignore if missing.
+ *
+ * Returns true when at least one line was appended.
+ * Creates .gitignore if not present.
+ */
+export declare function ensureGitignoreEntries(repoDir: string): boolean;
+//# sourceMappingURL=scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/scaffold.ts"],"names":[],"mappings":"AAyIA,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,wDAAwD;IACxD,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,8BAA8B;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,cAAc,CAiD/E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAsC/D"}

package/dist/core/wiki/scaffold.js

@@ -0,0 +1,223 @@
+/**
+ * @module        core/wiki/scaffold
+ * @description   `sps wiki init` 的物理脚手架：建目录、写模板、安装 .gitignore 条目
+ *
+ * @layer         core
+ *
+ * doc-28 §4 目录结构 + §3 三层架构（per-repo）的实施面。
+ *
+ * 设计原则：
+ *   - **幂等**：重复跑不破坏现有内容
+ *   - **不覆盖**：所有写入前先 existsSync 检查
+ *   - **单向同步 .gitignore**：只 append 缺失行，不重排已有内容
+ *
+ * 失败模式：mkdir 失败 → throw（让命令层报错）。
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { wikiAttachmentsDir, wikiDir, wikiHotFile, wikiIndexFile, wikiMetaFile, wikiOverviewFile, wikiPageDir, wikiRawDir, } from '../../shared/wikiPaths.js';
+// ─── Constants ────────────────────────────────────────────────────
+const ALL_PAGE_TYPES = [
+    'module',
+    'concept',
+    'decision',
+    'lesson',
+    'source',
+];
+/** Lines that wiki ownership requires in .gitignore */
+const GITIGNORE_LINES = [
+    '# Wiki per-instance drift (added by sps wiki init)',
+    'wiki/.hot.md',
+    'wiki/.log.md',
+    'wiki/.manifest.json',
+];
+/**
+ * Default WIKI.md template. Contains schema version + sources config.
+ * Worker reads `sources:` to know what to ingest.
+ */
+function wikiMetaTemplate(projectName, today) {
+    return `---
+type: meta
+title: ${projectName} Wiki
+version: 1
+created: ${today}
+updated: ${today}
+sources:
+  code:
+    - "src/**/*.ts"
+  doc:
+    - "docs/**/*.md"
+    - "README.md"
+  raw:
+    - "wiki/.raw/**/*"
+---
+
+# ${projectName} Wiki
+
+Project knowledge base. See [doc-28](../docs/design/28-wiki-system.md) for design.
+
+## Page Types
+
+- **modules/** — Code modules / services (auto-derived from \`src/\`)
+- **concepts/** — Domain concepts and patterns
+- **decisions/** — Architecture decisions
+- **lessons/** — Bug post-mortems and gotchas
+- **sources/** — External references (PDFs, articles, transcripts)
+
+## Workflow
+
+\`\`\`bash
+sps wiki update <project>          # ingest source diff via Worker + skill
+sps wiki read <project> "query"    # 5-layer retrieval for prompt injection
+\`\`\`
+`;
+}
+const INDEX_PLACEHOLDER = `---
+type: meta
+title: Wiki Index
+updated: 1970-01-01T00:00:00Z
+---
+
+# Wiki Index
+
+(empty — run \`sps wiki update\` to ingest sources)
+`;
+const OVERVIEW_TEMPLATE = (projectName, today) => `---
+type: meta
+title: ${projectName} Overview
+created: ${today}
+updated: ${today}
+---
+
+# ${projectName} Overview
+
+(autogenerated summary — first \`sps wiki update\` will fill this in)
+`;
+const HOT_PLACEHOLDER = `---
+type: meta
+title: Hot Cache
+updated: 1970-01-01T00:00:00Z
+---
+
+# Recent Context
+
+## Last Updated
+（尚无活动。第一次 \`sps wiki update\` 或卡片完成后会自动填充。）
+
+## Key Recent Facts
+（none yet）
+
+## Recent Changes
+（none yet）
+
+## Active Threads
+（none yet）
+`;
+/**
+ * Idempotently scaffold wiki/ in the given repo.
+ *
+ * Creates:
+ *   - wiki/, wiki/{modules,concepts,decisions,lessons,sources}/, wiki/.raw/, wiki/_attachments/
+ *   - wiki/WIKI.md, wiki/index.md, wiki/overview.md, wiki/.hot.md
+ *   - .gitignore: appends per-instance drift entries if missing
+ *
+ * Does NOT write .manifest.json — that's owned by `sps wiki update` and is empty
+ * until first ingest.
+ *
+ * Re-runnable safely: existing files are preserved.
+ */
+export function initWiki(repoDir, opts) {
+    const today = opts.today ?? new Date().toISOString().slice(0, 10);
+    const created = [];
+    const filesWritten = [];
+    const filesSkipped = [];
+    // 1) Subdirs
+    const dirs = [
+        wikiDir(repoDir),
+        ...ALL_PAGE_TYPES.map((t) => wikiPageDir(repoDir, t)),
+        wikiRawDir(repoDir),
+        wikiAttachmentsDir(repoDir),
+    ];
+    for (const d of dirs) {
+        if (!existsSync(d)) {
+            mkdirSync(d, { recursive: true });
+            created.push(d);
+        }
+    }
+    // 2) Templated files (don't overwrite existing user content)
+    const templated = [
+        [wikiMetaFile(repoDir), wikiMetaTemplate(opts.projectName, today)],
+        [wikiIndexFile(repoDir), INDEX_PLACEHOLDER],
+        [wikiOverviewFile(repoDir), OVERVIEW_TEMPLATE(opts.projectName, today)],
+        [wikiHotFile(repoDir), HOT_PLACEHOLDER],
+    ];
+    for (const [path, body] of templated) {
+        if (existsSync(path)) {
+            filesSkipped.push(path);
+        }
+        else {
+            writeFileSync(path, body, { encoding: 'utf-8', mode: 0o644 });
+            filesWritten.push(path);
+        }
+    }
+    // 3) .gitignore — only append missing lines
+    let gitignoreUpdated = false;
+    if (!opts.skipGitignore) {
+        gitignoreUpdated = ensureGitignoreEntries(repoDir);
+    }
+    return {
+        wikiDir: wikiDir(repoDir),
+        created,
+        filesWritten,
+        filesSkipped,
+        gitignoreUpdated,
+    };
+}
+/**
+ * Append wiki drift entries to .gitignore if missing.
+ *
+ * Returns true when at least one line was appended.
+ * Creates .gitignore if not present.
+ */
+export function ensureGitignoreEntries(repoDir) {
+    const gitignorePath = resolve(repoDir, '.gitignore');
+    let existing = '';
+    if (existsSync(gitignorePath)) {
+        existing = readFileSync(gitignorePath, 'utf-8');
+    }
+    const existingLines = new Set(existing.split('\n').map((l) => l.trim()));
+    const toAppend = [];
+    for (const line of GITIGNORE_LINES) {
+        // skip comment header if any drift line already present (we don't want to
+        // re-add the comment if user organized their .gitignore)
+        if (line.startsWith('#'))
+            continue;
+        if (!existingLines.has(line)) {
+            toAppend.push(line);
+        }
+    }
+    if (toAppend.length === 0)
+        return false;
+    // If .gitignore is brand new or empty, include the comment header.
+    const block = [];
+    const needsHeader = !existing.includes('# Wiki per-instance drift');
+    if (existing.length > 0 && !existing.endsWith('\n'))
+        block.push('');
+    if (existing.length > 0)
+        block.push('');
+    if (needsHeader)
+        block.push(GITIGNORE_LINES[0]);
+    block.push(...toAppend);
+    block.push(''); // trailing newline
+    if (existsSync(gitignorePath)) {
+        appendFileSync(gitignorePath, block.join('\n'), { encoding: 'utf-8' });
+    }
+    else {
+        writeFileSync(gitignorePath, block.join('\n').replace(/^\n+/, ''), {
+            encoding: 'utf-8',
+            mode: 0o644,
+        });
+    }
+    return true;
+}
+//# sourceMappingURL=scaffold.js.map

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

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

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

@@ -0,0 +1,73 @@
+/**
+ * @module        core/wiki/searcher
+ * @description   Wiki BM25F 全文检索（field-weighted Best Matching 25）
+ *
+ * @layer         core
+ *
+ * 实现选择：
+ *   - **不**用 lunr.js / minisearch / fuse.js —— 多一个 50KB 依赖不值得
+ *   - **不**做词干提取（stemming）—— SPS 是技术文档库，词形变化少；stemming
+ *     反而把 "Pipeline" 和 "PipelineService" 合并成同一 token，丢辨别力
+ *   - **不**做向量 embedding —— v0 BM25 够用；v1 视召回率决定
+ *
+ * BM25F 通过 field tiling 实现：title 3x / tags 2x / tldr 2x / body 1x
+ * 加权方式 = 该 field 内 token 重复 n 次（等价于 BM25F 的 boosting）。
+ *
+ * 中文支持：ASCII 按词切；中文按字切（朴素 unigram）。够用且无外部依赖。
+ *
+ * 数据规模：项目 wiki 一般 < 1000 page，~MB 级 corpus。in-memory 索引
+ * 占用几 MB，构建 < 100ms，查询 < 10ms。不需要持久化（每次进程启动重建）。
+ */
+import type { Page, PageType } from './types.js';
+export interface BM25Options {
+    /** 词频饱和参数；标准值 1.2-2.0 */
+    k1?: number;
+    /** 长度归一化；0=关 / 0.75=标准 / 1=最大归一 */
+    b?: number;
+    /** 各字段权重 */
+    fieldWeights?: {
+        title?: number;
+        tags?: number;
+        tldr?: number;
+        body?: number;
+    };
+}
+export declare function tokenize(text: string): string[];
+export interface IndexedDoc {
+    readonly pageId: string;
+    readonly title: string;
+    readonly tags: readonly string[];
+    /** 第一段（## TL;DR 之后到下个 ## 之前）；用作字段权重 + 返回值预览 */
+    readonly tldr: string;
+    /** Body 剩余部分（除 TL;DR 之外） */
+    readonly body: string;
+    readonly type: PageType;
+}
+/**
+ * 从 Page 对象抽 IndexedDoc。
+ * TL;DR 提取规则：找 `## TL;DR\n...\n##` 之间的内容；找不到取 body 前 200 字符。
+ */
+export declare function pageToIndexed(page: Page): IndexedDoc;
+export declare function extractTLDR(body: string): string;
+export interface SearchResult {
+    readonly pageId: string;
+    readonly score: number;
+}
+export declare class WikiSearcher {
+    readonly docs: readonly IndexedDoc[];
+    private readonly opts;
+    private readonly postings;
+    private readonly docLengths;
+    private readonly avgDocLength;
+    constructor(docs: readonly IndexedDoc[], opts?: BM25Options);
+    /**
+     * 全字段加权的 token stream。同一个 token 在 title 出现一次 = title weight 个副本。
+     */
+    private tokenizeDoc;
+    search(query: string, limit?: number): SearchResult[];
+    /** 按 tag 集合过滤（OR 语义）—— 用于 reader.ts 的 skill-match layer */
+    searchByTags(tags: readonly string[], limit?: number): SearchResult[];
+    /** 按 type 列出（不打分；reader.ts 排序用） */
+    byType(type: PageType): IndexedDoc[];
+}
+//# sourceMappingURL=searcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searcher.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/searcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,YAAY,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAqED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAW/C;AAID,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CASpD;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAID,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAID,qBAAa,YAAY;aASL,IAAI,EAAE,SAAS,UAAU,EAAE;IAR7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAEnB;IACF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGpB,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3C,IAAI,GAAE,WAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE;IA2BjD,2DAA2D;IAC3D,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE;IAejE,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE;CAGrC"}

package/dist/core/wiki/searcher.js

@@ -0,0 +1,216 @@
+const DEFAULT_OPTS = {
+    k1: 1.5,
+    b: 0.75,
+    fieldWeights: { title: 3, tags: 2, tldr: 2, body: 1 },
+};
+// ─── Tokenization ─────────────────────────────────────────────────
+/**
+ * 把文本切成 token：
+ *   - ASCII 单词组（含数字、`_`、`-`），≥ 2 字符
+ *   - 单个汉字
+ *   - lowercase 归一化
+ *   - 去 stop words
+ *
+ * **不**做 stemming（pipelining → pipeline）—— SPS 文档技术词多，stemming
+ * 引入更多噪声而不是信号。
+ */
+const STOP_WORDS = new Set([
+    // English stop words
+    'a',
+    'an',
+    'and',
+    'are',
+    'as',
+    'at',
+    'be',
+    'but',
+    'by',
+    'do',
+    'for',
+    'has',
+    'have',
+    'in',
+    'is',
+    'it',
+    'its',
+    'of',
+    'on',
+    'or',
+    'that',
+    'the',
+    'this',
+    'to',
+    'was',
+    'were',
+    'will',
+    'with',
+    // Chinese stop words (常见高频虚词)
+    '的',
+    '了',
+    '是',
+    '和',
+    '或',
+    '在',
+    '有',
+    '我',
+    '你',
+    '他',
+    '它',
+    '这',
+    '那',
+    '与',
+]);
+const TOKEN_RE = /[a-z0-9_-]{2,}|[一-鿿]/g;
+export function tokenize(text) {
+    if (!text)
+        return [];
+    const lower = text.toLowerCase();
+    const tokens = [];
+    const matches = lower.matchAll(TOKEN_RE);
+    for (const m of matches) {
+        const t = m[0];
+        if (STOP_WORDS.has(t))
+            continue;
+        tokens.push(t);
+    }
+    return tokens;
+}
+/**
+ * 从 Page 对象抽 IndexedDoc。
+ * TL;DR 提取规则：找 `## TL;DR\n...\n##` 之间的内容；找不到取 body 前 200 字符。
+ */
+export function pageToIndexed(page) {
+    return {
+        pageId: page.pageId,
+        title: page.frontmatter.title,
+        tags: page.frontmatter.tags,
+        tldr: extractTLDR(page.body),
+        body: page.body,
+        type: page.frontmatter.type,
+    };
+}
+const TLDR_RE = /^##\s+TL;DR\s*\r?\n([\s\S]*?)(?=\r?\n##\s+|\s*$)/m;
+export function extractTLDR(body) {
+    const m = body.match(TLDR_RE);
+    if (m)
+        return m[1].trim();
+    // Fallback：第一个段落或前 200 字
+    const firstPara = body.split(/\n\s*\n/)[0]?.trim() ?? '';
+    return firstPara.slice(0, 200);
+}
+// ─── BM25F searcher ───────────────────────────────────────────────
+export class WikiSearcher {
+    docs;
+    opts;
+    postings = new Map();
+    docLengths = [];
+    avgDocLength;
+    constructor(docs, opts = {}) {
+        this.docs = docs;
+        this.opts = mergeOpts(opts);
+        let totalLen = 0;
+        for (let i = 0; i < docs.length; i++) {
+            const tokens = this.tokenizeDoc(docs[i]);
+            const tf = countTF(tokens);
+            for (const [term, count] of tf) {
+                let pl = this.postings.get(term);
+                if (!pl) {
+                    pl = new Map();
+                    this.postings.set(term, pl);
+                }
+                pl.set(i, count);
+            }
+            this.docLengths[i] = tokens.length;
+            totalLen += tokens.length;
+        }
+        this.avgDocLength = docs.length > 0 ? totalLen / docs.length : 1;
+    }
+    /**
+     * 全字段加权的 token stream。同一个 token 在 title 出现一次 = title weight 个副本。
+     */
+    tokenizeDoc(doc) {
+        const w = this.opts.fieldWeights;
+        return [
+            ...repeat(tokenize(doc.title), w.title),
+            ...repeat(tokenize(doc.tags.join(' ')), w.tags),
+            ...repeat(tokenize(doc.tldr), w.tldr),
+            ...repeat(tokenize(doc.body), w.body),
+        ];
+    }
+    search(query, limit = 10) {
+        const queryTerms = unique(tokenize(query));
+        if (queryTerms.length === 0 || this.docs.length === 0)
+            return [];
+        const scores = new Map();
+        const N = this.docs.length;
+        for (const term of queryTerms) {
+            const postings = this.postings.get(term);
+            if (!postings)
+                continue;
+            const df = postings.size;
+            const idf = Math.log((N - df + 0.5) / (df + 0.5) + 1);
+            for (const [docIdx, tf] of postings) {
+                const docLen = this.docLengths[docIdx];
+                const norm = 1 - this.opts.b + this.opts.b * (docLen / this.avgDocLength);
+                const tfPart = (tf * (this.opts.k1 + 1)) / (tf + this.opts.k1 * norm);
+                const contribution = idf * tfPart;
+                scores.set(docIdx, (scores.get(docIdx) ?? 0) + contribution);
+            }
+        }
+        return [...scores.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, limit)
+            .map(([idx, score]) => ({ pageId: this.docs[idx].pageId, score }));
+    }
+    /** 按 tag 集合过滤（OR 语义）—— 用于 reader.ts 的 skill-match layer */
+    searchByTags(tags, limit = 10) {
+        if (tags.length === 0)
+            return [];
+        const tagSet = new Set(tags.map((t) => t.toLowerCase()));
+        const matches = [];
+        for (let i = 0; i < this.docs.length; i++) {
+            const doc = this.docs[i];
+            const overlap = doc.tags.filter((t) => tagSet.has(t.toLowerCase())).length;
+            if (overlap > 0) {
+                // 命中 tag 多 = 分数高
+                matches.push({ pageId: doc.pageId, score: overlap });
+            }
+        }
+        return matches.sort((a, b) => b.score - a.score).slice(0, limit);
+    }
+    /** 按 type 列出（不打分；reader.ts 排序用） */
+    byType(type) {
+        return this.docs.filter((d) => d.type === type);
+    }
+}
+// ─── Pure helpers ─────────────────────────────────────────────────
+function countTF(tokens) {
+    const m = new Map();
+    for (const t of tokens)
+        m.set(t, (m.get(t) ?? 0) + 1);
+    return m;
+}
+function repeat(arr, n) {
+    if (n <= 1)
+        return arr.slice();
+    const out = [];
+    for (let i = 0; i < n; i++)
+        out.push(...arr);
+    return out;
+}
+function unique(arr) {
+    return [...new Set(arr)];
+}
+function mergeOpts(input) {
+    return {
+        k1: input.k1 ?? DEFAULT_OPTS.k1,
+        b: input.b ?? DEFAULT_OPTS.b,
+        fieldWeights: {
+            title: input.fieldWeights?.title ?? DEFAULT_OPTS.fieldWeights.title,
+            tags: input.fieldWeights?.tags ?? DEFAULT_OPTS.fieldWeights.tags,
+            tldr: input.fieldWeights?.tldr ?? DEFAULT_OPTS.fieldWeights.tldr,
+            body: input.fieldWeights?.body ?? DEFAULT_OPTS.fieldWeights.body,
+        },
+    };
+}
+//# sourceMappingURL=searcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searcher.js","sourceRoot":"","sources":["../../../src/core/wiki/searcher.ts"],"names":[],"mappings":"AAsCA,MAAM,YAAY,GAAG;IACnB,EAAE,EAAE,GAAG;IACP,CAAC,EAAE,IAAI;IACP,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;CACb,CAAC;AAE3C,qEAAqE;AAErE;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,qBAAqB;IACrB,GAAG;IACH,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,KAAK;IACL,MAAM;IACN,IAAI;IACJ,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,8BAA8B;IAC9B,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;CACJ,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,uBAAuB,CAAC;AAEzC,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACf,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAChC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAeD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK;QAC7B,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;QAC3B,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAG,mDAAmD,CAAC;AAEpE,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IAC3B,yBAAyB;IACzB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AASD,qEAAqE;AAErE,MAAM,OAAO,YAAY;IASL;IARD,IAAI,CAEnB;IACe,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IAClD,UAAU,GAAa,EAAE,CAAC;IAC1B,YAAY,CAAS;IAEtC,YACkB,IAA2B,EAC3C,OAAoB,EAAE;QADN,SAAI,GAAJ,IAAI,CAAuB;QAG3C,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YAC1C,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC/B,IAAI,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACjC,IAAI,CAAC,EAAE,EAAE,CAAC;oBACR,EAAE,GAAG,IAAI,GAAG,EAAE,CAAC;oBACf,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9B,CAAC;gBACD,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACnB,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YACnC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,GAAe;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;QACjC,OAAO;YACL,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;YACvC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;YAC/C,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;YACrC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;SACtC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;QAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEjE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAE3B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACtD,KAAK,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC1E,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;gBACtE,MAAM,YAAY,GAAG,GAAG,GAAG,MAAM,CAAC;gBAClC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;aACzB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAE,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,2DAA2D;IAC3D,YAAY,CAAC,IAAuB,EAAE,KAAK,GAAG,EAAE;QAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YAC3E,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,iBAAiB;gBACjB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACnE,CAAC;IAED,mCAAmC;IACnC,MAAM,CAAC,IAAc;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAClD,CAAC;CACF;AAED,qEAAqE;AAErE,SAAS,OAAO,CAAC,MAAyB;IACxC,MAAM,CAAC,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,MAAM,CAAI,GAAiB,EAAE,CAAS;IAC7C,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,MAAM,CAAI,GAAiB;IAClC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,SAAS,CAAC,KAAkB;IAGnC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,YAAY,CAAC,EAAE;QAC/B,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC;QAC5B,YAAY,EAAE;YACZ,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,IAAI,YAAY,CAAC,YAAY,CAAC,KAAK;YACnE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI;YAChE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI;YAChE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI;SACjE;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,84 @@
+import type { Manifest, SourceDiff } from './types.js';
+/** WIKI.md sources 字段定义的 4 个 bucket */
+export type SourceCategory = 'code' | 'doc' | 'raw' | 'data';
+export interface DiscoveredSource {
+    /** Path relative to repoDir, posix-style */
+    readonly path: string;
+    /** Which sources bucket the file belongs to */
+    readonly category: SourceCategory;
+    /** sha256 hex; computed lazily by callers (use hashSource) */
+    readonly hash?: string;
+}
+export interface SourcesConfig {
+    /** Globs per bucket; absent bucket = empty array */
+    readonly code: readonly string[];
+    readonly doc: readonly string[];
+    readonly raw: readonly string[];
+    readonly data: readonly string[];
+}
+/**
+ * 从 WIKI.md 顶部 frontmatter 抽 sources 配置。
+ *
+ * 容错：
+ *   - WIKI.md 不存在 → 返默认（空配置）
+ *   - frontmatter 缺失 / sources 字段缺失 → 返默认
+ *   - 类型不对（非数组 / 非字符串）→ 跳过该 bucket
+ */
+export declare function readSourcesConfig(repoDir: string): SourcesConfig;
+interface ParsedPattern {
+    /** Anchor directory relative to repoDir (no trailing slash) */
+    readonly base: string;
+    /** Should match recursively? (true if pattern contains ** ) */
+    readonly recursive: boolean;
+    /** Optional file extension filter (e.g. ".ts"); '' for all files */
+    readonly extension: string;
+    /** Original pattern (for debug) */
+    readonly raw: string;
+}
+/**
+ * Parse a simple glob pattern into base + recursion + extension filter.
+ *
+ * Examples:
+ *   "src/**\/*.ts"  → base=src,  recursive=true,  ext=.ts
+ *   "src/**"        → base=src,  recursive=true,  ext=''
+ *   "docs/*.md"     → base=docs, recursive=false, ext=.md
+ *   "README.md"     → base=.,    recursive=false, ext=.md  (treated as flat single)
+ *
+ * Unsupported patterns (e.g. with `{}`) are passed through but won't match anything.
+ */
+export declare function parsePattern(pattern: string): ParsedPattern;
+/**
+ * Walk filesystem from `repoDir/<base>` and collect files that match the pattern.
+ *
+ * - Skips dotfiles starting with `.` UNLESS the base itself starts with `.`
+ *   (e.g. wiki/.raw/** — user wants those).
+ * - Always skips node_modules / .git anywhere in the tree.
+ *
+ * Returns paths relative to repoDir, posix-normalized.
+ */
+export declare function expandPattern(repoDir: string, pattern: string): string[];
+export interface DiscoverResult {
+    /** Discovered sources with hashes */
+    readonly sources: readonly DiscoveredSource[];
+    /** Patterns that returned 0 files (warning candidates) */
+    readonly emptyPatterns: readonly string[];
+}
+/**
+ * Discover all sources from WIKI.md config + hash them.
+ *
+ * Buckets are merged; if the same path is matched by multiple buckets, the first
+ * winning bucket (in code → doc → data → raw order) is used.
+ *
+ * Caller is responsible for I/O fault tolerance — this throws on individual hash
+ * failures only via `tryHashFile` semantics (skip).
+ */
+export declare function discoverSources(repoDir: string): DiscoverResult;
+/**
+ * Compute diff between current discovered sources and saved manifest.
+ *
+ * Wraps diffSources() with a typed input so callers don't have to remember
+ * the DiffInputSource shape.
+ */
+export declare function diffAgainstManifest(sources: readonly DiscoveredSource[], manifest: Manifest): SourceDiff;
+export {};
+//# sourceMappingURL=sources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/sources.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIvD,uCAAuC;AACvC,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAID;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA2BhE;AASD,UAAU,aAAa;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAgC3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsCxE;AAqDD,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAuC/D;AAID;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,QAAQ,EAAE,QAAQ,GACjB,UAAU,CAKZ"}