zone-ai-agent 0.4.0

package/dist/patch/validatePatchPlan.js

@@ -0,0 +1,148 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePatchPlan = validatePatchPlan;
+const node_path_1 = __importDefault(require("node:path"));
+const files_js_1 = require("../utils/files.js");
+function isSupportedOperation(value) {
+    return value === "create" || value === "modify";
+}
+function normalizePatchPath(filePath) {
+    return filePath.replace(/\\/g, "/").trim();
+}
+function resolvePatchPath(targetPath, patchPath) {
+    return node_path_1.default.resolve(targetPath, patchPath);
+}
+function isPathOutsideRepo(targetPath, patchPath) {
+    const resolvedRepoRoot = node_path_1.default.resolve(targetPath);
+    const resolvedPatchPath = resolvePatchPath(targetPath, patchPath);
+    const relative = node_path_1.default.relative(resolvedRepoRoot, resolvedPatchPath);
+    return relative.startsWith("..") || node_path_1.default.isAbsolute(relative);
+}
+function isProtectedFilePath(normalizedPath) {
+    return (normalizedPath === ".env" ||
+        normalizedPath.startsWith(".env.") ||
+        normalizedPath === "package-lock.json" ||
+        normalizedPath === "yarn.lock" ||
+        normalizedPath === "pnpm-lock.yaml" ||
+        normalizedPath.startsWith(".github/workflows/") ||
+        normalizedPath.startsWith(".git/"));
+}
+function isNodeModulesPath(normalizedPath) {
+    return normalizedPath.includes("node_modules/");
+}
+function isAgentArtifactPath(normalizedPath) {
+    return (normalizedPath.startsWith(".agent-patches") ||
+        normalizedPath.startsWith(".agent-backups") ||
+        normalizedPath.startsWith(".agent-cache"));
+}
+function buildIssue(input) {
+    return {
+        level: input.level,
+        code: input.code,
+        message: input.message,
+        filePath: input.filePath,
+        details: input.details,
+    };
+}
+async function validatePatchPlan(input) {
+    const issues = [];
+    const seenPaths = new Set();
+    for (const patch of input.patchPlan.patches) {
+        if (!patch.path || !patch.path.trim()) {
+            issues.push(buildIssue({
+                level: "error",
+                code: "MISSING_TARGET_PATH",
+                message: "Patch item is missing a target path.",
+            }));
+            continue;
+        }
+        const normalizedPath = normalizePatchPath(patch.path);
+        if (!isSupportedOperation(patch.operation)) {
+            issues.push(buildIssue({
+                level: "error",
+                code: "UNSUPPORTED_OPERATION",
+                message: `Unsupported patch operation '${patch.operation}'.`,
+                filePath: normalizedPath,
+            }));
+            continue;
+        }
+        if (!patch.contentPreview || !patch.contentPreview.trim()) {
+            issues.push(buildIssue({
+                level: "warning",
+                code: "EMPTY_CONTENT_PREVIEW",
+                message: "Patch item has empty content preview.",
+                filePath: normalizedPath,
+            }));
+        }
+        if (seenPaths.has(normalizedPath)) {
+            issues.push(buildIssue({
+                level: "warning",
+                code: "DUPLICATE_TARGET_PATH",
+                message: "Multiple patch items target the same file.",
+                filePath: normalizedPath,
+            }));
+        }
+        else {
+            seenPaths.add(normalizedPath);
+        }
+        if (isPathOutsideRepo(input.targetPath, normalizedPath)) {
+            issues.push(buildIssue({
+                level: "error",
+                code: "PATH_OUTSIDE_REPO",
+                message: "Patch target resolves outside the repository root.",
+                filePath: normalizedPath,
+            }));
+            continue;
+        }
+        if (isProtectedFilePath(normalizedPath)) {
+            issues.push(buildIssue({
+                level: "error",
+                code: "TARGETS_PROTECTED_FILE",
+                message: "Patch targets a protected file or workflow path.",
+                filePath: normalizedPath,
+            }));
+        }
+        const absoluteTargetPath = resolvePatchPath(input.targetPath, normalizedPath);
+        const exists = await (0, files_js_1.fileExists)(absoluteTargetPath);
+        if (patch.operation === "create" && exists) {
+            issues.push(buildIssue({
+                level: "warning",
+                code: "CREATE_TARGET_ALREADY_EXISTS",
+                message: "Create operation targets an existing file.",
+                filePath: normalizedPath,
+            }));
+        }
+        if (patch.operation === "modify" && !exists) {
+            issues.push(buildIssue({
+                level: "error",
+                code: "MODIFY_TARGET_MISSING",
+                message: "Modify operation targets a file that does not exist.",
+                filePath: normalizedPath,
+            }));
+        }
+        if (isNodeModulesPath(normalizedPath)) {
+            issues.push(buildIssue({
+                level: "warning",
+                code: "TARGETS_NODE_MODULES",
+                message: "Patch targets a file inside node_modules, which is usually unintended.",
+                filePath: normalizedPath,
+            }));
+        }
+        if (isAgentArtifactPath(normalizedPath)) {
+            issues.push(buildIssue({
+                level: "warning",
+                code: "TARGETS_AGENT_ARTIFACT",
+                message: "Patch targets an internal agent artifact directory.",
+                filePath: normalizedPath,
+            }));
+        }
+    }
+    return {
+        isValid: !issues.some((issue) => issue.level === "error"),
+        issues,
+    };
+}
+//# sourceMappingURL=validatePatchPlan.js.map

