@hongmaple0820/scale-engine 0.27.1 → 0.28.0

package/README.en.md

@@ -33,7 +33,7 @@ scale ai-os plan \
 
 This is not a claim that SCALE replaces human judgment. It is the first testable, explainable, and measurable runtime planning layer for the AI Engineering OS direction.
 
-The near-term target is a one-week push from `ai-os plan` to a runnable beta loop: `ai-os run`, memory providers, Context Compiler v2, Skill Router v2, Adaptive Workflow, Failure Learning, Dashboard, migration, and benchmark evidence. The long-range target is an AI Engineering OS beta in 8-12 weeks, a stable governance runtime in 3-6 months, and a cross-agent engineering operating layer in 6-12 months. See the full roadmap in [AI Engineering OS Strategic Positioning](docs/AI_ENGINEERING_OS_POSITIONING.md).
+The near-term target is `0.28.0` as a usable closed-loop enhancement: connect `ai-os plan`, `ai-os run`, verification recommendations, failure learning, dashboard, benchmark, migration, and adoption into one verifiable loop. The long-range target is an AI Engineering OS beta in 8-12 weeks, a stable governance runtime in 3-6 months, and a cross-agent engineering operating layer in 6-12 months. See the full roadmap in [AI Engineering OS Strategic Positioning](docs/AI_ENGINEERING_OS_POSITIONING.md).
 
 The current 0.27.0 beta runtime now includes the controlled run entry point: `scale ai-os run --dry-run` reuses the unified plan, produces execution steps, evidence requirements, next actions, and writes the run report to `.scale/ai-os/runs/`. When real verification is required, use guarded mode with explicit `--verify` commands. Commands run through the safe runner by default and are recorded as runtime evidence; failed verification returns a `blocked` JSON report and a non-zero CLI exit code.
 
@@ -61,21 +61,34 @@ scale ai-os run \
 After multiple runs, use the dashboard to summarize ready/blocked runs, verification commands, pending evidence, and failure learning:
 
 ```bash
+scale ai-os status --lang en
 scale ai-os dashboard --json
 ```
 
+`status` is the 0.28.0 closed-loop visibility entry point. It checks runtime directories, plan/run evidence, guarded verification, dashboard health, benchmark evidence, and the adoption report in one place.
+When guarded verification evidence is missing, it also recommends concrete commands from `.scale/verification.json` or `package.json` scripts so an agent can choose the next governed `--verify` step without guessing.
+
 Before a release or milestone review, run the fixed benchmark scenarios to compare context, memory, skill, governance, and dashboard metrics:
 
 ```bash
 scale ai-os benchmark --json
 ```
 
-Before adopting the 0.27.0 beta runtime in an existing project, create or verify the AI OS runtime state directories:
+Before adopting the AI OS beta runtime in an existing project, create or verify the AI OS runtime state directories:
 
 ```bash
 scale ai-os migrate --json
 ```
 
+You can also use the one-command adoption path. It runs migrate, the first dry-run, benchmark, and doctor in order, then writes the adoption report to `.scale/ai-os/adoption.json`:
+
+```bash
+scale ai-os adopt \
+  --task "Adopt AI OS runtime and generate the first governance evidence" \
+  --files "README.md,src/runtime/AiOsRuntime.ts" \
+  --json
+```
+
 For project-level readiness, run the AI OS doctor. It checks runtime directories, run history, dashboard health, benchmark freshness, and prints the next required action in English or Chinese:
 
 ```bash
@@ -83,7 +96,7 @@ scale ai-os doctor --lang en --json
 scale ai-os doctor --lang zh
 ```
 
-The standard upgrade path also surfaces this readiness. `scale upgrade check --json` now includes the AI OS doctor result, and `scale upgrade plan --json` adds explicit `ai-os migrate` / `ai-os doctor` steps when a project has not yet adopted the runtime state.
+The standard upgrade path also surfaces this readiness. `scale upgrade check --json` now includes the AI OS doctor result, and `scale upgrade plan --json` adds explicit `ai-os adopt`, `ai-os migrate`, and `ai-os doctor` steps when a project has not yet adopted the runtime state. Human-facing `scale upgrade check/plan --lang en` prints localized next commands; keep `--json` for scripts, CI, and agent integrations.
 
 ## Community
 
