rippletide-package 0.1.0

package/reviewer/codex/rippletide-reviewer/scripts/rippletide-codex

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -P "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CODEX_NODE="$HOME/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/bin/node"
+
+if command -v node >/dev/null 2>&1; then
+  exec node "$SCRIPT_DIR/rippletide-codex.mjs" "$@"
+fi
+
+if [[ -x "$CODEX_NODE" ]]; then
+  exec "$CODEX_NODE" "$SCRIPT_DIR/rippletide-codex.mjs" "$@"
+fi
+
+echo "Rippletide Codex mode needs Node.js to run." >&2
+exit 127

package/reviewer/codex/rippletide-reviewer/scripts/rippletide-codex.mjs

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+
+const roots = [
+  process.env.RIPPLETIDE_REVIEWER_ROOT,
+  path.resolve(scriptDir, "../../.."),
+  process.cwd(),
+].filter(Boolean);
+
+const reviewerRoot = [...new Set(roots.map((root) => path.resolve(root)))]
+  .find((root) => existsSync(path.join(root, "src/integrations/codex/prepare.js")));
+
+if (!reviewerRoot) {
+  console.error("Rippletide reviewer source not found.");
+  console.error("Set RIPPLETIDE_REVIEWER_ROOT=/path/to/reviewer and rerun.");
+  process.exit(1);
+}
+
+await import(pathToFileURL(path.join(reviewerRoot, "src/integrations/codex/prepare.js")).href);

package/reviewer/codex/rippletide-reviewer/scripts/rippletide-reviewer

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd -P "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+RELATIVE_REVIEWER_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+REVIEWER_ROOT="${RIPPLETIDE_REVIEWER_ROOT:-}"
+
+if [[ -z "$REVIEWER_ROOT" && -f "$RELATIVE_REVIEWER_ROOT/bin/rippletide.js" ]]; then
+  REVIEWER_ROOT="$RELATIVE_REVIEWER_ROOT"
+fi
+
+if [[ -z "$REVIEWER_ROOT" ]]; then
+  REVIEWER_ROOT="$RELATIVE_REVIEWER_ROOT"
+fi
+
+CLI="$REVIEWER_ROOT/bin/rippletide.js"
+CODEX_NODE="$HOME/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/bin/node"
+
+if [[ ! -f "$CLI" ]]; then
+  echo "Rippletide CLI not found at $CLI" >&2
+  exit 1
+fi
+
+if command -v bun >/dev/null 2>&1; then
+  exec bun "$CLI" "$@"
+fi
+
+if command -v node >/dev/null 2>&1; then
+  exec node "$CLI" "$@"
+fi
+
+if [[ -x "$CODEX_NODE" ]]; then
+  exec "$CODEX_NODE" "$CLI" "$@"
+fi
+
+echo "Rippletide needs Bun or Node.js to run." >&2
+exit 127

package/reviewer/src/connect/evidence.js

