yuangs 3.21.0 → 3.22.0

package/dist/agent/replay.d.ts

@@ -1,2 +0,0 @@
-import { ExecutionRecord } from './record';
-export declare function replay(record: ExecutionRecord): Promise<import("./plan").AgentPlan>;

package/dist/agent/replay.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.replay = replay;
-const llm_1 = require("./llm");
-const interpret_1 = require("./interpret");
-async function replay(record) {
-    console.log(`\nReplaying execution: ${record.id}`);
-    console.log(`Original timestamp: ${new Date(record.timestamp).toISOString()}`);
-    console.log(`Mode: ${record.mode}\n`);
-    const result = await (0, llm_1.runLLM)({
-        prompt: record.prompt,
-        model: record.model,
-        stream: record.mode === 'chat',
-        onChunk: record.mode === 'chat'
-            ? (s) => process.stdout.write(s)
-            : undefined,
-    });
-    // Create a minimal intent for interpretation
-    const intent = {
-        type: record.mode === 'chat' ? 'chat' : 'shell',
-        capabilities: {},
-    };
-    return (0, interpret_1.interpretResultToPlan)(result, intent, record.mode);
-}
-//# sourceMappingURL=replay.js.map

package/dist/commands/chatHistoryStorage.d.ts

@@ -1,4 +0,0 @@
-import { AIRequestMessage } from '../core/validation';
-export declare function loadChatHistory(): Promise<AIRequestMessage[]>;
-export declare function saveChatHistory(history: AIRequestMessage[]): Promise<void>;
-export declare function clearChatHistory(): Promise<void>;

package/dist/commands/chatHistoryStorage.js

@@ -1,54 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadChatHistory = loadChatHistory;
-exports.saveChatHistory = saveChatHistory;
-exports.clearChatHistory = clearChatHistory;
-const fs_1 = __importDefault(require("fs"));
-const util_1 = require("util");
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-const CHAT_HISTORY_DIR = path_1.default.resolve(os_1.default.homedir(), '.yuangs_chat_history');
-const CHAT_HISTORY_FILE = path_1.default.join(CHAT_HISTORY_DIR, 'chat_history.json');
-const readFileAsync = (0, util_1.promisify)(fs_1.default.readFile);
-const writeFileAsync = (0, util_1.promisify)(fs_1.default.writeFile);
-const mkdirAsync = (0, util_1.promisify)(fs_1.default.mkdir);
-const rmAsync = (0, util_1.promisify)(fs_1.default.rm);
-async function loadChatHistory() {
-    if (fs_1.default.existsSync(CHAT_HISTORY_FILE)) {
-        try {
-            const raw = await readFileAsync(CHAT_HISTORY_FILE, 'utf-8');
-            const data = JSON.parse(raw);
-            // 验证数据结构
-            if (Array.isArray(data) && data.every(msg => typeof msg === 'object' &&
-                ['user', 'assistant', 'system'].includes(msg.role) &&
-                typeof msg.content === 'string')) {
-                return data;
-            }
-        }
-        catch (e) {
-            console.warn('警告: 加载聊天历史记录失败，使用空历史记录');
-        }
-    }
-    return [];
-}
-async function saveChatHistory(history) {
-    try {
-        await mkdirAsync(CHAT_HISTORY_DIR, { recursive: true });
-        await writeFileAsync(CHAT_HISTORY_FILE, JSON.stringify(history, null, 2));
-    }
-    catch (e) {
-        console.error('错误: 保存聊天历史记录失败:', e);
-    }
-}
-async function clearChatHistory() {
-    try {
-        await rmAsync(CHAT_HISTORY_FILE, { force: true });
-    }
-    catch (e) {
-        console.error('错误: 清除聊天历史记录失败:', e);
-    }
-}
-//# sourceMappingURL=chatHistoryStorage.js.map

package/dist/governance/GovernanceEngine.d.ts

@@ -1,20 +0,0 @@
-import { GovernedAction, ExecutionContext, ApprovalSource } from "./GovernedAction";
-/**
- * Governance engine - single point of control for all governed actions
- * Enforces "No Diff Without Review. No Execution Without Approval."
- */
-export declare class GovernanceEngine {
-    private actions;
-    private revokedActions;
-    register(action: GovernedAction): void;
-    getAction(id: string): GovernedAction | undefined;
-    listActions(): GovernedAction[];
-    requestApproval(id: string): void;
-    approve(id: string, by: ApprovalSource): void;
-    reject(id: string, reason: string): void;
-    execute(id: string, ctx: ExecutionContext): Promise<void>;
-    observe(id: string): Promise<void>;
-    verify(id: string, obs: any): boolean;
-    revoke(id: string): void;
-    has(id: string): boolean;
-}

