yuangs 2.28.0 → 2.30.0

package/README.md

@@ -634,6 +634,296 @@ Then `yuangs` is for you.
 
 ## Status
 
+`yuangs` is actively evolving.  
+The core governance model is stable; interfaces are still sharpening.
+
+Contributions, ideas, and principled criticism are welcome.
+
+> **"AI should never appear smarter than input unless explicitly asked."**
+
+---
+
+# Phase 2: Explainability & Governance (v1)
+
+## 🎯 Overview
+
+Phase 2 introduces **system observability and control** without changing core behavior:
+- ✅ Explainability: Human-readable execution explanations
+- ✅ Replay++: Dry-run, explain, and diff capabilities
+- ✅ Skill Control: Enable/disable skills for fine-grained control
+
+---
+
+## 📦 New Commands
+
+### `yuangs explain [id | last]`
+
+**Purpose**: Explain why the system made a decision
+
+**Usage**:
+```bash
+# Explain the most recent execution
+yuangs explain last
+
+# Explain a specific execution by ID
+yuangs explain exec_1768820380225_rgts34981
+```
+
+**Output Format (v1)**:
+```
+=== Execution Explanation ===
+[1] Command
+- Name: ai-command
+- Args: echo "hello"
+
+[2] Decision
+- Strategy: capability-match
+- Selected Model: gemini-2.5-flash-lite
+- Reason: Capability-based selection with fallback support
+
+[3] Model
+- Name: gemini-2.5-flash-lite
+- Provider: aiproxy
+- Context Window: 8000
+- Cost Profile: low
+
+[4] Skills
+- (none)
+
+[5] Meta
+- Execution ID: exec_1768820380225_rgts34981
+- Timestamp: 2026-01-19T10:59:40.225Z
+- Replayable: true
+- Version: unknown
+=============================
+```
+
+**Key Features**:
+- ✅ Pure read-only operation (no side effects)
+- ✅ Stable, snapshot-able output
+- ✅ Future-proof for diff/audit workflows
+
+---
+
+### `yuangs replay <id> [options]`
+
+**Purpose**: Replay an execution with control flags
+
+**Options**:
+| Option | Description |
+|--------|-------------|
+| `-s, --strict` | Strict replay (use exact model) |
+| `-c, --compatible` | Compatible replay (allow fallback) |
+| `-r, --re-evaluate` | Re-evaluate with current config |
+| `-v, --verbose` | Verbose output |
+| `--dry` | Dry run - show what would happen without executing |
+| `--explain` | Show explanation before replay |
+| `--diff` | Show diff between original and current config |
+
+**Usage Examples**:
+```bash
+# Dry run with explanation
+yuangs replay exec_1768820380225_rgts34981 --dry --explain
+
+# Show diff only (no execution)
+yuangs replay exec_1768820380225_rgts34981 --diff --dry
+
+# Full replay with diff
+yuangs replay exec_1768820380225_rgts34981 --diff
+```
+
+**Replay Behavior Matrix**:
+| explain | dry | strict | Behavior |
+|--------|-----|--------|----------|
+| ✅ | ✅ | any | Explain only, no execution |
+| ✅ | ❌ | ✅ | Explain → Replay |
+| ❌ | ✅ | ✅ | Print strict info → Exit |
+| ❌ | ❌ | ✅ | Normal replay |
+
+**Diff Output**:
+```
+=== Replay Diff ===
+[Decision]
+- no change
+
+[Model]
+- no change
+
+[Skills]
+- no change
+===================
+```
+
+---
+
+### `yuangs skills <subcommand>`
+
+**Purpose**: Manage skill library
+
+**Subcommands**:
+```bash
+# List all skills with scores
+yuangs skills list
+
+# Explain a specific skill
+yuangs skills explain <skill-name>
+
+# Disable a skill
+yuangs skills disable <skill-name>
+
+# Enable a skill
+yuangs skills enable <skill-name>
+```
+
+**Output Example** (`skills list`):
+```
+📦 Skills (3)
+
+✔ deploy-production
+  Confidence: 72%
+  Success: 8 / Failure: 1
+  Last used: 2 days ago
+
+✔ cleanup-logs
+  Confidence: 41%
+  Success: 5 / Failure: 7
+  Last used: 1 day ago
+
+⊘ legacy-search (disabled)
+  Confidence: 23%
+  Success: 2 / Failure: 6
+  Last used: 7 days ago
+```
+
+**Key Features**:
+- ✅ Skills can be disabled without deletion
+- ✅ Skills are scored and sorted by relevance
+- ✅ Disabled skills don't affect new decisions
+- ✅ All skills remain visible in `explain` output
+
+---
+
+## 🧭 Explain Output Spec v1
+
+The explain output follows a strict format designed for:
+- ✅ Human readability
+- ✅ Stability and snapshot compatibility
+- ✅ Future diff/audit workflows
+- ✅ No implementation coupling
+
+**Structure** (5 sections, immutable order):
+1. `[1] Command` - User input layer
+2. `[2] Decision` - Decision-making core
+3. `[3] Model` - Execution environment
+4. `[4] Skills` - Skills that influenced decision
+5. `[5] Meta` - Audit/replay metadata
+
+**Important Notes**:
+- ⚠️ Do NOT change format without bumping spec version
+- ✅ Output is pure text (no color for snapshots)
+- ✅ Same execution record = 100% reproducible output
+
+---
+
+## 🔒 Skills & Enabled State
+
+Skills now have an `enabled` field that controls their participation in new decisions:
+
+**Default Behavior**:
+- ✅ New skills: `enabled: true`
+- ✅ Legacy skills: `enabled: true` (if field missing)
+- ❌ Disabled skills: Not included in `getRelevantSkills()`
+
+**Use Cases**:
+1. **Governance**: Temporarily disable risky skills
+2. **A/B Testing**: Compare different skill configurations
+3. **Rollback**: Disable a newly-added skill without deletion
+4. **Audit**: View disabled skills in explain output
+
+**CLI Commands**:
+```bash
+# Disable a skill
+yuangs skills disable risky-operation
+
+# List to verify
+yuangs skills list
+
+# Re-enable if needed
+yuangs skills enable risky-operation
+```
+
+---
+
+## 🧪 Testing & Snapshots
+
+### Creating Explain Snapshots
+
+```bash
+# Create a snapshot of the last execution
+yuangs replay exec_1768820380225_rgts34981 --explain --dry > snapshot.txt
+```
+
+Snapshots are useful for:
+- ✅ Regression testing
+- ✅ Output format verification
+- ✅ Documentation examples
+- ✅ Audit trails
+
+---
+
+## 📝 Implementation Notes
+
+### Explain Output v1
+
+**File**: `src/core/explain.ts`
+
+**Key Design**:
+- Pure function (no side effects)
+- No external dependencies on global state
+- Uses existing `ExecutionRecord` structure
+- Stable formatting (versioned)
+
+---
+
+### Replay Diff
+
+**File**: `src/core/replayDiff.ts`
+
+**Key Design**:
+- Compares Decision, Model, and Skills layers
+- Shows added/removed/changed skills
+- Semantic diff (not token-level)
+- Compatible with Explain v1 format
+
+---
+
+### Skills Control
+
+**File**: `src/agent/skills.ts`
+
+**Key Changes**:
+- Added `enabled: boolean` field to `Skill` interface
+- Exported `computeSkillScore()` for CLI usage
+- `getRelevantSkills()` filters disabled skills
+
+---
+
+## ✅ Phase 2 Completion
+
+All Phase 2 objectives are complete:
+
+- [x] Explainability (ExecutionRecord-level)
+- [x] Replay dry / explain / strict
+- [x] Skill scoring & enable flag
+- [x] CLI wiring for all three
+- [x] Replay diff implementation
+- [x] Skills enabled filtering
+- [x] Explain v1 specification
+- [x] Snapshot testing capability
+
+**Next Phase**: Phase 3 - Advanced governance & project-level intelligence
+
+
 `yuangs` is actively evolving.  
 The core governance model is stable; interfaces are still sharpening.
 

