specdo 1.0.2

package/dist/commands/init.js

@@ -0,0 +1,243 @@
+/**
+ * specdo init <agent> [-g] [-y]
+ *
+ * agent 是必传位置参数。运行流程（更严格的契约）：
+ *   1. agent 缺失 → exit 2，不做任何事
+ *   2. 解析 agent；任意失败（'all' / typo / unknown）→ exit 2，不创建骨架
+ *   3. agent 完全合法后才创建/修复骨架
+ *   4. 导出 skill
+ *
+ * 关键不变量：
+ *   - 仅当 agent 完全合法时，骨架才被创建（agent 错误不留下任何痕迹）
+ *   - config.yaml 永不覆盖（仅缺失时写入）
+ *   - 错误提示不引导用户去手填 'universal'；交互层（cli/index.ts）会在
+ *     未知无近似词时主动 prompt 是否走通用目录
+ *   - 任何 FS 写入失败 → exit 3
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fail, findSpecdoConfig, getSpecdoDir, ok, safeExists, safeIsDir, } from './_shared.js';
+import { ALL_AGENTS, exportSkills, isAgentName, suggestAgents, } from '../core/skill-exporter.js';
+/** 供错误提示与 --help 复用的可读字符串，例："claude | qoder | cursor | ..." */
+const SUPPORTED_AGENTS_HELP = ALL_AGENTS.join(' | ');
+const CONFIG_TEMPLATE = `# specdo configuration
+# Generated by 'specdo init'. Edit to add config.overrides for project-specific
+# domain customization. See specdo/specs/ for accumulated specifications, and
+# specdo/changes/ for in-flight change proposals.
+
+domainVersion: "1.0"
+overrides: {}
+`;
+export async function handleInit(options) {
+    const { cwd, agent, global = false } = options;
+    if (!safeIsDir(cwd)) {
+        return fail(1, [`init failed: cwd is not a directory: ${cwd}`]);
+    }
+    // ── 1. 必传 agent 校验 ─────────────────────────────────
+    if (agent === undefined || agent.trim().length === 0) {
+        return fail(2, [
+            'init failed: an agent name is required.',
+            'Usage: specdo init <agent>[,<agent>...]',
+            `Supported agents: ${SUPPORTED_AGENTS_HELP}.`,
+            'Examples:',
+            '  specdo init claude',
+            '  specdo init claude,cursor',
+            '  specdo init -g claude         # install skills globally',
+        ]);
+    }
+    // ── 2. 解析 agent（任何错误立即返回，绝不创建骨架）────
+    const parsed = parseAgents(agent);
+    if (!parsed.ok) {
+        return fail(2, parsed.stderr);
+    }
+    const agents = parsed.agents;
+    // 极端：trim/split 后为空（例如 ",,,"）
+    if (agents.length === 0) {
+        return fail(2, [
+            'init failed: an agent name is required.',
+            'Usage: specdo init <agent>[,<agent>...]',
+            `Supported agents: ${SUPPORTED_AGENTS_HELP}.`,
+        ]);
+    }
+    // ── 3. agent 已全部合法 → 创建/修复骨架（-g 跳过） ────
+    const stdout = [];
+    if (!global) {
+        const specdoDir = getSpecdoDir(cwd);
+        const existingConfig = findSpecdoConfig(cwd);
+        const skeletonExists = safeIsDir(specdoDir);
+        if (existingConfig && !skeletonExists) {
+            return fail(1, [
+                `Existing specdo config detected at ${existingConfig} but specdo/ is not a directory. Aborting.`,
+            ]);
+        }
+        try {
+            ensureDirs(cwd);
+            const configPath = path.join(specdoDir, 'config.yaml');
+            if (!safeExists(configPath)) {
+                fs.writeFileSync(configPath, CONFIG_TEMPLATE, 'utf-8');
+            }
+        }
+        catch (err) {
+            return fail(3, [`init failed: ${err.message}`]);
+        }
+        if (skeletonExists) {
+            stdout.push(`✓ specdo/ already initialized at ${path.relative(cwd, specdoDir) || '.'} — refreshed skeleton (config.yaml preserved)`);
+        }
+        else {
+            stdout.push(`✓ Initialized specdo workspace at ${path.relative(cwd, specdoDir) || '.'}`);
+        }
+    }
+    // ── 4. Skill 导出 ──────────────────────────────────────
+    const scope = global ? 'user' : 'project';
+    try {
+        const result = exportSkills({ cwd, agents, scope });
+        const scopeLabel = scope === 'user' ? 'user-global' : 'project';
+        stdout.push(`✓ Exported ${result.skillCount} core workflow skill packages (${result.filesWritten.length} files) to ${scopeLabel} ${result.agents.length === 1 ? '' : 'agents '}${result.agents.join(', ')}`);
+        for (const agentName of result.agents) {
+            const sample = result.filesWritten.find((p) => p.includes(`/.${agentName}/skills/`));
+            if (sample) {
+                const root = path.dirname(path.dirname(sample));
+                stdout.push(`  • ${agentName}: ${root}`);
+            }
+        }
+        if (result.pruned.length > 0) {
+            stdout.push(`✓ Removed ${result.pruned.length} orphan skill director${result.pruned.length === 1 ? 'y' : 'ies'} (legacy specdo-domain-* / specdo-protocol-*)`);
+            for (const prunedPath of result.pruned) {
+                stdout.push(`  • removed: ${path.basename(prunedPath)}`);
+            }
+        }
+    }
+    catch (err) {
+        return fail(3, [`init failed during skill export: ${err.message}`]);
+    }
+    // ── 5. Next steps 提示 ────────────────────────────────
+    stdout.push('');
+    if (global) {
+        stdout.push('Skills installed globally. Restart your AI tool to pick them up.');
+    }
+    else {
+        stdout.push('Next:');
+        stdout.push("  1. specdo explore '<idea>'      # capture intent + domain matches");
+        stdout.push('  2. specdo propose --change <n>   # generate proposal/specs/design/tasks');
+        stdout.push('  3. specdo apply --change <n>     # iterate with TDD discipline');
+        stdout.push('  4. specdo sync --change <n>      # promote specs to specdo/specs/');
+        stdout.push('  5. specdo archive --change <n>   # finalize and record evidence');
+    }
+    return ok(stdout);
+}
+function ensureDirs(cwd) {
+    const dirs = [
+        'specdo',
+        'specdo/specs',
+        'specdo/changes',
+        'specdo/archive',
+    ];
+    for (const rel of dirs) {
+        const abs = path.join(cwd, rel);
+        if (!safeExists(abs)) {
+            fs.mkdirSync(abs, { recursive: true });
+        }
+    }
+    for (const rel of ['specdo/specs', 'specdo/changes', 'specdo/archive']) {
+        const keepFile = path.join(cwd, rel, '.gitkeep');
+        if (!safeExists(keepFile)) {
+            fs.writeFileSync(keepFile, '', 'utf-8');
+        }
+    }
+}
+/**
+ * 检查 raw 是否为「单一未知 agent 且无近似词候选」——
+ * CLI 层在此场景下会主动 prompt 用户是否写到通用目录 (.agents/skills/)。
+ *
+ * 返回 null 表示不属于此场景（合法 agent / 'all' / typo / 多 agent / 空）；
+ * 返回字符串则是被识别出来的未知名（已 trim+lowercase）。
+ */
+export function detectUnknownAgentForPrompt(raw) {
+    if (raw === undefined)
+        return null;
+    const trimmed = raw.trim().toLowerCase();
+    if (trimmed.length === 0 || trimmed === 'all')
+        return null;
+    const parts = trimmed.split(',').map((s) => s.trim()).filter(Boolean);
+    if (parts.length !== 1)
+        return null;
+    const only = parts[0];
+    if (isAgentName(only))
+        return null;
+    if (suggestAgents(only).length > 0)
+        return null;
+    return only;
+}
+/**
+ * 检查 raw 是否为「单一未知 agent 且有近似词候选」——
+ * CLI 层在此场景下会 prompt 用户是否直接使用建议的 agent。
+ *
+ * 返回 null 表示不属于此场景（合法 agent / 'all' / 多 agent / 空 / 无近似词）；
+ * 返回 { input, suggestion } 则是识别出的 typo 和建议修正。
+ */
+export function detectTypoAgentForPrompt(raw) {
+    if (raw === undefined)
+        return null;
+    const trimmed = raw.trim().toLowerCase();
+    if (trimmed.length === 0 || trimmed === 'all')
+        return null;
+    const parts = trimmed.split(',').map((s) => s.trim()).filter(Boolean);
+    if (parts.length !== 1)
+        return null;
+    const only = parts[0];
+    if (isAgentName(only))
+        return null;
+    const suggestions = suggestAgents(only);
+    if (suggestions.length === 0)
+        return null;
+    return { input: only, suggestion: suggestions[0] };
+}
+function parseAgents(raw) {
+    const trimmed = raw.trim().toLowerCase();
+    if (trimmed === 'all') {
+        return {
+            ok: false,
+            stderr: [
+                "init failed: 'all' is not supported (potentially writes to multiple IDE directories at once).",
+                'List the agents explicitly, e.g. specdo init claude,cursor,codex.',
+                `Supported agents: ${SUPPORTED_AGENTS_HELP}.`,
+            ],
+        };
+    }
+    const parts = trimmed.split(',').map((s) => s.trim()).filter(Boolean);
+    const result = [];
+    const seen = new Set();
+    for (const part of parts) {
+        if (!isAgentName(part)) {
+            return { ok: false, stderr: buildUnknownAgentMessage(part) };
+        }
+        if (!seen.has(part)) {
+            seen.add(part);
+            result.push(part);
+        }
+    }
+    return { ok: true, agents: result };
+}
+/**
+ * 组装未知 agent 的多行 stderr。
+ *
+ * 分两种场景：
+ *   1. 近似词命中（Levenshtein ≤ 1）→ "Did you mean: <name>?" 并给出重跑命令
+ *   2. 无近似词 → 简单提示：交互式重跑（会调 prompt）。
+ *      绝不引导用户手填 'universal'。
+ */
+function buildUnknownAgentMessage(input) {
+    const lines = [`init failed: unknown agent '${input}'.`];
+    const suggestions = suggestAgents(input);
+    if (suggestions.length > 0) {
+        const list = suggestions.map((s) => `'${s}'`).join(' or ');
+        lines.push(`Did you mean: ${list}?`);
+        lines.push(`Run: specdo init ${suggestions[0]}`);
+    }
+    else {
+        lines.push(`Supported agents: ${SUPPORTED_AGENTS_HELP}.`);
+        lines.push('Run interactively to be prompted for the community fallback (.agents/skills/, picked up by Cursor / Goose / Kilo / Roo Code).');
+    }
+    return lines;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,23 @@
+/**
+ * specdo list [--changes | --specs | --archived] [--json] [--sort recent|name]
+ *
+ * 默认列出 active changes（specdo/changes/<name>/）。
+ * 行为遵循 phases/03-phase2-commands.md §`list`。
+ */
+import { CommandResult } from './_shared.js';
+export interface ListOptions {
+    cwd: string;
+    mode?: 'changes' | 'specs' | 'archived';
+    sort?: 'recent' | 'name';
+    json?: boolean;
+}
+export interface ChangeListEntry {
+    name: string;
+    stage: string;
+    tasksCompleted: number;
+    tasksTotal: number;
+    updatedAt: string | null;
+    hasConflicts: boolean;
+}
+export declare function handleList(options: ListOptions): Promise<CommandResult>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EACL,aAAa,EAMd,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACxC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAa7E"}

package/dist/commands/list.js

@@ -0,0 +1,135 @@
+/**
+ * specdo list [--changes | --specs | --archived] [--json] [--sort recent|name]
+ *
+ * 默认列出 active changes（specdo/changes/<name>/）。
+ * 行为遵循 phases/03-phase2-commands.md §`list`。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ContextStore } from '../core/context-store.js';
+import { fail, findSpecdoConfig, getSpecdoDir, ok, safeIsDir, } from './_shared.js';
+export async function handleList(options) {
+    const { cwd } = options;
+    if (!findSpecdoConfig(cwd)) {
+        return fail(1, ["Not initialized. Run 'specdo init' first."]);
+    }
+    const mode = options.mode ?? 'changes';
+    if (mode === 'specs') {
+        return listSpecs(cwd, options);
+    }
+    if (mode === 'archived') {
+        return listChangeDir(cwd, path.join(getSpecdoDir(cwd), 'archive'), options, 'archived');
+    }
+    return listChangeDir(cwd, path.join(getSpecdoDir(cwd), 'changes'), options, 'active');
+}
+function listChangeDir(cwd, baseDir, options, label) {
+    if (!safeIsDir(baseDir)) {
+        return ok(emptyOutput(label, options.json));
+    }
+    const entries = [];
+    for (const name of fs.readdirSync(baseDir)) {
+        const dir = path.join(baseDir, name);
+        if (!safeIsDir(dir))
+            continue;
+        const store = new ContextStore({ changeDir: dir });
+        const ctx = store.read();
+        entries.push({
+            name,
+            stage: deriveStage(ctx),
+            tasksCompleted: ctx.apply?.tasksCompleted ?? 0,
+            tasksTotal: ctx.apply?.tasksTotal ?? 0,
+            updatedAt: ctx.change?.updatedAt ?? null,
+            hasConflicts: (ctx.sync?.conflicts ?? []).length > 0,
+        });
+    }
+    const sort = options.sort ?? 'recent';
+    entries.sort((a, b) => {
+        if (sort === 'name')
+            return a.name.localeCompare(b.name);
+        const ta = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
+        const tb = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
+        return tb - ta;
+    });
+    if (options.json) {
+        return ok([JSON.stringify({ kind: label, entries }, null, 2)]);
+    }
+    const stdout = [];
+    if (entries.length === 0) {
+        stdout.push(`No ${label} changes found in ${path.relative(cwd, baseDir)}/.`);
+        return ok(stdout);
+    }
+    stdout.push(`${label === 'active' ? 'Active' : 'Archived'} changes (${entries.length}):`);
+    stdout.push('');
+    stdout.push(`  ${'NAME'.padEnd(28)} ${'STAGE'.padEnd(10)} ${'TASKS'.padEnd(8)} ${'UPDATED'.padEnd(20)}`);
+    for (const e of entries) {
+        const tasks = e.tasksTotal > 0 ? `${e.tasksCompleted}/${e.tasksTotal}` : '-';
+        const updated = e.updatedAt ? e.updatedAt.replace('T', ' ').slice(0, 19) : '(unknown)';
+        const flag = e.hasConflicts ? ' ⚠' : '';
+        stdout.push(`  ${e.name.padEnd(28)} ${e.stage.padEnd(10)} ${tasks.padEnd(8)} ${updated}${flag}`);
+    }
+    if (entries.some((e) => e.hasConflicts)) {
+        stdout.push('');
+        stdout.push('⚠ = unresolved sync conflicts; run `specdo sync --change <name>` to inspect.');
+    }
+    return ok(stdout);
+}
+function listSpecs(cwd, options) {
+    const specsDir = path.join(getSpecdoDir(cwd), 'specs');
+    if (!safeIsDir(specsDir)) {
+        return ok(['No specs directory found. Run `specdo init` then sync a change to populate it.']);
+    }
+    const files = walkMarkdown(specsDir, specsDir);
+    const sorted = [...files].sort();
+    if (options.json) {
+        return ok([JSON.stringify({ kind: 'specs', entries: sorted }, null, 2)]);
+    }
+    const stdout = [];
+    if (sorted.length === 0) {
+        stdout.push(`No spec files in ${path.relative(cwd, specsDir)}/.`);
+        return ok(stdout);
+    }
+    stdout.push(`Specs in ${path.relative(cwd, specsDir)}/ (${sorted.length}):`);
+    stdout.push('');
+    for (const rel of sorted) {
+        const abs = path.join(specsDir, rel);
+        const sizeKb = (fs.statSync(abs).size / 1024).toFixed(1);
+        stdout.push(`  ${rel.padEnd(40)} ${sizeKb} KB`);
+    }
+    return ok(stdout);
+}
+function deriveStage(ctx) {
+    if (ctx.archive)
+        return 'archive';
+    if (ctx.sync?.completedAt)
+        return 'synced';
+    if (ctx.apply) {
+        if (ctx.apply.completedAt)
+            return 'apply✓';
+        return 'apply';
+    }
+    if (ctx.propose)
+        return 'propose';
+    if (ctx.explore)
+        return 'explore';
+    return 'init';
+}
+function walkMarkdown(root, base) {
+    const out = [];
+    for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+        const abs = path.join(root, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...walkMarkdown(abs, base));
+            continue;
+        }
+        if (entry.isFile() && entry.name.endsWith('.md')) {
+            out.push(path.relative(base, abs).split(path.sep).join('/'));
+        }
+    }
+    return out;
+}
+function emptyOutput(label, json) {
+    if (json)
+        return [JSON.stringify({ kind: label, entries: [] }, null, 2)];
+    return [`No ${label} changes found.`];
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/propose.d.ts

@@ -0,0 +1,22 @@
+/**
+ * specdo propose [--change <name>] [--force]
+ *
+ * 行为：
+ *   1. 前置检查：specdo/config.yaml 必须存在；--change 必须提供或可从
+ *      cwd 路径推导
+ *   2. 读取 context.json → 取 explore.matchedDomains / answers / flaggedConcerns
+ *   3. 无 explore 数据时，domainsUsed = ALL_DOMAINS 的 name 列表，并在
+ *      stdout 警告"使用全部领域作为兜底"
+ *   4. 渲染 4 个 artifact：proposal.md / specs/<capability>/spec.md / design.md / tasks.md
+ *   5. 已存在的非空文件默认跳过（warn）；--force 时整段覆盖
+ *   6. 更新 context.propose.{artifacts, domainsUsed, capabilities, completedAt}
+ */
+import { CommandResult } from './_shared.js';
+export interface ProposeOptions {
+    cwd: string;
+    change?: string;
+    force?: boolean;
+    now?: () => string;
+}
+export declare function handlePropose(options: ProposeOptions): Promise<CommandResult>;
+//# sourceMappingURL=propose.d.ts.map

package/dist/commands/propose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../src/commands/propose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,OAAO,EACL,aAAa,EASd,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA+MnF"}