@coralai/sps-cli 0.56.2 → 0.57.0

package/dist/core/wiki/index-builder.js

@@ -1,130 +0,0 @@
-/**
- * @module        core/wiki/index-builder
- * @description   渲染 wiki/index.md：全部 page 的 catalog，按类型分组
- *
- * @layer         core
- *
- * doc-28 §10：reader 5 层注入策略里"index 节选 top-30 行"是 Worker prompt
- * 知识地图来源——所以 index.md 必须**密集且 LLM-friendly**：
- *   - 每条一行：`- [[type/Title]]: TL;DR 摘要`
- *   - 按类型分组（### Modules / ### Concepts / ### Lessons / ...）
- *   - 不写废话头（无引子、无 stats 表格之类）
- *
- * 重建时机：每次 ingest / write 后调用一次（cheap，纯函数+1 次 writeFile）。
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname } from 'node:path';
-import { wikiIndexFile } from '../../shared/wikiPaths.js';
-import { extractTLDR } from './searcher.js';
-// ─── Render ───────────────────────────────────────────────────────
-const SECTIONS = [
-    { type: 'module', label: 'Modules' },
-    { type: 'concept', label: 'Concepts' },
-    { type: 'decision', label: 'Decisions' },
-    { type: 'lesson', label: 'Lessons' },
-    { type: 'source', label: 'Sources' },
-];
-/**
- * 从 page 列表渲染 index.md 完整内容。
- *
- * 输出形如：
- * ```md
- * ---
- * type: meta
- * title: Wiki Index
- * updated: 2026-04-27
- * ---
- *
- * # Wiki Index
- *
- * Pages: 12 · Updated 2026-04-27
- *
- * ## Modules (3)
- * - [[modules/PipelineService]]: TL;DR 摘要短句...
- * - ...
- *
- * ## Lessons (4)
- * - [[lessons/Stop Hook Race]]: ...
- * ```
- */
-export function renderIndex(pages, opts = {}) {
-    const ts = opts.updatedAt ?? new Date().toISOString().slice(0, 10);
-    const total = pages.length;
-    const lines = [
-        '---',
-        'type: meta',
-        'title: Wiki Index',
-        `updated: ${ts}`,
-        '---',
-        '',
-        '# Wiki Index',
-        '',
-        `Pages: ${total} · Updated ${ts}`,
-        '',
-    ];
-    for (const section of SECTIONS) {
-        const inSection = pages.filter((p) => p.frontmatter.type === section.type);
-        if (inSection.length === 0)
-            continue;
-        lines.push(`## ${section.label} (${inSection.length})`);
-        // 按 title 字典序排
-        const sorted = inSection.slice().sort((a, b) => a.frontmatter.title.localeCompare(b.frontmatter.title, 'en'));
-        for (const page of sorted) {
-            const tldr = extractTLDR(page.body);
-            const oneliner = squashToOneLine(tldr, 120);
-            lines.push(`- [[${page.pageId}]]: ${oneliner}`);
-        }
-        lines.push('');
-    }
-    if (total === 0) {
-        lines.push('（empty—— run `sps wiki update` to populate）');
-        lines.push('');
-    }
-    return lines.join('\n');
-}
-/**
- * 写 index.md（全量重建）。
- */
-export function writeIndex(repoDir, pages) {
-    const path = wikiIndexFile(repoDir);
-    const dir = dirname(path);
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    const content = renderIndex(pages);
-    writeFileSync(path, content, { encoding: 'utf-8', mode: 0o644 });
-}
-/**
- * 取 index.md 节选 top-N 行（不含 frontmatter）。
- * 给 reader.ts 的 Layer 2 用——总是注入这一段。
- */
-export function readIndexSummary(repoDir, maxLines = 30) {
-    const path = wikiIndexFile(repoDir);
-    if (!existsSync(path))
-        return '';
-    let content;
-    try {
-        content = readFileSync(path, 'utf-8');
-    }
-    catch {
-        return '';
-    }
-    // strip frontmatter
-    const body = content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, '').trim();
-    const lines = body.split('\n');
-    // 跳过 # Wiki Index 标题 + 空行
-    const start = lines.findIndex((l) => l.startsWith('## '));
-    if (start === -1)
-        return body.split('\n').slice(0, maxLines).join('\n');
-    return lines.slice(start, start + maxLines).join('\n');
-}
-// ─── helpers ──────────────────────────────────────────────────────
-/**
- * 把 TL;DR 拍扁成一行 + 截短。给 Worker prompt 注入用——不能多行。
- */
-function squashToOneLine(text, maxLen) {
-    const flat = text.replace(/\s+/g, ' ').trim();
-    if (flat.length <= maxLen)
-        return flat;
-    return flat.slice(0, maxLen - 1) + '…';
-}
-//# sourceMappingURL=index-builder.js.map