package/dist/agent/contextManager.d.ts

@@ -0,0 +1,30 @@
+import { GovernanceContext } from './state';
+export declare class ContextManager {
+    private messages;
+    private maxHistorySize;
+    constructor(initialContext?: GovernanceContext);
+    addMessage(role: string, content: string): void;
+    addToolResult(toolName: string, result: string): void;
+    addObservation(observation: string): void;
+    getMessages(): Array<{
+        role: 'system' | 'user' | 'assistant' | 'tool';
+        content: string;
+    }>;
+    getRecentMessages(count: number): Array<{
+        role: string;
+        content: string;
+        timestamp: number;
+    }>;
+    getHash(): string;
+    getSnapshot(): {
+        inputHash: string;
+        systemPromptVersion: string;
+        toolSetVersion: string;
+        recentMessages: {
+            role: string;
+            content: string;
+            timestamp: number;
+        }[];
+    };
+    clear(): void;
+}

package/dist/agent/contextManager.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextManager = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+class ContextManager {
+    messages = [];
+    maxHistorySize = 50;
+    constructor(initialContext) {
+        if (initialContext?.history) {
+            this.messages = initialContext.history.map(msg => ({
+                ...msg,
+                timestamp: Date.now()
+            }));
+        }
+        if (initialContext?.input) {
+            this.addMessage('user', initialContext.input);
+        }
+    }
+    addMessage(role, content) {
+        this.messages.push({
+            role,
+            content,
+            timestamp: Date.now()
+        });
+        if (this.messages.length > this.maxHistorySize) {
+            this.messages = this.messages.slice(-this.maxHistorySize);
+        }
+    }
+    addToolResult(toolName, result) {
+        const content = `Tool ${toolName} returned:\n${result}`;
+        this.addMessage('tool', content);
+    }
+    addObservation(observation) {
+        this.addMessage('system', observation);
+    }
+    getMessages() {
+        return this.messages.map(({ role, content }) => ({
+            role: role,
+            content
+        }));
+    }
+    getRecentMessages(count) {
+        return this.messages.slice(-count);
+    }
+    getHash() {
+        const content = JSON.stringify(this.messages);
+        return crypto_1.default.createHash('sha256').update(content).digest('hex');
+    }
+    getSnapshot() {
+        return {
+            inputHash: this.getHash(),
+            systemPromptVersion: 'v1.0.0',
+            toolSetVersion: 'v1.0.0',
+            recentMessages: this.getRecentMessages(10)
+        };
+    }
+    clear() {
+        this.messages = [];
+    }
+}
+exports.ContextManager = ContextManager;
+//# sourceMappingURL=contextManager.js.map

