@hongmaple0820/scale-engine 0.18.0 → 0.19.0

package/dist/output/HTMLArtifactLayer.js

@@ -310,11 +310,11 @@ function renderPurposeSection(template, sections) {
     const missing = sections.missing.length
         ? `<p class="doc-warning">Missing source artifacts: ${sections.missing.map(item => `<code>${escapeHtml(item)}</code>`).join(', ')}</p>`
         : '<p>All configured source artifacts were found.</p>';
-    return `
-    <p>${escapeHtml(template.description)}</p>
-    <h3>Source Artifacts</h3>
-    ${present}
-    ${missing}
+    return `
+    <p>${escapeHtml(template.description)}</p>
+    <h3>Source Artifacts</h3>
+    ${present}
+    ${missing}
   `;
 }
 function markdownToHtml(markdown) {
@@ -427,12 +427,12 @@ function writeArtifactIndex(projectDir, taskDir, policy, manifest) {
     });
     const rows = manifest.artifacts.map(artifact => {
         const href = basename(artifact.path);
-        return `<tr>
-      <td><a href="${escapeAttribute(href)}">${escapeHtml(artifact.type)}</a></td>
-      <td>${escapeHtml(artifact.title)}</td>
-      <td>${escapeHtml(artifact.gitPolicy)}</td>
-      <td>${escapeHtml(artifact.generatedAt)}</td>
-      <td>${artifact.missingSources.length ? artifact.missingSources.map(item => `<code>${escapeHtml(item)}</code>`).join(', ') : 'none'}</td>
+        return `<tr>
+      <td><a href="${escapeAttribute(href)}">${escapeHtml(artifact.type)}</a></td>
+      <td>${escapeHtml(artifact.title)}</td>
+      <td>${escapeHtml(artifact.gitPolicy)}</td>
+      <td>${escapeHtml(artifact.generatedAt)}</td>
+      <td>${artifact.missingSources.length ? artifact.missingSources.map(item => `<code>${escapeHtml(item)}</code>`).join(', ') : 'none'}</td>
     </tr>`;
     }).join('\n');
     const html = renderer.renderReport({
@@ -445,9 +445,9 @@ function writeArtifactIndex(projectDir, taskDir, policy, manifest) {
         },
         sections: [{
                 heading: 'Artifact Index',
-                content: `<table>
-        <thead><tr><th>Type</th><th>Title</th><th>Git Policy</th><th>Generated</th><th>Missing Sources</th></tr></thead>
-        <tbody>${rows}</tbody>
+                content: `<table>
+        <thead><tr><th>Type</th><th>Title</th><th>Git Policy</th><th>Generated</th><th>Missing Sources</th></tr></thead>
+        <tbody>${rows}</tbody>
       </table>`,
             }],
     });
@@ -520,23 +520,23 @@ function htmlArtifactSettlementMarkdown(taskId, doctor) {
     const artifacts = doctor.artifacts.length
         ? doctor.artifacts.map(artifact => `| ${artifact.type} | ${escapeCell(artifact.path)} | ${artifact.sourcePaths.length} | ${artifact.missingSources.length} | ${artifact.gitPolicy} |`).join('\n')
         : '| none |  | 0 | 0 |  |';
-    return `# HTML Artifacts
-
-Task: ${taskId ?? 'unspecified'}
-Status: ${doctor.ok ? 'passed' : 'blocked'}
-Generated: ${new Date().toISOString()}
-
-## Artifacts
-
-| Type | Path | Sources | Missing | Git policy |
-| --- | --- | ---: | ---: | --- |
-${artifacts}
-
-## Findings
-
-| Severity | Code | Path | Message |
-| --- | --- | --- | --- |
-${findings}
+    return `# HTML Artifacts
+
+Task: ${taskId ?? 'unspecified'}
+Status: ${doctor.ok ? 'passed' : 'blocked'}
+Generated: ${new Date().toISOString()}
+
+## Artifacts
+
+| Type | Path | Sources | Missing | Git policy |
+| --- | --- | ---: | ---: | --- |
+${artifacts}
+
+## Findings
+
+| Severity | Code | Path | Message |
+| --- | --- | --- | --- |
+${findings}
 `;
 }
 function sourceHeading(path) {

package/dist/prompts/VibeTemplateGallery.js

@@ -20,29 +20,29 @@ export const VISUAL_VIBE_TEMPLATES = [
             '如果只上线一个最小闭环，必须包含哪三个能力？',
             '哪些需求现在看起来诱人，但应该明确列为非目标？',
         ],
-        copyPrompt: `请作为 CEO 和产品负责人，主导 {{appName}} 的产品发现工作。
-
-场景：{{scenario}}
-我当前身份：{{userRole}}
-
-请按 SCALE 工作流执行：
-1. explore：先明确用户、业务目标、约束、竞品或替代方案，不确定的事实必须标注 [UNCERTAIN]。
-2. plan：输出 Mini-PRD，包含用户路径、非目标、权限/数据影响、异常场景和验收标准。
-3. verify：逐条检查成功标准是否可测试、是否能形成端到端闭环。
-
-必须主动使用 skills/MCP/CLI：
-- 如需联网资料，主动使用 web-access 或等价联网能力，并引用来源。
-- 如需求模糊，主动使用 deep-interview / idea-refine 类 Skill。
-- 如涉及用户界面，联动 UI/UX Skill 形成体验标准。
-
-安全边界：
-- 不允许凭空编造市场数据、竞品能力或用户需求。
-- 不允许把临时想法写成确定需求。
-- 不允许跳过权限、隐私、数据生命周期和失败场景。
-
-成功标准：
-- 产出一份可落地 Mini-PRD。
-- 每条验收标准都能被测试或人工验证。
+        copyPrompt: `请作为 CEO 和产品负责人，主导 {{appName}} 的产品发现工作。
+
+场景：{{scenario}}
+我当前身份：{{userRole}}
+
+请按 SCALE 工作流执行：
+1. explore：先明确用户、业务目标、约束、竞品或替代方案，不确定的事实必须标注 [UNCERTAIN]。
+2. plan：输出 Mini-PRD，包含用户路径、非目标、权限/数据影响、异常场景和验收标准。
+3. verify：逐条检查成功标准是否可测试、是否能形成端到端闭环。
+
+必须主动使用 skills/MCP/CLI：
+- 如需联网资料，主动使用 web-access 或等价联网能力，并引用来源。
+- 如需求模糊，主动使用 deep-interview / idea-refine 类 Skill。
+- 如涉及用户界面，联动 UI/UX Skill 形成体验标准。
+
+安全边界：
+- 不允许凭空编造市场数据、竞品能力或用户需求。
+- 不允许把临时想法写成确定需求。
+- 不允许跳过权限、隐私、数据生命周期和失败场景。
+
+成功标准：
+- 产出一份可落地 Mini-PRD。
+- 每条验收标准都能被测试或人工验证。
 - 明确本阶段要做什么、不做什么、后续如何验证。`,
     },
     {
@@ -61,30 +61,30 @@ export const VISUAL_VIBE_TEMPLATES = [
             '界面应该更像运营后台、消费产品、创作工具，还是管理系统？',
             '哪些状态必须完整设计：空态、加载、错误、权限不足、移动端？',
         ],
-        copyPrompt: `请作为 UX Director 和高级视觉设计负责人，主导 {{appName}} 的 UI/UX 方案。
-
-场景：{{scenario}}
-我当前身份：{{userRole}}
-
-请按 SCALE 工作流执行：
-1. explore：阅读现有产品、页面、组件、品牌和设计系统，识别当前视觉语言。
-2. plan：输出 UI-SPEC，包含信息架构、核心用户路径、组件状态、响应式规则、可访问性要求。
-3. build：只给出可执行设计方案或实现切片，不要写营销式空话。
-4. verify：要求截图、浏览器检查、控制台/网络检查和移动端适配证据。
-
-必须主动使用 skills/MCP/CLI：
-- 设计方向用 awesome-design-md / ui-ux-pro-max / frontend-design。
-- 浏览器验证用 agent-browser / Chrome DevTools MCP / webapp-testing。
-- 如需真实网页或竞品参考，使用 web-access 并记录来源。
-
-安全边界：
-- 不允许默认套用紫蓝渐变、模板化卡片堆叠或无意义装饰。
-- 不允许只描述功能而不定义状态、布局和交互。
-- 不允许未验证截图就声称 UI 完成。
-
-成功标准：
-- 产出一份可以直接指导实现的 UI-SPEC。
-- 每个关键页面包含状态、布局、交互、移动端和验收规则。
+        copyPrompt: `请作为 UX Director 和高级视觉设计负责人，主导 {{appName}} 的 UI/UX 方案。
+
+场景：{{scenario}}
+我当前身份：{{userRole}}
+
+请按 SCALE 工作流执行：
+1. explore：阅读现有产品、页面、组件、品牌和设计系统，识别当前视觉语言。
+2. plan：输出 UI-SPEC，包含信息架构、核心用户路径、组件状态、响应式规则、可访问性要求。
+3. build：只给出可执行设计方案或实现切片，不要写营销式空话。
+4. verify：要求截图、浏览器检查、控制台/网络检查和移动端适配证据。
+
+必须主动使用 skills/MCP/CLI：
+- 设计方向用 awesome-design-md / ui-ux-pro-max / frontend-design。
+- 浏览器验证用 agent-browser / Chrome DevTools MCP / webapp-testing。
+- 如需真实网页或竞品参考，使用 web-access 并记录来源。
+
+安全边界：
+- 不允许默认套用紫蓝渐变、模板化卡片堆叠或无意义装饰。
+- 不允许只描述功能而不定义状态、布局和交互。
+- 不允许未验证截图就声称 UI 完成。
+
+成功标准：
+- 产出一份可以直接指导实现的 UI-SPEC。
+- 每个关键页面包含状态、布局、交互、移动端和验收规则。
 - 明确需要哪些浏览器证据证明体验达标。`,
     },
     {
@@ -103,32 +103,32 @@ export const VISUAL_VIBE_TEMPLATES = [
             '哪些契约一旦变更会影响其他服务、前端或数据迁移？',
             '失败、回滚、兼容、观测和权限边界如何设计？',
         ],
-        copyPrompt: `请作为 CTO 和首席架构师，主导 {{appName}} 的技术实现架构方案。
-
-场景：{{scenario}}
-我当前身份：{{userRole}}
-
-请按 SCALE 工作流执行：
-1. explore：先读现有代码、目录、模块文档、接口和验证命令，列出事实证据。
-2. plan：输出架构方案，包含模块边界、接口契约、数据影响、异常契约、回滚策略和测试策略。
-3. build：把方案拆成可独立验证的实现切片，避免一次性大爆炸改动。
-4. review：主动做架构、代码质量、安全和文档影响评审。
-5. verify：给出必须运行的命令、预期证据和无法验证时的降级说明。
-
-必须主动使用 skills/MCP/CLI：
-- 需要框架/SDK 当前用法时，主动查官方文档或 Context7。
-- 需要模块关系时，使用 rg/graphify 或代码图谱能力。
-- 需要交叉评审时，可使用 codex/gemini/opencode CLI，但必须记录版本、命令和输出摘要。
-- 工具与 Skill 编排必须写入 skill-plan 或 verification 证据。
-
-安全边界：
-- 不允许编造调用链、接口或测试结果。
-- 不允许绕过 ORM、框架约定、日志脱敏、安全校验和权限边界。
-- 不允许把临时脚本、报告或调试日志混入长期资产。
-
-成功标准：
-- 产出一份可执行架构方案。
-- 每个实现切片都有边界、风险、验证命令和回滚思路。
+        copyPrompt: `请作为 CTO 和首席架构师，主导 {{appName}} 的技术实现架构方案。
+
+场景：{{scenario}}
+我当前身份：{{userRole}}
+
+请按 SCALE 工作流执行：
+1. explore：先读现有代码、目录、模块文档、接口和验证命令，列出事实证据。
+2. plan：输出架构方案，包含模块边界、接口契约、数据影响、异常契约、回滚策略和测试策略。
+3. build：把方案拆成可独立验证的实现切片，避免一次性大爆炸改动。
+4. review：主动做架构、代码质量、安全和文档影响评审。
+5. verify：给出必须运行的命令、预期证据和无法验证时的降级说明。
+
+必须主动使用 skills/MCP/CLI：
+- 需要框架/SDK 当前用法时，主动查官方文档或 Context7。
+- 需要模块关系时，使用 rg/graphify 或代码图谱能力。
+- 需要交叉评审时，可使用 codex/gemini/opencode CLI，但必须记录版本、命令和输出摘要。
+- 工具与 Skill 编排必须写入 skill-plan 或 verification 证据。
+
+安全边界：
+- 不允许编造调用链、接口或测试结果。
+- 不允许绕过 ORM、框架约定、日志脱敏、安全校验和权限边界。
+- 不允许把临时脚本、报告或调试日志混入长期资产。
+
+成功标准：
+- 产出一份可执行架构方案。
+- 每个实现切片都有边界、风险、验证命令和回滚思路。
 - 明确哪些文档需要长期维护，哪些产物是临时证据。`,
     },
     {
@@ -147,30 +147,30 @@ export const VISUAL_VIBE_TEMPLATES = [
             '哪些同类问题需要一起扫描，但不一定一起修改？',
             '验证失败时如何定位是实现问题、环境问题还是既有债务？',
         ],
-        copyPrompt: `请作为 Engineering Lead，主导 {{appName}} 的实现切片。
-
-场景：{{scenario}}
-我当前身份：{{userRole}}
-
-请按 SCALE 工作流执行：
-1. explore：读相关代码、测试、规范和历史上下文，输出影响面。
-2. plan：把工作拆成最小实现切片，每个切片有文件范围和验证方式。
-3. build：优先 TDD 或补回归测试，保持改动可追溯。
-4. verify：运行真实命令，记录 exit code、失败项、修复迭代和未验证项。
-
-必须主动使用 skills/MCP/CLI：
-- 新逻辑或 Bug 修复使用 TDD / systematic-debugging。
-- 多文件变更使用 incremental-implementation。
-- 需要外部工具时先做安全扫描，再执行。
-
-安全边界：
-- 不允许随手重构无关代码。
-- 不允许增加无脱敏日志、硬编码密钥、危险默认值或绕过框架约定。
-- 不允许测试未运行却声称通过。
-
-成功标准：
-- 改动范围和用户请求可追溯。
-- 必要测试、lint、构建或人工验证有证据。
+        copyPrompt: `请作为 Engineering Lead，主导 {{appName}} 的实现切片。
+
+场景：{{scenario}}
+我当前身份：{{userRole}}
+
+请按 SCALE 工作流执行：
+1. explore：读相关代码、测试、规范和历史上下文，输出影响面。
+2. plan：把工作拆成最小实现切片，每个切片有文件范围和验证方式。
+3. build：优先 TDD 或补回归测试，保持改动可追溯。
+4. verify：运行真实命令，记录 exit code、失败项、修复迭代和未验证项。
+
+必须主动使用 skills/MCP/CLI：
+- 新逻辑或 Bug 修复使用 TDD / systematic-debugging。
+- 多文件变更使用 incremental-implementation。
+- 需要外部工具时先做安全扫描，再执行。
+
+安全边界：
+- 不允许随手重构无关代码。
+- 不允许增加无脱敏日志、硬编码密钥、危险默认值或绕过框架约定。
+- 不允许测试未运行却声称通过。
+
+成功标准：
+- 改动范围和用户请求可追溯。
+- 必要测试、lint、构建或人工验证有证据。
 - 交付说明包含完成内容、验证结果和未验证项。`,
     },
     {
@@ -189,30 +189,30 @@ export const VISUAL_VIBE_TEMPLATES = [
             '失败和跳过项是否被明确记录？',
             '是否存在临时文件、测试报告、截图或日志不应提交？',
         ],
-        copyPrompt: `请作为 QA Lead 和 Release Manager，主导 {{appName}} 的验收与发版前检查。
-
-场景：{{scenario}}
-我当前身份：{{userRole}}
-
-请按 SCALE 工作流执行：
-1. explore：读取当前任务产物、git diff、测试配置和已知风险。
-2. verify：运行最小相关验证和发版前门控，记录真实输出摘要。
-3. review：执行代码质量、安全、文档资产和资源治理检查。
-4. ship：只有证据闭环后才建议合并、打 tag 或发布。
-
-必须主动使用 skills/MCP/CLI：
-- 使用 verification / code-reviewer / security review 类 Skill。
-- UI 或浏览器功能必须补截图、控制台和网络证据。
-- 发版必须记录版本、commit、tag、registry 或远程状态。
-
-安全边界：
-- 不允许隐藏失败命令。
-- 不允许把 dry-run 当成真实通过。
-- 不允许提交临时脚本、敏感日志、未归档测试报告或本地配置。
-
-成功标准：
-- 产出完整 verification/review/release evidence。
-- 所有 required gates 通过，optional gates 的缺失有说明。
+        copyPrompt: `请作为 QA Lead 和 Release Manager，主导 {{appName}} 的验收与发版前检查。
+
+场景：{{scenario}}
+我当前身份：{{userRole}}
+
+请按 SCALE 工作流执行：
+1. explore：读取当前任务产物、git diff、测试配置和已知风险。
+2. verify：运行最小相关验证和发版前门控，记录真实输出摘要。
+3. review：执行代码质量、安全、文档资产和资源治理检查。
+4. ship：只有证据闭环后才建议合并、打 tag 或发布。
+
+必须主动使用 skills/MCP/CLI：
+- 使用 verification / code-reviewer / security review 类 Skill。
+- UI 或浏览器功能必须补截图、控制台和网络证据。
+- 发版必须记录版本、commit、tag、registry 或远程状态。
+
+安全边界：
+- 不允许隐藏失败命令。
+- 不允许把 dry-run 当成真实通过。
+- 不允许提交临时脚本、敏感日志、未归档测试报告或本地配置。
+
+成功标准：
+- 产出完整 verification/review/release evidence。
+- 所有 required gates 通过，optional gates 的缺失有说明。
 - 明确是否可发版，以及剩余风险。`,
     },
 ];

package/dist/runtime/FinalReportGuard.d.ts

@@ -0,0 +1,16 @@
+import type { RuntimeSessionLevel } from './SessionLedger.js';
+import { type RuntimeDoctorReport } from './RuntimeDoctor.js';
+export interface FinalReportReadinessOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    taskId?: string;
+    sessionId?: string;
+    level?: RuntimeSessionLevel;
+}
+export interface FinalReportReadiness {
+    ready: boolean;
+    blocked: boolean;
+    reasons: string[];
+    report: RuntimeDoctorReport;
+}
+export declare function evaluateFinalReportReadiness(options?: FinalReportReadinessOptions): FinalReportReadiness;

package/dist/runtime/FinalReportGuard.js

@@ -0,0 +1,14 @@
+import { doctorRuntimeEvidence } from './RuntimeDoctor.js';
+export function evaluateFinalReportReadiness(options = {}) {
+    const report = doctorRuntimeEvidence(options);
+    const reasons = report.checks
+        .filter(check => check.status === 'fail' || check.name === 'Runtime completion evidence' && check.status === 'warn')
+        .map(check => check.message);
+    return {
+        ready: reasons.length === 0,
+        blocked: report.blocked || reasons.length > 0,
+        reasons,
+        report,
+    };
+}
+//# sourceMappingURL=FinalReportGuard.js.map

package/dist/runtime/FinalReportGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinalReportGuard.js","sourceRoot":"","sources":["../../src/runtime/FinalReportGuard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAA4B,MAAM,oBAAoB,CAAA;AAiBpF,MAAM,UAAU,4BAA4B,CAAC,UAAuC,EAAE;IACpF,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAA;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM;SAC1B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,6BAA6B,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC;SACnH,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAE9B,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAC7C,OAAO;QACP,MAAM;KACP,CAAA;AACH,CAAC"}

package/dist/runtime/RuntimeDoctor.d.ts

@@ -0,0 +1,23 @@
+import { type RuntimeEvidenceSummary } from './RuntimeEvidenceLedger.js';
+import { type RuntimeSessionLevel } from './SessionLedger.js';
+export type RuntimeDoctorStatus = 'ok' | 'warn' | 'fail';
+export interface RuntimeDoctorCheck {
+    name: string;
+    status: RuntimeDoctorStatus;
+    message: string;
+    fix?: string;
+}
+export interface RuntimeDoctorOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    taskId?: string;
+    sessionId?: string;
+    level?: RuntimeSessionLevel;
+}
+export interface RuntimeDoctorReport {
+    ok: boolean;
+    blocked: boolean;
+    checks: RuntimeDoctorCheck[];
+    evidence: RuntimeEvidenceSummary;
+}
+export declare function doctorRuntimeEvidence(options?: RuntimeDoctorOptions): RuntimeDoctorReport;

package/dist/runtime/RuntimeDoctor.js

@@ -0,0 +1,151 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { RuntimeEvidenceLedger } from './RuntimeEvidenceLedger.js';
+import { SessionLedger } from './SessionLedger.js';
+import { loadVerificationMatrix, resolveVerificationPolicy } from '../workflow/VerificationProfile.js';
+export function doctorRuntimeEvidence(options = {}) {
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const scaleRoot = isAbsolute(options.scaleDir ?? '')
+        ? options.scaleDir
+        : join(projectDir, options.scaleDir ?? '.scale');
+    const evidenceDir = join(scaleRoot, 'evidence', 'runtime');
+    const sessionsDir = join(scaleRoot, 'events', 'sessions');
+    const evidenceLedger = new RuntimeEvidenceLedger({ projectDir, scaleDir: scaleRoot, createDirs: false });
+    const sessionLedger = new SessionLedger({ projectDir, scaleDir: scaleRoot, createDirs: false });
+    const policy = resolveVerificationPolicy(loadVerificationMatrix(projectDir, scaleRoot));
+    const evidence = evidenceLedger.summary({
+        taskId: options.taskId,
+        sessionId: options.sessionId,
+    });
+    const evidenceRecords = evidenceLedger.list({
+        taskId: options.taskId,
+        sessionId: options.sessionId,
+        limit: Number.MAX_SAFE_INTEGER,
+    });
+    const checks = [];
+    checks.push(checkDirectory('Runtime evidence directory', evidenceDir, 'Run: scale runtime record ...'));
+    checks.push(checkDirectory('Runtime session directory', sessionsDir, 'Run: scale runtime start --session-id <id>'));
+    checks.push(checkSessionJsonl(sessionsDir, options.sessionId));
+    if (options.sessionId) {
+        const events = sessionLedger.listEvents(options.sessionId);
+        checks.push(events.length > 0
+            ? { name: 'Runtime session events', status: 'ok', message: `${events.length} event(s) for ${options.sessionId}` }
+            : { name: 'Runtime session events', status: 'warn', message: `No events recorded for ${options.sessionId}`, fix: 'Run: scale runtime start or append runtime events' });
+    }
+    if (evidence.failed > 0) {
+        checks.push({
+            name: 'Runtime failed evidence',
+            status: 'fail',
+            message: `${evidence.failed} failed runtime evidence record(s)`,
+            fix: 'Fix the failing command/tool output and record a passing evidence item',
+        });
+    }
+    else {
+        checks.push({
+            name: 'Runtime failed evidence',
+            status: 'ok',
+            message: evidence.expectedRed > 0
+                ? `No unresolved failed runtime evidence records; ${evidence.expectedRed} expected red reproduction record(s)`
+                : 'No failed runtime evidence records',
+        });
+    }
+    const level = options.level ?? 'M';
+    if (level !== 'S' && evidence.passed === 0) {
+        checks.push({
+            name: 'Runtime completion evidence',
+            status: 'warn',
+            message: `No passed evidence recorded for ${scopeLabel(options)}`,
+            fix: 'Record at least one passed command, gate, tool, browser, or skill evidence before claiming completion',
+        });
+    }
+    else {
+        checks.push({
+            name: 'Runtime completion evidence',
+            status: 'ok',
+            message: `${evidence.passed} passed evidence record(s)`,
+        });
+    }
+    const productSmokeMode = policy.productSmokeGate ?? 'warn';
+    if (level !== 'S' && productSmokeMode !== 'off') {
+        const productSmokePassed = evidenceRecords.some(record => record.status === 'passed' && isProductSmokeEvidence(record));
+        const productSmokeFailed = evidenceRecords.some(record => record.status === 'failed' && isProductSmokeEvidence(record));
+        if (productSmokePassed) {
+            checks.push({
+                name: 'Runtime product smoke evidence',
+                status: 'ok',
+                message: 'Passed product smoke evidence recorded',
+            });
+        }
+        else {
+            checks.push({
+                name: 'Runtime product smoke evidence',
+                status: productSmokeMode === 'block' || productSmokeFailed ? 'fail' : 'warn',
+                message: productSmokeFailed
+                    ? 'Product smoke evidence failed and no later passed product smoke evidence was recorded'
+                    : 'No passed product smoke evidence recorded for this M/L/CRITICAL task',
+                fix: 'Run a real product-path smoke check and record it with metadata.productSmoke=true or metadata.realProductPath=true',
+            });
+        }
+    }
+    const blocked = checks.some(check => check.status === 'fail');
+    return {
+        ok: !blocked,
+        blocked,
+        checks,
+        evidence,
+    };
+}
+function isProductSmokeEvidence(record) {
+    const metadata = record.metadata ?? {};
+    if (metadata.productSmoke === true || metadata.realProductPath === true)
+        return true;
+    if (metadata.gate === 'G8' || metadata.gate === 'productSmoke')
+        return true;
+    const text = `${record.title}\n${record.summary}`.toLowerCase();
+    return text.includes('product smoke') || text.includes('real product path');
+}
+function checkDirectory(name, dir, fix) {
+    if (!existsSync(dir)) {
+        return { name, status: 'warn', message: `Missing ${dir}`, fix };
+    }
+    return { name, status: 'ok', message: `Found ${dir}` };
+}
+function checkSessionJsonl(sessionsDir, sessionId) {
+    if (!existsSync(sessionsDir)) {
+        return { name: 'Runtime session JSONL', status: 'warn', message: 'No session JSONL directory yet' };
+    }
+    const files = sessionId
+        ? [`${safePathSegment(sessionId)}.jsonl`].filter(file => existsSync(join(sessionsDir, file)))
+        : readdirSync(sessionsDir).filter(file => file.endsWith('.jsonl'));
+    for (const file of files) {
+        const path = join(sessionsDir, file);
+        const lines = readFileSync(path, 'utf-8').split(/\r?\n/).filter(Boolean);
+        for (const line of lines) {
+            try {
+                JSON.parse(line);
+            }
+            catch {
+                return {
+                    name: 'Runtime session JSONL',
+                    status: 'fail',
+                    message: `${file} contains invalid JSONL`,
+                    fix: 'Remove or repair the invalid session event line',
+                };
+            }
+        }
+    }
+    return {
+        name: 'Runtime session JSONL',
+        status: 'ok',
+        message: `${files.length} session file(s) parse cleanly`,
+    };
+}
+function scopeLabel(options) {
+    if (options.taskId && options.sessionId)
+        return `${options.taskId}/${options.sessionId}`;
+    return options.taskId ?? options.sessionId ?? 'current scope';
+}
+function safePathSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]/g, '-').slice(0, 120) || 'unknown-session';
+}
+//# sourceMappingURL=RuntimeDoctor.js.map

package/dist/runtime/RuntimeDoctor.js.map

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

package/dist/runtime/RuntimeEvidenceLedger.d.ts

@@ -0,0 +1,50 @@
+export type RuntimeEvidenceKind = 'command' | 'gate' | 'tool' | 'skill' | 'mcp' | 'browser' | 'desktop' | 'manual' | 'final-report';
+export type RuntimeEvidenceStatus = 'passed' | 'failed' | 'skipped';
+export interface RuntimeEvidenceInput {
+    taskId?: string;
+    sessionId?: string;
+    kind: RuntimeEvidenceKind;
+    title: string;
+    status: RuntimeEvidenceStatus;
+    command?: string;
+    exitCode?: number;
+    summary: string;
+    artifacts?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface RuntimeEvidenceRecord extends RuntimeEvidenceInput {
+    id: string;
+    createdAt: string;
+    sequence: number;
+    redactionApplied: boolean;
+}
+export interface RuntimeEvidenceQuery {
+    taskId?: string;
+    sessionId?: string;
+    limit?: number;
+}
+export interface RuntimeEvidenceSummary {
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    expectedRed: number;
+    ok: boolean;
+    latestFailure?: RuntimeEvidenceRecord;
+}
+export interface RuntimeEvidenceLedgerOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    now?: () => Date;
+    createDirs?: boolean;
+}
+export declare class RuntimeEvidenceLedger {
+    private rootDir;
+    private now;
+    private sequence;
+    constructor(options?: RuntimeEvidenceLedgerOptions);
+    record(input: RuntimeEvidenceInput): RuntimeEvidenceRecord;
+    list(query?: RuntimeEvidenceQuery): RuntimeEvidenceRecord[];
+    get(id: string): RuntimeEvidenceRecord | null;
+    summary(query?: RuntimeEvidenceQuery): RuntimeEvidenceSummary;
+}