yuangs 2.30.0 → 2.32.0

package/dist/governance/fsm/stateMachine.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GovernanceStateMachine = void 0;
+exports.assertTransition = assertTransition;
+exports.canTransition = canTransition;
+exports.getNextStates = getNextStates;
+exports.isValidState = isValidState;
+/**
+ * Only these state transitions are legally permitted
+ * Any other transition is a governance violation
+ */
+const ALLOWED_TRANSITIONS = {
+    DRAFT: ["PROPOSED"],
+    PROPOSED: ["APPROVED", "REJECTED"],
+    APPROVED: ["EXECUTED"],
+    EXECUTED: ["OBSERVED"],
+    OBSERVED: ["VERIFIED"],
+    VERIFIED: [],
+    REJECTED: [],
+};
+/**
+ * Throw governance violation if transition is not permitted
+ */
+function assertTransition(from, to) {
+    const allowed = ALLOWED_TRANSITIONS[from].includes(to);
+    if (!allowed) {
+        throw new Error(`Governance violation: illegal state transition ${from} → ${to}`);
+    }
+}
+/**
+ * Check if a transition is valid (without throwing)
+ */
+function canTransition(from, to) {
+    return ALLOWED_TRANSITIONS[from].includes(to);
+}
+/**
+ * Get all possible next states from current state
+ */
+function getNextStates(from) {
+    return [...ALLOWED_TRANSITIONS[from]];
+}
+/**
+ * Validate that a state is valid
+ */
+function isValidState(state) {
+    return [
+        "DRAFT",
+        "PROPOSED",
+        "APPROVED",
+        "EXECUTED",
+        "OBSERVED",
+        "VERIFIED",
+        "REJECTED",
+    ].includes(state);
+}
+/**
+ * State machine for tracking governance state transitions
+ * Enforces constitutional invariants
+ */
+class GovernanceStateMachine {
+    currentState;
+    history = [];
+    constructor(initialState) {
+        if (!isValidState(initialState)) {
+            throw new Error(`Invalid initial state: ${initialState}`);
+        }
+        this.currentState = initialState;
+    }
+    get current() {
+        return this.currentState;
+    }
+    get transitionHistory() {
+        return [...this.history];
+    }
+    transition(to, reason) {
+        assertTransition(this.currentState, to);
+        this.history.push({
+            from: this.currentState,
+            to,
+            timestamp: Date.now(),
+            reason,
+        });
+        this.currentState = to;
+    }
+    isTerminal() {
+        return this.currentState === "VERIFIED" || this.currentState === "REJECTED";
+    }
+    canProceedTo(state) {
+        return canTransition(this.currentState, state);
+    }
+}
+exports.GovernanceStateMachine = GovernanceStateMachine;
+//# sourceMappingURL=stateMachine.js.map

package/dist/governance/fsm/stateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateMachine.js","sourceRoot":"","sources":["../../../src/governance/fsm/stateMachine.ts"],"names":[],"mappings":";;;AAmBA,4CAWC;AAKD,sCAKC;AAKD,sCAEC;AAKD,oCAUC;AA5DD;;;GAGG;AACH,MAAM,mBAAmB,GAA+C;IACtE,KAAK,EAAE,CAAC,UAAU,CAAC;IACnB,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF;;GAEG;AACH,SAAgB,gBAAgB,CAC9B,IAAqB,EACrB,EAAmB;IAEnB,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,kDAAkD,IAAI,MAAM,EAAE,EAAE,CACjE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAC3B,IAAqB,EACrB,EAAmB;IAEnB,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,IAAqB;IACjD,OAAO,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,OAAO;QACL,OAAO;QACP,UAAU;QACV,UAAU;QACV,UAAU;QACV,UAAU;QACV,UAAU;QACV,UAAU;KACX,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC;AAYD;;;GAGG;AACH,MAAa,sBAAsB;IACzB,YAAY,CAAkB;IAC9B,OAAO,GAA6B,EAAE,CAAC;IAE/C,YAAY,YAA6B;QACvC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,UAAU,CAAC,EAAmB,EAAE,MAAe;QAC7C,gBAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAExC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,IAAI,CAAC,YAAY;YACvB,EAAE;YACF,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU,IAAI,IAAI,CAAC,YAAY,KAAK,UAAU,CAAC;IAC9E,CAAC;IAED,YAAY,CAAC,KAAsB;QACjC,OAAO,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;CACF;AAvCD,wDAuCC"}

package/dist/governance/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./GovernedAction";
+export * from "./GovernanceEngine";
+export * from "./actions/CodeChangeAction";
+export * from "./fsm/stateMachine";
+export * from "./review/diffParser";
+export * from "./review/render";
+export * from "./execution/sandbox";
+export * from "./capability/token";
+export * from "./storage/store";

package/dist/governance/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./GovernedAction"), exports);
+__exportStar(require("./GovernanceEngine"), exports);
+__exportStar(require("./actions/CodeChangeAction"), exports);
+__exportStar(require("./fsm/stateMachine"), exports);
+__exportStar(require("./review/diffParser"), exports);
+__exportStar(require("./review/render"), exports);
+__exportStar(require("./execution/sandbox"), exports);
+__exportStar(require("./capability/token"), exports);
+__exportStar(require("./storage/store"), exports);
+//# sourceMappingURL=index.js.map

