@hongmaple0820/scale-engine 0.14.0 → 0.15.0

package/dist/adapters/AiderAdapter.js

@@ -120,58 +120,58 @@ export class AiderAdapter {
         const stackLine = techStack.length > 0
             ? `\n## Tech Stack\n${techStack.map((t) => `- ${t}`).join('\n')}\n`
             : '';
-        return `# ${projectName}
-${stackLine}
-## SCALE Engine Integration (Aider)
-
-This project uses SCALE Engine for AI engineering governance via Aider CLI.
-
-### Commands
-- \`scale create <type> <title>\` — Create artifact
-- \`scale transition <id> <action>\` — Transition artifact state
-- \`scale list --type Spec\` — List artifacts
-- \`scale role activate <role>\` — Switch role
-- \`scale doctor\` — Health check
-
-### Workflow
-1. **Explore** → Role: explorer (Read/Grep only)
-2. **Plan** → Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
-3. **Implement** → Role: implementer (Edit/Write/Bash unlocked)
-4. **Verify** → Must run tests before claiming done
-5. **Learn** → Defects → Lessons → Rules → Hooks
-
-### Rules
-- 🔴 Dangerous commands are physically blocked
-- 🔴 Hardcoded secrets are blocked on Edit/Write
-- 🟡 3 identical retries triggers brute-retry detection
-- 🟡 Claiming done without running tests is blocked
-- 🟢 All tool calls are tracked in .scale/events/
-
-### Aider-Specific Notes
-- Aider uses \`/add\` and \`/drop\` to manage context files
-- Use \`/run\` for shell commands (SCALE hooks apply)
-- Use \`/clear\` to reset context between phases
-- SCALE hooks are defined in \`.aider.conf.yml\`
-
-### Quick Reference
-\`\`\`
-# Start with exploration
-> /add src/
-> /read AIDER.md
-
-# Plan phase
-> scale create Spec "Feature name"
-
-# Implement
-> scale role activate implementer
-> (make changes)
-
-# Verify
-> /run npm test
-
-# Complete
-> scale transition <id> approve
-\`\`\`
+        return `# ${projectName}
+${stackLine}
+## SCALE Engine Integration (Aider)
+
+This project uses SCALE Engine for AI engineering governance via Aider CLI.
+
+### Commands
+- \`scale create <type> <title>\` — Create artifact
+- \`scale transition <id> <action>\` — Transition artifact state
+- \`scale list --type Spec\` — List artifacts
+- \`scale role activate <role>\` — Switch role
+- \`scale doctor\` — Health check
+
+### Workflow
+1. **Explore** → Role: explorer (Read/Grep only)
+2. **Plan** → Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
+3. **Implement** → Role: implementer (Edit/Write/Bash unlocked)
+4. **Verify** → Must run tests before claiming done
+5. **Learn** → Defects → Lessons → Rules → Hooks
+
+### Rules
+- 🔴 Dangerous commands are physically blocked
+- 🔴 Hardcoded secrets are blocked on Edit/Write
+- 🟡 3 identical retries triggers brute-retry detection
+- 🟡 Claiming done without running tests is blocked
+- 🟢 All tool calls are tracked in .scale/events/
+
+### Aider-Specific Notes
+- Aider uses \`/add\` and \`/drop\` to manage context files
+- Use \`/run\` for shell commands (SCALE hooks apply)
+- Use \`/clear\` to reset context between phases
+- SCALE hooks are defined in \`.aider.conf.yml\`
+
+### Quick Reference
+\`\`\`
+# Start with exploration
+> /add src/
+> /read AIDER.md
+
+# Plan phase
+> scale create Spec "Feature name"
+
+# Implement
+> scale role activate implementer
+> (make changes)
+
+# Verify
+> /run npm test
+
+# Complete
+> scale transition <id> approve
+\`\`\`
 `;
     }
     async init(config) {

package/dist/adapters/ClaudeCodeAdapter.js

@@ -161,11 +161,11 @@ This project uses SCALE Engine for AI engineering governance.
             writeFileSync(gitignorePath, `# SCALE Engine runtime data
 *.db
 *.db-journal
-events/
-checkpoints/
-evidence/
-state/
-hooks/*.sh
+events/
+checkpoints/
+evidence/
+state/
+hooks/*.sh
 `, 'utf-8');
             created.push(gitignorePath);
         }

package/dist/adapters/DeepSeekTuiAdapter.js

