zone-ai-agent 0.4.0

package/dist/core/buildTaskExecutionContext.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTaskKeywords = buildTaskKeywords;
+exports.buildContextBlocksFromFiles = buildContextBlocksFromFiles;
+exports.buildExecutionContext = buildExecutionContext;
+const taskIntentParser_1 = require("./taskIntentParser");
+const selectRelevantBlocks_1 = require("./selectRelevantBlocks");
+const patchRiskAnalyzer_1 = require("./patchRiskAnalyzer");
+const validateSuggestedArchitecture_1 = require("./validateSuggestedArchitecture");
+const loadSchemaSnapshot_js_1 = require("../repo/loadSchemaSnapshot.js");
+const analyzeProjectPatterns_js_1 = require("../repo/analyzeProjectPatterns.js");
+const detectResourceStorage_js_1 = require("./detectResourceStorage.js");
+const buildSchemaAwareContext_js_1 = require("./buildSchemaAwareContext.js");
+function buildTaskKeywords(task, extra = []) {
+    return Array.from(new Set(task
+        .toLowerCase()
+        .split(/[^a-z0-9_]+/i)
+        .filter(Boolean)
+        .concat(extra.filter(Boolean))));
+}
+function buildContextBlocksFromFiles(files, keywords) {
+    return files.flatMap((file) => (0, selectRelevantBlocks_1.selectRelevantBlocks)({
+        filePath: file.path,
+        content: file.content,
+        keywords,
+        maxBlocks: 3
+    }));
+}
+async function buildExecutionContext(input) {
+    const intent = (0, taskIntentParser_1.parseTaskIntent)(input.task);
+    const keywords = buildTaskKeywords(input.task, [
+        intent.parentResource ?? "",
+        intent.nestedResource ?? "",
+        ...intent.paramHints
+    ]);
+    const contextBlocks = buildContextBlocksFromFiles(input.candidateFiles, keywords);
+    const architectureValidation = (0, validateSuggestedArchitecture_1.validateSuggestedArchitecture)(intent, input.suggestedFiles);
+    const patchRisk = input.patchPreview
+        ? (0, patchRiskAnalyzer_1.analyzePatchRisk)(intent, input.patchPreview)
+        : { warnings: [], isHighRisk: false };
+    const schemaSnapshot = await (0, loadSchemaSnapshot_js_1.loadSchemaSnapshot)(input.projectRoot);
+    const projectPatternAnalysis = (0, analyzeProjectPatterns_js_1.analyzeProjectPatterns)(input.candidateFiles);
+    const resourceStorageInsight = intent.parentResource
+        ? (0, detectResourceStorage_js_1.detectResourceStorage)({
+            parentResource: intent.parentResource,
+            nestedResource: intent.nestedResource,
+            files: input.candidateFiles,
+            schema: schemaSnapshot
+        })
+        : null;
+    const schemaAwareContext = (0, buildSchemaAwareContext_js_1.buildSchemaAwareContext)({
+        intent,
+        schema: schemaSnapshot,
+        projectPatterns: projectPatternAnalysis,
+        storageInsight: resourceStorageInsight
+    });
+    return {
+        intent,
+        keywords,
+        contextBlocks,
+        architectureWarnings: architectureValidation.warnings,
+        patchRiskWarnings: patchRisk.warnings,
+        isHighRisk: patchRisk.isHighRisk,
+        schemaSnapshot,
+        projectPatternAnalysis,
+        resourceStorageInsight,
+        schemaAwareSummary: schemaAwareContext.summaryLines
+    };
+}
+//# sourceMappingURL=buildTaskExecutionContext.js.map

