@yuaone/core 0.9.43 → 1.0.1

package/dist/overhead-governor.d.ts

@@ -63,7 +63,7 @@ export interface OverheadGovernorConfig {
     debugMode?: GuardMode;
 }
 export declare class OverheadGovernor {
-    private readonly cfg;
+    private cfg;
     /** Shadow mode 로그 콜백 (TUI로 보내거나 stdout) */
     private readonly onShadow?;
     constructor(config?: OverheadGovernorConfig, onShadow?: (subsystem: string, reason: string) => void);
@@ -87,6 +87,8 @@ export declare class OverheadGovernor {
     shouldRunTournament(ctx: TriggerContext): GuardMode;
     /** IncidentDebugMode: only run when repeated errors detected */
     shouldRunDebugMode(ctx: TriggerContext): GuardMode;
+    /** Override config at runtime (called by Decision Engine integration) */
+    overrideConfig(overrides: Partial<OverheadGovernorConfig>): void;
     private _shadow;
     /**
      * 현재 설정 반환 (디버그용).

package/dist/overhead-governor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overhead-governor.d.ts","sourceRoot":"","sources":["../src/overhead-governor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6BAA6B;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,sBAAsB,EAAE,OAAO,CAAC;IAChC,yCAAyC;IACzC,yBAAyB,EAAE,OAAO,CAAC;IACnC,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAkBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmC;IACvD,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA8C;gBAGtE,MAAM,CAAC,EAAE,sBAAsB,EAC/B,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI;IAQxD,kCAAkC;IAClC,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS;IA6BhD,uDAAuD;IACvD,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS;IAmB/C,gDAAgD;IAChD,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS;IAoBnD,4CAA4C;IAC5C,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS;IAoBpD,mCAAmC;IACnC,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS;IAanD,8CAA8C;IAC9C,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS;IAgBjD,sDAAsD;IACtD,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS;IAqBlD,sEAAsE;IACtE,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS;IAWjD,yEAAyE;IACzE,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS;IAWnD,gEAAgE;IAChE,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS;IAelD,OAAO,CAAC,OAAO;IAIf;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,sBAAsB,CAAC;IAI7C;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB;CAoB9D"}
+{"version":3,"file":"overhead-governor.d.ts","sourceRoot":"","sources":["../src/overhead-governor.ts"],"names":[],"mappings":"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"}

package/dist/overhead-governor.js

@@ -196,6 +196,11 @@ export class OverheadGovernor {
         }
         return "OFF";
     }
+    // ─── Runtime Override ────────────────────────────────────────────────────
+    /** Override config at runtime (called by Decision Engine integration) */
+    overrideConfig(overrides) {
+        Object.assign(this.cfg, overrides);
+    }
     // ─── Helpers ──────────────────────────────────────────────────────────────
     _shadow(subsystem, reason) {
         this.onShadow?.(subsystem, reason);

package/dist/overhead-governor.js.map

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

package/dist/patch-scope-controller.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @module patch-scope-controller
+ * @description Hard limits on modification scope per run.
+ * Prevents "silent large-scale changes" — the #1 agent safety risk.
+ * Tracks cumulative state in-memory per session.
+ * Role: SCOPE LIMITER only. Does NOT check code quality or path safety.
+ */
+import type { AgentComplexity } from "./agent-decision-types.js";
+export type RepoLifecycle = "existing" | "greenfield" | "migration";
+export interface PatchScopeLimit {
+    maxFilesPerRun: number;
+    maxDiffLinesPerRun: number;
+    maxProtectedFilesPerRun: number;
+    maxCrossPackageTouches: number;
+}
+export interface PatchScopeState {
+    touchedFiles: Set<string>;
+    totalInserted: number;
+    totalDeleted: number;
+    protectedFilesTouched: Set<string>;
+    packagesTouched: Set<string>;
+}
+export interface ScopeCheckResult {
+    allowed: boolean;
+    reason?: string;
+    currentUsage: {
+        files: number;
+        diffLines: number;
+        protectedFiles: number;
+        packages: number;
+    };
+    limits: PatchScopeLimit;
+}
+export declare function deriveScopeLimit(complexity: AgentComplexity, lifecycle: RepoLifecycle): PatchScopeLimit;
+export declare function detectRepoLifecycle(projectPath: string): RepoLifecycle;
+export declare class PatchScopeController {
+    private state;
+    private limit;
+    constructor(complexity: AgentComplexity, lifecycle: RepoLifecycle);
+    recordChange(filePath: string, insertedLines: number, deletedLines: number, isProtected: boolean): void;
+    check(): ScopeCheckResult;
+    reset(): void;
+}
+//# sourceMappingURL=patch-scope-controller.d.ts.map

package/dist/patch-scope-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-scope-controller.d.ts","sourceRoot":"","sources":["../src/patch-scope-controller.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7F,MAAM,EAAE,eAAe,CAAC;CACzB;AAaD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,GAAG,eAAe,CASvG;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAwBtE;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,KAAK,CAAkB;gBAEnB,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa;IAWjE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI;IAWvG,KAAK,IAAI,gBAAgB;IAwBzB,KAAK,IAAI,IAAI;CAOd"}

package/dist/patch-scope-controller.js

@@ -0,0 +1,107 @@
+/**
+ * @module patch-scope-controller
+ * @description Hard limits on modification scope per run.
+ * Prevents "silent large-scale changes" — the #1 agent safety risk.
+ * Tracks cumulative state in-memory per session.
+ * Role: SCOPE LIMITER only. Does NOT check code quality or path safety.
+ */
+const LIMITS = {
+    trivial: { maxFilesPerRun: 3, maxDiffLinesPerRun: 100, maxProtectedFilesPerRun: 0, maxCrossPackageTouches: 1 },
+    simple: { maxFilesPerRun: 5, maxDiffLinesPerRun: 300, maxProtectedFilesPerRun: 1, maxCrossPackageTouches: 1 },
+    moderate: { maxFilesPerRun: 10, maxDiffLinesPerRun: 800, maxProtectedFilesPerRun: 2, maxCrossPackageTouches: 2 },
+    complex: { maxFilesPerRun: 20, maxDiffLinesPerRun: 2000, maxProtectedFilesPerRun: 3, maxCrossPackageTouches: 3 },
+    massive: { maxFilesPerRun: 40, maxDiffLinesPerRun: 5000, maxProtectedFilesPerRun: 5, maxCrossPackageTouches: 5 },
+};
+const GREENFIELD_MULTIPLIER = 5;
+const MIGRATION_MULTIPLIER = 3;
+export function deriveScopeLimit(complexity, lifecycle) {
+    const base = LIMITS[complexity];
+    const mult = lifecycle === "greenfield" ? GREENFIELD_MULTIPLIER : lifecycle === "migration" ? MIGRATION_MULTIPLIER : 1;
+    return {
+        maxFilesPerRun: base.maxFilesPerRun * mult,
+        maxDiffLinesPerRun: base.maxDiffLinesPerRun * mult,
+        maxProtectedFilesPerRun: base.maxProtectedFilesPerRun * mult,
+        maxCrossPackageTouches: base.maxCrossPackageTouches * mult,
+    };
+}
+export function detectRepoLifecycle(projectPath) {
+    try {
+        const { existsSync } = require("node:fs");
+        const { join } = require("node:path");
+        const { execSync } = require("node:child_process");
+        if (!existsSync(join(projectPath, ".git")))
+            return "greenfield";
+        try {
+            const commitCount = execSync("git rev-list --count HEAD", { cwd: projectPath, timeout: 3000 }).toString().trim();
+            if (parseInt(commitCount) <= 1)
+                return "greenfield";
+        }
+        catch { /* git error */ }
+        // Check for migration signals
+        try {
+            const fs = require("node:fs");
+            const pkg = JSON.parse(fs.readFileSync(join(projectPath, "package.json"), "utf-8"));
+            if (pkg.scripts?.migrate || pkg.scripts?.migration)
+                return "migration";
+        }
+        catch { /* no package.json */ }
+        return "existing";
+    }
+    catch {
+        return "existing";
+    }
+}
+export class PatchScopeController {
+    state;
+    limit;
+    constructor(complexity, lifecycle) {
+        this.state = {
+            touchedFiles: new Set(),
+            totalInserted: 0,
+            totalDeleted: 0,
+            protectedFilesTouched: new Set(),
+            packagesTouched: new Set(),
+        };
+        this.limit = deriveScopeLimit(complexity, lifecycle);
+    }
+    recordChange(filePath, insertedLines, deletedLines, isProtected) {
+        this.state.touchedFiles.add(filePath);
+        this.state.totalInserted += insertedLines;
+        this.state.totalDeleted += deletedLines;
+        if (isProtected)
+            this.state.protectedFilesTouched.add(filePath);
+        // Package detection (monorepo)
+        const pkgMatch = filePath.match(/^(?:packages|apps|libs)\/([^/]+)\//);
+        if (pkgMatch)
+            this.state.packagesTouched.add(pkgMatch[1]);
+    }
+    check() {
+        const usage = {
+            files: this.state.touchedFiles.size,
+            diffLines: this.state.totalInserted + this.state.totalDeleted,
+            protectedFiles: this.state.protectedFilesTouched.size,
+            packages: this.state.packagesTouched.size,
+        };
+        if (usage.files > this.limit.maxFilesPerRun) {
+            return { allowed: false, reason: `File count ${usage.files} exceeds limit ${this.limit.maxFilesPerRun}`, currentUsage: usage, limits: this.limit };
+        }
+        if (usage.diffLines > this.limit.maxDiffLinesPerRun) {
+            return { allowed: false, reason: `Diff lines ${usage.diffLines} exceeds limit ${this.limit.maxDiffLinesPerRun}`, currentUsage: usage, limits: this.limit };
+        }
+        if (usage.protectedFiles > this.limit.maxProtectedFilesPerRun) {
+            return { allowed: false, reason: `Protected files ${usage.protectedFiles} exceeds limit ${this.limit.maxProtectedFilesPerRun}`, currentUsage: usage, limits: this.limit };
+        }
+        if (usage.packages > this.limit.maxCrossPackageTouches) {
+            return { allowed: false, reason: `Cross-package touches ${usage.packages} exceeds limit ${this.limit.maxCrossPackageTouches}`, currentUsage: usage, limits: this.limit };
+        }
+        return { allowed: true, currentUsage: usage, limits: this.limit };
+    }
+    reset() {
+        this.state.touchedFiles.clear();
+        this.state.totalInserted = 0;
+        this.state.totalDeleted = 0;
+        this.state.protectedFilesTouched.clear();
+        this.state.packagesTouched.clear();
+    }
+}
+//# sourceMappingURL=patch-scope-controller.js.map

package/dist/patch-scope-controller.js.map

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

package/dist/patch-transaction.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @module patch-transaction
+ * @description Patch transaction journal for atomic file modifications.
+ * Records before/after snapshots of all file mutations.
+ * Enables deterministic rollback on failure.
+ * NO LLM, pure file I/O.
+ */
+export interface PatchJournalEntry {
+    id: string;
+    tool: string;
+    path: string;
+    beforeSnapshot: string;
+    timestamp: number;
+    wasNewFile: boolean;
+}
+export interface RollbackPoint {
+    id: string;
+    entries: PatchJournalEntry[];
+    reason: string;
+    createdAt: number;
+}
+export declare class PatchTransactionJournal {
+    private entries;
+    private rollbackPoints;
+    private journalPath;
+    private entryCounter;
+    constructor(projectPath: string, sessionId: string);
+    /**
+     * Record a file's state BEFORE mutation.
+     * Call this before every file_edit / file_write.
+     */
+    recordBefore(tool: string, filePath: string): string;
+    /**
+     * Create a rollback point — snapshot of all mutations so far.
+     * Called when patchRisk >= threshold or changedFiles >= threshold.
+     */
+    createRollbackPoint(reason: string): RollbackPoint;
+    /**
+     * Execute rollback — restore all files to their before state.
+     * Processes entries in reverse order (last modified first).
+     */
+    rollback(pointId?: string): {
+        restored: number;
+        errors: string[];
+    };
+    /** Get total number of recorded mutations */
+    get size(): number;
+    /** Reset for new run */
+    reset(): void;
+    /** Check if a rollback point should be created (deterministic rule) */
+    shouldCreateRollbackPoint(patchRisk: number, changedFilesCount: number): boolean;
+}
+//# sourceMappingURL=patch-transaction.d.ts.map

package/dist/patch-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-transaction.d.ts","sourceRoot":"","sources":["../src/patch-transaction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAK;gBAEb,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAMlD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAiCpD;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAYlD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAiClE,6CAA6C;IAC7C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wBAAwB;IACxB,KAAK,IAAI,IAAI;IAMb,uEAAuE;IACvE,yBAAyB,CACvB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,GACxB,OAAO;CAGX"}

package/dist/patch-transaction.js

@@ -0,0 +1,119 @@
+/**
+ * @module patch-transaction
+ * @description Patch transaction journal for atomic file modifications.
+ * Records before/after snapshots of all file mutations.
+ * Enables deterministic rollback on failure.
+ * NO LLM, pure file I/O.
+ */
+import { readFileSync, writeFileSync, mkdirSync, appendFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+export class PatchTransactionJournal {
+    entries = [];
+    rollbackPoints = [];
+    journalPath;
+    entryCounter = 0;
+    constructor(projectPath, sessionId) {
+        const sessionDir = join(projectPath, ".yuan", "sessions", sessionId);
+        mkdirSync(sessionDir, { recursive: true });
+        this.journalPath = join(sessionDir, "patch-journal.jsonl");
+    }
+    /**
+     * Record a file's state BEFORE mutation.
+     * Call this before every file_edit / file_write.
+     */
+    recordBefore(tool, filePath) {
+        const id = `patch-${++this.entryCounter}-${Date.now()}`;
+        let beforeSnapshot = "";
+        let wasNewFile = true;
+        try {
+            beforeSnapshot = readFileSync(filePath, "utf-8");
+            wasNewFile = false;
+        }
+        catch {
+            // File doesn't exist yet (new file creation)
+            beforeSnapshot = "";
+            wasNewFile = true;
+        }
+        const entry = {
+            id,
+            tool,
+            path: filePath,
+            beforeSnapshot,
+            timestamp: Date.now(),
+            wasNewFile,
+        };
+        this.entries.push(entry);
+        // Persist to JSONL
+        try {
+            appendFileSync(this.journalPath, JSON.stringify(entry) + "\n");
+        }
+        catch { /* non-fatal */ }
+        return id;
+    }
+    /**
+     * Create a rollback point — snapshot of all mutations so far.
+     * Called when patchRisk >= threshold or changedFiles >= threshold.
+     */
+    createRollbackPoint(reason) {
+        const point = {
+            id: `rollback-${Date.now()}`,
+            entries: [...this.entries],
+            reason,
+            createdAt: Date.now(),
+        };
+        this.rollbackPoints.push(point);
+        return point;
+    }
+    /**
+     * Execute rollback — restore all files to their before state.
+     * Processes entries in reverse order (last modified first).
+     */
+    rollback(pointId) {
+        const point = pointId
+            ? this.rollbackPoints.find(p => p.id === pointId)
+            : this.rollbackPoints[this.rollbackPoints.length - 1];
+        if (!point) {
+            return { restored: 0, errors: ["No rollback point found"] };
+        }
+        let restored = 0;
+        const errors = [];
+        // Reverse order — undo last change first
+        for (const entry of [...point.entries].reverse()) {
+            try {
+                if (entry.wasNewFile) {
+                    // File was newly created — delete it
+                    const { unlinkSync } = require("node:fs");
+                    try {
+                        unlinkSync(entry.path);
+                    }
+                    catch { /* may already be gone */ }
+                }
+                else {
+                    // File existed — restore original content
+                    mkdirSync(dirname(entry.path), { recursive: true });
+                    writeFileSync(entry.path, entry.beforeSnapshot);
+                }
+                restored++;
+            }
+            catch (err) {
+                errors.push(`Failed to restore ${entry.path}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        return { restored, errors };
+    }
+    /** Get total number of recorded mutations */
+    get size() {
+        return this.entries.length;
+    }
+    /** Reset for new run */
+    reset() {
+        this.entries = [];
+        this.rollbackPoints = [];
+        this.entryCounter = 0;
+    }
+    /** Check if a rollback point should be created (deterministic rule) */
+    shouldCreateRollbackPoint(patchRisk, changedFilesCount) {
+        return patchRisk >= 0.7 || changedFilesCount >= 5;
+    }
+}
+//# sourceMappingURL=patch-transaction.js.map

package/dist/patch-transaction.js.map

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

package/dist/pre-write-validator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @module pre-write-validator
+ * @description Validates code quality BEFORE writing to file.
+ * Catches: TODO/stub, unbalanced braces, empty functions, any types.
+ * Context-aware: checks changed hunks, respects file role.
+ * Role: QUALITY GATE only. Does NOT protect paths or manage budget.
+ */
+export type FileRole = "source" | "test" | "config" | "doc" | "fixture" | "generated";
+export interface ValidationContext {
+    path: string;
+    language?: string;
+    fileRole: FileRole;
+    changedHunksOnly: boolean;
+}
+export interface PreWriteIssue {
+    severity: "error" | "warning";
+    message: string;
+    line?: number;
+}
+export interface PreWriteResult {
+    valid: boolean;
+    issues: PreWriteIssue[];
+    blockedReason?: string;
+}
+/** Detect file role from path */
+export declare function detectFileRole(path: string): FileRole;
+/** Validate content before writing */
+export declare function validateBeforeWrite(content: string, ctx: ValidationContext): PreWriteResult;
+//# sourceMappingURL=pre-write-validator.d.ts.map

package/dist/pre-write-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-write-validator.d.ts","sourceRoot":"","sources":["../src/pre-write-validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;AAEtF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,iCAAiC;AACjC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAOrD;AAED,sCAAsC;AACtC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,cAAc,CA6E3F"}

package/dist/pre-write-validator.js

@@ -0,0 +1,97 @@
+/**
+ * @module pre-write-validator
+ * @description Validates code quality BEFORE writing to file.
+ * Catches: TODO/stub, unbalanced braces, empty functions, any types.
+ * Context-aware: checks changed hunks, respects file role.
+ * Role: QUALITY GATE only. Does NOT protect paths or manage budget.
+ */
+/** Detect file role from path */
+export function detectFileRole(path) {
+    if (/\.(test|spec)\.[jt]sx?$/.test(path))
+        return "test";
+    if (/\.(md|txt|rst|adoc)$/.test(path))
+        return "doc";
+    if (/(fixture|mock|stub|sample|example)/.test(path))
+        return "fixture";
+    if (/(dist|build|\.next|__generated__|\.gen\.)/.test(path))
+        return "generated";
+    if (/\.(json|yaml|yml|toml|ini|conf|config)/.test(path) || /(tsconfig|package\.json|\.eslintrc)/.test(path))
+        return "config";
+    return "source";
+}
+/** Validate content before writing */
+export function validateBeforeWrite(content, ctx) {
+    const issues = [];
+    const role = ctx.fileRole;
+    // Generated files: never validate
+    if (role === "generated")
+        return { valid: true, issues: [] };
+    // Config files: minimal validation
+    if (role === "config") {
+        // Check JSON validity for .json files
+        if (ctx.path.endsWith(".json")) {
+            try {
+                JSON.parse(content);
+            }
+            catch {
+                issues.push({ severity: "error", message: "Invalid JSON" });
+            }
+        }
+        return { valid: issues.filter(i => i.severity === "error").length === 0, issues };
+    }
+    // Source/test files: full validation
+    const lines = content.split("\n");
+    // 1. TODO/FIXME/HACK in source (not test/doc/fixture)
+    if (role === "source") {
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Only flag if it's a code comment with TODO, not a string/doc
+            if (/\/\/\s*(TODO|FIXME|HACK|XXX)\b/i.test(line) || /\/\*\s*(TODO|FIXME|HACK)\b/i.test(line)) {
+                issues.push({ severity: "error", message: `TODO/FIXME/HACK comment at line ${i + 1}`, line: i + 1 });
+            }
+        }
+    }
+    // 2. Empty function body (not in interfaces/abstract/test)
+    if (role === "source") {
+        const emptyFunc = content.match(/\)\s*\{[\s\n]*\}/g);
+        if (emptyFunc && emptyFunc.length > 0) {
+            // Check it's not an interface or abstract method
+            for (const match of emptyFunc) {
+                const matchIdx = content.indexOf(match);
+                const preceding = content.slice(Math.max(0, matchIdx - 50), matchIdx);
+                if (!/interface|abstract|noop|intentional/i.test(preceding)) {
+                    issues.push({ severity: "error", message: "Empty function body detected" });
+                    break;
+                }
+            }
+        }
+    }
+    // 3. Brace balance
+    const opens = (content.match(/\{/g) ?? []).length;
+    const closes = (content.match(/\}/g) ?? []).length;
+    if (Math.abs(opens - closes) > 1) {
+        issues.push({ severity: "error", message: `Unbalanced braces: ${opens} opens, ${closes} closes` });
+    }
+    // 4. TypeScript: 'any' type usage (source only, not test)
+    if (role === "source" && /\.tsx?$/.test(ctx.path)) {
+        const anyMatches = content.match(/:\s*any\b/g);
+        if (anyMatches && anyMatches.length > 0) {
+            issues.push({ severity: "warning", message: `'any' type used ${anyMatches.length} time(s)` });
+        }
+    }
+    // 5. console.log in production code (not test)
+    if (role === "source" && /console\.(log|warn|error)\(/.test(content)) {
+        issues.push({ severity: "warning", message: "console.log left in production code" });
+    }
+    // 6. throw new Error("not implemented") — stub
+    if (role === "source" && /throw\s+new\s+Error\s*\(\s*["']not\s+implemented["']\s*\)/i.test(content)) {
+        issues.push({ severity: "error", message: "Stub implementation: throw new Error('not implemented')" });
+    }
+    const errorCount = issues.filter(i => i.severity === "error").length;
+    return {
+        valid: errorCount === 0,
+        issues,
+        blockedReason: errorCount > 0 ? `${errorCount} quality issue(s) found` : undefined,
+    };
+}
+//# sourceMappingURL=pre-write-validator.js.map

package/dist/pre-write-validator.js.map

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

package/dist/prompt-builder.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @module prompt-builder
+ * @description YUAN PromptBuilder -- dumb renderer.
+ *
+ * Rules:
+ * 1. PromptEnvelope -> string conversion only
+ * 2. No policy decisions (mode, budget, role interpretation forbidden)
+ * 3. Section order: core -> policy -> role -> context -> ephemeral -> reinforce
+ * 4. When token budget exceeded, droppable sections are removed first
+ *
+ * YUA reference: prompt-builder.ts (1436 lines) -- YUAN is much thinner
+ */
+import type { PromptEnvelope } from "./prompt-envelope.js";
+/**
+ * PromptEnvelope -> final system prompt string.
+ * No decisions. Just concatenation.
+ *
+ * @param envelope - The compiled prompt envelope from PromptRuntime
+ * @param maxTokens - Optional token budget. If set, droppable sections are
+ *                    removed (lowest priority first) until budget is met.
+ *                    Required sections (droppable=false) are never removed.
+ * @returns Final system prompt string ready for LLM consumption
+ */
+export declare function buildPrompt(envelope: PromptEnvelope, maxTokens?: number): string;
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,sBAAsB,CAAC;AA8B1E;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAwChF"}