package/dist/governance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/governance/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,qDAAmC;AACnC,6DAA2C;AAC3C,qDAAmC;AACnC,sDAAoC;AACpC,kDAAgC;AAChC,sDAAoC;AACpC,qDAAmC;AACnC,kDAAgC"}

package/dist/governance/review/diffParser.d.ts

@@ -0,0 +1,12 @@
+export interface DiffFile {
+    file: string;
+    additions: number;
+    deletions: number;
+    hunks: string[];
+}
+export declare function parseUnifiedDiff(diff: string): DiffFile[];
+export declare function extractFilesFromDiff(diff: string): string[];
+export declare function assessRisk(files: DiffFile[]): {
+    level: "low" | "medium" | "high";
+    warnings: string[];
+};

package/dist/governance/review/diffParser.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUnifiedDiff = parseUnifiedDiff;
+exports.extractFilesFromDiff = extractFilesFromDiff;
+exports.assessRisk = assessRisk;
+function parseUnifiedDiff(diff) {
+    const files = [];
+    let current = null;
+    for (const line of diff.split("\n")) {
+        if (line.startsWith("diff --git")) {
+            if (current) {
+                files.push(current);
+            }
+            const match = line.match(/b\/(.+)$/);
+            const file = match ? match[1] : "unknown";
+            current = { file, additions: 0, deletions: 0, hunks: [] };
+        }
+        else if (!current) {
+            continue;
+        }
+        else if (line.startsWith("+") && !line.startsWith("+++")) {
+            current.additions++;
+        }
+        else if (line.startsWith("-") && !line.startsWith("---")) {
+            current.deletions++;
+        }
+        else if (line.startsWith("@@")) {
+            current.hunks.push(line);
+        }
+    }
+    if (current) {
+        files.push(current);
+    }
+    return files;
+}
+function extractFilesFromDiff(diff) {
+    const files = [];
+    const filePattern = /^\+\+\+ b\/(.+)$/m;
+    for (const match of diff.matchAll(filePattern)) {
+        files.push(match[1]);
+    }
+    return files;
+}
+function assessRisk(files) {
+    const warnings = [];
+    const totalLines = files.reduce((sum, f) => sum + f.additions + f.deletions, 0);
+    if (totalLines > 300) {
+        warnings.push(`Large changeset: ${totalLines} lines`);
+    }
+    if (files.length > 10) {
+        warnings.push(`Many files touched: ${files.length}`);
+    }
+    if (totalLines > 1000) {
+        return { level: "high", warnings };
+    }
+    if (totalLines > 300 || files.length > 10) {
+        return { level: "medium", warnings };
+    }
+    return { level: "low", warnings };
+}
+//# sourceMappingURL=diffParser.js.map

package/dist/governance/review/diffParser.js.map

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

package/dist/governance/review/render.d.ts

@@ -0,0 +1,5 @@
+import { DiffFile } from "./diffParser";
+export declare function renderSummary(files: DiffFile[]): void;
+export declare function renderDiffForReview(files: DiffFile[], rationale: string): void;
+export declare function renderRiskAssessment(level: "low" | "medium" | "high", warnings: string[]): void;
+export declare function promptForApproval(): Promise<boolean>;

package/dist/governance/review/render.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSummary = renderSummary;
+exports.renderDiffForReview = renderDiffForReview;
+exports.renderRiskAssessment = renderRiskAssessment;
+exports.promptForApproval = promptForApproval;
+const chalk_1 = __importDefault(require("chalk"));
+function renderSummary(files) {
+    console.log(chalk_1.default.bold("\nDiff Summary\n"));
+    for (const f of files) {
+        console.log(`${chalk_1.default.cyan(f.file)}  ` +
+            chalk_1.default.green(`+${f.additions}`) +
+            " " +
+            chalk_1.default.red(`-${f.deletions}`));
+    }
+}
+function renderDiffForReview(files, rationale) {
+    console.log(chalk_1.default.bold.cyan("=".repeat(60)));
+    console.log(chalk_1.default.bold.blue("Proposed Code Change"));
+    console.log(chalk_1.default.bold.cyan("=".repeat(60)));
+    console.log(`${chalk_1.default.bold("Rationale:")} ${rationale}\n`);
+    for (const f of files) {
+        console.log(chalk_1.default.yellow(`\n📄 ${f.file}`));
+        console.log(`   ${chalk_1.default.green("+")} ${f.additions} lines added`);
+        console.log(`   ${chalk_1.default.red("-")} ${f.deletions} lines deleted`);
+    }
+    console.log(chalk_1.default.bold.cyan("\n" + "=".repeat(60)));
+}
+function renderRiskAssessment(level, warnings) {
+    const levelColor = {
+        low: chalk_1.default.green,
+        medium: chalk_1.default.yellow,
+        high: chalk_1.default.red,
+    };
+    console.log(chalk_1.default.bold(`\n${levelColor[level]}(\u26a0\ufe0f  Risk Level: ${level.toUpperCase()})`));
+    if (warnings.length > 0) {
+        for (const w of warnings) {
+            console.log(chalk_1.default.yellow(`   - ${w}`));
+        }
+    }
+}
+function promptForApproval() {
+    const readline = require("readline");
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(chalk_1.default.bold.yellow('\nType "YES" to approve, anything else to reject: '), (answer) => {
+            rl.close();
+            resolve(answer.trim() === "YES");
+        });
+    });
+}
+//# sourceMappingURL=render.js.map