@@ -0,0 +1,235 @@
+import { existsSync } from "node:fs";
+import { readdir, readFile, stat } from "node:fs/promises";
+import path from "node:path";
+
+export const DEFAULT_EVIDENCE_BUDGET = 140_000;
+export const MAX_FILES = 260;
+export const MAX_FILE_BYTES = 300_000;
+
+export const IGNORED_DIRS = new Set([
+  ".cache",
+  ".git",
+  ".next",
+  ".pytest_cache",
+  ".ruff_cache",
+  ".rippletide",
+  ".turbo",
+  ".venv",
+  "__pycache__",
+  "build",
+  "coverage",
+  "dist",
+  "node_modules",
+  "target",
+  "tmp",
+  "vendor",
+]);
+
+export const SOURCE_EXTENSIONS = new Set([
+  ".c",
+  ".cc",
+  ".cfg",
+  ".cjs",
+  ".cpp",
+  ".cs",
+  ".css",
+  ".go",
+  ".html",
+  ".ini",
+  ".java",
+  ".js",
+  ".json",
+  ".jsx",
+  ".kt",
+  ".lua",
+  ".md",
+  ".mjs",
+  ".php",
+  ".prompt",
+  ".properties",
+  ".py",
+  ".rb",
+  ".rs",
+  ".sh",
+  ".sql",
+  ".toml",
+  ".ts",
+  ".tsx",
+  ".txt",
+  ".xml",
+  ".yaml",
+  ".yml",
+]);
+
+export const SOURCE_FILENAMES = new Set([
+  ".env.example",
+  ".env.sample",
+  "AGENTS.md",
+  "Dockerfile",
+  "Gemfile",
+  "Makefile",
+  "Procfile",
+  "go.mod",
+  "package-lock.json",
+  "package.json",
+  "pnpm-lock.yaml",
+  "poetry.lock",
+  "pyproject.toml",
+  "requirements.txt",
+  "yarn.lock",
+]);
+
+export async function collectFiles(root, maxFiles = MAX_FILES) {
+  const files = [];
+
+  async function walk(directory, depth) {
+    if (files.length >= maxFiles || depth > 7) return;
+    const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
+
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+      if (files.length >= maxFiles) return;
+      const absolutePath = path.join(directory, entry.name);
+      const relativePath = path.relative(root, absolutePath) || entry.name;
+
+      if (entry.isDirectory()) {
+        if (!IGNORED_DIRS.has(entry.name)) {
+          await walk(absolutePath, depth + 1);
+        }
+        continue;
+      }
+
+      if (!entry.isFile()) continue;
+      if (!SOURCE_EXTENSIONS.has(path.extname(entry.name)) && !SOURCE_FILENAMES.has(entry.name)) continue;
+      files.push(relativePath);
+    }
+  }
+
+  await walk(root, 0);
+  return files;
+}
+
+export async function readSource(root, file) {
+  const absolutePath = path.join(root, file);
+  const info = await stat(absolutePath).catch(() => null);
+  if (!info || info.size > MAX_FILE_BYTES) return "";
+  return readFile(absolutePath, "utf8").catch(() => "");
+}
+
+export function redactSecrets(source) {
+  return source
+    .replace(/\bsk-[A-Za-z0-9_-]{16,}\b/g, "sk-[REDACTED]")
+    .replace(/\b([A-Z0-9_]*(?:API_KEY|ACCESS_TOKEN|AUTH_TOKEN|BOT_TOKEN|SECRET|PASSWORD|PRIVATE_KEY)[A-Z0-9_]*\s*=\s*)[^\s"'`]+/g, "$1[REDACTED]")
+    .replace(/(["'`](?:api[_-]?key|access[_-]?token|auth[_-]?token|bot[_-]?token|secret|password|private[_-]?key)["'`]\s*:\s*["'`])([^"'`\n]+)(["'`])/gi, "$1[REDACTED]$3");
+}
+
+export function lineNumberedSource(source, maxChars) {
+  const sanitized = redactSecrets(source).replace(/\t/g, "  ");
+  const lines = sanitized.split("\n");
+  const output = [];
+  let used = 0;
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const rendered = `${String(index + 1).padStart(4, " ")} | ${lines[index]}`;
+    if (used + rendered.length + 1 > maxChars) {
+      output.push("... truncated for context budget ...");
+      break;
+    }
+    output.push(rendered);
+    used += rendered.length + 1;
+  }
+
+  return output.join("\n");
+}
+
+export function buildEvidencePack(root, files, sources, options = {}) {
+  const budget = options.budget ?? DEFAULT_EVIDENCE_BUDGET;
+  const title = options.title ?? "Rippletide Local Evidence Pack";
+  const description = options.description
+    ?? "This is raw local evidence for an LLM inspector. It is not a review; it only packages included files.";
+  const citationRule = options.citationRule
+    ?? "Citation rule for the inspector: cite facts as `path/to/file.ext:line` using the line numbers shown in the excerpts.";
+
+  const sections = [
+    `# ${title}`,
+    "",
+    description,
+    "",
+    "## Scan",
+    `- Root: ${root}`,
+    `- Source/config/doc files found: ${files.length}`,
+    `- Context budget: ${budget} characters`,
+    "",
+    "## File Tree",
+    files.map((file) => `- ${file}`).join("\n") || "- No source files found.",
+    "",
+    "## Source Excerpts",
+  ];
+
+  let remaining = budget;
+  const included = [];
+  const skipped = [];
+
+  for (const item of sources) {
+    if (remaining < 2_500) {
+      skipped.push(item.file);
+      continue;
+    }
+
+    const perFileBudget = Math.min(20_000, Math.max(2_500, remaining - 1_000));
+    const excerpt = lineNumberedSource(item.source, perFileBudget);
+    const block = [
+      "",
+      `### ${item.file}`,
+      "```text",
+      excerpt,
+      "```",
+    ].join("\n");
+
+    if (block.length > remaining) {
+      skipped.push(item.file);
+      continue;
+    }
+
+    sections.push(block);
+    included.push(item.file);
+    remaining -= block.length;
+  }
+
+  sections.push(
+    "",
+    "## Context Packing Summary",
+    `- Files included with excerpts: ${included.length}`,
+    `- Files omitted after budget: ${skipped.length ? skipped.join(", ") : "none"}`,
+    "",
+    citationRule,
+  );
+
+  return sections.join("\n");
+}
+
+export async function collectAgentContext(targetPath, options = {}) {
+  const root = path.resolve(targetPath ?? ".");
+  if (!existsSync(root)) {
+    throw new Error(`Path does not exist: ${root}`);
+  }
+
+  const files = await collectFiles(root);
+  const sources = [];
+
+  for (const file of files) {
+    const source = await readSource(root, file);
+    if (source) sources.push({ file, source });
+  }
+
+  return {
+    evidencePack: buildEvidencePack(root, files, sources, {
+      budget: options.evidenceBudget ?? DEFAULT_EVIDENCE_BUDGET,
+      citationRule: options.citationRule,
+      description: options.description,
+      title: options.title,
+    }),
+    files,
+    root,
+    sources,
+  };
+}