package/dist/agent/contextManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextManager.js","sourceRoot":"","sources":["../../src/agent/contextManager.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAG5B,MAAa,cAAc;IACjB,QAAQ,GAAgE,EAAE,CAAC;IAC3E,cAAc,GAAG,EAAE,CAAC;IAE5B,YAAY,cAAkC;QAC5C,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACjD,GAAG,GAAG;gBACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC,CAAC;QACN,CAAC;QAED,IAAI,cAAc,EAAE,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,OAAe;QACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjB,IAAI;YACJ,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,aAAa,CAAC,QAAgB,EAAE,MAAc;QAC5C,MAAM,OAAO,GAAG,QAAQ,QAAQ,eAAe,MAAM,EAAE,CAAC;QACxD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,cAAc,CAAC,WAAmB;QAChC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,EAAE,IAAgD;YACtD,OAAO;SACR,CAAC,CAAC,CAAC;IACN,CAAC;IAED,iBAAiB,CAAC,KAAa;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,OAAO;QACL,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,OAAO,gBAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAED,WAAW;QACT,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE;YACzB,mBAAmB,EAAE,QAAQ;YAC7B,cAAc,EAAE,QAAQ;YACxB,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;CACF;AAlED,wCAkEC"}

package/dist/agent/executor.d.ts

@@ -0,0 +1,11 @@
+import { ProposedAction, ToolExecutionResult } from './state';
+export declare class ToolExecutor {
+    static execute(action: ProposedAction): Promise<ToolExecutionResult>;
+    private static executeTool;
+    private static toolReadFile;
+    private static toolWriteFile;
+    private static toolListFiles;
+    private static getFiles;
+    private static executeShell;
+    private static executeDiff;
+}

package/dist/agent/executor.js

