zone-ai-agent 0.4.0

package/dist/core/result/scoreTopRisks.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreTopRisks = scoreTopRisks;
+function clampScore(value) {
+    return Math.max(0, Math.min(100, Math.round(value)));
+}
+function toSeverity(score) {
+    if (score >= 80)
+        return "high";
+    if (score >= 50)
+        return "medium";
+    return "low";
+}
+function severityRank(severity) {
+    switch (severity) {
+        case "high":
+            return 3;
+        case "medium":
+            return 2;
+        case "low":
+            return 1;
+        default:
+            return 0;
+    }
+}
+function normalizeCategory(issue) {
+    if (issue.code.startsWith("SCHEMA_") || issue.code.startsWith("schema_")) {
+        return "schema";
+    }
+    if (issue.code.startsWith("ARCH_") ||
+        issue.code.startsWith("arch_") ||
+        issue.code === "ARCHITECTURE_WARNING") {
+        return "architecture";
+    }
+    if (issue.code.startsWith("CONFIDENCE_") || issue.code.startsWith("confidence_")) {
+        return "confidence";
+    }
+    if (issue.code.includes("PATCH") ||
+        issue.code === "PATH_TRAVERSAL" ||
+        issue.code === "PROTECTED_FILE" ||
+        issue.code === "DUPLICATE_TARGET") {
+        return "patch";
+    }
+    // Fallback: issue.source alanını kullan (özellikle custom kod'lar için)
+    if (issue.source === "schema")
+        return "schema";
+    if (issue.source === "architecture")
+        return "architecture";
+    if (issue.source === "confidence")
+        return "confidence";
+    if (issue.source === "patch")
+        return "patch";
+    return "validation";
+}
+function buildRisk(input) {
+    const score = clampScore(input.score);
+    return {
+        id: input.id,
+        title: input.title,
+        description: input.description,
+        score,
+        severity: toSeverity(score),
+        category: input.category,
+        source: input.source,
+        relatedCode: input.relatedCode
+    };
+}
+function scoreFromIssue(issue) {
+    switch (issue.code) {
+        case "PATH_TRAVERSAL":
+            return 100;
+        case "PROTECTED_FILE":
+            return 95;
+        case "SCHEMA_INVALID":
+            return 90;
+        case "DUPLICATE_TARGET":
+            return 72;
+        case "AMBIGUOUS_TARGET":
+            return 60;
+        case "PATCH_RISK_WARNING":
+            return 54;
+        case "ARCHITECTURE_WARNING":
+            return 55;
+        default:
+            if (issue.severity === "error")
+                return 78;
+            if (issue.severity === "warning")
+                return 52;
+            return 28;
+    }
+}
+function titleFromIssue(issue) {
+    switch (issue.code) {
+        case "PATH_TRAVERSAL":
+            return "Path traversal riski";
+        case "PROTECTED_FILE":
+            return "Protected file değişikliği";
+        case "SCHEMA_INVALID":
+            return "Schema mismatch riski";
+        case "DUPLICATE_TARGET":
+            return "Çakışan patch hedefleri";
+        case "AMBIGUOUS_TARGET":
+            return "Belirsiz dosya hedefi";
+        case "PATCH_RISK_WARNING":
+            return "Patch riski";
+        case "ARCHITECTURE_WARNING":
+            return "Mimari uyum riski";
+        default:
+            return issue.message;
+    }
+}
+function normalizeDetails(details) {
+    if (Array.isArray(details)) {
+        return details.join("; ");
+    }
+    return details;
+}
+function descriptionFromIssue(issue) {
+    switch (issue.code) {
+        case "PATH_TRAVERSAL":
+            return "Patch hedef yolu repo dışına çıkabilir ve beklenmeyen dosyaları etkileyebilir.";
+        case "PROTECTED_FILE":
+            return "Korunan dosyaların değiştirilmesi güvenlik veya kritik sistem davranışını bozabilir.";
+        case "SCHEMA_INVALID":
+            return "Patch çıktısı beklenen şemayla uyumlu değil; runtime veya apply aşaması kırılabilir.";
+        case "DUPLICATE_TARGET":
+            return "Aynı hedef üzerinde birden fazla patch çakışabilir ve beklenmeyen sonuç üretebilir.";
+        case "AMBIGUOUS_TARGET":
+            return "Değişikliğin uygulanacağı gerçek dosya net değil; yanlış hedef etkilenebilir.";
+        case "PATCH_RISK_WARNING":
+            return issue.message;
+        case "ARCHITECTURE_WARNING":
+            return issue.message;
+        default:
+            return normalizeDetails(issue.details) ?? "Validation aşamasında tespit edilen bir risk.";
+    }
+}
+function mapIssueToRisk(issue) {
+    return buildRisk({
+        id: `issue:${issue.code.toLowerCase()}`,
+        title: titleFromIssue(issue),
+        description: descriptionFromIssue(issue),
+        score: scoreFromIssue(issue),
+        category: normalizeCategory(issue),
+        source: "validation_issue",
+        relatedCode: issue.code
+    });
+}
+function mapDecisionToRisk(mode) {
+    switch (mode) {
+        case "blocked":
+            return buildRisk({
+                id: "decision:blocked",
+                title: "Uygulama engellendi",
+                description: "Sistem kritik riskler nedeniyle patch uygulamasını durdurdu.",
+                score: 92,
+                category: "validation",
+                source: "decision",
+                relatedCode: "blocked"
+            });
+        case "preview_only":
+            return buildRisk({
+                id: "decision:preview_only",
+                title: "Sadece preview güvenli",
+                description: "Sistem otomatik uygulama yerine manuel inceleme öneriyor.",
+                score: 57,
+                category: "validation",
+                source: "decision",
+                relatedCode: "preview_only"
+            });
+        case "safe_to_apply":
+            return null;
+    }
+}
+function dedupeRisks(risks) {
+    const byId = new Map();
+    for (const risk of risks) {
+        const existing = byId.get(risk.id);
+        if (!existing || risk.score > existing.score) {
+            byId.set(risk.id, risk);
+        }
+    }
+    return Array.from(byId.values());
+}
+function sortRisks(risks) {
+    return [...risks].sort((a, b) => {
+        if (b.score !== a.score) {
+            return b.score - a.score;
+        }
+        const severityDiff = severityRank(b.severity) - severityRank(a.severity);
+        if (severityDiff !== 0) {
+            return severityDiff;
+        }
+        return a.title.localeCompare(b.title, "tr");
+    });
+}
+function scoreTopRisks(input) {
+    const risks = input.issues.map(mapIssueToRisk);
+    const decisionRisk = mapDecisionToRisk(input.decisionMode);
+    if (decisionRisk) {
+        risks.push(decisionRisk);
+    }
+    return sortRisks(dedupeRisks(risks)).slice(0, input.limit ?? 5);
+}
+//# sourceMappingURL=scoreTopRisks.js.map