package/dist/governance/GovernanceEngine.js

@@ -1,95 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GovernanceEngine = void 0;
-/**
- * Governance engine - single point of control for all governed actions
- * Enforces "No Diff Without Review. No Execution Without Approval."
- */
-class GovernanceEngine {
-    actions = new Map();
-    revokedActions = new Set();
-    register(action) {
-        if (this.revokedActions.has(action.id)) {
-            throw new Error(`Governance violation: action ${action.id} was revoked`);
-        }
-        this.actions.set(action.id, action);
-    }
-    getAction(id) {
-        return this.actions.get(id);
-    }
-    listActions() {
-        return Array.from(this.actions.values());
-    }
-    requestApproval(id) {
-        const action = this.actions.get(id);
-        if (!action) {
-            throw new Error(`Action not found: ${id}`);
-        }
-        action.propose();
-        console.log(`[PROPOSED] ${action.kind}:${id}`);
-        console.log(`Rationale: ${action.rationale}`);
-    }
-    approve(id, by) {
-        const action = this.actions.get(id);
-        if (!action) {
-            throw new Error(`Action not found: ${id}`);
-        }
-        if (by !== "human") {
-            throw new Error(`Governance violation: only human can approve`);
-        }
-        action.approve(by);
-        console.log(`[APPROVED] ${action.kind}:${id} by ${by}`);
-    }
-    reject(id, reason) {
-        const action = this.actions.get(id);
-        if (!action) {
-            throw new Error(`Action not found: ${id}`);
-        }
-        action.reject(reason);
-        console.log(`[REJECTED] ${action.kind}:${id}`);
-        console.log(`Reason: ${reason}`);
-    }
-    async execute(id, ctx) {
-        const action = this.actions.get(id);
-        if (!action) {
-            throw new Error(`Action not found: ${id}`);
-        }
-        if (action.state !== "APPROVED") {
-            throw new Error(`Governance violation: execute() called on ${action.kind}:${id} in state ${action.state}, must be APPROVED`);
-        }
-        const result = await action.execute(ctx);
-        if (!result.ok) {
-            throw new Error(`Execution failed: ${result.error || "unknown error"}`);
-        }
-        console.log(`[EXECUTED] ${action.kind}:${id}`);
-    }
-    async observe(id) {
-        const action = this.actions.get(id);
-        if (!action) {
-            throw new Error(`Action not found: ${id}`);
-        }
-        const obs = await action.observe();
-        console.log(`[OBSERVED] ${action.kind}:${id}`);
-        console.log(`Files changed: ${obs.changedFiles.length}`);
-    }
-    verify(id, obs) {
-        const action = this.actions.get(id);
-        if (!action) {
-            throw new Error(`Action not found: ${id}`);
-        }
-        const verified = action.verify(obs);
-        if (verified) {
-            console.log(`[VERIFIED] ${action.kind}:${id}`);
-        }
-        return verified;
-    }
-    revoke(id) {
-        this.actions.delete(id);
-        this.revokedActions.add(id);
-    }
-    has(id) {
-        return this.actions.has(id) && !this.revokedActions.has(id);
-    }
-}
-exports.GovernanceEngine = GovernanceEngine;
-//# sourceMappingURL=GovernanceEngine.js.map

package/dist/governance/GovernedAction.d.ts