package/dist/core/wiki/index-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-builder.js","sourceRoot":"","sources":["../../../src/core/wiki/index-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,qEAAqE;AAErE,MAAM,QAAQ,GAA6C;IACzD,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;IACpC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE;IACtC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE;IACxC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;IACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAsB,EAAE,OAA+B,EAAE;IACnF,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAE3B,MAAM,KAAK,GAAa;QACtB,KAAK;QACL,YAAY;QACZ,mBAAmB;QACnB,YAAY,EAAE,EAAE;QAChB,KAAK;QACL,EAAE;QACF,cAAc;QACd,EAAE;QACF,UAAU,KAAK,cAAc,EAAE,EAAE;QACjC,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACrC,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QACxD,eAAe;QACf,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC7C,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAC7D,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,OAAO,QAAQ,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,KAAsB;IAChE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,QAAQ,GAAG,EAAE;IAC7D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,oBAAoB;IACpB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,0BAA0B;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,qEAAqE;AAErE;;GAEG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,MAAc;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AACzC,CAAC"}

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

@@ -1,76 +0,0 @@
-import type { Manifest, Page } from './types.js';
-export type IssueKind = 'orphan' | 'dead-link' | 'fm-gap' | 'stale';
-export type IssueSeverity = 'warn' | 'error';
-export interface LintIssue {
-    readonly kind: IssueKind;
-    readonly severity: IssueSeverity;
-    /** Page id where issue was found; null when issue is repo-level (e.g. stale source) */
-    readonly pageId: string | null;
-    /** One-line message */
-    readonly message: string;
-    /** Optional context: target page id / source path / field name */
-    readonly target?: string;
-}
-export interface LintReport {
-    readonly issues: readonly LintIssue[];
-    /** Counts grouped by kind for fast summary */
-    readonly counts: Record<IssueKind, number>;
-    readonly errorCount: number;
-    readonly warnCount: number;
-}
-export interface LintInput {
-    readonly pages: readonly Page[];
-    readonly manifest: Manifest;
-    readonly repoDir: string;
-}
-export declare function lintWiki(input: LintInput): LintReport;
-/**
- * Orphan = page that nobody links to (via frontmatter related[] OR body wikilink).
- *
- * A solo page can still be valuable (e.g. just-written lesson) — orphan is **warn**,
- * not error.
- */
-export declare function checkOrphans(pages: readonly Page[]): LintIssue[];
-/**
- * Dead link = wikilink "[[X]]" where X (resolved) is not in the page set.
- *
- * Errors for related[] (frontmatter); warnings for body links (in-flight writing).
- */
-export declare function checkDeadLinks(pages: readonly Page[]): LintIssue[];
-/**
- * Catches missing soft-required fields the zod schema can't enforce
- * (e.g. empty title, empty TL;DR, all default tags). Schema-level errors
- * are caught at parse time — this is a content sniff.
- */
-export declare function checkFrontmatterGaps(pages: readonly Page[]): LintIssue[];
-/**
- * Compare manifest's stored sha256 against current file hash on disk.
- * Mismatch = source has drifted since last ingest → its derived pages may be stale.
- *
- * Files that don't exist on disk anymore are flagged as 'stale' too (they should
- * be removed from manifest via finalize).
- */
-export declare function checkStaleSources(manifest: Manifest, repoDir: string): LintIssue[];
-/**
- * Resolve a "[[X]]" or "[[type/X]]" wikilink against the known pageId set.
- *
- * Strategy:
- *   - "[[type/X]]" → look up exact pageId
- *   - "[[X]]" → look up any pageId ending with "/X" (any type matches)
- *
- * Returns the resolved pageId, or null if unresolvable.
- */
-export declare function resolveLinkToId(wikilink: string, ids: ReadonlySet<string>): string | null;
-export declare function extractBodyWikilinks(body: string): string[];
-/**
- * Compare source mtime vs page mtime. Returns paths whose source is newer.
- *
- * Best-effort — file mtime precision varies (ext4 ns vs HFS+ 1s); we use a
- * 60s threshold to avoid false positives.
- */
-export declare function findOutdatedPages(manifest: Manifest, pages: readonly Page[], repoDir: string, thresholdMs?: number): {
-    sourcePath: string;
-    pageIds: string[];
-    sourceMtime: Date;
-}[];
-//# sourceMappingURL=linter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/linter.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAID,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAOrD;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,EAAE,CA+BhE;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,EAAE,CA4BlE;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,EAAE,CAiCxE;AAID;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CA4BlF;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GACvB,MAAM,GAAG,IAAI,CAaf;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAM3D;AA0BD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,OAAO,EAAE,MAAM,EACf,WAAW,SAAS,GACnB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,IAAI,CAAA;CAAE,EAAE,CA4BhE"}

