repodoc-local 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/README.md +128 -2
  2. package/dist/agent-loop.d.ts +21 -0
  3. package/dist/agent-loop.d.ts.map +1 -0
  4. package/dist/agent-loop.js +549 -0
  5. package/dist/agent-loop.js.map +1 -0
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +337 -0
  9. package/dist/cli.js.map +1 -0
  10. package/dist/file-walker.d.ts +30 -0
  11. package/dist/file-walker.d.ts.map +1 -0
  12. package/dist/file-walker.js +164 -0
  13. package/dist/file-walker.js.map +1 -0
  14. package/dist/followup.d.ts +25 -0
  15. package/dist/followup.d.ts.map +1 -0
  16. package/dist/followup.js +185 -0
  17. package/dist/followup.js.map +1 -0
  18. package/dist/guardrails.d.ts +28 -0
  19. package/dist/guardrails.d.ts.map +1 -0
  20. package/dist/guardrails.js +241 -0
  21. package/dist/guardrails.js.map +1 -0
  22. package/dist/hardware-detector.d.ts +6 -0
  23. package/dist/hardware-detector.d.ts.map +1 -0
  24. package/dist/hardware-detector.js +121 -0
  25. package/dist/hardware-detector.js.map +1 -0
  26. package/dist/local-llm.d.ts +49 -0
  27. package/dist/local-llm.d.ts.map +1 -0
  28. package/dist/local-llm.js +173 -0
  29. package/dist/local-llm.js.map +1 -0
  30. package/dist/model-manager.d.ts +9 -0
  31. package/dist/model-manager.d.ts.map +1 -0
  32. package/dist/model-manager.js +97 -0
  33. package/dist/model-manager.js.map +1 -0
  34. package/dist/persistence.d.ts +17 -0
  35. package/dist/persistence.d.ts.map +1 -0
  36. package/dist/persistence.js +88 -0
  37. package/dist/persistence.js.map +1 -0
  38. package/dist/secret-redactor.d.ts +19 -0
  39. package/dist/secret-redactor.d.ts.map +1 -0
  40. package/dist/secret-redactor.js +92 -0
  41. package/dist/secret-redactor.js.map +1 -0
  42. package/dist/security/audit.d.ts +15 -0
  43. package/dist/security/audit.d.ts.map +1 -0
  44. package/dist/security/audit.js +200 -0
  45. package/dist/security/audit.js.map +1 -0
  46. package/dist/types.d.ts +97 -0
  47. package/dist/types.d.ts.map +1 -0
  48. package/dist/types.js +6 -0
  49. package/dist/types.js.map +1 -0
  50. package/package.json +63 -4
  51. package/prompts/analyze-e2b.txt +28 -0
  52. package/prompts/analyze-e4b.txt +31 -0
  53. package/repodoc.example.yml +27 -0
