vibe-fabric 0.3.3 → 0.4.1

package/dist/cli/commands/report.js

@@ -0,0 +1,160 @@
+/**
+ * vibe report - Generate exportable project reports
+ *
+ * Generates project reports in Markdown, JSON, or HTML format for sharing
+ * with stakeholders or integration with external tools.
+ */
+import { Command, Option } from 'clipanion';
+import chalk from 'chalk';
+import ora from 'ora';
+import { writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import path from 'path';
+import { loadConfig } from '../../core/config.js';
+import { findProjectRoot } from '../../core/project.js';
+import { aggregateReportData, generateMarkdown, generateJson, generateHtml, } from '../../core/report.js';
+/**
+ * Valid format values
+ */
+const VALID_FORMATS = ['markdown', 'json', 'html'];
+/**
+ * Valid type values
+ */
+const VALID_TYPES = ['full', 'status', 'coverage', 'gaps'];
+export class ReportCommand extends Command {
+    static paths = [['report']];
+    static usage = Command.Usage({
+        description: 'Generate exportable project reports',
+        details: `
+      Generates project reports in various formats for sharing with stakeholders
+      or integration with external tools.
+
+      Supported formats:
+      - markdown (default): GitHub-flavored Markdown
+      - json: Machine-readable JSON with schema
+      - html: Self-contained HTML with embedded CSS
+
+      Report types:
+      - full (default): All sections included
+      - status: Repository and scope status only
+      - coverage: PRD coverage analysis only
+      - gaps: Gap analysis only
+
+      Output is written to stdout by default, or to a file with --output.
+    `,
+        examples: [
+            ['Generate Markdown report to stdout', 'vibe report'],
+            ['Generate JSON report', 'vibe report --format json'],
+            ['Generate HTML report to file', 'vibe report --format html --output report.html'],
+            ['Generate coverage-only report', 'vibe report --type coverage'],
+            ['Generate gaps report as JSON', 'vibe report --type gaps --format json'],
+        ],
+    });
+    // Options
+    format = Option.String('--format,-f', 'markdown', {
+        description: 'Output format: markdown, json, html',
+    });
+    output = Option.String('--output,-o', {
+        description: 'Write report to file instead of stdout',
+    });
+    type = Option.String('--type,-t', 'full', {
+        description: 'Report type: full, status, coverage, gaps',
+    });
+    async execute() {
+        // Validate format
+        const format = this.format.toLowerCase();
+        if (!VALID_FORMATS.includes(format)) {
+            this.context.stderr.write(chalk.red(`  Error: Invalid format '${this.format}'.\n`));
+            this.context.stderr.write(chalk.gray(`  Valid formats: ${VALID_FORMATS.join(', ')}\n\n`));
+            return 1;
+        }
+        // Validate type
+        const reportType = this.type.toLowerCase();
+        if (!VALID_TYPES.includes(reportType)) {
+            this.context.stderr.write(chalk.red(`  Error: Invalid type '${this.type}'.\n`));
+            this.context.stderr.write(chalk.gray(`  Valid types: ${VALID_TYPES.join(', ')}\n\n`));
+            return 1;
+        }
+        // Find project root
+        const projectRoot = findProjectRoot(process.cwd());
+        if (!projectRoot) {
+            this.context.stderr.write(chalk.red('  Error: Not inside a vibe-fabric project.\n'));
+            this.context.stderr.write(chalk.gray('  Run `vibe init` to create a planning hub first.\n\n'));
+            return 1;
+        }
+        // Load config
+        const config = await loadConfig(projectRoot);
+        if (!config) {
+            this.context.stderr.write(chalk.red('  Error: Failed to load configuration.\n\n'));
+            return 1;
+        }
+        // Show spinner only when writing to file (stdout should be clean for piping)
+        const showSpinner = !!this.output;
+        const spinner = showSpinner ? ora('Generating report...').start() : null;
+        try {
+            // Aggregate data
+            const data = await aggregateReportData(projectRoot, config);
+            // Generate report
+            let report;
+            switch (format) {
+                case 'json':
+                    report = generateJson(data, reportType);
+                    break;
+                case 'html':
+                    report = generateHtml(data, reportType);
+                    break;
+                case 'markdown':
+                default:
+                    report = generateMarkdown(data, reportType);
+                    break;
+            }
+            // Output report
+            if (this.output) {
+                // Write to file
+                const outputPath = path.resolve(this.output);
+                const outputDir = path.dirname(outputPath);
+                // Create directory if it doesn't exist
+                if (!existsSync(outputDir)) {
+                    await mkdir(outputDir, { recursive: true });
+                }
+                await writeFile(outputPath, report, 'utf-8');
+                spinner?.succeed(chalk.green(`Report saved to ${outputPath}`));
+                // Show summary
+                this.context.stdout.write('\n');
+                this.context.stdout.write(chalk.gray(`  Format: ${format}\n`));
+                this.context.stdout.write(chalk.gray(`  Type: ${reportType}\n`));
+                this.context.stdout.write(chalk.gray(`  Health: ${getHealthDisplay(data.summary.health)}\n`));
+                this.context.stdout.write('\n');
+            }
+            else {
+                // Write to stdout
+                this.context.stdout.write(report);
+                if (!report.endsWith('\n')) {
+                    this.context.stdout.write('\n');
+                }
+            }
+            return 0;
+        }
+        catch (error) {
+            spinner?.fail(chalk.red('Failed to generate report'));
+            this.context.stderr.write(chalk.red(`  Error: ${error instanceof Error ? error.message : 'Unknown error'}\n\n`));
+            return 1;
+        }
+    }
+}
+/**
+ * Get colored health display
+ */
+function getHealthDisplay(health) {
+    switch (health) {
+        case 'healthy':
+            return chalk.green('healthy');
+        case 'warning':
+            return chalk.yellow('warning');
+        case 'critical':
+            return chalk.red('critical');
+        default:
+            return health;
+    }
+}
+//# sourceMappingURL=report.js.map

package/dist/cli/commands/report.js.map

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

package/dist/cli/index.js

@@ -6,14 +6,21 @@ import { HelpCommand } from './commands/help.js';
 import { DoctorCommand } from './commands/doctor.js';
 import { RepoAddCommand } from './commands/repo/add.js';
 import { RepoCreateCommand } from './commands/repo/create.js';
+import { RepoListCommand } from './commands/repo/list.js';
+import { RepoRemoveCommand } from './commands/repo/remove.js';
 import { PrdCommand } from './commands/prd.js';
+import { AnalyzeCommand } from './commands/analyze.js';
 import { ScopeCommand } from './commands/scope.js';
 import { SendCommand } from './commands/send.js';
 import { SyncCommand } from './commands/sync.js';
 import { StatusCommand } from './commands/status.js';
 import { CoverageCommand } from './commands/coverage.js';
 import { GapsCommand } from './commands/gaps.js';
+import { ReportCommand } from './commands/report.js';
 import { ClaudeCommandsCommand } from './commands/claude.js';
+import { ConfigGetCommand } from './commands/config/get.js';
+import { ConfigSetCommand } from './commands/config/set.js';
+import { ConfigListCommand } from './commands/config/list.js';
 import { runDashboard } from './ui/dashboard.js';
 // Create CLI instance
 const cli = new Cli({
@@ -28,14 +35,21 @@ cli.register(HelpCommand);
 cli.register(DoctorCommand);
 cli.register(RepoAddCommand);
 cli.register(RepoCreateCommand);
+cli.register(RepoListCommand);
+cli.register(RepoRemoveCommand);
 cli.register(PrdCommand);
+cli.register(AnalyzeCommand);
 cli.register(ScopeCommand);
 cli.register(SendCommand);
 cli.register(SyncCommand);
 cli.register(StatusCommand);
 cli.register(CoverageCommand);
 cli.register(GapsCommand);
+cli.register(ReportCommand);
 cli.register(ClaudeCommandsCommand);
+cli.register(ConfigGetCommand);
+cli.register(ConfigSetCommand);
+cli.register(ConfigListCommand);
 // Register built-in commands
 cli.register(Builtins.DefinitionsCommand);
 // Run CLI

package/dist/cli/index.js.map

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

package/dist/core/config.d.ts

@@ -15,4 +15,29 @@ export declare function isVibeProject(dirPath: string): boolean;
  * Get the config file path for a project
  */
 export declare function getConfigPath(projectPath: string): string;
+/**
+ * Get a config value by dot-notation key
+ * @param config - The configuration object
+ * @param key - Dot-notation key (e.g., "project.name", "repos")
+ * @returns The value at the key, or undefined if not found
+ */
+export declare function getConfigValue(config: Config, key: string): unknown;
+/**
+ * Set a config value by dot-notation key
+ * @param config - The configuration object to modify
+ * @param key - Dot-notation key (e.g., "project.name")
+ * @param value - The value to set
+ * @returns The modified config
+ */
+export declare function setConfigValue(config: Config, key: string, value: unknown): Config;
+/**
+ * Parse a string value to appropriate type
+ * @param value - The string value to parse
+ * @returns The parsed value (boolean, number, or string)
+ */
+export declare function parseValue(value: string): unknown;
+/**
+ * Get all valid config keys (for validation and autocomplete)
+ */
+export declare function getValidConfigKeys(): string[];
 //# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAgB,MAAM,oBAAoB,CAAC;AAmB1D;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsB5E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBnF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAgB,MAAM,oBAAoB,CAAC;AAmB1D;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsB5E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBnF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAWnE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,MAAM,CAcR;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAcjD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAc7C"}

package/dist/core/config.js

@@ -75,4 +75,81 @@ export function isVibeProject(dirPath) {
 export function getConfigPath(projectPath) {
     return path.join(projectPath, CONFIG_FILE_NAME);
 }
+/**
+ * Get a config value by dot-notation key
+ * @param config - The configuration object
+ * @param key - Dot-notation key (e.g., "project.name", "repos")
+ * @returns The value at the key, or undefined if not found
+ */
+export function getConfigValue(config, key) {
+    const parts = key.split('.');
+    let current = config;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Set a config value by dot-notation key
+ * @param config - The configuration object to modify
+ * @param key - Dot-notation key (e.g., "project.name")
+ * @param value - The value to set
+ * @returns The modified config
+ */
+export function setConfigValue(config, key, value) {
+    const parts = key.split('.');
+    const lastPart = parts.pop();
+    let current = config;
+    for (const part of parts) {
+        if (!(part in current) || typeof current[part] !== 'object') {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[lastPart] = value;
+    return config;
+}
+/**
+ * Parse a string value to appropriate type
+ * @param value - The string value to parse
+ * @returns The parsed value (boolean, number, or string)
+ */
+export function parseValue(value) {
+    // Boolean
+    if (value.toLowerCase() === 'true')
+        return true;
+    if (value.toLowerCase() === 'false')
+        return false;
+    // Number (only if it's a valid number and not empty)
+    const trimmed = value.trim();
+    if (trimmed !== '') {
+        const num = Number(trimmed);
+        if (!isNaN(num))
+            return num;
+    }
+    // String (return as-is)
+    return value;
+}
+/**
+ * Get all valid config keys (for validation and autocomplete)
+ */
+export function getValidConfigKeys() {
+    return [
+        'project',
+        'project.name',
+        'project.version',
+        'project.created',
+        'project.type',
+        'project.description',
+        'project.description.summary',
+        'project.description.goals',
+        'project.description.constraints',
+        'project.description.targetUsers',
+        'repos',
+    ];
+}
 //# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/repo/templates/claude-agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-agents.d.ts","sourceRoot":"","sources":["../../../../src/core/repo/templates/claude-agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,YAAY,EAAE,YAAY,EA4KtC,CAAC"}
+{"version":3,"file":"claude-agents.d.ts","sourceRoot":"","sources":["../../../../src/core/repo/templates/claude-agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,YAAY,EAAE,YAAY,EAwRtC,CAAC"}

package/dist/core/repo/templates/claude-agents.js

@@ -117,25 +117,79 @@ description: Pre-execution research for Ralph autonomous mode
 
 # Ralph Research Agent
 
-You prepare context for autonomous execution sessions.
+You prepare comprehensive context for autonomous task execution. Your research
+enables subsequent sessions to execute tasks without needing to re-investigate
+the codebase.
+
+## Context
+
+This agent runs ONCE at the start of a Ralph execution loop. The context you
+gather will be saved to the plan file and used by ALL subsequent task sessions.
+
+## Capabilities
+
+- Read and analyze plan files
+- Explore codebase structure via maps
+- Search knowledge base for patterns and gotchas
+- Identify key files for each task
+- Detect potential blockers early
 
 ## Task
 
-Before each execution session:
-1. Review the current plan state
-2. Identify what was completed in previous sessions
-3. Determine the next logical steps
-4. Gather relevant context (files, KB entries)
-5. Identify potential blockers
+1. **Read the Plan**
+   - Understand all tasks and their order
+   - Note dependencies between tasks
+   - Identify acceptance criteria
 
-## Output
+2. **Analyze Codebase**
+   - Read maps in \`vibe/maps/\` for architecture understanding
+   - Search \`vibe/knowledge-base/\` for relevant entries
+   - Check completed plans for similar work patterns
+   - Identify coding conventions and patterns
+
+3. **Map Files to Tasks**
+   - For each task, list specific files to read
+   - For each task, list files to create or modify
+   - Identify shared utilities and types
+   - Locate test file conventions
+
+4. **Document Findings**
+   - Append "Ralph Research Context" section to plan
+   - Include codebase summary, key patterns
+   - List files by task
+   - Note any potential blockers
+
+## Output Format
+
+Append to plan file:
+
+\`\`\`markdown
+## Ralph Research Context
+
+### Codebase Summary
+- [Architecture patterns]
+- [Coding conventions]
+- [Key utilities]
+
+### Key Files by Task
+
+**Task 1:**
+- Read: [files]
+- Modify: [files]
+- Test: [test files]
+
+[Continue for all tasks...]
+
+### Potential Blockers
+- [Identified risks]
+\`\`\`
+
+## Guidelines
 
-Produce a session brief containing:
-- Summary of progress so far
-- Next steps to execute
-- Required context and files
-- Known risks or considerations
-- Success criteria for this session
+- Be thorough - task sessions depend on this research
+- Be specific - use actual file paths
+- Be concise - avoid unnecessary prose
+- EXIT immediately when complete
 `,
     },
     // ralph-cleanup-agent.md
@@ -148,25 +202,79 @@ description: Post-execution verification for Ralph autonomous mode
 
 # Ralph Cleanup Agent
 
-You verify and clean up after autonomous execution sessions.
+You verify and finalize work after all tasks are complete. This is the last
+phase of a Ralph execution loop.
+
+## Context
+
+This agent runs ONCE after all tasks have been executed. You verify the complete
+implementation, run quality checks, and prepare the plan for completion.
+
+## Capabilities
+
+- Run test suites and quality checks
+- Verify acceptance criteria
+- Update plan documentation
+- Add knowledge base entries
+- Finalize plan status
 
 ## Task
 
-After each execution session:
-1. Verify changes are correct and complete
-2. Run relevant tests
-3. Update progress log
-4. Check acceptance criteria
-5. Prepare handoff notes for next session
+1. **Run Quality Checks**
+   - Execute full test suite: \`npm test\`
+   - Run typecheck: \`npm run typecheck\`
+   - Run linter: \`npm run lint\`
+   - Run build: \`npm run build\`
 
-## Output
+2. **Verify Acceptance Criteria**
+   - Review each AC from the plan
+   - Mark each as verified or note issues
+   - Be honest about failures
+
+3. **Review Changes**
+   - Check all modified files
+   - Remove debug code or console.logs
+   - Ensure formatting is consistent
+
+4. **Finalize Documentation**
+   - Add completion summary to plan
+   - Update plan status to "complete"
+   - Create knowledge base entries for learnings
+
+## Output Format
+
+Add to plan file:
+
+\`\`\`markdown
+## Completion Summary
+
+### Verification Date
+[Date]
+
+### Quality Checks
+- [x] Tests pass
+- [x] Typecheck passes
+- [x] Lint passes
+- [x] Build succeeds
+
+### Acceptance Criteria
+- [x] AC-1: Verified
+- [x] AC-2: Verified
+
+### Files Changed
+- [List of all files]
+
+### Status
+**COMPLETE**
+\`\`\`
+
+## Guidelines
 
-Produce a session summary containing:
-- Changes made in this session
-- Test results
-- Updated acceptance criteria checklist
-- Any issues encountered
-- Recommendations for next session
+- Run ALL quality checks
+- Be honest about failures
+- Simple fixes (formatting) can be done
+- Complex issues should be noted, not fixed
+- EXIT immediately when complete
 `,
     },
 ];

package/dist/core/repo/templates/claude-agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-agents.js","sourceRoot":"","sources":["../../../../src/core/repo/templates/claude-agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,qBAAqB;IACrB;QACE,IAAI,EAAE,mCAAmC;QACzC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCZ;KACE;IAED,mBAAmB;IACnB;QACE,IAAI,EAAE,iCAAiC;QACvC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCZ;KACE;IAED,gBAAgB;IAChB;QACE,IAAI,EAAE,8BAA8B;QACpC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;CAwBZ;KACE;IAED,0BAA0B;IAC1B;QACE,IAAI,EAAE,wCAAwC;QAC9C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BZ;KACE;IAED,yBAAyB;IACzB;QACE,IAAI,EAAE,uCAAuC;QAC7C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BZ;KACE;CACF,CAAC"}
+{"version":3,"file":"claude-agents.js","sourceRoot":"","sources":["../../../../src/core/repo/templates/claude-agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,qBAAqB;IACrB;QACE,IAAI,EAAE,mCAAmC;QACzC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCZ;KACE;IAED,mBAAmB;IACnB;QACE,IAAI,EAAE,iCAAiC;QACvC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCZ;KACE;IAED,gBAAgB;IAChB;QACE,IAAI,EAAE,8BAA8B;QACpC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;CAwBZ;KACE;IAED,0BAA0B;IAC1B;QACE,IAAI,EAAE,wCAAwC;QAC9C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFZ;KACE;IAED,yBAAyB;IACzB;QACE,IAAI,EAAE,uCAAuC;QAC7C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFZ;KACE;CACF,CAAC"}

package/dist/core/repo/templates/claude-prompts.d.ts

@@ -1,5 +1,5 @@
 /**
- * .claude/prompts/ templates
+ * .claude/prompts/ templates for Ralph autonomous executor
  */
 import type { TemplateFile } from './index.js';
 export declare const claudePrompts: TemplateFile[];

package/dist/core/repo/templates/claude-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-prompts.d.ts","sourceRoot":"","sources":["../../../../src/core/repo/templates/claude-prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,aAAa,EAAE,YAAY,EAkQvC,CAAC"}
+{"version":3,"file":"claude-prompts.d.ts","sourceRoot":"","sources":["../../../../src/core/repo/templates/claude-prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,aAAa,EAAE,YAAY,EAigBvC,CAAC"}