package/dist/core/buildTaskExecutionContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTaskExecutionContext.js","sourceRoot":"","sources":["../../src/core/buildTaskExecutionContext.ts"],"names":[],"mappings":";;AASA,8CAUC;AAED,kEAYC;AAED,sDA2DC;AA9FD,yDAAqD;AACrD,iEAA8D;AAC9D,2DAAuD;AACvD,mFAAgF;AAChF,yEAAmE;AACnE,iFAA2E;AAC3E,yEAAmE;AACnE,6EAAuE;AAEvE,SAAgB,iBAAiB,CAAC,IAAY,EAAE,QAAkB,EAAE;IAClE,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CACL,IAAI;SACD,WAAW,EAAE;SACb,KAAK,CAAC,cAAc,CAAC;SACrB,MAAM,CAAC,OAAO,CAAC;SACf,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CACjC,CACF,CAAC;AACJ,CAAC;AAED,SAAgB,2BAA2B,CACzC,KAA+C,EAC/C,QAAkB;IAElB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5B,IAAA,2CAAoB,EAAC;QACnB,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ;QACR,SAAS,EAAE,CAAC;KACb,CAAC,CACH,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,qBAAqB,CAAC,KAM3C;IACC,MAAM,MAAM,GAAG,IAAA,kCAAe,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE3C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE;QAC7C,MAAM,CAAC,cAAc,IAAI,EAAE;QAC3B,MAAM,CAAC,cAAc,IAAI,EAAE;QAC3B,GAAG,MAAM,CAAC,UAAU;KACrB,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,2BAA2B,CAAC,KAAK,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAElF,MAAM,sBAAsB,GAAG,IAAA,6DAA6B,EAC1D,MAAM,EACN,KAAK,CAAC,cAAc,CACrB,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY;QAClC,CAAC,CAAC,IAAA,oCAAgB,EAAC,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC;QAC9C,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAExC,MAAM,cAAc,GAAG,MAAM,IAAA,0CAAkB,EAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAEnE,MAAM,sBAAsB,GAAG,IAAA,kDAAsB,EAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAE5E,MAAM,sBAAsB,GAAG,MAAM,CAAC,cAAc;QAClD,CAAC,CAAC,IAAA,gDAAqB,EAAC;YACpB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,KAAK,EAAE,KAAK,CAAC,cAAc;YAC3B,MAAM,EAAE,cAAc;SACvB,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,kBAAkB,GAAG,IAAA,oDAAuB,EAAC;QACjD,MAAM;QACN,MAAM,EAAE,cAAc;QACtB,eAAe,EAAE,sBAAsB;QACvC,cAAc,EAAE,sBAAsB;KACvC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,QAAQ;QACR,aAAa;QACb,oBAAoB,EAAE,sBAAsB,CAAC,QAAQ;QACrD,iBAAiB,EAAE,SAAS,CAAC,QAAQ;QACrC,UAAU,EAAE,SAAS,CAAC,UAAU;QAEhC,cAAc;QACd,sBAAsB;QACtB,sBAAsB;QACtB,kBAAkB,EAAE,kBAAkB,CAAC,YAAY;KACpD,CAAC;AACJ,CAAC"}