@@ -222,6 +235,12 @@ scale upgrade apply --dir . --confirm --lang en
 scale upgrade rollback --dir . --lang en
 ```
 
+If the upgrade plan says the AI OS runtime has not been adopted yet, run:
+
+```bash
+scale ai-os adopt --dir . --task "Adopt AI OS runtime" --lang en
+```
+
 Chinese output is the default. Add `--lang en` for English prompts and English HTML plans.
 
 Upgrade rules:

package/README.md

@@ -33,7 +33,7 @@ scale ai-os plan \
 
 这不是“完全替代人类判断”的声明；它是把 AI Engineering OS 的核心闭环先做成可测试、可解释、可度量的运行时规划层。
 
-短期目标是用一周冲刺把 `ai-os plan` 推进到可运行的 beta 闭环：`ai-os run`、记忆供应商、Context Compiler v2、Skill Router v2、Adaptive Workflow、Failure Learning、Dashboard、迁移和 benchmark。远景目标是 8-12 周形成 AI Engineering OS beta，3-6 个月进入稳定治理运行时，6-12 个月沉淀为跨 Agent 的工程操作层。完整路线图见 [AI Engineering OS 战略定位](docs/AI_ENGINEERING_OS_POSITIONING.md)。
+短期目标是把 `0.28.0` 做成可用闭环增强版：让 `ai-os plan`、`ai-os run`、验证建议、失败沉淀、Dashboard、benchmark、迁移和 adoption 串成可验证闭环。远景目标是 8-12 周形成 AI Engineering OS beta，3-6 个月进入稳定治理运行时，6-12 个月沉淀为跨 Agent 的工程操作层。完整路线图见 [AI Engineering OS 战略定位](docs/AI_ENGINEERING_OS_POSITIONING.md)。
 
 当前 0.27.0 beta runtime 已包含受控运行入口：`scale ai-os run --dry-run` 会复用统一 plan，生成执行步骤、证据要求、下一步动作，并把运行报告写入 `.scale/ai-os/runs/`。需要真实验证时可切到 guarded 模式并显式传入 `--verify`，命令默认通过 safe runner 执行并写入 runtime evidence；验证失败时 JSON 报告会返回 `blocked`，CLI 退出码为非零。
 
@@ -61,21 +61,35 @@ scale ai-os run \
 运行多次后可以用 dashboard 汇总 ready/blocked、验证命令、pending evidence 和 failure learning：
 
 ```bash
+scale ai-os status --lang zh
 scale ai-os dashboard --json
 ```
 
+当 guarded verification 证据缺失时，`status` 会从 `.scale/verification.json` 或 `package.json` scripts 推导具体验证命令，帮助 agent 自主选择下一条受治理的 `--verify` 步骤。
+
+`status` 是 0.28.0 闭环可见性入口，会一次性检查 runtime 目录、plan/run 证据、guarded verification、dashboard health、benchmark 和 adoption 报告是否齐全。
+
 发版或阶段验收前，用 benchmark 固定样例对比 context、memory、skill、governance 和 dashboard 指标：
 
 ```bash
 scale ai-os benchmark --json
 ```
 
-旧项目接入 0.27.0 beta runtime 前，可先创建或核验 AI OS 运行态目录：
+旧项目接入 AI OS beta runtime 前，可先创建或核验 AI OS 运行态目录：
 
 ```bash
 scale ai-os migrate --json
 ```
 
+也可以使用一键接入入口，它会按顺序执行 migrate、首个 dry-run、benchmark、doctor，并把采用报告写入 `.scale/ai-os/adoption.json`：
+
+```bash
+scale ai-os adopt \
+  --task "接入 AI OS runtime 并生成首份治理证据" \
+  --files "README.md,src/runtime/AiOsRuntime.ts" \
+  --json
+```
+
 项目级就绪检查可使用 AI OS doctor。它会检查运行态目录、运行历史、dashboard 健康度、benchmark 新鲜度，并按中英文输出下一步动作：
 
 ```bash
