@getripple/core 1.0.4

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# @getripple/core Changelog
+
+## [1.0.4] - 2026-06-03
+
+### Fixed
+- Publishable package identity under `@getripple/core`.
+- Release readiness checks for packed installs, package metadata, and shared engine entry points.
+- Package-specific README and changelog included in the npm tarball.
+
+## [1.0.3] - 2026-06-03
+
+### Added
+- Initial standalone package release of Ripple's core graph and workflow engine.
+- `GraphEngine` APIs for scanning a local repo, planning context, focus summaries, blast radius, and recent history.
+- Trust-boundary, policy, readiness, approval, audit, gate, and drift-repair summaries shared by CLI and MCP.
+
+### Notes
+- Public alpha. Prefer `@getripple/cli` for terminal use and `@getripple/mcp` for AI-agent integration.

package/README.md

@@ -0,0 +1,53 @@
+# @getripple/core
+
+The core graph engine that powers Ripple's VS Code extension, CLI, and MCP server.
+It scans a local repository, builds architectural context, and exposes the `GraphEngine`
+used by Ripple's plan-before-edit and check-after-edit workflow.
+
+Most users should not start here. Install `@getripple/cli` for terminal and CI
+workflows, or `@getripple/mcp` to give AI agents direct structured access to
+Ripple's architectural context.
+
+## Install
+
+```bash
+npm install @getripple/core
+```
+
+## Basic Usage
+
+```ts
+import { GraphEngine } from "@getripple/core";
+
+const engine = new GraphEngine(process.cwd());
+await engine.initialScan();
+
+const plan = engine.planContext(
+  "refactor token handling",
+  "src/auth.ts",
+  4000
+);
+```
+
+## What It Powers
+
+- file dependency and reverse-import graph
+- symbol and call-edge signals for JavaScript and TypeScript
+- focused context plans for AI coding agents
+- staged and changed-file checks against saved intent
+- trust-boundary, policy, readiness, and drift summaries
+
+## Trust Boundary Contract
+
+Ripple's core engine is the source of truth for control modes, editable files,
+context-only files, human gates, and continue/stop decisions. The CLI and MCP
+packages use this contract so humans, CI, and AI agents see the same workflow
+state.
+
+## Status
+
+Public alpha. APIs may change while Ripple's CLI and MCP workflows harden.
+
+## License
+
+MIT

package/dist/adapters.d.ts

@@ -0,0 +1,39 @@
+import { RippleAdapterCapabilities, RippleAdapterCapability } from "./types";
+export type RippleAdapterSupportLevel = "deep" | "generic";
+export type RippleAdapterCapabilityStatus = "available" | "partial" | "unavailable";
+export type RippleAdapterAgentUse = "trust" | "verify" | "manual";
+export type RippleAdapterCapabilityConfidence = {
+    capability: RippleAdapterCapability;
+    status: RippleAdapterCapabilityStatus;
+    confidence: number;
+    reason: string;
+    agentUse: RippleAdapterAgentUse;
+};
+export type RippleAdapterAgentPolicy = {
+    canTrust: string[];
+    beCarefulWith: string[];
+    mustFallbackToManual: string[];
+    planningGuidance: string[];
+};
+export type RippleDetectedAdapter = {
+    id: string;
+    supportLevel: RippleAdapterSupportLevel;
+    confidence: number;
+    capabilities: RippleAdapterCapabilities;
+    capabilityProfile: RippleAdapterCapabilityConfidence[];
+    agentPolicy: RippleAdapterAgentPolicy;
+    matchedFiles: number;
+    reason: string;
+};
+export type RippleAdapterDetectionSummary = {
+    workspace: string;
+    supportLevel: RippleAdapterSupportLevel;
+    primaryAdapter: RippleDetectedAdapter;
+    adapters: RippleDetectedAdapter[];
+};
+export declare const JS_TS_ADAPTER_CAPABILITIES: RippleAdapterCapabilities;
+export declare const PYTHON_ADAPTER_CAPABILITIES: RippleAdapterCapabilities;
+export declare const GENERIC_ADAPTER_CAPABILITIES: RippleAdapterCapabilities;
+export declare function detectWorkspaceAdapters(workspaceRoot: string): RippleAdapterDetectionSummary;
+export declare function hasAdapterCapability(adapter: RippleDetectedAdapter, capability: RippleAdapterCapability): boolean;
+export declare function adapterCapabilityConfidence(adapter: RippleDetectedAdapter, capability: RippleAdapterCapability): RippleAdapterCapabilityConfidence | undefined;

