nogrep 1.0.0

package/dist/trim.js

@@ -0,0 +1,266 @@
+// scripts/trim.ts
+import { readFile } from "fs/promises";
+import { resolve, extname } from "path";
+var MAX_CLUSTER_LINES = 300;
+function trimTypeScript(content) {
+  const lines = content.split("\n");
+  const result = [];
+  let braceDepth = 0;
+  let inBody = false;
+  let bodyStartDepth = 0;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (braceDepth === 0 || !inBody) {
+      if (trimmed === "" || trimmed.startsWith("import ") || trimmed.startsWith("export type ") || trimmed.startsWith("export interface ") || trimmed.startsWith("export enum ") || trimmed.startsWith("export const ") || trimmed.startsWith("type ") || trimmed.startsWith("interface ") || trimmed.startsWith("enum ") || trimmed.startsWith("@") || trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*") || trimmed.startsWith("declare ")) {
+        result.push(line);
+        braceDepth += countChar(trimmed, "{") - countChar(trimmed, "}");
+        continue;
+      }
+    }
+    const openBraces = countChar(trimmed, "{");
+    const closeBraces = countChar(trimmed, "}");
+    if (!inBody) {
+      if (isSignatureLine(trimmed) && openBraces > closeBraces) {
+        result.push(line);
+        braceDepth += openBraces - closeBraces;
+        inBody = true;
+        bodyStartDepth = braceDepth;
+        continue;
+      }
+      if (isClassOrInterfaceLine(trimmed)) {
+        result.push(line);
+        braceDepth += openBraces - closeBraces;
+        continue;
+      }
+      result.push(line);
+      braceDepth += openBraces - closeBraces;
+    } else {
+      braceDepth += openBraces - closeBraces;
+      if (braceDepth < bodyStartDepth) {
+        result.push(line);
+        inBody = false;
+      }
+    }
+  }
+  return result.join("\n");
+}
+function trimPython(content) {
+  const lines = content.split("\n");
+  const result = [];
+  let skipIndent = -1;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmed = line.trim();
+    const indent = line.length - line.trimStart().length;
+    if (skipIndent >= 0) {
+      if (trimmed === "" || indent > skipIndent) {
+        continue;
+      }
+      skipIndent = -1;
+    }
+    if (trimmed === "" || trimmed.startsWith("#") || trimmed.startsWith("import ") || trimmed.startsWith("from ") || trimmed.startsWith("@") || trimmed.startsWith("class ") || /^[A-Z_][A-Z_0-9]*\s*=/.test(trimmed)) {
+      result.push(line);
+      continue;
+    }
+    if (trimmed.startsWith("def ") || trimmed.startsWith("async def ")) {
+      result.push(line);
+      const docIdx = findDocstring(lines, i + 1, indent);
+      if (docIdx > i) {
+        for (let j = i + 1; j <= docIdx; j++) {
+          result.push(lines[j]);
+        }
+      }
+      skipIndent = indent;
+      continue;
+    }
+    result.push(line);
+  }
+  return result.join("\n");
+}
+function trimJava(content) {
+  const lines = content.split("\n");
+  const result = [];
+  let braceDepth = 0;
+  let inBody = false;
+  let bodyStartDepth = 0;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (braceDepth === 0 || !inBody) {
+      if (trimmed === "" || trimmed.startsWith("import ") || trimmed.startsWith("package ") || trimmed.startsWith("@") || trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*") || trimmed.startsWith("public interface ") || trimmed.startsWith("interface ") || trimmed.startsWith("public enum ") || trimmed.startsWith("enum ")) {
+        result.push(line);
+        braceDepth += countChar(trimmed, "{") - countChar(trimmed, "}");
+        continue;
+      }
+    }
+    const openBraces = countChar(trimmed, "{");
+    const closeBraces = countChar(trimmed, "}");
+    if (!inBody) {
+      if (isJavaMethodSignature(trimmed) && openBraces > closeBraces) {
+        result.push(line);
+        braceDepth += openBraces - closeBraces;
+        inBody = true;
+        bodyStartDepth = braceDepth;
+        continue;
+      }
+      if (isJavaClassLine(trimmed)) {
+        result.push(line);
+        braceDepth += openBraces - closeBraces;
+        continue;
+      }
+      result.push(line);
+      braceDepth += openBraces - closeBraces;
+    } else {
+      braceDepth += openBraces - closeBraces;
+      if (braceDepth < bodyStartDepth) {
+        result.push(line);
+        inBody = false;
+      }
+    }
+  }
+  return result.join("\n");
+}
+function trimGeneric(content) {
+  return content;
+}
+function countChar(s, ch) {
+  let count = 0;
+  let inString = false;
+  let stringChar = "";
+  for (let i = 0; i < s.length; i++) {
+    const c = s[i];
+    if (inString) {
+      if (c === stringChar && s[i - 1] !== "\\") inString = false;
+    } else if (c === '"' || c === "'" || c === "`") {
+      inString = true;
+      stringChar = c;
+    } else if (c === ch) {
+      count++;
+    }
+  }
+  return count;
+}
+function isSignatureLine(trimmed) {
+  return /^(export\s+)?(async\s+)?function\s/.test(trimmed) || /^(public|private|protected|static|async|get|set|\*)\s/.test(trimmed) || /^(readonly\s+)?[a-zA-Z_$][a-zA-Z0-9_$]*\s*\(/.test(trimmed) || /^(export\s+)?(const|let|var)\s+\w+\s*=\s*(async\s+)?\(/.test(trimmed) || /^(export\s+)?(const|let|var)\s+\w+\s*=\s*(async\s+)?function/.test(trimmed) || // Arrow function assigned at class level
+  /^[a-zA-Z_$][a-zA-Z0-9_$]*\s*=\s*(async\s+)?\(/.test(trimmed);
+}
+function isClassOrInterfaceLine(trimmed) {
+  return /^(export\s+)?(abstract\s+)?(class|interface|enum)\s/.test(trimmed) || /^(export\s+)?namespace\s/.test(trimmed);
+}
+function isJavaMethodSignature(trimmed) {
+  return /^(public|private|protected|static|final|abstract|synchronized|native)\s/.test(trimmed) && /\(/.test(trimmed);
+}
+function isJavaClassLine(trimmed) {
+  return /^(public|private|protected)?\s*(abstract\s+)?(class|interface|enum)\s/.test(trimmed);
+}
+function findDocstring(lines, startIdx, defIndent) {
+  for (let i = startIdx; i < lines.length; i++) {
+    const trimmed = lines[i].trim();
+    if (trimmed === "") continue;
+    if (trimmed.startsWith('"""') || trimmed.startsWith("'''")) {
+      const quote = trimmed.slice(0, 3);
+      if (trimmed.length > 3 && trimmed.endsWith(quote)) return i;
+      for (let j = i + 1; j < lines.length; j++) {
+        if (lines[j].trim().endsWith(quote)) return j;
+      }
+      return i;
+    }
+    return startIdx - 1;
+  }
+  return startIdx - 1;
+}
+function getTrimmer(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  switch (ext) {
+    case ".ts":
+    case ".tsx":
+    case ".js":
+    case ".jsx":
+    case ".mjs":
+    case ".cjs":
+      return trimTypeScript;
+    case ".py":
+      return trimPython;
+    case ".java":
+    case ".kt":
+    case ".kts":
+    case ".scala":
+    case ".groovy":
+      return trimJava;
+    case ".go":
+    case ".rs":
+    case ".c":
+    case ".cpp":
+    case ".h":
+    case ".hpp":
+    case ".cs":
+    case ".swift":
+    case ".dart":
+      return trimJava;
+    // brace-based languages use same strategy
+    default:
+      return trimGeneric;
+  }
+}
+async function trimCluster(paths, projectRoot) {
+  const results = [];
+  for (const filePath of paths) {
+    const absPath = resolve(projectRoot, filePath);
+    try {
+      const raw = await readFile(absPath, "utf-8");
+      const trimmer = getTrimmer(filePath);
+      const trimmed = trimmer(raw);
+      results.push({
+        path: filePath,
+        content: trimmed,
+        lines: trimmed.split("\n").length
+      });
+    } catch {
+      if (process.env["NOGREP_DEBUG"] === "1") {
+        process.stderr.write(`[nogrep] Could not read: ${absPath}
+`);
+      }
+    }
+  }
+  results.sort((a, b) => a.lines - b.lines);
+  const output = [];
+  let totalLines = 0;
+  const maxLines = MAX_CLUSTER_LINES;
+  for (const file of results) {
+    const header = `// === ${file.path} ===`;
+    const fileLines = file.content.split("\n");
+    const available = maxLines - totalLines - 2;
+    if (available <= 0) break;
+    output.push(header);
+    if (fileLines.length <= available) {
+      output.push(file.content);
+    } else {
+      output.push(fileLines.slice(0, available).join("\n"));
+      output.push(`// ... truncated (${fileLines.length - available} more lines)`);
+    }
+    output.push("");
+    totalLines += Math.min(fileLines.length, available) + 2;
+  }
+  return output.join("\n");
+}
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.length === 0) {
+    process.stderr.write("Usage: node trim.js <path1> <path2> ...\n");
+    process.exit(1);
+  }
+  const projectRoot = process.cwd();
+  const result = await trimCluster(args, projectRoot);
+  process.stdout.write(result);
+}
+var isDirectRun = process.argv[1]?.endsWith("trim.js") || process.argv[1]?.endsWith("trim.ts");
+if (isDirectRun) {
+  main().catch((err) => {
+    process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  });
+}
+export {
+  trimCluster
+};
+//# sourceMappingURL=trim.js.map

package/dist/trim.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../scripts/trim.ts"],"sourcesContent":["import { readFile } from 'fs/promises'\nimport { resolve, extname, basename } from 'path'\n\nconst MAX_CLUSTER_LINES = 300\n\ninterface TrimOptions {\n  maxLines?: number\n}\n\n// Language-agnostic regex patterns for stripping function/method bodies\n// Strategy: find opening braces after signatures, track depth, remove body content\n\nfunction trimTypeScript(content: string): string {\n  const lines = content.split('\\n')\n  const result: string[] = []\n  let braceDepth = 0\n  let inBody = false\n  let bodyStartDepth = 0\n\n  for (const line of lines) {\n    const trimmed = line.trim()\n\n    // Always keep: empty lines at top level, imports, type/interface, decorators, exports of types\n    if (braceDepth === 0 || !inBody) {\n      if (\n        trimmed === '' ||\n        trimmed.startsWith('import ') ||\n        trimmed.startsWith('export type ') ||\n        trimmed.startsWith('export interface ') ||\n        trimmed.startsWith('export enum ') ||\n        trimmed.startsWith('export const ') ||\n        trimmed.startsWith('type ') ||\n        trimmed.startsWith('interface ') ||\n        trimmed.startsWith('enum ') ||\n        trimmed.startsWith('@') ||\n        trimmed.startsWith('//') ||\n        trimmed.startsWith('/*') ||\n        trimmed.startsWith('*') ||\n        trimmed.startsWith('declare ')\n      ) {\n        result.push(line)\n        // Count braces even in kept lines\n        braceDepth += countChar(trimmed, '{') - countChar(trimmed, '}')\n        continue\n      }\n    }\n\n    const openBraces = countChar(trimmed, '{')\n    const closeBraces = countChar(trimmed, '}')\n\n    if (!inBody) {\n      // Detect function/method signature — line with opening brace\n      if (isSignatureLine(trimmed) && openBraces > closeBraces) {\n        result.push(line)\n        braceDepth += openBraces - closeBraces\n        inBody = true\n        bodyStartDepth = braceDepth\n        continue\n      }\n\n      // Class/interface declaration — keep but don't treat as body\n      if (isClassOrInterfaceLine(trimmed)) {\n        result.push(line)\n        braceDepth += openBraces - closeBraces\n        continue\n      }\n\n      // Keep the line (top-level statement, property declaration, etc.)\n      result.push(line)\n      braceDepth += openBraces - closeBraces\n    } else {\n      // Inside a function body — skip lines\n      braceDepth += openBraces - closeBraces\n\n      // Check if we've closed back to where the body started\n      if (braceDepth < bodyStartDepth) {\n        // Add closing brace\n        result.push(line)\n        inBody = false\n      }\n    }\n  }\n\n  return result.join('\\n')\n}\n\nfunction trimPython(content: string): string {\n  const lines = content.split('\\n')\n  const result: string[] = []\n  let skipIndent = -1\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i]!\n    const trimmed = line.trim()\n    const indent = line.length - line.trimStart().length\n\n    // If we're skipping a body and this line is still indented deeper, skip it\n    if (skipIndent >= 0) {\n      if (trimmed === '' || indent > skipIndent) {\n        continue\n      }\n      // We've exited the body\n      skipIndent = -1\n    }\n\n    // Always keep: comments, imports, class defs, decorators, type hints, module-level assignments\n    if (\n      trimmed === '' ||\n      trimmed.startsWith('#') ||\n      trimmed.startsWith('import ') ||\n      trimmed.startsWith('from ') ||\n      trimmed.startsWith('@') ||\n      trimmed.startsWith('class ') ||\n      /^[A-Z_][A-Z_0-9]*\\s*=/.test(trimmed)\n    ) {\n      result.push(line)\n      continue\n    }\n\n    // Function/method definition — keep signature, skip body\n    if (trimmed.startsWith('def ') || trimmed.startsWith('async def ')) {\n      result.push(line)\n      // If the next non-empty line has docstring, keep it\n      const docIdx = findDocstring(lines, i + 1, indent)\n      if (docIdx > i) {\n        for (let j = i + 1; j <= docIdx; j++) {\n          result.push(lines[j]!)\n        }\n      }\n      skipIndent = indent\n      continue\n    }\n\n    // Keep everything else at module/class level\n    result.push(line)\n  }\n\n  return result.join('\\n')\n}\n\nfunction trimJava(content: string): string {\n  // Java/Kotlin — very similar to TypeScript brace-matching\n  const lines = content.split('\\n')\n  const result: string[] = []\n  let braceDepth = 0\n  let inBody = false\n  let bodyStartDepth = 0\n\n  for (const line of lines) {\n    const trimmed = line.trim()\n\n    if (braceDepth === 0 || !inBody) {\n      if (\n        trimmed === '' ||\n        trimmed.startsWith('import ') ||\n        trimmed.startsWith('package ') ||\n        trimmed.startsWith('@') ||\n        trimmed.startsWith('//') ||\n        trimmed.startsWith('/*') ||\n        trimmed.startsWith('*') ||\n        trimmed.startsWith('public interface ') ||\n        trimmed.startsWith('interface ') ||\n        trimmed.startsWith('public enum ') ||\n        trimmed.startsWith('enum ')\n      ) {\n        result.push(line)\n        braceDepth += countChar(trimmed, '{') - countChar(trimmed, '}')\n        continue\n      }\n    }\n\n    const openBraces = countChar(trimmed, '{')\n    const closeBraces = countChar(trimmed, '}')\n\n    if (!inBody) {\n      if (isJavaMethodSignature(trimmed) && openBraces > closeBraces) {\n        result.push(line)\n        braceDepth += openBraces - closeBraces\n        inBody = true\n        bodyStartDepth = braceDepth\n        continue\n      }\n\n      if (isJavaClassLine(trimmed)) {\n        result.push(line)\n        braceDepth += openBraces - closeBraces\n        continue\n      }\n\n      result.push(line)\n      braceDepth += openBraces - closeBraces\n    } else {\n      braceDepth += openBraces - closeBraces\n      if (braceDepth < bodyStartDepth) {\n        result.push(line)\n        inBody = false\n      }\n    }\n  }\n\n  return result.join('\\n')\n}\n\nfunction trimGeneric(content: string): string {\n  // For unknown languages, just return as-is (truncation handles size)\n  return content\n}\n\n// --- Helpers ---\n\nfunction countChar(s: string, ch: string): number {\n  let count = 0\n  let inString = false\n  let stringChar = ''\n  for (let i = 0; i < s.length; i++) {\n    const c = s[i]!\n    if (inString) {\n      if (c === stringChar && s[i - 1] !== '\\\\') inString = false\n    } else if (c === '\"' || c === \"'\" || c === '`') {\n      inString = true\n      stringChar = c\n    } else if (c === ch) {\n      count++\n    }\n  }\n  return count\n}\n\nfunction isSignatureLine(trimmed: string): boolean {\n  return /^(export\\s+)?(async\\s+)?function\\s/.test(trimmed) ||\n    /^(public|private|protected|static|async|get|set|\\*)\\s/.test(trimmed) ||\n    /^(readonly\\s+)?[a-zA-Z_$][a-zA-Z0-9_$]*\\s*\\(/.test(trimmed) ||\n    /^(export\\s+)?(const|let|var)\\s+\\w+\\s*=\\s*(async\\s+)?\\(/.test(trimmed) ||\n    /^(export\\s+)?(const|let|var)\\s+\\w+\\s*=\\s*(async\\s+)?function/.test(trimmed) ||\n    // Arrow function assigned at class level\n    /^[a-zA-Z_$][a-zA-Z0-9_$]*\\s*=\\s*(async\\s+)?\\(/.test(trimmed)\n}\n\nfunction isClassOrInterfaceLine(trimmed: string): boolean {\n  return /^(export\\s+)?(abstract\\s+)?(class|interface|enum)\\s/.test(trimmed) ||\n    /^(export\\s+)?namespace\\s/.test(trimmed)\n}\n\nfunction isJavaMethodSignature(trimmed: string): boolean {\n  return /^(public|private|protected|static|final|abstract|synchronized|native)\\s/.test(trimmed) &&\n    /\\(/.test(trimmed)\n}\n\nfunction isJavaClassLine(trimmed: string): boolean {\n  return /^(public|private|protected)?\\s*(abstract\\s+)?(class|interface|enum)\\s/.test(trimmed)\n}\n\nfunction findDocstring(lines: string[], startIdx: number, defIndent: number): number {\n  // Find Python docstring (triple-quoted) after a def\n  for (let i = startIdx; i < lines.length; i++) {\n    const trimmed = lines[i]!.trim()\n    if (trimmed === '') continue\n    if (trimmed.startsWith('\"\"\"') || trimmed.startsWith(\"'''\")) {\n      const quote = trimmed.slice(0, 3)\n      // Single-line docstring\n      if (trimmed.length > 3 && trimmed.endsWith(quote)) return i\n      // Multi-line docstring — find closing\n      for (let j = i + 1; j < lines.length; j++) {\n        if (lines[j]!.trim().endsWith(quote)) return j\n      }\n      return i\n    }\n    // First non-empty line after def is not a docstring\n    return startIdx - 1\n  }\n  return startIdx - 1\n}\n\nfunction getTrimmer(filePath: string): (content: string) => string {\n  const ext = extname(filePath).toLowerCase()\n  switch (ext) {\n    case '.ts':\n    case '.tsx':\n    case '.js':\n    case '.jsx':\n    case '.mjs':\n    case '.cjs':\n      return trimTypeScript\n    case '.py':\n      return trimPython\n    case '.java':\n    case '.kt':\n    case '.kts':\n    case '.scala':\n    case '.groovy':\n      return trimJava\n    case '.go':\n    case '.rs':\n    case '.c':\n    case '.cpp':\n    case '.h':\n    case '.hpp':\n    case '.cs':\n    case '.swift':\n    case '.dart':\n      return trimJava // brace-based languages use same strategy\n    default:\n      return trimGeneric\n  }\n}\n\nexport async function trimCluster(paths: string[], projectRoot: string): Promise<string> {\n  const results: Array<{ path: string; content: string; lines: number }> = []\n\n  for (const filePath of paths) {\n    const absPath = resolve(projectRoot, filePath)\n    try {\n      const raw = await readFile(absPath, 'utf-8')\n      const trimmer = getTrimmer(filePath)\n      const trimmed = trimmer(raw)\n      results.push({\n        path: filePath,\n        content: trimmed,\n        lines: trimmed.split('\\n').length,\n      })\n    } catch {\n      // Skip files that can't be read\n      if (process.env['NOGREP_DEBUG'] === '1') {\n        process.stderr.write(`[nogrep] Could not read: ${absPath}\\n`)\n      }\n    }\n  }\n\n  // Sort by line count descending — truncate least important (largest) files first\n  results.sort((a, b) => a.lines - b.lines)\n\n  const output: string[] = []\n  let totalLines = 0\n  const maxLines = MAX_CLUSTER_LINES\n\n  for (const file of results) {\n    const header = `// === ${file.path} ===`\n    const fileLines = file.content.split('\\n')\n    const available = maxLines - totalLines - 2 // header + separator\n\n    if (available <= 0) break\n\n    output.push(header)\n    if (fileLines.length <= available) {\n      output.push(file.content)\n    } else {\n      output.push(fileLines.slice(0, available).join('\\n'))\n      output.push(`// ... truncated (${fileLines.length - available} more lines)`)\n    }\n    output.push('')\n\n    totalLines += Math.min(fileLines.length, available) + 2\n  }\n\n  return output.join('\\n')\n}\n\n// --- CLI ---\n\nasync function main(): Promise<void> {\n  const args = process.argv.slice(2)\n\n  if (args.length === 0) {\n    process.stderr.write('Usage: node trim.js <path1> <path2> ...\\n')\n    process.exit(1)\n  }\n\n  const projectRoot = process.cwd()\n  const result = await trimCluster(args, projectRoot)\n  process.stdout.write(result)\n}\n\nconst isDirectRun = process.argv[1]?.endsWith('trim.js') || process.argv[1]?.endsWith('trim.ts')\nif (isDirectRun) {\n  main().catch((err: unknown) => {\n    process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\\n`)\n    process.exit(1)\n  })\n}\n"],"mappings":"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","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,141 @@
+interface DirectoryNode {
+    name: string;
+    path: string;
+    type: 'file' | 'directory';
+    children?: DirectoryNode[];
+}
+interface ManifestFile {
+    path: string;
+    type: string;
+    depth: number;
+}
+interface ChurnEntry {
+    path: string;
+    changes: number;
+}
+interface FileSize {
+    path: string;
+    bytes: number;
+}
+interface SignalResult {
+    directoryTree: DirectoryNode[];
+    extensionMap: Record<string, number>;
+    manifests: ManifestFile[];
+    entryPoints: string[];
+    gitChurn: ChurnEntry[];
+    largeFiles: FileSize[];
+    envFiles: string[];
+    testFiles: string[];
+}
+interface StackConventions {
+    entryPattern: string;
+    testPattern: string;
+    configLocation: string;
+}
+interface DomainCluster {
+    name: string;
+    path: string;
+    confidence: number;
+}
+interface StackResult {
+    primaryLanguage: string;
+    frameworks: string[];
+    architecture: 'monolith' | 'monorepo' | 'multi-repo' | 'microservice' | 'library';
+    domainClusters: DomainCluster[];
+    conventions: StackConventions;
+    stackHints: string;
+    dynamicTaxonomy: {
+        domain: string[];
+        tech: string[];
+    };
+}
+interface TagSet {
+    domain: string[];
+    layer: string[];
+    tech: string[];
+    concern: string[];
+    type: string[];
+}
+interface Taxonomy {
+    static: {
+        layer: string[];
+        concern: string[];
+        type: string[];
+    };
+    dynamic: {
+        domain: string[];
+        tech: string[];
+    };
+    custom: Record<string, string[]>;
+}
+interface Relation {
+    id: string;
+    reason: string;
+}
+interface ExternalDep {
+    name: string;
+    usage: string;
+}
+interface SyncMeta {
+    commit: string;
+    timestamp: string;
+    srcHash: string;
+}
+interface NodeResult {
+    id: string;
+    title: string;
+    category: 'domain' | 'architecture' | 'flow' | 'entity';
+    tags: TagSet;
+    relatesTo: Relation[];
+    inverseRelations: Relation[];
+    srcPaths: string[];
+    keywords: string[];
+    lastSynced: SyncMeta;
+    purpose: string;
+    publicSurface: string[];
+    doesNotOwn: string[];
+    externalDeps: ExternalDep[];
+    gotchas: string[];
+}
+interface PathEntry {
+    context: string;
+    tags: string[];
+}
+interface IndexJson {
+    version: string;
+    generatedAt: string;
+    commit: string;
+    stack: Pick<StackResult, 'primaryLanguage' | 'frameworks' | 'architecture'>;
+    tags: Record<string, string[]>;
+    keywords: Record<string, string[]>;
+    paths: Record<string, PathEntry>;
+}
+interface RegistryMapping {
+    glob: string;
+    contextFile: string;
+    watch: boolean;
+}
+interface RegistryJson {
+    mappings: RegistryMapping[];
+}
+interface RankedResult {
+    contextFile: string;
+    score: number;
+    matchedOn: string[];
+    summary: string;
+}
+interface StaleResult {
+    file: string;
+    isStale: boolean;
+    reason?: string;
+}
+interface NogrepSettings {
+    enabled: boolean;
+}
+type NogrepErrorCode = 'NO_INDEX' | 'NO_GIT' | 'IO_ERROR' | 'STALE';
+declare class NogrepError extends Error {
+    code: NogrepErrorCode;
+    constructor(message: string, code: NogrepErrorCode);
+}
+
+export { type ChurnEntry, type DirectoryNode, type DomainCluster, type ExternalDep, type FileSize, type IndexJson, type ManifestFile, type NodeResult, NogrepError, type NogrepErrorCode, type NogrepSettings, type PathEntry, type RankedResult, type RegistryJson, type RegistryMapping, type Relation, type SignalResult, type StackConventions, type StackResult, type StaleResult, type SyncMeta, type TagSet, type Taxonomy };

package/dist/types.js

@@ -0,0 +1,7 @@
+import {
+  NogrepError
+} from "./chunk-SMUAF6SM.js";
+export {
+  NogrepError
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/validate.d.ts

@@ -0,0 +1,10 @@
+import { StaleResult } from './types.js';
+
+declare function checkFreshness(nodeFile: string, projectRoot: string): Promise<StaleResult>;
+declare function validateAll(projectRoot: string): Promise<{
+    total: number;
+    fresh: StaleResult[];
+    stale: StaleResult[];
+}>;
+
+export { checkFreshness, validateAll };

package/dist/validate.js

@@ -0,0 +1,143 @@
+import {
+  NogrepError
+} from "./chunk-SMUAF6SM.js";
+
+// scripts/validate.ts
+import { readFile } from "fs/promises";
+import { join, resolve as resolvePath } from "path";
+import { createHash } from "crypto";
+import { parseArgs } from "util";
+import { glob } from "glob";
+import matter from "gray-matter";
+async function checkFreshness(nodeFile, projectRoot) {
+  let content;
+  try {
+    content = await readFile(join(projectRoot, nodeFile), "utf-8");
+  } catch {
+    return { file: nodeFile, isStale: true, reason: "context file not found" };
+  }
+  const parsed = matter(content);
+  const srcPaths = parsed.data.src_paths ?? [];
+  const lastSynced = parsed.data.last_synced;
+  if (!lastSynced?.src_hash) {
+    return { file: nodeFile, isStale: true, reason: "no src_hash in frontmatter" };
+  }
+  if (srcPaths.length === 0) {
+    return { file: nodeFile, isStale: false };
+  }
+  const allFiles = [];
+  for (const pattern of srcPaths) {
+    const matches = await glob(pattern, {
+      cwd: projectRoot,
+      nodir: true,
+      ignore: ["node_modules/**", "dist/**", "build/**", ".git/**", "coverage/**"]
+    });
+    allFiles.push(...matches);
+  }
+  allFiles.sort();
+  if (allFiles.length === 0) {
+    return { file: nodeFile, isStale: true, reason: "no source files match src_paths" };
+  }
+  const hash = createHash("sha256");
+  for (const file of allFiles) {
+    try {
+      const fileContent = await readFile(join(projectRoot, file));
+      hash.update(fileContent);
+    } catch {
+    }
+  }
+  const currentHash = `sha256:${hash.digest("hex").slice(0, 12)}`;
+  if (currentHash !== lastSynced.src_hash) {
+    return {
+      file: nodeFile,
+      isStale: true,
+      reason: `hash mismatch: expected ${lastSynced.src_hash}, got ${currentHash}`
+    };
+  }
+  return { file: nodeFile, isStale: false };
+}
+async function discoverNodes(projectRoot) {
+  const nogrepDir = join(projectRoot, ".nogrep");
+  const patterns = [
+    "domains/*.md",
+    "architecture/*.md",
+    "flows/*.md",
+    "entities/*.md"
+  ];
+  const files = [];
+  for (const pattern of patterns) {
+    const matches = await glob(pattern, { cwd: nogrepDir, nodir: true });
+    files.push(...matches.map((m) => `.nogrep/${m}`));
+  }
+  return files.sort();
+}
+async function validateAll(projectRoot) {
+  const indexPath = join(projectRoot, ".nogrep", "_index.json");
+  try {
+    await readFile(indexPath, "utf-8");
+  } catch {
+    throw new NogrepError(
+      "No .nogrep/_index.json found. Run /nogrep:init first.",
+      "NO_INDEX"
+    );
+  }
+  const nodeFiles = await discoverNodes(projectRoot);
+  const results = await Promise.all(
+    nodeFiles.map((f) => checkFreshness(f, projectRoot))
+  );
+  const fresh = results.filter((r) => !r.isStale);
+  const stale = results.filter((r) => r.isStale);
+  return { total: results.length, fresh, stale };
+}
+function formatText(result) {
+  const lines = [];
+  lines.push(`nogrep index: ${result.total} nodes`);
+  lines.push(`  Fresh: ${result.fresh.length}`);
+  lines.push(`  Stale: ${result.stale.length}`);
+  if (result.stale.length > 0) {
+    lines.push("");
+    lines.push("Stale nodes:");
+    for (const s of result.stale) {
+      lines.push(`  - ${s.file}: ${s.reason}`);
+    }
+  }
+  return lines.join("\n");
+}
+function formatJson(result) {
+  return JSON.stringify(result, null, 2);
+}
+async function main() {
+  const { values } = parseArgs({
+    options: {
+      format: { type: "string", default: "text" },
+      root: { type: "string", default: process.cwd() }
+    },
+    strict: true
+  });
+  const root = resolvePath(values.root ?? process.cwd());
+  const format = values.format ?? "text";
+  const result = await validateAll(root);
+  switch (format) {
+    case "json":
+      process.stdout.write(formatJson(result) + "\n");
+      break;
+    case "text":
+    default:
+      process.stdout.write(formatText(result) + "\n");
+      break;
+  }
+}
+main().catch((err) => {
+  if (err instanceof NogrepError) {
+    process.stderr.write(JSON.stringify({ error: err.message, code: err.code }) + "\n");
+  } else {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(JSON.stringify({ error: message }) + "\n");
+  }
+  process.exitCode = 1;
+});
+export {
+  checkFreshness,
+  validateAll
+};
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../scripts/validate.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises'\nimport { join, resolve as resolvePath } from 'node:path'\nimport { createHash } from 'node:crypto'\nimport { parseArgs } from 'node:util'\nimport { glob } from 'glob'\nimport matter from 'gray-matter'\nimport type { StaleResult } from './types.js'\nimport { NogrepError } from './types.js'\n\n// --- Freshness check ---\n\nexport async function checkFreshness(\n  nodeFile: string,\n  projectRoot: string,\n): Promise<StaleResult> {\n  let content: string\n  try {\n    content = await readFile(join(projectRoot, nodeFile), 'utf-8')\n  } catch {\n    return { file: nodeFile, isStale: true, reason: 'context file not found' }\n  }\n\n  const parsed = matter(content)\n  const srcPaths: string[] = parsed.data.src_paths ?? []\n  const lastSynced = parsed.data.last_synced as\n    | { src_hash?: string; commit?: string; timestamp?: string }\n    | undefined\n\n  if (!lastSynced?.src_hash) {\n    return { file: nodeFile, isStale: true, reason: 'no src_hash in frontmatter' }\n  }\n\n  if (srcPaths.length === 0) {\n    return { file: nodeFile, isStale: false }\n  }\n\n  // Glob all matching source files\n  const allFiles: string[] = []\n  for (const pattern of srcPaths) {\n    const matches = await glob(pattern, {\n      cwd: projectRoot,\n      nodir: true,\n      ignore: ['node_modules/**', 'dist/**', 'build/**', '.git/**', 'coverage/**'],\n    })\n    allFiles.push(...matches)\n  }\n\n  allFiles.sort()\n\n  if (allFiles.length === 0) {\n    return { file: nodeFile, isStale: true, reason: 'no source files match src_paths' }\n  }\n\n  // Compute SHA256 of all file contents concatenated\n  const hash = createHash('sha256')\n  for (const file of allFiles) {\n    try {\n      const fileContent = await readFile(join(projectRoot, file))\n      hash.update(fileContent)\n    } catch {\n      // File unreadable — skip\n    }\n  }\n  const currentHash = `sha256:${hash.digest('hex').slice(0, 12)}`\n\n  if (currentHash !== lastSynced.src_hash) {\n    return {\n      file: nodeFile,\n      isStale: true,\n      reason: `hash mismatch: expected ${lastSynced.src_hash}, got ${currentHash}`,\n    }\n  }\n\n  return { file: nodeFile, isStale: false }\n}\n\n// --- Discover all context nodes ---\n\nasync function discoverNodes(projectRoot: string): Promise<string[]> {\n  const nogrepDir = join(projectRoot, '.nogrep')\n  const patterns = [\n    'domains/*.md',\n    'architecture/*.md',\n    'flows/*.md',\n    'entities/*.md',\n  ]\n\n  const files: string[] = []\n  for (const pattern of patterns) {\n    const matches = await glob(pattern, { cwd: nogrepDir, nodir: true })\n    files.push(...matches.map(m => `.nogrep/${m}`))\n  }\n\n  return files.sort()\n}\n\n// --- Validate all nodes ---\n\nexport async function validateAll(\n  projectRoot: string,\n): Promise<{ total: number; fresh: StaleResult[]; stale: StaleResult[] }> {\n  const indexPath = join(projectRoot, '.nogrep', '_index.json')\n  try {\n    await readFile(indexPath, 'utf-8')\n  } catch {\n    throw new NogrepError(\n      'No .nogrep/_index.json found. Run /nogrep:init first.',\n      'NO_INDEX',\n    )\n  }\n\n  const nodeFiles = await discoverNodes(projectRoot)\n  const results = await Promise.all(\n    nodeFiles.map(f => checkFreshness(f, projectRoot)),\n  )\n\n  const fresh = results.filter(r => !r.isStale)\n  const stale = results.filter(r => r.isStale)\n\n  return { total: results.length, fresh, stale }\n}\n\n// --- Formatting ---\n\nfunction formatText(result: { total: number; fresh: StaleResult[]; stale: StaleResult[] }): string {\n  const lines: string[] = []\n  lines.push(`nogrep index: ${result.total} nodes`)\n  lines.push(`  Fresh: ${result.fresh.length}`)\n  lines.push(`  Stale: ${result.stale.length}`)\n\n  if (result.stale.length > 0) {\n    lines.push('')\n    lines.push('Stale nodes:')\n    for (const s of result.stale) {\n      lines.push(`  - ${s.file}: ${s.reason}`)\n    }\n  }\n\n  return lines.join('\\n')\n}\n\nfunction formatJson(result: { total: number; fresh: StaleResult[]; stale: StaleResult[] }): string {\n  return JSON.stringify(result, null, 2)\n}\n\n// --- CLI ---\n\nasync function main(): Promise<void> {\n  const { values } = parseArgs({\n    options: {\n      format: { type: 'string', default: 'text' },\n      root: { type: 'string', default: process.cwd() },\n    },\n    strict: true,\n  })\n\n  const root = resolvePath(values.root ?? process.cwd())\n  const format = values.format ?? 'text'\n\n  const result = await validateAll(root)\n\n  switch (format) {\n    case 'json':\n      process.stdout.write(formatJson(result) + '\\n')\n      break\n    case 'text':\n    default:\n      process.stdout.write(formatText(result) + '\\n')\n      break\n  }\n}\n\nmain().catch((err: unknown) => {\n  if (err instanceof NogrepError) {\n    process.stderr.write(JSON.stringify({ error: err.message, code: err.code }) + '\\n')\n  } else {\n    const message = err instanceof Error ? err.message : String(err)\n    process.stderr.write(JSON.stringify({ error: message }) + '\\n')\n  }\n  process.exitCode = 1\n})\n"],"mappings":"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","names":[]}

package/dist/write.d.ts

@@ -0,0 +1,8 @@
+import { NodeResult, StackResult, IndexJson, RegistryJson } from './types.js';
+
+declare function writeContextNodes(nodes: NodeResult[], outputDir: string): Promise<void>;
+declare function buildIndex(nodes: NodeResult[], stack: Pick<StackResult, 'primaryLanguage' | 'frameworks' | 'architecture'>): IndexJson;
+declare function buildRegistry(nodes: NodeResult[]): RegistryJson;
+declare function patchClaudeMd(projectRoot: string): Promise<void>;
+
+export { buildIndex, buildRegistry, patchClaudeMd, writeContextNodes };