@hongmaple0820/scale-engine 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+MIT License
+
+Copyright (c) 2026 SCALE Engine Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

package/README.md

@@ -0,0 +1,64 @@
+# SCALE Engine
+
+> **S**caffold · **C**ontrol · **A**rtifact · **L**earn · **E**volve
+>
+> AI 工程化脚手架引擎 — 让 AI Agent 在物理约束下工作，而不是靠提示词自律。
+
+[![Tests](https://img.shields.io/badge/tests-148%2B%20passed-brightgreen)]()
+[![Node](https://img.shields.io/badge/node-%3E%3D20-blue)]()
+[![License](https://img.shields.io/badge/license-MIT-green)]()
+
+## 核心理念
+
+```
+提示词说 "你应该跑测试"    → AI 可以假装跑了  ❌
+Stop Hook 检查 "未跑测试"  → AI 物理无法跳过  ✅
+```
+
+## 六层架构
+
+```
+L1 Context       — Token 预算 + 上下文组装
+L2 Guardrails    — 8 检测器 + Role 网关
+L3 Observability — EventBus + BehaviorTracker
+L4 Orchestration — TaskEngine + Effects + ModelRouter
+L5 Memory        — KnowledgeBase + 衰减算法
+L6 Evolution     — Defect→Lesson→Rule→Hook 自进化
+```
+
+## 快速开始
+
+```bash
+npm install -g @hongmaple0820/scale-engine
+cd your-project
+scale init --agent claude-code
+scale doctor
+scale create Spec "用户导出 Excel 功能"
+scale transition SPEC-xxx refine
+scale transition SPEC-xxx approve   # ambiguity > 0.2 物理拦截
+```
+
+## CLI 命令 (13 个)
+
+| 命令 | 说明 |
+|------|------|
+| `scale init` | 初始化 (.scale/ + hooks + CLAUDE.md) |
+| `scale doctor` | 环境诊断 + 健康检查 |
+| `scale create` | 创建 Artifact |
+| `scale list` | 列表查询 |
+| `scale show` | 详情 |
+| `scale transition` | 状态迁移 (含 guard) |
+| `scale role` | 角色切换 |
+| `scale context` | 组装上下文 |
+| `scale evolve` | 进化周期 |
+| `scale stats` | 统计 |
+| `scale session` | 会话管理 |
+| `scale gate` | 网关检查 |
+
+## 11 种 Artifact · 4 级自进化 · 8 个检测器
+
+详见 `docs/` 目录。
+
+## License
+
+MIT

package/dist/adapters/ClaudeCodeAdapter.d.ts

@@ -0,0 +1,48 @@
+export interface AdapterConfig {
+    projectDir: string;
+    scaleDir?: string;
+    agentType?: 'claude-code' | 'codex' | 'opencode' | 'cursor' | 'gemini';
+}
+export interface HookEntry {
+    matcher: string;
+    command: string;
+    timeout?: number;
+}
+export interface SettingsJson {
+    hooks?: Record<string, HookEntry[]>;
+    permissions?: {
+        allow?: string[];
+        deny?: string[];
+    };
+    mcpServers?: Record<string, unknown>;
+}
+export interface IAgentAdapter {
+    readonly agentType: string;
+    init(config: AdapterConfig): Promise<InitResult>;
+    getSettingsPath(): string;
+    getKnowledgeDocPath(): string;
+    generateSettings(): SettingsJson;
+    generateKnowledgeDoc(projectName: string, techStack?: string[]): string;
+    mergeSettings(existing: SettingsJson): SettingsJson;
+    isInstalled(): boolean;
+}
+export interface InitResult {
+    settingsPath: string;
+    knowledgeDocPath: string;
+    scaleDir: string;
+    created: string[];
+    skipped: string[];
+}
+export declare class ClaudeCodeAdapter implements IAgentAdapter {
+    readonly agentType = "claude-code";
+    private projectDir;
+    private scaleDir;
+    getSettingsPath(): string;
+    getKnowledgeDocPath(): string;
+    isInstalled(): boolean;
+    generateSettings(): SettingsJson;
+    mergeSettings(existing: SettingsJson): SettingsJson;
+    generateKnowledgeDoc(projectName: string, techStack?: string[]): string;
+    init(config: AdapterConfig): Promise<InitResult>;
+}
+export declare function createAdapter(agentType: string): IAgentAdapter;

package/dist/adapters/ClaudeCodeAdapter.js

@@ -0,0 +1,188 @@
+// SCALE Engine — Claude Code Adapter (W8)
+// 生成/合并 .claude/settings.json + CLAUDE.md
+// 设计参考：docs/01-ARCHITECTURE.md 原则4 Headless优先
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../core/logger.js';
+// ============================================================================
+// Claude Code Adapter
+// ============================================================================
+export class ClaudeCodeAdapter {
+    agentType = 'claude-code';
+    projectDir = '.';
+    scaleDir = '.scale';
+    getSettingsPath() {
+        return join(this.projectDir, '.claude', 'settings.json');
+    }
+    getKnowledgeDocPath() {
+        return join(this.projectDir, 'CLAUDE.md');
+    }
+    isInstalled() {
+        return existsSync(this.getSettingsPath());
+    }
+    generateSettings() {
+        return {
+            hooks: {
+                SessionStart: [
+                    { matcher: '', command: 'scale session start --agent claude-code --session-id $CLAUDE_SESSION_ID' },
+                ],
+                PreToolUse: [
+                    { matcher: 'Bash', command: 'scale gate pre-tool Bash --args-json $TOOL_INPUT_JSON --session-id $CLAUDE_SESSION_ID' },
+                    { matcher: 'Edit|Write|MultiEdit', command: 'scale gate pre-tool Edit --args-json $TOOL_INPUT_JSON --session-id $CLAUDE_SESSION_ID' },
+                ],
+                PostToolUse: [
+                    { matcher: 'Edit|Write|MultiEdit', command: 'scale gate post-tool Edit --args-json $TOOL_INPUT_JSON --output-json $TOOL_OUTPUT_JSON --session-id $CLAUDE_SESSION_ID' },
+                    { matcher: 'Bash', command: 'scale gate post-tool Bash --args-json $TOOL_INPUT_JSON --exit-code $TOOL_EXIT_CODE --session-id $CLAUDE_SESSION_ID' },
+                ],
+                Stop: [
+                    { matcher: '', command: 'scale gate before-stop --session-id $CLAUDE_SESSION_ID' },
+                ],
+                SessionEnd: [
+                    { matcher: '', command: 'scale session end --session-id $CLAUDE_SESSION_ID' },
+                ],
+            },
+            permissions: {
+                allow: ['Bash(scale:*)'],
+            },
+        };
+    }
+    mergeSettings(existing) {
+        const generated = this.generateSettings();
+        const merged = { ...existing };
+        // Merge hooks — add SCALE hooks without overwriting existing
+        if (!merged.hooks)
+            merged.hooks = {};
+        for (const [hookType, entries] of Object.entries(generated.hooks)) {
+            if (!merged.hooks[hookType])
+                merged.hooks[hookType] = [];
+            for (const entry of entries) {
+                const alreadyExists = merged.hooks[hookType].some((e) => e.command.includes('scale '));
+                if (!alreadyExists) {
+                    merged.hooks[hookType].push(entry);
+                }
+            }
+        }
+        // Merge permissions
+        if (!merged.permissions)
+            merged.permissions = {};
+        if (!merged.permissions.allow)
+            merged.permissions.allow = [];
+        for (const perm of generated.permissions.allow) {
+            if (!merged.permissions.allow.includes(perm)) {
+                merged.permissions.allow.push(perm);
+            }
+        }
+        return merged;
+    }
+    generateKnowledgeDoc(projectName, techStack = []) {
+        const stackLine = techStack.length > 0
+            ? `\n## Tech Stack\n${techStack.map((t) => `- ${t}`).join('\n')}\n`
+            : '';
+        return `# ${projectName}
+${stackLine}
+## SCALE Engine Integration
+
+This project uses SCALE Engine for AI engineering governance.
+
+### Commands
+- \`scale create <type> <title>\` — Create artifact (Spec/Plan/Task/...)
+- \`scale transition <id> <action>\` — Transition artifact state
+- \`scale list --type Spec\` — List artifacts
+- \`scale role activate <role>\` — Switch role (explorer/planner/implementer/reviewer)
+- \`scale stats\` — Show engine stats
+
+### 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 (Stop gate enforced)
+5. **Learn** → Defects auto-extract to lessons → rules → hooks
+
+### Rules
+- 🔴 Dangerous commands (rm -rf, DROP TABLE) 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) {
+        this.projectDir = config.projectDir;
+        this.scaleDir = config.scaleDir ?? join(config.projectDir, '.scale');
+        const created = [];
+        const skipped = [];
+        // 1. Create .scale/ directory structure
+        for (const dir of ['events', 'artifacts', 'rules', 'hooks', 'checkpoints']) {
+            const fullDir = join(this.scaleDir, dir);
+            if (!existsSync(fullDir)) {
+                mkdirSync(fullDir, { recursive: true });
+                created.push(fullDir);
+            }
+            else {
+                skipped.push(fullDir);
+            }
+        }
+        // 2. Create/merge .claude/settings.json
+        const settingsPath = this.getSettingsPath();
+        const claudeDir = join(this.projectDir, '.claude');
+        mkdirSync(claudeDir, { recursive: true });
+        if (existsSync(settingsPath)) {
+            const existing = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+            const merged = this.mergeSettings(existing);
+            writeFileSync(settingsPath, JSON.stringify(merged, null, 2), 'utf-8');
+            skipped.push(settingsPath + ' (merged)');
+        }
+        else {
+            const settings = this.generateSettings();
+            writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+            created.push(settingsPath);
+        }
+        // 3. Create CLAUDE.md if not exists
+        const knowledgeDocPath = this.getKnowledgeDocPath();
+        if (!existsSync(knowledgeDocPath)) {
+            const projectName = config.projectDir.split(/[/\\]/).pop() ?? 'Project';
+            const content = this.generateKnowledgeDoc(projectName);
+            writeFileSync(knowledgeDocPath, content, 'utf-8');
+            created.push(knowledgeDocPath);
+        }
+        else {
+            skipped.push(knowledgeDocPath);
+        }
+        // 4. Create .gitignore for .scale/
+        const gitignorePath = join(this.scaleDir, '.gitignore');
+        if (!existsSync(gitignorePath)) {
+            writeFileSync(gitignorePath, `# SCALE Engine runtime data
+*.db
+*.db-journal
+events/
+checkpoints/
+hooks/*.sh
+`, 'utf-8');
+            created.push(gitignorePath);
+        }
+        logger.info({ created: created.length, skipped: skipped.length }, 'SCALE init completed');
+        return {
+            settingsPath,
+            knowledgeDocPath,
+            scaleDir: this.scaleDir,
+            created,
+            skipped,
+        };
+    }
+}
+// ============================================================================
+// Adapter Factory
+// ============================================================================
+import { CodexAdapter } from './CodexAdapter.js';
+// ...existing code...
+export function createAdapter(agentType) {
+    switch (agentType) {
+        case 'claude-code':
+            return new ClaudeCodeAdapter();
+        case 'codex':
+            return new CodexAdapter();
+        default:
+            throw new Error(`Unsupported agent type: ${agentType}. Supported: claude-code, codex`);
+    }
+}
+//# sourceMappingURL=ClaudeCodeAdapter.js.map

package/dist/adapters/ClaudeCodeAdapter.js.map

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

package/dist/adapters/CodexAdapter.d.ts

@@ -0,0 +1,14 @@
+import type { IAgentAdapter, AdapterConfig, InitResult, SettingsJson } from './ClaudeCodeAdapter.js';
+export declare class CodexAdapter implements IAgentAdapter {
+    readonly agentType = "codex";
+    private projectDir;
+    private scaleDir;
+    getSettingsPath(): string;
+    getKnowledgeDocPath(): string;
+    isInstalled(): boolean;
+    generateSettings(): SettingsJson;
+    generateCodexConfig(): string;
+    mergeSettings(existing: SettingsJson): SettingsJson;
+    generateKnowledgeDoc(projectName: string, techStack?: string[]): string;
+    init(config: AdapterConfig): Promise<InitResult>;
+}

package/dist/adapters/CodexAdapter.js

@@ -0,0 +1,153 @@
+// SCALE Engine — Codex CLI Adapter (W11)
+// 生成 .codex/config.toml + .codex/hooks.json + AGENTS.md
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+// ============================================================================
+// Codex CLI Adapter
+// ============================================================================
+export class CodexAdapter {
+    agentType = 'codex';
+    projectDir = '.';
+    scaleDir = '.scale';
+    getSettingsPath() {
+        return join(this.projectDir, '.codex', 'hooks.json');
+    }
+    getKnowledgeDocPath() {
+        return join(this.projectDir, 'AGENTS.md');
+    }
+    isInstalled() {
+        return existsSync(this.getSettingsPath());
+    }
+    generateSettings() {
+        // Codex hooks.json format
+        return {
+            hooks: {
+                'pre-exec': [
+                    { matcher: '', command: 'scale gate pre-tool Bash --args-json "$ARGS" --session-id "$SESSION_ID"' },
+                ],
+                'post-exec': [
+                    { matcher: '', command: 'scale gate post-tool Bash --exit-code "$EXIT_CODE" --session-id "$SESSION_ID"' },
+                ],
+            },
+        };
+    }
+    generateCodexConfig() {
+        return `# SCALE Engine — Codex CLI config
+# See: https://github.com/openai/codex
+
+[model]
+default = "o4-mini"
+
+[approval]
+# SCALE hooks handle safety gates
+auto_approve = ["scale *"]
+
+[environment]
+SCALE_AGENT = "codex"
+`;
+    }
+    mergeSettings(existing) {
+        const generated = this.generateSettings();
+        const merged = { ...existing };
+        if (!merged.hooks)
+            merged.hooks = {};
+        for (const [hookType, entries] of Object.entries(generated.hooks)) {
+            if (!merged.hooks[hookType])
+                merged.hooks[hookType] = [];
+            for (const entry of entries) {
+                const alreadyExists = merged.hooks[hookType].some((e) => e.command.includes('scale '));
+                if (!alreadyExists) {
+                    merged.hooks[hookType].push(entry);
+                }
+            }
+        }
+        return merged;
+    }
+    generateKnowledgeDoc(projectName, techStack = []) {
+        const stackLine = techStack.length > 0
+            ? `\n## Tech Stack\n${techStack.map((t) => `- ${t}`).join('\n')}\n`
+            : '';
+        return `# ${projectName}
+${stackLine}
+## SCALE Engine Integration
+
+This project uses SCALE Engine for AI engineering governance.
+
+### Workflow
+1. Explore → Plan → Implement → Verify → Learn
+2. All tool calls pass through SCALE gates
+3. Dangerous commands are physically blocked
+4. Tests must pass before completion
+
+### Commands
+- \`scale create <type> <title>\` — Create artifact
+- \`scale transition <id> <action>\` — State transition
+- \`scale doctor\` — Health check
+`;
+    }
+    async init(config) {
+        this.projectDir = config.projectDir;
+        this.scaleDir = config.scaleDir ?? join(config.projectDir, '.scale');
+        const created = [];
+        const skipped = [];
+        // 1. Create .scale/ structure
+        for (const dir of ['events', 'artifacts', 'rules', 'hooks', 'checkpoints']) {
+            const fullDir = join(this.scaleDir, dir);
+            if (!existsSync(fullDir)) {
+                mkdirSync(fullDir, { recursive: true });
+                created.push(fullDir);
+            }
+            else {
+                skipped.push(fullDir);
+            }
+        }
+        // 2. Create .codex/ directory
+        const codexDir = join(this.projectDir, '.codex');
+        mkdirSync(codexDir, { recursive: true });
+        // 3. Create/merge hooks.json
+        const hooksPath = this.getSettingsPath();
+        if (existsSync(hooksPath)) {
+            const existing = JSON.parse(readFileSync(hooksPath, 'utf-8'));
+            const merged = this.mergeSettings(existing);
+            writeFileSync(hooksPath, JSON.stringify(merged, null, 2), 'utf-8');
+            skipped.push(hooksPath + ' (merged)');
+        }
+        else {
+            writeFileSync(hooksPath, JSON.stringify(this.generateSettings(), null, 2), 'utf-8');
+            created.push(hooksPath);
+        }
+        // 4. Create config.toml
+        const configPath = join(codexDir, 'config.toml');
+        if (!existsSync(configPath)) {
+            writeFileSync(configPath, this.generateCodexConfig(), 'utf-8');
+            created.push(configPath);
+        }
+        else {
+            skipped.push(configPath);
+        }
+        // 5. Create AGENTS.md
+        const agentsPath = this.getKnowledgeDocPath();
+        if (!existsSync(agentsPath)) {
+            const projectName = config.projectDir.split(/[/\\]/).pop() ?? 'Project';
+            writeFileSync(agentsPath, this.generateKnowledgeDoc(projectName), 'utf-8');
+            created.push(agentsPath);
+        }
+        else {
+            skipped.push(agentsPath);
+        }
+        // 6. .gitignore
+        const gitignorePath = join(this.scaleDir, '.gitignore');
+        if (!existsSync(gitignorePath)) {
+            writeFileSync(gitignorePath, `*.db\n*.db-journal\nevents/\ncheckpoints/\nhooks/*.sh\n`, 'utf-8');
+            created.push(gitignorePath);
+        }
+        return {
+            settingsPath: hooksPath,
+            knowledgeDocPath: agentsPath,
+            scaleDir: this.scaleDir,
+            created,
+            skipped,
+        };
+    }
+}
+//# sourceMappingURL=CodexAdapter.js.map

package/dist/adapters/CodexAdapter.js.map

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

package/dist/api/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};