package/dist/patch/validatePatchPlan.js.map

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

package/dist/patch-generation/buildGeneratedPatchPlan.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGeneratedPatchPlan = buildGeneratedPatchPlan;
+const classifyPatchIntent_js_1 = require("./classifyPatchIntent.js");
+function mapIntent(intent) {
+    switch (intent) {
+        case "safe_replace":
+        case "add_comment":
+        case "update_import":
+        case "rename_symbol":
+            return intent;
+        default:
+            return "add_comment";
+    }
+}
+function buildOperations(intent) {
+    switch (intent) {
+        case "add_comment":
+            return [
+                {
+                    type: "add_comment",
+                    filePath: "unknown",
+                    comment: "TODO",
+                    target: "unknown"
+                }
+            ];
+        case "safe_replace":
+            return [
+                {
+                    type: "safe_replace",
+                    filePath: "unknown",
+                    find: "old_value",
+                    replaceWith: "new_value",
+                    matchMode: "exact"
+                }
+            ];
+        case "update_import":
+            return [
+                {
+                    type: "update_import",
+                    filePath: "unknown",
+                    from: "old/import",
+                    to: "new/import"
+                }
+            ];
+        case "rename_symbol":
+            return [
+                {
+                    type: "rename_symbol",
+                    filePath: "unknown",
+                    from: "oldName",
+                    to: "newName"
+                }
+            ];
+    }
+}
+function buildSummary(intent) {
+    switch (intent) {
+        case "add_comment":
+            return "Adds a comment in a deterministic location.";
+        case "safe_replace":
+            return "Performs a safe deterministic replacement.";
+        case "update_import":
+            return "Updates an import path in a deterministic way.";
+        case "rename_symbol":
+            return "Renames a symbol intent in preview form.";
+    }
+}
+function buildWarnings(input, intent) {
+    const warnings = [];
+    if (input.decision.mode !== "safe_to_apply") {
+        warnings.push(`Decision mode is '${input.decision.mode}', so generated operations are preview-oriented.`);
+    }
+    if (intent !== "safe_replace") {
+        warnings.push(`Intent '${intent}' is not convertible to a real PatchPlan in v1 unless explicitly supported.`);
+    }
+    if (input.reasonCodes.length > 0) {
+        warnings.push(`Reason codes: ${input.reasonCodes.join(", ")}`);
+    }
+    return warnings;
+}
+function buildGeneratedPatchPlan(input) {
+    const rawIntent = (0, classifyPatchIntent_js_1.classifyPatchIntent)(input.task);
+    const intent = mapIntent(rawIntent);
+    const operations = buildOperations(intent);
+    return {
+        version: 1,
+        intent,
+        operations,
+        summary: buildSummary(intent),
+        warnings: buildWarnings(input, intent)
+    };
+}
+//# sourceMappingURL=buildGeneratedPatchPlan.js.map

