@hongmaple0820/scale-engine 0.49.0 → 0.50.2

package/docs/workflow/README.md

@@ -21,8 +21,12 @@ make verify PROFILE=default
 scale gates status --json
 scale score task --changed --json
 scale prompt optimize --input "raw coding request" --json
+scale vibe-index
+npm run serve
 ```
 
+`npm run build` now builds the TypeScript CLI/runtime and builds the Vue 3 dashboard as the default UI. `npm run serve` prints the concrete dashboard URL, normally `http://localhost:3210/`. If the port is already occupied, either stop the stale process or set `SCALE_DASHBOARD_PORT=auto`.
+
 ### SCALE 2.0 引擎命令
 
 ```bash
@@ -38,7 +42,7 @@ scale orch status             # 查看状态 + workspace 列表
 # Scale Cortex — 持续进化
 scale cortex evolve           # 完整进化周期
 scale cortex extract          # 提取 Instincts
-scale cortex inject --minimal # 预览 SessionStart 注入
+scale cortex inject --minimal # 预览 runtime/AI OS 会消费的 SessionStart 注入
 scale cortex metrics --days 30 # 治理 ROI 报告
 ```
 
@@ -52,6 +56,10 @@ See [GATES_AND_SCORE.md](GATES_AND_SCORE.md) for gate catalog visibility, archit
 
 See [PROMPT_OPTIMIZATION.md](PROMPT_OPTIMIZATION.md) for the deterministic prompt rewrite layer used by `scale prompt optimize` and `scale define`.
 
+See [../VIBE-TEMPLATES.md](../VIBE-TEMPLATES.md) for built-in vibe coding templates. The default live dashboard is the Vue 3 + Naive UI app at the server root `/`. The Vue dashboard includes Overview, Workflow, Topology, Monitoring, Token/Cost, Documents, Knowledge, and Prompt Studio pages. Prompt Studio covers templates, packs, custom prompts, copy/download/export, and the deterministic optimizer. The Knowledge page separates repo knowledge base, gbrain memory, and graph visualization instead of treating memory as the whole knowledge system.
+
+The dashboard reads `GET /api/dashboard/capabilities` before rendering capability claims. Empty panels should have an explicit source and reason: missing model usage means no `.scale/model-usage/usage.jsonl`; missing knowledge base means no knowledge docs, `.scale/knowledge.db`, or `graphify-out/graph.json`; missing gbrain memory means no `.scale/memory/brain.sqlite` nodes; partial realtime/workflow transitions mean the HTTP serve path has not been started with EventBus/FSM/store injection.
+
 ## 模板与示例
 
 - 不知道一个任务该用哪些模板、模板和哪个门禁挂钩，先读 [TEMPLATE_GUIDE.md](TEMPLATE_GUIDE.md)（按等级 + 按改动类型的选择矩阵，含模板↔门禁映射）。

package/docs/workflow/templates/github-actions-scale-preflight.yml

@@ -7,6 +7,9 @@ on:
       - main
       - master
 
+permissions:
+  contents: read
+
 jobs:
   preflight:
     runs-on: ubuntu-latest
@@ -29,4 +32,4 @@ jobs:
           fi
 
       - name: Run SCALE preflight
-        run: npx @hongmaple0820/scale-engine@latest preflight --service all --preflight-profile ci
+        run: npx @hongmaple0820/scale-engine@latest preflight --service all --profile ci --preflight-profile ci

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hongmaple0820/scale-engine",
-  "version": "0.49.0",
+  "version": "0.50.2",
   "description": "Executable AI agent governance with workflow gates, evidence, skill/tool orchestration, and traceable HTML artifacts",
   "repository": {
     "type": "git",
@@ -33,6 +33,7 @@
     "docs/workflow",
     "examples/demo-projects/agent-governance-demo",
     "scripts/workflow/lib",
+    "scripts/workflow/run-vitest.mjs",
     "scripts/workflow/setup-smoke.mjs",
     "scripts/workflow/provider-rehearsal.mjs"
   ],
@@ -40,10 +41,11 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/workflow/cleanup-dashboard-legacy.mjs && vite build --config vite.dashboard.config.ts",
     "dev": "bun --watch src/api/cli.ts",
-    "test": "vitest run --reporter dot --pool=forks --maxWorkers=4 --minWorkers=1",
+    "test": "node scripts/workflow/run-vitest.mjs --timeout-ms 900000 --testTimeout=120000",
     "test:serial": "vitest run --reporter dot --pool=forks --poolOptions.forks.maxForks=1 --poolOptions.forks.minForks=1",
+    "coverage": "node scripts/workflow/run-vitest.mjs --timeout-ms 300000 tests/workflow/gateCatalog.test.ts tests/workflow/verificationProfile.test.ts --coverage --coverage.provider=v8 --coverage.reporter=text --coverage.include=src/workflow/GateCatalog.ts --coverage.include=src/workflow/VerificationProfile.ts --testTimeout=120000",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/**/*.ts",
     "smoke:setup": "node scripts/workflow/setup-smoke.mjs",
@@ -66,9 +68,11 @@
     "execa": "^9.3.0",
     "hono": "^4.5.0",
     "js-yaml": "^4.1.0",