package/dist/core/wiki/linter.js

@@ -1,280 +0,0 @@
-/**
- * @module        core/wiki/linter
- * @description   Wiki lint：orphan / dead link / frontmatter gap / stale 检查
- *
- * @layer         core
- *
- * doc-28 §10 wiki check 的代码实现。纯函数（除文件 mtime 读取）：给一组 Page +
- * manifest，返一份 Report。
- *
- * 四类问题：
- *   - orphan       — 页未被任何其他页 related[] 或 body wikilink 引用
- *   - dead-link    — wikilink 指向不存在的 page
- *   - fm-gap       — frontmatter 缺关键字段（其实 zod schema 已校验，这里防漏）
- *   - stale        — manifest 里 source 的 hash 跟当前文件不一致（content drift）
- *
- * 不做：
- *   - 自动修复（删 dead link、合并 orphan）—— 安全交给人决定
- *   - 跨项目检查
- */
-import { existsSync, statSync } from 'node:fs';
-import { resolve } from 'node:path';
-import { tryHashFile } from './manifest.js';
-export function lintWiki(input) {
-    const issues = [];
-    issues.push(...checkOrphans(input.pages));
-    issues.push(...checkDeadLinks(input.pages));
-    issues.push(...checkFrontmatterGaps(input.pages));
-    issues.push(...checkStaleSources(input.manifest, input.repoDir));
-    return summarize(issues);
-}
-// ─── Orphan detection ────────────────────────────────────────────
-/**
- * Orphan = page that nobody links to (via frontmatter related[] OR body wikilink).
- *
- * A solo page can still be valuable (e.g. just-written lesson) — orphan is **warn**,
- * not error.
- */
-export function checkOrphans(pages) {
-    const ids = new Set(pages.map((p) => p.pageId));
-    const refCount = new Map();
-    for (const id of ids)
-        refCount.set(id, 0);
-    for (const p of pages) {
-        // related[] is wikilinks "[[Page Name]]" — strip brackets and check both
-        // bare-title and "type/title" forms against ids.
-        for (const link of p.frontmatter.related) {
-            const target = resolveLinkToId(link, ids);
-            if (target)
-                refCount.set(target, (refCount.get(target) ?? 0) + 1);
-        }
-        // Body wikilinks
-        for (const link of extractBodyWikilinks(p.body)) {
-            const target = resolveLinkToId(`[[${link}]]`, ids);
-            if (target)
-                refCount.set(target, (refCount.get(target) ?? 0) + 1);
-        }
-    }
-    const out = [];
-    for (const [pageId, count] of refCount) {
-        if (count === 0) {
-            out.push({
-                kind: 'orphan',
-                severity: 'warn',
-                pageId,
-                message: `Page "${pageId}" is not referenced by any other page.`,
-            });
-        }
-    }
-    return out;
-}
-// ─── Dead-link detection ─────────────────────────────────────────
-/**
- * Dead link = wikilink "[[X]]" where X (resolved) is not in the page set.
- *
- * Errors for related[] (frontmatter); warnings for body links (in-flight writing).
- */
-export function checkDeadLinks(pages) {
-    const ids = new Set(pages.map((p) => p.pageId));
-    const out = [];
-    for (const p of pages) {
-        for (const link of p.frontmatter.related) {
-            if (!resolveLinkToId(link, ids)) {
-                out.push({
-                    kind: 'dead-link',
-                    severity: 'error',
-                    pageId: p.pageId,
-                    target: link,
-                    message: `frontmatter related: "${link}" does not resolve to any page.`,
-                });
-            }
-        }
-        for (const link of extractBodyWikilinks(p.body)) {
-            if (!resolveLinkToId(`[[${link}]]`, ids)) {
-                out.push({
-                    kind: 'dead-link',
-                    severity: 'warn',
-                    pageId: p.pageId,
-                    target: link,
-                    message: `body wikilink: "[[${link}]]" does not resolve.`,
-                });
-            }
-        }
-    }
-    return out;
-}
-// ─── Frontmatter gap detection ───────────────────────────────────
-/**
- * Catches missing soft-required fields the zod schema can't enforce
- * (e.g. empty title, empty TL;DR, all default tags). Schema-level errors
- * are caught at parse time — this is a content sniff.
- */
-export function checkFrontmatterGaps(pages) {
-    const out = [];
-    for (const p of pages) {
-        const fm = p.frontmatter;
-        if (!fm.title.trim()) {
-            out.push({
-                kind: 'fm-gap',
-                severity: 'error',
-                pageId: p.pageId,
-                target: 'title',
-                message: 'frontmatter title is empty.',
-            });
-        }
-        if (fm.tags.length === 0) {
-            out.push({
-                kind: 'fm-gap',
-                severity: 'warn',
-                pageId: p.pageId,
-                target: 'tags',
-                message: 'frontmatter tags is empty (page won\'t match any skill).',
-            });
-        }
-        if (!hasTLDR(p.body)) {
-            out.push({
-                kind: 'fm-gap',
-                severity: 'warn',
-                pageId: p.pageId,
-                target: 'body',
-                message: 'body has no `## TL;DR` section (search/preview will use fallback).',
-            });
-        }
-    }
-    return out;
-}
-// ─── Stale source detection ──────────────────────────────────────
-/**
- * Compare manifest's stored sha256 against current file hash on disk.
- * Mismatch = source has drifted since last ingest → its derived pages may be stale.
- *
- * Files that don't exist on disk anymore are flagged as 'stale' too (they should
- * be removed from manifest via finalize).
- */
-export function checkStaleSources(manifest, repoDir) {
-    const out = [];
-    for (const [path, entry] of Object.entries(manifest.sources)) {
-        const abs = resolve(repoDir, path);
-        if (!existsSync(abs)) {
-            out.push({
-                kind: 'stale',
-                severity: 'warn',
-                pageId: null,
-                target: path,
-                message: `Source "${path}" no longer exists. Run \`sps wiki update <project> --finalize\` to clean.`,
-            });
-            continue;
-        }
-        const currentHash = tryHashFile(abs);
-        if (currentHash && currentHash !== entry.sha256) {
-            // Best effort: include affected pages
-            const affected = entry.pages.length > 0 ? ` (affects: ${entry.pages.join(', ')})` : '';
-            out.push({
-                kind: 'stale',
-                severity: 'warn',
-                pageId: null,
-                target: path,
-                message: `Source "${path}" has changed since ingest${affected}.`,
-            });
-        }
-    }
-    return out;
-}
-// ─── Helpers ──────────────────────────────────────────────────────
-/**
- * Resolve a "[[X]]" or "[[type/X]]" wikilink against the known pageId set.
- *
- * Strategy:
- *   - "[[type/X]]" → look up exact pageId
- *   - "[[X]]" → look up any pageId ending with "/X" (any type matches)
- *
- * Returns the resolved pageId, or null if unresolvable.
- */
-export function resolveLinkToId(wikilink, ids) {
-    const m = wikilink.match(/^\[\[([^[\]]+)\]\]$/);
-    if (!m)
-        return null;
-    const target = m[1].trim();
-    if (target.includes('/')) {
-        return ids.has(target) ? target : null;
-    }
-    // No prefix — find any pageId whose title matches
-    for (const id of ids) {
-        const slash = id.lastIndexOf('/');
-        if (slash >= 0 && id.slice(slash + 1) === target)
-            return id;
-    }
-    return null;
-}
-const BODY_LINK_RE = /\[\[([^[\]]+)\]\]/g;
-export function extractBodyWikilinks(body) {
-    const out = [];
-    for (const m of body.matchAll(BODY_LINK_RE)) {
-        out.push(m[1].trim());
-    }
-    return out;
-}
-const TLDR_RE = /^##\s+TL;DR\b/m;
-function hasTLDR(body) {
-    return TLDR_RE.test(body);
-}
-function summarize(issues) {
-    const counts = {
-        orphan: 0,
-        'dead-link': 0,
-        'fm-gap': 0,
-        stale: 0,
-    };
-    let errorCount = 0;
-    let warnCount = 0;
-    for (const i of issues) {
-        counts[i.kind] += 1;
-        if (i.severity === 'error')
-            errorCount += 1;
-        else
-            warnCount += 1;
-    }
-    return { issues: [...issues], counts, errorCount, warnCount };
-}
-// ─── Mtime helper (used by status command) ────────────────────────
-/**
- * Compare source mtime vs page mtime. Returns paths whose source is newer.
- *
- * Best-effort — file mtime precision varies (ext4 ns vs HFS+ 1s); we use a
- * 60s threshold to avoid false positives.
- */
-export function findOutdatedPages(manifest, pages, repoDir, thresholdMs = 60_000) {
-    const out = [];
-    const pageMtimeById = new Map();
-    for (const p of pages) {
-        try {
-            pageMtimeById.set(p.pageId, statSync(p.filePath).mtime);
-        }
-        catch {
-            // ignore
-        }
-    }
-    for (const [sourcePath, entry] of Object.entries(manifest.sources)) {
-        if (entry.pages.length === 0)
-            continue;
-        let sourceMtime;
-        try {
-            sourceMtime = statSync(resolve(repoDir, sourcePath)).mtime;
-        }
-        catch {
-            continue;
-        }
-        const outdated = [];
-        for (const pid of entry.pages) {
-            const pmtime = pageMtimeById.get(pid);
-            if (!pmtime)
-                continue;
-            if (sourceMtime.getTime() - pmtime.getTime() > thresholdMs)
-                outdated.push(pid);
-        }
-        if (outdated.length > 0)
-            out.push({ sourcePath, pageIds: outdated, sourceMtime });
-    }
-    return out;
-}
-//# sourceMappingURL=linter.js.map

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

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

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

