spec-wave 2.1.1

package/lib/cli-shared.js

@@ -0,0 +1,281 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export class CliError extends Error {
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = 'CliError';
+        this.exitCode = exitCode;
+    }
+}
+export const STATUS_RE = /\*\*状态\*\*：?\s*`?([a-z_]+)/i;
+const META_TICK_RE = /\|\s*\*\*([^*]+)\*\*\s*\|\s*`([^`]+)`/;
+const META_PLAIN_RE = /\|\s*\*\*([^*]+)\*\*\s*\|\s*([^|\n]+)\|/;
+const GATE_ROW_RE = /^\|\s*(?:\*\*)?([^*|]+?)(?:\*\*)?\s*\|\s*([^|]+)\|\s*([^|]+)\|\s*([^|]*)\|/;
+export function packageRoot() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+}
+export function resolveTarget(cwd, targetArg) {
+    return path.resolve(targetArg || cwd);
+}
+export function takeOption(args, name) {
+    const idx = args.indexOf(name);
+    if (idx === -1 || idx + 1 >= args.length)
+        return { value: undefined, rest: args };
+    const value = args[idx + 1];
+    const rest = args.slice(0, idx).concat(args.slice(idx + 2));
+    return { value, rest };
+}
+export function fail(message, exitCode = 1) {
+    throw new CliError(message, exitCode);
+}
+/**
+ * S2 过程域前缀唯一真值源（F1 / X7）。
+ * 规范三路径 + legacy 裸前缀并集；判定用「相等或前缀/」——禁止各命令本地再硬编码等价列表。
+ */
+export const S2_TRUTH_PREFIXES = [
+    'docs/tasks',
+    'docs/harness/reviews',
+    'docs/harness/invokes/by-task',
+    'reviews',
+    'invokes/by-task',
+];
+export function normalizeSlashPath(p) {
+    return p.replace(/\\/g, '/');
+}
+/** 相对路径（仓内 rel）是否命中 S2 */
+export function isS2RelPath(destRel) {
+    const n = normalizeSlashPath(destRel).replace(/^\.\//, '');
+    return S2_TRUTH_PREFIXES.some((seg) => n === seg || n.startsWith(`${seg}/`));
+}
+/**
+ * 绝对路径是否命中 S2。
+ * `.dsh/skills` 安装落点白名单：永不视为 S2（与 skills install 历史语义一致）。
+ */
+export function isS2AbsPath(absPath) {
+    const n = normalizeSlashPath(absPath);
+    if (n.endsWith('/.dsh/skills') || n.includes('/.dsh/skills/'))
+        return false;
+    return S2_TRUTH_PREFIXES.some((seg) => {
+        const needle = `/${seg}`;
+        return n.endsWith(needle) || n.includes(`${needle}/`);
+    });
+}
+export function assertNotS2Abs(absPath, message, exitCode = 2) {
+    if (isS2AbsPath(absPath)) {
+        fail(message ??
+            `拒写：路径命中 S2 过程域（${S2_TRUTH_PREFIXES.join(' · ')}）: ${absPath}`, exitCode);
+    }
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** 现行落盘根（F4 方案 B） */
+export const KIT_LAYOUT_DIR = '.coding-kit';
+/** legacy 只读探测根（不再作为新写默认目标） */
+export const LEGACY_LAYOUT_DIR = '.cyning-harness';
+export function kitLayoutJoin(target, ...parts) {
+    return path.join(target, KIT_LAYOUT_DIR, ...parts);
+}
+export function legacyLayoutJoin(target, ...parts) {
+    return path.join(target, LEGACY_LAYOUT_DIR, ...parts);
+}
+/**
+ * 解析布局内相对文件：优先 `.coding-kit/`，否则 legacy `.cyning-harness/`。
+ * `source=none` 时 `abs` 仍指向新布局路径（供写入）。
+ */
+export function resolveLayoutFile(target, relWithinLayout) {
+    const kit = kitLayoutJoin(target, relWithinLayout);
+    if (existsSync(kit))
+        return { abs: kit, source: 'kit' };
+    const legacy = legacyLayoutJoin(target, relWithinLayout);
+    if (existsSync(legacy))
+        return { abs: legacy, source: 'legacy' };
+    return { abs: kit, source: 'none' };
+}
+export function legacyLayoutHint(target) {
+    const hasLegacy = existsSync(path.join(target, LEGACY_LAYOUT_DIR));
+    const hasKit = existsSync(path.join(target, KIT_LAYOUT_DIR));
+    if (hasLegacy && !hasKit) {
+        return (`提示: 检测到 legacy 目录 ${LEGACY_LAYOUT_DIR}/；新落盘已统一为 ${KIT_LAYOUT_DIR}/。` +
+            `请运行 \`npx spec-wave upgrade --yes\` 将 manifest 写入新目录（旧目录只读保留，不删除）。`);
+    }
+    if (hasLegacy && hasKit) {
+        return `提示: ${LEGACY_LAYOUT_DIR}/ 为 legacy 只读；现行落盘为 ${KIT_LAYOUT_DIR}/。`;
+    }
+    return null;
+}
+export function extractSection(content, startMarker, endMarker) {
+    const startRe = new RegExp(`^${escapeRegExp(startMarker)}`, 'm');
+    const startMatch = content.match(startRe);
+    if (!startMatch || startMatch.index === undefined)
+        return null;
+    const start = startMatch.index;
+    let end = content.length;
+    if (endMarker) {
+        const next = content.indexOf(endMarker, start + startMarker.length);
+        if (next !== -1)
+            end = next;
+    }
+    return content.slice(start, end);
+}
+export function normalizeCell(raw) {
+    return raw.replace(/[`*]/g, '').trim();
+}
+export function parseHarnessMeta(content) {
+    const meta = {};
+    const section = extractSection(content, '## Harness 元信息', '###');
+    if (!section)
+        return meta;
+    for (const line of section.split('\n')) {
+        const tick = line.match(META_TICK_RE);
+        if (tick) {
+            meta[tick[1].trim()] = tick[2].trim();
+            continue;
+        }
+        const plain = line.match(META_PLAIN_RE);
+        if (!plain)
+            continue;
+        const key = plain[1].trim();
+        const val = plain[2].trim();
+        if (!key || key === '字段')
+            continue;
+        if (/^[-:\s]+$/.test(val))
+            continue;
+        if (!(key in meta))
+            meta[key] = val;
+    }
+    return meta;
+}
+// K1（task wiki-delta-section-diagnostics）：错节诊断 helper —— 诊断非兼容。
+// parseHarnessMeta 权威节名仍只认 '## Harness 元信息'（不改）；本 helper 仅在解析落空时
+// 全文查找「写在其他节的 wiki_delta 字段行」，供 lint-wiki-delta（wiki_delta_wrong_section）
+// 与 task lint（E8）输出指向正确节的诊断。key 单元格须恰为 wiki_delta（不误伤 wiki_delta_note）；
+// 启发式可能命中正文代码块示例（residual_risk 已登记）——诊断 detail 带行号便于人判。
+const WIKI_DELTA_ROW_RE = /^\s*\|?\s*(?:\*\*)?wiki_delta(?:\*\*)?\s*[|:]/;
+const HEADING_RE = /^(#{1,6})\s+(.+?)\s*$/;
+export function findWikiDeltaOutsideMetaSection(content) {
+    const lines = content.split('\n');
+    let inMeta = false;
+    let section = '（文首 · 无节）';
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        const heading = line.match(HEADING_RE);
+        if (heading) {
+            const level = heading[1].length;
+            const title = heading[2];
+            if (level === 2 && title === 'Harness 元信息') {
+                inMeta = true;
+                continue;
+            }
+            // 与 extractSection(content, '## Harness 元信息', '###') 同口径：节域止于下一个
+            // ### 及以上标题（level >= 3）；后继 ## 节仍在解析节域内（与解析器行为一致，避免误报）
+            if (inMeta && level >= 3)
+                inMeta = false;
+            if (!inMeta)
+                section = `${heading[1]} ${title}`;
+            continue;
+        }
+        if (inMeta)
+            continue;
+        if (WIKI_DELTA_ROW_RE.test(line))
+            return { line: i + 1, section };
+    }
+    return null;
+}
+export function parseHumanGates(content) {
+    const section = extractSection(content, '### 人工闸', '\n##');
+    if (!section)
+        return [];
+    const gates = [];
+    for (const line of section.split('\n')) {
+        const match = line.match(GATE_ROW_RE);
+        if (!match)
+            continue;
+        const id = match[1].trim();
+        if (!id.startsWith('HG-') || id.includes('human_gate'))
+            continue;
+        gates.push({
+            id,
+            status: normalizeCell(match[2]),
+            blocksHats: normalizeCell(match[3]),
+        });
+    }
+    return gates;
+}
+export function findGate(gates, prefix) {
+    return gates.find((g) => g.id === prefix || g.id.startsWith(`${prefix}（`) || g.id.startsWith(`${prefix}(`));
+}
+export function evaluateMayStart30(gates) {
+    const audit = findGate(gates, 'HG-AUDIT-R1');
+    const draft = findGate(gates, 'HG-TASK-DRAFT');
+    const graph = findGate(gates, 'HG-GRAPH-MODULES');
+    if (audit?.status !== 'approved') {
+        return { ok: false, reason: 'HG-AUDIT-R1 pending' };
+    }
+    if (draft && draft.status !== 'approved' && draft.blocksHats.includes('30')) {
+        return { ok: false, reason: 'HG-TASK-DRAFT pending' };
+    }
+    if (graph?.status === 'pending') {
+        return { ok: false, reason: 'HG-GRAPH-MODULES pending' };
+    }
+    return { ok: true, reason: null };
+}
+export function extractTaskSlug(fileName) {
+    let base = path.basename(fileName).replace(/\.md$/, '');
+    base = base.replace(/^(task_|done_)/, '');
+    base = base.replace(/_(\d{8}|\d{4}-\d{2}-\d{2})$/, '');
+    base = base.replace(/_v\d+$/, '');
+    return base;
+}
+export function normalizeSlug(slug) {
+    return String(slug).replace(/_/g, '-');
+}
+export function resolveTaskPath(target, taskFile) {
+    return path.isAbsolute(taskFile) ? taskFile : path.join(target, taskFile);
+}
+export function readTextIfExists(file) {
+    if (!existsSync(file))
+        return null;
+    return readFileSync(file, 'utf8');
+}
+export function toRel(target, abs) {
+    const rel = path.relative(target, abs);
+    if (!rel || rel.startsWith('..'))
+        return abs.replace(/\\/g, '/');
+    return rel.split(path.sep).join('/');
+}
+export function extractHatsFromInvokeFilename(name) {
+    const base = path.basename(name, '.md');
+    const parts = base.split('_');
+    if (parts.length >= 3 && parts[0] === 'invoke') {
+        return [parts[2]];
+    }
+    return [];
+}
+// 异常态兜底：canonical 模板（assets/harness/templates/TASK_TEMPLATE.md）亦不可读时的最小节。
+const CANONICAL_META_FALLBACK = '## Harness 元信息\n\n| 字段 | 值 |\n|------|-----|\n| **task_slug** | `<slug>` |';
+export function canonicalHarnessMetaSection() {
+    try {
+        const tpl = readFileSync(path.join(packageRoot(), 'assets', 'harness', 'templates', 'TASK_TEMPLATE.md'), 'utf8');
+        const section = extractSection(tpl, '## Harness 元信息', '###');
+        if (section)
+            return section.trimEnd();
+    }
+    catch {
+        // 落兜底常量
+    }
+    return CANONICAL_META_FALLBACK;
+}
+export function buildDoneSnapshot(dest) {
+    const content = readFileSync(dest, 'utf8');
+    const excerpt = extractSection(content, '## Harness 元信息', '###');
+    if (excerpt)
+        return { path: dest, harness_meta_section: excerpt.trimEnd(), warn: null };
+    return {
+        path: dest,
+        harness_meta_section: canonicalHarnessMetaSection(),
+        warn: '归档文件缺 ## Harness 元信息 节 · done_snapshot 打印 canonical 模板占位（assets/harness/templates/TASK_TEMPLATE.md）',
+    };
+}
+//# sourceMappingURL=cli-shared.js.map

package/lib/cli-shared.js.map

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

package/lib/cli-skills.d.ts

@@ -0,0 +1,52 @@
+export declare const EXECUTE_TRACK = "starter-experimental";
+type Frontmatter = {
+    name?: string;
+    description?: string;
+    compatibility?: string;
+    metadata?: {
+        hat_id?: string;
+        track?: string;
+    };
+    [k: string]: unknown;
+};
+type SkillPrompt = {
+    file: string;
+    frontmatter: Frontmatter;
+    body: string;
+    errors: string[];
+};
+export declare function parseSkillPrompt(content: string): {
+    frontmatter: Frontmatter | null;
+    body: string;
+    parseError?: string;
+};
+export declare function validateSkillFrontmatter(fm: Frontmatter | null, source: string): string[];
+export declare function loadSkillPrompts({ promptsDir }: {
+    promptsDir: string;
+}): SkillPrompt[];
+export declare function generateSkills({ promptsDir, withExecuteHats, }: {
+    promptsDir: string;
+    withExecuteHats?: boolean;
+}): {
+    files: Map<string, string>;
+    skills: SkillPrompt[];
+    errors: string[];
+};
+export declare function buildSkills({ promptsDir, outDir, withExecuteHats, }: {
+    promptsDir: string;
+    outDir: string;
+    withExecuteHats?: boolean;
+}): {
+    written: string[];
+};
+export declare function checkSkills({ promptsDir, skillsDir, }: {
+    promptsDir: string;
+    skillsDir: string;
+}): {
+    ok: boolean;
+    errors: string[];
+};
+export declare const EXECUTE_HAT_DIRS: Set<string>;
+export declare function isExecuteHatSkipped(parentDir: string, name: string, withExecuteHats: boolean): boolean;
+export declare function cmdSkills(args: string[]): Promise<void>;
+export {};