package/dist/patch-generation/buildGeneratedPatchPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGeneratedPatchPlan.js","sourceRoot":"","sources":["../../src/patch-generation/buildGeneratedPatchPlan.ts"],"names":[],"mappings":";;AA4GA,0DAYC;AAxHD,qEAA+D;AAgB/D,SAAS,SAAS,CAAC,MAAc;IAC/B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,cAAc,CAAC;QACpB,KAAK,aAAa,CAAC;QACnB,KAAK,eAAe,CAAC;QACrB,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAA4B;IACnD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,aAAa;YAChB,OAAO;gBACL;oBACE,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,MAAM;oBACf,MAAM,EAAE,SAAS;iBAClB;aACF,CAAC;QAEJ,KAAK,cAAc;YACjB,OAAO;gBACL;oBACE,IAAI,EAAE,cAAc;oBACpB,QAAQ,EAAE,SAAS;oBACnB,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,WAAW;oBACxB,SAAS,EAAE,OAAO;iBACnB;aACF,CAAC;QAEJ,KAAK,eAAe;YAClB,OAAO;gBACL;oBACE,IAAI,EAAE,eAAe;oBACrB,QAAQ,EAAE,SAAS;oBACnB,IAAI,EAAE,YAAY;oBAClB,EAAE,EAAE,YAAY;iBACjB;aACF,CAAC;QAEJ,KAAK,eAAe;YAClB,OAAO;gBACL;oBACE,IAAI,EAAE,eAAe;oBACrB,QAAQ,EAAE,SAAS;oBACnB,IAAI,EAAE,SAAS;oBACf,EAAE,EAAE,SAAS;iBACd;aACF,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAA4B;IAChD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,aAAa;YAChB,OAAO,6CAA6C,CAAC;QACvD,KAAK,cAAc;YACjB,OAAO,4CAA4C,CAAC;QACtD,KAAK,eAAe;YAClB,OAAO,gDAAgD,CAAC;QAC1D,KAAK,eAAe;YAClB,OAAO,0CAA0C,CAAC;IACtD,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAY,EAAE,MAA4B;IAC/D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QAC5C,QAAQ,CAAC,IAAI,CACX,qBAAqB,KAAK,CAAC,QAAQ,CAAC,IAAI,kDAAkD,CAC3F,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CACX,WAAW,MAAM,6EAA6E,CAC/F,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,uBAAuB,CAAC,KAAY;IAClD,MAAM,SAAS,GAAG,IAAA,4CAAmB,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE,CAAC;QACV,MAAM;QACN,UAAU;QACV,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;QAC7B,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/patch-generation/buildPatchOperations.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPatchOperations = buildPatchOperations;
+function buildPatchOperations(intent) {
+    switch (intent) {
+        case "rename_symbol":
+            return [
+                {
+                    type: "rename",
+                    scope: "single_file"
+                }
+            ];
+        case "update_import":
+            return [
+                {
+                    type: "update_import",
+                    scope: "single_file"
+                }
+            ];
+        case "add_comment":
+            return [
+                {
+                    type: "insert_comment",
+                    scope: "single_file",
+                    position: "line_above_target"
+                }
+            ];
+        case "safe_replace":
+            return [
+                {
+                    type: "replace_text",
+                    scope: "single_file",
+                    matchMode: "exact"
+                }
+            ];
+        case "unknown":
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=buildPatchOperations.js.map

package/dist/patch-generation/buildPatchOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPatchOperations.js","sourceRoot":"","sources":["../../src/patch-generation/buildPatchOperations.ts"],"names":[],"mappings":";;AAsBA,oDAwCC;AAxCD,SAAgB,oBAAoB,CAAC,MAAmB;IACtD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,eAAe;YAClB,OAAO;gBACL;oBACE,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,aAAa;iBACrB;aACF,CAAC;QAEJ,KAAK,eAAe;YAClB,OAAO;gBACL;oBACE,IAAI,EAAE,eAAe;oBACrB,KAAK,EAAE,aAAa;iBACrB;aACF,CAAC;QAEJ,KAAK,aAAa;YAChB,OAAO;gBACL;oBACE,IAAI,EAAE,gBAAgB;oBACtB,KAAK,EAAE,aAAa;oBACpB,QAAQ,EAAE,mBAAmB;iBAC9B;aACF,CAAC;QAEJ,KAAK,cAAc;YACjB,OAAO;gBACL;oBACE,IAAI,EAAE,cAAc;oBACpB,KAAK,EAAE,aAAa;oBACpB,SAAS,EAAE,OAAO;iBACnB;aACF,CAAC;QAEJ,KAAK,SAAS,CAAC;QACf;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/patch-generation/classifyPatchIntent.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyPatchIntent = classifyPatchIntent;
+function normalizeTask(task) {
+    return task.trim().toLowerCase();
+}
+function includesAny(text, keywords) {
+    return keywords.some((keyword) => text.includes(keyword));
+}
+function classifyPatchIntent(task) {
+    const normalizedTask = normalizeTask(task);
+    if (!normalizedTask) {
+        return "unknown";
+    }
+    if (includesAny(normalizedTask, [
+        "update import",
+        "fix import",
+        "change import",
+        "import path",
+        "adjust import"
+    ])) {
+        // If it's a test file context, let LLM handle it
+        const isTestContext = includesAny(normalizedTask, [
+            "spec", "test", "cypress", "playwright", "selenium",
+            "cucumber", "jest", "pytest", "feature", "step"
+        ]);
+        if (isTestContext)
+            return "unknown";
+        return "update_import";
+    }
+    if (includesAny(normalizedTask, [
+        "rename function",
+        "rename variable",
+        "rename helper",
+        "rename method",
+        "rename class",
+        "change name",
+        "rename "
+    ])) {
+        return "rename_symbol";
+    }
+    if (includesAny(normalizedTask, [
+        "add comment",
+        "insert comment",
+        "append comment",
+        "document with comment",
+        "add explanation comment"
+    ])) {
+        return "add_comment";
+    }
+    if (includesAny(normalizedTask, [
+        "safe replace",
+        "replace exact text",
+        "replace string",
+        "update text",
+        "replace "
+    ])) {
+        return "safe_replace";
+    }
+    return "unknown";
+}
+//# sourceMappingURL=classifyPatchIntent.js.map

package/dist/patch-generation/classifyPatchIntent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifyPatchIntent.js","sourceRoot":"","sources":["../../src/patch-generation/classifyPatchIntent.ts"],"names":[],"mappings":";;AAeA,kDAgEC;AAxED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,QAA2B;IAC5D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IACA,WAAW,CAAC,cAAc,EAAE;QAC1B,eAAe;QACf,YAAY;QACZ,eAAe;QACf,aAAa;QACb,eAAe;KAChB,CAAC,EACF,CAAC;QACD,iDAAiD;QACjD,MAAM,aAAa,GAAG,WAAW,CAAC,cAAc,EAAE;YAChD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU;YACnD,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM;SAChD,CAAC,CAAC;QACH,IAAI,aAAa;YAAE,OAAO,SAAS,CAAC;QACpC,OAAO,eAAe,CAAC;IACzB,CAAC;IAEC,IACE,WAAW,CAAC,cAAc,EAAE;QAC1B,iBAAiB;QACjB,iBAAiB;QACjB,eAAe;QACf,eAAe;QACf,cAAc;QACd,aAAa;QACb,SAAS;KACV,CAAC,EACF,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IACE,WAAW,CAAC,cAAc,EAAE;QAC1B,aAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,uBAAuB;QACvB,yBAAyB;KAC1B,CAAC,EACF,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IACE,WAAW,CAAC,cAAc,EAAE;QAC1B,cAAc;QACd,oBAAoB;QACpB,gBAAgB;QAChB,aAAa;QACb,UAAU;KACX,CAAC,EACF,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/patch-generation/formatGeneratedPatchPlanPreview.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatGeneratedPatchPlanPreview = formatGeneratedPatchPlanPreview;
+function formatGeneratedPatchPlanPreview(plan) {
+    const operationCount = plan.operations.length;
+    return {
+        stage: "generated_patch_preview",
+        status: "info",
+        summary: operationCount === 1
+            ? "Generated patch preview contains 1 operation."
+            : `Generated patch preview contains ${operationCount} operations.`,
+        details: operationCount > 0
+            ? plan.operations
+                .map((operation, index) => {
+                const filePath = "filePath" in operation && typeof operation.filePath === "string"
+                    ? operation.filePath
+                    : "unknown";
+                return `${index + 1}. ${operation.type} -> ${filePath}`;
+            })
+                .join("\n")
+            : "No operations were generated.",
+        operationCount
+    };
+}
+//# sourceMappingURL=formatGeneratedPatchPlanPreview.js.map

package/dist/patch-generation/formatGeneratedPatchPlanPreview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatGeneratedPatchPlanPreview.js","sourceRoot":"","sources":["../../src/patch-generation/formatGeneratedPatchPlanPreview.ts"],"names":[],"mappings":";;AAEA,0EAyBC;AAzBD,SAAgB,+BAA+B,CAAC,IAAwB;IACtE,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAE9C,OAAO;QACL,KAAK,EAAE,yBAAyB;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EACL,cAAc,KAAK,CAAC;YAClB,CAAC,CAAC,+CAA+C;YACjD,CAAC,CAAC,oCAAoC,cAAc,cAAc;QACtE,OAAO,EACL,cAAc,GAAG,CAAC;YAChB,CAAC,CAAC,IAAI,CAAC,UAAU;iBACZ,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;gBACxB,MAAM,QAAQ,GACZ,UAAU,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ;oBAC/D,CAAC,CAAC,SAAS,CAAC,QAAQ;oBACpB,CAAC,CAAC,SAAS,CAAC;gBAEhB,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,SAAS,CAAC,IAAI,OAAO,QAAQ,EAAE,CAAC;YAC1D,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC;YACf,CAAC,CAAC,+BAA+B;QACrC,cAAc;KACN,CAAC;AACb,CAAC"}

package/dist/patch-generation/generatePatchPlan.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePatchPlan = generatePatchPlan;
+const buildPatchOperations_js_1 = require("./buildPatchOperations.js");
+const classifyPatchIntent_js_1 = require("./classifyPatchIntent.js");
+const isIntentAllowed_js_1 = require("./isIntentAllowed.js");
+function mapDecisionModeToStrategy(mode) {
+    switch (mode) {
+        case "blocked":
+            return "blocked";
+        case "preview_only":
+            return "restricted";
+        case "safe_to_apply":
+            return "safe";
+        default:
+            return "blocked";
+    }
+}
+function generatePatchPlan(input) {
+    const strategy = mapDecisionModeToStrategy(input.decision.mode);
+    const intent = (0, classifyPatchIntent_js_1.classifyPatchIntent)(input.task);
+    const derivedFrom = input.reasonCodes ?? [];
+    if (strategy === "blocked") {
+        return {
+            allowed: false,
+            strategy,
+            intent,
+            operations: [],
+            metadata: {
+                reason: "Patch generation blocked by decision mode.",
+                derivedFrom,
+                confidenceScore: input.decision.confidenceScore
+            }
+        };
+    }
+    if (intent === "unknown") {
+        return {
+            allowed: false,
+            strategy,
+            intent,
+            operations: [],
+            metadata: {
+                reason: "Patch generation blocked because task intent is unknown.",
+                derivedFrom,
+                confidenceScore: input.decision.confidenceScore
+            }
+        };
+    }
+    if (!(0, isIntentAllowed_js_1.isIntentAllowed)(intent, strategy)) {
+        return {
+            allowed: false,
+            strategy,
+            intent,
+            operations: [],
+            metadata: {
+                reason: `Patch intent is not allowed for strategy: ${strategy}.`,
+                derivedFrom,
+                confidenceScore: input.decision.confidenceScore
+            }
+        };
+    }
+    return {
+        allowed: true,
+        strategy,
+        intent,
+        operations: (0, buildPatchOperations_js_1.buildPatchOperations)(intent),
+        metadata: {
+            reason: "Patch plan generated successfully from deterministic intent classification.",
+            derivedFrom,
+            confidenceScore: input.decision.confidenceScore
+        }
+    };
+}
+//# sourceMappingURL=generatePatchPlan.js.map

package/dist/patch-generation/generatePatchPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generatePatchPlan.js","sourceRoot":"","sources":["../../src/patch-generation/generatePatchPlan.ts"],"names":[],"mappings":";;AA8CA,8CA4DC;AA1GD,uEAAsF;AACtF,qEAGkC;AAClC,6DAG8B;AAyB9B,SAAS,yBAAyB,CAAC,IAAkB;IACnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,cAAc;YACjB,OAAO,YAAY,CAAC;QACtB,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAC/B,KAA6B;IAE7B,MAAM,QAAQ,GAAG,yBAAyB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,IAAA,4CAAmB,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;IAE5C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ;YACR,MAAM;YACN,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE;gBACR,MAAM,EAAE,4CAA4C;gBACpD,WAAW;gBACX,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,eAAe;aAChD;SACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ;YACR,MAAM;YACN,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE;gBACR,MAAM,EAAE,0DAA0D;gBAClE,WAAW;gBACX,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,eAAe;aAChD;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,IAAA,oCAAe,EAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;QACvC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ;YACR,MAAM;YACN,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE;gBACR,MAAM,EAAE,6CAA6C,QAAQ,GAAG;gBAChE,WAAW;gBACX,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,eAAe;aAChD;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ;QACR,MAAM;QACN,UAAU,EAAE,IAAA,8CAAoB,EAAC,MAAM,CAAC;QACxC,QAAQ,EAAE;YACR,MAAM,EAAE,6EAA6E;YACrF,WAAW;YACX,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,eAAe;SAChD;KACF,CAAC;AACJ,CAAC"}

package/dist/patch-generation/generatedPatchPlanTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=generatedPatchPlanTypes.js.map

package/dist/patch-generation/generatedPatchPlanTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generatedPatchPlanTypes.js","sourceRoot":"","sources":["../../src/patch-generation/generatedPatchPlanTypes.ts"],"names":[],"mappings":""}

package/dist/patch-generation/isIntentAllowed.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isIntentAllowed = isIntentAllowed;
+const ALLOWED_INTENTS_BY_STRATEGY = {
+    blocked: [],
+    restricted: ["rename_symbol", "add_comment", "safe_replace"],
+    safe: ["rename_symbol", "update_import", "add_comment", "safe_replace"]
+};
+function isIntentAllowed(intent, strategy) {
+    if (intent === "unknown") {
+        return false;
+    }
+    return ALLOWED_INTENTS_BY_STRATEGY[strategy].includes(intent);
+}
+//# sourceMappingURL=isIntentAllowed.js.map

package/dist/patch-generation/isIntentAllowed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isIntentAllowed.js","sourceRoot":"","sources":["../../src/patch-generation/isIntentAllowed.ts"],"names":[],"mappings":";;AAaA,0CASC;AAlBD,MAAM,2BAA2B,GAG7B;IACF,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,CAAC,eAAe,EAAE,aAAa,EAAE,cAAc,CAAC;IAC5D,IAAI,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,CAAC;CACxE,CAAC;AAEF,SAAgB,eAAe,CAC7B,MAAmB,EACnB,QAAiC;IAEjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,2BAA2B,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/dist/patch-generation/renderGeneratedPatchPlan.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderGeneratedPatchPlan = renderGeneratedPatchPlan;
+function renderOperation(operation) {
+    switch (operation.type) {
+        case "safe_replace":
+            return [
+                "- type: safe_replace",
+                `  filePath: ${operation.filePath}`,
+                `  find: ${operation.find}`,
+                `  replaceWith: ${operation.replaceWith}`,
+                `  matchMode: ${operation.matchMode}`
+            ].join("\n");
+        case "rename_symbol":
+            return [
+                "- type: rename_symbol",
+                `  filePath: ${operation.filePath}`,
+                `  from: ${operation.from}`,
+                `  to: ${operation.to}`
+            ].join("\n");
+        case "update_import":
+            return [
+                "- type: update_import",
+                `  filePath: ${operation.filePath}`,
+                `  from: ${operation.from}`,
+                `  to: ${operation.to}`
+            ].join("\n");
+        case "add_comment":
+            return [
+                "- type: add_comment",
+                `  filePath: ${operation.filePath}`,
+                `  comment: ${operation.comment}`,
+                `  target: ${operation.target}`
+            ].join("\n");
+    }
+}
+function renderGeneratedPatchPlan(plan) {
+    const lines = [];
+    lines.push("=== GENERATED PATCH PLAN ===");
+    lines.push(`Intent: ${plan.intent}`);
+    lines.push(`Summary: ${plan.summary}`);
+    lines.push("");
+    if (plan.operations.length === 0) {
+        lines.push("Operations:");
+        lines.push("(none)");
+    }
+    else {
+        lines.push("Operations:");
+        for (const operation of plan.operations) {
+            lines.push(renderOperation(operation));
+        }
+    }
+    if (plan.warnings.length > 0) {
+        lines.push("");
+        lines.push("Warnings:");
+        for (const warning of plan.warnings) {
+            lines.push(`- ${warning}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=renderGeneratedPatchPlan.js.map

package/dist/patch-generation/renderGeneratedPatchPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderGeneratedPatchPlan.js","sourceRoot":"","sources":["../../src/patch-generation/renderGeneratedPatchPlan.ts"],"names":[],"mappings":";;AA0CA,4DA2BC;AAhED,SAAS,eAAe,CAAC,SAAkC;IACzD,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,cAAc;YACjB,OAAO;gBACL,sBAAsB;gBACtB,eAAe,SAAS,CAAC,QAAQ,EAAE;gBACnC,WAAW,SAAS,CAAC,IAAI,EAAE;gBAC3B,kBAAkB,SAAS,CAAC,WAAW,EAAE;gBACzC,gBAAgB,SAAS,CAAC,SAAS,EAAE;aACtC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEf,KAAK,eAAe;YAClB,OAAO;gBACL,uBAAuB;gBACvB,eAAe,SAAS,CAAC,QAAQ,EAAE;gBACnC,WAAW,SAAS,CAAC,IAAI,EAAE;gBAC3B,SAAS,SAAS,CAAC,EAAE,EAAE;aACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEf,KAAK,eAAe;YAClB,OAAO;gBACL,uBAAuB;gBACvB,eAAe,SAAS,CAAC,QAAQ,EAAE;gBACnC,WAAW,SAAS,CAAC,IAAI,EAAE;gBAC3B,SAAS,SAAS,CAAC,EAAE,EAAE;aACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEf,KAAK,aAAa;YAChB,OAAO;gBACL,qBAAqB;gBACrB,eAAe,SAAS,CAAC,QAAQ,EAAE;gBACnC,cAAc,SAAS,CAAC,OAAO,EAAE;gBACjC,aAAa,SAAS,CAAC,MAAM,EAAE;aAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAgB,wBAAwB,CAAC,IAAwB;IAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}