@getripple/core 1.0.5 → 1.0.7

package/dist/index.d.ts

@@ -7,5 +7,6 @@ export * from "./graph";
 export * from "./normalizer";
 export * from "./policy";
 export * from "./readiness";
+export * from "./risk";
 export * from "./staged-check";
 export * from "./types";

package/dist/index.js

@@ -23,6 +23,7 @@ __exportStar(require("./graph"), exports);
 __exportStar(require("./normalizer"), exports);
 __exportStar(require("./policy"), exports);
 __exportStar(require("./readiness"), exports);
+__exportStar(require("./risk"), exports);
 __exportStar(require("./staged-check"), exports);
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B;AAC3B,0CAAwB;AACxB,mDAAiC;AACjC,kDAAgC;AAChC,0CAAwB;AACxB,+CAA6B;AAC7B,2CAAyB;AACzB,8CAA4B;AAC5B,iDAA+B;AAC/B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B;AAC3B,0CAAwB;AACxB,mDAAiC;AACjC,kDAAgC;AAChC,0CAAwB;AACxB,+CAA6B;AAC7B,2CAAyB;AACzB,8CAA4B;AAC5B,yCAAuB;AACvB,iDAA+B;AAC/B,0CAAwB"}

package/dist/readiness.d.ts

@@ -1,6 +1,8 @@
 import { RippleAdapterDetectionSummary } from "./adapters";
 import { GraphEngine } from "./graph";
 export declare const RIPPLE_CI_WORKFLOW_PATH = ".github/workflows/ripple.yml";