package/dist/core/ciEvaluator.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateFeatureAgentForCi = evaluateFeatureAgentForCi;
+exports.printCiAnnotations = printCiAnnotations;
+function formatIssue(issue) {
+    const filePart = issue.file ? ` [${issue.file}]` : "";
+    return `[${issue.severity}] ${issue.message}${filePart}`;
+}
+function collectTopAnnotations(result) {
+    const annotations = [];
+    for (const issue of result.patchValidationIssues.slice(0, 3)) {
+        annotations.push(formatIssue(issue));
+    }
+    for (const issue of result.schemaPatchWarnings.slice(0, 3)) {
+        annotations.push(formatIssue(issue));
+    }
+    for (const warning of result.patchRiskWarnings.slice(0, 2)) {
+        annotations.push(warning);
+    }
+    for (const warning of result.architectureWarnings.slice(0, 2)) {
+        annotations.push(warning);
+    }
+    const missingFiles = result.validatedSuggestedFiles
+        .filter((file) => file.status === "missing")
+        .slice(0, 2)
+        .map((file) => `Missing suggested file: ${file.originalPath}`);
+    annotations.push(...missingFiles);
+    return [...new Set(annotations)];
+}
+function buildSummary(result) {
+    return [
+        `decision=${result.decision.mode}`,
+        `confidence=${result.confidence.finalScore}`,
+        `patches=${result.patchPlan.patches.length}`,
+        `warnings=${collectTopAnnotations(result).length}`,
+        `relevant=${result.relevantFiles.length}`,
+        `suggested=${result.validatedSuggestedFiles.length}`
+    ].join(" | ");
+}
+function evaluateFeatureAgentForCi(result) {
+    const annotations = collectTopAnnotations(result);
+    const summary = buildSummary(result);
+    if (result.decision.mode === "blocked") {
+        return {
+            outcome: "fail",
+            exitCode: 1,
+            shouldFail: true,
+            title: "Feature agent blocked",
+            summary,
+            annotations
+        };
+    }
+    if (result.decision.mode === "preview_only") {
+        return {
+            outcome: "warn",
+            exitCode: 0,
+            shouldFail: false,
+            title: "Feature agent requires review",
+            summary,
+            annotations
+        };
+    }
+    return {
+        outcome: "pass",
+        exitCode: 0,
+        shouldFail: false,
+        title: "Feature agent approved",
+        summary,
+        annotations
+    };
+}
+function printCiAnnotations(evaluation) {
+    const prefix = evaluation.outcome === "fail"
+        ? "::error::"
+        : evaluation.outcome === "warn"
+            ? "::warning::"
+            : "::notice::";
+    console.log(`${prefix}${evaluation.title} | ${evaluation.summary}`);
+    for (const annotation of evaluation.annotations) {
+        console.log(`${prefix}${annotation}`);
+    }
+}
+//# sourceMappingURL=ciEvaluator.js.map

package/dist/core/ciEvaluator.js.map

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

package/dist/core/computeRiskScore.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeRiskScore = computeRiskScore;
+const computeRiskScoreDetails_js_1 = require("./computeRiskScoreDetails.js");
+function computeRiskScore(input) {
+    const task = typeof input === "string" ? input : input.task;
+    const role = typeof input === "string" ? undefined : input.role;
+    const details = (0, computeRiskScoreDetails_js_1.computeRiskScoreDetails)({ task });
+    // Role-aware schema penalty adjustment:
+    // test_engineer: writing tests is not a schema risk
+    // data_analyst: schema changes are expected, handled separately
+    const schemaScore = role === "test_engineer" || role === "data_analyst" || role === "developer"
+        ? 0
+        : details.riskBreakdown.schema;
+    const signals = [];
+    if (details.riskBreakdown.destructive > 0)
+        signals.push("destructive");
+    if (schemaScore > 0)
+        signals.push("schema");
+    if (details.riskBreakdown.critical > 0)
+        signals.push("critical_domain");
+    if (details.riskBreakdown.lowRisk < 0)
+        signals.push("low_risk");
+    if (details.riskBreakdown.massScope > 0)
+        signals.push("mass_scope");
+    const adjustedScore = Math.max(0, Math.min(100, details.riskBreakdown.destructive +
+        schemaScore +
+        details.riskBreakdown.critical +
+        details.riskBreakdown.lowRisk +
+        details.riskBreakdown.massScope));
+    return {
+        score: adjustedScore,
+        signals,
+        breakdown: {
+            destructive: details.riskBreakdown.destructive,
+            schema: schemaScore,
+            critical: details.riskBreakdown.critical,
+            lowRisk: details.riskBreakdown.lowRisk,
+            massScope: details.riskBreakdown.massScope,
+        },
+    };
+}
+//# sourceMappingURL=computeRiskScore.js.map