@@ -0,0 +1,49 @@
1
+ import { ModelTier } from "./types.js";
2
+ export interface LLMOptions {
3
+ model: ModelTier;
4
+ temperature?: number;
5
+ maxTokens?: number;
6
+ stream?: boolean;
7
+ }
8
+ export interface LLMResponse {
9
+ text: string;
10
+ tokensUsed?: number;
11
+ promptTokens?: number;
12
+ doneReason?: string;
13
+ durationMs: number;
14
+ }
15
+ export interface CompleteOptions {
16
+ format?: string | "json";
17
+ think?: boolean;
18
+ options?: {
19
+ num_ctx?: number;
20
+ num_predict?: number;
21
+ temperature?: number;
22
+ [key: string]: unknown;
23
+ };
24
+ }
25
+ /**
26
+ * Map a ModelTier to the Ollama model tag.
27
+ * NOTE: Tags are gemma3 placeholders; update to real Gemma 4 tags in Phase 0.
28
+ */
29
+ export declare function getOllamaTag(tier: ModelTier): string;
30
+ export declare class LocalLLM {
31
+ private options;
32
+ private ollamaTag;
33
+ constructor(options: LLMOptions);
34
+ /**
35
+ * Check whether Ollama is reachable on localhost.
36
+ * Returns true on HTTP 200, false on any error.
37
+ */
38
+ isAvailable(): Promise<boolean>;
39
+ /**
40
+ * Run a one-shot (non-streaming) completion.
41
+ */
42
+ complete(prompt: string, callOpts?: CompleteOptions): Promise<LLMResponse>;
43
+ /**
44
+ * Stream a completion, yielding text chunks as they arrive.
45
+ * Uses NDJSON (one JSON object per line, stream: true).
46
+ */
47
+ stream(prompt: string): AsyncGenerator<string>;
48
+ }
49
+ //# sourceMappingURL=local-llm.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-llm.d.ts","sourceRoot":"","sources":["../src/local-llm.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAWpD;AAED,qBAAa,QAAQ;IAGP,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,SAAS,CAAS;gBAEN,OAAO,EAAE,UAAU;IAIvC;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAarC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAwDhF;;;OAGG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;CAkFtD"}
@@ -0,0 +1,173 @@
1
+ // ─────────────────────────────────────────────────────────────────────────────
2
+ // repoDoc Local — LocalLLM: Ollama inference module
3
+ // All network calls stay on localhost:11434 only.
4
+ // ─────────────────────────────────────────────────────────────────────────────
5
+ const OLLAMA_BASE = "http://localhost:11434";
6
+ /**
7
+ * Map a ModelTier to the Ollama model tag.
8
+ * NOTE: Tags are gemma3 placeholders; update to real Gemma 4 tags in Phase 0.
9
+ */
10
+ export function getOllamaTag(tier) {
11
+ switch (tier) {
12
+ case "gemma-4-e4b":
13
+ return "gemma4:e4b";
14
+ case "gemma-4-e2b":
15
+ return "gemma4:e2b";
16
+ default: {
17
+ const _exhaustive = tier;
18
+ throw new Error(`Unknown ModelTier: ${_exhaustive}`);
19
+ }
20
+ }
21
+ }
22
+ export class LocalLLM {
23
+ options;
24
+ ollamaTag;
25
+ constructor(options) {
26
+ this.options = options;
27
+ this.ollamaTag = getOllamaTag(options.model);
28
+ }
29
+ /**
30
+ * Check whether Ollama is reachable on localhost.
31
+ * Returns true on HTTP 200, false on any error.
32
+ */
33
+ async isAvailable() {
34
+ try {
35
+ const res = await fetch(`${OLLAMA_BASE}/api/tags`);
36
+ if (res.ok)
37
+ return true;
38
+ return false;
39
+ }
40
+ catch {
41
+ console.error("Ollama is not running. Start it with: ollama serve");
42
+ return false;
43
+ }
44
+ }
45
+ /**
46
+ * Run a one-shot (non-streaming) completion.
47
+ */
48
+ async complete(prompt, callOpts) {
49
+ const start = Date.now();
50
+ let res;
51
+ try {
52
+ res = await fetch(`${OLLAMA_BASE}/api/generate`, {
53
+ method: "POST",
54
+ headers: { "Content-Type": "application/json" },
55
+ body: JSON.stringify({
56
+ model: this.ollamaTag,
57
+ prompt,
58
+ stream: false,
59
+ format: callOpts?.format !== undefined ? callOpts.format : "json",
60
+ think: callOpts?.think ?? false,
61
+ options: {
62
+ num_ctx: callOpts?.options?.num_ctx ?? 8192,
63
+ num_predict: callOpts?.options?.num_predict ?? 1024,
64
+ temperature: callOpts?.options?.temperature ?? 0,
65
+ ...callOpts?.options,
66
+ },
67
+ }),
68
+ });
69
+ }
70
+ catch (err) {
71
+ throw new Error(`Failed to reach Ollama at ${OLLAMA_BASE}. Is it running? (ollama serve)\n${err}`);
72
+ }
73
+ if (!res.ok) {
74
+ const body = await res.text().catch(() => "");
75
+ throw new Error(`Ollama returned HTTP ${res.status}: ${body}`);
76
+ }
77
+ let json;
78
+ try {
79
+ json = (await res.json());
80
+ }
81
+ catch (err) {
82
+ throw new Error(`Failed to parse Ollama response JSON: ${err}`);
83
+ }
84
+ return {
85
+ text: json.response,
86
+ tokensUsed: json.eval_count,
87
+ promptTokens: json.prompt_eval_count,
88
+ doneReason: json.done_reason,
89
+ durationMs: Date.now() - start,
90
+ };
91
+ }
92
+ /**
93
+ * Stream a completion, yielding text chunks as they arrive.
94
+ * Uses NDJSON (one JSON object per line, stream: true).
95
+ */
96
+ async *stream(prompt) {
97
+ let res;
98
+ try {
99
+ res = await fetch(`${OLLAMA_BASE}/api/generate`, {
100
+ method: "POST",
101
+ headers: { "Content-Type": "application/json" },
102
+ body: JSON.stringify({
103
+ model: this.ollamaTag,
104
+ prompt,
105
+ stream: true,
106
+ format: "json",
107
+ think: false,
108
+ options: {
109
+ num_ctx: 8192,
110
+ num_predict: 1024,
111
+ temperature: 0,
112
+ },
113
+ }),
114
+ });
115
+ }
116
+ catch (err) {
117
+ throw new Error(`Failed to reach Ollama at ${OLLAMA_BASE}. Is it running? (ollama serve)\n${err}`);
118
+ }
119
+ if (!res.ok) {
120
+ const body = await res.text().catch(() => "");
121
+ throw new Error(`Ollama returned HTTP ${res.status}: ${body}`);
122
+ }
123
+ if (!res.body) {
124
+ throw new Error("Ollama response has no body — cannot stream.");
125
+ }
126
+ const reader = res.body.getReader();
127
+ const decoder = new TextDecoder("utf-8");
128
+ let buffer = "";
129
+ try {
130
+ while (true) {
131
+ const { done, value } = await reader.read();
132
+ if (done)
133
+ break;
134
+ buffer += decoder.decode(value, { stream: true });
135
+ const lines = buffer.split("\n");
136
+ // Keep the last (potentially incomplete) line in the buffer
137
+ buffer = lines.pop() ?? "";
138
+ for (const line of lines) {
139
+ const trimmed = line.trim();
140
+ if (!trimmed)
141
+ continue;
142
+ try {
143
+ const chunk = JSON.parse(trimmed);
144
+ if (chunk.response) {
145
+ yield chunk.response;
146
+ }
147
+ if (chunk.done)
148
+ return;
149
+ }
150
+ catch {
151
+ // Malformed line — skip silently
152
+ }
153
+ }
154
+ }
155
+ // Flush any remaining bytes
156
+ const remaining = decoder.decode(undefined, { stream: false });
157
+ if (remaining.trim()) {
158
+ try {
159
+ const chunk = JSON.parse(remaining.trim());
160
+ if (chunk.response)
161
+ yield chunk.response;
162
+ }
163
+ catch {
164
+ // ignore
165
+ }
166
+ }
167
+ }
168
+ finally {
169
+ reader.releaseLock();
170
+ }
171
+ }
172
+ }
173
+ //# sourceMappingURL=local-llm.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-llm.js","sourceRoot":"","sources":["../src/local-llm.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import { ModelTier, ModelSpec } from "./types.js";
2
+ export declare const MODEL_SPECS: Record<ModelTier, ModelSpec>;
3
+ export declare function getModelCacheDir(): string;
4
+ export declare function isModelCached(tier: ModelTier): Promise<boolean>;
5
+ export declare function ensureModel(tier: ModelTier, opts: {
6
+ offline: boolean;
7
+ force?: boolean;
8
+ }): Promise<void>;
9
+ //# sourceMappingURL=model-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-manager.d.ts","sourceRoot":"","sources":["../src/model-manager.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAKlD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAepD,CAAC;AAIF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAYrE;AAmBD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1C,OAAO,CAAC,IAAI,CAAC,CA2Df"}
@@ -0,0 +1,97 @@
1
+ // ─────────────────────────────────────────────────────────────────────────────
2
+ // repoDoc Local — Model Manager
3
+ // Design: dark brutalist terminal aesthetic (#0A0A0A bg, emerald-400 accents)
4
+ // ─────────────────────────────────────────────────────────────────────────────
5
+ import os from "os";
6
+ import path from "path";
7
+ import readline from "readline";
8
+ import { execSync } from "child_process";
9
+ import chalk from "chalk";
10
+ // ── Model Registry ────────────────────────────────────────────────────────────
11
+ // TODO: Query and fill dynamic model specs from `ollama list` / `ollama show`
12
+ export const MODEL_SPECS = {
13
+ "gemma-4-e4b": {
14
+ id: "gemma-4-e4b",
15
+ ollamaTag: "gemma4:e4b",
16
+ sha256: "PLACEHOLDER_PHASE_0",
17
+ estimatedRamGb: 5.5, // Measured: 5.5 GB RAM footprint (Q4_K_M GGUF)
18
+ downloadSizeGb: 2.8, // Measured: 2.8 GB download size
19
+ },
20
+ "gemma-4-e2b": {
21
+ id: "gemma-4-e2b",
22
+ ollamaTag: "gemma4:e2b",
23
+ sha256: "PLACEHOLDER_PHASE_0",
24
+ estimatedRamGb: 3.0, // Measured: 3.0 GB RAM footprint (Q4_K_M GGUF)
25
+ downloadSizeGb: 1.4, // Measured: 1.4 GB download size
26
+ },
27
+ };
28
+ // ── Cache Utilities ───────────────────────────────────────────────────────────
29
+ export function getModelCacheDir() {
30
+ return path.join(os.homedir(), ".repoDoc", "models");
31
+ }
32
+ export async function isModelCached(tier) {
33
+ const spec = MODEL_SPECS[tier];
34
+ try {
35
+ const output = execSync("ollama list", {
36
+ stdio: ["pipe", "pipe", "pipe"],
37
+ }).toString();
38
+ // ollama list output has lines like: "gemma3:4b <id> <size> <date>"
39
+ return output.includes(spec.ollamaTag);
40
+ }
41
+ catch {
42
+ // ollama not installed or not running
43
+ return false;
44
+ }
45
+ }
46
+ // ── Prompt Helper ─────────────────────────────────────────────────────────────
47
+ function askConfirmation(question) {
48
+ const rl = readline.createInterface({
49
+ input: process.stdin,
50
+ output: process.stdout,
51
+ });
52
+ return new Promise((resolve) => {
53
+ rl.question(question, (answer) => {
54
+ rl.close();
55
+ resolve(answer.trim().toLowerCase() === "y");
56
+ });
57
+ });
58
+ }
59
+ // ── Model Lifecycle ───────────────────────────────────────────────────────────
60
+ export async function ensureModel(tier, opts) {
61
+ const spec = MODEL_SPECS[tier];
62
+ const cached = await isModelCached(tier);
63
+ // 1. Offline + not cached → hard stop
64
+ if (opts.offline && !cached) {
65
+ throw new Error("Model not cached and --offline mode is set. Run: repodoc model pull");
66
+ }
67
+ // 2. Already cached (and not forcing a re-pull)
68
+ if (cached && !opts.force) {
69
+ console.log(chalk.green("✓ Model already cached, loading..."));
70
+ return;
71
+ }
72
+ // 3. Not cached (or forced) → prompt then pull
73
+ console.log();
74
+ console.log(chalk.bold(`Downloading ${chalk.cyan(spec.ollamaTag)} via Ollama...`));
75
+ console.log(` ${chalk.gray("Estimated download size:")} ${chalk.white(`~${spec.downloadSizeGb} GB`)} ${chalk.dim("(measured; TODO: fetch from ollama list)")}`);
76
+ console.log(` ${chalk.gray("Estimated RAM required: ")} ${chalk.white(`~${spec.estimatedRamGb} GB`)} ${chalk.dim("(measured; TODO: fetch from ollama list)")}`);
77
+ console.log();
78
+ const confirmed = await askConfirmation(chalk.yellow("Proceed with download? [Y/n] "));
79
+ if (!confirmed) {
80
+ console.log(chalk.gray("Download cancelled."));
81
+ console.log(chalk.dim("Prefer not to install? Use the live app: https://repodoc.app"));
82
+ process.exit(0);
83
+ }
84
+ console.log();
85
+ console.log(chalk.gray(`Running: ollama pull ${spec.ollamaTag}`));
86
+ console.log();
87
+ try {
88
+ execSync(`ollama pull ${spec.ollamaTag}`, { stdio: "inherit" });
89
+ }
90
+ catch (err) {
91
+ throw new Error(`Failed to pull model via Ollama. Please ensure Ollama is installed and running (https://ollama.com).\n` +
92
+ `Or run in offline guardrail mode: repodoc --offline`);
93
+ }
94
+ console.log();
95
+ console.log(chalk.green("✓ Model ready."));
96
+ }
97
+ //# sourceMappingURL=model-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-manager.js","sourceRoot":"","sources":["../src/model-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import { AnalysisResult, SavedRun } from "./types.js";
2
+ /** Return the absolute path to .repodoc/runs for a repository. */
3
+ export declare function getRunsDir(repoPath: string): string;
4
+ /**
5
+ * Save an analysis run to .repodoc/runs/<run-id>.json.
6
+ * Returns the generated runId.
7
+ */
8
+ export declare function saveRun(repoPath: string, result: AnalysisResult, filesScanned: number): string;
9
+ /**
10
+ * List all available run IDs for a repository, sorted newest first.
11
+ */
12
+ export declare function listRuns(repoPath: string): string[];
13
+ /**
14
+ * Load a run by ID, or the most recent run if no ID is supplied.
15
+ */
16
+ export declare function loadRun(repoPath: string, runId?: string): SavedRun;
17
+ //# sourceMappingURL=persistence.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,MAAM,GACnB,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBnD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CA6BlE"}
@@ -0,0 +1,88 @@
1
+ // ─────────────────────────────────────────────────────────────────────────────
2
+ // repoDoc Local — Persistence
3
+ // Saves and retrieves analysis runs in .repodoc/runs/<run-id>.json.
4
+ // Zero data leaves the machine.
5
+ // ─────────────────────────────────────────────────────────────────────────────
6
+ import fs from "fs";
7
+ import path from "path";
8
+ /** Return the absolute path to .repodoc/runs for a repository. */
9
+ export function getRunsDir(repoPath) {
10
+ return path.join(path.resolve(repoPath), ".repodoc", "runs");
11
+ }
12
+ /**
13
+ * Save an analysis run to .repodoc/runs/<run-id>.json.
14
+ * Returns the generated runId.
15
+ */
16
+ export function saveRun(repoPath, result, filesScanned) {
17
+ const runsDir = getRunsDir(repoPath);
18
+ if (!fs.existsSync(runsDir)) {
19
+ fs.mkdirSync(runsDir, { recursive: true });
20
+ }
21
+ const runId = result.runId ?? `run-${Date.now()}`;
22
+ const runFilePath = path.join(runsDir, `${runId}.json`);
23
+ const savedRun = {
24
+ id: runId,
25
+ timestamp: new Date().toISOString(),
26
+ repoPath: path.resolve(repoPath),
27
+ model: result.model,
28
+ guardrailFindings: result.guardrailFindings,
29
+ bugs: result.bugs,
30
+ patches: result.patches,
31
+ durationMs: result.durationMs,
32
+ filesScanned,
33
+ llmResponseInvalid: result.llmResponseInvalid,
34
+ };
35
+ fs.writeFileSync(runFilePath, JSON.stringify(savedRun, null, 2), "utf8");
36
+ return runId;
37
+ }
38
+ /**
39
+ * List all available run IDs for a repository, sorted newest first.
40
+ */
41
+ export function listRuns(repoPath) {
42
+ const runsDir = getRunsDir(repoPath);
43
+ if (!fs.existsSync(runsDir)) {
44
+ return [];
45
+ }
46
+ try {
47
+ const files = fs
48
+ .readdirSync(runsDir)
49
+ .filter((f) => f.endsWith(".json"))
50
+ .map((f) => {
51
+ const fullPath = path.join(runsDir, f);
52
+ const stat = fs.statSync(fullPath);
53
+ return { name: f.replace(/\.json$/, ""), mtime: stat.mtimeMs };
54
+ })
55
+ .sort((a, b) => b.mtime - a.mtime);
56
+ return files.map((f) => f.name);
57
+ }
58
+ catch {
59
+ return [];
60
+ }
61
+ }
62
+ /**
63
+ * Load a run by ID, or the most recent run if no ID is supplied.
64
+ */
65
+ export function loadRun(repoPath, runId) {
66
+ const runsDir = getRunsDir(repoPath);
67
+ let targetId = runId;
68
+ if (!targetId) {
69
+ const runs = listRuns(repoPath);
70
+ if (runs.length === 0) {
71
+ throw new Error(`No saved runs found in ${runsDir}. Please run 'repodoc' first to analyze the repository.`);
72
+ }
73
+ targetId = runs[0];
74
+ }
75
+ const fileName = targetId.endsWith(".json") ? targetId : `${targetId}.json`;
76
+ const filePath = path.join(runsDir, fileName);
77
+ if (!fs.existsSync(filePath)) {
78
+ throw new Error(`Run "${targetId}" not found in ${runsDir}. Available runs: ${listRuns(repoPath).join(", ") || "none"}`);
79
+ }
80
+ try {
81
+ const raw = fs.readFileSync(filePath, "utf8");
82
+ return JSON.parse(raw);
83
+ }
84
+ catch (err) {
85
+ throw new Error(`Failed to read or parse run file ${filePath}: ${err}`);
86
+ }
87
+ }
88
+ //# sourceMappingURL=persistence.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"persistence.js","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ export interface RedactionResult {
2
+ redacted: string;
3
+ count: number;
4
+ types: string[];
5
+ }
6
+ /**
7
+ * Scan `text` for known secret patterns and replace them with
8
+ * `[REDACTED:<TYPE>]` placeholders.
9
+ *
10
+ * Returns the sanitised text, the number of redactions applied,
11
+ * and the unique secret types found.
12
+ */
13
+ export declare function redactSecrets(text: string): RedactionResult;
14
+ /**
15
+ * Returns a list of glob patterns that the file scanner should skip entirely.
16
+ * These files are likely to contain raw secrets and should never be read.
17
+ */
18
+ export declare function buildSkipList(): string[];
19
+ //# sourceMappingURL=secret-redactor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"secret-redactor.d.ts","sourceRoot":"","sources":["../src/secret-redactor.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AA4CD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAuB3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAqBxC"}
@@ -0,0 +1,92 @@
1
+ // ─────────────────────────────────────────────────────────────────────────────
2
+ // repoDoc Local — Secret Redactor
3
+ // Strips secrets from code/text before it reaches the local model.
4
+ // ─────────────────────────────────────────────────────────────────────────────
5
+ const SECRET_PATTERNS = [
6
+ {
7
+ type: "API_KEY",
8
+ // Matches: api_key = 'ABC...', secret-key: "XYZ...", access_token="...", etc.
9
+ regex: /(api[_-]?key|secret[_-]?key|access[_-]?token|auth[_-]?token)\s*[=:]\s*(['"])[^'"]{8,}\2/gi,
10
+ replacement: "$1=[REDACTED:API_KEY]",
11
+ },
12
+ {
13
+ type: "PASSWORD",
14
+ // Matches: password = 'secret', passwd: "...", pwd="..."
15
+ regex: /(password|passwd|pwd)\s*[=:]\s*(['"])[^'"]{4,}\2/gi,
16
+ replacement: "$1=[REDACTED:PASSWORD]",
17
+ },
18
+ {
19
+ type: "PRIVATE_KEY",
20
+ // Matches PEM private key blocks
21
+ regex: /-----BEGIN (RSA |EC |DSA )?PRIVATE KEY-----[\s\S]+?-----END/g,
22
+ replacement: "[REDACTED:PRIVATE_KEY]",
23
+ },
24
+ {
25
+ type: "AWS_KEY",
26
+ // Matches AWS access key IDs
27
+ regex: /AKIA[0-9A-Z]{16}/g,
28
+ replacement: "[REDACTED:AWS_KEY]",
29
+ },
30
+ {
31
+ type: "GENERIC_SECRET",
32
+ // Matches: secret = "...", secret: '...'
33
+ regex: /(secret)\s*[=:]\s*(['"])[^'"]{8,}\2/gi,
34
+ replacement: "$1=[REDACTED:GENERIC_SECRET]",
35
+ },
36
+ ];
37
+ /**
38
+ * Scan `text` for known secret patterns and replace them with
39
+ * `[REDACTED:<TYPE>]` placeholders.
40
+ *
41
+ * Returns the sanitised text, the number of redactions applied,
42
+ * and the unique secret types found.
43
+ */
44
+ export function redactSecrets(text) {
45
+ let redacted = text;
46
+ let count = 0;
47
+ const typesFound = new Set();
48
+ for (const { type, regex, replacement } of SECRET_PATTERNS) {
49
+ // Count matches before replacing
50
+ const matches = redacted.match(regex);
51
+ if (matches && matches.length > 0) {
52
+ count += matches.length;
53
+ typesFound.add(type);
54
+ redacted = redacted.replace(regex, replacement);
55
+ }
56
+ // Reset lastIndex for global regexes (they are recreated per call anyway,
57
+ // but be safe in case patterns are reused across calls)
58
+ regex.lastIndex = 0;
59
+ }
60
+ return {
61
+ redacted,
62
+ count,
63
+ types: Array.from(typesFound),
64
+ };
65
+ }
66
+ /**
67
+ * Returns a list of glob patterns that the file scanner should skip entirely.
68
+ * These files are likely to contain raw secrets and should never be read.
69
+ */
70
+ export function buildSkipList() {
71
+ return [
72
+ ".env",
73
+ ".env.*",
74
+ "*.pem",
75
+ "*.key",
76
+ "*.p12",
77
+ "*.pfx",
78
+ "id_rsa",
79
+ "id_rsa.*",
80
+ "id_ed25519",
81
+ "*.ppk",
82
+ ".git/**",
83
+ "node_modules/**",
84
+ "venv/**",
85
+ "__pycache__/**",
86
+ "dist/**",
87
+ "build/**",
88
+ "*.min.js",
89
+ "*.lock",
90
+ ];
91
+ }
92
+ //# sourceMappingURL=secret-redactor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"secret-redactor.js","sourceRoot":"","sources":["../src/secret-redactor.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kCAAkC;AAClC,mEAAmE;AACnE,gFAAgF;AAehF,MAAM,eAAe,GAAoB;IACvC;QACE,IAAI,EAAE,SAAS;QACf,8EAA8E;QAC9E,KAAK,EACH,2FAA2F;QAC7F,WAAW,EAAE,uBAAuB;KACrC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,yDAAyD;QACzD,KAAK,EAAE,oDAAoD;QAC3D,WAAW,EAAE,wBAAwB;KACtC;IACD;QACE,IAAI,EAAE,aAAa;QACnB,iCAAiC;QACjC,KAAK,EACH,8DAA8D;QAChE,WAAW,EAAE,wBAAwB;KACtC;IACD;QACE,IAAI,EAAE,SAAS;QACf,6BAA6B;QAC7B,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,oBAAoB;KAClC;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,yCAAyC;QACzC,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EAAE,8BAA8B;KAC5C;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,eAAe,EAAE,CAAC;QAC3D,iCAAiC;QACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;YACxB,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrB,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAClD,CAAC;QACD,0EAA0E;QAC1E,wDAAwD;QACxD,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,OAAO;QACL,QAAQ;QACR,KAAK;QACL,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,MAAM;QACN,QAAQ;QACR,OAAO;QACP,OAAO;QACP,OAAO;QACP,OAAO;QACP,QAAQ;QACR,UAAU;QACV,YAAY;QACZ,OAAO;QACP,SAAS;QACT,iBAAiB;QACjB,SAAS;QACT,gBAAgB;QAChB,SAAS;QACT,UAAU;QACV,UAAU;QACV,QAAQ;KACT,CAAC;AACJ,CAAC"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Print a best-effort audit report of network-capable module usage in the
3
+ * installed dist/ package.
4
+ */
5
+ export declare function runAudit(): Promise<void>;
6
+ /**
7
+ * Spawn a child Node.js process that simulates a network request under the
8
+ * NO_NETWORK=1 guard. The child detects the flag and immediately reports
9
+ * "BLOCKED" rather than opening any real TCP connection.
10
+ *
11
+ * Full OS-level network blocking requires seccomp/sandbox (Phase 3 goal).
12
+ * This guard is a protocol-level check for v1.
13
+ */
14
+ export declare function checkNetwork(): Promise<void>;
15
+ //# sourceMappingURL=audit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/security/audit.ts"],"names":[],"mappings":"AAyGA;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAmE9C;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAkFlD"}