package/dist/governance/review/render.js.map

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

package/dist/governance/storage/store.d.ts

@@ -0,0 +1,16 @@
+export interface SerializedAction {
+    id: string;
+    kind: string;
+    state: string;
+    payload: any;
+    rationale: string;
+    provenance: any;
+    updatedAt: number;
+    executedAt?: number;
+}
+export declare function ensureDataDir(): void;
+export declare function atomicWrite(filePath: string, data: string): void;
+export declare function loadActions(): Record<string, SerializedAction>;
+export declare function saveActions(actions: Record<string, SerializedAction>): void;
+export declare function deserializeActions(data: Record<string, any>): Record<string, SerializedAction>;
+export declare function auditActions(actions: Record<string, SerializedAction>): void;

package/dist/governance/storage/store.js

@@ -0,0 +1,110 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDataDir = ensureDataDir;
+exports.atomicWrite = atomicWrite;
+exports.loadActions = loadActions;
+exports.saveActions = saveActions;
+exports.deserializeActions = deserializeActions;
+exports.auditActions = auditActions;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const DATA_DIR = path_1.default.join(os_1.default.homedir(), ".yuangs");
+const STORE_PATH = path_1.default.join(DATA_DIR, "actions.json");
+function ensureDataDir() {
+    if (!fs_1.default.existsSync(DATA_DIR)) {
+        fs_1.default.mkdirSync(DATA_DIR, { recursive: true });
+    }
+}
+function atomicWrite(filePath, data) {
+    const tmpPath = `${filePath}.tmp.${Date.now()}`;
+    try {
+        fs_1.default.writeFileSync(tmpPath, data, "utf-8");
+        fs_1.default.renameSync(tmpPath, filePath);
+    }
+    catch (error) {
+        if (fs_1.default.existsSync(tmpPath)) {
+            fs_1.default.unlinkSync(tmpPath);
+        }
+        throw error;
+    }
+}
+function loadActions() {
+    ensureDataDir();
+    if (!fs_1.default.existsSync(STORE_PATH)) {
+        return {};
+    }
+    try {
+        const content = fs_1.default.readFileSync(STORE_PATH, "utf-8");
+        const data = JSON.parse(content);
+        return deserializeActions(data);
+    }
+    catch (error) {
+        console.error(`Failed to load actions: ${error}`);
+        return {};
+    }
+}
+function saveActions(actions) {
+    ensureDataDir();
+    try {
+        const content = JSON.stringify(actions, null, 2);
+        atomicWrite(STORE_PATH, content);
+    }
+    catch (error) {
+        console.error(`Failed to save actions: ${error}`);
+        throw error;
+    }
+}
+function deserializeActions(data) {
+    const result = {};
+    for (const [id, raw] of Object.entries(data)) {
+        try {
+            result[id] = validateAction(raw);
+        }
+        catch (error) {
+            console.warn(`Invalid action ${id}, skipping: ${error}`);
+        }
+    }
+    return result;
+}
+function validateAction(raw) {
+    if (typeof raw.id !== "string" || !raw.id) {
+        throw new Error("Action missing valid id");
+    }
+    const validStates = [
+        "DRAFT",
+        "PROPOSED",
+        "APPROVED",
+        "EXECUTED",
+        "OBSERVED",
+        "VERIFIED",
+        "REJECTED",
+    ];
+    if (!validStates.includes(raw.state)) {
+        throw new Error(`Invalid state: ${raw.state}`);
+    }
+    if (typeof raw.rationale !== "string") {
+        throw new Error("Rationale must be a string");
+    }
+    if (typeof raw.updatedAt !== "number") {
+        throw new Error("UpdatedAt must be a number");
+    }
+    if (raw.state === "EXECUTED" && !raw.executedAt) {
+        throw new Error("EXECUTED actions must have executedAt");
+    }
+    return raw;
+}
+function auditActions(actions) {
+    for (const [id, action] of Object.entries(actions)) {
+        try {
+            validateAction(action);
+        }
+        catch (error) {
+            throw new Error(`Audit failed for action ${id}: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/governance/storage/store.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuangs",
-  "version": "2.30.0",
+  "version": "2.32.0",
   "description": "苑广山的个人应用集合 CLI（彩色版）",
   "author": "苑广山",
   "license": "ISC",
@@ -43,9 +43,11 @@
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",
     "ora": "^6.3.1",
+    "yuangs": "^2.29.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
+    "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/json5": "^0.0.30",
     "@types/marked": "^5.0.2",