+export declare const RIPPLE_GITIGNORE_PATH = ".gitignore";
+export declare const RIPPLE_CACHE_GITIGNORE_ENTRY = ".ripple/.cache/";
 export type RippleReadinessCheck = {
     ok: boolean;
     detail: string;
@@ -16,8 +18,15 @@ export type RippleEnforcementReadiness = {
     explicitPolicy: RippleReadinessCheck;
     gaps: string[];
 };
+export type RippleReadinessDecision = "continue" | "setup-required";
 export type RippleReadinessSummary = {
     status: "ready" | "needs_setup";
+    decision: RippleReadinessDecision;
+    canContinue: boolean;
+    mustStop: boolean;
+    nextRequiredAction: string;
+    why: string[];
+    fixNow: string[];
     workspace: string;
     sourceFiles: number;
     symbols: number;
@@ -27,6 +36,7 @@ export type RippleReadinessSummary = {
     checks: {
         graph: RippleReadinessCheck;
         git: RippleReadinessCheck;
+        gitIgnore: RippleReadinessCheck;
         ciWorkflow: RippleReadinessCheck;
         latestIntent: RippleReadinessCheck;
     };

package/dist/readiness.js

@@ -23,13 +23,15 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildRippleReadinessSummary = exports.RIPPLE_CI_WORKFLOW_PATH = void 0;
+exports.buildRippleReadinessSummary = exports.RIPPLE_CACHE_GITIGNORE_ENTRY = exports.RIPPLE_GITIGNORE_PATH = exports.RIPPLE_CI_WORKFLOW_PATH = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const child_process_1 = require("child_process");
 const adapters_1 = require("./adapters");
 const change_intent_1 = require("./change-intent");
+const git_1 = require("./git");
 exports.RIPPLE_CI_WORKFLOW_PATH = ".github/workflows/ripple.yml";
+exports.RIPPLE_GITIGNORE_PATH = ".gitignore";
+exports.RIPPLE_CACHE_GITIGNORE_ENTRY = ".ripple/.cache/";
 function buildRippleReadinessSummary(workspaceRoot, engine) {
     const sourceFiles = engine.graph.files.size;
     const symbols = engine.graph.symbols.size;
@@ -39,7 +41,9 @@ function buildRippleReadinessSummary(workspaceRoot, engine) {
     const latestIntentPath = (0, change_intent_1.defaultChangeIntentPath)(workspaceRoot);
     const policyPath = path.join(workspaceRoot, ".ripple", "policy.json");
     const graphOk = sourceFiles > 0;
-    const gitOk = isGitWorktree(workspaceRoot);
+    const gitCheck = gitWorktreeCheck(workspaceRoot);
+    const gitOk = gitCheck.ok;
+    const gitIgnoreCheck = rippleGitIgnoreCheck(workspaceRoot);
     const ciWorkflowOk = fs.existsSync(workflowPath);
     const latestIntentOk = fs.existsSync(latestIntentPath);
     const explicitPolicyOk = fs.existsSync(policyPath);
@@ -51,11 +55,8 @@ function buildRippleReadinessSummary(workspaceRoot, engine) {
                 : "No supported source files were found",
             fix: graphOk ? undefined : "Run Ripple from a JavaScript, TypeScript, or Python repo root.",
         },
-        git: {
-            ok: gitOk,
-            detail: gitOk ? "Inside a git worktree" : "Not inside a git worktree",
-            fix: gitOk ? undefined : "Run Ripple inside a git repository.",
-        },
+        git: gitCheck,
+        gitIgnore: gitIgnoreCheck,
         ciWorkflow: {
             ok: ciWorkflowOk,
             detail: ciWorkflowOk
@@ -76,6 +77,8 @@ function buildRippleReadinessSummary(workspaceRoot, engine) {
     const enforcement = buildEnforcementReadiness({
         graphOk,
         gitOk,
+        gitDetail: gitCheck.detail,
+        gitIgnoreOk: gitIgnoreCheck.ok,
         ciWorkflowOk,
         latestIntentOk,
         explicitPolicyOk,
@@ -86,8 +89,16 @@ function buildRippleReadinessSummary(workspaceRoot, engine) {
     if (nextSteps.length === 0) {
         nextSteps.push("Run ripple ci --base origin/main --intent latest --github-annotations.");
     }
+    const status = Object.values(checks).every((check) => check.ok) ? "ready" : "needs_setup";
+    const contract = readinessContract(status, enforcement, nextSteps);
     return {
-        status: Object.values(checks).every((check) => check.ok) ? "ready" : "needs_setup",
+        status,
+        decision: contract.decision,
+        canContinue: contract.canContinue,
+        mustStop: contract.mustStop,
+        nextRequiredAction: contract.nextRequiredAction,
+        why: contract.why,
+        fixNow: contract.fixNow,
         workspace: workspaceRoot,
         sourceFiles,
         symbols,
@@ -99,6 +110,26 @@ function buildRippleReadinessSummary(workspaceRoot, engine) {
     };
 }
 exports.buildRippleReadinessSummary = buildRippleReadinessSummary;
+function readinessContract(status, enforcement, nextSteps) {
+    if (status === "ready") {
+        return {
+            decision: "continue",
+            canContinue: true,
+            mustStop: false,
+            nextRequiredAction: "Continue with the saved-intent workflow and keep the Ripple CI gate enabled.",
+            why: [enforcement.summary],
+            fixNow: [],
+        };
+    }
+    return {
+        decision: "setup-required",
+        canContinue: false,
+        mustStop: true,
+        nextRequiredAction: "Stop autonomous agent work until Ripple readiness gaps are fixed.",
+        why: enforcement.gaps,
+        fixNow: nextSteps,
+    };
+}
 function buildEnforcementReadiness(input) {
     const canGuideAgents = input.graphOk;
     const canDetectDrift = input.graphOk && input.gitOk && input.latestIntentOk;
@@ -157,7 +188,10 @@ function enforcementGaps(input) {
         gaps.push("No supported source graph is available.");
     }
     if (!input.gitOk) {
-        gaps.push("Git worktree is required for changed-file and CI drift checks.");
+        gaps.push(`${input.gitDetail} Git is required for changed-file and CI drift checks.`);
+    }
+    if (!input.gitIgnoreOk) {
+        gaps.push("Missing .gitignore hygiene for .ripple/.cache/; generated cache files may be committed accidentally.");
     }
     if (!input.latestIntentOk) {
         gaps.push("No latest saved intent exists, so Ripple cannot compare agent work to a plan.");
@@ -177,18 +211,82 @@ function countCallEdges(engine) {
     });
     return count;
 }
-function isGitWorktree(workspaceRoot) {
+function gitWorktreeCheck(workspaceRoot) {
     try {
-        const output = (0, child_process_1.execFileSync)("git", ["rev-parse", "--is-inside-work-tree"], {
-            cwd: workspaceRoot,
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-        });
-        return output.trim() === "true";
+        const output = (0, git_1.execGit)(workspaceRoot, ["rev-parse", "--is-inside-work-tree"], ["ignore", "pipe", "ignore"]);
+        const insideWorktree = output.trim() === "true";
+        return {
+            ok: insideWorktree,
+            detail: insideWorktree
+                ? "Inside a git worktree"
+                : "Git command ran, but this directory is not inside a git worktree",
+            fix: insideWorktree
+                ? undefined
+                : "Run Ripple from the repository root or initialize git first.",
+        };
     }
-    catch {
-        return false;
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        return {
+            ok: false,
+            detail,
+            fix: gitFixFor(detail),
+        };
+    }
+}
+function gitFixFor(detail) {
+    if (/could not be started|EPERM|EACCES/i.test(detail)) {
+        return "Run Ripple from a normal terminal, or allow Node.js to execute git in this environment.";
     }
+    if (/not found|ENOENT/i.test(detail)) {
+        return "Install Git and make sure git is available on PATH.";
+    }
+    return "Run Ripple from the repository root or initialize git first.";
+}
+function rippleGitIgnoreCheck(workspaceRoot) {
+    const gitignorePath = path.join(workspaceRoot, exports.RIPPLE_GITIGNORE_PATH);
+    if (!fs.existsSync(gitignorePath)) {
+        return {
+            ok: false,
+            detail: "Missing .gitignore entry for .ripple/.cache/",
+            fix: "Run ripple init or add .ripple/.cache/ to .gitignore.",
+        };
+    }
+    const lines = fs
+        .readFileSync(gitignorePath, "utf8")
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith("#"));
+    const broadRippleIgnore = lines.some(isBroadRippleIgnore);
+    if (broadRippleIgnore) {
+        return {
+            ok: false,
+            detail: "Overbroad .ripple/ ignore may hide policy, history, intents, or approvals",
+            fix: "Ignore only .ripple/.cache/ so Ripple audit files can be committed intentionally.",
+        };
+    }
+    const cacheIgnored = lines.some(isRippleCacheIgnore);
+    return {
+        ok: cacheIgnored,
+        detail: cacheIgnored
+            ? ".ripple/.cache/ is ignored; Ripple audit files remain commit-able"
+            : "Missing .gitignore entry for .ripple/.cache/",
+        fix: cacheIgnored
+            ? undefined
+            : "Run ripple init or add .ripple/.cache/ to .gitignore.",
+    };
+}
+function isRippleCacheIgnore(line) {
+    const normalized = line.replace(/\\/g, "/").replace(/^\/+/, "");
+    return (normalized === exports.RIPPLE_CACHE_GITIGNORE_ENTRY ||
+        normalized === ".ripple/.cache" ||
+        normalized === ".ripple/.cache/**");
+}
+function isBroadRippleIgnore(line) {
+    const normalized = line.replace(/\\/g, "/").replace(/^\/+/, "");
+    return (normalized === ".ripple" ||
+        normalized === ".ripple/" ||
+        normalized === ".ripple/**");
 }
 function formatWorkspacePath(workspaceRoot, filePath) {
     const relative = path.relative(workspaceRoot, filePath);

package/dist/readiness.js.map

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

package/dist/risk.d.ts

@@ -0,0 +1,33 @@
+import type { ControlBoundaryRisk } from "./change-intent";
+import type { StagedCheckFileSummary } from "./staged-check";
+export type RippleRiskLevel = "low" | "medium" | "high" | "critical";
+export type RippleRiskReasonKind = "boundary-crossed" | "intent-drift" | "risky-path" | "blast-radius" | "public-contract" | "test-gap" | "policy-rule" | "readiness-drift";
+export type RippleRiskReason = {
+    kind: RippleRiskReasonKind;
+    severity: RippleRiskLevel;
+    message: string;
+    evidence: string[];
+};
+export type RippleRiskSummary = {
+    level: RippleRiskLevel;
+    score: number;
+    summary: string;
+    reasons: RippleRiskReason[];
+    affectedFiles: string[];
+    affectedSymbols: string[];
+    requiredActions: string[];
+};
+export type BuildRippleRiskSummaryInput = {
+    boundaryRisk: ControlBoundaryRisk;
+    allowedFiles: string[];
+    allowedSymbols: string[];
+    changedFiles: string[];
+    changedOutsideBoundaryFiles: string[];
+    changedOutsideBoundarySymbols: string[];
+    unplannedFiles?: string[];
+    unplannedSymbols?: string[];
+    verificationTargets: string[];
+    nextSteps: string[];
+    stagedFiles: StagedCheckFileSummary[];
+};
+export declare function buildRippleRiskSummary(input: BuildRippleRiskSummaryInput): RippleRiskSummary;

package/dist/risk.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRippleRiskSummary = void 0;
+const GRAPH_RISK_WEIGHT = {
+    safe: 0,
+    caution: 16,
+    dangerous: 32,
+};
+const CONTRACT_RISK_WEIGHT = {
+    review: 16,
+    high: 28,
+};
+const RISKY_PATH_RULES = [
+    {
+        pattern: /(^|[\\/])(auth|security|permissions?)([\\/]|$)/i,
+        label: "auth/security/permission code",
+        severity: "high",
+        weight: 24,
+    },
+    {
+        pattern: /(^|[\\/])(payments?|billing|checkout)([\\/]|$)/i,
+        label: "payment/billing code",
+        severity: "critical",
+        weight: 36,
+    },
+    {
+        pattern: /(^|[\\/])(migrations?|schema|database|db)([\\/]|$)/i,
+        label: "database/schema/migration code",
+        severity: "critical",
+        weight: 36,
+    },
+    {
+        pattern: /(^|[\\/])(infra|deploy|deployment|terraform|k8s|kubernetes|docker)([\\/]|$)/i,
+        label: "infra/deployment code",
+        severity: "high",
+        weight: 26,
+    },
+    {
+        pattern: /(^|[\\/])\.github[\\/]workflows[\\/]|(^|[\\/])(config|configs)([\\/]|$)|\.(env|ya?ml|toml|ini)$/i,
+        label: "config/CI code",
+        severity: "high",
+        weight: 22,
+    },
+];
+function buildRippleRiskSummary(input) {
+    const reasons = [];
+    const affectedFiles = new Set(input.changedFiles);
+    const affectedSymbols = new Set([
+        ...input.changedOutsideBoundarySymbols,
+        ...(input.unplannedSymbols ?? []),
+    ]);
+    addBoundaryReasons(input, reasons);
+    addIntentReasons(input, reasons);
+    addPolicyReason(input, reasons);
+    addFileRiskReasons(input, reasons, affectedFiles);
+    addContractReasons(input, reasons, affectedSymbols);
+    addVerificationReason(input, reasons);
+    const score = Math.min(100, reasons.reduce((total, reason) => total + reason.weight, 0));
+    const level = riskLevelForScore(score);
+    const requiredActions = buildRequiredActions(input, reasons);
+    return {
+        level,
+        score,
+        summary: buildRiskSummary(level, score, reasons),
+        reasons: reasons.map(({ weight: _weight, ...reason }) => reason),
+        affectedFiles: Array.from(affectedFiles).sort(),
+        affectedSymbols: Array.from(affectedSymbols).sort(),
+        requiredActions,
+    };
+}
+exports.buildRippleRiskSummary = buildRippleRiskSummary;
+function addBoundaryReasons(input, reasons) {
+    if (input.changedOutsideBoundaryFiles.length > 0) {
+        reasons.push({
+            kind: "boundary-crossed",
+            severity: "high",
+            weight: 34,
+            message: "Agent changed files outside the approved Ripple boundary.",
+            evidence: [
+                ...input.allowedFiles.map((file) => `allowed file: ${file}`),
+                ...input.changedOutsideBoundaryFiles.map((file) => `changed outside boundary: ${file}`),
+            ],
+        });
+    }
+    if (input.changedOutsideBoundarySymbols.length > 0) {
+        reasons.push({
+            kind: "boundary-crossed",
+            severity: "high",
+            weight: 36,
+            message: "Agent changed symbols outside the approved Ripple boundary.",
+            evidence: [
+                ...input.allowedSymbols.map((symbol) => `allowed symbol: ${symbol}`),
+                ...input.changedOutsideBoundarySymbols.map((symbol) => `changed outside boundary: ${symbol}`),
+            ],
+        });
+    }
+}
+function addIntentReasons(input, reasons) {
+    const unplannedFiles = input.unplannedFiles ?? [];
+    const unplannedSymbols = input.unplannedSymbols ?? [];
+    if (unplannedFiles.length > 0) {
+        reasons.push({
+            kind: "intent-drift",
+            severity: "medium",
+            weight: 22,
+            message: "Agent changed files outside the saved task plan.",
+            evidence: unplannedFiles.map((file) => `unplanned file: ${file}`),
+        });
+    }
+    if (unplannedSymbols.length > 0) {
+        reasons.push({
+            kind: "intent-drift",
+            severity: "medium",
+            weight: 20,
+            message: "Agent changed symbols outside the saved task plan.",
+            evidence: unplannedSymbols.map((symbol) => `unplanned symbol: ${symbol}`),
+        });
+    }
+}
+function addPolicyReason(input, reasons) {
+    if (input.boundaryRisk === "high" || input.boundaryRisk === "critical") {
+        reasons.push({
+            kind: "policy-rule",
+            severity: input.boundaryRisk,
+            weight: input.boundaryRisk === "critical" ? 55 : 35,
+            message: `Saved intent is marked ${input.boundaryRisk} risk by Ripple policy/boundary analysis.`,
+            evidence: [`boundary risk: ${input.boundaryRisk}`],
+        });
+    }
+}
+function addFileRiskReasons(input, reasons, affectedFiles) {
+    for (const file of input.stagedFiles) {
+        affectedFiles.add(file.file);
+        const graphWeight = GRAPH_RISK_WEIGHT[file.modificationRisk];
+        if (graphWeight > 0) {
+            reasons.push({
+                kind: "blast-radius",
+                severity: file.modificationRisk === "dangerous" ? "high" : "medium",
+                weight: graphWeight,
+                message: `${file.file} is marked ${file.modificationRisk} by Ripple graph risk.`,
+                evidence: [
+                    `importer count: ${file.importerCount}`,
+                    `symbol count: ${file.symbolCount}`,
+                ],
+            });
+        }
+        if (file.importerCount >= 5) {
+            reasons.push({
+                kind: "blast-radius",
+                severity: "high",
+                weight: 26,
+                message: `${file.file} has a large downstream blast radius.`,
+                evidence: [`${file.importerCount} direct importers may be affected`],
+            });
+        }
+        else if (file.importerCount >= 2) {
+            reasons.push({
+                kind: "blast-radius",
+                severity: "medium",
+                weight: 14,
+                message: `${file.file} is shared by multiple downstream files.`,
+                evidence: [`${file.importerCount} direct importers may be affected`],
+            });
+        }
+        const riskyPath = RISKY_PATH_RULES.find((rule) => rule.pattern.test(file.file));
+        if (riskyPath) {
+            reasons.push({
+                kind: "risky-path",
+                severity: riskyPath.severity,
+                weight: riskyPath.weight,
+                message: `${file.file} touches ${riskyPath.label}.`,
+                evidence: [`changed file: ${file.file}`],
+            });
+        }
+    }
+}
+function addContractReasons(input, reasons, affectedSymbols) {
+    const contractRisks = input.stagedFiles.flatMap((file) => file.contractRisks);
+    if (contractRisks.length === 0) {
+        return;
+    }
+    const highestRisk = contractRisks.some((contractRisk) => contractRisk.risk === "high")
+        ? "high"
+        : "review";
+    for (const contractRisk of contractRisks) {
+        affectedSymbols.add(contractRisk.symbol);
+    }
+    reasons.push({
+        kind: "public-contract",
+        severity: highestRisk === "high" ? "high" : "medium",
+        weight: Math.max(...contractRisks.map((contractRisk) => CONTRACT_RISK_WEIGHT[contractRisk.risk])),
+        message: "Changed exported/public symbols may affect callers or external contracts.",
+        evidence: uniqueItems(contractRisks.flatMap((contractRisk) => [
+            `symbol: ${contractRisk.symbol}`,
+            `callers: ${contractRisk.callers}`,
+            `exported: ${contractRisk.exported}`,
+            `reason: ${contractRisk.reason}`,
+        ])),
+    });
+}
+function addVerificationReason(input, reasons) {
+    if (input.changedFiles.length > 0 && input.verificationTargets.length === 0) {
+        reasons.push({
+            kind: "test-gap",
+            severity: "medium",
+            weight: 10,
+            message: "No verification target was detected for this change.",
+            evidence: ["verification targets: none"],
+        });
+    }
+}
+function buildRequiredActions(input, reasons) {
+    const actions = [];
+    if (input.changedOutsideBoundaryFiles.length > 0 ||
+        input.changedOutsideBoundarySymbols.length > 0) {
+        actions.push("Undo the outside-boundary change or create a wider human-approved intent.");
+    }
+    if (reasons.some((reason) => reason.kind === "blast-radius")) {
+        actions.push("Review downstream callers/importers before continuing.");
+    }
+    if (reasons.some((reason) => reason.kind === "public-contract")) {
+        actions.push("Review public contract changes before keeping this edit.");
+    }
+    if (input.verificationTargets.length > 0) {
+        actions.push(...input.verificationTargets.map((target) => `Run verification target: ${target}`));
+    }
+    else if (input.changedFiles.length > 0) {
+        actions.push("Run the narrowest relevant test/typecheck before handoff.");
+    }
+    if (actions.length === 0) {
+        actions.push("Continue with normal verification and review for the saved intent.");
+    }
+    return uniqueItems(actions);
+}
+function buildRiskSummary(level, score, reasons) {
+    if (reasons.length === 0) {
+        return `LOW risk ${score}/100: no boundary, graph, policy, contract, or verification risk signals were detected.`;
+    }
+    const topReason = reasons.slice().sort((a, b) => b.weight - a.weight)[0];
+    return `${level.toUpperCase()} risk ${score}/100: ${topReason.message}`;
+}
+function riskLevelForScore(score) {
+    if (score >= 81) {
+        return "critical";
+    }
+    if (score >= 51) {
+        return "high";
+    }
+    if (score >= 21) {
+        return "medium";
+    }
+    return "low";
+}
+function uniqueItems(items) {
+    const seen = new Set();
+    return items.filter((item) => {
+        if (seen.has(item)) {
+            return false;
+        }
+        seen.add(item);
+        return true;
+    });
+}
+//# sourceMappingURL=risk.js.map

package/dist/risk.js.map

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