@hongmaple0820/scale-engine 0.25.0 → 0.27.0

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/GeminiAdapter.js

@@ -76,32 +76,32 @@ export class GeminiAdapter {
         const stackLine = techStack.length > 0
             ? `\n## Tech Stack\n${techStack.map((t) => `- ${t}`).join('\n')}\n`
             : '';
-        return `# ${projectName}
-${stackLine}
-## SCALE Engine Integration (Gemini)
-
-This project uses SCALE Engine for AI engineering governance via Gemini 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/
+        return `# ${projectName}
+${stackLine}
+## SCALE Engine Integration (Gemini)
+
+This project uses SCALE Engine for AI engineering governance via Gemini 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/
 `;
     }
     async init(config) {

package/dist/adapters/GenericProjectAgentAdapter.d.ts

@@ -0,0 +1,29 @@
+import type { AgentPlatform } from '../artifact/types.js';
+import type { AdapterConfig, IAgentAdapter, InitResult, SettingsJson } from './ClaudeCodeAdapter.js';
+export type SettingsShape = 'scale-hooks' | 'qoder-hooks';
+export interface GenericProjectAgentOptions {
+    agentType: AgentPlatform;
+    displayName: string;
+    settingsPath: string;
+    knowledgeDocPath: string;
+    skillsDir: string;
+    installedPaths?: string[];
+    extraDirs?: string[];
+    settingsShape?: SettingsShape;
+    notes?: string[];
+}
+export declare class GenericProjectAgentAdapter implements IAgentAdapter {
+    readonly agentType: AgentPlatform;
+    protected projectDir: string;
+    protected scaleDir: string;
+    protected readonly options: GenericProjectAgentOptions;
+    constructor(options: GenericProjectAgentOptions);
+    getSettingsPath(): string;
+    getKnowledgeDocPath(): string;
+    getSkillsDir(): string;
+    isInstalled(): boolean;
+    generateSettings(): SettingsJson;
+    mergeSettings(existing: SettingsJson): SettingsJson;
+    generateKnowledgeDoc(projectName: string, techStack?: string[]): string;
+    init(config: AdapterConfig): Promise<InitResult>;
+}

package/dist/adapters/GenericProjectAgentAdapter.js

@@ -0,0 +1,204 @@
+// SCALE Engine - Generic project-level agent adapter
+// Used for platforms that accept project-local rule files and optional JSON settings.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { logger } from '../core/logger.js';
+function hasScaleCommand(entry) {
+    if (entry.command?.includes('scale '))
+        return true;
+    return entry.hooks?.some(hasScaleCommand) ?? false;
+}
+export class GenericProjectAgentAdapter {
+    constructor(options) {
+        this.projectDir = '.';
+        this.scaleDir = '.scale';
+        this.options = options;
+        this.agentType = options.agentType;
+    }
+    getSettingsPath() {
+        return join(this.projectDir, this.options.settingsPath);
+    }
+    getKnowledgeDocPath() {
+        return join(this.projectDir, this.options.knowledgeDocPath);
+    }
+    getSkillsDir() {
+        return join(this.projectDir, this.options.skillsDir);
+    }
+    isInstalled() {
+        const paths = this.options.installedPaths ?? [this.options.settingsPath];
+        return paths.some(path => existsSync(join(this.projectDir, path)));
+    }
+    generateSettings() {
+        if (this.options.settingsShape === 'qoder-hooks') {
+            return {
+                hooks: {
+                    PreToolUse: [
+                        {
+                            matcher: 'Bash',
+                            command: '',
+                            hooks: [{ matcher: '', type: 'command', command: 'scale gate pre-tool Bash --args-json "$ARGS" --session-id "$SESSION_ID"' }],
+                        },
+                        {
+                            matcher: 'Edit|Write',
+                            command: '',
+                            hooks: [{ matcher: '', type: 'command', command: 'scale gate pre-tool Edit --args-json "$ARGS" --session-id "$SESSION_ID"' }],
+                        },
+                    ],
+                    PostToolUse: [
+                        {
+                            matcher: 'Edit|Write',
+                            command: '',
+                            hooks: [{ matcher: '', type: 'command', command: 'scale gate post-tool Edit --args-json "$ARGS" --exit-code "$EXIT_CODE" --session-id "$SESSION_ID"' }],
+                        },
+                        {
+                            matcher: 'Bash',
+                            command: '',
+                            hooks: [{ matcher: '', type: 'command', command: 'scale gate post-tool Bash --args-json "$ARGS" --exit-code "$EXIT_CODE" --session-id "$SESSION_ID"' }],
+                        },
+                    ],
+                    Stop: [
+                        {
+                            matcher: '',
+                            command: '',
+                            hooks: [{ matcher: '', type: 'command', command: 'scale gate before-stop --session-id "$SESSION_ID"' }],
+                        },
+                    ],
+                },
+                permissions: { allow: ['scale:*'] },
+            };
+        }
+        return {
+            hooks: {
+                'pre-exec': [
+                    { matcher: 'Bash', command: 'scale gate pre-tool Bash --args-json "$ARGS" --session-id "$SESSION_ID"' },
+                    { matcher: 'Edit|Write', command: 'scale gate pre-tool Edit --args-json "$ARGS" --session-id "$SESSION_ID"' },
+                ],
+                'post-exec': [
+                    { matcher: 'Edit|Write', command: 'scale gate post-tool Edit --args-json "$ARGS" --exit-code "$EXIT_CODE" --session-id "$SESSION_ID"' },
+                    { matcher: 'Bash', command: 'scale gate post-tool Bash --args-json "$ARGS" --exit-code "$EXIT_CODE" --session-id "$SESSION_ID"' },
+                ],
+                'before-stop': [
+                    { matcher: '', command: 'scale gate before-stop --session-id "$SESSION_ID"' },
+                ],
+            },
+            permissions: { allow: ['scale:*'] },
+        };
+    }
+    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] = [];
+            const alreadyExists = merged.hooks[hookType].some(hasScaleCommand);
+            if (!alreadyExists)
+                merged.hooks[hookType].push(...entries);
+        }
+        if (!merged.permissions)
+            merged.permissions = {};
+        if (!merged.permissions.allow)
+            merged.permissions.allow = [];
+        for (const permission of generated.permissions?.allow ?? []) {
+            if (!merged.permissions.allow.includes(permission))
+                merged.permissions.allow.push(permission);
+        }
+        return merged;
+    }
+    generateKnowledgeDoc(projectName, techStack = []) {
+        const stackLine = techStack.length > 0
+            ? `\n## Tech Stack\n${techStack.map(t => `- ${t}`).join('\n')}\n`
+            : '';
+        const notes = this.options.notes?.length
+            ? `\n### ${this.options.displayName}-Specific Notes\n${this.options.notes.map(note => `- ${note}`).join('\n')}\n`
+            : '';
+        return `# ${projectName}
+${stackLine}
+## SCALE Engine Integration (${this.options.displayName})
+
+This project uses SCALE Engine for AI engineering governance via ${this.options.displayName}.
+
+### 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
+3. Implement - Role: implementer
+4. Verify - Must run tests before claiming done
+5. Learn - Defects become lessons, rules, and hooks
+
+### Rules
+- Dangerous commands are blocked through SCALE gates where the platform supports executable hooks.
+- Hardcoded secrets must be rejected before edits are committed.
+- Repeated retries should be treated as diagnostic evidence, not brute force.
+- Claims of completion require verification evidence.
+- Runtime evidence is tracked under .scale/.
+${notes}`;
+    }
+    async init(config) {
+        this.projectDir = config.projectDir;
+        this.scaleDir = config.scaleDir ?? join(config.projectDir, '.scale');
+        const created = [];
+        const skipped = [];
+        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);
+            }
+        }
+        const settingsPath = this.getSettingsPath();
+        mkdirSync(dirname(settingsPath), { recursive: true });
+        if (existsSync(settingsPath)) {
+            const existing = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+            writeFileSync(settingsPath, JSON.stringify(this.mergeSettings(existing), null, 2), 'utf-8');
+            skipped.push(`${settingsPath} (merged)`);
+        }
+        else {
+            writeFileSync(settingsPath, JSON.stringify(this.generateSettings(), null, 2), 'utf-8');
+            created.push(settingsPath);
+        }
+        for (const dir of [this.getSkillsDir(), ...(this.options.extraDirs ?? []).map(dir => join(this.projectDir, dir))]) {
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+                created.push(dir);
+            }
+            else {
+                skipped.push(dir);
+            }
+        }
+        const knowledgeDocPath = this.getKnowledgeDocPath();
+        mkdirSync(dirname(knowledgeDocPath), { recursive: true });
+        if (!existsSync(knowledgeDocPath)) {
+            const projectName = config.projectDir.split(/[/\\]/).pop() ?? 'Project';
+            writeFileSync(knowledgeDocPath, this.generateKnowledgeDoc(projectName), 'utf-8');
+            created.push(knowledgeDocPath);
+        }
+        else {
+            skipped.push(knowledgeDocPath);
+        }
+        const gitignorePath = join(this.scaleDir, '.gitignore');
+        if (!existsSync(gitignorePath)) {
+            writeFileSync(gitignorePath, `*.db\n*.db-journal\nevents/\ncheckpoints/\nevidence/\nstate/\nhooks/*.sh\n`, 'utf-8');
+            created.push(gitignorePath);
+        }
+        logger.info({ created: created.length, skipped: skipped.length }, `SCALE init (${this.agentType}) completed`);
+        return {
+            settingsPath,
+            knowledgeDocPath,
+            scaleDir: this.scaleDir,
+            created,
+            skipped,
+        };
+    }
+}
+//# sourceMappingURL=GenericProjectAgentAdapter.js.map