package/dist/adapters.js

@@ -0,0 +1,396 @@
+"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.adapterCapabilityConfidence = exports.hasAdapterCapability = exports.detectWorkspaceAdapters = exports.GENERIC_ADAPTER_CAPABILITIES = exports.PYTHON_ADAPTER_CAPABILITIES = exports.JS_TS_ADAPTER_CAPABILITIES = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const JS_TS_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx"];
+const PYTHON_EXTENSIONS = [".py"];
+const ALL_ADAPTER_CAPABILITIES = [
+    "files",
+    "dependencies",
+    "reverse-dependencies",
+    "symbols",
+    "call-edges",
+    "tests",
+    "configs",
+];
+const GENERIC_IGNORE_DIRS = new Set([
+    ".git",
+    ".next",
+    ".ripple",
+    ".turbo",
+    ".vercel",
+    "coverage",
+    "dist",
+    "node_modules",
+    "out",
+]);
+exports.JS_TS_ADAPTER_CAPABILITIES = {
+    language: "typescript",
+    displayName: "JavaScript / TypeScript",
+    extensions: JS_TS_EXTENSIONS,
+    capabilities: [
+        "files",
+        "dependencies",
+        "reverse-dependencies",
+        "symbols",
+        "call-edges",
+        "tests",
+        "configs",
+    ],
+};
+exports.PYTHON_ADAPTER_CAPABILITIES = {
+    language: "python",
+    displayName: "Python",
+    extensions: PYTHON_EXTENSIONS,
+    capabilities: [
+        "files",
+        "dependencies",
+        "reverse-dependencies",
+        "symbols",
+        "call-edges",
+        "tests",
+        "configs",
+    ],
+};
+exports.GENERIC_ADAPTER_CAPABILITIES = {
+    language: "generic",
+    displayName: "Generic repository",
+    extensions: ["*"],
+    capabilities: ["files", "configs"],
+};
+function detectWorkspaceAdapters(workspaceRoot) {
+    const extensionCounts = countExtensions(workspaceRoot);
+    const jsTsCount = JS_TS_EXTENSIONS.reduce((total, extension) => total + (extensionCounts.get(extension) ?? 0), 0);
+    const pythonCount = PYTHON_EXTENSIONS.reduce((total, extension) => total + (extensionCounts.get(extension) ?? 0), 0);
+    const totalFiles = Array.from(extensionCounts.values()).reduce((total, count) => total + count, 0);
+    const adapters = [];
+    if (jsTsCount > 0) {
+        adapters.push({
+            id: "builtin-js-ts",
+            supportLevel: "deep",
+            confidence: 0.94,
+            capabilities: {
+                ...exports.JS_TS_ADAPTER_CAPABILITIES,
+                language: preferredJsTsLanguage(extensionCounts),
+            },
+            capabilityProfile: jsTsCapabilityProfile(),
+            agentPolicy: jsTsAgentPolicy(),
+            matchedFiles: jsTsCount,
+            reason: "Detected JavaScript or TypeScript source files.",
+        });
+    }
+    if (pythonCount > 0) {
+        adapters.push({
+            id: "builtin-python",
+            supportLevel: "deep",
+            confidence: 0.86,
+            capabilities: exports.PYTHON_ADAPTER_CAPABILITIES,
+            capabilityProfile: pythonCapabilityProfile(),
+            agentPolicy: pythonAgentPolicy(),
+            matchedFiles: pythonCount,
+            reason: "Detected Python source files.",
+        });
+    }
+    const hasDeepAdapter = jsTsCount > 0 || pythonCount > 0;
+    adapters.push({
+        id: "builtin-generic",
+        supportLevel: "generic",
+        confidence: hasDeepAdapter ? 0.55 : 0.45,
+        capabilities: exports.GENERIC_ADAPTER_CAPABILITIES,
+        capabilityProfile: genericCapabilityProfile(),
+        agentPolicy: genericAgentPolicy(),
+        matchedFiles: totalFiles,
+        reason: hasDeepAdapter
+            ? "Generic fallback remains available for files outside the active language adapters."
+            : "No deep language adapter matched; using generic repository support.",
+    });
+    const primaryAdapter = adapters
+        .filter((adapter) => adapter.supportLevel === "deep")
+        .sort((a, b) => b.matchedFiles - a.matchedFiles || b.confidence - a.confidence)[0] ??
+        adapters[0];
+    return {
+        workspace: workspaceRoot,
+        supportLevel: primaryAdapter.supportLevel,
+        primaryAdapter,
+        adapters,
+    };
+}
+exports.detectWorkspaceAdapters = detectWorkspaceAdapters;
+function hasAdapterCapability(adapter, capability) {
+    return adapter.capabilities.capabilities.includes(capability);
+}
+exports.hasAdapterCapability = hasAdapterCapability;
+function adapterCapabilityConfidence(adapter, capability) {
+    return adapter.capabilityProfile.find((item) => item.capability === capability);
+}
+exports.adapterCapabilityConfidence = adapterCapabilityConfidence;
+function jsTsCapabilityProfile() {
+    return [
+        {
+            capability: "files",
+            status: "available",
+            confidence: 0.99,
+            reason: "JS/TS file discovery is extension based and excludes generated/cache folders.",
+            agentUse: "trust",
+        },
+        {
+            capability: "dependencies",
+            status: "available",
+            confidence: 0.94,
+            reason: "Static import/export and require edges are parsed from JS/TS source.",
+            agentUse: "trust",
+        },
+        {
+            capability: "reverse-dependencies",
+            status: "available",
+            confidence: 0.94,
+            reason: "Reverse edges are derived from the same static dependency graph.",
+            agentUse: "trust",
+        },
+        {
+            capability: "symbols",
+            status: "available",
+            confidence: 0.9,
+            reason: "Functions, classes, methods, variables, and exported symbols are parsed with TypeScript AST support.",
+            agentUse: "trust",
+        },
+        {
+            capability: "call-edges",
+            status: "partial",
+            confidence: 0.74,
+            reason: "Direct call references are useful, but dynamic dispatch, reflection, and framework wiring can hide edges.",
+            agentUse: "verify",
+        },
+        {
+            capability: "tests",
+            status: "partial",
+            confidence: 0.72,
+            reason: "Test links use imports and naming conventions; framework-specific behavior may need manual confirmation.",
+            agentUse: "verify",
+        },
+        {
+            capability: "configs",
+            status: "partial",
+            confidence: 0.68,
+            reason: "Common JS/TS config files are detected, but project-specific runtime config can be custom.",
+            agentUse: "verify",
+        },
+    ];
+}
+function genericCapabilityProfile() {
+    return ALL_ADAPTER_CAPABILITIES.map((capability) => {
+        if (capability === "files") {
+            return {
+                capability,
+                status: "available",
+                confidence: 0.72,
+                reason: "Generic support can discover repository files while ignoring common generated folders.",
+                agentUse: "trust",
+            };
+        }
+        if (capability === "configs") {
+            return {
+                capability,
+                status: "partial",
+                confidence: 0.42,
+                reason: "Generic support can notice config-like files, but cannot interpret every stack-specific setting.",
+                agentUse: "verify",
+            };
+        }
+        return {
+            capability,
+            status: "unavailable",
+            confidence: 0,
+            reason: "No deep language adapter is active for this capability.",
+            agentUse: "manual",
+        };
+    });
+}
+function pythonCapabilityProfile() {
+    return [
+        {
+            capability: "files",
+            status: "available",
+            confidence: 0.98,
+            reason: "Python file discovery is extension based and excludes generated/cache folders.",
+            agentUse: "trust",
+        },
+        {
+            capability: "dependencies",
+            status: "partial",
+            confidence: 0.78,
+            reason: "Static import and from-import statements are parsed, but dynamic imports can hide edges.",
+            agentUse: "verify",
+        },
+        {
+            capability: "reverse-dependencies",
+            status: "partial",
+            confidence: 0.78,
+            reason: "Reverse edges are derived from parsed Python imports and package-relative resolution.",
+            agentUse: "verify",
+        },
+        {
+            capability: "symbols",
+            status: "available",
+            confidence: 0.82,
+            reason: "Python functions, async functions, classes, and methods are detected from source structure.",
+            agentUse: "trust",
+        },
+        {
+            capability: "call-edges",
+            status: "partial",
+            confidence: 0.58,
+            reason: "Name-based Python call edges catch direct calls but cannot prove dynamic dispatch or monkey patching.",
+            agentUse: "verify",
+        },
+        {
+            capability: "tests",
+            status: "partial",
+            confidence: 0.7,
+            reason: "Pytest/unittest-style test files are linked through imports and naming conventions.",
+            agentUse: "verify",
+        },
+        {
+            capability: "configs",
+            status: "partial",
+            confidence: 0.62,
+            reason: "Common Python config files can be detected, but runtime behavior may live in custom settings.",
+            agentUse: "verify",
+        },
+    ];
+}
+function jsTsAgentPolicy() {
+    return {
+        canTrust: [
+            "JS/TS source file discovery",
+            "static imports and reverse importers",
+            "declared symbols and exported contracts",
+            "direct test files found through imports",
+        ],
+        beCarefulWith: [
+            "dynamic import paths",
+            "runtime framework routing",
+            "dependency injection or reflection",
+            "generated files and build artifacts",
+            "indirect tests discovered only by naming conventions",
+        ],
+        mustFallbackToManual: [
+            "non-JS/TS services in the same repo",
+            "runtime behavior hidden behind external configuration",
+            "call paths created by strings, decorators, or framework metadata",
+        ],
+        planningGuidance: [
+            "Use readFirst, symbolFocus, importers, and verificationTargets as primary planning signals.",
+            "For call-edge-only risk, verify direct callers before assuming the graph is complete.",
+            "If a task touches runtime routing or generated code, inspect framework config manually.",
+        ],
+    };
+}
+function pythonAgentPolicy() {
+    return {
+        canTrust: [
+            "Python source file discovery",
+            "declared functions, classes, and methods",
+            "top-level static import statements",
+            "direct test files found through imports",
+        ],
+        beCarefulWith: [
+            "dynamic imports through importlib or __import__",
+            "runtime monkey patching and dependency injection",
+            "framework routing through decorators or external config",
+            "namespace packages without explicit local files",
+            "tests discovered only by naming convention",
+        ],
+        mustFallbackToManual: [
+            "metaclass behavior and decorators that rewrite call paths",
+            "runtime plugin loading",
+            "package imports resolved only through virtual environments",
+            "behavior controlled by deployment-specific config",
+        ],
+        planningGuidance: [
+            "Use readFirst, importers, symbolFocus, and verificationTargets as structural planning signals.",
+            "Verify call-edge and test-target findings before relying on them for commit safety.",
+            "Inspect decorators, framework routes, and dynamic imports manually when they are part of the task.",
+        ],
+    };
+}
+function genericAgentPolicy() {
+    return {
+        canTrust: [
+            "repository file discovery",
+            "git changed-file scope",
+            "basic config and documentation presence",
+        ],
+        beCarefulWith: [
+            "all dependency relationships",
+            "all symbol and function-level conclusions",
+            "test target recommendations",
+        ],
+        mustFallbackToManual: [
+            "callers and blast radius",
+            "public contracts",
+            "language-specific tests",
+            "framework routes and runtime wiring",
+        ],
+        planningGuidance: [
+            "Use Ripple as a file-level and git-scope guide only.",
+            "Read language-specific entry points and tests manually before editing.",
+            "Treat missing symbols or call edges as unknown, not safe.",
+        ],
+    };
+}
+function preferredJsTsLanguage(extensionCounts) {
+    const typeScriptCount = (extensionCounts.get(".ts") ?? 0) + (extensionCounts.get(".tsx") ?? 0);
+    return typeScriptCount > 0 ? "typescript" : "javascript";
+}
+function countExtensions(workspaceRoot) {
+    const counts = new Map();
+    walkWorkspace(workspaceRoot, (filePath) => {
+        const extension = path.extname(filePath).toLowerCase();
+        counts.set(extension, (counts.get(extension) ?? 0) + 1);
+    });
+    return counts;
+}
+function walkWorkspace(root, visitFile) {
+    if (!fs.existsSync(root)) {
+        return;
+    }
+    const entries = fs.readdirSync(root, { withFileTypes: true });
+    entries.forEach((entry) => {
+        if (entry.isDirectory()) {
+            if (GENERIC_IGNORE_DIRS.has(entry.name)) {
+                return;
+            }
+            walkWorkspace(path.join(root, entry.name), visitFile);
+            return;
+        }
+        if (entry.isFile()) {
+            visitFile(path.join(root, entry.name));
+        }
+    });
+}
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

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