package/dist/core/result/scoreTopRisks.js.map

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

package/dist/core/runAgent.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTopRisks = buildTopRisks;
+exports.runAgent = runAgent;
+exports.buildPrimaryCause = buildPrimaryCause;
+exports.buildConfidenceImpactLine = buildConfidenceImpactLine;
+const computeRiskScore_js_1 = require("./computeRiskScore.js");
+const normalizeSignals_js_1 = require("./normalizeSignals.js");
+const computeConfidenceScore_js_1 = require("./scoring/computeConfidenceScore.js");
+const buildDecisionTrace_js_1 = require("./buildDecisionTrace.js");
+const buildDecisionReasonCodes_js_1 = require("./decision/buildDecisionReasonCodes.js");
+const buildDecisionExplanation_js_1 = require("./decision/buildDecisionExplanation.js");
+const decisionReasonCodeMeta_js_1 = require("./decision/decisionReasonCodeMeta.js");
+function mapScoreToMode(score, signals) {
+    if (score >= 71) {
+        return "blocked";
+    }
+    if (score >= 31 ||
+        signals.includes("schema") ||
+        signals.includes("critical_domain") ||
+        signals.includes("mass_scope")) {
+        return "preview_only";
+    }
+    return "safe_to_apply";
+}
+function toRiskSeverity(value) {
+    if (value === "low" || value === "medium" || value === "high") {
+        return value;
+    }
+    return "medium";
+}
+function buildRecommendation(mode) {
+    switch (mode) {
+        case "blocked":
+            return "Do not auto-apply. Manual review is required before making changes.";
+        case "preview_only":
+            return "Preview the patch and verify the affected scope before any apply step.";
+        case "safe_to_apply":
+        default:
+            return "Patch can be applied automatically under current safeguards.";
+    }
+}
+function mapNormalizedSignalTypeForReasonCodes(type) {
+    switch (type) {
+        case "destructive":
+            return "destructive";
+        case "schema":
+            return "schema";
+        case "critical_domain":
+            return "critical";
+        case "low_risk":
+            return "lowRisk";
+        case "mass_scope":
+            return "massScope";
+        default:
+            return null;
+    }
+}
+function mapReasonSeverityForExplanation(severity) {
+    switch (severity) {
+        case "high":
+            return "critical";
+        case "medium":
+            return "warning";
+        case "low":
+        default:
+            return "info";
+    }
+}
+function buildTopRisks(_score, signals) {
+    const normalized = (0, normalizeSignals_js_1.normalizeSignals)(signals);
+    const risks = [];
+    for (const signal of normalized) {
+        if (signal.type === "destructive") {
+            risks.push({
+                title: signal.label,
+                severity: toRiskSeverity(signal.severity),
+                reason: "Task contains destructive keywords that may cause irreversible data loss."
+            });
+        }
+        if (signal.type === "schema") {
+            risks.push({
+                title: signal.label,
+                severity: toRiskSeverity(signal.severity),
+                reason: "Schema modifications can break existing data contracts or migrations."
+            });
+        }
+        if (signal.type === "critical_domain") {
+            risks.push({
+                title: signal.label,
+                severity: toRiskSeverity(signal.severity),
+                reason: "Touches auth, billing, or production — elevated impact if change is incorrect."
+            });
+        }
+        if (signal.type === "mass_scope") {
+            risks.push({
+                title: signal.label,
+                severity: toRiskSeverity(signal.severity),
+                reason: "Task targets all records or the entire dataset — bulk operations are irreversible."
+            });
+        }
+    }
+    return risks;
+}
+async function runAgent(input) {
+    const normalizedTask = input.task.trim();
+    const { score, signals, breakdown } = (0, computeRiskScore_js_1.computeRiskScore)({
+        task: normalizedTask,
+        role: input.role,
+    });
+    const mode = mapScoreToMode(score, signals);
+    const confidence = (0, computeConfidenceScore_js_1.computeConfidenceScore)({ breakdown });
+    const reasonCodes = (0, buildDecisionReasonCodes_js_1.buildDecisionReasonCodes)({
+        mode,
+        riskScore: score,
+        confidenceScore: confidence.score,
+        normalizedSignals: (0, normalizeSignals_js_1.normalizeSignals)(signals)
+            .map((signal) => mapNormalizedSignalTypeForReasonCodes(signal.type))
+            .filter((type) => type !== null)
+            .map((type) => ({ type }))
+    });
+    const reasonDetails = (0, decisionReasonCodeMeta_js_1.buildDecisionReasonDetails)(reasonCodes);
+    const trace = (0, buildDecisionTrace_js_1.buildDecisionTrace)({
+        signals,
+        riskScore: score,
+        confidenceScore: confidence.score,
+        confidenceBreakdown: confidence.breakdown,
+        mode,
+        reasonDetails: reasonDetails.map((reason) => ({
+            code: reason.code,
+            severity: mapReasonSeverityForExplanation(reason.severity),
+            category: reason.category,
+            message: reason.summary
+        }))
+    });
+    const explanationReasons = reasonDetails.map((reason) => ({
+        code: reason.code,
+        severity: mapReasonSeverityForExplanation(reason.severity),
+        category: reason.category,
+        message: reason.summary
+    }));
+    const result = {
+        task: normalizedTask,
+        decision: {
+            mode,
+            confidenceScore: confidence.score
+        },
+        risk: {
+            score,
+            breakdown: {
+                destructive: breakdown.destructive,
+                schema: breakdown.schema,
+                critical: breakdown.critical,
+                lowRisk: breakdown.lowRisk,
+                massScope: breakdown.massScope
+            }
+        },
+        confidence,
+        recommendation: buildRecommendation(mode),
+        topRisks: buildTopRisks(score, signals),
+        trace,
+        reasonCodes
+    };
+    return {
+        ...result,
+        explanation: (0, buildDecisionExplanation_js_1.buildDecisionExplanation)({
+            mode,
+            confidenceScore: confidence.score,
+            reasons: explanationReasons
+        }, { reasonCodes: reasonCodes })
+    };
+}
+function buildPrimaryCause(signals) {
+    if (signals.includes("destructive"))
+        return "destructive operation";
+    if (signals.includes("schema"))
+        return "schema-sensitive change";
+    if (signals.includes("critical_domain"))
+        return "critical domain access";
+    if (signals.includes("mass_scope"))
+        return "mass-scope operation";
+    return "general task";
+}
+function buildConfidenceImpactLine(breakdown) {
+    const destructivePenalty = breakdown.destructivePenalty ?? 0;
+    const schemaPenalty = breakdown.schemaPenalty ?? 0;
+    const criticalPenalty = breakdown.criticalPenalty ?? 0;
+    const massScopePenalty = breakdown.massScopePenalty ?? 0;
+    const lowRiskBonus = breakdown.lowRiskBonus ?? 0;
+    const parts = [];
+    if (destructivePenalty !== 0) {
+        parts.push(`destructive penalty: ${destructivePenalty}`);
+    }
+    if (schemaPenalty !== 0) {
+        parts.push(`schema penalty: ${schemaPenalty}`);
+    }
+    if (criticalPenalty !== 0) {
+        parts.push(`critical penalty: ${criticalPenalty}`);
+    }
+    if (massScopePenalty !== 0) {
+        parts.push(`mass-scope penalty: ${massScopePenalty}`);
+    }
+    if (lowRiskBonus !== 0) {
+        parts.push(`low-risk bonus: +${lowRiskBonus}`);
+    }
+    if (parts.length === 0)
+        return null;
+    return parts.join(", ");
+}
+//# sourceMappingURL=runAgent.js.map

package/dist/core/runAgent.js.map

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