@@ -0,0 +1,191 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolExecutor = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+class ToolExecutor {
+    static async execute(action) {
+        const { type, payload } = action;
+        try {
+            switch (type) {
+                case 'tool_call':
+                    return await this.executeTool(payload);
+                case 'shell_cmd':
+                    return await this.executeShell(payload.command);
+                case 'code_diff':
+                    return await this.executeDiff(payload.diff);
+                case 'answer':
+                    return {
+                        success: true,
+                        output: payload.content || '',
+                        artifacts: []
+                    };
+                default:
+                    return {
+                        success: false,
+                        error: `Unknown action type: ${type}`,
+                        output: ''
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message || String(error),
+                output: ''
+            };
+        }
+    }
+    static async executeTool(payload) {
+        const toolName = payload.tool_name;
+        switch (toolName) {
+            case 'read_file':
+                return await this.toolReadFile(payload.parameters);
+            case 'write_file':
+                return await this.toolWriteFile(payload.parameters);
+            case 'list_files':
+                return await this.toolListFiles(payload.parameters);
+            case 'web_search':
+                return {
+                    success: false,
+                    error: 'web_search not implemented yet',
+                    output: ''
+                };
+            default:
+                return {
+                    success: false,
+                    error: `Unknown tool: ${toolName}`,
+                    output: ''
+                };
+        }
+    }
+    static async toolReadFile(params) {
+        const filePath = params.path;
+        try {
+            const content = await promises_1.default.readFile(filePath, 'utf-8');
+            return {
+                success: true,
+                output: content,
+                artifacts: [filePath]
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                output: ''
+            };
+        }
+    }
+    static async toolWriteFile(params) {
+        const filePath = params.path;
+        const content = params.content;
+        try {
+            await promises_1.default.mkdir(path_1.default.dirname(filePath), { recursive: true });
+            await promises_1.default.writeFile(filePath, content, 'utf-8');
+            return {
+                success: true,
+                output: `Successfully wrote ${filePath}`,
+                artifacts: [filePath]
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                output: ''
+            };
+        }
+    }
+    static async toolListFiles(params) {
+        const dirPath = params.path || '.';
+        const recursive = params.recursive || false;
+        try {
+            const files = await this.getFiles(dirPath, recursive);
+            return {
+                success: true,
+                output: JSON.stringify(files, null, 2),
+                artifacts: files.map(f => f.path)
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                output: ''
+            };
+        }
+    }
+    static async getFiles(dir, recursive) {
+        const entries = await promises_1.default.readdir(dir, { withFileTypes: true });
+        const files = [];
+        for (const entry of entries) {
+            const fullPath = path_1.default.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                files.push({ path: fullPath, type: 'directory' });
+                if (recursive) {
+                    const subFiles = await this.getFiles(fullPath, recursive);
+                    files.push(...subFiles);
+                }
+            }
+            else {
+                files.push({ path: fullPath, type: 'file' });
+            }
+        }
+        return files;
+    }
+    static async executeShell(command) {
+        try {
+            const { stdout, stderr } = await execAsync(command, {
+                maxBuffer: 10 * 1024 * 1024,
+                cwd: process.cwd()
+            });
+            const output = stdout || stderr || '';
+            return {
+                success: true,
+                output,
+                artifacts: []
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                output: error.stdout || error.stderr || ''
+            };
+        }
+    }
+    static async executeDiff(diff) {
+        try {
+            const tempFile = path_1.default.join(process.cwd(), '.yuangs_temp.patch');
+            await promises_1.default.writeFile(tempFile, diff, 'utf-8');
+            const { stdout, stderr } = await execAsync(`git apply --check ${tempFile}`, {
+                cwd: process.cwd()
+            });
+            const { stdout: applyOutput } = await execAsync(`git apply ${tempFile}`, {
+                cwd: process.cwd()
+            });
+            await promises_1.default.unlink(tempFile);
+            return {
+                success: true,
+                output: applyOutput || 'Diff applied successfully',
+                artifacts: ['.yuangs_temp.patch']
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                output: error.stdout || error.stderr || 'Failed to apply diff'
+            };
+        }
+    }
+}
+exports.ToolExecutor = ToolExecutor;
+//# sourceMappingURL=executor.js.map

package/dist/agent/executor.js.map

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

package/dist/agent/fsm.d.ts

@@ -0,0 +1,23 @@
+import { AgentState } from './state';
+export declare class GovernanceFSM {
+    private _state;
+    private _history;
+    private _transitionLog;
+    get current(): AgentState;
+    get history(): AgentState[];
+    get transitionLog(): Array<{
+        from: AgentState;
+        to: AgentState;
+        timestamp: number;
+        payload?: any;
+    }>;
+    transitionTo(target: AgentState, payload?: any): void;
+    private canTransition;
+    isTerminal(): boolean;
+    reset(): void;
+    getStateInfo(): {
+        current: AgentState;
+        history: AgentState[];
+        transitionCount: number;
+    };
+}