package/dist/adapters/GenericProjectAgentAdapter.js.map

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

package/dist/adapters/HermesAdapter.js

@@ -76,32 +76,32 @@ export class HermesAdapter {
         const stackLine = techStack.length > 0
             ? `\n## Tech Stack\n${techStack.map((t) => `- ${t}`).join('\n')}\n`
             : '';
-        return `# ${projectName}
-${stackLine}
-## SCALE Engine Integration (Hermes)
-
-This project uses SCALE Engine for AI engineering governance via Hermes.
-
-### 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 (Hermes)
+
+This project uses SCALE Engine for AI engineering governance via Hermes.
+
+### 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/JCodeAdapter.d.ts

@@ -0,0 +1,4 @@
+import { GenericProjectAgentAdapter } from './GenericProjectAgentAdapter.js';
+export declare class JCodeAdapter extends GenericProjectAgentAdapter {
+    constructor();
+}

package/dist/adapters/JCodeAdapter.js

@@ -0,0 +1,19 @@
+// SCALE Engine - JCode Adapter
+import { GenericProjectAgentAdapter } from './GenericProjectAgentAdapter.js';
+export class JCodeAdapter extends GenericProjectAgentAdapter {
+    constructor() {
+        super({
+            agentType: 'jcode',
+            displayName: 'JCode',
+            settingsPath: '.jcode/settings.json',
+            knowledgeDocPath: 'JCODE.md',
+            skillsDir: '.jcode/skills',
+            installedPaths: ['.jcode/settings.json', 'JCODE.md'],
+            notes: [
+                'JCode is treated as a project-local agent surface because no stable public hook contract is assumed.',
+                'The adapter records SCALE rules and conservative command boundaries without claiming native hook execution.',
+            ],
+        });
+    }
+}
+//# sourceMappingURL=JCodeAdapter.js.map

package/dist/adapters/JCodeAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JCodeAdapter.js","sourceRoot":"","sources":["../../src/adapters/JCodeAdapter.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAE5E,MAAM,OAAO,YAAa,SAAQ,0BAA0B;IAC1D;QACE,KAAK,CAAC;YACJ,SAAS,EAAE,OAAO;YAClB,WAAW,EAAE,OAAO;YACpB,YAAY,EAAE,sBAAsB;YACpC,gBAAgB,EAAE,UAAU;YAC5B,SAAS,EAAE,eAAe;YAC1B,cAAc,EAAE,CAAC,sBAAsB,EAAE,UAAU,CAAC;YACpD,KAAK,EAAE;gBACL,sGAAsG;gBACtG,6GAA6G;aAC9G;SACF,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/adapters/KiloCodeAdapter.d.ts

@@ -0,0 +1,4 @@
+import { GenericProjectAgentAdapter } from './GenericProjectAgentAdapter.js';
+export declare class KiloCodeAdapter extends GenericProjectAgentAdapter {
+    constructor();
+}

package/dist/adapters/KiloCodeAdapter.js

@@ -0,0 +1,20 @@
+// SCALE Engine - Kilo Code Adapter
+import { GenericProjectAgentAdapter } from './GenericProjectAgentAdapter.js';
+export class KiloCodeAdapter extends GenericProjectAgentAdapter {
+    constructor() {
+        super({
+            agentType: 'kilocode',
+            displayName: 'Kilo Code',
+            settingsPath: '.kilocode/settings.json',
+            knowledgeDocPath: 'AGENTS.md',
+            skillsDir: '.kilocode/skills',
+            extraDirs: ['.kilocode/rules'],
+            installedPaths: ['.kilocode/settings.json', 'AGENTS.md'],
+            notes: [
+                'Kilo Code can read AGENTS.md style project instructions; SCALE creates it only when absent.',
+                'Platform-local metadata is kept under .kilocode/ to avoid overwriting unrelated agent configuration.',
+            ],
+        });
+    }
+}
+//# sourceMappingURL=KiloCodeAdapter.js.map

package/dist/adapters/KiloCodeAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KiloCodeAdapter.js","sourceRoot":"","sources":["../../src/adapters/KiloCodeAdapter.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAE5E,MAAM,OAAO,eAAgB,SAAQ,0BAA0B;IAC7D;QACE,KAAK,CAAC;YACJ,SAAS,EAAE,UAAU;YACrB,WAAW,EAAE,WAAW;YACxB,YAAY,EAAE,yBAAyB;YACvC,gBAAgB,EAAE,WAAW;YAC7B,SAAS,EAAE,kBAAkB;YAC7B,SAAS,EAAE,CAAC,iBAAiB,CAAC;YAC9B,cAAc,EAAE,CAAC,yBAAyB,EAAE,WAAW,CAAC;YACxD,KAAK,EAAE;gBACL,6FAA6F;gBAC7F,sGAAsG;aACvG;SACF,CAAC,CAAA;IACJ,CAAC;CACF"}

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) {