@@ -1,107 +0,0 @@
-/**
- * Core Governance Types and Interfaces
- *
- * This module defines the foundational types for the Code Change Governance System.
- * All actions must implement GovernedAction and follow strict state transitions.
- */
-/**
- * Valid governance states for any action
- * No action can skip states or bypass approval
- */
-export type GovernanceState = "DRAFT" | "PROPOSED" | "APPROVED" | "EXECUTED" | "OBSERVED" | "VERIFIED" | "REJECTED";
-/**
- * Approval can only come from humans - no auto-approval
- */
-export type ApprovalSource = "human";
-/**
- * Provenance tracking for reproducibility and audit
- */
-export interface ActionProvenance {
-    /** The agent that created this action */
-    agentId: string;
-    /** Hash of the plan that generated this action */
-    planHash: string;
-    /** Parent action if this is a fix/repair attempt */
-    parentAction?: string;
-    /** When this action was created */
-    createdAt: number;
-}
-/**
- * Execution context for running actions
- */
-export interface ExecutionContext {
-    executor: ActionExecutor;
-    snapshot?: string;
-}
-/**
- * Result from executing an action
- */
-export interface ExecutionResult {
-    ok: boolean;
-    error?: string;
-    executedAt?: number;
-    snapshotAfter?: string;
-}
-/**
- * Observation data after execution
- */
-export interface Observation {
-    gitDiff: string;
-    changedFiles: string[];
-    executionTime: number;
-}
-/**
- * Action executor interface (filesystem operations)
- * This is the ONLY place where filesystem changes can happen
- */
-export interface ActionExecutor {
-    applyDiff(diff: string): Promise<void>;
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    deleteFile(path: string): Promise<void>;
-}
-/**
- * Core interface that ALL governed actions must implement
- * This enforces the constitutional constraints
- */
-export interface GovernedAction<Payload = unknown> {
-    /** Unique identifier for this action */
-    readonly id: string;
-    /** Type/kind of action (code_change, run_command, etc.) */
-    readonly kind: string;
-    /** The actual payload that will be executed */
-    readonly payload: Payload;
-    /** Current state of this action */
-    state: GovernanceState;
-    /** Why this action is being proposed (must be human-readable) */
-    readonly rationale: string;
-    /** Who created this action and when */
-    readonly provenance: ActionProvenance;
-    /** When was the state last updated */
-    updatedAt: number;
-    /** Transition from DRAFT to PROPOSED */
-    propose(): void;
-    /** Transition from PROPOSED to APPROVED (only human can approve) */
-    approve(by: ApprovalSource): void;
-    /** Transition from any state to REJECTED */
-    reject(reason: string): void;
-    /** Execute the action (only possible if APPROVED) */
-    execute(ctx: ExecutionContext): Promise<ExecutionResult>;
-    /** Observe the results of execution (only possible if EXECUTED) */
-    observe(): Promise<Observation>;
-    /** Verify the observation (only possible if OBSERVED) */
-    verify(obs: Observation): boolean;
-    /** Get a summary of this action for display */
-    summarize(): ActionSummary;
-}
-/**
- * Human-readable summary of an action
- */
-export interface ActionSummary {
-    id: string;
-    kind: string;
-    state: GovernanceState;
-    rationale: string;
-    filesAffected?: string[];
-    changeSize?: number;
-}

package/dist/governance/GovernedAction.js

@@ -1,9 +0,0 @@
-"use strict";
-/**
- * Core Governance Types and Interfaces
- *
- * This module defines the foundational types for the Code Change Governance System.
- * All actions must implement GovernedAction and follow strict state transitions.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=GovernedAction.js.map

package/dist/governance/actions/CodeChangeAction.d.ts

@@ -1,28 +0,0 @@
-import { GovernedAction, GovernanceState, ExecutionContext, ExecutionResult, Observation, ActionSummary, ApprovalSource, ActionProvenance } from "../GovernedAction";
-/**
- * Payload for code change actions
- * Contains unified diff and affected files
- */
-export interface CodeChangePayload {
-    files: string[];
-    diff: string;
-}
-export declare class CodeChangeAction implements GovernedAction<CodeChangePayload> {
-    readonly id: string;
-    readonly payload: CodeChangePayload;
-    readonly rationale: string;
-    readonly provenance: ActionProvenance;
-    readonly kind = "code_change";
-    state: GovernanceState;
-    updatedAt: number;
-    constructor(id: string, payload: CodeChangePayload, rationale: string, provenance: ActionProvenance);
-    propose(): void;
-    approve(by: ApprovalSource): void;
-    reject(reason: string): void;
-    execute(ctx: ExecutionContext): Promise<ExecutionResult>;
-    observe(): Promise<Observation>;
-    verify(obs: Observation): boolean;
-    summarize(): ActionSummary;
-    private calculateChangeSize;
-    static create(payload: CodeChangePayload, rationale: string, agentId: string, planHash: string, parentAction?: string): CodeChangeAction;
-}

package/dist/governance/actions/CodeChangeAction.js

