@vinaes/succ 1.3.19

package/dist/lib/patterns.js

@@ -0,0 +1,395 @@
+/**
+ * Common file patterns for code and documentation indexing.
+ *
+ * Based on:
+ * - GitHub Linguist (https://github.com/github-linguist/linguist)
+ * - GitHub gitignore templates (https://github.com/github/gitignore)
+ */
+/**
+ * Code file extensions to index/watch.
+ * Covers most common programming languages used in production.
+ */
+export const CODE_EXTENSIONS = new Set([
+    // JavaScript/TypeScript ecosystem
+    '.js',
+    '.jsx',
+    '.ts',
+    '.tsx',
+    '.mjs',
+    '.cjs',
+    '.mts',
+    '.cts',
+    // Python
+    '.py',
+    '.pyw',
+    '.pyi',
+    // Java/JVM languages
+    '.java',
+    '.kt',
+    '.kts',
+    '.scala',
+    '.groovy',
+    // C/C++
+    '.c',
+    '.h',
+    '.cpp',
+    '.cc',
+    '.cxx',
+    '.hpp',
+    '.hh',
+    // C#/.NET
+    '.cs',
+    '.fs',
+    '.vb',
+    // Go
+    '.go',
+    // Rust
+    '.rs',
+    // Ruby
+    '.rb',
+    '.rake',
+    // PHP
+    '.php',
+    // Swift
+    '.swift',
+    // Dart
+    '.dart',
+    // Shell
+    '.sh',
+    '.bash',
+    '.zsh',
+    // Lua
+    '.lua',
+    // Elixir/Erlang
+    '.ex',
+    '.exs',
+    '.erl',
+    // Haskell
+    '.hs',
+    // SQL
+    '.sql',
+    // GraphQL
+    '.graphql',
+    '.gql',
+]);
+/**
+ * Documentation file extensions to index/watch.
+ */
+export const DOC_EXTENSIONS = new Set([
+    '.md',
+    '.mdx',
+    '.markdown',
+    '.txt',
+    '.text',
+    '.rst',
+    '.adoc',
+    '.asciidoc',
+]);
+/**
+ * Default glob patterns for code files.
+ */
+export const DEFAULT_CODE_PATTERNS = [
+    // JavaScript/TypeScript
+    '**/*.js',
+    '**/*.jsx',
+    '**/*.ts',
+    '**/*.tsx',
+    '**/*.mjs',
+    '**/*.cjs',
+    '**/*.mts',
+    '**/*.cts',
+    // Python
+    '**/*.py',
+    '**/*.pyw',
+    '**/*.pyi',
+    // Java/JVM
+    '**/*.java',
+    '**/*.kt',
+    '**/*.kts',
+    '**/*.scala',
+    '**/*.groovy',
+    '**/*.gradle',
+    '**/*.clj',
+    '**/*.cljs',
+    '**/*.cljc',
+    // C/C++
+    '**/*.c',
+    '**/*.h',
+    '**/*.cpp',
+    '**/*.cc',
+    '**/*.cxx',
+    '**/*.hpp',
+    '**/*.hh',
+    '**/*.hxx',
+    '**/*.ino',
+    // C#/.NET
+    '**/*.cs',
+    '**/*.fs',
+    '**/*.fsx',
+    '**/*.vb',
+    // Go
+    '**/*.go',
+    // Rust
+    '**/*.rs',
+    // Ruby
+    '**/*.rb',
+    '**/*.rake',
+    '**/*.gemspec',
+    // PHP
+    '**/*.php',
+    // Swift
+    '**/*.swift',
+    // Dart
+    '**/*.dart',
+    // Shell
+    '**/*.sh',
+    '**/*.bash',
+    '**/*.zsh',
+    // Lua
+    '**/*.lua',
+    // Elixir/Erlang
+    '**/*.ex',
+    '**/*.exs',
+    '**/*.erl',
+    // Haskell
+    '**/*.hs',
+    // SQL
+    '**/*.sql',
+];
+/**
+ * Directories to ignore (for fast path checking).
+ */
+export const IGNORE_DIRS = new Set([
+    '.git',
+    '.svn',
+    '.hg',
+    'node_modules',
+    'bower_components',
+    'jspm_packages',
+    'web_modules',
+    'vendor',
+    '.bundle',
+    'Pods',
+    '__pycache__',
+    '.venv',
+    'venv',
+    'env',
+    '.eggs',
+    '.tox',
+    '.nox',
+    '.pytest_cache',
+    '.mypy_cache',
+    '.ruff_cache',
+    'dist',
+    'build',
+    'out',
+    '.next',
+    '.nuxt',
+    '.output',
+    '.svelte-kit',
+    '.vitepress',
+    '.docusaurus',
+    '.cache',
+    '.parcel-cache',
+    '.turbo',
+    'target',
+    'bin',
+    '.gradle',
+    'gradle',
+    'debug',
+    'obj',
+    'packages',
+    '.vs',
+    'coverage',
+    '.nyc_output',
+    'htmlcov',
+    '.idea',
+    '.vscode',
+    '.obsidian',
+    'logs',
+    '.claude',
+    'tmp',
+    'temp',
+    '.tmp',
+    '.hypothesis',
+    'test-results',
+    'playwright-report',
+    'docs/_build',
+    'site',
+    'generated',
+]);
+/**
+ * Default glob ignore patterns.
+ */
+export const DEFAULT_IGNORE_PATTERNS = [
+    // Version control
+    '**/.git/**',
+    '**/.svn/**',
+    '**/.hg/**',
+    // Dependencies
+    '**/node_modules/**',
+    '**/bower_components/**',
+    '**/jspm_packages/**',
+    '**/web_modules/**',
+    '**/vendor/**',
+    '**/.bundle/**',
+    '**/Pods/**',
+    // Python
+    '**/__pycache__/**',
+    '**/*.py[cod]',
+    '**/.venv/**',
+    '**/venv/**',
+    '**/env/**',
+    '**/.eggs/**',
+    '**/*.egg-info/**',
+    '**/.tox/**',
+    '**/.nox/**',
+    '**/.pytest_cache/**',
+    '**/.mypy_cache/**',
+    '**/.ruff_cache/**',
+    // JavaScript/TypeScript build
+    '**/dist/**',
+    '**/build/**',
+    '**/out/**',
+    '**/.next/**',
+    '**/.nuxt/**',
+    '**/.output/**',
+    '**/.svelte-kit/**',
+    '**/.vitepress/**',
+    '**/.docusaurus/**',
+    '**/.cache/**',
+    '**/.parcel-cache/**',
+    '**/.turbo/**',
+    // Java/JVM
+    '**/target/**',
+    '**/bin/**',
+    '**/.gradle/**',
+    '**/gradle/**',
+    '**/*.class',
+    // Rust
+    '**/debug/**',
+    // Go
+    '**/go/pkg/**',
+    // .NET
+    '**/obj/**',
+    '**/packages/**',
+    '**/.vs/**',
+    // Minified/bundled files
+    '**/*.min.js',
+    '**/*.min.css',
+    '**/*.bundle.js',
+    '**/*.chunk.js',
+    // Coverage
+    '**/coverage/**',
+    '**/.nyc_output/**',
+    '**/htmlcov/**',
+    // IDE/Editors
+    '**/.idea/**',
+    '**/.vscode/**',
+    '**/.obsidian/**',
+    '**/*.swp',
+    '**/*.swo',
+    '**/*~',
+    // OS files
+    '**/.DS_Store',
+    '**/Thumbs.db',
+    '**/desktop.ini',
+    // Lock files and logs
+    '**/*.log',
+    '**/logs/**',
+    '**/*.lock',
+    '**/package-lock.json',
+    '**/yarn.lock',
+    '**/pnpm-lock.yaml',
+    '**/Gemfile.lock',
+    '**/Cargo.lock',
+    '**/poetry.lock',
+    '**/composer.lock',
+    // Environment/secrets
+    '**/.env',
+    '**/.env.*',
+    '**/secrets/**',
+    '**/*.pem',
+    '**/*.key',
+    // Testing
+    '**/.hypothesis/**',
+    '**/test-results/**',
+    '**/playwright-report/**',
+    // Documentation build
+    '**/docs/_build/**',
+    '**/site/**',
+    // Temporary
+    '**/tmp/**',
+    '**/temp/**',
+    '**/.tmp/**',
+    // succ/Claude specific
+    '**/.claude/**',
+    '**/.succ/**',
+    // Generated
+    '**/generated/**',
+    '**/*.generated.*',
+    '**/*.auto.*',
+];
+/**
+ * Specific paths to ignore within .succ directory.
+ * These are checked separately to allow .succ/brain/** files.
+ */
+export const IGNORE_SUCC_PATHS = new Set([
+    '.tmp',
+    'succ.db',
+    'succ.db-wal',
+    'succ.db-shm',
+    'daemon.log',
+    'config.json',
+]);
+/**
+ * Get file type based on extension.
+ */
+export function getFileType(filePath) {
+    const ext = filePath.substring(filePath.lastIndexOf('.')).toLowerCase();
+    if (CODE_EXTENSIONS.has(ext))
+        return 'code';
+    if (DOC_EXTENSIONS.has(ext))
+        return 'doc';
+    return null;
+}
+/**
+ * Check if a path should be ignored based on directory components.
+ * Fast path check without glob matching.
+ */
+export function shouldIgnorePath(relativePath, sep = '/') {
+    const parts = relativePath.split(sep);
+    // Check each directory component
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (IGNORE_DIRS.has(parts[i])) {
+            return true;
+        }
+    }
+    // Special handling for .succ directory
+    if (parts[0] === '.succ') {
+        // Allow .succ/brain/** files
+        if (parts.length > 1 && parts[1] === 'brain') {
+            return false;
+        }
+        // Ignore specific files in .succ
+        if (parts.length === 2 && IGNORE_SUCC_PATHS.has(parts[1])) {
+            return true;
+        }
+        // Ignore .succ/.tmp/**
+        if (parts.length > 1 && parts[1] === '.tmp') {
+            return true;
+        }
+        // Allow other .succ files (like soul.md)
+        return false;
+    }
+    // Check filename patterns
+    const filename = parts[parts.length - 1];
+    if (filename === '.DS_Store' || filename === '.env' || filename.endsWith('.log')) {
+        return true;
+    }
+    if (filename.startsWith('.env.')) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=patterns.js.map

