specdo 1.0.2

package/dist/commands/archive.js

@@ -0,0 +1,362 @@
+/**
+ * specdo archive [--change <name>] [--skip-sync-check]
+ *
+ * 行为：
+ *   1. 必须 init；--change 必需
+ *   2. 检查 tasks 全部完成 + 每个完成任务有 evidence
+ *   3. 实时只读检查当前 changes/<name>/specs 与 specdo/specs 的同步状态
+ *        - 只要存在 added / conflict → 始终失败（即使 --skip-sync-check）
+ *        - sync 未运行 → 失败（除非 --skip-sync-check）
+ *        - sync.completedAt = null → 失败（除非 --skip-sync-check）
+ *   4. same-filesystem rename: changes/<name>/ → archive/<name>/
+ *   5. 在 archive 目录内写 archive-summary.md 与 context.archive 元数据
+ *      - rename 失败 EXDEV → exit 3
+ *      - 目标已存在 → exit 1
+ *      - 元数据写入失败 → 尝试回滚 rename，避免 active change 脏状态
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ContextStore } from '../core/context-store.js';
+import { planSync, SyncError } from '../core/spec-sync.js';
+import { parseTasks } from '../core/task-parser.js';
+import { loadConfig, resolveDomains } from '../core/config-store.js';
+import { validateChange } from './validate.js';
+import { fail, findSpecdoConfig, getArchiveDir, getChangeDir, isValidChangeName, safeExists, safeIsDir, failOnInvalidConfig, } from './_shared.js';
+export async function handleArchive(options) {
+    const { cwd } = options;
+    if (!findSpecdoConfig(cwd)) {
+        return fail(1, ["Not initialized. Run 'specdo init' first."]);
+    }
+    if (!options.change) {
+        return fail(1, ['archive requires --change <name>.']);
+    }
+    if (!isValidChangeName(options.change)) {
+        return fail(1, [`Invalid --change name: "${options.change}".`]);
+    }
+    const changeName = options.change;
+    const changeDir = getChangeDir(cwd, changeName);
+    if (!safeIsDir(changeDir)) {
+        return fail(1, [`Change directory not found: ${changeDir}.`]);
+    }
+    const archiveDir = getArchiveDir(cwd, changeName);
+    if (safeExists(archiveDir)) {
+        return fail(1, [
+            `Archive target already exists: ${archiveDir}.`,
+            `Remove or rename the existing archive entry before re-archiving.`,
+        ]);
+    }
+    const tasksPath = path.join(changeDir, 'tasks.md');
+    if (!safeExists(tasksPath)) {
+        return fail(1, [`tasks.md not found at ${tasksPath}; cannot validate completion.`]);
+    }
+    const now = options.now ?? (() => new Date().toISOString());
+    const configResult = loadConfig(cwd);
+    const configFailure = failOnInvalidConfig(configResult);
+    if (configFailure)
+        return configFailure;
+    const validation = validateChange(cwd, changeName);
+    const validationErrors = validation.issues.filter((issue) => issue.level === 'error');
+    if (validationErrors.length > 0) {
+        return fail(1, renderValidationIssues(changeName, validationErrors));
+    }
+    const store = new ContextStore({ changeDir, now });
+    const ctx = store.read();
+    const resolvedDomains = resolveDomains(configResult.config).map((r) => r.domain);
+    const sourceSpecsDir = path.join(changeDir, 'specs');
+    const specsDir = path.join(cwd, 'specdo/specs');
+    // ─── 1. tasks 检查 ───
+    let parsed;
+    try {
+        parsed = parseTasks(fs.readFileSync(tasksPath, 'utf-8'));
+    }
+    catch (err) {
+        return fail(1, [`tasks.md parse failed: ${err.message}`]);
+    }
+    if (parsed.tasks.length === 0) {
+        return fail(1, ['tasks.md has no tasks; nothing to archive.']);
+    }
+    const incomplete = parsed.tasks.filter((t) => !t.completed);
+    if (incomplete.length > 0) {
+        return fail(1, [
+            `Cannot archive: ${incomplete.length} task(s) still incomplete:`,
+            ...incomplete.map((t) => `  - ${t.number}. ${t.title}`),
+        ]);
+    }
+    const missingEvidence = parsed.tasks.filter((t) => t.completed && (!t.evidence || t.evidence.trim().length === 0));
+    if (missingEvidence.length > 0) {
+        return fail(1, [
+            `Cannot archive: ${missingEvidence.length} completed task(s) missing evidence:`,
+            ...missingEvidence.map((t) => `  - ${t.number}. ${t.title}`),
+        ]);
+    }
+    // ─── 2. apply.tasksCompleted vs tasksTotal ───
+    if (!validation.context?.apply) {
+        return fail(1, [
+            'Cannot archive: context.apply is missing.',
+            `Run 'specdo apply --change ${changeName}' to rebuild apply state before archiving.`,
+        ]);
+    }
+    if (validation.context.apply.tasksCompleted !== validation.context.apply.tasksTotal ||
+        validation.context.apply.tasksTotal !== parsed.tasks.length) {
+        return fail(1, [
+            `context.apply is out of sync with tasks.md (parsed ${parsed.tasks.length} tasks, ` +
+                `context says ${validation.context.apply.tasksCompleted}/${validation.context.apply.tasksTotal}).`,
+            `Run 'specdo apply --change ${changeName}' to refresh state.`,
+        ]);
+    }
+    // ─── 3. sync 检查（实时只读比对 + 历史 completedAt 审计） ───
+    let liveSync;
+    try {
+        liveSync = inspectLiveSync({ changeName, sourceSpecsDir, specsDir });
+    }
+    catch (err) {
+        if (err instanceof ArchivePreconditionError) {
+            return fail(err.exitCode, err.lines);
+        }
+        return fail(3, [`Failed to inspect current sync state: ${err.message}`]);
+    }
+    if (liveSync.unsyncedAdded.length > 0 || liveSync.unsyncedConflicts.length > 0) {
+        return fail(1, [
+            `Cannot archive: change specs are not fully synced into specdo/specs.`,
+            ...liveSync.unsyncedAdded.map((rel) => `  + pending add: ${rel}`),
+            ...liveSync.unsyncedConflicts.map((rel) => `  ! pending conflict: ${rel}`),
+            `Re-run 'specdo sync --change ${changeName}' before archiving.`,
+        ]);
+    }
+    const syncSnapshot = {
+        completedAt: ctx.sync?.completedAt ?? null,
+        unresolvedConflicts: liveSync.unsyncedConflicts,
+        forcedConflicts: ctx.sync?.forcedConflicts ?? [],
+    };
+    // 显式校验 context.json 中的 conflicts 字段
+    if (ctx.sync?.conflicts && ctx.sync.conflicts.length > 0) {
+        return fail(1, [
+            `Cannot archive: ${ctx.sync.conflicts.length} unresolved sync conflict(s) recorded in context.json.`,
+            ...ctx.sync.conflicts.map((c) => `  - ${c}`),
+            `Run 'specdo sync --change ${changeName} --force' to overwrite, or hand-merge and re-sync.`,
+        ]);
+    }
+    const riskNotes = [];
+    let skippedSyncCheck = false;
+    let skipSyncReason;
+    if (!ctx.sync) {
+        if (!options.skipSyncCheck) {
+            return fail(1, [
+                `Cannot archive: sync has not been executed. ` +
+                    `Run 'specdo sync --change ${changeName}' first, or pass --skip-sync-check (record-only).`,
+            ]);
+        }
+        skippedSyncCheck = true;
+        skipSyncReason = 'Sync was never executed';
+        riskNotes.push('Sync was never executed');
+    }
+    else if (ctx.sync.completedAt === null) {
+        if (!options.skipSyncCheck) {
+            return fail(1, [
+                `Cannot archive: sync is incomplete (completedAt = null).`,
+                `Re-run 'specdo sync --change ${changeName}' or pass --skip-sync-check (record-only).`,
+            ]);
+        }
+        skippedSyncCheck = true;
+        skipSyncReason = 'Sync started but never completed';
+        riskNotes.push('Sync started but never completed');
+    }
+    // ─── 4. rename 到 archive/ ───
+    fs.mkdirSync(path.dirname(archiveDir), { recursive: true });
+    try {
+        fs.renameSync(changeDir, archiveDir);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'EXDEV') {
+            return fail(3, [
+                `specdo/changes/ and specdo/archive/ must reside on the same filesystem. ` +
+                    `Symlinks across mount points are not supported. ` +
+                    `(${err.message})`,
+            ]);
+        }
+        if (code === 'ENOTEMPTY' || code === 'EEXIST') {
+            return fail(1, [`Archive target already exists: ${archiveDir}.`]);
+        }
+        return fail(3, [`Failed to rename change directory to archive: ${err.message}`]);
+    }
+    // ─── 5. 在 archive 目录内写 summary + context.archive；失败时回滚 rename ───
+    const summaryRelPath = 'archive-summary.md';
+    const summaryAbsPath = path.join(archiveDir, summaryRelPath);
+    const archivedAt = now();
+    const summary = renderArchiveSummary({
+        changeName,
+        tasksCount: parsed.tasks.length,
+        domainsUsed: ctx.propose?.domainsUsed ?? [],
+        syncSnapshot,
+        skippedSyncCheck,
+        skipSyncReason,
+        riskNotes,
+        archivedAt,
+    });
+    const archiveStore = new ContextStore({ changeDir: archiveDir, now });
+    try {
+        fs.writeFileSync(summaryAbsPath, summary, 'utf-8');
+        archiveStore.writeDeep({
+            archive: {
+                archivedAt,
+                archivePath: path.relative(cwd, archiveDir),
+                summaryPath: summaryRelPath,
+                skippedSyncCheck: skippedSyncCheck ? true : undefined,
+                skipSyncReason,
+                syncSnapshot,
+                riskNotes: riskNotes.length > 0 ? riskNotes : undefined,
+            },
+        });
+    }
+    catch (err) {
+        return rollbackArchivedChange({
+            cwd,
+            changeDir,
+            archiveDir,
+            summaryAbsPath,
+            message: `Failed to finalize archive metadata: ${err.message}`,
+        });
+    }
+    // ─── 6. 注入领域 verify checklist 作为 stdout 提示 ───
+    const stdout = [];
+    stdout.push(`✓ Archived '${changeName}' → ${path.relative(cwd, archiveDir)}/.`);
+    stdout.push(`Summary: ${path.relative(cwd, path.join(archiveDir, summaryRelPath))}`);
+    stdout.push('');
+    if (riskNotes.length > 0) {
+        stdout.push('Risk notes:');
+        for (const r of riskNotes) {
+            stdout.push(`  ! ${r}`);
+        }
+        stdout.push('');
+    }
+    const verifyChecklist = collectVerifyChecklist(resolvedDomains, ctx.propose?.domainsUsed ?? []);
+    if (verifyChecklist.length > 0) {
+        stdout.push('Pre-archive verify checklist (cross-check before announcing the change):');
+        for (const item of verifyChecklist) {
+            stdout.push(`  - [ ] ${item}`);
+        }
+    }
+    return { exitCode: 0, stdout, stderr: [] };
+}
+function renderArchiveSummary(input) {
+    const lines = [];
+    lines.push(`# Archive Summary: ${input.changeName}`);
+    lines.push('');
+    lines.push(`<!-- generatedBy: specdo archive at ${input.archivedAt} -->`);
+    lines.push('');
+    lines.push('## Outcome');
+    lines.push('');
+    lines.push(`- Tasks completed: ${input.tasksCount}`);
+    lines.push(`- Domains used: ${input.domainsUsed.length > 0 ? input.domainsUsed.join(', ') : '(none)'}`);
+    lines.push('');
+    lines.push('## Sync Snapshot');
+    lines.push('');
+    lines.push(`- completedAt: ${input.syncSnapshot.completedAt ?? '(none)'}`);
+    lines.push(`- unresolvedConflicts: ${input.syncSnapshot.unresolvedConflicts.length}`);
+    lines.push(`- forcedConflicts: ${input.syncSnapshot.forcedConflicts.length}`);
+    if (input.syncSnapshot.forcedConflicts.length > 0) {
+        for (const f of input.syncSnapshot.forcedConflicts) {
+            lines.push(`  - ${f}`);
+        }
+    }
+    lines.push('');
+    if (input.skippedSyncCheck) {
+        lines.push('## Skipped Sync Check');
+        lines.push('');
+        lines.push(`- reason: ${input.skipSyncReason ?? 'unspecified'}`);
+        lines.push('');
+    }
+    if (input.riskNotes.length > 0) {
+        lines.push('## Risk Notes');
+        lines.push('');
+        for (const r of input.riskNotes) {
+            lines.push(`- ⚠️ ${r}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function inspectLiveSync(input) {
+    let entries;
+    try {
+        entries = planSync({
+            changesSpecsDir: input.sourceSpecsDir,
+            specsDir: input.specsDir,
+        });
+    }
+    catch (err) {
+        if (err instanceof SyncError && err.exitCode === 1) {
+            throw new ArchivePreconditionError([
+                `Cannot archive: source specs directory not found for change '${input.changeName}'.`,
+                `Run 'specdo propose --change ${input.changeName}' first.`,
+            ]);
+        }
+        throw err;
+    }
+    return {
+        unsyncedAdded: entries.filter((entry) => entry.status === 'added').map((entry) => entry.relativePath),
+        unsyncedConflicts: entries.filter((entry) => entry.status === 'conflict').map((entry) => entry.relativePath),
+    };
+}
+function rollbackArchivedChange(input) {
+    const rollbackErrors = [];
+    try {
+        if (fs.existsSync(input.summaryAbsPath)) {
+            fs.rmSync(input.summaryAbsPath, { force: true });
+        }
+    }
+    catch (err) {
+        rollbackErrors.push(`remove summary: ${err.message}`);
+    }
+    try {
+        if (!safeExists(input.changeDir) && safeExists(input.archiveDir)) {
+            fs.renameSync(input.archiveDir, input.changeDir);
+        }
+    }
+    catch (err) {
+        rollbackErrors.push(`rename rollback: ${err.message}`);
+    }
+    if (rollbackErrors.length > 0) {
+        return fail(3, [
+            input.message,
+            `Rollback failed: ${rollbackErrors.join('; ')}`,
+            `Inspect ${path.relative(input.cwd, input.archiveDir)} manually before retrying archive.`,
+        ]);
+    }
+    return fail(3, [input.message, 'Archive directory was rolled back to the active change.']);
+}
+class ArchivePreconditionError extends Error {
+    lines;
+    exitCode = 1;
+    constructor(lines) {
+        super(lines.join('\n'));
+        this.lines = lines;
+        this.name = 'ArchivePreconditionError';
+    }
+}
+function collectVerifyChecklist(resolvedDomains, domainNames) {
+    const out = [];
+    const seen = new Set();
+    const byName = new Map(resolvedDomains.map((domain) => [domain.name, domain]));
+    for (const name of domainNames) {
+        const domain = byName.get(name);
+        if (!domain)
+            continue;
+        for (const item of domain.verify?.checklist ?? []) {
+            if (seen.has(item))
+                continue;
+            seen.add(item);
+            out.push(`(${name}) ${item}`);
+        }
+    }
+    return out;
+}
+function renderValidationIssues(changeName, issues) {
+    return [
+        `Cannot archive: validation failed for change '${changeName}'.`,
+        ...issues.map((issue) => `  - ${issue.path}: ${issue.message}`),
+        `Run 'specdo validate --change ${changeName}' to inspect the full report.`,
+    ];
+}
+//# sourceMappingURL=archive.js.map

package/dist/commands/archive.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * specdo doctor [--deep]
+ *
+ * 检查工作区健康度：目录结构、config schema、active vs archive 冲突、
+ * .sync-backup 残留、context.json.lock 残留。失败项使用 ✗，可恢复警告
+ * 使用 ! ，通过项使用 ✓。任意必须项失败 → exit 1。
+ */
+import { CommandResult } from './_shared.js';
+export interface DoctorOptions {
+    cwd: string;
+    deep?: boolean;
+    json?: boolean;
+}
+export interface DoctorCheck {
+    label: string;
+    status: 'ok' | 'warn' | 'fail';
+    detail: string;
+    required: boolean;
+}
+export declare function handleDoctor(options: DoctorOptions): Promise<CommandResult>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EACL,aAAa,EAMd,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CA0KjF"}

