@hongmaple0820/scale-engine 0.3.0 → 0.6.0

package/dist/artifact/sqliteStore.js

@@ -17,67 +17,67 @@ import { dirname, join } from 'node:path';
 // ============================================================================
 // Schema DDL
 // ============================================================================
-const SCHEMA_DDL = `
--- Artifacts 主表
-CREATE TABLE IF NOT EXISTS artifacts (
-  id            TEXT PRIMARY KEY,
-  type          TEXT NOT NULL,
-  version       INTEGER NOT NULL DEFAULT 1,
-  status        TEXT NOT NULL DEFAULT 'DRAFT',
-  status_history TEXT NOT NULL DEFAULT '[]',   -- JSON array of StatusChange
-  parents       TEXT NOT NULL DEFAULT '[]',    -- JSON array of ArtifactId
-  children      TEXT NOT NULL DEFAULT '[]',    -- JSON array of ArtifactId
-  supersedes    TEXT,
-  title         TEXT NOT NULL,
-  content_ref   TEXT NOT NULL DEFAULT '',
-  payload       TEXT NOT NULL DEFAULT '{}',    -- JSON
-  gates         TEXT NOT NULL DEFAULT '[]',    -- JSON array of Gate
-  created_by    TEXT NOT NULL DEFAULT '{}',    -- JSON Actor
-  created_at    INTEGER NOT NULL,
-  updated_at    INTEGER NOT NULL,
-  closed_at     INTEGER,
-  tags          TEXT NOT NULL DEFAULT '[]',    -- JSON array
-  labels        TEXT NOT NULL DEFAULT '{}'     -- JSON object
-);
-
-CREATE INDEX IF NOT EXISTS idx_artifacts_type ON artifacts(type);
-CREATE INDEX IF NOT EXISTS idx_artifacts_status ON artifacts(status);
-CREATE INDEX IF NOT EXISTS idx_artifacts_created_at ON artifacts(created_at);
-
--- Events 表（事件溯源的持久化副本）
-CREATE TABLE IF NOT EXISTS events (
-  id           TEXT PRIMARY KEY,
-  type         TEXT NOT NULL,
-  timestamp    INTEGER NOT NULL,
-  session_id   TEXT,
-  artifact_id  TEXT,
-  actor        TEXT DEFAULT '{}',
-  payload      TEXT NOT NULL DEFAULT '{}',
-  metadata     TEXT DEFAULT '{}'
-);
-
-CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
-CREATE INDEX IF NOT EXISTS idx_events_artifact_id ON events(artifact_id);
-CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);
-
--- Artifact 关系边表（加速 parent/child 查询）
-CREATE TABLE IF NOT EXISTS artifact_edges (
-  parent_id TEXT NOT NULL,
-  child_id  TEXT NOT NULL,
-  PRIMARY KEY (parent_id, child_id)
-);
-
-CREATE INDEX IF NOT EXISTS idx_edges_parent ON artifact_edges(parent_id);
-CREATE INDEX IF NOT EXISTS idx_edges_child ON artifact_edges(child_id);
-
--- 元信息表
-CREATE TABLE IF NOT EXISTS meta (
-  key   TEXT PRIMARY KEY,
-  value TEXT NOT NULL
-);
-
--- 初始化 schema version
-INSERT OR IGNORE INTO meta (key, value) VALUES ('schema_version', '1');
+const SCHEMA_DDL = `
+-- Artifacts 主表
+CREATE TABLE IF NOT EXISTS artifacts (
+  id            TEXT PRIMARY KEY,
+  type          TEXT NOT NULL,
+  version       INTEGER NOT NULL DEFAULT 1,
+  status        TEXT NOT NULL DEFAULT 'DRAFT',
+  status_history TEXT NOT NULL DEFAULT '[]',   -- JSON array of StatusChange
+  parents       TEXT NOT NULL DEFAULT '[]',    -- JSON array of ArtifactId
+  children      TEXT NOT NULL DEFAULT '[]',    -- JSON array of ArtifactId
+  supersedes    TEXT,
+  title         TEXT NOT NULL,
+  content_ref   TEXT NOT NULL DEFAULT '',
+  payload       TEXT NOT NULL DEFAULT '{}',    -- JSON
+  gates         TEXT NOT NULL DEFAULT '[]',    -- JSON array of Gate
+  created_by    TEXT NOT NULL DEFAULT '{}',    -- JSON Actor
+  created_at    INTEGER NOT NULL,
+  updated_at    INTEGER NOT NULL,
+  closed_at     INTEGER,
+  tags          TEXT NOT NULL DEFAULT '[]',    -- JSON array
+  labels        TEXT NOT NULL DEFAULT '{}'     -- JSON object
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_type ON artifacts(type);
+CREATE INDEX IF NOT EXISTS idx_artifacts_status ON artifacts(status);
+CREATE INDEX IF NOT EXISTS idx_artifacts_created_at ON artifacts(created_at);
+
+-- Events 表（事件溯源的持久化副本）
+CREATE TABLE IF NOT EXISTS events (
+  id           TEXT PRIMARY KEY,
+  type         TEXT NOT NULL,
+  timestamp    INTEGER NOT NULL,
+  session_id   TEXT,
+  artifact_id  TEXT,
+  actor        TEXT DEFAULT '{}',
+  payload      TEXT NOT NULL DEFAULT '{}',
+  metadata     TEXT DEFAULT '{}'
+);
+
+CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
+CREATE INDEX IF NOT EXISTS idx_events_artifact_id ON events(artifact_id);
+CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);
+
+-- Artifact 关系边表（加速 parent/child 查询）
+CREATE TABLE IF NOT EXISTS artifact_edges (
+  parent_id TEXT NOT NULL,
+  child_id  TEXT NOT NULL,
+  PRIMARY KEY (parent_id, child_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_edges_parent ON artifact_edges(parent_id);
+CREATE INDEX IF NOT EXISTS idx_edges_child ON artifact_edges(child_id);
+
+-- 元信息表
+CREATE TABLE IF NOT EXISTS meta (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+-- 初始化 schema version
+INSERT OR IGNORE INTO meta (key, value) VALUES ('schema_version', '1');
 `;
 // ============================================================================
 // SQLiteArtifactStore
@@ -131,38 +131,38 @@ export class SQLiteArtifactStore {
         });
     }
     prepareStatements() {
-        this.stmtInsert = this.db.prepare(`
-      INSERT INTO artifacts (id, type, version, status, status_history, parents, children, supersedes,
-        title, content_ref, payload, gates, created_by, created_at, updated_at, closed_at, tags, labels)
-      VALUES (@id, @type, @version, @status, @statusHistory, @parents, @children, @supersedes,
-        @title, @contentRef, @payload, @gates, @createdBy, @createdAt, @updatedAt, @closedAt, @tags, @labels)
+        this.stmtInsert = this.db.prepare(`
+      INSERT INTO artifacts (id, type, version, status, status_history, parents, children, supersedes,
+        title, content_ref, payload, gates, created_by, created_at, updated_at, closed_at, tags, labels)
+      VALUES (@id, @type, @version, @status, @statusHistory, @parents, @children, @supersedes,
+        @title, @contentRef, @payload, @gates, @createdBy, @createdAt, @updatedAt, @closedAt, @tags, @labels)
     `);
         this.stmtGet = this.db.prepare(`SELECT * FROM artifacts WHERE id = ?`);
-        this.stmtUpdate = this.db.prepare(`
-      UPDATE artifacts SET
-        version = @version, status = @status, status_history = @statusHistory,
-        parents = @parents, children = @children, supersedes = @supersedes,
-        title = @title, content_ref = @contentRef, payload = @payload,
-        gates = @gates, updated_at = @updatedAt, closed_at = @closedAt,
-        tags = @tags, labels = @labels
-      WHERE id = @id
+        this.stmtUpdate = this.db.prepare(`
+      UPDATE artifacts SET
+        version = @version, status = @status, status_history = @statusHistory,
+        parents = @parents, children = @children, supersedes = @supersedes,
+        title = @title, content_ref = @contentRef, payload = @payload,
+        gates = @gates, updated_at = @updatedAt, closed_at = @closedAt,
+        tags = @tags, labels = @labels
+      WHERE id = @id
     `);
         this.stmtDelete = this.db.prepare(`DELETE FROM artifacts WHERE id = ?`);
         this.stmtInsertEdge = this.db.prepare(`INSERT OR IGNORE INTO artifact_edges (parent_id, child_id) VALUES (?, ?)`);
         this.stmtDeleteEdges = this.db.prepare(`DELETE FROM artifact_edges WHERE child_id = ?`);
-        this.stmtFindChildren = this.db.prepare(`
-      SELECT a.* FROM artifacts a
-      INNER JOIN artifact_edges e ON a.id = e.child_id
-      WHERE e.parent_id = ?
+        this.stmtFindChildren = this.db.prepare(`
+      SELECT a.* FROM artifacts a
+      INNER JOIN artifact_edges e ON a.id = e.child_id
+      WHERE e.parent_id = ?
     `);
-        this.stmtFindParents = this.db.prepare(`
-      SELECT a.* FROM artifacts a
-      INNER JOIN artifact_edges e ON a.id = e.parent_id
-      WHERE e.child_id = ?
+        this.stmtFindParents = this.db.prepare(`
+      SELECT a.* FROM artifacts a
+      INNER JOIN artifact_edges e ON a.id = e.parent_id
+      WHERE e.child_id = ?
     `);
-        this.stmtInsertEvent = this.db.prepare(`
-      INSERT OR IGNORE INTO events (id, type, timestamp, session_id, artifact_id, actor, payload, metadata)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        this.stmtInsertEvent = this.db.prepare(`
+      INSERT OR IGNORE INTO events (id, type, timestamp, session_id, artifact_id, actor, payload, metadata)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
     `);
     }
     // ===== CRUD =====
@@ -276,10 +276,10 @@ export class SQLiteArtifactStore {
     }
     async findChildren(parentId, type) {
         if (type) {
-            const rows = this.db.prepare(`
-        SELECT a.* FROM artifacts a
-        INNER JOIN artifact_edges e ON a.id = e.child_id
-        WHERE e.parent_id = ? AND a.type = ?
+            const rows = this.db.prepare(`
+        SELECT a.* FROM artifacts a
+        INNER JOIN artifact_edges e ON a.id = e.child_id
+        WHERE e.parent_id = ? AND a.type = ?
       `).all(parentId, type);
             return rows.map((r) => this.fromRow(r));
         }

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,6 +13,7 @@ export interface BuiltContext {
     metadata: {
         totalTokens: number;
         layers: string[];
+        scenarioMode?: ScenarioMode;
     };
 }
 export interface ContextStatus {
@@ -27,12 +28,14 @@ export interface ContextStatus {
         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(): {
@@ -52,6 +55,7 @@ export declare class ContextBuilder implements IContextBuilder {
         roleId?: string;
         currentArtifactId?: ArtifactId;
         sessionId: SessionId;
+        scenarioMode?: ScenarioMode;
     }): Promise<BuiltContext>;
     getStatus(sessionId: SessionId, roleGate: {
         getRole(): {

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,10 @@ 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) {

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/evolution/EvolutionEngine.js

@@ -165,20 +165,20 @@ export class RuleProposer {
         mkdirSync(rulesDir, { recursive: true });
         const filename = `${rule.id}.md`;
         const path = join(rulesDir, filename);
-        const content = `# ${rule.title}
-
-> Source: ${rule.sourceLesson}
-> Enforcement: ${rule.enforcement}
-> Approved: ${rule.approved ? `Yes (by ${rule.approvedBy})` : 'Pending'}
-> Created: ${new Date(rule.createdAt).toISOString()}
-
-## Description
-
-${rule.description}
-
-## Pattern
-
-\`${rule.pattern}\`
+        const content = `# ${rule.title}
+
+> Source: ${rule.sourceLesson}
+> Enforcement: ${rule.enforcement}
+> Approved: ${rule.approved ? `Yes (by ${rule.approvedBy})` : 'Pending'}
+> Created: ${new Date(rule.createdAt).toISOString()}
+
+## Description
+
+${rule.description}
+
+## Pattern
+
+\`${rule.pattern}\`
 `;
         writeFileSync(path, content, 'utf-8');
         return path;
@@ -205,23 +205,23 @@ export class HookGenerator {
         const scriptName = `${rule.id}.sh`;
         const scriptPath = join(hooksDir, scriptName);
         // Generate shell script
-        const script = `#!/bin/bash
-# Auto-generated hook from Rule: ${rule.id}
-# Source lesson: ${rule.sourceLesson}
-# Pattern: ${rule.pattern}
-# Hook type: ${hookType} | Matcher: ${matcher}
-#
-# This hook was automatically promoted from a recurring lesson.
-# Edit with caution — it enforces a hard constraint.
-
-# Read tool input from stdin
-INPUT=$(cat)
-
-# Check condition
-# TODO: Implement specific check for pattern "${rule.pattern}"
-# For now, this is a placeholder that always passes.
-echo "Hook ${rule.id} checked (pattern: ${rule.pattern})" >&2
-exit 0
+        const script = `#!/bin/bash
+# Auto-generated hook from Rule: ${rule.id}
+# Source lesson: ${rule.sourceLesson}
+# Pattern: ${rule.pattern}
+# Hook type: ${hookType} | Matcher: ${matcher}
+#
+# This hook was automatically promoted from a recurring lesson.
+# Edit with caution — it enforces a hard constraint.
+
+# Read tool input from stdin
+INPUT=$(cat)
+
+# Check condition
+# TODO: Implement specific check for pattern "${rule.pattern}"
+# For now, this is a placeholder that always passes.
+echo "Hook ${rule.id} checked (pattern: ${rule.pattern})" >&2
+exit 0
 `;
         writeFileSync(scriptPath, script, 'utf-8');
         const hook = {

package/dist/guardrails/advancedDetectors.d.ts

@@ -24,3 +24,15 @@ export declare class RoleGateDetector implements IDetector {
     getRole(): RoleDefinition;
     check(input: ToolUseInput, _ctx: DetectorContext): Promise<DetectorResult>;
 }
+export declare class ScopeCreepDetector implements IDetector {
+    name: string;
+    /** Max distinct files allowed per session before warning */
+    private maxFiles;
+    /** Window in ms to track file edits */
+    private windowMs;
+    constructor(opts?: {
+        maxFiles?: number;
+        windowMs?: number;
+    });
+    check(input: ToolUseInput, ctx: DetectorContext): Promise<DetectorResult>;
+}

package/dist/guardrails/advancedDetectors.js

@@ -1,5 +1,5 @@
-// SCALE Engine — 危险命令检测 + Role 权限网关
-// W5 补充检测器
+// SCALE Engine — 危险命令检测 + Role 权限网关 + ScopeCreep 检测
+// W5 补充检测器 + 9th detector
 // 设计参考：docs/01-ARCHITECTURE.md §二 L2
 // ============================================================================
 // 6. 危险命令检测器
@@ -135,4 +135,52 @@ export class RoleGateDetector {
         return { triggered: false };
     }
 }
+// ============================================================================
+// 9. ScopeCreep 检测器
+// ============================================================================
+export class ScopeCreepDetector {
+    name = 'scope-creep';
+    /** Max distinct files allowed per session before warning */
+    maxFiles;
+    /** Window in ms to track file edits */
+    windowMs;
+    constructor(opts = {}) {
+        this.maxFiles = opts.maxFiles ?? 15;
+        this.windowMs = opts.windowMs ?? 10 * 60 * 1000; // 10 minutes
+    }
+    async check(input, ctx) {
+        if (!['Edit', 'Write', 'MultiEdit'].includes(input.tool))
+            return { triggered: false };
+        const file = input.args.file_path;
+        if (!file)
+            return { triggered: false };
+        const key = `scope-creep:${input.sessionId}`;
+        const record = ctx.cache.get(key)
+            ?? { files: new Set(), timestamps: [] };
+        const now = Date.now();
+        // Prune old timestamps outside window
+        record.timestamps = record.timestamps.filter((t) => now - t < this.windowMs);
+        // Track new file
+        const isNew = !record.files.has(file);
+        record.files.add(file);
+        record.timestamps.push(now);
+        ctx.cache.set(key, record);
+        // Only warn when a NEW file is added and we exceed the threshold
+        if (isNew && record.files.size > this.maxFiles) {
+            ctx.eventBus.emit('tool.blocked', {
+                tool: input.tool,
+                detector: this.name,
+                reason: `scope_creep:${record.files.size}_files`,
+                file,
+            }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'warn',
+                reason: `⚠️ 检测到「范围蔓延」：本会话已编辑 ${record.files.size} 个不同文件（阈值 ${this.maxFiles}）。请确认这些修改都在当前任务范围内，而非越界修改。`,
+                suggestion: '请检查是否偏离了原始任务范围。考虑收窄修改范围或拆分为多个任务。',
+            };
+        }
+        return { triggered: false };
+    }
+}
 //# sourceMappingURL=advancedDetectors.js.map