package/dist/lib/patterns.js.map

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

package/dist/lib/prd/codebase-context.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Codebase Context Enrichment
+ *
+ * Gathers real project context for LLM prompts during PRD generation and parsing.
+ * This ensures the LLM sees actual file structure, relevant code, memories, and docs
+ * rather than guessing the architecture.
+ *
+ * Context budget: ~8500 tokens total
+ * - File tree: ~2000 tokens
+ * - Code search: ~3000 tokens
+ * - Memories: ~2000 tokens
+ * - Brain docs: ~1500 tokens
+ */
+import type { CodebaseContext } from './types.js';
+/**
+ * Gather codebase context for LLM prompts.
+ * Used by both generate.ts and parse.ts before calling LLM.
+ *
+ * @param description - The PRD description or content to gather context for
+ * @returns CodebaseContext with formatted sections
+ */
+export declare function gatherCodebaseContext(description: string): Promise<CodebaseContext>;
+/**
+ * Format codebase context into a string for prompt injection
+ */
+export declare function formatContext(ctx: CodebaseContext): string;
+//# sourceMappingURL=codebase-context.d.ts.map

package/dist/lib/prd/codebase-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-context.d.ts","sourceRoot":"","sources":["../../../src/lib/prd/codebase-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAuRlD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CASzF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAoB1D"}