@@ -1,139 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CodeChangeAction = void 0;
-const crypto_1 = __importDefault(require("crypto"));
-class CodeChangeAction {
-    id;
-    payload;
-    rationale;
-    provenance;
-    kind = "code_change";
-    state = "DRAFT";
-    updatedAt = Date.now();
-    constructor(id, payload, rationale, provenance) {
-        this.id = id;
-        this.payload = payload;
-        this.rationale = rationale;
-        this.provenance = provenance;
-        this.updatedAt = provenance.createdAt;
-    }
-    propose() {
-        if (this.state !== "DRAFT") {
-            throw new Error(`Governance violation: propose() called from ${this.state}, must be DRAFT`);
-        }
-        this.state = "PROPOSED";
-        this.updatedAt = Date.now();
-    }
-    approve(by) {
-        if (this.state !== "PROPOSED") {
-            throw new Error(`Governance violation: approve() called from ${this.state}, must be PROPOSED`);
-        }
-        if (by !== "human") {
-            throw new Error(`Governance violation: only human can approve, got ${by}`);
-        }
-        this.state = "APPROVED";
-        this.updatedAt = Date.now();
-    }
-    reject(reason) {
-        if (this.state === "REJECTED") {
-            throw new Error(`Governance violation: reject() called from ${this.state}, already rejected`);
-        }
-        this.state = "REJECTED";
-        this.updatedAt = Date.now();
-    }
-    async execute(ctx) {
-        if (this.state !== "APPROVED") {
-            throw new Error(`Governance violation: execute() called from ${this.state}, must be APPROVED`);
-        }
-        const startTime = Date.now();
-        try {
-            await ctx.executor.applyDiff(this.payload.diff);
-            this.state = "EXECUTED";
-            this.updatedAt = Date.now();
-            return {
-                ok: true,
-                executedAt: Date.now(),
-                snapshotAfter: ctx.snapshot,
-            };
-        }
-        catch (error) {
-            this.state = "REJECTED";
-            this.updatedAt = Date.now();
-            return {
-                ok: false,
-                error: error instanceof Error ? error.message : String(error),
-            };
-        }
-    }
-    async observe() {
-        if (this.state !== "EXECUTED") {
-            throw new Error(`Governance violation: observe() called from ${this.state}, must be EXECUTED`);
-        }
-        const { execSync } = require("child_process");
-        const changedFiles = execSync("git diff --name-only", {
-            encoding: "utf-8",
-        })
-            .trim()
-            .split("\n")
-            .filter((f) => f);
-        const gitDiff = execSync("git diff", { encoding: "utf-8" });
-        this.state = "OBSERVED";
-        this.updatedAt = Date.now();
-        return {
-            gitDiff,
-            changedFiles,
-            executionTime: Date.now(),
-        };
-    }
-    verify(obs) {
-        if (this.state !== "OBSERVED") {
-            throw new Error(`Governance violation: verify() called from ${this.state}, must be OBSERVED`);
-        }
-        const changedFiles = new Set(obs.changedFiles);
-        const declaredFiles = new Set(this.payload.files);
-        const extraFiles = obs.changedFiles.filter((f) => !declaredFiles.has(f));
-        if (extraFiles.length > 0) {
-            throw new Error(`Governance violation: execution modified undeclared files: ${extraFiles.join(", ")}`);
-        }
-        this.state = "VERIFIED";
-        this.updatedAt = Date.now();
-        return true;
-    }
-    summarize() {
-        const changeSize = this.calculateChangeSize();
-        return {
-            id: this.id,
-            kind: this.kind,
-            state: this.state,
-            rationale: this.rationale,
-            filesAffected: this.payload.files,
-            changeSize,
-        };
-    }
-    calculateChangeSize() {
-        let additions = 0;
-        let deletions = 0;
-        for (const line of this.payload.diff.split("\n")) {
-            if (line.startsWith("+") && !line.startsWith("+++"))
-                additions++;
-            if (line.startsWith("-") && !line.startsWith("---"))
-                deletions++;
-        }
-        return additions + deletions;
-    }
-    static create(payload, rationale, agentId, planHash, parentAction) {
-        const id = crypto_1.default.randomUUID();
-        const provenance = {
-            agentId,
-            planHash,
-            parentAction,
-            createdAt: Date.now(),
-        };
-        return new CodeChangeAction(id, payload, rationale, provenance);
-    }
-}
-exports.CodeChangeAction = CodeChangeAction;
-//# sourceMappingURL=CodeChangeAction.js.map

package/dist/governance/capability/token.d.ts