package/dist/core/computeRiskScore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeRiskScore.js","sourceRoot":"","sources":["../../src/core/computeRiskScore.ts"],"names":[],"mappings":";;AA0BA,4CA+CC;AAzED,6EAAuE;AA0BvE,SAAgB,gBAAgB,CAC9B,KAAqC;IAErC,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAC5D,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAEhE,MAAM,OAAO,GAAG,IAAA,oDAAuB,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,wCAAwC;IACxC,oDAAoD;IACpD,gEAAgE;IAClE,MAAM,WAAW,GACf,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW;QACzE,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC;IAEjC,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,IAAI,OAAO,CAAC,aAAa,CAAC,WAAW,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACvE,IAAI,WAAW,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,aAAa,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxE,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,aAAa,CAAC,SAAS,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAEpE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,CAAC,EACD,IAAI,CAAC,GAAG,CACN,GAAG,EACH,OAAO,CAAC,aAAa,CAAC,WAAW;QAC/B,WAAW;QACX,OAAO,CAAC,aAAa,CAAC,QAAQ;QAC9B,OAAO,CAAC,aAAa,CAAC,OAAO;QAC7B,OAAO,CAAC,aAAa,CAAC,SAAS,CAClC,CACF,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,aAAa;QACpB,OAAO;QACP,SAAS,EAAE;YACT,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,WAAW;YAC9C,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,QAAQ;YACxC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO;YACtC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,SAAS;SAC3C;KACF,CAAC;AACJ,CAAC"}

package/dist/core/computeRiskScoreDetails.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeRiskScoreDetails = computeRiskScoreDetails;
+function clampScore(value) {
+    if (value < 0)
+        return 0;
+    if (value > 100)
+        return 100;
+    return value;
+}
+function includesAny(text, keywords) {
+    return keywords.some((keyword) => text.includes(keyword));
+}
+function computeRiskScoreDetails(input) {
+    const normalizedTask = input.task.trim().toLowerCase();
+    const hasDestructiveSignal = includesAny(normalizedTask, [
+        "delete",
+        "drop",
+        "remove",
+        "destroy",
+        "truncate"
+    ]);
+    const hasSchemaSignal = includesAny(normalizedTask, [
+        "schema",
+        "migration",
+        "migrate",
+        "database",
+        "db",
+        "column",
+        "columns",
+        "table",
+        "tables",
+        "field",
+        "fields",
+        "model",
+        "models"
+    ]);
+    const hasCriticalSignal = includesAny(normalizedTask, [
+        "auth",
+        "authentication",
+        "authorization",
+        "billing",
+        "payment",
+        "payments",
+        "permission",
+        "permissions",
+        "security",
+        "jwt",
+        "token",
+        "production"
+    ]);
+    const hasLowRiskSignal = includesAny(normalizedTask, [
+        "copy",
+        "text",
+        "rename",
+        "comment",
+        "docs",
+        "readme"
+    ]);
+    const hasMassScopeSignal = includesAny(normalizedTask, [
+        "delete all",
+        "drop all",
+        "remove all",
+        "truncate",
+        "wipe",
+        "purge",
+        "flush",
+        "delete everything",
+        "delete every"
+    ]);
+    const riskBreakdown = {
+        destructive: hasDestructiveSignal ? 50 : 0,
+        schema: hasSchemaSignal ? 25 : 0,
+        critical: hasCriticalSignal ? 20 : 0,
+        lowRisk: hasLowRiskSignal ? -20 : 0,
+        massScope: hasMassScopeSignal ? 25 : 0
+    };
+    const rawScore = riskBreakdown.destructive +
+        riskBreakdown.schema +
+        riskBreakdown.critical +
+        riskBreakdown.lowRisk +
+        riskBreakdown.massScope;
+    const riskScore = clampScore(rawScore);
+    const detectedSignals = [];
+    if (hasDestructiveSignal) {
+        detectedSignals.push("destructive");
+    }
+    if (hasSchemaSignal) {
+        detectedSignals.push("schema_change");
+    }
+    if (hasCriticalSignal) {
+        detectedSignals.push("critical_domain");
+    }
+    if (hasLowRiskSignal) {
+        detectedSignals.push("low_risk");
+    }
+    if (hasMassScopeSignal) {
+        detectedSignals.push("mass_scope");
+    }
+    return {
+        riskScore,
+        riskBreakdown,
+        detectedSignals
+    };
+}
+//# sourceMappingURL=computeRiskScoreDetails.js.map