@@ -83,7 +97,7 @@ scale ai-os doctor --lang zh --json
 scale ai-os doctor --lang en
 ```
 
-标准升级入口也会带出这项检查。`scale upgrade check --json` 会包含 AI OS doctor 结果；当项目尚未接入运行态目录时，`scale upgrade plan --json` 会补充明确的 `ai-os migrate` / `ai-os doctor` 步骤。
+标准升级入口也会带出这项检查。`scale upgrade check --json` 会包含 AI OS doctor 结果；当项目尚未接入运行态目录时，`scale upgrade plan --json` 会补充明确的 `ai-os adopt`、`ai-os migrate` 和 `ai-os doctor` 步骤。面向人使用的 `scale upgrade check/plan --lang zh` 会输出中文 task 和中文下一步命令；`--json` 保留给脚本、CI 和 Agent 集成。
 
 ## 先怎么学
 
@@ -228,6 +242,12 @@ scale tools outdated --dir .
 scale skill outdated --dir .
 ```
 
+如果升级计划提示 AI OS runtime 尚未接入，先运行：
+
+```bash
+scale ai-os adopt --dir . --task "接入 AI OS runtime" --lang zh
+```
+
 升级原则：
 
 - `scale upgrade check` 读取 `.scale/governance.lock.json`，判断当前项目是干净、缺文件、模板过期，还是存在本地改动。

package/dist/api/cli.js

@@ -65,7 +65,7 @@ import { doctorHtmlArtifacts, renderHtmlArtifact, resolveHtmlArtifactForOpen, se
 import { renderGovernanceDashboard } from '../output/GovernanceDashboard.js';
 import { cleanupWorkspaceLifecycle, inspectWorkspaceLifecycle, } from '../workflow/WorkspaceLifecycle.js';
 import { inspectWorkspaceSafety } from '../workflow/WorkspaceSafety.js';
-import { RuntimeEvidenceLedger, SessionLedger, createAiOsBenchmark, createAiOsDashboard, createAiOsDoctor, createAiOsMigration, createAiOsPlan, createAiOsRun, doctorRuntimeEvidence, evaluateFinalReportReadiness, } from '../runtime/index.js';
+import { RuntimeEvidenceLedger, SessionLedger, createAiOsAdoption, createAiOsBenchmark, createAiOsDashboard, createAiOsDoctor, createAiOsMigration, createAiOsPlan, createAiOsRun, createAiOsStatus, doctorRuntimeEvidence, evaluateFinalReportReadiness, } from '../runtime/index.js';
 import { MemoryFabric, MemoryBrain, doctorMemoryFabric, renderContextPackMarkdown, renderMemoryLearningCandidateMarkdown, inspectMemoryProviders, recallMemoryProviders, settleMemoryLearning, writeMemoryProvidersConfig, } from '../memory/index.js';
 import { resolveWorkspaceTopology, workspaceTopologyPath, workspaceTopologyTemplate, } from '../workflow/WorkspaceTopology.js';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
@@ -3136,9 +3136,149 @@ const aiOsDoctorCommand = defineCommand({
             process.exitCode = 1;
     },
 });