package/dist/commands/doctor.js

@@ -0,0 +1,180 @@
+/**
+ * specdo doctor [--deep]
+ *
+ * 检查工作区健康度：目录结构、config schema、active vs archive 冲突、
+ * .sync-backup 残留、context.json.lock 残留。失败项使用 ✗，可恢复警告
+ * 使用 ! ，通过项使用 ✓。任意必须项失败 → exit 1。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { loadConfig } from '../core/config-store.js';
+import { findSpecdoConfig, getSpecdoDir, ok, safeExists, safeIsDir, } from './_shared.js';
+const STALE_LOCK_THRESHOLD_MS = 30_000;
+export async function handleDoctor(options) {
+    const { cwd } = options;
+    const checks = [];
+    const specdoDir = getSpecdoDir(cwd);
+    checks.push({
+        label: 'specdo directory',
+        status: safeIsDir(specdoDir) ? 'ok' : 'fail',
+        detail: safeIsDir(specdoDir) ? path.relative(cwd, specdoDir) || '.' : "Not found — run 'specdo init'",
+        required: true,
+    });
+    // config + schema
+    if (!findSpecdoConfig(cwd)) {
+        checks.push({
+            label: 'project config',
+            status: 'fail',
+            detail: "Not found — expected specdo/config.yaml or specdo/config.yml",
+            required: true,
+        });
+    }
+    else {
+        const { config, issues } = loadConfig(cwd);
+        if (config && issues.length === 0) {
+            checks.push({
+                label: 'project config',
+                status: 'ok',
+                detail: `domainVersion=${config.domainVersion}, overrides=${Object.keys(config.overrides ?? {}).length}`,
+                required: true,
+            });
+        }
+        else {
+            checks.push({
+                label: 'project config',
+                status: 'fail',
+                detail: issues.map((i) => `${i.path}: ${i.message}`).slice(0, 3).join('; ') || 'invalid',
+                required: true,
+            });
+        }
+    }
+    // 子目录
+    for (const sub of ['specs', 'changes', 'archive']) {
+        const dir = path.join(specdoDir, sub);
+        checks.push({
+            label: `specdo/${sub}`,
+            status: safeIsDir(dir) ? 'ok' : 'warn',
+            detail: safeIsDir(dir) ? path.relative(cwd, dir) : 'missing (will be re-created on demand)',
+            required: false,
+        });
+    }
+    // active vs archive 冲突
+    const changesDir = path.join(specdoDir, 'changes');
+    const archiveDir = path.join(specdoDir, 'archive');
+    const conflicting = [];
+    if (safeIsDir(changesDir) && safeIsDir(archiveDir)) {
+        const activeNames = fs.readdirSync(changesDir).filter((n) => safeIsDir(path.join(changesDir, n)));
+        const archivedNames = new Set(fs.readdirSync(archiveDir).filter((n) => safeIsDir(path.join(archiveDir, n))));
+        for (const name of activeNames) {
+            if (archivedNames.has(name))
+                conflicting.push(name);
+        }
+    }
+    checks.push({
+        label: 'active vs archive',
+        status: conflicting.length === 0 ? 'ok' : 'warn',
+        detail: conflicting.length === 0
+            ? 'no overlapping change names'
+            : `${conflicting.length} overlapping name(s) detected: ${conflicting.join(', ')}. Run 'specdo archive --change <name>' to retry.`,
+        required: false,
+    });
+    // .sync-backup 残留
+    const syncBackupDir = path.join(specdoDir, '.sync-backup');
+    checks.push({
+        label: 'sync backup',
+        status: safeExists(syncBackupDir) ? 'warn' : 'ok',
+        detail: safeExists(syncBackupDir)
+            ? `Leftover at ${path.relative(cwd, syncBackupDir)}/. Review and remove manually.`
+            : 'no leftover',
+        required: false,
+    });
+    // context.json.lock 残留
+    const stale = [];
+    if (safeIsDir(changesDir)) {
+        for (const name of fs.readdirSync(changesDir)) {
+            const lock = path.join(changesDir, name, 'context.json.lock');
+            if (safeExists(lock)) {
+                try {
+                    const stat = fs.statSync(lock);
+                    const ageMs = Date.now() - stat.mtimeMs;
+                    if (ageMs > STALE_LOCK_THRESHOLD_MS) {
+                        stale.push({ path: path.relative(cwd, lock), ageMs });
+                    }
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+    }
+    checks.push({
+        label: 'stale locks',
+        status: stale.length === 0 ? 'ok' : 'warn',
+        detail: stale.length === 0
+            ? 'no stale lock files'
+            : stale
+                .map((s) => `${s.path} (age ${(s.ageMs / 1000).toFixed(0)}s)`)
+                .join('; '),
+        required: false,
+    });
+    // ─── deep checks ───
+    if (options.deep) {
+        // Node 版本（仅作信息展示）
+        checks.push({
+            label: 'Node runtime',
+            status: 'ok',
+            detail: `${process.version} (platform=${process.platform})`,
+            required: false,
+        });
+        // 检查 active changes 是否含损坏的 context.json
+        if (safeIsDir(changesDir)) {
+            let corrupted = 0;
+            for (const name of fs.readdirSync(changesDir)) {
+                const ctxPath = path.join(changesDir, name, 'context.json');
+                if (safeExists(ctxPath)) {
+                    try {
+                        JSON.parse(fs.readFileSync(ctxPath, 'utf-8'));
+                    }
+                    catch {
+                        corrupted++;
+                    }
+                }
+            }
+            checks.push({
+                label: 'context.json integrity',
+                status: corrupted === 0 ? 'ok' : 'warn',
+                detail: corrupted === 0 ? `all parseable` : `${corrupted} corrupted (will fall back to .bak on next read)`,
+                required: false,
+            });
+        }
+    }
+    // ─── render ───
+    const requiredFailed = checks.filter((c) => c.required && c.status === 'fail');
+    if (options.json) {
+        return {
+            exitCode: requiredFailed.length === 0 ? 0 : 1,
+            stdout: [JSON.stringify({ checks, summary: requiredFailed.length === 0 ? 'ok' : 'failed' }, null, 2)],
+            stderr: [],
+        };
+    }
+    const stdout = [];
+    stdout.push('SpecDo Doctor');
+    stdout.push('');
+    for (const c of checks) {
+        const icon = c.status === 'ok' ? '✓' : c.status === 'warn' ? '!' : '✗';
+        stdout.push(`  ${icon} ${c.label.padEnd(22)} ${c.detail}`);
+    }
+    stdout.push('');
+    if (requiredFailed.length > 0) {
+        stdout.push('Some required checks failed. Resolve the items above.');
+        return { exitCode: 1, stdout, stderr: [] };
+    }
+    if (checks.some((c) => c.status === 'warn')) {
+        stdout.push('Core checks passed. Optional items need attention.');
+    }
+    else {
+        stdout.push('All checks passed.');
+    }
+    return ok(stdout);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/domains.d.ts

@@ -0,0 +1,14 @@
+/**
+ * specdo domains [list | show <name>] [--json]
+ *
+ * 默认 `domains list`。`show <name>` 展示 override 应用后的有效配置。
+ */
+import { CommandResult } from './_shared.js';
+export interface DomainsOptions {
+    cwd: string;
+    subcommand?: 'list' | 'show';
+    name?: string;
+    json?: boolean;
+}
+export declare function handleDomains(options: DomainsOptions): Promise<CommandResult>;
+//# sourceMappingURL=domains.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../src/commands/domains.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,aAAa,EAKd,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA8FnF"}