package/dist/core/computeRiskScoreDetails.js.map

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

package/dist/core/confidenceGate.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkConfidenceGate = checkConfidenceGate;
+exports.renderConfidenceGateBlock = renderConfidenceGateBlock;
+const THRESHOLDS = {
+    developer: 60,
+    test_engineer: 50,
+    data_analyst: 70,
+    default: 60,
+};
+const ROLE_RISK_DESCRIPTIONS = {
+    developer: [
+        "Low confidence may indicate unclear task scope",
+        "Existing code patterns may not be well understood",
+        "Generated code may not follow project conventions",
+    ],
+    test_engineer: [
+        "Test framework may not be fully detected",
+        "Page object method names may be inaccurate",
+        "Test file paths may not match project structure",
+    ],
+    data_analyst: [
+        "Schema changes are irreversible without a backup",
+        "Column types may not match existing data",
+        "Foreign key constraints may be violated",
+    ],
+};
+function getThreshold(role) {
+    if (!role)
+        return THRESHOLDS.default;
+    return THRESHOLDS[role] ?? THRESHOLDS.default;
+}
+function getRisks(role, warnings) {
+    const roleRisks = ROLE_RISK_DESCRIPTIONS[role ?? "developer"] ??
+        ROLE_RISK_DESCRIPTIONS["developer"];
+    const warningRisks = (warnings ?? [])
+        .filter(Boolean)
+        .map(w => `Warning: ${w}`);
+    return [...roleRisks, ...warningRisks];
+}
+function getRecommendation(confidenceScore, threshold, role) {
+    const gap = threshold - confidenceScore;
+    if (gap > 30) {
+        return "Confidence is too low to proceed safely. " +
+            "Provide more context in your task description, " +
+            "or manually specify the target files.";
+    }
+    if (role === "test_engineer") {
+        return "Review the detected framework and page objects before applying. " +
+            "Consider running with --verbose to see what was detected.";
+    }
+    if (role === "data_analyst") {
+        return "Review the generated SQL carefully before applying. " +
+            "Ensure a database backup exists before running migrations.";
+    }
+    return "Review the patch preview carefully before applying. " +
+        "Consider using --format detailed to see full output.";
+}
+function checkConfidenceGate(input) {
+    const threshold = getThreshold(input.role);
+    if (input.confidenceScore >= threshold) {
+        return { pass: true };
+    }
+    return {
+        pass: false,
+        reason: `Confidence score ${input.confidenceScore} is below the ${input.role ?? "default"} threshold of ${threshold}.`,
+        risks: getRisks(input.role, input.warnings),
+        recommendation: getRecommendation(input.confidenceScore, threshold, input.role),
+    };
+}
+function renderConfidenceGateBlock(result) {
+    const lines = [];
+    lines.push("=== CONFIDENCE GATE ===");
+    lines.push(`Status: BLOCKED`);
+    lines.push(`Reason: ${result.reason}`);
+    lines.push("");
+    lines.push("Risks:");
+    result.risks.forEach(r => lines.push(`- ${r}`));
+    lines.push("");
+    lines.push(`Recommendation: ${result.recommendation}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=confidenceGate.js.map

package/dist/core/confidenceGate.js.map

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

package/dist/core/decision/buildDecisionExplanation.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDecisionExplanation = buildDecisionExplanation;
+const buildReasonSummaryLine_js_1 = require("./buildReasonSummaryLine.js");
+function countReasonsBySeverity(reasons) {
+    return reasons.reduce((acc, reason) => {
+        if (reason.severity === "critical")
+            acc.critical += 1;
+        else if (reason.severity === "warning")
+            acc.warning += 1;
+        else
+            acc.info += 1;
+        return acc;
+    }, { critical: 0, warning: 0, info: 0 });
+}
+function countSeriousRisks(topRisks) {
+    if (!topRisks || topRisks.length === 0) {
+        return 0;
+    }
+    return topRisks.filter((risk) => risk.severity === "high" || risk.severity === "medium").length;
+}
+function buildModeLead(result) {
+    switch (result.mode) {
+        case "blocked":
+            return "Decision was set to BLOCKED because blocking validation signals were detected.";
+        case "preview_only":
+            return "Decision was set to PREVIEW ONLY because manual review is still required.";
+        case "safe_to_apply":
+            return "Decision was set to SAFE TO APPLY because no blocking execution risks were detected.";
+    }
+}
+function buildReasonSummary(result) {
+    const counts = countReasonsBySeverity(result.reasons);
+    const lines = [];
+    if (counts.critical > 0) {
+        lines.push(`- ${counts.critical} critical reason(s) affected the decision`);
+    }
+    if (counts.warning > 0) {
+        lines.push(`- ${counts.warning} warning-level reason(s) affected the decision`);
+    }
+    if (counts.info > 0 && result.mode === "safe_to_apply") {
+        lines.push(`- ${counts.info} informational confirmation reason(s) were recorded`);
+    }
+    const seriousRiskCount = countSeriousRisks(result.topRisks);
+    if (seriousRiskCount > 0) {
+        lines.push(`- ${seriousRiskCount} medium/high top risk(s) remain visible in the result`);
+    }
+    return lines;
+}
+function buildClosingLine(result) {
+    switch (result.mode) {
+        case "blocked":
+            return "Automatic apply is not recommended until blocking issues are resolved.";
+        case "preview_only":
+            return "Automatic apply is not recommended until review is completed.";
+        case "safe_to_apply":
+            return "Automatic apply can proceed under the current safeguards.";
+    }
+}
+function assertReasonCodeParity(reasons, reasonCodes) {
+    if (!reasonCodes || reasonCodes.length === 0) {
+        return;
+    }
+    const reasonSequence = reasons.map((reason) => String(reason.code));
+    let searchStartIndex = 0;
+    for (const code of reasonCodes) {
+        const matchedIndex = reasonSequence.indexOf(String(code), searchStartIndex);
+        if (matchedIndex === -1) {
+            throw new Error("DECISION_EXPLANATION_REASON_MISMATCH");
+        }
+        searchStartIndex = matchedIndex + 1;
+    }
+}
+function buildDecisionExplanation(result, options = {}) {
+    assertReasonCodeParity(result.reasons, options.reasonCodes);
+    const lines = [];
+    lines.push(buildModeLead(result));
+    if (options.reasonCodes && options.reasonCodes.length > 0) {
+        lines.push("");
+        lines.push((0, buildReasonSummaryLine_js_1.buildReasonSummaryLine)(options.reasonCodes));
+    }
+    const summaryLines = buildReasonSummary(result);
+    if (summaryLines.length > 0) {
+        lines.push("");
+        lines.push(...summaryLines);
+    }
+    lines.push("");
+    lines.push(buildClosingLine(result));
+    return lines.join("\n");
+}
+//# sourceMappingURL=buildDecisionExplanation.js.map

package/dist/core/decision/buildDecisionExplanation.js.map

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

package/dist/core/decision/buildDecisionReasonCodes.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDecisionReasonCodes = buildDecisionReasonCodes;
+const REASON_CODE_PRIORITY = [
+    "BLOCKED_DESTRUCTIVE_OPERATION",
+    "BLOCKED_SCHEMA_RISK",
+    "BLOCKED_CRITICAL_RISK",
+    "BLOCKED_HIGH_RISK_SCORE",
+    "PREVIEW_DESTRUCTIVE_SIGNAL",
+    "PREVIEW_SCHEMA_UNCERTAINTY",
+    "PREVIEW_CRITICAL_SIGNAL",
+    "PREVIEW_MASS_SCOPE_CHANGE",
+    "PREVIEW_LOW_CONFIDENCE",
+    "SAFE_LOW_RISK_LOCALIZED",
+    "SAFE_HIGH_CONFIDENCE"
+];
+function getReasonCodePriority(code) {
+    const index = REASON_CODE_PRIORITY.indexOf(code);
+    return index === -1 ? Number.MAX_SAFE_INTEGER : index;
+}
+function buildDecisionReasonCodes(input) {
+    const codes = new Set();
+    const signalTypes = new Set(input.normalizedSignals.map((signal) => signal.type));
+    if (input.mode === "blocked") {
+        if (signalTypes.has("destructive")) {
+            codes.add("BLOCKED_DESTRUCTIVE_OPERATION");
+        }
+        if (signalTypes.has("schema")) {
+            codes.add("BLOCKED_SCHEMA_RISK");
+        }
+        if (signalTypes.has("critical")) {
+            codes.add("BLOCKED_CRITICAL_RISK");
+        }
+        if (input.riskScore >= 70) {
+            codes.add("BLOCKED_HIGH_RISK_SCORE");
+        }
+    }
+    if (input.mode === "preview_only") {
+        if (signalTypes.has("destructive")) {
+            codes.add("PREVIEW_DESTRUCTIVE_SIGNAL");
+        }
+        if (signalTypes.has("schema")) {
+            codes.add("PREVIEW_SCHEMA_UNCERTAINTY");
+        }
+        if (signalTypes.has("critical")) {
+            codes.add("PREVIEW_CRITICAL_SIGNAL");
+        }
+        if (signalTypes.has("massScope")) {
+            codes.add("PREVIEW_MASS_SCOPE_CHANGE");
+        }
+        if (input.confidenceScore < 70) {
+            codes.add("PREVIEW_LOW_CONFIDENCE");
+        }
+    }
+    if (input.mode === "safe_to_apply") {
+        if (signalTypes.has("lowRisk")) {
+            codes.add("SAFE_LOW_RISK_LOCALIZED");
+        }
+        if (input.confidenceScore >= 80) {
+            codes.add("SAFE_HIGH_CONFIDENCE");
+        }
+    }
+    return [...codes].sort((left, right) => getReasonCodePriority(left) - getReasonCodePriority(right));
+}
+//# sourceMappingURL=buildDecisionReasonCodes.js.map

package/dist/core/decision/buildDecisionReasonCodes.js.map

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

package/dist/core/decision/buildReasonSummaryLine.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildReasonSummaryLine = buildReasonSummaryLine;
+const decisionReasonCodeMeta_js_1 = require("./decisionReasonCodeMeta.js");
+function buildReasonSummaryLine(reasonCodes) {
+    const uniqueCodes = [...new Set(reasonCodes)];
+    if (uniqueCodes.length === 0) {
+        return "Why: no explicit decision reasons.";
+    }
+    const details = (0, decisionReasonCodeMeta_js_1.buildDecisionReasonDetails)([...uniqueCodes]).filter((detail) => Boolean(detail));
+    if (details.length === 0) {
+        return "Why: no explicit decision reasons.";
+    }
+    const summaries = details.map((detail) => normalizeSummary(detail.summary));
+    return `Why: ${summaries.join("; ")}.`;
+}
+function normalizeSummary(summary) {
+    const trimmed = summary.trim();
+    if (trimmed.length === 0) {
+        return "unspecified reason";
+    }
+    return trimmed.endsWith(".") ? trimmed.slice(0, -1) : trimmed;
+}
+//# sourceMappingURL=buildReasonSummaryLine.js.map

package/dist/core/decision/buildReasonSummaryLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildReasonSummaryLine.js","sourceRoot":"","sources":["../../../src/core/decision/buildReasonSummaryLine.ts"],"names":[],"mappings":";;AAKA,wDAmBC;AAxBD,2EAGqC;AAErC,SAAgB,sBAAsB,CACpC,WAA0C;IAE1C,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IAE9C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,oCAAoC,CAAC;IAC9C,CAAC;IAEF,MAAM,OAAO,GAAG,IAAA,sDAA0B,EAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAClE,CAAC,MAAM,EAAiD,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAC3E,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,oCAAoC,CAAC;IAC9C,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,OAAO,QAAQ,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACzC,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAE/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAChE,CAAC"}