@rpamis/comet 0.3.9 → 0.4.0-beta.10

package/dist/domains/dashboard/native-collector.js

@@ -0,0 +1,289 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { readNativeBoundedTextFile } from '../comet-native/native-bounded-file.js';
+import { NATIVE_CHANGE_STATE_FILE, readNativeChange, readNativeChangeFile, } from '../comet-native/native-change.js';
+import { inspectNativeArchivePreflight } from '../comet-native/native-archive-inspection.js';
+import { inspectNativeConflictRadar } from '../comet-native/native-conflict-inspection.js';
+import { collectNativeContractFiles } from '../comet-native/native-contract-files.js';
+import { listNativeStatusPage } from '../comet-native/native-diagnostics.js';
+import { readNativeImplementationScope, readNativeVerificationEvidence, } from '../comet-native/native-evidence-storage.js';
+import { nativeProjectPaths, resolveContainedNativePath } from '../comet-native/native-paths.js';
+import { readWorkflowProjectConfig } from '../workflow-contract/project-config-reader.js';
+import { adaptNativeDashboardProjection, NATIVE_DASHBOARD_LIMITS, } from './native-adapter.js';
+const ARCHIVE_NAME_PATTERN = /^(\d{4}-\d{2}-\d{2})-(.+)$/u;
+function artifactDescriptors(state) {
+    const descriptors = [['brief', '需求简报', state.brief]];
+    for (const spec of state.spec_changes) {
+        if (!spec.source)
+            continue;
+        descriptors.push([`spec-${spec.capability}`, `${spec.capability} Spec`, spec.source]);
+    }
+    if (state.verification_report) {
+        descriptors.push(['verification', '验证报告', state.verification_report]);
+    }
+    return descriptors.slice(0, NATIVE_DASHBOARD_LIMITS.maxArtifactPreviews);
+}
+async function readArtifactPreview(root, [key, label, ref]) {
+    const preview = {
+        key,
+        label,
+        path: ref,
+        exists: false,
+    };
+    try {
+        const artifact = await readNativeBoundedTextFile({ root, ref });
+        const bytes = Buffer.from(artifact.text, 'utf8');
+        const truncated = bytes.length > NATIVE_DASHBOARD_LIMITS.maxArtifactPreviewBytes;
+        return {
+            ...preview,
+            exists: true,
+            content: truncated
+                ? bytes.subarray(0, NATIVE_DASHBOARD_LIMITS.maxArtifactPreviewBytes).toString('utf8')
+                : artifact.text,
+            truncated,
+            size: artifact.size,
+        };
+    }
+    catch {
+        return preview;
+    }
+}
+async function collectArtifacts(changeDir, state) {
+    return Promise.all(artifactDescriptors(state).map((descriptor) => readArtifactPreview(changeDir, descriptor)));
+}
+function specSummary(state) {
+    const capabilities = [...state.spec_changes]
+        .sort((left, right) => left.capability.localeCompare(right.capability))
+        .slice(0, NATIVE_DASHBOARD_LIMITS.maxCapabilities)
+        .map(({ capability, operation }) => ({ capability, operation }));
+    return {
+        total: state.spec_changes.length,
+        create: state.spec_changes.filter(({ operation }) => operation === 'create').length,
+        replace: state.spec_changes.filter(({ operation }) => operation === 'replace').length,
+        remove: state.spec_changes.filter(({ operation }) => operation === 'remove').length,
+        capabilities,
+        capabilitiesTruncated: state.spec_changes.length > capabilities.length,
+    };
+}
+async function acceptanceSummary(paths, changeDir, state, includeRuntimeEvidence) {
+    try {
+        const contract = await collectNativeContractFiles({
+            changeDir,
+            briefRef: state.brief,
+            specChanges: state.spec_changes,
+        });
+        const total = contract.contract.acceptance.length;
+        if (!includeRuntimeEvidence || !state.verification_evidence) {
+            return { total, evidenced: 0, skipped: 0, missing: total };
+        }
+        const evidence = await readNativeVerificationEvidence(paths, state.name, state.verification_evidence);
+        return {
+            total: evidence.acceptanceTrace.total,
+            evidenced: evidence.acceptanceTrace.evidenced,
+            skipped: evidence.acceptanceTrace.skipped,
+            missing: Math.max(0, evidence.acceptanceTrace.total -
+                evidence.acceptanceTrace.evidenced -
+                evidence.acceptanceTrace.skipped),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function implementationSummary(paths, state) {
+    if (!state.implementation_scope)
+        return null;
+    try {
+        const scope = await readNativeImplementationScope(paths, state.name, state.implementation_scope);
+        return {
+            complete: scope.complete,
+            declaredArtifactCount: scope.declaredArtifacts.length,
+            changeCount: scope.changes.length,
+            unattributedCount: scope.unattributed.length,
+            unresolvedCount: scope.unresolvedScopes.length,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function collectChangeFacts(paths, changeDir, state, includeRuntimeEvidence) {
+    const [artifacts, acceptance, implementation] = await Promise.all([
+        collectArtifacts(changeDir, state),
+        acceptanceSummary(paths, changeDir, state, includeRuntimeEvidence),
+        includeRuntimeEvidence ? implementationSummary(paths, state) : Promise.resolve(null),
+    ]);
+    return {
+        artifacts,
+        specs: specSummary(state),
+        acceptance,
+        implementation,
+        approval: state.approval,
+        createdAt: state.created_at,
+    };
+}
+async function collectArchivedChanges(paths) {
+    let entries;
+    try {
+        entries = await fs.readdir(paths.archiveDir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    const archived = [];
+    for (const entry of entries.sort((left, right) => right.name.localeCompare(left.name))) {
+        if (!entry.isDirectory())
+            continue;
+        const match = ARCHIVE_NAME_PATTERN.exec(entry.name);
+        if (!match)
+            continue;
+        const changeDir = path.join(paths.archiveDir, entry.name);
+        await resolveContainedNativePath(paths.nativeRoot, changeDir);
+        try {
+            const state = await readNativeChangeFile(path.join(changeDir, NATIVE_CHANGE_STATE_FILE));
+            if (!state.archived || entry.name !== `${match[1]}-${state.name}`)
+                continue;
+            const facts = await collectChangeFacts(paths, changeDir, state, false);
+            archived.push({
+                workflow: 'native',
+                name: state.name,
+                status: 'archived',
+                archivedAt: match[1],
+                phase: 'archive',
+                revision: state.revision,
+                selected: false,
+                approval: facts.approval,
+                nextCommand: null,
+                verificationResult: state.verification_result,
+                verificationFreshness: state.verification_result === 'pass' ? 'complete' : 'unknown',
+                archiveReady: true,
+                continuation: {
+                    disposition: 'done',
+                    action: 'none',
+                    command: null,
+                    requiresUserDecision: false,
+                    requiredInputs: [],
+                    requiredInputsTruncated: false,
+                },
+                findings: {
+                    total: 0,
+                    errors: 0,
+                    warnings: 0,
+                    info: 0,
+                    requiresUserDecision: false,
+                    codes: [],
+                    truncated: false,
+                },
+                archive: {
+                    ready: true,
+                    evidenceFreshness: state.verification_result === 'pass' ? 'complete' : 'unknown',
+                    operationCount: state.spec_changes.length,
+                    findingCodes: [],
+                    findingCodesTruncated: false,
+                    preflightHash: null,
+                },
+                conflicts: {
+                    visibleDefiniteConflict: 0,
+                    visiblePossibleOverlap: 0,
+                    peers: [],
+                    peersTruncated: false,
+                },
+                artifacts: facts.artifacts,
+                progress: {
+                    createdAt: facts.createdAt,
+                    checkpointAt: null,
+                    checkpointPhase: null,
+                    summary: 'Native change 已完成并归档。',
+                    nextAction: null,
+                    artifactCount: facts.artifacts.filter(({ exists }) => exists).length,
+                },
+                specs: facts.specs,
+                acceptance: facts.acceptance,
+                implementation: null,
+                repair: null,
+            });
+        }
+        catch {
+            // Invalid or unreadable archives are omitted from the read-only Dashboard projection.
+        }
+    }
+    return archived;
+}
+/** Collect a fresh, read-only Native Dashboard projection when this project enables Native. */
+export async function collectNativeDashboardProjection(projectRoot, options = {}) {
+    const root = path.resolve(projectRoot);
+    const config = await readWorkflowProjectConfig(root);
+    if (!config?.native)
+        return null;
+    const paths = await nativeProjectPaths(root, config.native.artifact_root);
+    const statuses = [];
+    let statusCursor = null;
+    let totalStatusCount;
+    do {
+        const page = await listNativeStatusPage(paths, {
+            cursor: statusCursor,
+            clarificationMode: config.native.clarification_mode,
+            maxVerifyFailures: config.native.max_verify_failures,
+        });
+        totalStatusCount ??= page.total;
+        if (page.total !== totalStatusCount) {
+            throw new Error('Native status total changed during Dashboard pagination');
+        }
+        statuses.push(...page.items.slice(0, NATIVE_DASHBOARD_LIMITS.maxChanges - statuses.length));
+        statusCursor = page.nextCursor;
+    } while (statusCursor !== null && statuses.length < NATIVE_DASHBOARD_LIMITS.maxChanges);
+    const preflightEntries = await Promise.all(statuses.map(async (status) => {
+        if (status.phase === 'invalid' || status.revision === null) {
+            return [status.name, null];
+        }
+        try {
+            return [
+                status.name,
+                await inspectNativeArchivePreflight({ paths, name: status.name, now: options.now }),
+            ];
+        }
+        catch {
+            return [status.name, null];
+        }
+    }));
+    const conflictRadar = await inspectNativeConflictRadar(paths).catch(() => null);
+    const projection = adaptNativeDashboardProjection({
+        generatedAt: (options.now ?? new Date()).toISOString(),
+        statuses,
+        preflights: Object.fromEntries(preflightEntries),
+        conflictRadar,
+        omittedSourceChangeCount: Math.max(0, (totalStatusCount ?? 0) - statuses.length),
+    });
+    const active = await Promise.all(projection.changes.map(async (change) => {
+        try {
+            const state = await readNativeChange(paths, change.name);
+            const facts = await collectChangeFacts(paths, path.join(paths.changesDir, change.name), state, true);
+            return {
+                ...change,
+                ...facts,
+                progress: { ...change.progress, createdAt: facts.createdAt },
+            };
+        }
+        catch {
+            return change;
+        }
+    }));
+    const archived = await collectArchivedChanges(paths);
+    const visible = [...active, ...archived].slice(0, NATIVE_DASHBOARD_LIMITS.maxChanges);
+    const totalChangeCount = projection.totalChangeCount + archived.length;
+    const result = {
+        ...projection,
+        totalChangeCount,
+        visibleChangeCount: visible.length,
+        omittedChangeCount: totalChangeCount - visible.length,
+        changesTruncated: totalChangeCount > visible.length,
+        changes: visible,
+    };
+    if (Buffer.byteLength(JSON.stringify(result), 'utf8') > NATIVE_DASHBOARD_LIMITS.maxSerializedBytes) {
+        throw new Error('Native Dashboard projection exceeds its serialized output budget');
+    }
+    return result;
+}
+//# sourceMappingURL=native-collector.js.map

package/dist/domains/dashboard/native-collector.js.map

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

package/dist/domains/dashboard/next-action.d.ts

@@ -0,0 +1,17 @@
+import type { ChangePhase, NextAction, TasksSummary, VerifySummary } from './types.js';
+interface NextActionInput {
+    phase: ChangePhase;
+    tasks: TasksSummary;
+    verify: VerifySummary;
+}
+/**
+ * Recommend a next slash-command for an active change. Combines the phase
+ * with task / verify state so the reason text matches what the user will
+ * actually see when they run the command.
+ *
+ * Returns `null` for archived changes — the dashboard surfaces an archive
+ * summary in that case instead of a next-action card.
+ */
+export declare function recommendNextAction(input: NextActionInput): NextAction;
+export {};
+//# sourceMappingURL=next-action.d.ts.map

package/dist/domains/dashboard/next-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-action.d.ts","sourceRoot":"","sources":["../../../domains/dashboard/next-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAWvF,UAAU,eAAe;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAwEtE"}

package/dist/domains/dashboard/next-action.js

@@ -0,0 +1,83 @@
+const PHASE_COMMAND = {
+    open: '/comet-open',
+    design: '/comet-design',
+    build: '/comet-build',
+    verify: '/comet-verify',
+    archive: '/comet-archive',
+    unknown: null,
+};
+/**
+ * Recommend a next slash-command for an active change. Combines the phase
+ * with task / verify state so the reason text matches what the user will
+ * actually see when they run the command.
+ *
+ * Returns `null` for archived changes — the dashboard surfaces an archive
+ * summary in that case instead of a next-action card.
+ */
+export function recommendNextAction(input) {
+    const command = PHASE_COMMAND[input.phase];
+    if (input.verify.result === 'fail') {
+        return {
+            command: '/comet-verify',
+            reason: '最近一次 verify 失败。',
+            description: '先打开 verify-result.md 逐项修复失败用例，再重新运行 /comet-verify。',
+        };
+    }
+    if (input.phase === 'unknown') {
+        return {
+            command: null,
+            reason: '当前 change 的 phase 未知。',
+            description: '检查 .comet.yaml 是否完整；可能需要重新运行 /comet-open 重新初始化状态。',
+        };
+    }
+    if (input.phase === 'build') {
+        const remaining = input.tasks.total - input.tasks.completed;
+        if (remaining > 0) {
+            return {
+                command,
+                reason: `当前处于 Build 阶段，还有 ${remaining} 个任务未完成。`,
+                description: '继续完成 tasks.md 中剩余任务后再进入 verify。',
+            };
+        }
+        return {
+            command: '/comet-verify',
+            reason: 'Build 任务已完成。',
+            description: '可以运行 /comet-verify 验证实现。',
+        };
+    }
+    if (input.phase === 'verify') {
+        if (input.verify.result === 'pass') {
+            return {
+                command: '/comet-archive',
+                reason: 'Verify 已通过。',
+                description: '可以运行 /comet-archive 进入归档流程。',
+            };
+        }
+        return {
+            command,
+            reason: 'Verify 尚未完成。',
+            description: '运行 /comet-verify 生成验证报告。',
+        };
+    }
+    if (input.phase === 'archive') {
+        return {
+            command,
+            reason: '当前 change 已进入归档阶段。',
+            description: '运行 /comet-archive 完成归档。',
+        };
+    }
+    if (input.phase === 'design') {
+        return {
+            command,
+            reason: '当前 change 仍处于 Design 阶段。',
+            description: '运行 /comet-design 推进设计，产出 tasks.md 和 plan.md。',
+        };
+    }
+    // phase === 'open'
+    return {
+        command,
+        reason: '当前 change 处于 Open 阶段。',
+        description: '运行 /comet-open 完成初始化或继续推进到 design。',
+    };
+}
+//# sourceMappingURL=next-action.js.map

package/dist/domains/dashboard/next-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-action.js","sourceRoot":"","sources":["../../../domains/dashboard/next-action.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAuC;IACxD,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,eAAe;IACvB,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,eAAe;IACvB,OAAO,EAAE,gBAAgB;IACzB,OAAO,EAAE,IAAI;CACd,CAAC;AAQF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAsB;IACxD,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE3C,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,eAAe;YACxB,MAAM,EAAE,iBAAiB;YACzB,WAAW,EAAE,oDAAoD;SAClE,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,uBAAuB;YAC/B,WAAW,EAAE,mDAAmD;SACjE,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5D,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO;gBACP,MAAM,EAAE,oBAAoB,SAAS,UAAU;gBAC/C,WAAW,EAAE,iCAAiC;aAC/C,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,eAAe;YACxB,MAAM,EAAE,cAAc;YACtB,WAAW,EAAE,0BAA0B;SACxC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACnC,OAAO;gBACL,OAAO,EAAE,gBAAgB;gBACzB,MAAM,EAAE,aAAa;gBACrB,WAAW,EAAE,6BAA6B;aAC3C,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO;YACP,MAAM,EAAE,cAAc;YACtB,WAAW,EAAE,0BAA0B;SACxC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,OAAO;YACP,MAAM,EAAE,oBAAoB;YAC5B,WAAW,EAAE,yBAAyB;SACvC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO;YACP,MAAM,EAAE,0BAA0B;YAClC,WAAW,EAAE,8CAA8C;SAC5D,CAAC;IACJ,CAAC;IAED,mBAAmB;IACnB,OAAO;QACL,OAAO;QACP,MAAM,EAAE,uBAAuB;QAC/B,WAAW,EAAE,oCAAoC;KAClD,CAAC;AACJ,CAAC"}

package/dist/domains/dashboard/open-browser.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Best-effort: open `url` in the user's default browser.
+ *
+ * Cross-platform without dependencies. Failures are swallowed (CI / headless
+ * containers / SSH sessions are expected to fail) — callers should still log
+ * the URL so the user can open it manually.
+ */
+export declare function openInBrowser(url: string): void;
+//# sourceMappingURL=open-browser.d.ts.map

package/dist/domains/dashboard/open-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../../../domains/dashboard/open-browser.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA6B/C"}

package/dist/domains/dashboard/open-browser.js

@@ -0,0 +1,40 @@
+import { spawn } from 'child_process';
+/**
+ * Best-effort: open `url` in the user's default browser.
+ *
+ * Cross-platform without dependencies. Failures are swallowed (CI / headless
+ * containers / SSH sessions are expected to fail) — callers should still log
+ * the URL so the user can open it manually.
+ */
+export function openInBrowser(url) {
+    let command;
+    let args;
+    if (process.platform === 'darwin') {
+        command = 'open';
+        args = [url];
+    }
+    else if (process.platform === 'win32') {
+        // `start` is a cmd builtin; route through cmd /c to invoke it.
+        command = 'cmd';
+        args = ['/c', 'start', '""', url];
+    }
+    else {
+        command = 'xdg-open';
+        args = [url];
+    }
+    try {
+        const child = spawn(command, args, {
+            stdio: 'ignore',
+            detached: true,
+            windowsHide: true,
+        });
+        child.on('error', () => {
+            // Silent — the surface command logged the URL already.
+        });
+        child.unref();
+    }
+    catch {
+        // Same as above: failure is informational, not fatal.
+    }
+}
+//# sourceMappingURL=open-browser.js.map

package/dist/domains/dashboard/open-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.js","sourceRoot":"","sources":["../../../domains/dashboard/open-browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,OAAe,CAAC;IACpB,IAAI,IAAc,CAAC;IAEnB,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,GAAG,MAAM,CAAC;QACjB,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACxC,+DAA+D;QAC/D,OAAO,GAAG,KAAK,CAAC;QAChB,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,UAAU,CAAC;QACrB,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,uDAAuD;QACzD,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;AACH,CAAC"}

package/dist/domains/dashboard/risk.d.ts

@@ -0,0 +1,24 @@
+import type { ArtifactsSummary, ChangeDashboardItem, ChangePhase, DashboardRisk, GitSnapshot, TasksSummary, VerifySummary } from './types.js';
+interface ChangeRiskInput {
+    status: 'active' | 'archived';
+    phase: ChangePhase;
+    hasCometYaml: boolean;
+    tasks: TasksSummary;
+    verify: VerifySummary;
+    artifacts: ArtifactsSummary;
+    archiveMetadataKnown?: boolean;
+}
+/**
+ * Risk rules per the dashboard PRD. Each rule is independent so the same
+ * change can surface several risks at once (e.g. failed verify + missing
+ * artifact). Codes are stable identifiers for the frontend / future API
+ * consumers.
+ */
+export declare function buildChangeRisks(input: ChangeRiskInput): DashboardRisk[];
+interface ProjectRiskInput {
+    git: GitSnapshot;
+    changes: ChangeDashboardItem[];
+}
+export declare function buildProjectRisks(input: ProjectRiskInput): DashboardRisk[];
+export {};
+//# sourceMappingURL=risk.d.ts.map

package/dist/domains/dashboard/risk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk.d.ts","sourceRoot":"","sources":["../../../domains/dashboard/risk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,UAAU,eAAe;IACvB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,EAAE,CA+ExE;AAED,UAAU,gBAAgB;IACxB,GAAG,EAAE,WAAW,CAAC;IACjB,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAa1E"}

package/dist/domains/dashboard/risk.js

@@ -0,0 +1,97 @@
+/**
+ * Risk rules per the dashboard PRD. Each rule is independent so the same
+ * change can surface several risks at once (e.g. failed verify + missing
+ * artifact). Codes are stable identifiers for the frontend / future API
+ * consumers.
+ */
+export function buildChangeRisks(input) {
+    const risks = [];
+    if (!input.hasCometYaml) {
+        risks.push({
+            level: 'warning',
+            code: 'MISSING_COMET_YAML',
+            message: '该 change 缺少 .comet.yaml，无法判定准确状态。',
+            suggestion: '运行 /comet-open 或手动补齐 .comet.yaml。',
+        });
+    }
+    if (input.phase === 'unknown') {
+        risks.push({
+            level: 'warning',
+            code: 'UNKNOWN_PHASE',
+            message: '当前 change 的 phase 未知。',
+            suggestion: '检查 .comet.yaml 的 phase 字段，或重新运行对应阶段命令。',
+        });
+    }
+    if (!input.artifacts.tasks) {
+        risks.push({
+            level: 'warning',
+            code: 'TASKS_MISSING',
+            message: '未找到 tasks.md，任务进度无法统计。',
+            suggestion: '在 change 目录下创建 tasks.md 并填入任务清单。',
+        });
+    }
+    else if (input.status === 'active' && input.tasks.total > 0) {
+        const remaining = input.tasks.total - input.tasks.completed;
+        if (remaining > 0) {
+            risks.push({
+                level: 'warning',
+                code: 'TASKS_INCOMPLETE',
+                message: `仍有 ${remaining} 个任务未完成。`,
+                suggestion: '继续执行 /comet-build 完成剩余任务后再进入 verify。',
+            });
+        }
+    }
+    if (input.verify.result === 'fail') {
+        risks.push({
+            level: 'error',
+            code: 'VERIFY_FAILED',
+            message: '最近一次 verify 失败。',
+            suggestion: '打开 verify-result.md 修复失败项后重新运行 /comet-verify。',
+        });
+    }
+    else if (input.status === 'active' && input.verify.result === 'pending') {
+        risks.push({
+            level: 'info',
+            code: 'VERIFY_PENDING',
+            message: '验证尚未执行或报告未生成。',
+            suggestion: '完成 build 任务后运行 /comet-verify。',
+        });
+    }
+    const missingArtifacts = [];
+    if (!input.artifacts.proposal)
+        missingArtifacts.push('proposal.md');
+    if (!input.artifacts.design)
+        missingArtifacts.push('design.md');
+    if (!input.artifacts.plan)
+        missingArtifacts.push('plan.md');
+    if (missingArtifacts.length > 0) {
+        risks.push({
+            level: 'info',
+            code: 'ARTIFACT_MISSING',
+            message: `缺少关键产物：${missingArtifacts.join(', ')}。`,
+            suggestion: '按当前 phase 补齐对应产物。',
+        });
+    }
+    if (input.status === 'archived' && input.archiveMetadataKnown === false) {
+        risks.push({
+            level: 'info',
+            code: 'ARCHIVE_METADATA_MISSING',
+            message: '归档目录名不符合 YYYY-MM-DD-<name> 规范，无法推断 archivedAt。',
+            suggestion: '后续归档时遵守标准命名，或在 .comet.yaml 中记录 archived_at。',
+        });
+    }
+    return risks;
+}
+export function buildProjectRisks(input) {
+    const risks = [];
+    if (input.git.dirtyFiles > 0) {
+        risks.push({
+            level: 'warning',
+            code: 'GIT_DIRTY',
+            message: `当前 repo 有 ${input.git.dirtyFiles} 个未提交文件。`,
+            suggestion: '在 verify / archive 前复核 git diff。',
+        });
+    }
+    return risks;
+}
+//# sourceMappingURL=risk.js.map

package/dist/domains/dashboard/risk.js.map

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

package/dist/domains/dashboard/server.d.ts

@@ -0,0 +1,21 @@
+export interface DashboardServerOptions {
+    projectPath: string;
+    port?: number;
+    webRoot?: string;
+}
+export interface DashboardServerHandle {
+    url: string;
+    port: number;
+    close: () => Promise<void>;
+}
+/**
+ * Start the dashboard HTTP server.
+ *
+ * - Serves `GET /api/dashboard` with a freshly-collected snapshot on every hit.
+ * - Serves the static frontend from `webRoot` (defaults to `./web` next to
+ *   this module — both in source and after build, since the build step copies
+ *   `domains/dashboard/web` to `dist/domains/dashboard/web`).
+ * - Tries `port` first, then port+1 ... until it finds a free one (max 50).
+ */
+export declare function startDashboardServer(options: DashboardServerOptions): Promise<DashboardServerHandle>;
+//# sourceMappingURL=server.d.ts.map

package/dist/domains/dashboard/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../domains/dashboard/server.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAgBD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA8BhC"}