+    "naive-ui": "^2.44.1",
     "pino": "^9.3.0",
     "pino-pretty": "^11.2.0",
     "type-is": "2.0.1",
+    "vue": "^3.5.38",
     "zod": "^3.23.0"
   },
   "overrides": {
@@ -85,9 +89,12 @@
     "@types/node": "^20.14.0",
     "@typescript-eslint/eslint-plugin": "^8.60.1",
     "@typescript-eslint/parser": "^8.59.3",
+    "@vitejs/plugin-vue": "^5.2.4",
+    "@vitest/coverage-v8": "2.1.9",
     "eslint": "^9.0.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
+    "vite": "^5.4.21",
     "vitest": "^2.0.0"
   },
   "engines": {

package/scripts/workflow/run-vitest.mjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+import { spawn } from 'node:child_process'
+
+const DEFAULT_TIMEOUT_MS = 600_000
+const DEFAULT_ARGS = [
+  'vitest',
+  'run',
+  '--reporter',
+  'dot',
+  '--pool=forks',
+  '--maxWorkers=4',
+  '--minWorkers=1',
+]
+
+const options = parseArgs(process.argv.slice(2))
+const commandArgs = [...DEFAULT_ARGS, ...options.vitestArgs]
+const invocation = buildInvocation(commandArgs)
+let timedOut = false
+let child
+
+child = spawn(invocation.command, invocation.args, {
+  cwd: process.cwd(),
+  env: process.env,
+  stdio: 'inherit',
+  detached: process.platform !== 'win32',
+  windowsHide: true,
+})
+
+const timer = setTimeout(() => {
+  timedOut = true
+  process.stderr.write(`\n[scale-engine] vitest timed out after ${options.timeoutMs}ms; terminating process tree.\n`)
+  terminateProcessTree(child.pid)
+}, options.timeoutMs)
+
+child.on('exit', (code, signal) => {
+  clearTimeout(timer)
+  if (timedOut) {
+    process.exitCode = 124
+    return
+  }
+  if (typeof code === 'number') {
+    process.exitCode = code
+    return
+  }
+  process.stderr.write(`[scale-engine] vitest exited via signal ${signal ?? 'unknown'}.\n`)
+  process.exitCode = 1
+})
+
+child.on('error', error => {
+  clearTimeout(timer)
+  process.stderr.write(`[scale-engine] failed to start vitest: ${error.message}\n`)
+  process.exitCode = 1
+})
+
+for (const signal of ['SIGINT', 'SIGTERM']) {
+  process.on(signal, () => {
+    clearTimeout(timer)
+    terminateProcessTree(child?.pid)
+    process.exit(130)
+  })
+}
+
+function parseArgs(args) {
+  const parsed = {
+    timeoutMs: Number.parseInt(process.env.SCALE_TEST_TIMEOUT_MS ?? '', 10),
+    vitestArgs: [],
+  }
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index]
+    if (arg === '--timeout-ms') {
+      parsed.timeoutMs = Number.parseInt(args[++index] ?? '', 10)
+      continue
+    }
+    if (arg.startsWith('--timeout-ms=')) {
+      parsed.timeoutMs = Number.parseInt(arg.slice('--timeout-ms='.length), 10)
+      continue
+    }
+    parsed.vitestArgs.push(arg)
+  }
+  if (!Number.isFinite(parsed.timeoutMs) || parsed.timeoutMs <= 0) {
+    parsed.timeoutMs = DEFAULT_TIMEOUT_MS
+  }
+  return parsed
+}
+
+function terminateProcessTree(pid) {
+  if (!pid) return
+  if (process.platform === 'win32') {
+    const killer = spawn('taskkill', ['/pid', String(pid), '/T', '/F'], {
+      stdio: 'ignore',
+      windowsHide: true,
+    })
+    killer.on('error', () => {
+      try { process.kill(pid, 'SIGKILL') } catch (error) { ignoreExitedProcess(error) }
+    })
+    return
+  }
+  try { process.kill(-pid, 'SIGTERM') } catch { try { process.kill(pid, 'SIGTERM') } catch (error) { ignoreExitedProcess(error) } }
+  setTimeout(() => {
+    try { process.kill(-pid, 'SIGKILL') } catch { try { process.kill(pid, 'SIGKILL') } catch (error) { ignoreExitedProcess(error) } }
+  }, 2000).unref()
+}
+
+function ignoreExitedProcess(error) {
+  if (process.env.SCALE_TEST_DEBUG) {
+    process.stderr.write(`[scale-engine] process tree cleanup notice: ${error instanceof Error ? error.message : String(error)}\n`)
+  }
+}
+
+function buildInvocation(args) {
+  const configured = process.env.SCALE_VITEST_RUNNER
+  if (configured) return { command: configured, args }
+  if (process.platform !== 'win32') return { command: 'npx', args }
+  return {
+    command: 'cmd.exe',
+    args: ['/d', '/s', '/c', ['npx', ...args].map(windowsQuote).join(' ')],
+  }
+}
+
+function windowsQuote(value) {
+  if (/^[A-Za-z0-9_./:=@-]+$/.test(value)) return value
+  return `"${value.replace(/"/g, '\\"')}"`
+}