package/dist/agent-workflow.d.ts

@@ -0,0 +1,86 @@
+export type AgentControlMode = "brainstorm" | "function" | "file" | "task" | "pr";
+export type AgentAuditGate = "beforeRiskyEdit" | "afterStaging" | "beforeMerge";
+export type AgentRuntimePhaseId = "discover_contract" | "plan_before_edit" | "approval_gate" | "edit_inside_boundary" | "audit_after_change" | "repair_or_handoff";
+export type AgentRuntimeNextPhaseId = AgentRuntimePhaseId | "done";
+export type AgentRuntimePhase = {
+    id: AgentRuntimePhaseId;
+    order: number;
+    requiredWhen: string;
+    agentAction: string;
+    mcpTool?: string;
+    cliCommand?: string;
+    outputContract?: string;
+    must: string[];
+    stopIf: string[];
+    continueIf: string[];
+};
+export type AgentWorkflowSummary = {
+    protocol: "ripple-agent-workflow";
+    version: 1;
+    purpose: string;
+    loop: string[];
+    controlModes: Record<AgentControlMode, string>;
+    auditGates: Record<AgentAuditGate, string>;
+    policyWorkflow: {
+        defaultAgentPath: string;
+        policyOnlyPath: string;
+        policyDriftPath: string;
+    };
+    commands: {
+        guide: string;
+        initializeRepo: string;
+        checkReadiness: string;
+        installCi: string;
+        explainPolicy: string;
+        planBeforeEditing: string;
+        checkAfterStaging: string;
+        checkChangedAgainstBase: string;
+        auditCurrentChange: string;
+        gateCurrentChange: string;
+        checkApproval: string;
+        approveHumanGate: string;
+        ciGate: string;
+        repairIntentDrift: string;
+    };
+    mcpTools: {
+        workflow: "ripple_get_agent_workflow";
+        checkReadiness: "ripple_doctor";
+        explainPolicy: "ripple_explain_policy";
+        planBeforeEditing: "ripple_plan_context";
+        checkAfterStaging: "ripple_check_staged";
+        checkChangedAgainstBase: "ripple_check_changed";
+        auditCurrentChange: "ripple_audit_change";
+        gateCurrentChange: "ripple_gate";
+        checkApproval: "ripple_get_approval_status";
+        repairIntentDrift: "ripple_repair_intent_drift";
+    };
+    outputContracts: {
+        doctorHeader: "RIPPLE_DOCTOR";
+        planHeader: "RIPPLE_AGENT_CONTEXT";
+        stagedCheckHeader: "RIPPLE_STAGED_CHECK";
+        repairHeader: "RIPPLE_INTENT_DRIFT_REPAIR";
+        auditHeader: "RIPPLE_AUDIT";
+        gateHeader: "RIPPLE_GATE";
+        approvalHeader: "RIPPLE_APPROVAL";
+        approvalStatusHeader: "RIPPLE_APPROVAL_STATUS";
+        doctorSections: string[];
+        planSections: string[];
+        stagedCheckSections: string[];
+        repairSections: string[];
+        auditSections: string[];
+        gateSections: string[];
+    };
+    runtimeContract: {
+        protocol: "ripple-agent-runtime-contract";
+        version: 1;
+        invariant: string;
+        compatibleRuntimes: string[];
+        sourceOfTruth: string[];
+        phases: AgentRuntimePhase[];
+        stopConditions: string[];
+        proceedConditions: string[];
+    };
+    rules: string[];
+    example: string[];
+};
+export declare function getAgentWorkflowSummary(): AgentWorkflowSummary;