+const aiOsAdoptCommand = defineCommand({
+    meta: { name: 'adopt', description: 'Prepare a project for AI OS runtime use by running migrate, first dry-run, benchmark, and doctor' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task id for the first adoption dry-run report' },
+        task: { type: 'string', required: true, description: 'Task or adoption scenario description' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        files: { type: 'string', description: 'Comma-separated changed or target files' },
+        services: { type: 'string', description: 'Comma-separated affected services' },
+        budget: { type: 'string', description: 'Maximum estimated tokens for the adoption plan and benchmark' },
+        'requested-mode': { type: 'string', description: 'Requested governance mode: minimal, standard, expanded, or critical' },
+        lang: { type: 'string', default: 'en', description: 'Output language zh/en' },
+        'benchmark-max-age-hours': { type: 'string', description: 'Maximum accepted benchmark report age in hours' },
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const lang = normalizeLangArg(args.lang);
+        const report = await createAiOsAdoption({
+            projectDir,
+            scaleDir,
+            taskId: args['task-id'] ? String(args['task-id']) : undefined,
+            task: String(args.task),
+            level: normalizeTaskArtifactLevel(args.level),
+            files: parseCommaList(args.files),
+            services: parseCommaList(args.services),
+            budget: parsePositiveIntArg(args.budget, '--budget'),
+            requestedMode: normalizeGovernanceMode(args['requested-mode']),
+            lang,
+            benchmarkMaxAgeHours: parsePositiveIntArg(args['benchmark-max-age-hours'], '--benchmark-max-age-hours'),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (report.status === 'blocked')
+                process.exitCode = 1;
+            return;
+        }
+        if (lang === 'zh') {
+            console.log('SCALE AI OS 接入');
+            console.log(`  状态: ${report.status}`);
+            console.log(`  迁移: ${report.migration.status}`);
+            console.log(`  首次运行: ${report.run.status} (${report.run.mode})`);
+            console.log(`  基准: ${report.benchmark.summary.scenarios} 个场景`);
+            console.log(`  Doctor: ${report.doctor.status}`);
+            console.log(`  报告: ${report.artifacts.adoptionReport}`);
+            for (const phase of report.phases)
+                console.log(`  [${phase.status}] ${phase.id}: ${phase.summary}`);
+            for (const action of report.nextActions)
+                console.log(`  下一步: ${action}`);
+            for (const warning of report.warnings)
+                console.log(`  警告: ${warning}`);
+        }
+        else {
+            console.log('SCALE AI OS Adoption');
+            console.log(`  Status: ${report.status}`);
+            console.log(`  Migration: ${report.migration.status}`);
+            console.log(`  First run: ${report.run.status} (${report.run.mode})`);
+            console.log(`  Benchmark: ${report.benchmark.summary.scenarios} scenario(s)`);
+            console.log(`  Doctor: ${report.doctor.status}`);
+            console.log(`  Report: ${report.artifacts.adoptionReport}`);
+            for (const phase of report.phases)
+                console.log(`  [${phase.status}] ${phase.id}: ${phase.summary}`);
+            for (const action of report.nextActions)
+                console.log(`  next: ${action}`);
+            for (const warning of report.warnings)
+                console.log(`  warning: ${warning}`);
+        }
+        if (report.status === 'blocked')
+            process.exitCode = 1;
+    },
+});
+const aiOsStatusCommand = defineCommand({
+    meta: { name: 'status', description: 'Show AI OS closed-loop readiness across runtime, run, verification, dashboard, benchmark, and adoption evidence' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        lang: { type: 'string', default: 'en', description: 'Output language zh/en' },
+        'benchmark-max-age-hours': { type: 'string', description: 'Maximum accepted benchmark report age in hours' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const lang = normalizeLangArg(args.lang);
+        const report = createAiOsStatus({
+            projectDir,
+            scaleDir,
+            benchmarkMaxAgeHours: parsePositiveIntArg(args['benchmark-max-age-hours'], '--benchmark-max-age-hours'),
+            lang,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (report.status === 'blocked')
+                process.exitCode = 1;
+            return;
+        }
+        if (lang === 'zh') {
+            console.log('SCALE AI OS 状态');
+            console.log(`  状态: ${report.status}`);
+            console.log(`  检查: ${report.summary.ready} ready, ${report.summary.warning} warning, ${report.summary.blocked} blocked`);
+            console.log(`  Dashboard: ${report.dashboard.health.status} (${report.dashboard.health.score})`);
+            console.log(`  Doctor: ${report.doctor.status}`);
+            for (const check of report.checks)
+                console.log(`  [${check.status}] ${check.id}: ${check.summary}`);
+            if (report.verificationRecommendations.length > 0) {
+                console.log('  验证建议:');
+                for (const recommendation of report.verificationRecommendations) {
+                    console.log(`    - ${recommendation.command} (${recommendation.source})`);
+                }
+            }
+            for (const action of report.nextActions)
+                console.log(`  下一步: ${action}`);
+            for (const warning of report.warnings)
+                console.log(`  警告: ${warning}`);
+        }
+        else {
+            console.log('SCALE AI OS Status');
+            console.log(`  Status: ${report.status}`);
+            console.log(`  Checks: ${report.summary.ready} ready, ${report.summary.warning} warning, ${report.summary.blocked} blocked`);
+            console.log(`  Dashboard: ${report.dashboard.health.status} (${report.dashboard.health.score})`);
+            console.log(`  Doctor: ${report.doctor.status}`);
+            for (const check of report.checks)
+                console.log(`  [${check.status}] ${check.id}: ${check.summary}`);
+            if (report.verificationRecommendations.length > 0) {
+                console.log('  Verification recommendations:');
+                for (const recommendation of report.verificationRecommendations) {
+                    console.log(`    - ${recommendation.command} (${recommendation.source})`);
+                }
+            }
+            for (const action of report.nextActions)
+                console.log(`  next: ${action}`);
+            for (const warning of report.warnings)
+                console.log(`  warning: ${warning}`);
+        }
+        if (report.status === 'blocked')
+            process.exitCode = 1;
+    },
+});
 const aiOs = defineCommand({
     meta: { name: 'ai-os', description: 'AI Engineering OS runtime planning and governance orchestration' },
     subCommands: {
+        adopt: aiOsAdoptCommand,
+        status: aiOsStatusCommand,
         plan: aiOsPlanCommand,
         run: aiOsRunCommand,
         dashboard: aiOsDashboardCommand,
@@ -3193,7 +3333,7 @@ const upgradeCheck = defineCommand({
             console.log('  Next:');
         }
         for (const command of report.recommendedCommands)
-            console.log(`    ${command}`);
+            console.log(`    ${formatUpgradeCommand(command, lang)}`);
     },
 });
 const upgradePlan = defineCommand({
@@ -3238,7 +3378,7 @@ const upgradePlan = defineCommand({
         console.log(lang === 'zh' ? '  步骤:' : '  Steps:');
         for (const step of report.steps) {
             const path = step.path ? ` ${step.path}` : '';
-            const command = step.command ? ` -> ${step.command}` : '';
+            const command = step.command ? ` -> ${formatUpgradeCommand(step.command, lang)}` : '';
             console.log(`    [${step.risk}] ${step.action}${path}: ${formatUpgradeStepReason(step.action, step.reason, lang)}${command}`);
         }
         if (htmlPath)
@@ -3339,12 +3479,32 @@ function formatUpgradeStepReason(action, fallback, lang) {
             return fallback
                 .replace('updates require manual-review; SCALE never auto-installs third-party capabilities.', '更新需要人工审阅；SCALE 不会自动安装第三方能力。')
                 .replace('updates require blocked; SCALE never auto-installs third-party capabilities.', '更新默认阻断；SCALE 不会自动安装第三方能力。');
+        case 'adopt-ai-os-runtime':
+            return '运行 AI OS 一键接入路径，生成运行态目录、首份 dry-run、benchmark 和 doctor 报告。';
+        case 'migrate-ai-os-runtime':
+            return 'AI OS 运行态目录缺失；接入 beta runtime 前先创建目录结构。';
+        case 'check-ai-os-runtime':
+            return '依赖 AI OS beta 编排前，先复核运行态就绪状态。';
         case 'run-preflight':
             return '完成已接受的升级后，运行项目级预检。';
         default:
             return fallback;
     }
 }
+function formatUpgradeCommand(command, lang) {
+    if (command === 'scale ai-os adopt --dir . --task "Adopt AI OS runtime" --json') {
+        return lang === 'zh'
+            ? 'scale ai-os adopt --dir . --task "接入 AI OS runtime" --lang zh'
+            : 'scale ai-os adopt --dir . --task "Adopt AI OS runtime" --lang en';
+    }
+    if (command === 'scale ai-os doctor --dir . --json') {
+        return lang === 'zh' ? 'scale ai-os doctor --dir . --lang zh' : 'scale ai-os doctor --dir . --lang en';
+    }
+    if (command === 'scale ai-os migrate --dir . --json') {
+        return 'scale ai-os migrate --dir .';
+    }
+    return command;
+}
 function formatUpgradeApplyReason(reason, lang) {
     if (lang !== 'zh')
         return reason;