@@ -1,24 +0,0 @@
-export type LogAction = 'ingest' | 'write' | 'update' | 'lint' | 'init' | 'add' | 'delete';
-export interface LogEntry {
-    action: LogAction;
-    /** 时间戳；缺省 now */
-    timestamp?: string;
-    /** Source 路径或 page id 或简短描述 */
-    target: string;
-    /** 一句话描述（≤ 100 字符） */
-    message: string;
-    /** 受影响的 page id 列表（可选） */
-    pages?: readonly string[];
-}
-/**
- * 在 log.md 顶部插入一条 entry。
- *
- * - 文件不存在：创建带 header
- * - 已有内容：保留最近 MAX_ENTRIES 条（旧的截掉）
- */
-export declare function appendLog(repoDir: string, entry: LogEntry): void;
-/**
- * 读 log.md 全文。文件不存在返默认 header。
- */
-export declare function readLog(repoDir: string): string;
-//# sourceMappingURL=log.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/log.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3F,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAwChE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ/C"}

package/dist/core/wiki/log.js

@@ -1,107 +0,0 @@
-/**
- * @module        core/wiki/log
- * @description   Wiki .log.md：操作时间序列（per-instance，gitignored）
- *
- * @layer         core
- *
- * 借鉴 claude-obsidian 的 wiki/log.md：每次 ingest / write / lint 在文件
- * 顶部追加一条事件，便于 Worker / 用户回看 "最近 wiki 怎么变的"。
- *
- * 实现选择：
- *   - 新条目**顶部追加**（最新在最前），方便 Worker 默认读前几条就看到 latest
- *   - hard cap 500 条（~5000 行），超过截尾——log 不是 audit，旧条目用 git/hot.md 找
- *   - frontmatter 固定（type=meta），不需要解析
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname } from 'node:path';
-import { wikiLogFile } from '../../shared/wikiPaths.js';
-const HEADER = `---
-type: meta
-title: Wiki Operation Log
----
-
-# Wiki Operation Log
-
-`;
-const MAX_ENTRIES = 500;
-/**
- * 在 log.md 顶部插入一条 entry。
- *
- * - 文件不存在：创建带 header
- * - 已有内容：保留最近 MAX_ENTRIES 条（旧的截掉）
- */
-export function appendLog(repoDir, entry) {
-    const path = wikiLogFile(repoDir);
-    const ts = entry.timestamp ?? new Date().toISOString();
-    const block = renderEntry({ ...entry, timestamp: ts });
-    let existing;
-    if (existsSync(path)) {
-        try {
-            existing = readFileSync(path, 'utf-8');
-        }
-        catch {
-            existing = HEADER;
-        }
-    }
-    else {
-        existing = HEADER;
-        mkdirSync(dirname(path), { recursive: true });
-    }
-    // 拆 header + 旧 entries
-    const headerEnd = existing.indexOf('# Wiki Operation Log\n');
-    let header;
-    let entries;
-    if (headerEnd === -1) {
-        header = HEADER;
-        entries = '';
-    }
-    else {
-        const afterHeader = existing.indexOf('\n', headerEnd) + 1;
-        header = existing.slice(0, afterHeader + 1);
-        entries = existing.slice(afterHeader + 1);
-    }
-    // 拆现有 entries（按 ## 开头分组），去除可能的 trailing whitespace
-    const oldBlocks = entries.split(/(?=^## )/m).filter((b) => b.trim().length > 0);
-    // 顶部插入新 block
-    const updatedBlocks = [block, ...oldBlocks];
-    // cap 数量
-    const truncated = updatedBlocks.slice(0, MAX_ENTRIES);
-    const final = header + truncated.join('') + (truncated.length === MAX_ENTRIES ? '\n…（older entries truncated）\n' : '');
-    writeFileSync(path, final, { encoding: 'utf-8', mode: 0o644 });
-}
-/**
- * 读 log.md 全文。文件不存在返默认 header。
- */
-export function readLog(repoDir) {
-    const path = wikiLogFile(repoDir);
-    if (!existsSync(path))
-        return HEADER;
-    try {
-        return readFileSync(path, 'utf-8');
-    }
-    catch {
-        return HEADER;
-    }
-}
-// ─── Render ───────────────────────────────────────────────────────
-/**
- * 单条 log entry 渲染：
- *
- * ```md
- * ## 2026-04-27T18:30:00Z · update · src/X.ts
- * 增量 ingest：3 个文件改动
- * - Pages: [[modules/X]], [[lessons/Stop Hook Race]]
- * ```
- */
-function renderEntry(entry) {
-    const lines = [];
-    lines.push(`## ${entry.timestamp} · ${entry.action} · ${entry.target}`);
-    lines.push(entry.message.trim());
-    if (entry.pages && entry.pages.length > 0) {
-        const wikilinks = entry.pages.map((p) => `[[${p}]]`).join(', ');
-        lines.push(`- Pages: ${wikilinks}`);
-    }
-    lines.push('');
-    return lines.join('\n');
-}
-//# sourceMappingURL=log.js.map

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

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