@@ -1,45 +0,0 @@
-export type Right = {
-    type: "APPLY_DIFF";
-} | {
-    type: "READ_FILE";
-    path: string;
-} | {
-    type: "EXECUTE_ACTION";
-    actionId: string;
-};
-export type Scope = {
-    type: "ACTION";
-    id: string;
-} | {
-    type: "PATH_PREFIX";
-    prefix: string;
-} | {
-    type: "REPO";
-};
-export interface Capability {
-    id: string;
-    subject: string;
-    rights: Right[];
-    scope: Scope;
-    issuedAt: number;
-    expiresAt: number;
-    maxUses: number;
-    used: number;
-    signature: string;
-}
-export declare function sign(data: string): string;
-export declare function verify(cap: Capability): boolean;
-export declare function issue(input: {
-    subject: string;
-    rights: Right[];
-    scope: Scope;
-    ttlMs: number;
-    maxUses?: number;
-}): Capability;
-export declare function checkCapability(cap: Capability, want: Right, context: {
-    actionId?: string;
-    path?: string;
-}): void;
-export declare function attenuate(cap: Capability, limits: Partial<Pick<Capability, "expiresAt" | "maxUses">>): Capability;
-export declare function revoke(capId: string): void;
-export declare function checkRevoked(cap: Capability): void;

package/dist/governance/capability/token.js

@@ -1,103 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sign = sign;
-exports.verify = verify;
-exports.issue = issue;
-exports.checkCapability = checkCapability;
-exports.attenuate = attenuate;
-exports.revoke = revoke;
-exports.checkRevoked = checkRevoked;
-const crypto_1 = __importDefault(require("crypto"));
-const SECRET = process.env.CAP_SECRET || "default-secret-change-in-production";
-function sign(data) {
-    return crypto_1.default
-        .createHmac("sha256", SECRET)
-        .update(data)
-        .digest("hex");
-}
-function verify(cap) {
-    const { signature, ...rest } = cap;
-    const payload = JSON.stringify(rest);
-    const computed = sign(payload);
-    return computed === signature;
-}
-function issue(input) {
-    const base = {
-        id: crypto_1.default.randomUUID(),
-        subject: input.subject,
-        rights: input.rights,
-        scope: input.scope,
-        issuedAt: Date.now(),
-        expiresAt: Date.now() + input.ttlMs,
-        maxUses: input.maxUses ?? 1,
-        used: 0,
-    };
-    const payload = JSON.stringify(base);
-    return {
-        ...base,
-        signature: sign(payload),
-    };
-}
-function checkCapability(cap, want, context) {
-    if (!verify(cap)) {
-        throw new Error("Invalid capability: signature verification failed");
-    }
-    if (Date.now() > cap.expiresAt) {
-        throw new Error("Capability expired");
-    }
-    if (cap.used >= cap.maxUses) {
-        throw new Error("Capability exhausted (max uses reached)");
-    }
-    const rightMatch = cap.rights.some((r) => JSON.stringify(r) === JSON.stringify(want));
-    if (!rightMatch) {
-        throw new Error(`Capability does not grant right: ${JSON.stringify(want)}`);
-    }
-    if (cap.scope.type === "ACTION" && context.actionId !== cap.scope.id) {
-        throw new Error(`Scope violation: capability scoped to action ${cap.scope.id}, used on ${context.actionId}`);
-    }
-    if (cap.scope.type === "PATH_PREFIX" &&
-        context.path &&
-        !context.path.startsWith(cap.scope.prefix)) {
-        throw new Error(`Scope violation: capability scoped to ${cap.scope.prefix}, used on ${context.path}`);
-    }
-    cap.used++;
-}
-function attenuate(cap, limits) {
-    if (!verify(cap)) {
-        throw new Error("Cannot attenuate invalid capability");
-    }
-    const reduced = {
-        ...cap,
-        expiresAt: Math.min(cap.expiresAt, limits.expiresAt ?? cap.expiresAt),
-        maxUses: Math.min(cap.maxUses, limits.maxUses ?? cap.maxUses),
-        used: 0,
-        signature: "",
-    };
-    const payload = JSON.stringify({
-        id: reduced.id,
-        subject: reduced.subject,
-        rights: reduced.rights,
-        scope: reduced.scope,
-        issuedAt: reduced.issuedAt,
-        expiresAt: reduced.expiresAt,
-        maxUses: reduced.maxUses,
-        used: 0,
-    });
-    return {
-        ...reduced,
-        signature: sign(payload),
-    };
-}
-const revokedCaps = new Set();
-function revoke(capId) {
-    revokedCaps.add(capId);
-}
-function checkRevoked(cap) {
-    if (revokedCaps.has(cap.id)) {
-        throw new Error(`Capability ${cap.id} has been revoked`);
-    }
-}
-//# sourceMappingURL=token.js.map

package/dist/governance/commands/diffEdit.d.ts

@@ -1,2 +0,0 @@
-import { Command } from "commander";
-export declare function createDiffEditCommand(): Command;