@@ -242,11 +242,11 @@ define → plan → build → verify → review → ship
 *.db
 *.db-shm
 *.db-wal
-events/
-checkpoints/
-evidence/
-state/
-hooks/*.sh
+events/
+checkpoints/
+evidence/
+state/
+hooks/*.sh
 `, 'utf-8');
             created.push(gitignorePath);
         }

package/dist/adapters/DoubaoAdapter.js

@@ -75,39 +75,39 @@ export class DoubaoAdapter {
         const stackLine = techStack.length > 0
             ? `\n## Tech Stack\n${techStack.map((t) => `- ${t}`).join('\n')}\n`
             : '';
-        return `# ${projectName}
-${stackLine}
-## SCALE Engine Integration (Doubao)
-
-This project uses SCALE Engine for AI engineering governance via Doubao (ByteDance AI).
-
-### Commands
-- \`scale create <type> <title>\` — Create artifact
-- \`scale transition <id> <action>\` — Transition artifact state
-- \`scale list --type Spec\` — List artifacts
-- \`scale role activate <role>\` — Switch role
-- \`scale doctor\` — Health check
-
-### Workflow
-1. **Explore** → Role: explorer (Read/Grep only)
-2. **Plan** → Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
-3. **Implement** → Role: implementer (Edit/Write/Bash unlocked)
-4. **Verify** → Must run tests before claiming done
-5. **Learn** → Defects → Lessons → Rules → Hooks
-
-### Rules
-- 🔴 Dangerous commands are physically blocked
-- 🔴 Hardcoded secrets are blocked on Edit/Write
-- 🟡 3 identical retries triggers brute-retry detection
-- 🟡 Claiming done without running tests is blocked
-- 🟢 All tool calls are tracked in .scale/events/
-
-### Doubao-Specific Notes
-- Doubao supports Chinese-optimized reasoning
-- Use Doubao for Chinese documentation and analysis
-- This rules.md file provides AI assistant context
-- SCALE hooks are defined in \`.doubao/settings.json\`
-- ByteDance Trae IDE users may also use \`scale init --agent trae\`
+        return `# ${projectName}
+${stackLine}
+## SCALE Engine Integration (Doubao)
+
+This project uses SCALE Engine for AI engineering governance via Doubao (ByteDance AI).
+
+### Commands
+- \`scale create <type> <title>\` — Create artifact
+- \`scale transition <id> <action>\` — Transition artifact state
+- \`scale list --type Spec\` — List artifacts
+- \`scale role activate <role>\` — Switch role
+- \`scale doctor\` — Health check
+
+### Workflow
+1. **Explore** → Role: explorer (Read/Grep only)
+2. **Plan** → Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
+3. **Implement** → Role: implementer (Edit/Write/Bash unlocked)
+4. **Verify** → Must run tests before claiming done
+5. **Learn** → Defects → Lessons → Rules → Hooks
+
+### Rules
+- 🔴 Dangerous commands are physically blocked
+- 🔴 Hardcoded secrets are blocked on Edit/Write
+- 🟡 3 identical retries triggers brute-retry detection
+- 🟡 Claiming done without running tests is blocked
+- 🟢 All tool calls are tracked in .scale/events/
+
+### Doubao-Specific Notes
+- Doubao supports Chinese-optimized reasoning
+- Use Doubao for Chinese documentation and analysis
+- This rules.md file provides AI assistant context
+- SCALE hooks are defined in \`.doubao/settings.json\`
+- ByteDance Trae IDE users may also use \`scale init --agent trae\`
 `;
     }
     async init(config) {

package/dist/adapters/KimiAdapter.js

@@ -75,38 +75,38 @@ export class KimiAdapter {
         const stackLine = techStack.length > 0
             ? `\n## Tech Stack\n${techStack.map((t) => `- ${t}`).join('\n')}\n`
             : '';
-        return `# ${projectName}
-${stackLine}
-## SCALE Engine Integration (Kimi)
-
-This project uses SCALE Engine for AI engineering governance via Kimi (Moonshot AI).
-
-### Commands
-- \`scale create <type> <title>\` — Create artifact
-- \`scale transition <id> <action>\` — Transition artifact state
-- \`scale list --type Spec\` — List artifacts
-- \`scale role activate <role>\` — Switch role
-- \`scale doctor\` — Health check
-
-### Workflow
-1. **Explore** → Role: explorer (Read/Grep only)
-2. **Plan** → Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
-3. **Implement** → Role: implementer (Edit/Write/Bash unlocked)
-4. **Verify** → Must run tests before claiming done
-5. **Learn** → Defects → Lessons → Rules → Hooks
-
-### Rules
-- 🔴 Dangerous commands are physically blocked
-- 🔴 Hardcoded secrets are blocked on Edit/Write
-- 🟡 3 identical retries triggers brute-retry detection
-- 🟡 Claiming done without running tests is blocked
-- 🟢 All tool calls are tracked in .scale/events/
-
-### Kimi-Specific Notes
-- Kimi supports long-context reasoning (200K+ tokens)
-- Use Kimi for complex analysis and documentation tasks
-- This rules.md file provides AI assistant context
-- SCALE hooks are defined in \`.kimi/settings.json\`
+        return `# ${projectName}
+${stackLine}
+## SCALE Engine Integration (Kimi)
+
+This project uses SCALE Engine for AI engineering governance via Kimi (Moonshot AI).
+
+### Commands
+- \`scale create <type> <title>\` — Create artifact
+- \`scale transition <id> <action>\` — Transition artifact state
+- \`scale list --type Spec\` — List artifacts
+- \`scale role activate <role>\` — Switch role
+- \`scale doctor\` — Health check
+
+### Workflow
+1. **Explore** → Role: explorer (Read/Grep only)
+2. **Plan** → Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
+3. **Implement** → Role: implementer (Edit/Write/Bash unlocked)
+4. **Verify** → Must run tests before claiming done
+5. **Learn** → Defects → Lessons → Rules → Hooks
+
+### Rules
+- 🔴 Dangerous commands are physically blocked
+- 🔴 Hardcoded secrets are blocked on Edit/Write
+- 🟡 3 identical retries triggers brute-retry detection
+- 🟡 Claiming done without running tests is blocked
+- 🟢 All tool calls are tracked in .scale/events/
+
+### Kimi-Specific Notes
+- Kimi supports long-context reasoning (200K+ tokens)
+- Use Kimi for complex analysis and documentation tasks
+- This rules.md file provides AI assistant context
+- SCALE hooks are defined in \`.kimi/settings.json\`
 `;
     }
     async init(config) {

package/dist/adapters/KiroAdapter.js

@@ -75,32 +75,32 @@ export class KiroAdapter {
         const stackLine = techStack.length > 0
             ? `\n## Tech Stack\n${techStack.map((t) => `- ${t}`).join('\n')}\n`
             : '';
-        return `# ${projectName}
-${stackLine}
-## SCALE Engine Integration (Kiro)
-
-This project uses SCALE Engine for AI engineering governance via Kiro.
-
-### Commands
-- \`scale create <type> <title>\` — Create artifact
-- \`scale transition <id> <action>\` — Transition artifact state
-- \`scale list --type Spec\` — List artifacts
-- \`scale role activate <role>\` — Switch role
-- \`scale doctor\` — Health check
-
-### Workflow
-1. **Explore** → Role: explorer (Read/Grep only)
-2. **Plan** → Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
-3. **Implement** → Role: implementer (Edit/Write/Bash unlocked)
-4. **Verify** → Must run tests before claiming done
-5. **Learn** → Defects → Lessons → Rules → Hooks
-
-### Rules
-- 🔴 Dangerous commands are physically blocked
-- 🔴 Hardcoded secrets are blocked on Edit/Write
-- 🟡 3 identical retries triggers brute-retry detection
-- 🟡 Claiming done without running tests is blocked
-- 🟢 All tool calls are tracked in .scale/events/
+        return `# ${projectName}
+${stackLine}
+## SCALE Engine Integration (Kiro)
+
+This project uses SCALE Engine for AI engineering governance via Kiro.
+
+### Commands
+- \`scale create <type> <title>\` — Create artifact
+- \`scale transition <id> <action>\` — Transition artifact state
+- \`scale list --type Spec\` — List artifacts
+- \`scale role activate <role>\` — Switch role
+- \`scale doctor\` — Health check
+
+### Workflow
+1. **Explore** → Role: explorer (Read/Grep only)
+2. **Plan** → Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
+3. **Implement** → Role: implementer (Edit/Write/Bash unlocked)
+4. **Verify** → Must run tests before claiming done
+5. **Learn** → Defects → Lessons → Rules → Hooks
+
+### Rules
+- 🔴 Dangerous commands are physically blocked
+- 🔴 Hardcoded secrets are blocked on Edit/Write
+- 🟡 3 identical retries triggers brute-retry detection
+- 🟡 Claiming done without running tests is blocked
+- 🟢 All tool calls are tracked in .scale/events/
 `;
     }
     async init(config) {

package/dist/adapters/WindsurfAdapter.js

@@ -77,38 +77,38 @@ export class WindsurfAdapter {
         const stackLine = techStack.length > 0
             ? `\n## Tech Stack\n${techStack.map((t) => `- ${t}`).join('\n')}\n`
             : '';
-        return `# ${projectName}
-${stackLine}
-## SCALE Engine Integration (Windsurf)
-
-This project uses SCALE Engine for AI engineering governance via Windsurf.
-
-### Commands
-- \`scale create <type> <title>\` — Create artifact
-- \`scale transition <id> <action>\` — Transition artifact state
-- \`scale list --type Spec\` — List artifacts
-- \`scale role activate <role>\` — Switch role
-- \`scale doctor\` — Health check
-
-### Workflow
-1. **Explore** → Role: explorer (Read/Grep only)
-2. **Plan** → Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
-3. **Implement** → Role: implementer (Edit/Write/Bash unlocked)
-4. **Verify** → Must run tests before claiming done
-5. **Learn** → Defects → Lessons → Rules → Hooks
-
-### Rules
-- 🔴 Dangerous commands are physically blocked
-- 🔴 Hardcoded secrets are blocked on Edit/Write
-- 🟡 3 identical retries triggers brute-retry detection
-- 🟡 Claiming done without running tests is blocked
-- 🟢 All tool calls are tracked in .scale/events/
-
-### Windsurf-Specific Notes
-- Windsurf uses Cascade Flow for multi-file editing
-- Use Chat mode for quick questions, Cascade for complex tasks
-- This rules.md file provides AI assistant context
-- SCALE hooks are defined in \`.windsurf/settings.json\`
+        return `# ${projectName}
+${stackLine}
+## SCALE Engine Integration (Windsurf)
+
+This project uses SCALE Engine for AI engineering governance via Windsurf.
+
+### Commands
+- \`scale create <type> <title>\` — Create artifact
+- \`scale transition <id> <action>\` — Transition artifact state
+- \`scale list --type Spec\` — List artifacts
+- \`scale role activate <role>\` — Switch role
+- \`scale doctor\` — Health check
+
+### Workflow
+1. **Explore** → Role: explorer (Read/Grep only)
+2. **Plan** → Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
+3. **Implement** → Role: implementer (Edit/Write/Bash unlocked)
+4. **Verify** → Must run tests before claiming done
+5. **Learn** → Defects → Lessons → Rules → Hooks
+
+### Rules
+- 🔴 Dangerous commands are physically blocked
+- 🔴 Hardcoded secrets are blocked on Edit/Write
+- 🟡 3 identical retries triggers brute-retry detection
+- 🟡 Claiming done without running tests is blocked
+- 🟢 All tool calls are tracked in .scale/events/
+
+### Windsurf-Specific Notes
+- Windsurf uses Cascade Flow for multi-file editing
+- Use Chat mode for quick questions, Cascade for complex tasks
+- This rules.md file provides AI assistant context
+- SCALE hooks are defined in \`.windsurf/settings.json\`
 `;
     }
     async init(config) {

package/dist/api/cli.js

@@ -35,6 +35,7 @@ import { TaskMetricsStore } from '../workflow/TaskMetricsStore.js';
 import { checkTaskArtifactCompleteness } from '../workflow/TaskArtifactScaffolder.js';
 import { WorkflowArtifactWriter } from '../workflow/WorkflowArtifactWriter.js';
 import { cleanupWorkspaceLifecycle, inspectWorkspaceLifecycle, } from '../workflow/WorkspaceLifecycle.js';
+import { resolveWorkspaceTopology, workspaceTopologyPath, workspaceTopologyTemplate, } from '../workflow/WorkspaceTopology.js';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 // ============================================================================
@@ -826,6 +827,7 @@ const taskArtifacts = defineCommand({
 });
 function printWorkspaceLifecycle(report) {
     console.log('\nSCALE Workspace Lifecycle');
+    console.log(`  Topology: ${report.topology.topology}${report.topology.configured ? '' : ' (default)'}`);
     console.log(`  Root: ${report.root.path}`);
     console.log(`  Branch: ${report.root.branch ?? '(detached)'}`);
     console.log(`  Linked worktree: ${report.root.isLinkedWorktree ? 'yes' : 'no'}`);
@@ -852,6 +854,19 @@ function printWorkspaceLifecycle(report) {
     for (const action of report.finish.nextActions)
         console.log(`  [NEXT] ${action}`);
 }
+function printWorkspaceTopology(topology, written) {
+    console.log('\nSCALE Workspace Topology');
+    console.log(`  Topology: ${topology.topology}${topology.configured ? '' : ' (default)'}`);
+    console.log(`  Config: ${topology.configPath}`);
+    if (written)
+        console.log(`  Written: ${written}`);
+    console.log('\n  Repositories:');
+    for (const repo of topology.repositories) {
+        console.log(`    - ${repo.name}: ${repo.path} (${repo.role}) required=${repo.required !== false ? 'yes' : 'no'}`);
+    }
+    for (const warning of topology.warnings)
+        console.log(`  [WARN] ${warning}`);
+}
 function printWorkspaceCleanup(result) {
     printWorkspaceLifecycle(result.report);
     console.log('\n  Cleanup plan:');
@@ -885,6 +900,35 @@ const workspaceStatus = defineCommand({
             process.exitCode = 1;
     },
 });
+const workspaceMap = defineCommand({
+    meta: { name: 'map', description: 'Resolve or write explicit workspace topology for single, monorepo, polyrepo, submodule, or MOE projects' },
+    args: {
+        dir: { type: 'string', description: 'Project directory; defaults to current project directory' },
+        topology: { type: 'string', default: 'moe', description: 'Starter topology for --write (single/monorepo/polyrepo/submodule-workspace/moe)' },
+        write: { type: 'boolean', default: false, description: 'Create .scale/workspace.json when it does not exist' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(args.dir ?? PROJECT_DIR);
+        const target = workspaceTopologyPath(projectDir);
+        let written = null;
+        if (isTruthyFlag(args.write) && !existsSync(target)) {
+            ensureDir(join(projectDir, '.scale'));
+            writeFileSync(target, workspaceTopologyTemplate({
+                topology: normalizeWorkspaceTopologyKind(args.topology),
+            }), 'utf-8');
+            written = target;
+        }
+        const topology = resolveWorkspaceTopology({ projectDir });
+        const result = { ...topology, written };
+        if (args.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            printWorkspaceTopology(topology, written);
+        }
+    },
+});
 const workspaceFinish = defineCommand({
     meta: { name: 'finish', description: 'Check whether a temporary worktree can be safely finished or cleaned up' },
     args: {
@@ -896,6 +940,7 @@ const workspaceFinish = defineCommand({
         const result = {
             root: report.root,
             childRepositories: report.childRepositories,
+            topology: report.topology,
             finish: report.finish,
         };
         if (args.json) {
@@ -936,11 +981,23 @@ const workspaceCleanup = defineCommand({
 const workspace = defineCommand({
     meta: { name: 'workspace', description: 'Inspect worktree, branch, and child repository lifecycle safety' },
     subCommands: {
+        map: workspaceMap,
         status: workspaceStatus,
         finish: workspaceFinish,
         cleanup: workspaceCleanup,
     },
 });
+function normalizeWorkspaceTopologyKind(value) {
+    const normalized = String(value ?? 'moe').trim();
+    if (normalized === 'single'
+        || normalized === 'monorepo'
+        || normalized === 'polyrepo'
+        || normalized === 'submodule-workspace'
+        || normalized === 'moe') {
+        return normalized;
+    }
+    return 'moe';
+}
 const preflight = defineCommand({
     meta: { name: 'preflight', description: 'Run service-aware verification without a task artifact' },
     args: {
@@ -1150,7 +1207,7 @@ const init = defineCommand({
         'governance-pack': {
             type: 'string',
             default: 'standard',
-            description: 'Governance template pack (standard/project-scaffold/go-service-matrix/node-library/frontend-app)',
+            description: 'Governance template pack (standard/project-scaffold/moe-workspace/go-service-matrix/node-library/frontend-app)',
         },
         quick: { type: 'boolean', default: false, description: 'Quick start with auto-detection' },
         interactive: { type: 'boolean', default: false, description: 'Interactive configuration mode with prompts' },