@getripple/core 1.0.4

package/dist/policy.js

@@ -0,0 +1,380 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explainRipplePolicyForIntent = exports.explainRipplePolicyForTarget = exports.resolveRipplePolicyForTarget = exports.loadRipplePolicy = exports.ripplePolicyPath = exports.formatRipplePolicy = exports.defaultRipplePolicy = exports.RIPPLE_POLICY_PATH = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.RIPPLE_POLICY_PATH = ".ripple/policy.json";
+const CONTROL_MODES = ["brainstorm", "function", "file", "task", "pr"];
+const RISK_LEVELS = ["low", "medium", "high", "critical"];
+function defaultRipplePolicy() {
+    return {
+        protocol: "ripple-policy",
+        version: 1,
+        defaultMode: "file",
+        riskRules: [
+            {
+                paths: ["src/auth/**", "src/security/**", "src/session/**"],
+                risk: "high",
+                requireHumanBeforeEdit: true,
+            },
+            {
+                paths: ["src/payments/**", "migrations/**", "database/**", "db/**"],
+                risk: "critical",
+                requireHumanBeforeEdit: true,
+                requireHumanBeforeMerge: true,
+            },
+            {
+                paths: ["docs/**", "**/*.md"],
+                risk: "low",
+                allowPrMode: true,
+            },
+        ],
+    };
+}
+exports.defaultRipplePolicy = defaultRipplePolicy;
+function formatRipplePolicy(policy = defaultRipplePolicy()) {
+    return `${JSON.stringify(policy, null, 2)}\n`;
+}
+exports.formatRipplePolicy = formatRipplePolicy;
+function ripplePolicyPath(workspaceRoot) {
+    return path.join(workspaceRoot, exports.RIPPLE_POLICY_PATH);
+}
+exports.ripplePolicyPath = ripplePolicyPath;
+function loadRipplePolicy(workspaceRoot) {
+    const policyPath = ripplePolicyPath(workspaceRoot);
+    if (!fs.existsSync(policyPath)) {
+        return {
+            policy: {},
+            path: policyPath,
+            exists: false,
+        };
+    }
+    const parsed = JSON.parse(fs.readFileSync(policyPath, "utf8"));
+    return {
+        policy: normalizeRipplePolicy(parsed, policyPath),
+        path: policyPath,
+        exists: true,
+    };
+}
+exports.loadRipplePolicy = loadRipplePolicy;
+function resolveRipplePolicyForTarget(loaded, targetFile) {
+    const policy = loaded.policy;
+    const source = loaded.exists ? "file" : "built-in";
+    const matchedRules = [];
+    let risk;
+    let requireHumanBeforeEdit = false;
+    let requireHumanBeforeMerge = false;
+    let allowPrMode;
+    (policy.riskRules ?? []).forEach((rule, index) => {
+        if (!rule.paths.some((pattern) => matchesPolicyPath(pattern, targetFile))) {
+            return;
+        }
+        matchedRules.push(describeRiskRule(rule, index));
+        if (rule.risk) {
+            risk = strongestRisk(risk, rule.risk);
+        }
+        requireHumanBeforeEdit = requireHumanBeforeEdit || rule.requireHumanBeforeEdit === true;
+        requireHumanBeforeMerge = requireHumanBeforeMerge || rule.requireHumanBeforeMerge === true;
+        if (rule.allowPrMode !== undefined) {
+            allowPrMode = allowPrMode === undefined ? rule.allowPrMode : allowPrMode || rule.allowPrMode;
+        }
+    });
+    return {
+        source,
+        sourcePath: loaded.exists ? exports.RIPPLE_POLICY_PATH : undefined,
+        defaultMode: policy.defaultMode,
+        risk,
+        requireHumanBeforeEdit,
+        requireHumanBeforeMerge,
+        allowPrMode,
+        matchedRules,
+    };
+}
+exports.resolveRipplePolicyForTarget = resolveRipplePolicyForTarget;
+function explainRipplePolicyForTarget(loaded, targetFile, options = {}) {
+    const resolution = resolveRipplePolicyForTarget(loaded, targetFile);
+    const policyDefaultMode = resolution.defaultMode ?? "file";
+    const effectiveMode = options.controlMode ?? policyDefaultMode;
+    const humanGate = policyHumanGate(resolution, effectiveMode);
+    const policySource = resolution.sourcePath ?? "built-in default";
+    const why = [];
+    const nextSteps = [];
+    if (loaded.exists) {
+        why.push(`Trust policy loaded from ${policySource}.`);
+    }
+    else {
+        why.push("No .ripple/policy.json found; Ripple will use built-in defaults.");
+        nextSteps.push("Run ripple policy init to create repo-level trust defaults.");
+    }
+    if (resolution.defaultMode) {
+        why.push(`Default control mode: ${resolution.defaultMode}.`);
+    }
+    else {
+        why.push("No defaultMode set; Ripple will default to file mode.");
+    }
+    if (options.controlMode && options.controlMode !== policyDefaultMode) {
+        why.push(`Requested control mode overrides policy default: ${options.controlMode}.`);
+    }
+    if (resolution.matchedRules.length > 0) {
+        why.push(`Matched policy rules: ${resolution.matchedRules.join("; ")}.`);
+    }
+    else {
+        why.push("No path-specific policy rule matched this file.");
+        if (loaded.exists) {
+            nextSteps.push("Add a riskRules entry if this path needs a stronger trust boundary.");
+        }
+    }
+    if (resolution.risk) {
+        why.push(`Policy risk: ${resolution.risk}.`);
+    }
+    if (resolution.requireHumanBeforeEdit) {
+        why.push("Policy requires human approval before editing.");
+    }
+    if (resolution.requireHumanBeforeMerge) {
+        why.push("Policy requires human approval before merge.");
+    }
+    if (effectiveMode === "brainstorm") {
+        why.push("Brainstorm mode means no file edits are allowed.");
+    }
+    if (effectiveMode === "pr") {
+        why.push("PR mode still requires human review before merge.");
+    }
+    if (humanGate === "required-before-edit") {
+        nextSteps.push("Ask the human to approve before the agent edits this file.");
+    }
+    else if (humanGate === "required-before-merge") {
+        nextSteps.push("Require human review before merging this change.");
+    }
+    else {
+        nextSteps.push("Use ripple plan to create a saved intent before editing.");
+    }
+    return {
+        protocol: "ripple-policy-explanation",
+        version: 1,
+        targetFile,
+        policySource,
+        policyExists: loaded.exists,
+        effectiveMode,
+        policyRisk: resolution.risk ?? "none",
+        humanGate,
+        humanRequired: humanGate !== "none",
+        allowPrMode: resolution.allowPrMode === true,
+        matchedRules: resolution.matchedRules,
+        why: uniqueItems(why),
+        nextSteps: uniqueItems(nextSteps),
+    };
+}
+exports.explainRipplePolicyForTarget = explainRipplePolicyForTarget;
+function explainRipplePolicyForIntent(loaded, intent) {
+    const explanation = explainRipplePolicyForTarget(loaded, intent.targetFile, {
+        controlMode: intent.controlMode,
+    });
+    const boundaryGate = humanGateFromIntentBoundary(intent);
+    const humanGate = strongestHumanGate(explanation.humanGate, boundaryGate);
+    if (humanGate === explanation.humanGate) {
+        return explanation;
+    }
+    return {
+        ...explanation,
+        humanGate,
+        humanRequired: humanGate !== "none",
+        why: uniqueItems([
+            ...explanation.why,
+            ...boundaryGateWhy(intent, boundaryGate),
+        ]),
+        nextSteps: uniqueItems([
+            ...humanGateNextSteps(humanGate),
+            ...explanation.nextSteps,
+        ]),
+    };
+}
+exports.explainRipplePolicyForIntent = explainRipplePolicyForIntent;
+function policyHumanGate(resolution, effectiveMode) {
+    if (resolution.requireHumanBeforeEdit || effectiveMode === "brainstorm") {
+        return "required-before-edit";
+    }
+    if (resolution.requireHumanBeforeMerge || effectiveMode === "pr") {
+        return "required-before-merge";
+    }
+    return "none";
+}
+function humanGateFromIntentBoundary(intent) {
+    if (intent.controlMode === "brainstorm") {
+        return "required-before-edit";
+    }
+    if (intent.boundaryRisk === "critical" || intent.boundaryRisk === "high") {
+        return "required-before-edit";
+    }
+    if (intent.controlMode === "pr") {
+        return "required-before-merge";
+    }
+    return "none";
+}
+function strongestHumanGate(first, second) {
+    return humanGateRank(second) > humanGateRank(first) ? second : first;
+}
+function humanGateRank(gate) {
+    if (gate === "required-before-edit") {
+        return 2;
+    }
+    if (gate === "required-before-merge") {
+        return 1;
+    }
+    return 0;
+}
+function boundaryGateWhy(intent, gate) {
+    if (gate === "required-before-edit") {
+        if (intent.controlMode === "brainstorm") {
+            return ["Ripple boundary requires human approval because brainstorm mode does not allow file edits."];
+        }
+        return [
+            `Ripple boundary requires human approval before editing because the saved target is ${intent.boundaryRisk} risk.`,
+        ];
+    }
+    if (gate === "required-before-merge") {
+        return ["Ripple boundary requires human review before merge because PR mode was selected."];
+    }
+    return [];
+}
+function humanGateNextSteps(gate) {
+    if (gate === "required-before-edit") {
+        return ["Ask the human to approve before the agent edits this file."];
+    }
+    if (gate === "required-before-merge") {
+        return ["Require human review before merging this change."];
+    }
+    return ["Use ripple plan to create a saved intent before editing."];
+}
+function normalizeRipplePolicy(value, sourcePath) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${sourcePath} must contain a JSON object.`);
+    }
+    const raw = value;
+    if (raw.protocol !== undefined && raw.protocol !== "ripple-policy") {
+        throw new Error(`${sourcePath} has unsupported protocol: ${String(raw.protocol)}`);
+    }
+    if (raw.version !== undefined && raw.version !== 1) {
+        throw new Error(`${sourcePath} has unsupported version: ${String(raw.version)}`);
+    }
+    if (raw.defaultMode !== undefined && !isControlMode(raw.defaultMode)) {
+        throw new Error(`${sourcePath} defaultMode must be one of: ${CONTROL_MODES.join(", ")}`);
+    }
+    return {
+        protocol: raw.protocol,
+        version: raw.version,
+        defaultMode: raw.defaultMode,
+        riskRules: normalizeRiskRules(raw.riskRules, sourcePath),
+    };
+}
+function normalizeRiskRules(value, sourcePath) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(`${sourcePath} riskRules must be an array.`);
+    }
+    return value.map((rule, index) => {
+        if (!rule || typeof rule !== "object" || Array.isArray(rule)) {
+            throw new Error(`${sourcePath} riskRules[${index}] must be an object.`);
+        }
+        if (!Array.isArray(rule.paths) || rule.paths.some((item) => typeof item !== "string")) {
+            throw new Error(`${sourcePath} riskRules[${index}].paths must be a string array.`);
+        }
+        if (rule.risk !== undefined && !isRisk(rule.risk)) {
+            throw new Error(`${sourcePath} riskRules[${index}].risk must be one of: ${RISK_LEVELS.join(", ")}`);
+        }
+        return {
+            paths: rule.paths,
+            risk: rule.risk,
+            requireHumanBeforeEdit: rule.requireHumanBeforeEdit === true,
+            requireHumanBeforeMerge: rule.requireHumanBeforeMerge === true,
+            allowPrMode: rule.allowPrMode,
+        };
+    });
+}
+function describeRiskRule(rule, index) {
+    const risk = rule.risk ? ` risk=${rule.risk}` : "";
+    return `riskRules[${index}] paths=${rule.paths.join(",")}${risk}`;
+}
+function matchesPolicyPath(pattern, filePath) {
+    const normalizedPattern = normalizePolicyPath(pattern);
+    const normalizedFile = normalizePolicyPath(filePath);
+    const hasGlob = normalizedPattern.includes("*");
+    if (!hasGlob) {
+        return normalizedFile === normalizedPattern || normalizedFile.startsWith(`${normalizedPattern}/`);
+    }
+    return globPatternToRegExp(normalizedPattern).test(normalizedFile);
+}
+function normalizePolicyPath(value) {
+    return value.replace(/\\/g, "/").replace(/^\/+/, "").toLowerCase();
+}
+function globPatternToRegExp(pattern) {
+    let source = "^";
+    for (let i = 0; i < pattern.length; i++) {
+        const char = pattern[i];
+        if (char === "*" && pattern[i + 1] === "*") {
+            source += ".*";
+            i++;
+            continue;
+        }
+        if (char === "*") {
+            source += "[^/]*";
+            continue;
+        }
+        source += escapeRegExp(char);
+    }
+    source += "$";
+    return new RegExp(source);
+}
+function escapeRegExp(value) {
+    return value.replace(/[\\^$+?.()|[\]{}]/g, "\\$&");
+}
+function strongestRisk(first, second) {
+    if (!first) {
+        return second;
+    }
+    return riskRank(second) > riskRank(first) ? second : first;
+}
+function riskRank(risk) {
+    return RISK_LEVELS.indexOf(risk);
+}
+function isControlMode(value) {
+    return CONTROL_MODES.includes(value);
+}
+function isRisk(value) {
+    return RISK_LEVELS.includes(value);
+}
+function uniqueItems(items) {
+    const seen = new Set();
+    return items.filter((item) => {
+        if (seen.has(item)) {
+            return false;
+        }
+        seen.add(item);
+        return true;
+    });
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAGhB,QAAA,kBAAkB,GAAG,qBAAqB,CAAC;AAsDxD,MAAM,aAAa,GAAkB,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AACtF,MAAM,WAAW,GAA0B,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AAEjF,SAAgB,mBAAmB;IACjC,OAAO;QACL,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,MAAM;QACnB,SAAS,EAAE;YACT;gBACE,KAAK,EAAE,CAAC,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,CAAC;gBAC3D,IAAI,EAAE,MAAM;gBACZ,sBAAsB,EAAE,IAAI;aAC7B;YACD;gBACE,KAAK,EAAE,CAAC,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,CAAC;gBACnE,IAAI,EAAE,UAAU;gBAChB,sBAAsB,EAAE,IAAI;gBAC5B,uBAAuB,EAAE,IAAI;aAC9B;YACD;gBACE,KAAK,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;gBAC7B,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,IAAI;aAClB;SACF;KACF,CAAC;AACJ,CAAC;AAxBD,kDAwBC;AAED,SAAgB,kBAAkB,CAAC,SAAuB,mBAAmB,EAAE;IAC7E,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAFD,gDAEC;AAED,SAAgB,gBAAgB,CAAC,aAAqB;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,0BAAkB,CAAC,CAAC;AACtD,CAAC;AAFD,4CAEC;AAED,SAAgB,gBAAgB,CAAC,aAAqB;IACpD,MAAM,UAAU,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D,OAAO;QACL,MAAM,EAAE,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC;QACjD,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAhBD,4CAgBC;AAED,SAAgB,4BAA4B,CAC1C,MAA0B,EAC1B,UAAkB;IAElB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IACnD,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,IAAqC,CAAC;IAC1C,IAAI,sBAAsB,GAAG,KAAK,CAAC;IACnC,IAAI,uBAAuB,GAAG,KAAK,CAAC;IACpC,IAAI,WAAgC,CAAC;IAErC,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;YAC1E,OAAO;QACT,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QACD,sBAAsB,GAAG,sBAAsB,IAAI,IAAI,CAAC,sBAAsB,KAAK,IAAI,CAAC;QACxF,uBAAuB,GAAG,uBAAuB,IAAI,IAAI,CAAC,uBAAuB,KAAK,IAAI,CAAC;QAC3F,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,WAAW,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC;QAC/F,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,0BAAkB,CAAC,CAAC,CAAC,SAAS;QAC1D,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,IAAI;QACJ,sBAAsB;QACtB,uBAAuB;QACvB,WAAW;QACX,YAAY;KACb,CAAC;AACJ,CAAC;AAtCD,oEAsCC;AAED,SAAgB,4BAA4B,CAC1C,MAA0B,EAC1B,UAAkB,EAClB,UAA0C,EAAE;IAE5C,MAAM,UAAU,GAAG,4BAA4B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpE,MAAM,iBAAiB,GAAG,UAAU,CAAC,WAAW,IAAI,MAAM,CAAC;IAC3D,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,IAAI,iBAAiB,CAAC;IAC/D,MAAM,SAAS,GAAG,eAAe,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,IAAI,kBAAkB,CAAC;IACjE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,GAAG,CAAC,IAAI,CAAC,4BAA4B,YAAY,GAAG,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QAC7E,SAAS,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,yBAAyB,UAAU,CAAC,WAAW,GAAG,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,KAAK,iBAAiB,EAAE,CAAC;QACrE,GAAG,CAAC,IAAI,CAAC,oDAAoD,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,UAAU,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,yBAAyB,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3E,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,SAAS,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,gBAAgB,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,UAAU,CAAC,sBAAsB,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,UAAU,CAAC,uBAAuB,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;QACnC,GAAG,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,SAAS,KAAK,sBAAsB,EAAE,CAAC;QACzC,SAAS,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAC/E,CAAC;SAAM,IAAI,SAAS,KAAK,uBAAuB,EAAE,CAAC;QACjD,SAAS,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,2BAA2B;QACrC,OAAO,EAAE,CAAC;QACV,UAAU;QACV,YAAY;QACZ,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,aAAa;QACb,UAAU,EAAE,UAAU,CAAC,IAAI,IAAI,MAAM;QACrC,SAAS;QACT,aAAa,EAAE,SAAS,KAAK,MAAM;QACnC,WAAW,EAAE,UAAU,CAAC,WAAW,KAAK,IAAI;QAC5C,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC;QACrB,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC;KAClC,CAAC;AACJ,CAAC;AA9ED,oEA8EC;AAED,SAAgB,4BAA4B,CAC1C,MAA0B,EAC1B,MAAoB;IAEpB,MAAM,WAAW,GAAG,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE;QAC1E,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAE1E,IAAI,SAAS,KAAK,WAAW,CAAC,SAAS,EAAE,CAAC;QACxC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO;QACL,GAAG,WAAW;QACd,SAAS;QACT,aAAa,EAAE,SAAS,KAAK,MAAM;QACnC,GAAG,EAAE,WAAW,CAAC;YACf,GAAG,WAAW,CAAC,GAAG;YAClB,GAAG,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC;SACzC,CAAC;QACF,SAAS,EAAE,WAAW,CAAC;YACrB,GAAG,kBAAkB,CAAC,SAAS,CAAC;YAChC,GAAG,WAAW,CAAC,SAAS;SACzB,CAAC;KACH,CAAC;AACJ,CAAC;AA3BD,oEA2BC;AAED,SAAS,eAAe,CACtB,UAAkC,EAClC,aAA0B;IAE1B,IAAI,UAAU,CAAC,sBAAsB,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;QACxE,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,IAAI,UAAU,CAAC,uBAAuB,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QACjE,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,2BAA2B,CAAC,MAAoB;IACvD,IAAI,MAAM,CAAC,WAAW,KAAK,YAAY,EAAE,CAAC;QACxC,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,UAAU,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QACzE,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAgB,EAAE,MAAiB;IAC7D,OAAO,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AACvE,CAAC;AAED,SAAS,aAAa,CAAC,IAAe;IACpC,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;QACpC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;QACrC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,eAAe,CAAC,MAAoB,EAAE,IAAe;IAC5D,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,WAAW,KAAK,YAAY,EAAE,CAAC;YACxC,OAAO,CAAC,4FAA4F,CAAC,CAAC;QACxG,CAAC;QACD,OAAO;YACL,sFAAsF,MAAM,CAAC,YAAY,QAAQ;SAClH,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;QACrC,OAAO,CAAC,kFAAkF,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAe;IACzC,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;QACpC,OAAO,CAAC,4DAA4D,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;QACrC,OAAO,CAAC,kDAAkD,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,CAAC,0DAA0D,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc,EAAE,UAAkB;IAC/D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,8BAA8B,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,GAAG,GAAG,KAAqB,CAAC;IAClC,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,8BAA8B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,6BAA6B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,gCAAgC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,SAAS,EAAE,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAyC,EACzC,UAAkB;IAElB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,8BAA8B,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,cAAc,KAAK,sBAAsB,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,cAAc,KAAK,iCAAiC,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,cAAc,KAAK,0BAA0B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtG,CAAC;QAED,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,KAAK,IAAI;YAC5D,uBAAuB,EAAE,IAAI,CAAC,uBAAuB,KAAK,IAAI;YAC9D,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA0B,EAAE,KAAa;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,OAAO,aAAa,KAAK,WAAW,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe,EAAE,QAAgB;IAC1D,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,cAAc,KAAK,iBAAiB,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,iBAAiB,GAAG,CAAC,CAAC;IACpG,CAAC;IAED,OAAO,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe;IAC1C,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,IAAI,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3C,MAAM,IAAI,IAAI,CAAC;YACf,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,OAAO,CAAC;YAClB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,IAAI,GAAG,CAAC;IACd,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,aAAa,CACpB,KAAsC,EACtC,MAA2B;IAE3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC;AAED,SAAS,QAAQ,CAAC,IAAyB;IACzC,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,aAAa,CAAC,QAAQ,CAAC,KAAoB,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,WAAW,CAAC,QAAQ,CAAC,KAA4B,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,WAAW,CAAI,KAAU;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAK,CAAC;IAC1B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/readiness.d.ts

@@ -0,0 +1,35 @@
+import { RippleAdapterDetectionSummary } from "./adapters";
+import { GraphEngine } from "./graph";
+export declare const RIPPLE_CI_WORKFLOW_PATH = ".github/workflows/ripple.yml";
+export type RippleReadinessCheck = {
+    ok: boolean;
+    detail: string;
+    fix?: string;
+};
+export type RippleEnforcementLevel = "none" | "advisory" | "drift-check-ready" | "ci-gate-ready";
+export type RippleEnforcementReadiness = {
+    level: RippleEnforcementLevel;
+    summary: string;
+    canGuideAgents: boolean;
+    canDetectDrift: boolean;
+    canBlockInCi: boolean;
+    explicitPolicy: RippleReadinessCheck;
+    gaps: string[];
+};
+export type RippleReadinessSummary = {
+    status: "ready" | "needs_setup";
+    workspace: string;
+    sourceFiles: number;
+    symbols: number;
+    callEdges: number;
+    adapterSupport: RippleAdapterDetectionSummary;
+    enforcement: RippleEnforcementReadiness;
+    checks: {
+        graph: RippleReadinessCheck;
+        git: RippleReadinessCheck;
+        ciWorkflow: RippleReadinessCheck;
+        latestIntent: RippleReadinessCheck;
+    };
+    nextSteps: string[];
+};
+export declare function buildRippleReadinessSummary(workspaceRoot: string, engine: GraphEngine): RippleReadinessSummary;

package/dist/readiness.js

@@ -0,0 +1,200 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRippleReadinessSummary = 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");
+exports.RIPPLE_CI_WORKFLOW_PATH = ".github/workflows/ripple.yml";
+function buildRippleReadinessSummary(workspaceRoot, engine) {
+    const sourceFiles = engine.graph.files.size;
+    const symbols = engine.graph.symbols.size;
+    const callEdges = countCallEdges(engine);
+    const adapterSupport = (0, adapters_1.detectWorkspaceAdapters)(workspaceRoot);
+    const workflowPath = path.join(workspaceRoot, exports.RIPPLE_CI_WORKFLOW_PATH);
+    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 ciWorkflowOk = fs.existsSync(workflowPath);
+    const latestIntentOk = fs.existsSync(latestIntentPath);
+    const explicitPolicyOk = fs.existsSync(policyPath);
+    const checks = {
+        graph: {
+            ok: graphOk,
+            detail: graphOk
+                ? `${sourceFiles} source files, ${symbols} symbols, ${callEdges} call edges`
+                : "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.",
+        },
+        ciWorkflow: {
+            ok: ciWorkflowOk,
+            detail: ciWorkflowOk
+                ? exports.RIPPLE_CI_WORKFLOW_PATH
+                : "Missing .github/workflows/ripple.yml",
+            fix: ciWorkflowOk ? undefined : "Run ripple init.",
+        },
+        latestIntent: {
+            ok: latestIntentOk,
+            detail: latestIntentOk
+                ? formatWorkspacePath(workspaceRoot, latestIntentPath)
+                : "Missing .ripple/intents/latest.json",
+            fix: latestIntentOk
+                ? undefined
+                : "Run ripple plan --file <file> --task \"<task>\" --save before CI.",
+        },
+    };
+    const enforcement = buildEnforcementReadiness({
+        graphOk,
+        gitOk,
+        ciWorkflowOk,
+        latestIntentOk,
+        explicitPolicyOk,
+    });
+    const nextSteps = Object.values(checks)
+        .map((check) => check.fix)
+        .filter((fix) => Boolean(fix));
+    if (nextSteps.length === 0) {
+        nextSteps.push("Run ripple ci --base origin/main --intent latest --github-annotations.");
+    }
+    return {
+        status: Object.values(checks).every((check) => check.ok) ? "ready" : "needs_setup",
+        workspace: workspaceRoot,
+        sourceFiles,
+        symbols,
+        callEdges,
+        adapterSupport,
+        enforcement,
+        checks,
+        nextSteps,
+    };
+}
+exports.buildRippleReadinessSummary = buildRippleReadinessSummary;
+function buildEnforcementReadiness(input) {
+    const canGuideAgents = input.graphOk;
+    const canDetectDrift = input.graphOk && input.gitOk && input.latestIntentOk;
+    const canBlockInCi = canDetectDrift && input.ciWorkflowOk;
+    const level = enforcementLevel({
+        canGuideAgents,
+        canDetectDrift,
+        canBlockInCi,
+    });
+    const gaps = enforcementGaps(input);
+    return {
+        level,
+        summary: enforcementSummary(level),
+        canGuideAgents,
+        canDetectDrift,
+        canBlockInCi,
+        explicitPolicy: {
+            ok: input.explicitPolicyOk,
+            detail: input.explicitPolicyOk
+                ? ".ripple/policy.json"
+                : "Using built-in policy defaults",
+            fix: input.explicitPolicyOk
+                ? undefined
+                : "Run ripple policy init to make repo trust boundaries explicit.",
+        },
+        gaps,
+    };
+}
+function enforcementLevel(input) {
+    if (input.canBlockInCi) {
+        return "ci-gate-ready";
+    }
+    if (input.canDetectDrift) {
+        return "drift-check-ready";
+    }
+    if (input.canGuideAgents) {
+        return "advisory";
+    }
+    return "none";
+}
+function enforcementSummary(level) {
+    if (level === "ci-gate-ready") {
+        return "Ripple can guide agents, detect drift, and fail CI when the saved intent or boundary is violated.";
+    }
+    if (level === "drift-check-ready") {
+        return "Ripple can guide agents and detect drift locally, but CI blocking is not installed yet.";
+    }
+    if (level === "advisory") {
+        return "Ripple can provide context, but saved-intent drift checks or CI blocking are not fully ready.";
+    }
+    return "Ripple cannot enforce or guide safely until a supported repo graph is available.";
+}
+function enforcementGaps(input) {
+    const gaps = [];
+    if (!input.graphOk) {
+        gaps.push("No supported source graph is available.");
+    }
+    if (!input.gitOk) {
+        gaps.push("Git worktree is required for changed-file and CI drift checks.");
+    }
+    if (!input.latestIntentOk) {
+        gaps.push("No latest saved intent exists, so Ripple cannot compare agent work to a plan.");
+    }
+    if (!input.ciWorkflowOk) {
+        gaps.push("Ripple setup is missing the CI workflow, so unsafe changes cannot be blocked in PR checks.");
+    }
+    if (!input.explicitPolicyOk) {
+        gaps.push("No explicit .ripple/policy.json exists; Ripple is using built-in policy defaults.");
+    }
+    return gaps;
+}
+function countCallEdges(engine) {
+    let count = 0;
+    engine.graph.symbols.forEach((symbol) => {
+        count += symbol.calls.size;
+    });
+    return count;
+}
+function isGitWorktree(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";
+    }
+    catch {
+        return false;
+    }
+}
+function formatWorkspacePath(workspaceRoot, filePath) {
+    const relative = path.relative(workspaceRoot, filePath);
+    if (relative && !relative.startsWith("..") && !path.isAbsolute(relative)) {
+        return relative.split(path.sep).join("/");
+    }
+    return filePath;
+}
+//# sourceMappingURL=readiness.js.map

package/dist/readiness.js.map

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