spec-wave 2.1.1

package/lib/cli-wiki.js

@@ -0,0 +1,189 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { fail, resolveTarget, takeOption } from "./cli-shared.js";
+export const WIKI_GRAPH_SCHEMA = 'harness.wiki_graph.v1';
+export function exportWikiGraph(repoRoot, options = {}) {
+    const rootRel = (options.root || 'docs/coding_wiki').replace(/^\.\/+/, '').replace(/\\/g, '/');
+    const absRoot = path.join(repoRoot, rootRel);
+    const warnings = [];
+    if (!existsSync(absRoot)) {
+        const err = new Error(`wiki 根不存在: ${rootRel}`);
+        err.code = 'wiki_root_missing';
+        throw err;
+    }
+    const files = listMarkdownFiles(absRoot);
+    const nodes = [];
+    const nodeByStem = new Map();
+    const nodeByRel = new Map();
+    for (const abs of files) {
+        const rel = path.relative(repoRoot, abs).replace(/\\/g, '/');
+        const stem = path.basename(abs, path.extname(abs));
+        const title = extractTitle(readFileSync(abs, 'utf8')) || stem;
+        const node = { id: rel, path: rel, title };
+        nodes.push(node);
+        nodeByRel.set(rel, node);
+        nodeByStem.set(stem.toLowerCase(), node);
+    }
+    const edges = [];
+    const edgeKey = new Set();
+    let skippedIllustrative = 0;
+    const pushEdge = (source, target, kind) => {
+        if (!source || !target || source === target)
+            return;
+        const key = `${source}|${target}|${kind}`;
+        if (edgeKey.has(key))
+            return;
+        edgeKey.add(key);
+        edges.push({ source, target, kind });
+    };
+    for (const abs of files) {
+        const rel = path.relative(repoRoot, abs).replace(/\\/g, '/');
+        const content = readFileSync(abs, 'utf8');
+        const dir = path.dirname(abs);
+        for (const name of extractWikilinks(content)) {
+            const target = resolveWikilink(name, nodeByStem, nodeByRel, repoRoot, dir);
+            if (target) {
+                pushEdge(rel, target, 'wikilink');
+                continue;
+            }
+            if (isIllustrativeWikilink(name)) {
+                skippedIllustrative += 1;
+                continue;
+            }
+            warnings.push(`未解析 wikilink [[${name}]] @ ${rel}`);
+        }
+        for (const href of extractMdRelLinks(content)) {
+            const targetAbs = path.resolve(dir, href.split('#')[0]);
+            if (!targetAbs.startsWith(absRoot))
+                continue;
+            if (!existsSync(targetAbs)) {
+                warnings.push(`md 链目标不存在: ${href} @ ${rel}`);
+                continue;
+            }
+            const targetRel = path.relative(repoRoot, targetAbs).replace(/\\/g, '/');
+            if (nodeByRel.has(targetRel))
+                pushEdge(rel, targetRel, 'md_link');
+        }
+    }
+    return { schema: WIKI_GRAPH_SCHEMA, root: rootRel, nodes, edges, warnings, skipped_illustrative: skippedIllustrative };
+}
+function listMarkdownFiles(dir) {
+    const out = [];
+    const walk = (d) => {
+        for (const ent of readdirSync(d, { withFileTypes: true })) {
+            if (ent.name.startsWith('.'))
+                continue;
+            const p = path.join(d, ent.name);
+            if (ent.isDirectory())
+                walk(p);
+            else if (/\.md$/i.test(ent.name))
+                out.push(p);
+        }
+    };
+    walk(dir);
+    return out.sort();
+}
+function extractTitle(content) {
+    const m = content.match(/^#\s+(.+)$/m);
+    return m ? m[1].trim() : null;
+}
+function extractWikilinks(content) {
+    const names = [];
+    const re = /\[\[([^\]|#]+)(?:\|[^\]]+)?\]\]/g;
+    let m;
+    while ((m = re.exec(content)) !== null)
+        names.push(m[1].trim());
+    return names;
+}
+function extractMdRelLinks(content) {
+    const hrefs = [];
+    const re = /\[[^\]]*\]\((\.\/[^)\s]+\.md(?:#[^)\s]*)?|\.\.\/[^)\s]+\.md(?:#[^)\s]*)?)\)/gi;
+    let m;
+    while ((m = re.exec(content)) !== null)
+        hrefs.push(m[1].trim());
+    return hrefs;
+}
+function resolveWikilink(name, nodeByStem, nodeByRel, repoRoot, fromDir) {
+    const cleaned = name.replace(/\\/g, '/').replace(/\.md$/i, '');
+    const byStem = nodeByStem.get(path.basename(cleaned).toLowerCase());
+    if (byStem)
+        return byStem.path;
+    const asRel = cleaned.replace(/^\.\/+/, '');
+    if (nodeByRel.has(asRel))
+        return asRel;
+    if (nodeByRel.has(`${asRel}.md`))
+        return `${asRel}.md`;
+    const fromRepo = path.relative(repoRoot, path.resolve(fromDir, cleaned)).replace(/\\/g, '/');
+    if (nodeByRel.has(fromRepo))
+        return fromRepo;
+    if (nodeByRel.has(`${fromRepo}.md`))
+        return `${fromRepo}.md`;
+    return null;
+}
+export function isIllustrativeWikilink(name) {
+    const n = String(name || '')
+        .trim()
+        .toLowerCase()
+        .replace(/\.md$/i, '');
+    if (!n)
+        return true;
+    if (/^(wikilink|page|name|link|title|placeholder|example|foo|bar|baz)$/i.test(n))
+        return true;
+    if (/^[.…·]+$/.test(n) || n === '...' || n === '…')
+        return true;
+    return false;
+}
+export async function cmdWiki(args) {
+    const [sub, ...rest] = args;
+    if (!sub || sub === '--help' || sub === '-h') {
+        console.log(`用法: npx spec-wave wiki export --json [--target PATH] [--root DIR] [--out FILE|-]
+`);
+        return;
+    }
+    if (sub !== 'export')
+        fail(`wiki 子命令未知: ${sub}\n用法: wiki export --json`);
+    let remaining = rest;
+    const json = remaining.includes('--json');
+    remaining = remaining.filter((a) => a !== '--json');
+    const { value: targetArg, rest: r1 } = takeOption(remaining, '--target');
+    remaining = r1;
+    const { value: rootArg, rest: r2 } = takeOption(remaining, '--root');
+    remaining = r2;
+    const { value: outArg, rest: r3 } = takeOption(remaining, '--out');
+    remaining = r3;
+    if (remaining.length > 0)
+        fail(`wiki export 未知参数: ${remaining.join(' ')}`);
+    if (!json)
+        fail('wiki export 须 --json');
+    const target = resolveTarget(process.cwd(), targetArg);
+    let graph;
+    try {
+        graph = exportWikiGraph(target, { root: rootArg });
+    }
+    catch (e) {
+        console.error(e.message || String(e));
+        fail('', 2);
+    }
+    const payload = {
+        schema: graph.schema,
+        root: graph.root,
+        nodes: graph.nodes,
+        edges: graph.edges,
+        warnings: graph.warnings,
+    };
+    const text = `${JSON.stringify(payload, null, 2)}\n`;
+    const out = outArg || '-';
+    if (out === '-')
+        process.stdout.write(text);
+    else {
+        const abs = path.resolve(process.cwd(), out);
+        mkdirSync(path.dirname(abs), { recursive: true });
+        writeFileSync(abs, text);
+        console.error(`wrote: ${abs}`);
+    }
+    if (graph.warnings.length > 0) {
+        for (const w of graph.warnings)
+            console.error(`warn: ${w}`);
+    }
+}
+//# sourceMappingURL=cli-wiki.js.map

package/lib/cli-wiki.js.map

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

package/lib/cli.d.ts

@@ -0,0 +1,22 @@
+/** 非 TTY / CI：须显式 `--tools`（对齐 OpenSpec） */
+export declare function isInteractiveInit(stdin?: {
+    isTTY?: boolean | undefined;
+}): boolean;
+export type InitToolsSelection = {
+    mode: 'none';
+} | {
+    mode: 'hosts';
+    ids: string[];
+    toolsArg: string;
+};
+/** 解析 init `--tools`；`none` 仅 init；`all`=适配表全量 */
+export declare function parseInitToolsArg(toolsArg: string, knownIds: string[]): InitToolsSelection;
+/**
+ * TTY 询问宿主选型（可注入 stdin/stdout；测用 mock Readable）。
+ * 接受：逗号多选 / all / none。
+ */
+export declare function promptInitTools(knownIds: string[], io?: {
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}): Promise<InitToolsSelection>;
+export declare function runCli(argv: string[]): Promise<void>;