@hongmaple0820/scale-engine 0.2.0 → 0.5.0

package/dist/artifact/types.d.ts

@@ -130,6 +130,11 @@ export interface TaskPayload {
     dependsOn: ArtifactId[];
     requiredRole: string;
     requiredCapabilities: string[];
+    buildStatus?: 'pending' | 'success' | 'failed';
+    buildExitCode?: number;
+    lintStatus?: 'pending' | 'success' | 'failed';
+    testPassed?: boolean;
+    testCoverage?: number;
 }
 /** Change —— 实际代码变更 */
 export interface ChangePayload {
@@ -235,10 +240,11 @@ export interface GuardFailure {
 }
 export interface Session {
     id: SessionId;
-    agent: 'claude-code' | 'codex' | 'cursor' | 'gemini' | 'opencode' | 'unknown';
+    agent: AgentPlatform | 'unknown';
     startedAt: Timestamp;
     endedAt?: Timestamp;
     activeRole?: string;
+    scenarioMode?: ScenarioMode;
     metadata: Record<string, unknown>;
 }
 export interface ToolUseInput {
@@ -331,3 +337,58 @@ export declare class RoleDeniedError extends ScaleError {
 export declare class ArtifactNotFoundError extends ScaleError {
     constructor(id: string);
 }
+/** 场景模式：控制检测器敏感度、上下文规则、权限级别 */
+export type ScenarioMode = 'sandbox' | 'standard' | 'critical';
+/** 场景模式配置 */
+export interface ScenarioModeConfig {
+    mode: ScenarioMode;
+    detectorSensitivity: 'low' | 'medium' | 'high';
+    verificationRequired: boolean;
+    humanConfirmationRequired: boolean;
+    auditTrail: boolean;
+    maxRetries: number;
+}
+/** 场景模式预设配置 */
+export declare const SCENARIO_MODE_CONFIGS: Record<ScenarioMode, ScenarioModeConfig>;
+/** Agent 平台类型 */
+export type AgentPlatform = 'claude-code' | 'codex' | 'opencode' | 'cursor' | 'gemini' | 'openclaw' | 'hermes';
+/** Skill 引用 */
+export interface SkillRef {
+    id: string;
+    name: string;
+    description: string;
+    platform: AgentPlatform;
+    path: string;
+    enabled: boolean;
+}
+/** Skill 目录扫描结果 */
+export interface SkillScanResult {
+    platform: AgentPlatform;
+    skillsDir: string;
+    skills: SkillRef[];
+    exists: boolean;
+}
+/** 工作流步骤 */
+export interface WorkflowStep {
+    stepId: string;
+    skillId?: string;
+    action: string;
+    verificationGate?: string;
+    isMandatory: boolean;
+    description?: string;
+}
+/** 工作流预设 */
+export interface WorkflowPreset {
+    id: string;
+    name: string;
+    nameZh: string;
+    description: string;
+    steps: WorkflowStep[];
+    scenarioMode: ScenarioMode;
+    requiredArtifacts: Array<{
+        type: ArtifactType;
+        status?: string;
+    }>;
+}
+/** Agent 类型扩展（支持所有 7 种 Agent） */
+export type AgentType = AgentPlatform;

package/dist/artifact/types.js

@@ -47,4 +47,31 @@ export class ArtifactNotFoundError extends ScaleError {
         super(`Artifact '${id}' not found`, 'ARTIFACT_NOT_FOUND', { id });
     }
 }
+/** 场景模式预设配置 */
+export const SCENARIO_MODE_CONFIGS = {
+    sandbox: {
+        mode: 'sandbox',
+        detectorSensitivity: 'low',
+        verificationRequired: false,
+        humanConfirmationRequired: false,
+        auditTrail: false,
+        maxRetries: 10,
+    },
+    standard: {
+        mode: 'standard',
+        detectorSensitivity: 'medium',
+        verificationRequired: true,
+        humanConfirmationRequired: false,
+        auditTrail: true,
+        maxRetries: 5,
+    },
+    critical: {
+        mode: 'critical',
+        detectorSensitivity: 'high',
+        verificationRequired: true,
+        humanConfirmationRequired: true,
+        auditTrail: true,
+        maxRetries: 3,
+    },
+};
 //# sourceMappingURL=types.js.map

package/dist/artifact/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/artifact/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgeH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,MAAM,OAAO,UAAW,SAAQ,KAAK;IACC;IAAqB;IAAzD,YAAY,OAAe,EAAS,IAAY,EAAS,OAAiB;QACxE,KAAK,CAAC,OAAO,CAAC,CAAA;QADoB,SAAI,GAAJ,IAAI,CAAQ;QAAS,YAAO,GAAP,OAAO,CAAU;QAExE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IACpD,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,UAAU,IAAI,8BAA8B,MAAM,GAAG,EAAE,oBAAoB,EAAE;YACjF,IAAI;YACJ,MAAM;SACP,CAAC,CAAA;IACJ,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAC3B;IAAnB,YAAmB,QAAwB;QACzC,KAAK,CAAC,iCAAiC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE;YAChG,QAAQ;SACT,CAAC,CAAA;QAHe,aAAQ,GAAR,QAAQ,CAAgB;IAI3C,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,SAAS,IAAI,aAAa,MAAM,EAAE,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5E,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD,YAAY,EAAU;QACpB,KAAK,CAAC,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;IACnE,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/artifact/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAweH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,MAAM,OAAO,UAAW,SAAQ,KAAK;IACC;IAAqB;IAAzD,YAAY,OAAe,EAAS,IAAY,EAAS,OAAiB;QACxE,KAAK,CAAC,OAAO,CAAC,CAAA;QADoB,SAAI,GAAJ,IAAI,CAAQ;QAAS,YAAO,GAAP,OAAO,CAAU;QAExE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IACpD,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,UAAU,IAAI,8BAA8B,MAAM,GAAG,EAAE,oBAAoB,EAAE;YACjF,IAAI;YACJ,MAAM;SACP,CAAC,CAAA;IACJ,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAC3B;IAAnB,YAAmB,QAAwB;QACzC,KAAK,CAAC,iCAAiC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE;YAChG,QAAQ;SACT,CAAC,CAAA;QAHe,aAAQ,GAAR,QAAQ,CAAgB;IAI3C,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,SAAS,IAAI,aAAa,MAAM,EAAE,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5E,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD,YAAY,EAAU;QACpB,KAAK,CAAC,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;IACnE,CAAC;CACF;AAmBD,eAAe;AACf,MAAM,CAAC,MAAM,qBAAqB,GAA6C;IAC7E,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,mBAAmB,EAAE,KAAK;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,yBAAyB,EAAE,KAAK;QAChC,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,EAAE;KACf;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,mBAAmB,EAAE,QAAQ;QAC7B,oBAAoB,EAAE,IAAI;QAC1B,yBAAyB,EAAE,KAAK;QAChC,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,CAAC;KACd;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,mBAAmB,EAAE,MAAM;QAC3B,oBAAoB,EAAE,IAAI;QAC1B,yBAAyB,EAAE,IAAI;QAC/B,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,CAAC;KACd;CACF,CAAA"}

package/dist/context/ContextBuilder.d.ts

@@ -1,4 +1,4 @@
-import type { ArtifactId, SessionId } from '../artifact/types.js';
+import type { ArtifactId, SessionId, ScenarioMode } from '../artifact/types.js';
 import type { IArtifactStore } from '../artifact/store.js';
 import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
 import type { IEventBus } from '../core/eventBus.js';
@@ -13,14 +13,37 @@ export interface BuiltContext {
     metadata: {
         totalTokens: number;
         layers: string[];
+        scenarioMode?: ScenarioMode;
     };
 }
+export interface ContextStatus {
+    sessionId: SessionId;
+    role: string;
+    allowedTools: string[];
+    deniedTools: string[];
+    activeArtifacts: Array<{
+        id: ArtifactId;
+        type: string;
+        status: string;
+        current?: boolean;
+    }>;
+    constraints: string[];
+    scenarioMode?: ScenarioMode;
+}
 export interface IContextBuilder {
     build(opts: {
         roleId?: string;
         currentArtifactId?: ArtifactId;
         sessionId: SessionId;
+        scenarioMode?: ScenarioMode;
     }): Promise<BuiltContext>;
+    getStatus(sessionId: SessionId, roleGate: {
+        getRole(): {
+            id: string;
+            allowedTools: string[];
+            deniedTools?: string[];
+        };
+    }): Promise<ContextStatus>;
 }
 export declare class ContextBuilder implements IContextBuilder {
     private store;
@@ -32,5 +55,13 @@ export declare class ContextBuilder implements IContextBuilder {
         roleId?: string;
         currentArtifactId?: ArtifactId;
         sessionId: SessionId;
+        scenarioMode?: ScenarioMode;
     }): Promise<BuiltContext>;
+    getStatus(sessionId: SessionId, roleGate: {
+        getRole(): {
+            id: string;
+            allowedTools: string[];
+            deniedTools?: string[];
+        };
+    }): Promise<ContextStatus>;
 }

package/dist/context/ContextBuilder.js

@@ -1,6 +1,75 @@
-// SCALE Engine — Context Builder (W6 完整实现)
-// 分层上下文加载 + Token 预算
+// SCALE Engine — Context Builder (v0.5.0 完整实现)
+// 分层上下文加载 + Token 预算 + SCALE v10.0 哲学 P1 层 + 场景模式感知
 // 设计参考：docs/03-CORE-MODULES.md §3.6
+// ============================================================================
+// SCALE v10.0 Philosophy — P1 system_rules layer content
+// ============================================================================
+const SCALE_V10_PHILOSOPHY = `## SCALE Engine v10.0 — System Rules
+
+You are operating under SCALE Engine governance. These rules are PHYSICALLY ENFORCED — you cannot bypass them by choice.
+
+### Core Philosophy
+- **S**caffold — Every action is scaffolded by artifacts (Spec→Plan→Task→Change→Evidence)
+- **C**ontrol — Guardrails physically block dangerous actions; no "soft" suggestions
+- **A**rtifact — All work products are tracked artifacts with FSM state machines
+- **L**earn — Defects auto-extract to Lessons → Rules → Hooks (evolution loop)
+- **E**volve — The system improves itself from mistakes
+
+### Physical Constraints (cannot be bypassed)
+🔴 **Dangerous commands** (rm -rf, DROP TABLE, format) are BLOCKED at the gate
+🔴 **Hardcoded secrets** (AWS keys, passwords, tokens) are BLOCKED on Edit/Write
+🔴 **Unapproved code** — Cannot implement until Spec is FROZEN and Plan is APPROVED
+🟡 **Brute retry** — 3+ identical retries detected → forced pause + context injection
+🟡 **Premature completion** — Cannot claim "done" without running tests
+🟡 **Blame shift** — Detected when AI blames environment without evidence
+
+### Mandatory Workflow
+1. **Explore** (role: explorer) — Read/Grep only, no edits
+2. **Plan** (role: planner) — Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
+3. **Implement** (role: implementer) — Edit/Write/Bash unlocked only after Plan APPROVED
+4. **Verify** — Must run build+lint+test before marking task complete
+5. **Learn** — Defects auto-extract → lessons → rules → hooks
+
+### Artifact Lifecycle
+- Every piece of work is an Artifact with typed FSM transitions
+- Guards check quality gates at each transition (ambiguity score, test coverage, etc.)
+- Artifacts form a DAG: Need→Insight→Spec→Plan→Task→Change→Evidence
+- Challenging a FROZEN Spec invalidates downstream Plans and Tasks
+
+### Self-Evolution
+- Defect → Lesson (auto-extracted from root cause)
+- Lesson → Rule (promoted by access count + verification)
+- Rule → Hook (auto-generated enforcement code)
+- The system gets stricter over time, not weaker`;
+// ============================================================================
+// Scenario Mode Context Additions
+// ============================================================================
+const SCENARIO_CONTEXT = {
+    sandbox: `### Scenario Mode: SANDBOX 🏖️
+- Lower detector sensitivity — exploratory work allowed
+- Verification NOT required before completion
+- Human confirmation NOT required
+- Audit trail disabled (lighter weight)
+- Max retries: 10 (freedom to experiment)
+- Use for: prototyping, exploration, learning`,
+    standard: `### Scenario Mode: STANDARD ⚙️
+- Medium detector sensitivity — production-quality required
+- Verification REQUIRED before completion
+- Human confirmation NOT required (trust the process)
+- Audit trail ENABLED
+- Max retries: 5 (balanced)
+- Use for: feature development, bug fixes, regular work`,
+    critical: `### Scenario Mode: CRITICAL 🔒
+- Maximum detector sensitivity — zero tolerance for errors
+- Verification REQUIRED before completion
+- Human confirmation REQUIRED for key transitions
+- Audit trail ENABLED (comprehensive)
+- Max retries: 3 (fail fast, escalate)
+- Use for: security changes, production deployments, data migrations`,
+};
+// ============================================================================
+// ContextBuilder
+// ============================================================================
 export class ContextBuilder {
     store;
     kb;
@@ -12,11 +81,27 @@ export class ContextBuilder {
         this.eventBus = eventBus;
     }
     async build(opts) {
+        const scenarioMode = opts.scenarioMode ?? 'standard';
         const layers = [];
-        layers.push({ name: 'system_rules', content: '## SCALE Core Rules\n...', priority: 1, estimatedTokens: 3000 });
+        // P1: System Rules — SCALE v10.0 Philosophy (always present, highest priority)
+        layers.push({
+            name: 'system_rules',
+            content: SCALE_V10_PHILOSOPHY,
+            priority: 1,
+            estimatedTokens: 3500,
+        });
+        // P1.5: Scenario Mode awareness
+        layers.push({
+            name: 'scenario_mode',
+            content: SCENARIO_CONTEXT[scenarioMode],
+            priority: 1,
+            estimatedTokens: 800,
+        });
+        // P2: Role prompt
         if (opts.roleId) {
             layers.push({ name: 'role_prompt', content: `## Active Role: ${opts.roleId}\n...`, priority: 2, estimatedTokens: 1500 });
         }
+        // P3: Current artifact context
         if (opts.currentArtifactId) {
             const artifact = await this.store.get(opts.currentArtifactId);
             if (artifact) {
@@ -43,10 +128,55 @@ export class ContextBuilder {
             selected.push(layer);
             used += layer.estimatedTokens;
         }
-        this.eventBus.emit('context.built', { layers: selected.map((l) => l.name), totalTokens: used }, { sessionId: opts.sessionId });
+        this.eventBus.emit('context.built', { layers: selected.map((l) => l.name), totalTokens: used, scenarioMode }, { sessionId: opts.sessionId });
         return {
             system: selected.map((l) => l.content).join('\n\n---\n\n'),
-            metadata: { totalTokens: used, layers: selected.map((l) => l.name) },
+            metadata: { totalTokens: used, layers: selected.map((l) => l.name), scenarioMode },
+        };
+    }
+    async getStatus(sessionId, roleGate) {
+        const role = roleGate.getRole();
+        // Query active artifacts for this session (linked via events)
+        const events = await this.eventBus.query({
+            sessionId,
+            types: ['artifact.created', 'artifact.transitioned'],
+            limit: 50
+        });
+        const artifactIds = new Set();
+        for (const event of events) {
+            if (event.artifactId) {
+                artifactIds.add(event.artifactId);
+            }
+        }
+        const activeArtifacts = await Promise.all(Array.from(artifactIds).map(async (id) => {
+            const artifact = await this.store.get(id);
+            return artifact ? {
+                id: artifact.id,
+                type: artifact.type,
+                status: artifact.status,
+            } : null;
+        }));
+        const validArtifacts = activeArtifacts.filter((a) => a !== null);
+        // Extract constraints from artifacts and FSM definitions
+        const constraints = [];
+        for (const artifact of validArtifacts) {
+            if (artifact.type === 'Spec' && artifact.status !== 'FROZEN') {
+                constraints.push(`Spec must be FROZEN before writing code (current: ${artifact.status})`);
+            }
+            if (artifact.type === 'Plan' && artifact.status === 'DRAFT') {
+                constraints.push(`Plan must be approved before implementation`);
+            }
+            if (artifact.type === 'Task' && artifact.status === 'TODO') {
+                constraints.push(`Task must be READY before implementation`);
+            }
+        }
+        return {
+            sessionId,
+            role: role.id,
+            allowedTools: role.allowedTools,
+            deniedTools: role.deniedTools ?? [],
+            activeArtifacts: validArtifacts,
+            constraints,
         };
     }
 }

package/dist/context/ContextBuilder.js.map

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

package/dist/index.d.ts

@@ -12,11 +12,13 @@ export { BehaviorTracker } from './evolution/BehaviorTracker.js';
 export { LessonExtractor, RuleProposer, HookGenerator, EvolutionEngine } from './evolution/EvolutionEngine.js';
 export { Gateway } from './guardrails/Gateway.js';
 export { ROLES, getRole, listRoles } from './guardrails/roles.js';
+export { BruteRetryDetector, IdleToolDetector, BusyLoopDetector, PrematureDoneDetector, BlameShiftDetector, } from './guardrails/detectors.js';
 export { ContextBuilder } from './context/ContextBuilder.js';
 export { wireEffects } from './orchestration/EffectsWiring.js';
 export { ModelRouter, DEFAULT_MODELS } from './routing/ModelRouter.js';
-export { ClaudeCodeAdapter, createAdapter } from './adapters/ClaudeCodeAdapter.js';
-export { CodexAdapter } from './adapters/CodexAdapter.js';
+export { ClaudeCodeAdapter, CodexAdapter, OpenCodeAdapter, CursorAdapter, GeminiAdapter, OpenClawAdapter, HermesAdapter, createAdapter, SUPPORTED_AGENTS, } from './adapters/index.js';
+export type { IAgentAdapter, AdapterConfig, InitResult, SettingsJson, HookEntry } from './adapters/ClaudeCodeAdapter.js';
+export { SkillDiscovery } from './skills/SkillDiscovery.js';
+export { WORKFLOW_PRESETS, getWorkflowPreset, listWorkflowPresets, getPresetsByScenario, BASIC_DEV, TDD_DEV, BUG_FIX, SDD, CODE_REVIEW, SECURITY_AUDIT, RALPH_LOOP, RAPID_PROTO, MASSIVE_REFACTOR, PARALLEL_EXEC, } from './workflows/presets.js';
 export { Doctor } from './api/doctor.js';
 export { ScaleMCPServer } from './api/mcp.js';
-export { BruteRetryDetector, IdleToolDetector, BusyLoopDetector, PrematureDoneDetector, BlameShiftDetector, } from './guardrails/detectors.js';

package/dist/index.js

@@ -1,22 +1,39 @@
-// SCALE Engine — Public API
+// SCALE Engine v0.5.0 — Public API
+// S · C · A · L · E: Scaffold · Control · Artifact · Learn · Evolve
+// Core types
 export * from './artifact/types.js';
+// FSM
 export { FSM, SpecFSM } from './artifact/fsm.js';
+// Artifact Store
 export { InMemoryArtifactStore } from './artifact/store.js';
+// Core Infrastructure
 export { EventBus } from './core/eventBus.js';
 export { Container, container, createToken } from './core/container.js';
 export { logger } from './core/logger.js';
+// Task Engine
 export { TaskEngine } from './tasks/TaskEngine.js';
+// Knowledge Base
 export { KnowledgeBase } from './knowledge/KnowledgeBase.js';
+// Evolution
 export { BehaviorTracker } from './evolution/BehaviorTracker.js';
 export { LessonExtractor, RuleProposer, HookGenerator, EvolutionEngine } from './evolution/EvolutionEngine.js';
+// Guardrails
 export { Gateway } from './guardrails/Gateway.js';
 export { ROLES, getRole, listRoles } from './guardrails/roles.js';
+export { BruteRetryDetector, IdleToolDetector, BusyLoopDetector, PrematureDoneDetector, BlameShiftDetector, } from './guardrails/detectors.js';
+// Context
 export { ContextBuilder } from './context/ContextBuilder.js';
+// Orchestration
 export { wireEffects } from './orchestration/EffectsWiring.js';
+// Routing
 export { ModelRouter, DEFAULT_MODELS } from './routing/ModelRouter.js';
-export { ClaudeCodeAdapter, createAdapter } from './adapters/ClaudeCodeAdapter.js';
-export { CodexAdapter } from './adapters/CodexAdapter.js';
+// Adapters (all 7 platforms)
+export { ClaudeCodeAdapter, CodexAdapter, OpenCodeAdapter, CursorAdapter, GeminiAdapter, OpenClawAdapter, HermesAdapter, createAdapter, SUPPORTED_AGENTS, } from './adapters/index.js';
+// Skill Discovery
+export { SkillDiscovery } from './skills/SkillDiscovery.js';
+// Workflow Presets
+export { WORKFLOW_PRESETS, getWorkflowPreset, listWorkflowPresets, getPresetsByScenario, BASIC_DEV, TDD_DEV, BUG_FIX, SDD, CODE_REVIEW, SECURITY_AUDIT, RALPH_LOOP, RAPID_PROTO, MASSIVE_REFACTOR, PARALLEL_EXEC, } from './workflows/presets.js';
+// API
 export { Doctor } from './api/doctor.js';
 export { ScaleMCPServer } from './api/mcp.js';
-export { BruteRetryDetector, IdleToolDetector, BusyLoopDetector, PrematureDoneDetector, BlameShiftDetector, } from './guardrails/detectors.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAC9G,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EACL,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EACtD,qBAAqB,EAAE,kBAAkB,GAC1C,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,oEAAoE;AAEpE,aAAa;AACb,cAAc,qBAAqB,CAAA;AAEnC,MAAM;AACN,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEhD,iBAAiB;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAG3D,sBAAsB;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAE5D,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAE9G,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,EACL,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EACtD,qBAAqB,EAAE,kBAAkB,GAC1C,MAAM,2BAA2B,CAAA;AAElC,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAE5D,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAE9D,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEtE,6BAA6B;AAC7B,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,qBAAqB,CAAA;AAG5B,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAE3D,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,EACT,OAAO,EACP,OAAO,EACP,GAAG,EACH,WAAW,EACX,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,GACd,MAAM,wBAAwB,CAAA;AAE/B,MAAM;AACN,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/dist/skills/SkillDiscovery.d.ts

@@ -0,0 +1,28 @@
+import type { AgentPlatform, SkillRef, SkillScanResult } from '../artifact/types.js';
+export declare class SkillDiscovery {
+    private projectDir;
+    constructor(projectDir?: string);
+    /**
+     * Detect the active agent platform based on config files present in the project.
+     * Returns the most likely platform, or null if indeterminate.
+     */
+    detectPlatform(): AgentPlatform | null;
+    /**
+     * Scan the skills directory for a given platform.
+     * Returns structured skill references.
+     */
+    scanSkills(platform: AgentPlatform): SkillScanResult;
+    /**
+     * Generate a skills.md document from discovered skills.
+     * Useful for injecting into agent knowledge docs.
+     */
+    generateSkillsMd(skills: SkillRef[]): string;
+    /**
+     * Full discovery pipeline: detect platform → scan → generate doc.
+     */
+    discover(): {
+        platform: AgentPlatform | null;
+        skills: SkillRef[];
+        skillsMd: string;
+    };
+}

package/dist/skills/SkillDiscovery.js

@@ -0,0 +1,171 @@
+// SCALE Engine — Skill Discovery
+// 检测平台 → 扫描技能目录 → 生成 skills.md
+// 设计参考：SCALE v10.0 技能生态系统
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+// ============================================================================
+// Platform Skills Directory Map
+// ============================================================================
+const PLATFORM_SKILLS_DIRS = {
+    'claude-code': null, // Claude Code uses .claude/commands/, no dedicated skills dir
+    'codex': null, // Codex uses .codex/commands/
+    'opencode': join(homedir(), '.config', 'opencode', 'skills'),
+    'cursor': join('.cursor', 'skills'),
+    'gemini': null, // Gemini has no skills directory concept
+    'openclaw': null, // OpenClaw has no skills directory concept
+    'hermes': null, // Hermes has no skills directory concept
+};
+// ============================================================================
+// SkillDiscovery
+// ============================================================================
+export class SkillDiscovery {
+    projectDir;
+    constructor(projectDir = '.') {
+        this.projectDir = projectDir;
+    }
+    /**
+     * Detect the active agent platform based on config files present in the project.
+     * Returns the most likely platform, or null if indeterminate.
+     */
+    detectPlatform() {
+        const checks = [
+            { platform: 'claude-code', paths: [join(this.projectDir, '.claude', 'settings.json')] },
+            { platform: 'codex', paths: [join(this.projectDir, '.codex', 'hooks.json')] },
+            { platform: 'opencode', paths: [join(homedir(), '.config', 'opencode', 'hooks.json')] },
+            { platform: 'cursor', paths: [join(this.projectDir, '.cursor', 'settings.json')] },
+            { platform: 'gemini', paths: [join(this.projectDir, '.gemini', 'settings.json')] },
+            { platform: 'openclaw', paths: [join(this.projectDir, '.openclaw', 'settings.json')] },
+            { platform: 'hermes', paths: [join(this.projectDir, '.hermes', 'settings.json')] },
+        ];
+        for (const check of checks) {
+            if (check.paths.some((p) => existsSync(p))) {
+                return check.platform;
+            }
+        }
+        return null;
+    }
+    /**
+     * Scan the skills directory for a given platform.
+     * Returns structured skill references.
+     */
+    scanSkills(platform) {
+        const skillsDir = PLATFORM_SKILLS_DIRS[platform];
+        if (!skillsDir) {
+            return {
+                platform,
+                skillsDir: '',
+                skills: [],
+                exists: false,
+            };
+        }
+        const resolvedDir = platform === 'opencode'
+            ? skillsDir
+            : join(this.projectDir, skillsDir);
+        if (!existsSync(resolvedDir)) {
+            return {
+                platform,
+                skillsDir: resolvedDir,
+                skills: [],
+                exists: false,
+            };
+        }
+        const skills = [];
+        try {
+            const entries = readdirSync(resolvedDir);
+            for (const entry of entries) {
+                const entryPath = join(resolvedDir, entry);
+                const stat = statSync(entryPath);
+                if (stat.isFile() && (entry.endsWith('.md') || entry.endsWith('.json') || entry.endsWith('.yaml') || entry.endsWith('.yml'))) {
+                    const name = entry.replace(/\.(md|json|ya?ml)$/, '');
+                    let description = '';
+                    // Try to extract description from file content
+                    try {
+                        const content = readFileSync(entryPath, 'utf-8');
+                        // Extract first line as description for .md files
+                        if (entry.endsWith('.md')) {
+                            const firstLine = content.split('\n').find((l) => l.trim().length > 0) ?? '';
+                            description = firstLine.replace(/^#+\s*/, '').trim();
+                        }
+                        else if (entry.endsWith('.json')) {
+                            const parsed = JSON.parse(content);
+                            description = parsed.description ?? parsed.name ?? '';
+                        }
+                    }
+                    catch {
+                        description = '';
+                    }
+                    skills.push({
+                        id: `${platform}-${name}`,
+                        name,
+                        description,
+                        platform,
+                        path: entryPath,
+                        enabled: true,
+                    });
+                }
+                else if (stat.isDirectory()) {
+                    // Directory-based skills
+                    skills.push({
+                        id: `${platform}-${entry}`,
+                        name: entry,
+                        description: '',
+                        platform,
+                        path: entryPath,
+                        enabled: true,
+                    });
+                }
+            }
+        }
+        catch {
+            // Permission or read error
+        }
+        return {
+            platform,
+            skillsDir: resolvedDir,
+            skills,
+            exists: true,
+        };
+    }
+    /**
+     * Generate a skills.md document from discovered skills.
+     * Useful for injecting into agent knowledge docs.
+     */
+    generateSkillsMd(skills) {
+        if (skills.length === 0) {
+            return '## Available Skills\n\nNo skills discovered.\n';
+        }
+        const grouped = new Map();
+        for (const skill of skills) {
+            const group = grouped.get(skill.platform) ?? [];
+            group.push(skill);
+            grouped.set(skill.platform, group);
+        }
+        const sections = ['## Available Skills\n'];
+        for (const [platform, platformSkills] of grouped) {
+            sections.push(`### ${platform}`);
+            sections.push('');
+            for (const skill of platformSkills) {
+                const desc = skill.description ? ` — ${skill.description}` : '';
+                const status = skill.enabled ? '✅' : '❌';
+                sections.push(`- ${status} **${skill.name}**${desc}`);
+            }
+            sections.push('');
+        }
+        return sections.join('\n');
+    }
+    /**
+     * Full discovery pipeline: detect platform → scan → generate doc.
+     */
+    discover() {
+        const platform = this.detectPlatform();
+        let skills = [];
+        if (platform) {
+            const result = this.scanSkills(platform);
+            skills = result.skills;
+        }
+        const skillsMd = this.generateSkillsMd(skills);
+        return { platform, skills, skillsMd };
+    }
+}
+//# sourceMappingURL=SkillDiscovery.js.map

package/dist/skills/SkillDiscovery.js.map

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