@hongmaple0820/med-scale-research-os 0.43.0

package/docs/reference/cli.md

@@ -0,0 +1,2921 @@
+# SCALE Engine CLI Reference
+
+> Auto-generated by `scripts/generate-cli-reference.mjs`. Do not edit by hand.
+> Regenerate with `npm run docs:cli`.
+
+Version: `0.43.0`
+
+SCALE Engine v0.43.0 CLI - hardened phase workflow gates, governance templates, platform adapters, skill routing, and verification automation
+
+## Commands
+
+- [`scale lite`](#scale-lite)
+- [`scale vibe`](#scale-vibe)
+- [`scale vibe-next`](#scale-vibe-next)
+- [`scale vibe-index`](#scale-vibe-index)
+- [`scale define`](#scale-define)
+- [`scale plan`](#scale-plan)
+- [`scale build`](#scale-build)
+- [`scale verify`](#scale-verify)
+- [`scale review`](#scale-review)
+- [`scale ship`](#scale-ship)
+- [`scale run`](#scale-run)
+- [`scale init`](#scale-init)
+- [`scale setup`](#scale-setup)
+- [`scale bootstrap`](#scale-bootstrap)
+  - [`scale bootstrap deps`](#scale-bootstrap-deps)
+- [`scale doctor`](#scale-doctor)
+- [`scale session`](#scale-session)
+  - [`scale session start`](#scale-session-start)
+  - [`scale session end`](#scale-session-end)
+- [`scale gate`](#scale-gate)
+  - [`scale gate pre-tool`](#scale-gate-pre-tool)
+  - [`scale gate post-tool`](#scale-gate-post-tool)
+  - [`scale gate before-stop`](#scale-gate-before-stop)
+- [`scale gates`](#scale-gates)
+  - [`scale gates status`](#scale-gates-status)
+- [`scale meta-governance`](#scale-meta-governance)
+- [`scale create`](#scale-create)
+- [`scale list`](#scale-list)
+- [`scale show`](#scale-show)
+- [`scale suggest`](#scale-suggest)
+- [`scale transition`](#scale-transition)
+- [`scale verifyTask`](#scale-verifyTask)
+- [`scale role`](#scale-role)
+  - [`scale role activate`](#scale-role-activate)
+  - [`scale role show`](#scale-role-show)
+- [`scale context`](#scale-context)
+  - [`scale context build`](#scale-context-build)
+  - [`scale context status`](#scale-context-status)
+  - [`scale context inject`](#scale-context-inject)
+  - [`scale context glossary`](#scale-context-glossary)
+  - [`scale context init`](#scale-context-init)
+  - [`scale context grill`](#scale-context-grill)
+  - [`scale context budget`](#scale-context-budget)
+  - [`scale context pack`](#scale-context-pack)
+  - [`scale context doctor`](#scale-context-doctor)
+  - [`scale context anatomy`](#scale-context-anatomy)
+- [`scale evolve`](#scale-evolve)
+- [`scale stats`](#scale-stats)
+- [`scale preflight`](#scale-preflight)
+- [`scale upgrade`](#scale-upgrade)
+  - [`scale upgrade check`](#scale-upgrade-check)
+  - [`scale upgrade plan`](#scale-upgrade-plan)
+  - [`scale upgrade diff`](#scale-upgrade-diff)
+  - [`scale upgrade apply`](#scale-upgrade-apply)
+  - [`scale upgrade rollback`](#scale-upgrade-rollback)
+- [`scale governance`](#scale-governance)
+  - [`scale governance diff`](#scale-governance-diff)
+  - [`scale governance mode`](#scale-governance-mode)
+  - [`scale governance roi`](#scale-governance-roi)
+- [`scale prompt`](#scale-prompt)
+  - [`scale prompt optimize`](#scale-prompt-optimize)
+- [`scale score`](#scale-score)
+  - [`scale score task`](#scale-score-task)
+- [`scale ai-os`](#scale-ai-os)
+  - [`scale ai-os adopt`](#scale-ai-os-adopt)
+  - [`scale ai-os status`](#scale-ai-os-status)
+  - [`scale ai-os plan`](#scale-ai-os-plan)
+  - [`scale ai-os run`](#scale-ai-os-run)
+  - [`scale ai-os dashboard`](#scale-ai-os-dashboard)
+  - [`scale ai-os benchmark`](#scale-ai-os-benchmark)
+  - [`scale ai-os migrate`](#scale-ai-os-migrate)
+  - [`scale ai-os doctor`](#scale-ai-os-doctor)
+- [`scale codegraph`](#scale-codegraph)
+  - [`scale codegraph status`](#scale-codegraph-status)
+  - [`scale codegraph init`](#scale-codegraph-init)
+  - [`scale codegraph query`](#scale-codegraph-query)
+  - [`scale codegraph impact`](#scale-codegraph-impact)
+  - [`scale codegraph context`](#scale-codegraph-context)
+  - [`scale codegraph roi`](#scale-codegraph-roi)
+- [`scale eval`](#scale-eval)
+  - [`scale eval init`](#scale-eval-init)
+  - [`scale eval run`](#scale-eval-run)
+  - [`scale eval compare`](#scale-eval-compare)
+  - [`scale eval report`](#scale-eval-report)
+  - [`scale eval failures`](#scale-eval-failures)
+  - [`scale eval replay`](#scale-eval-replay)
+  - [`scale eval promote-failure`](#scale-eval-promote-failure)
+- [`scale artifact`](#scale-artifact)
+  - [`scale artifact render`](#scale-artifact-render)
+  - [`scale artifact doctor`](#scale-artifact-doctor)
+  - [`scale artifact settle`](#scale-artifact-settle)
+  - [`scale artifact open`](#scale-artifact-open)
+  - [`scale artifact dashboard`](#scale-artifact-dashboard)
+- [`scale assets`](#scale-assets)
+  - [`scale assets scan`](#scale-assets-scan)
+  - [`scale assets doctor`](#scale-assets-doctor)
+  - [`scale assets settle`](#scale-assets-settle)
+- [`scale standards`](#scale-standards)
+  - [`scale standards scan`](#scale-standards-scan)
+  - [`scale standards doctor`](#scale-standards-doctor)
+  - [`scale standards settle`](#scale-standards-settle)
+  - [`scale standards baseline`](#scale-standards-baseline)
+- [`scale metrics`](#scale-metrics)
+  - [`scale metrics list`](#scale-metrics-list)
+- [`scale task-artifacts`](#scale-task-artifacts)
+  - [`scale task-artifacts check`](#scale-task-artifacts-check)
+- [`scale workspace`](#scale-workspace)
+  - [`scale workspace map`](#scale-workspace-map)
+  - [`scale workspace status`](#scale-workspace-status)
+  - [`scale workspace finish`](#scale-workspace-finish)
+  - [`scale workspace cleanup`](#scale-workspace-cleanup)
+- [`scale status`](#scale-status)
+- [`scale workflow`](#scale-workflow)
+  - [`scale workflow list`](#scale-workflow-list)
+- [`scale evidence`](#scale-evidence)
+  - [`scale evidence list`](#scale-evidence-list)
+  - [`scale evidence show`](#scale-evidence-show)
+- [`scale runtime`](#scale-runtime)
+  - [`scale runtime start`](#scale-runtime-start)
+  - [`scale runtime end`](#scale-runtime-end)
+  - [`scale runtime record`](#scale-runtime-record)
+  - [`scale runtime doctor`](#scale-runtime-doctor)
+  - [`scale runtime final-check`](#scale-runtime-final-check)
+- [`scale token`](#scale-token)
+  - [`scale token record`](#scale-token-record)
+  - [`scale token report`](#scale-token-report)
+- [`scale memory`](#scale-memory)
+  - [`scale memory pack`](#scale-memory-pack)
+  - [`scale memory doctor`](#scale-memory-doctor)
+  - [`scale memory cerebrum`](#scale-memory-cerebrum)
+  - [`scale memory settle`](#scale-memory-settle)
+  - [`scale memory ingest`](#scale-memory-ingest)
+  - [`scale memory query`](#scale-memory-query)
+  - [`scale memory contradictions`](#scale-memory-contradictions)
+  - [`scale memory dream`](#scale-memory-dream)
+  - [`scale memory promote`](#scale-memory-promote)
+  - [`scale memory export`](#scale-memory-export)
+  - [`scale memory import`](#scale-memory-import)
+  - [`scale memory provider`](#scale-memory-provider)
+    - [`scale memory provider init`](#scale-memory-provider-init)
+    - [`scale memory provider status`](#scale-memory-provider-status)
+    - [`scale memory provider recall`](#scale-memory-provider-recall)
+    - [`scale memory provider use`](#scale-memory-provider-use)
+- [`scale diagnose`](#scale-diagnose)
+  - [`scale diagnose plan`](#scale-diagnose-plan)
+- [`scale hunt`](#scale-hunt)
+  - [`scale hunt scan`](#scale-hunt-scan)
+  - [`scale hunt report`](#scale-hunt-report)
+  - [`scale hunt diagnose`](#scale-hunt-diagnose)
+  - [`scale hunt ignore`](#scale-hunt-ignore)
+- [`scale dependency`](#scale-dependency)
+  - [`scale dependency audit`](#scale-dependency-audit)
+- [`scale tdd`](#scale-tdd)
+  - [`scale tdd slice`](#scale-tdd-slice)
+- [`scale tool`](#scale-tool)
+  - [`scale tool policy`](#scale-tool-policy)
+  - [`scale tool doctor`](#scale-tool-doctor)
+  - [`scale tool plan`](#scale-tool-plan)
+  - [`scale tool run`](#scale-tool-run)
+  - [`scale tool evidence`](#scale-tool-evidence)
+  - [`scale tool outdated`](#scale-tool-outdated)
+- [`scale tools`](#scale-tools)
+  - [`scale tools policy`](#scale-tools-policy)
+  - [`scale tools doctor`](#scale-tools-doctor)
+  - [`scale tools plan`](#scale-tools-plan)
+  - [`scale tools run`](#scale-tools-run)
+  - [`scale tools evidence`](#scale-tools-evidence)
+  - [`scale tools outdated`](#scale-tools-outdated)
+- [`scale skill`](#scale-skill)
+  - [`scale skill scan`](#scale-skill-scan)
+  - [`scale skill doctor`](#scale-skill-doctor)
+  - [`scale skill plan`](#scale-skill-plan)
+  - [`scale skill check`](#scale-skill-check)
+  - [`scale skill repo`](#scale-skill-repo)
+  - [`scale skill safety`](#scale-skill-safety)
+  - [`scale skill radar`](#scale-skill-radar)
+  - [`scale skill recommend`](#scale-skill-recommend)
+  - [`scale skill outdated`](#scale-skill-outdated)
+- [`scale skills`](#scale-skills)
+  - [`scale skills scan`](#scale-skills-scan)
+  - [`scale skills doctor`](#scale-skills-doctor)
+  - [`scale skills plan`](#scale-skills-plan)
+  - [`scale skills check`](#scale-skills-check)
+  - [`scale skills repo`](#scale-skills-repo)
+  - [`scale skills safety`](#scale-skills-safety)
+  - [`scale skills radar`](#scale-skills-radar)
+  - [`scale skills recommend`](#scale-skills-recommend)
+  - [`scale skills outdated`](#scale-skills-outdated)
+- [`scale agent`](#scale-agent)
+  - [`scale agent spawn`](#scale-agent-spawn)
+  - [`scale agent list`](#scale-agent-list)
+  - [`scale agent profiles`](#scale-agent-profiles)
+  - [`scale agent leaders`](#scale-agent-leaders)
+- [`scale team`](#scale-team)
+  - [`scale team create`](#scale-team-create)
+  - [`scale team status`](#scale-team-status)
+- [`scale create-prd`](#scale-create-prd)
+- [`scale out-of-scope`](#scale-out-of-scope)
+  - [`scale out-of-scope add`](#scale-out-of-scope-add)
+  - [`scale out-of-scope check`](#scale-out-of-scope-check)
+  - [`scale out-of-scope list`](#scale-out-of-scope-list)
+  - [`scale out-of-scope remove`](#scale-out-of-scope-remove)
+- [`scale config`](#scale-config)
+  - [`scale config profile`](#scale-config-profile)
+- [`scale quickstart`](#scale-quickstart)
+- [`scale tui`](#scale-tui)
+- [`scale qa`](#scale-qa)
+  - [`scale qa e2e`](#scale-qa-e2e)
+  - [`scale qa daemon`](#scale-qa-daemon)
+- [`scale auto-fix`](#scale-auto-fix)
+- [`scale cost-report`](#scale-cost-report)
+- [`scale cost-optimize`](#scale-cost-optimize)
+- [`scale cross-review`](#scale-cross-review)
+- [`scale shield`](#scale-shield)
+  - [`scale shield compile`](#scale-shield-compile)
+  - [`scale shield status`](#scale-shield-status)
+  - [`scale shield test`](#scale-shield-test)
+- [`scale orch`](#scale-orch)
+  - [`scale orch start`](#scale-orch-start)
+  - [`scale orch stop`](#scale-orch-stop)
+  - [`scale orch status`](#scale-orch-status)
+  - [`scale orch log`](#scale-orch-log)
+- [`scale cortex`](#scale-cortex)
+  - [`scale cortex extract`](#scale-cortex-extract)
+  - [`scale cortex inject`](#scale-cortex-inject)
+  - [`scale cortex metrics`](#scale-cortex-metrics)
+  - [`scale cortex evolve`](#scale-cortex-evolve)
+  - [`scale cortex verify`](#scale-cortex-verify)
+
+---
+## `scale lite`
+
+SCALE Lite Mode - Interactive phase workflow
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--phase` | positional |  |  |
+| `--interactive` | boolean | `false` |  |
+| `--list` | boolean | `false` |  |
+| `--skills` | boolean | `false` |  |
+
+
+## `scale vibe`
+
+生成可复制的 SCALE Vibe Coding 中文提示词模板
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--template` | string |  | 模板 ID，例如 product-ceo-discovery / technical-architecture-plan |
+| `--phase` | string |  | 兼容旧阶段: idea/research/prd/design/agents/build |
+| `--pack` | string |  | 组合包: full-mvp/quick-prototype/developer-path/vibe-coder-path |
+| `--app` | string |  | 项目或应用名称 |
+| `--scenario` | string |  | 本次任务场景 |
+| `--user` | string |  | 用户身份或角色 |
+| `--output` | string |  | 输出文件路径；不填则输出到终端 |
+| `--interactive` | boolean | `false` | 显示交互式使用引导 |
+
+
+## `scale vibe-next`
+
+基于旧阶段推荐下一步 Vibe 模板
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--current` | string |  | 当前阶段 |
+
+
+## `scale vibe-index`
+
+生成 SCALE Vibe Coding 可视化提示词索引
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--output` | string | `docs/VIBE-TEMPLATES.md` | 输出文件路径 |
+| `--app` | string |  | 项目或应用名称 |
+
+
+## `scale define`
+
+DEFINE: Create Spec with AmbiguityScorer + SocraticQuestioner (/spec)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--title` | positional |  |  |
+| `--description` | string |  |  |
+| `--success-criteria` | string |  | Comma-separated criteria |
+| `--goal` | string |  | Goal answer for Socratic refinement |
+| `--constraint` | string |  | Constraint answer for Socratic refinement |
+| `--acceptance` | string |  | Acceptance criteria answer for Socratic refinement |
+| `--context` | string |  | Context answer for Socratic refinement |
+| `--risk` | string |  | Risk answer for Socratic refinement |
+| `--priority` | string |  | Priority answer for Socratic refinement |
+| `--format` | string |  | Output format: html or md (default: html) |
+| `--brand` | string |  | Brand theme for HTML output (vercel/stripe/notion/linear/github) |
+| `--json` | boolean | `false` |  |
+
+
+## `scale plan`
+
+PLAN: Create Plan with ConsensusPlanner (/plan)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--spec-id` | positional |  |  |
+| `--approach` | string |  | Implementation approach |
+| `--rollback` | string |  | Rollback strategy (required for FSM) |
+| `--format` | string |  | Output format: html or md (default: html) |
+| `--brand` | string |  | Brand theme for HTML output (vercel/stripe/notion/linear/github) |
+| `--json` | boolean | `false` |  |
+
+
+## `scale build`
+
+BUILD: Create Task (/build)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--plan-id` | positional |  |  |
+| `--description` | string |  | Task description |
+| `--level` | string | `` | Workflow task level: S, M, L, or CRITICAL (auto-detected if omitted) |
+| `--service` | string |  | Comma-separated service names touched by this task |
+| `--residual-risk` | string |  | Known residual risk statement for metrics |
+| `--json` | boolean | `false` |  |
+
+
+## `scale verify`
+
+VERIFY: Run Gates G3-G7 (/test)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task-id` | positional |  |  |
+| `--build-cmd` | string |  | Override build command |
+| `--lint-cmd` | string |  | Override lint command |
+| `--test-cmd` | string |  | Override test command |
+| `--coverage-cmd` | string |  | Override coverage command |
+| `--profile` | string |  | Verification profile from .scale/verification.json |
+| `--service` | string |  | Service name from .scale/verification.json |
+| `--artifact-gate` | string |  | Task artifact policy override: off, warn, or block |
+| `--require-artifacts` | boolean | `false` | Fail verification when required M/L/CRITICAL artifacts are incomplete |
+| `--require-installed-skills` | boolean | `false` | Fail verification when required workflow skills are not installed locally |
+| `--tool-gate` | string |  | Tool evidence policy override: off, advisory, evidence-required, or block |
+| `--require-tool-evidence` | boolean | `false` | Fail verification when required tool execution evidence is missing or skipped |
+| `--allow-skipped-tool-evidence` | boolean | `false` | Allow skipped/manual fallback tool evidence to satisfy the tool gate |
+| `--tdd-evidence` | string |  | Path to JSON TDD evidence with red/green/refactor/testFirst=true |
+| `--tdd-strict` | boolean | `false` | Require TDD evidence before other gates |
+| `--residual-risk` | string |  | Residual risk statement to record in task metrics |
+| `--skip-build` | boolean | `false` |  |
+| `--skip-lint` | boolean | `false` |  |
+| `--skip-test` | boolean | `false` |  |
+| `--json` | boolean | `false` |  |
+
+
+## `scale review`
+
+REVIEW: Code review with Karpathy Principles (/review)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task-id` | positional |  |  |
+| `--check-security` | boolean | `true` |  |
+| `--check-style` | boolean | `true` |  |
+| `--format` | string |  | Output format: html or md (default: html) |
+| `--brand` | string |  | Brand theme for HTML output (vercel/stripe/notion/linear/github) |
+| `--json` | boolean | `false` |  |
+
+
+## `scale ship`
+
+SHIP: Commit with HonestDelivery Report (/ship)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task-id` | positional |  |  |
+| `--message` | string |  | Commit message |
+| `--no-commit` | boolean | `false` | Skip git commit |
+| `--skip-commit` | boolean | `false` | Skip git commit |
+| `--json` | boolean | `false` |  |
+
+
+## `scale run`
+
+RUN: End-to-end workflow (define → plan → build → verify → review → ship)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--title` | positional |  | Task title |
+| `--description` | string |  | Task description |
+| `--level` | string |  | Task level (S/M/L/CRITICAL). Auto-detected if omitted. |
+| `--success-criteria` | string |  | Comma-separated success criteria |
+| `--skip-phases` | string |  | Comma-separated phases to skip (define,plan,build,verify,review,ship) |
+| `--no-stop` | boolean | `false` | Continue on phase failure instead of stopping |
+| `--no-commit` | boolean | `false` | Skip git commit in ship phase |
+| `--json` | boolean | `false` |  |
+
+
+## `scale init`
+
+Initialize SCALE Engine governance in current project (one-click bootstrap, not third-party auto-install)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--agent` | string | `` | Agent type (claude-code/codex/opencode/cursor/gemini/openclaw/hermes/trae/workbuddy/vsc/qcoder/deepseek-tui/aider/windsurf/kimi/doubao/kiro/qoder/jcode/cline/kilocode/antigravity) - auto-detected if not specified |
+| `--dir` | string | `.` | Project directory |
+| `--json` | boolean | `false` | Output initialization result as JSON |
+| `--scenario` | string | `standard` | Scenario mode (sandbox/standard/critical) |
+| `--governance-pack` | string | `standard` | Governance template pack (standard/project-scaffold/scale-engine-repo/moe-workspace/resource-governance/go-service-matrix/node-library/frontend-app) |
+| `--quick` | boolean | `false` | Quick start with auto-detection |
+| `--interactive` | boolean | `false` | Interactive configuration mode with prompts |
+| `--profile` | string | `` | Configuration profile (minimal/standard/advanced). Auto-mapped from scenario if not specified |
+| `--coverage-threshold` | string | `80` | Coverage threshold (default 80%) |
+| `--retry-threshold` | string | `3` | Brute retry threshold (default 3) |
+| `--block-severity` | string | `CRITICAL` | Block severity level (CRITICAL/HIGH/MEDIUM) |
+
+
+## `scale setup`
+
+Interactive SCALE setup for third-party skills, CLIs, memory, and knowledge providers
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--pack` | string | `` | Comma-separated packs: ui,memory,knowledge,external-cli,full. Defaults to full unless --profile is supplied. |
+| `--profile` | string |  | Resolve recommended packs from profile: minimal, standard, advanced |
+| `--governance-pack` | string |  | Optional governance pack hint, for example frontend-app -> ui |
+| `--include` | string |  | Additional dependency ids to include explicitly |
+| `--apply` | boolean | `false` | Run install commands for ready dependencies |
+| `--yes` | boolean | `false` | Confirm installation without prompting |
+| `--verify` | boolean | `false` | Verify governed setup and dependency readiness instead of running the setup wizard |
+| `--interactive` | boolean | `true` | Prompt before installation when dependencies are ready |
+| `--lang` | string |  | Output language zh/en. Defaults to zh, then SCALE_LANG, then .scale/config.yaml locale. |
+| `--memory-provider` | string |  | Switch memory provider during setup: gbrain, agentmemory, or scale-local |
+| `--memory-mode` | string |  | Memory routing mode: auto, local-only, external-first |
+| `--memory-endpoint` | string |  | Optional endpoint to persist for the selected memory provider |
+| `--memory-write-mode` | string |  | Memory write mode: disabled, candidate-only, enabled |
+| `--allow-external-write` | boolean | `false` | Explicitly allow external memory writes in provider routing |
+| `--json` | boolean | `false` | Output setup report as JSON |
+
+
+## `scale bootstrap`
+
+Bootstrap third-party workflow dependencies with explicit install intent
+
+
+### `scale bootstrap deps`
+
+Plan or install third-party skills, CLI dependencies, and project post-configuration
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--pack` | string | `` | Comma-separated packs: ui,memory,knowledge,external-cli,full. Defaults to full unless --profile is supplied. |
+| `--profile` | string |  | Resolve recommended packs from profile: minimal, standard, advanced |
+| `--governance-pack` | string |  | Optional governance pack hint, for example frontend-app -> ui |
+| `--include` | string |  | Additional dependency ids to include explicitly |
+| `--apply` | boolean | `false` | Run install commands for ready dependencies |
+| `--lang` | string |  | Output language zh/en. Defaults to zh, then SCALE_LANG, then .scale/config.yaml locale. |
+| `--json` | boolean | `false` | Output bootstrap plan as JSON |
+
+
+## `scale doctor`
+
+Diagnose SCALE Engine health
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--scope` | positional |  | Optional diagnostic scope: env |
+| `--dir` | string | `.` | Project directory |
+| `--json` | boolean | `false` | Output as JSON |
+
+
+## `scale session`
+
+Session lifecycle
+
+
+### `scale session start`
+
+Start a new session
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--agent` | string | `claude-code` |  |
+| `--session-id` | string |  |  |
+
+
+### `scale session end`
+
+End current session
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--session-id` | string |  |  |
+
+
+## `scale gate`
+
+Guardrail gate commands
+
+
+### `scale gate pre-tool`
+
+Pre-tool gate check
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--tool` | positional |  |  |
+| `--args-json` | string | `{}` |  |
+| `--session-id` | string |  |  |
+
+
+### `scale gate post-tool`
+
+Post-tool event recording
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--tool` | positional |  |  |
+| `--args-json` | string | `{}` |  |
+| `--output-json` | string | `` |  |
+| `--exit-code` | string | `0` |  |
+| `--session-id` | string |  |  |
+
+
+### `scale gate before-stop`
+
+Before-stop gate check
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--session-id` | string |  |  |
+
+
+## `scale gates`
+
+Quality gate catalog and status commands
+
+
+### `scale gates status`
+
+Show active gate catalog, profiles, and policy-backed extension gates
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--scale-dir` | string | `.scale` | Scale governance directory |
+| `--profile` | string |  | Verification profile from .scale/verification.json |
+| `--service` | string |  | Service name from .scale/verification.json |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+## `scale meta-governance`
+
+Run meta-governance gates (G9-G15) — check if governance capabilities are actually used
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--scale-dir` | string | `.scale` |  |
+| `--json` | boolean | `false` | Output as JSON |
+
+
+## `scale create`
+
+Create an artifact
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--type` | positional |  |  |
+| `--title` | positional |  |  |
+| `--parent` | string |  |  |
+| `--payload` | string | `{}` |  |
+
+
+## `scale list`
+
+List artifacts
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--type` | string |  |  |
+| `--status` | string |  |  |
+| `--limit` | string | `20` |  |
+
+
+## `scale show`
+
+Show artifact details
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--id` | positional |  |  |
+
+
+## `scale suggest`
+
+Show available actions for an artifact
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--id` | positional |  |  |
+| `--json` | boolean | `false` |  |
+
+
+## `scale transition`
+
+Transition artifact state
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--id` | positional |  |  |
+| `--action` | positional |  |  |
+| `--reason` | string |  |  |
+
+
+## `scale verifyTask`
+
+Verify task code quality (build/lint/test)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--id` | positional |  |  |
+| `--build-cmd` | string | `npm run build` | Build command |
+| `--lint-cmd` | string | `npm run lint` | Lint command |
+| `--test-cmd` | string | `npm test` | Test command |
+| `--skip-build` | boolean | `false` | Skip build check |
+| `--skip-lint` | boolean | `false` | Skip lint check |
+| `--skip-test` | boolean | `false` | Skip test check |
+| `--json` | boolean | `false` | Output as JSON |
+
+
+## `scale role`
+
+Role management
+
+
+### `scale role activate`
+
+Activate a role
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--role` | positional |  |  |
+
+
+### `scale role show`
+
+Show current role
+
+
+## `scale context`
+
+Context assembly
+
+
+### `scale context build`
+
+Build context for current task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--session-id` | string |  |  |
+| `--artifact-id` | string |  |  |
+| `--role` | string |  |  |
+
+
+### `scale context status`
+
+Show session context status
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--session-id` | string |  |  |
+
+
+### `scale context inject`
+
+Inject FSM context for SessionStart hook
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--session-id` | string |  |  |
+
+
+### `scale context glossary`
+
+Show project domain glossary (借鉴 mattpocock/skills CONTEXT.md)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--json` | boolean | `false` | JSON output |
+
+
+### `scale context init`
+
+Create CONTEXT.md and CONTEXT-MAP.md starter templates
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--name` | string |  | Project display name |
+| `--force` | boolean | `false` | Overwrite existing templates |
+| `--json` | boolean | `false` |  |
+
+
+### `scale context grill`
+
+Check project context docs and generate request-specific grill questions
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--task-id` | string |  | Task id for workflow state and artifact linkage |
+| `--task` | string |  | Task or requirement description |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--artifact-dir` | string |  | Task artifact directory where explore.md should be updated |
+| `--write` | boolean | `false` | Append context grill output to the task explore artifact |
+| `--json` | boolean | `false` |  |
+
+
+### `scale context budget`
+
+Report Always/on-demand/evidence/archive/generated context token cost
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--max-always` | string |  | Maximum Always-loaded estimated tokens |
+| `--max-task` | string |  | Maximum task context estimated tokens |
+| `--provider` | string | `generic` | Model provider for prompt cache policy: anthropic, openai, or generic |
+| `--write` | boolean | `false` | Write .scale/context-budget.json |
+| `--json` | boolean | `false` |  |
+
+
+### `scale context pack`
+
+Build a lazy-loaded context pack for a task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--task` | string |  | Current task or question |
+| `--task-id` | string |  | Task id |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated files or modules in scope |
+| `--budget` | string |  | Maximum estimated tokens for the context pack |
+| `--json` | boolean | `false` |  |
+
+
+### `scale context doctor`
+
+Check context budget thresholds and generated-artifact loading risk
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--max-always` | string |  | Maximum Always-loaded estimated tokens |
+| `--max-task` | string |  | Maximum task context estimated tokens |
+| `--task` | string |  | Task text for a representative lazy context pack probe |
+| `--level` | string | `M` | Task level for the context pack probe |
+| `--files` | string |  | Comma-separated scoped files for the context pack probe |
+| `--json` | boolean | `false` |  |
+
+
+### `scale context anatomy`
+
+Scan the project and generate .scale/anatomy.md for file-map context
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--max-files` | string |  | Maximum files to include; defaults to 500 |
+| `--exclude` | string |  | Comma-separated directory names to exclude |
+| `--write` | boolean | `false` | Write .scale/anatomy.md |
+| `--json` | boolean | `false` |  |
+
+
+## `scale evolve`
+
+Run evolution cycle (Defect→Lesson→Rule→Hook)
+
+
+## `scale stats`
+
+Show engine stats
+
+
+## `scale preflight`
+
+Run service-aware verification without a task artifact
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--build-cmd` | string |  | Override build command |
+| `--lint-cmd` | string |  | Override lint command |
+| `--test-cmd` | string |  | Override test command |
+| `--coverage-cmd` | string |  | Override coverage command |
+| `--profile` | string |  | Verification profile from .scale/verification.json |
+| `--preflight-profile` | string | `quick` | Gate intensity profile (quick/full/ci); quick skips coverage and security |
+| `--service` | string |  | Service name from .scale/verification.json; use all for required services |
+| `--tdd-evidence` | string |  | Path to JSON TDD evidence with red/green/refactor/testFirst=true |
+| `--tdd-strict` | boolean | `false` | Require TDD evidence before other gates |
+| `--json` | boolean | `false` |  |
+
+
+## `scale upgrade`
+
+SCALE 工作流、模板、skills、MCP、CLI 工具的安全升级向导 / Safe update wizard for workflow assets
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | 项目目录 / Project directory |
+| `--target-version` | string |  | 目标 SCALE Engine 版本，默认使用当前 CLI 版本 / Target SCALE Engine version |
+| `--apply` | boolean | `false` | 直接应用安全升级计划 / Apply safe upgrade plan |
+| `--yes` | boolean | `false` | 非交互确认 / Confirm without prompting |
+| `--html` | boolean | `true` | 写入 HTML 升级计划 / Write HTML plan |
+| `--interactive` | boolean | `true` | 启用升级向导交互 / Enable upgrade wizard prompts |
+| `--lang` | string | `zh` | 输出语言 zh/en / Output language |
+| `--json` | boolean | `false` | 输出 JSON / Print JSON output |
+
+
+### `scale upgrade check`
+
+检查 SCALE 工作流、治理包和第三方能力更新状态 / Check SCALE workflow, governance pack, and third-party capability update status
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | 项目目录 / Project directory |
+| `--target-version` | string |  | 目标 SCALE Engine 版本，默认使用当前 CLI 版本 / Target SCALE Engine version |
+| `--lang` | string | `zh` | 输出语言 zh/en / Output language |
+| `--json` | boolean | `false` | 输出 JSON / Print JSON output |
+
+
+### `scale upgrade plan`
+
+生成非破坏性的 SCALE 升级计划 / Create a non-destructive SCALE upgrade plan
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | 项目目录 / Project directory |
+| `--target-version` | string |  | 目标 SCALE Engine 版本，默认使用当前 CLI 版本 / Target SCALE Engine version |
+| `--html` | boolean | `false` | 写入 .scale/reports/upgrade-plan.html / Write HTML plan |
+| `--lang` | string | `zh` | 输出语言 zh/en / Output language |
+| `--json` | boolean | `false` | 输出 JSON / Print JSON output |
+
+
+### `scale upgrade diff`
+
+显示受管文件的本地改动 vs SCALE 模板的差异 / Show local managed-file changes vs SCALE templates
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | 项目目录 / Project directory |
+| `--lang` | string | `zh` | 输出语言 zh/en / Output language |
+| `--json` | boolean | `false` | 输出 JSON / Print JSON output |
+
+
+### `scale upgrade apply`
+
+按已审阅计划安全应用升级 / Guarded entrypoint for applying an upgrade plan
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | 项目目录 / Project directory |
+| `--confirm` | boolean | `false` | 确认当前升级计划已经审阅 / Confirm the current plan was reviewed |
+| `--lang` | string | `zh` | 输出语言 zh/en / Output language |
+| `--json` | boolean | `false` | 输出 JSON / Print JSON output |
+
+
+### `scale upgrade rollback`
+
+回滚最近一次 SCALE 托管升级 / Roll back the latest SCALE-managed upgrade
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | 项目目录 / Project directory |
+| `--lang` | string | `zh` | 输出语言 zh/en / Output language |
+| `--json` | boolean | `false` | 输出 JSON / Print JSON output |
+
+
+## `scale governance`
+
+Governance template pack tools
+
+
+### `scale governance diff`
+
+Check generated governance files for drift
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+### `scale governance mode`
+
+Evaluate progressive governance mode from task text and changed files
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task` | string |  | Task or requirement description |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--requested-mode` | string |  | Requested governance mode: minimal, standard, expanded, or critical |
+| `--json` | boolean | `false` |  |
+
+
+### `scale governance roi`
+
+Report benefit and overhead signals for active governance modules
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--task-id` | string |  | Task id |
+| `--task` | string |  | Task or requirement description |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--requested-mode` | string |  | Requested governance mode |
+| `--code-query` | string |  | Optional code intelligence query to include in ROI |
+| `--symbol` | string |  | Optional symbol impact query to include in ROI |
+| `--json` | boolean | `false` |  |
+
+
+## `scale prompt`
+
+Prompt optimization and rewriting utilities
+
+
+### `scale prompt optimize`
+
+Rewrite a raw coding instruction into a structured executable prompt
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--input` | string |  | Raw prompt text |
+| `--title` | string |  | Optional task title |
+| `--language` | string | `auto` | Output language: auto, zh, or en |
+| `--level` | string |  | Task level hint: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated relevant files |
+| `--service` | string |  | Comma-separated relevant services |
+| `--success-criteria` | string |  | Comma-separated acceptance criteria |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+## `scale score`
+
+Algorithmic task quality and efficiency scoring
+
+
+### `scale score task`
+
+Compute deterministic task completion, quality, and efficiency score
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--scale-dir` | string | `.scale` | Scale governance directory |
+| `--task-id` | string |  | Task id for reporting |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--changed` | boolean | `false` | Score engineering standards against changed Git files only |
+| `--changed-files` | string |  | Comma or newline separated changed files to score |
+| `--warn-only` | boolean | `false` | Return zero even when score is below threshold |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+## `scale ai-os`
+
+AI Engineering OS runtime planning and governance orchestration
+
+
+### `scale ai-os adopt`
+
+Prepare a project for AI OS runtime use by running migrate, first dry-run, benchmark, and doctor
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--task-id` | string |  | Task id for the first adoption dry-run report |
+| `--task` | string |  | Task or adoption scenario description |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--services` | string |  | Comma-separated affected services |
+| `--budget` | string |  | Maximum estimated tokens for the adoption plan and benchmark |
+| `--requested-mode` | string |  | Requested governance mode: minimal, standard, expanded, or critical |
+| `--lang` | string | `en` | Output language zh/en |
+| `--benchmark-max-age-hours` | string |  | Maximum accepted benchmark report age in hours |
+| `--json` | boolean | `false` |  |
+
+
+### `scale ai-os status`
+
+Show AI OS closed-loop readiness across runtime, run, verification, dashboard, benchmark, and adoption evidence
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--lang` | string | `en` | Output language zh/en |
+| `--benchmark-max-age-hours` | string |  | Maximum accepted benchmark report age in hours |
+| `--json` | boolean | `false` |  |
+
+
+### `scale ai-os plan`
+
+Create a unified AI OS runtime plan for governance, context, memory, skills, and ROI
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--task-id` | string |  | Task id |
+| `--task` | string |  | Task or requirement description |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--services` | string |  | Comma-separated affected services |
+| `--budget` | string |  | Maximum estimated tokens for the context compiler |
+| `--requested-mode` | string |  | Requested governance mode: minimal, standard, expanded, or critical |
+| `--json` | boolean | `false` |  |
+
+
+### `scale ai-os run`
+
+Run the AI OS beta loop in dry-run or guarded mode and write an execution report
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--task-id` | string |  | Task id |
+| `--task` | string |  | Task or requirement description |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--services` | string |  | Comma-separated affected services |
+| `--budget` | string |  | Maximum estimated tokens for the context compiler |
+| `--requested-mode` | string |  | Requested governance mode: minimal, standard, expanded, or critical |
+| `--verify` | string |  | Comma-separated guarded verification commands to run without shell by default |
+| `--timeout` | string |  | Verification command timeout in milliseconds |
+| `--mode` | string |  | Run mode: dry-run or guarded |
+| `--dry-run` | boolean | `false` | Force dry-run mode without executing external commands |
+| `--allow-shell` | boolean | `false` | Allow shell execution for trusted local guarded runs |
+| `--json` | boolean | `false` |  |
+
+
+### `scale ai-os dashboard`
+
+Summarize AI OS runtime run reports and verification health
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--limit` | string |  | Maximum latest run rows to include |
+| `--json` | boolean | `false` |  |
+
+
+### `scale ai-os benchmark`
+
+Run fixed AI OS beta benchmark scenarios for context, memory, skill, governance, and dashboard metrics
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--budget` | string |  | Scenario context budget |
+| `--json` | boolean | `false` |  |
+
+
+### `scale ai-os migrate`
+
+Create or verify AI OS runtime state directories for this project
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+
+
+### `scale ai-os doctor`
+
+Check AI OS beta runtime readiness, dashboard health, and benchmark freshness
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--lang` | string | `en` | Output language zh/en |
+| `--benchmark-max-age-hours` | string |  | Maximum accepted benchmark report age in hours |
+| `--json` | boolean | `false` |  |
+
+
+## `scale codegraph`
+
+Adapter-first code intelligence and exploration ROI
+
+
+### `scale codegraph status`
+
+Inspect CodeGraph, Graphify, and fallback code intelligence providers
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+
+
+### `scale codegraph init`
+
+Create .scale/code-intelligence.json provider configuration
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--force` | boolean | `false` | Overwrite existing configuration |
+| `--json` | boolean | `false` |  |
+
+
+### `scale codegraph query`
+
+Query code intelligence providers, with explicit fallback when graph data is unavailable
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--query` | positional |  | Symbol, function, class, route, or text query |
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+
+
+### `scale codegraph impact`
+
+Find likely impacted files for a symbol
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--symbol` | string |  | Symbol to analyze |
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+
+
+### `scale codegraph context`
+
+Build a budgeted file context recommendation from code intelligence
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--symbol` | string |  | Symbol to analyze |
+| `--budget` | string |  | Maximum estimated tokens for recommended files |
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+
+
+### `scale codegraph roi`
+
+Estimate exploration ROI from code intelligence or fallback query results
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--query` | string |  | Text query |
+| `--symbol` | string |  | Symbol to analyze |
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+
+
+## `scale eval`
+
+Workflow eval harness, pass@k metrics, and failure replay
+
+
+### `scale eval init`
+
+Create a lightweight workflow eval suite under .scale/evals
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--suite` | string | `workflow-baseline` | Suite id |
+| `--force` | boolean | `false` | Overwrite the existing suite file |
+| `--json` | boolean | `false` |  |
+
+
+### `scale eval run`
+
+Run a workflow eval suite and preserve failure replay artifacts
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--suite` | string | `workflow-baseline` | Suite id or JSON path |
+| `--json` | boolean | `false` |  |
+
+
+### `scale eval compare`
+
+Compare two workflow eval runs by pass rate, iterations, tool calls, and token estimate
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--baseline` | string |  | Baseline run id or JSON path |
+| `--candidate` | string |  | Candidate run id or JSON path |
+| `--json` | boolean | `false` |  |
+
+
+### `scale eval report`
+
+Render a Markdown workflow eval report from a saved run
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--run` | string |  | Run id or JSON path |
+| `--output` | string |  | Write report to a Markdown file |
+| `--json` | boolean | `false` |  |
+
+
+### `scale eval failures`
+
+List failure replay records for workflow improvement
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--task-id` | string |  | Filter by task/case id |
+| `--since` | string | `30d` | Window such as 30d; use all for no date filter |
+| `--json` | boolean | `false` |  |
+
+
+### `scale eval replay`
+
+Show failure replay records by failure id or task id
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--id` | positional |  | Failure replay id |
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--task-id` | string |  | Task/case id to replay |
+| `--json` | boolean | `false` |  |
+
+
+### `scale eval promote-failure`
+
+Promote a failure replay into a workflow improvement candidate
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--id` | positional |  | Failure replay id |
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+
+
+## `scale artifact`
+
+Derived HTML artifact rendering and safety checks
+
+
+### `scale artifact render`
+
+Render a task Markdown source set into a governed HTML artifact
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id under docs/worklog/tasks |
+| `--artifact-dir` | string |  | Task artifact directory override |
+| `--type` | string | `release-report` | HTML artifact type |
+| `--source` | string |  | Comma or newline separated source Markdown files relative to the task directory |
+| `--theme` | string | `auto` | Theme mode: dark/light/auto |
+| `--lang` | string | `zh` | HTML language: zh/en |
+| `--title` | string |  | HTML document title override |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+### `scale artifact doctor`
+
+Check HTML artifacts for traceability, stale sources, remote assets, and secret-like content
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id under docs/worklog/tasks |
+| `--artifact-dir` | string |  | Task artifact directory override |
+| `--type` | string |  | Optional HTML artifact type to check |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+### `scale artifact settle`
+
+Record HTML artifact settlement evidence for a task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id under docs/worklog/tasks |
+| `--artifact-dir` | string |  | Task artifact directory override |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+### `scale artifact open`
+
+Open or print the local file URL for a rendered HTML artifact
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id under docs/worklog/tasks |
+| `--artifact-dir` | string |  | Task artifact directory override |
+| `--type` | string |  | Optional HTML artifact type to open |
+| `--print-only` | boolean | `false` | Only print the file URL without launching a browser |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+### `scale artifact dashboard`
+
+Render a governance HTML dashboard from runtime, eval, memory, resource, and artifact evidence
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Optional task id to scope runtime/eval evidence and task HTML artifacts |
+| `--output` | string |  | Output HTML path; defaults to .scale/reports/governance-dashboard.html |
+| `--theme` | string | `auto` | Theme mode: dark/light/auto |
+| `--lang` | string | `zh` | HTML language: zh/en |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+## `scale assets`
+
+Resource lifecycle governance for generated and maintained project assets
+
+
+### `scale assets scan`
+
+Classify project docs, reports, media, scripts, and temporary outputs
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+### `scale assets doctor`
+
+Find resource lifecycle and Git policy problems
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+### `scale assets settle`
+
+Record resource lifecycle settlement evidence for a task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id for the settlement record |
+| `--artifact-dir` | string |  | Task artifact directory where resource-impact.md should be updated |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+## `scale standards`
+
+Engineering standards governance for logs, security, architecture, database, and code quality
+
+
+### `scale standards scan`
+
+Scan source files for engineering standard violations
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--changed` | boolean | `false` | Scan changed Git files only |
+| `--changed-files` | string |  | Comma or newline separated file list to scan |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+### `scale standards doctor`
+
+Find blocking engineering standards problems
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--changed` | boolean | `false` | Scan changed Git files only |
+| `--changed-files` | string |  | Comma or newline separated file list to scan |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+### `scale standards settle`
+
+Record engineering standards settlement evidence for a task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id for the settlement record |
+| `--artifact-dir` | string |  | Task artifact directory where standards-impact.md should be updated |
+| `--changed` | boolean | `false` | Scan changed Git files only |
+| `--changed-files` | string |  | Comma or newline separated file list to scan |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+### `scale standards baseline`
+
+Generate a legacy standards baseline and classification report
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--write` | boolean | `false` | Write .scale/engineering-standards-baseline.json |
+| `--task-id` | string |  | Task id for the legacy debt report |
+| `--artifact-dir` | string |  | Directory where standards-legacy-debt.md should be written |
+| `--reason` | string | `legacy standards debt accepted for staged remediation` | Reason recorded on generated baseline entries |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+## `scale metrics`
+
+Inspect workflow task metrics
+
+
+### `scale metrics list`
+
+List M/L task workflow metrics
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--json` | boolean | `false` |  |
+
+
+## `scale task-artifacts`
+
+Inspect task artifact completeness
+
+
+### `scale task-artifacts check`
+
+Check task artifact completeness
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string |  | Task artifact directory; defaults to .scale/state/current.json artifactsDir |
+| `--level` | string |  | Task level: S, M, L, or CRITICAL; defaults to current state level or M |
+| `--warn-only` | boolean | `false` | Return zero even when artifacts are incomplete |
+| `--json` | boolean | `false` |  |
+
+
+## `scale workspace`
+
+Inspect worktree, branch, and child repository lifecycle safety
+
+
+### `scale workspace map`
+
+Resolve or write explicit workspace topology for single, monorepo, polyrepo, submodule, or MOE projects
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string |  | Project directory; defaults to current project directory |
+| `--topology` | string | `moe` | Starter topology for --write (single/monorepo/polyrepo/submodule-workspace/moe) |
+| `--write` | boolean | `false` | Create .scale/workspace.json when it does not exist |
+| `--json` | boolean | `false` |  |
+
+
+### `scale workspace status`
+
+Inspect root worktree and child repository lifecycle state
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string |  | Repository or worktree directory; defaults to current project directory |
+| `--summary` | boolean | `false` | Print concise human summary instead of the full repository listing |
+| `--json` | boolean | `false` |  |
+
+
+### `scale workspace finish`
+
+Check whether a temporary worktree can be safely finished or cleaned up
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string |  | Repository or worktree directory; defaults to current project directory |
+| `--summary` | boolean | `false` | Print concise human summary instead of the full repository listing |
+| `--json` | boolean | `false` |  |
+
+
+### `scale workspace cleanup`
+
+Dry-run or apply safe removal of a linked temporary worktree
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string |  | Linked worktree directory; defaults to current project directory |
+| `--dry-run` | boolean | `false` | Preview cleanup; this is the default unless --apply is set |
+| `--apply` | boolean | `false` | Actually run git worktree remove after safety checks |
+| `--confirm` | string |  | Required confirmation token for --apply, usually the worktree branch name |
+| `--summary` | boolean | `false` | Print concise human summary before the cleanup plan |
+| `--json` | boolean | `false` |  |
+
+
+## `scale status`
+
+Show current SCALE workflow status
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--json` | boolean | `false` |  |
+
+
+## `scale workflow`
+
+Workflow preset management
+
+
+### `scale workflow list`
+
+List all workflow presets
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--scenario` | string |  | Filter by scenario mode (sandbox/standard/critical) |
+| `--json` | boolean | `false` | Output workflow presets as JSON |
+
+
+## `scale evidence`
+
+Persisted gate evidence inspection
+
+
+### `scale evidence list`
+
+List persisted gate evidence records
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--limit` | string | `20` | Maximum number of records |
+| `--json` | boolean | `false` |  |
+
+
+### `scale evidence show`
+
+Show a persisted gate evidence record
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--id` | positional |  |  |
+| `--json` | boolean | `false` |  |
+
+
+## `scale runtime`
+
+Runtime session ledger and completion evidence governance
+
+
+### `scale runtime start`
+
+Start a runtime session ledger
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--session-id` | string |  | Session id; generated when omitted |
+| `--task-id` | string |  | Task id linked to this session |
+| `--agent` | string |  | Agent name |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--summary` | string |  | Short session summary |
+| `--json` | boolean | `false` |  |
+
+
+### `scale runtime end`
+
+End the current or named runtime session
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--session-id` | string |  | Session id; current session is used when omitted |
+| `--status` | string | `completed` | completed, failed, or abandoned |
+| `--summary` | string |  | Completion summary |
+| `--json` | boolean | `false` |  |
+
+
+### `scale runtime record`
+
+Record command, gate, tool, browser, skill, or manual runtime evidence
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task-id` | string |  | Task id linked to this evidence |
+| `--session-id` | string |  | Session id linked to this evidence |
+| `--kind` | string | `command` | command, gate, tool, skill, mcp, browser, desktop, manual, final-report |
+| `--title` | string |  | Evidence title |
+| `--status` | string |  | passed, failed, or skipped |
+| `--command` | string |  | Exact command or tool invocation, with secrets redacted by SCALE |
+| `--exit-code` | string |  | Exit code when applicable |
+| `--summary` | string |  | Short output summary |
+| `--artifacts` | string |  | Comma-separated artifact paths |
+| `--provider` | string |  | Optional model provider when attaching model usage: anthropic, openai, codex, etc. |
+| `--model` | string |  | Optional model id when attaching model usage |
+| `--usage-json` | string |  | Raw provider response or usage JSON to normalize into the usage ledger |
+| `--usage-file` | string |  | Path to a JSON file containing a raw provider response or usage payload |
+| `--input-tokens` | string |  | Explicit input token count; overrides usage JSON when provided |
+| `--output-tokens` | string |  | Explicit output token count; overrides usage JSON when provided |
+| `--cache-eligible-tokens` | string |  | Explicit cache-eligible token count |
+| `--cache-creation-input-tokens` | string |  | Explicit Anthropic cache creation token count |
+| `--cache-read-input-tokens` | string |  | Explicit Anthropic cache read token count |
+| `--cached-tokens` | string |  | Explicit OpenAI cached token count |
+| `--estimated-cost-usd` | string |  | Optional estimated cost in USD |
+| `--timestamp` | string |  | Optional ISO timestamp for the usage record |
+| `--metadata-json` | string | `{}` | Additional JSON metadata |
+| `--json` | boolean | `false` |  |
+
+
+### `scale runtime doctor`
+
+Check runtime session and completion evidence
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task-id` | string |  | Task id to inspect |
+| `--session-id` | string |  | Session id to inspect |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--json` | boolean | `false` |  |
+
+
+### `scale runtime final-check`
+
+Block final delivery claims without passed runtime evidence
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task-id` | string |  | Task id to inspect |
+| `--session-id` | string |  | Session id to inspect |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--json` | boolean | `false` |  |
+
+
+## `scale token`
+
+Record and audit real model token usage
+
+
+### `scale token record`
+
+Record real model usage from provider usage payloads or explicit token counts
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--provider` | string |  | Model provider: anthropic, openai, codex, etc. |
+| `--model` | string |  | Optional model id |
+| `--task-id` | string |  | Task id linked to this model usage |
+| `--session-id` | string |  | Session id linked to this model usage |
+| `--usage-json` | string |  | Raw provider response or usage JSON to normalize into the usage ledger |
+| `--usage-file` | string |  | Path to a JSON file containing a raw provider response or usage payload |
+| `--input-tokens` | string |  | Explicit input token count; overrides usage JSON when provided |
+| `--output-tokens` | string |  | Explicit output token count; overrides usage JSON when provided |
+| `--cache-eligible-tokens` | string |  | Explicit cache-eligible token count |
+| `--cache-creation-input-tokens` | string |  | Explicit Anthropic cache creation token count |
+| `--cache-read-input-tokens` | string |  | Explicit Anthropic cache read token count |
+| `--cached-tokens` | string |  | Explicit OpenAI cached token count |
+| `--estimated-cost-usd` | string |  | Optional estimated cost in USD |
+| `--timestamp` | string |  | Optional ISO timestamp |
+| `--metadata-json` | string | `{}` | Additional JSON metadata |
+| `--json` | boolean | `false` |  |
+
+
+### `scale token report`
+
+Summarize recorded model usage by day, provider, model, and task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--day` | string |  | Exact UTC day in YYYY-MM-DD format |
+| `--since` | string |  | ISO timestamp lower bound |
+| `--until` | string |  | ISO timestamp upper bound |
+| `--since-days` | string | `7d` | Relative time window when day/since/until are omitted; use all to disable |
+| `--provider` | string |  | Filter by provider |
+| `--model` | string |  | Filter by model id |
+| `--task-id` | string |  | Filter by task id |
+| `--session-id` | string |  | Filter by session id |
+| `--limit` | string |  | Maximum recent records to include in the report; defaults to 20 |
+| `--json` | boolean | `false` |  |
+
+
+## `scale memory`
+
+Memory Fabric context packs and project-scoped long-term memory
+
+
+### `scale memory pack`
+
+Build a compact context pack from runtime evidence, session events, knowledge, and graph status
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task` | string |  | Current task or question |
+| `--task-id` | string |  | Task id to scope evidence and session data |
+| `--session-id` | string |  | Session id to scope session events |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated files or modules in scope |
+| `--budget` | string |  | Maximum estimated tokens for the context pack |
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory doctor`
+
+Check whether a task context pack is available and within token budget
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task` | string |  | Current task or question |
+| `--task-id` | string |  | Task id to scope evidence and session data |
+| `--session-id` | string |  | Session id to scope session events |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated files or modules in scope |
+| `--budget` | string |  | Maximum estimated tokens for the context pack |
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory cerebrum`
+
+Maintain .scale/cerebrum.md do-not-repeat rules and preferences
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--type` | string |  | Optional entry type: preference or do-not-repeat |
+| `--pattern` | string |  | Pattern for do-not-repeat entries |
+| `--description` | string |  | Entry description or preference text |
+| `--tags` | string |  | Comma-separated tags for preferences |
+| `--write` | boolean | `false` | Write .scale/cerebrum.md |
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory settle`
+
+Settle runtime evidence into a reviewable memory learning candidate
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task` | string |  | Current task or question |
+| `--task-id` | string |  | Task id to scope evidence and session data |
+| `--session-id` | string |  | Session id to scope session events |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated files or modules in scope |
+| `--budget` | string |  | Maximum estimated tokens for the context pack |
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory ingest`
+
+Ingest runtime evidence, learning candidates, or failure replays into the project memory brain
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--from` | string | `evidence` | Source: evidence, candidate, or failure |
+| `--task-id` | string |  | Task id to scope runtime evidence |
+| `--session-id` | string |  | Session id to scope runtime evidence |
+| `--candidate-id` | string |  | Memory learning candidate id |
+| `--failure-id` | string |  | Workflow eval failure replay id |
+| `--type` | string |  | Memory type override: fact/decision/incident/relation/contradiction |
+| `--scope` | string |  | Memory scope: project/workspace/global-candidate |
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory query`
+
+Query concise project-scoped long-term memory with evidence references
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--query` | positional |  | Search query |
+| `--limit` | string | `8` | Maximum number of memory nodes |
+| `--status` | string |  | Filter by status: candidate/active/stale/rejected |
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory contradictions`
+
+Report conflicting project memory instead of silently resolving it
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory dream`
+
+Run memory maintenance: duplicates, stale memories, contradictions, and promotion candidates
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory promote`
+
+Promote a memory candidate to active project memory after evidence review
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--id` | positional |  | Memory node id or learning candidate id |
+| `--scope` | string |  | Scope override: project/workspace/global-candidate |
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory export`
+
+Export project memory as JSONL
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--output` | string |  | Output JSONL file; stdout when omitted |
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory import`
+
+Import project memory from JSONL
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--file` | positional |  | Input JSONL file |
+| `--json` | boolean | `false` |  |
+
+
+### `scale memory provider`
+
+Manage autonomous memory provider routing for agentmemory, gbrain, and scale-local
+
+
+#### `scale memory provider init`
+
+Create .scale/memory-providers.json for autonomous memory provider routing
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--force` | boolean | `false` | Overwrite existing provider configuration |
+| `--json` | boolean | `false` |  |
+
+
+#### `scale memory provider status`
+
+Inspect memory provider routing, availability, and safety boundaries
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--json` | boolean | `false` |  |
+
+
+#### `scale memory provider recall`
+
+Recall relevant memory through provider routing with local fallback
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--query` | positional |  | Memory query or task context |
+| `--task` | string |  | Optional task text for provider routing context |
+| `--files` | string |  | Comma-separated files or modules in scope |
+| `--provider` | string |  | Force one provider id, such as agentmemory, gbrain, or scale-local |
+| `--limit` | string | `5` | Maximum results |
+| `--include-candidates` | boolean | `false` | Allow scale-local candidate memory fallback |
+| `--json` | boolean | `false` |  |
+
+
+#### `scale memory provider use`
+
+Promote one memory provider to the front of routing and persist the selection
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--provider` | positional |  | Provider id: gbrain, agentmemory, or scale-local |
+| `--mode` | string |  | Optional routing mode override: auto, local-only, external-first |
+| `--endpoint` | string |  | Optional provider endpoint to persist while switching |
+| `--write-mode` | string |  | Optional provider write mode: disabled, candidate-only, enabled |
+| `--allow-external-write` | boolean | `false` | Persist external write allowance when explicitly switching |
+| `--json` | boolean | `false` |  |
+
+
+## `scale diagnose`
+
+Evidence-first debugging workflows
+
+
+### `scale diagnose plan`
+
+Create a reproducible diagnostic loop before fixing a bug
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task-id` | string |  |  |
+| `--symptom` | string |  |  |
+| `--repro` | string |  | Command that reproduces the current failure |
+| `--expected-failure` | string |  | Expected failing behavior or assertion |
+| `--files` | string |  | Comma-separated changed or suspicious files |
+| `--verify` | string |  | Comma-separated verification commands after the fix |
+| `--artifact-dir` | string |  | Task artifact directory where plan.md should be updated |
+| `--write` | boolean | `false` | Append diagnostic loop output to the task plan artifact |
+| `--json` | boolean | `false` |  |
+
+
+## `scale hunt`
+
+Readonly proactive governance scans
+
+
+### `scale hunt scan`
+
+Run a readonly proactive governance scan
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--changed` | boolean | `false` | Scan changed Git files only |
+| `--changed-files` | string |  | Comma or newline separated file list to scan |
+| `--json` | boolean | `false` |  |
+
+
+### `scale hunt report`
+
+Print open and ignored hunt findings
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--changed` | boolean | `false` | Scan changed Git files only |
+| `--changed-files` | string |  | Comma or newline separated file list to scan |
+| `--json` | boolean | `false` |  |
+
+
+### `scale hunt diagnose`
+
+Create a diagnostic loop from a hunt finding
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--id` | positional |  | Hunt finding id |
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--changed` | boolean | `false` | Scan changed Git files only |
+| `--changed-files` | string |  | Comma or newline separated file list to scan |
+| `--json` | boolean | `false` |  |
+
+
+### `scale hunt ignore`
+
+Ignore a stable hunt finding fingerprint
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--id` | positional |  | Hunt finding id |
+| `--reason` | string |  | Why this finding is accepted or deferred |
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--changed` | boolean | `false` | Scan changed Git files only |
+| `--changed-files` | string |  | Comma or newline separated file list to scan |
+| `--json` | boolean | `false` |  |
+
+
+## `scale dependency`
+
+Supply-chain dependency governance
+
+
+### `scale dependency audit`
+
+Audit lockfile-scoped dependency supply-chain risk
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--mode` | string |  | Audit mode: compatibility, strict, or offline |
+| `--changed-packages` | string |  | Comma-separated package names to audit instead of direct dependencies |
+| `--json` | boolean | `false` |  |
+
+
+## `scale tdd`
+
+TDD vertical slice workflows
+
+
+### `scale tdd slice`
+
+Create and evaluate a TDD vertical slice
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task-id` | string |  |  |
+| `--behavior` | string |  |  |
+| `--public-interface` | string |  |  |
+| `--failing-test` | string |  |  |
+| `--test-file` | string |  |  |
+| `--impl-files` | string |  |  |
+| `--red-exit-code` | string |  | Exit code from the RED command |
+| `--red-summary` | string |  | Short RED output summary |
+| `--green-exit-code` | string |  | Exit code from the GREEN command |
+| `--green-summary` | string |  | Short GREEN output summary |
+| `--refactor-exit-code` | string |  | Exit code from the REFACTOR command |
+| `--refactor-summary` | string |  | Short REFACTOR output summary |
+| `--artifact-dir` | string |  | Task artifact directory where verification.md should be updated |
+| `--write` | boolean | `false` | Append TDD slice output to the task verification artifact |
+| `--json` | boolean | `false` |  |
+
+
+## `scale tool`
+
+Skills, MCP, browser, desktop, and external CLI governance
+
+
+### `scale tool policy`
+
+Show resolved tool orchestration policy
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--mode` | string |  | Render a starter policy mode instead of reading .scale/tools.json |
+| `--json` | boolean | `false` |  |
+
+
+### `scale tool doctor`
+
+Check skill, MCP, and CLI tool availability
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--tools` | string |  | Comma-separated tool ids to check |
+| `--json` | boolean | `false` |  |
+
+
+### `scale tool plan`
+
+Create a tool execution plan from task intent
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id for evidence linkage |
+| `--task` | string |  | Task description |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--services` | string |  | Comma-separated affected services |
+| `--json` | boolean | `false` |  |
+
+
+### `scale tool run`
+
+Run or dry-run a tool execution plan and write tool evidence
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id for evidence linkage |
+| `--task` | string |  | Task description |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--services` | string |  | Comma-separated affected services |
+| `--dry-run` | boolean | `false` | Plan and record skipped evidence without executing tools |
+| `--json` | boolean | `false` |  |
+
+
+### `scale tool evidence`
+
+Check required tool execution evidence for a task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id for evidence linkage |
+| `--task` | string |  | Task description |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--services` | string |  | Comma-separated affected services |
+| `--mode` | string |  | Override tool gate mode: off, advisory, evidence-required, or block |
+| `--allow-skipped` | boolean | `false` | Allow skipped/manual fallback evidence to satisfy required tools |
+| `--json` | boolean | `false` |  |
+
+
+### `scale tool outdated`
+
+List MCP, browser, desktop, and external CLI update surfaces without installing anything
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+## `scale tools`
+
+Skills, MCP, browser, desktop, and external CLI governance
+
+
+### `scale tools policy`
+
+Show resolved tool orchestration policy
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--mode` | string |  | Render a starter policy mode instead of reading .scale/tools.json |
+| `--json` | boolean | `false` |  |
+
+
+### `scale tools doctor`
+
+Check skill, MCP, and CLI tool availability
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--tools` | string |  | Comma-separated tool ids to check |
+| `--json` | boolean | `false` |  |
+
+
+### `scale tools plan`
+
+Create a tool execution plan from task intent
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id for evidence linkage |
+| `--task` | string |  | Task description |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--services` | string |  | Comma-separated affected services |
+| `--json` | boolean | `false` |  |
+
+
+### `scale tools run`
+
+Run or dry-run a tool execution plan and write tool evidence
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id for evidence linkage |
+| `--task` | string |  | Task description |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--services` | string |  | Comma-separated affected services |
+| `--dry-run` | boolean | `false` | Plan and record skipped evidence without executing tools |
+| `--json` | boolean | `false` |  |
+
+
+### `scale tools evidence`
+
+Check required tool execution evidence for a task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--task-id` | string |  | Task id for evidence linkage |
+| `--task` | string |  | Task description |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or target files |
+| `--services` | string |  | Comma-separated affected services |
+| `--mode` | string |  | Override tool gate mode: off, advisory, evidence-required, or block |
+| `--allow-skipped` | boolean | `false` | Allow skipped/manual fallback evidence to satisfy required tools |
+| `--json` | boolean | `false` |  |
+
+
+### `scale tools outdated`
+
+List MCP, browser, desktop, and external CLI update surfaces without installing anything
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+## `scale skill`
+
+Skill discovery and management
+
+
+### `scale skill scan`
+
+Scan for installed skills
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--json` | boolean | `false` | Output scan result as JSON |
+
+
+### `scale skill doctor`
+
+Check workflow skill installation status
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--supply-chain` | boolean | `false` | Include supply-chain safety review for known skill sources |
+| `--json` | boolean | `false` | Output skill doctor report as JSON |
+
+
+### `scale skill plan`
+
+Create or refresh a task skill plan
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task-id` | positional |  |  |
+| `--dir` | string |  | Task artifact directory; defaults to current state artifactsDir |
+| `--json` | boolean | `false` |  |
+
+
+### `scale skill check`
+
+Check required skill evidence artifacts
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string |  | Task artifact directory; defaults to current state artifactsDir |
+| `--level` | string |  | Task level: S, M, L, or CRITICAL; defaults to current state level or M |
+| `--require-installed` | boolean | `false` | Fail when required workflow skills are not installed locally |
+| `--json` | boolean | `false` |  |
+
+
+### `scale skill repo`
+
+Show SCALE progressive skill repository guide
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--category` | string |  | Filter by category: ui/browser/desktop/testing/review/docs/agent-cli/role-library/discovery |
+| `--output` | string |  | Write markdown guide to file |
+| `--json` | boolean | `false` |  |
+
+
+### `scale skill safety`
+
+Evaluate skill install command and source safety
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--source` | string |  | Skill source URL |
+| `--command` | string |  | Install command to review |
+| `--json` | boolean | `false` |  |
+
+
+### `scale skill radar`
+
+Recommend skills, MCP, and CLI capabilities with confidence, safety, and evidence requirements
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task` | string |  | Task description |
+| `--phase` | string |  | Workflow phase |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or relevant files |
+| `--services` | string |  | Comma-separated services or modules |
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--output` | string |  | Write markdown report to file |
+| `--json` | boolean | `false` | Output radar report as JSON |
+
+
+### `scale skill recommend`
+
+Recommend a composable skill workflow for a task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task` | string |  | Task description |
+| `--phase` | string |  | Workflow phase |
+| `--json` | boolean | `false` |  |
+
+
+### `scale skill outdated`
+
+List skill update surfaces without installing or upgrading anything
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+## `scale skills`
+
+Skill discovery and management
+
+
+### `scale skills scan`
+
+Scan for installed skills
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `.` | Project directory |
+| `--json` | boolean | `false` | Output scan result as JSON |
+
+
+### `scale skills doctor`
+
+Check workflow skill installation status
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--supply-chain` | boolean | `false` | Include supply-chain safety review for known skill sources |
+| `--json` | boolean | `false` | Output skill doctor report as JSON |
+
+
+### `scale skills plan`
+
+Create or refresh a task skill plan
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task-id` | positional |  |  |
+| `--dir` | string |  | Task artifact directory; defaults to current state artifactsDir |
+| `--json` | boolean | `false` |  |
+
+
+### `scale skills check`
+
+Check required skill evidence artifacts
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string |  | Task artifact directory; defaults to current state artifactsDir |
+| `--level` | string |  | Task level: S, M, L, or CRITICAL; defaults to current state level or M |
+| `--require-installed` | boolean | `false` | Fail when required workflow skills are not installed locally |
+| `--json` | boolean | `false` |  |
+
+
+### `scale skills repo`
+
+Show SCALE progressive skill repository guide
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--category` | string |  | Filter by category: ui/browser/desktop/testing/review/docs/agent-cli/role-library/discovery |
+| `--output` | string |  | Write markdown guide to file |
+| `--json` | boolean | `false` |  |
+
+
+### `scale skills safety`
+
+Evaluate skill install command and source safety
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--source` | string |  | Skill source URL |
+| `--command` | string |  | Install command to review |
+| `--json` | boolean | `false` |  |
+
+
+### `scale skills radar`
+
+Recommend skills, MCP, and CLI capabilities with confidence, safety, and evidence requirements
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task` | string |  | Task description |
+| `--phase` | string |  | Workflow phase |
+| `--level` | string | `M` | Task level: S, M, L, or CRITICAL |
+| `--files` | string |  | Comma-separated changed or relevant files |
+| `--services` | string |  | Comma-separated services or modules |
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--output` | string |  | Write markdown report to file |
+| `--json` | boolean | `false` | Output radar report as JSON |
+
+
+### `scale skills recommend`
+
+Recommend a composable skill workflow for a task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--task` | string |  | Task description |
+| `--phase` | string |  | Workflow phase |
+| `--json` | boolean | `false` |  |
+
+
+### `scale skills outdated`
+
+List skill update surfaces without installing or upgrading anything
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` | Print JSON output |
+
+
+## `scale agent`
+
+Multi-Agent system management
+
+
+### `scale agent spawn`
+
+Spawn a new agent instance
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--profile` | positional |  | Agent profile ID (e.g., frontend-agent) |
+
+
+### `scale agent list`
+
+List all agent instances
+
+
+### `scale agent profiles`
+
+List available agent profiles
+
+
+### `scale agent leaders`
+
+List SCALE leader presets such as CEO and CTO
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--output` | string |  | Write markdown guide to file |
+| `--json` | boolean | `false` |  |
+
+
+## `scale team`
+
+Agent team orchestration
+
+
+### `scale team create`
+
+Create an agent team for a task
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--profiles` | string |  | Comma-separated profile IDs |
+| `--task` | string |  | Task description |
+
+
+### `scale team status`
+
+Show team status
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--team` | positional |  | Team ID |
+
+
+## `scale create-prd`
+
+Create PRD hierarchy (Spec → Plan → Tasks)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--title` | positional |  |  |
+| `--specs` | string |  | Spec description |
+| `--plans` | string |  | Plan design |
+| `--tasks` | string |  | Task list (comma-separated) |
+| `--session-id` | string |  |  |
+
+
+## `scale out-of-scope`
+
+Manage out-of-scope knowledge base (rejected concepts with institutional memory)
+
+
+### `scale out-of-scope add`
+
+Record a rejected concept to the out-of-scope knowledge base
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--concept` | positional |  | kebab-case concept name |
+| `--title` | string |  | Human-readable title |
+| `--reason` | string |  | Why this was rejected |
+| `--tech-context` | string |  | Technical constraints that led to rejection |
+| `--prior-requests` | string |  | Comma-separated issue IDs or URLs |
+
+
+### `scale out-of-scope check`
+
+Check if a concept matches any existing out-of-scope entry
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--concept` | positional |  | Concept name to check |
+| `--description` | string |  | Optional description for fuzzy matching |
+
+
+### `scale out-of-scope list`
+
+List all out-of-scope entries
+
+
+### `scale out-of-scope remove`
+
+Remove an out-of-scope entry (concept reconsidered)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--concept` | positional |  | Concept name to remove |
+
+
+## `scale config`
+
+Configuration management
+
+
+### `scale config profile`
+
+View or switch configuration profile
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--set` | string | `` | Switch to profile (minimal/standard/advanced) |
+| `--governance-pack` | string |  | Optional governance pack hint for bootstrap suggestions, for example frontend-app |
+| `--list` | boolean | `false` | List all available profiles |
+| `--json` | boolean | `false` | Output as JSON |
+
+
+## `scale quickstart`
+
+One-command governance setup (30 seconds to your first gate)
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--pack` | string |  | Governance pack (auto-detected if omitted) |
+| `--profile` | string | `standard` | Profile (minimal\|standard\|critical) |
+
+
+## `scale tui`
+
+Interactive terminal UI dashboard for governance status
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+
+
+## `scale qa`
+
+Browser QA — E2E, visual regression, daemon management
+
+
+### `scale qa e2e`
+
+Run browser E2E test flow
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--url` | string |  | Base URL (default: http://localhost:3000) |
+| `--flow` | string |  | Flow file path (.scale/qa/flows/*.json) |
+| `--save-domain-skill` | boolean |  | Save successful selectors as domain skill |
+
+
+### `scale qa daemon`
+
+Manage persistent browser daemon
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--action` | positional |  | start\|stop\|status |
+
+
+## `scale auto-fix`
+
+Auto-detect and fix lint, test, and security failures — then re-verify
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--scope` | string | `all` | Scope: lint\|test\|security\|all |
+| `--max-attempts` | string | `3` | Max fix attempts per failure |
+| `--escalate` | boolean | `true` | Escalate model tier on retry |
+| `--dry-run` | boolean | `false` | Report what would be done without applying fixes |
+
+
+## `scale cost-report`
+
+Show token usage and estimated cost by model, task, and day
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--days` | string | `30` | Lookback days |
+| `--format` | string | `text` | Output format: text\|json |
+
+
+## `scale cost-optimize`
+
+Show cost optimization recommendations
+
+
+## `scale cross-review`
+
+Cross-model review — multiple models independently review a change
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--diff` | string |  | Git diff reference (e.g. HEAD~1) |
+| `--models` | string | `claude-sonnet` | Comma-separated model list |
+| `--files` | string |  | Specific files to review |
+
+
+## `scale shield`
+
+SCALE Shield — Deterministic hook-based governance interception
+
+
+### `scale shield compile`
+
+Compile .scale/policy.yaml into runtime hook scripts for all harnesses
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--no-patch` | boolean | `false` | Skip settings.json patching |
+
+
+### `scale shield status`
+
+Check Shield integrity — verify hooks match policy, paths protected
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+
+
+### `scale shield test`
+
+Test Shield rules against sample inputs — verify blocking behavior
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--json` | boolean | `false` |  |
+
+
+## `scale orch`
+
+SCALE Orchestrator — Declarative daemon-based orchestration
+
+
+### `scale orch start`
+
+Start the SCALE Orchestrator daemon for autonomous issue processing
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--foreground` | boolean | `false` | Run in foreground (blocking) |
+
+
+### `scale orch stop`
+
+Stop the SCALE Orchestrator daemon gracefully
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+
+
+### `scale orch status`
+
+Show SCALE Orchestrator daemon status and active workspaces
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+
+
+### `scale orch log`
+
+Show recent SCALE Orchestrator daemon log entries
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--lines` | string | `50` | Number of recent log lines |
+
+
+## `scale cortex`
+
+SCALE Cortex — Evidence-driven continuous learning and governance evolution
+
+
+### `scale cortex extract`
+
+Extract instincts from observation logs — detect failure patterns and create learning entries
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--min-confidence` | string | `0.5` | Minimum confidence threshold (0.3-0.9) |
+| `--json` | boolean | `false` |  |
+
+
+### `scale cortex inject`
+
+Preview what SCALE Cortex would inject at SessionStart — high-confidence instincts
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--minimal` | boolean | `false` | Show minimal (low-context) injection format |
+| `--json` | boolean | `false` |  |
+
+
+### `scale cortex metrics`
+
+Compute SCALE Cortex governance ROI — gate pass rates, instinct hit rates, cost savings
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--days` | string | `30` | Lookback period in days |
+| `--json` | boolean | `false` |  |
+
+
+### `scale cortex evolve`
+
+Run full Cortex evolution cycle: reflect → extract → save high-confidence instincts
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+
+
+### `scale cortex verify`
+
+Verify Cortex pipeline health — instinct store integrity, observation data, injection readiness
+
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `--dir` | string | `E:\project\yixue-scale-engine` | Project directory |
+| `--json` | boolean | `false` |  |
+