feat: Mode system with inheritance and multilingual support (#412)
* feat: add domain management system with support for multiple domain profiles
- Introduced DomainManager class for loading and managing domain profiles.
- Added support for a default domain ('code') and fallback mechanisms.
- Implemented domain configuration validation and error handling.
- Created types for domain configuration, observation types, and concepts.
- Added new directory for domain profiles and ensured its existence.
- Updated SettingsDefaultsManager to include CLAUDE_MEM_DOMAIN setting.
* Refactor domain management to mode management
- Removed DomainManager class and replaced it with ModeManager for better clarity and functionality.
- Updated types from DomainConfig to ModeConfig and DomainPrompts to ModePrompts.
- Changed references from domains to modes in the settings and paths.
- Ensured backward compatibility by maintaining the fallback mechanism to the 'code' mode.
* feat: add migration 008 to support mode-agnostic observations and refactor service layer references in documentation
* feat: add new modes for code development and email investigation with detailed observation types and concepts
* Refactor observation parsing and prompt generation to incorporate mode-specific configurations
- Updated `parseObservations` function to use 'observation' as a universal fallback type instead of 'change', utilizing active mode's valid observation types.
- Modified `buildInitPrompt` and `buildContinuationPrompt` functions to accept a `ModeConfig` parameter, allowing for dynamic prompt content based on the active mode.
- Enhanced `ModePrompts` interface to include additional guidance for observers, such as recording focus and skip guidance.
- Adjusted the SDKAgent to load the active mode and pass it to prompt generation functions, ensuring prompts are tailored to the current mode's context.
* fix: correct mode prompt injection to preserve exact wording and type list visibility
- Add script to extract prompts from main branch prompts.ts into code.yaml
- Fix prompts.ts to show type list in XML template (e.g., "[ bugfix | feature | ... ]")
- Keep 'change' as fallback type in parser.ts (maintain backwards compatibility)
- Regenerate code.yaml with exact wording from original hardcoded prompts
- Build succeeds with no TypeScript errors
* fix: update ModeManager to load JSON mode files and improve validation
- Changed ModeManager to load mode configurations from JSON files instead of YAML.
- Removed the requirement for an "observation" type and updated validation to require at least one observation type.
- Updated fallback behavior in the parser to use the first type from the active mode's type list.
- Added comprehensive tests for mode loading, prompt injection, and parser integration, ensuring correct behavior across different modes.
- Introduced new mode JSON files for "Code Development" and "Email Investigation" with detailed observation types and prompts.
* Add mode configuration loading and update licensing information for Ragtime
- Implemented loading of mode configuration in WorkerService before database initialization.
- Added PolyForm Noncommercial License 1.0.0 to Ragtime directory.
- Created README.md for Ragtime with licensing details and usage guidelines.
* fix: add datasets directory to .gitignore to prevent accidental commits
* refactor: remove unused plugin package.json file
* chore: add package.json for claude-mem plugin with version 7.4.5
* refactor: remove outdated tests and improve error handling
- Deleted tests for ChromaSync error handling, smart install, strip memory tags, and user prompt tag stripping due to redundancy or outdated logic.
- Removed vitest configuration as it is no longer needed.
- Added a comprehensive implementation plan for fixing the modes system, addressing critical issues and improving functionality.
- Created a detailed test analysis report highlighting the quality and effectiveness of the current test suite, identifying areas for improvement.
- Introduced a new plugin package.json for runtime dependencies related to claude-mem hooks.
* refactor: remove parser regression tests to streamline codebase
* docs: update CLAUDE.md to clarify test management and changelog generation
* refactor: remove migration008 for mode-agnostic observations
* Refactor observation type handling to use ModeManager for icons and emojis
- Removed direct mappings of observation types to icons and work emojis in context-generator, FormattingService, SearchManager, and TimelineService.
- Integrated ModeManager to dynamically retrieve icons and emojis based on the active mode.
- Improved maintainability by centralizing the logic for observation type representation.
* Refactor observation metadata constants and update context generator
- Removed the explicit declaration of OBSERVATION_TYPES and OBSERVATION_CONCEPTS from observation-metadata.ts.
- Introduced fallback default strings for DEFAULT_OBSERVATION_TYPES_STRING and DEFAULT_OBSERVATION_CONCEPTS_STRING.
- Updated context-generator.ts to utilize observation types and concepts from ModeManager instead of constants.
* refactor: remove intermediate error handling from hooks (Phase 1)
Apply "fail fast" error handling strategy - errors propagate and crash loud
instead of being caught, wrapped, and re-thrown at intermediate layers.
Changes:
- Remove try/catch around fetch calls in all hooks - let errors throw
- Add try/catch ONLY around JSON.parse at entry points
- Delete error-handler.ts and hook-error-handler.ts (no longer needed)
- Update worker-utils.ts: functions now throw instead of returning null
- Update transcript-parser.ts: throw on missing path, empty file, malformed JSON
- Remove all handleWorkerError, handleFetchError imports
Philosophy: If something breaks, we KNOW it broke. No silent failures.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor: remove intermediate error handling from worker service (Phase 2)
Apply "fail fast" error handling strategy to worker service layer.
Changes:
- worker-service.ts: Remove try/catch from version endpoint, cleanup,
MCP close, process enumeration, force kill, and isAlive check
- SessionRoutes.ts: Remove try/catch from JSON.stringify calls, remove
.catch() from Chroma sync and SDK agent calls
- SettingsRoutes.ts: Remove try/catch from toggleMcp()
- DatabaseManager.ts: Remove .catch() from backfill and close operations
- SDKAgent.ts: Keep outer try/catch (top-level), remove .catch() from
Chroma sync operations
- SSEBroadcaster.ts: Remove try/catch from broadcast and sendToClient
Philosophy: Errors propagate and crash loud. BaseRouteHandler.wrapHandler
provides top-level catching for HTTP routes.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor: remove error swallowing from SQLite services (Phase 3)
Apply "fail fast" error handling strategy to database layer.
SessionStore.ts migrations:
- ensureWorkerPortColumn(): Remove outer try/catch, let it throw
- ensurePromptTrackingColumns(): Remove outer try/catch, let it throw
- removeSessionSummariesUniqueConstraint(): Keep inner transaction
rollback, remove outer catch
- addObservationHierarchicalFields(): Remove outer try/catch
- makeObservationsTextNullable(): Keep inner transaction rollback,
remove outer catch
- createUserPromptsTable(): Keep inner transaction rollback, remove
outer catch
- getFilesForSession(): Remove try/catch around JSON.parse
SessionSearch.ts:
- ensureFTSTables(): Remove try/catch, let it throw
Philosophy: Migration errors that are swallowed mean we think the
database is fine when it's not. Keep only inner transaction rollback
try/catch blocks.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor: remove error hiding from utilities (Phase 4)
Apply "fail fast" error handling strategy to utility layer.
logger.ts:
- formatTool(): Remove try/catch, let JSON.parse throw on malformed input
context-generator.ts:
- loadContextConfig(): Remove try/catch, let parseInt throw on invalid settings
- Transcript extraction: Remove try/catch, let file read errors propagate
ChromaSync.ts:
- close(): Remove nested try/catch blocks, let close errors propagate
Philosophy: No silent fallbacks or hidden defaults. If something breaks,
we know it broke immediately.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: serve static UI assets and update package root path
- Added middleware to serve static UI assets (JS, CSS, fonts, etc.) in ViewerRoutes.
- Updated getPackageRoot function to correctly return the package root directory as one level up from the current directory.
* feat: Enhance mode loading with inheritance support
- Introduced parseInheritance method to handle parent--override mode IDs.
- Added deepMerge method for recursively merging mode configurations.
- Updated loadMode method to support inheritance, loading parent modes and applying overrides.
- Improved error handling for missing mode files and logging for better traceability.
* fix(modes): correct inheritance file resolution and path handling
* Refactor code structure for improved readability and maintainability
* feat: Add mode configuration documentation and examples
* fix: Improve concurrency handling in translateReadme function
* Refactor SDK prompts to enhance clarity and structure
- Updated the `buildInitPrompt` and `buildContinuationPrompt` functions in `prompts.ts` to improve the organization of prompt components, including the addition of language instructions and footer messages.
- Removed redundant instructions and emphasized the importance of recording observations.
- Modified the `ModePrompts` interface in `types.ts` to include new properties for system identity, language instructions, and output format header, ensuring better flexibility and clarity in prompt generation.
* Enhance prompts with language instructions and XML formatting
- Updated `buildInitPrompt`, `buildSummaryPrompt`, and `buildContinuationPrompt` functions to include detailed language instructions in XML comments.
- Ensured that language instructions guide users to keep XML tags in English while writing content in the specified language.
- Modified the `buildSummaryPrompt` function to accept `mode` as a parameter for consistency.
- Adjusted the call to `buildSummaryPrompt` in `SDKAgent` to pass the `mode` argument.
* Refactor XML prompt generation in SDK
- Updated the buildInitPrompt, buildSummaryPrompt, and buildContinuationPrompt functions to use new placeholders for XML elements, improving maintainability and readability.
- Removed redundant language instructions in comments for clarity.
- Added new properties to ModePrompts interface for better structure and organization of XML placeholders and section headers.
* feat: Update observation prompts and structure across multiple languages
* chore: Remove planning docs and update Ragtime README
Remove ephemeral development artifacts:
- .claude/plans/modes-system-fixes.md
- .claude/test-analysis-report.md
- PROMPT_INJECTION_ANALYSIS.md
Update ragtime/README.md to explain:
- Feature is not yet implemented
- Dependency on modes system (now complete in PR #412)
- Ready to be scripted out in future release
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
* fix: Move summary prompts to mode files for multilingual support
Summary prompts were hardcoded in English in prompts.ts, breaking
multilingual support. Now properly mode-based:
- Added summary_instruction, summary_context_label,
summary_format_instruction, summary_footer to code.json
- Updated buildSummaryPrompt() to use mode fields instead of hardcoded text
- Added summary_footer with language instructions to all 10 language modes
- Language modes keep English prompts + language requirement footer
This fixes the gaslighting where we claimed full multilingual support
but summaries were still generated in English.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
* chore: Clean up README by removing local preview instructions and streamlining beta features section
* Add translated README files for Ukrainian, Vietnamese, and Chinese languages
* Add new language modes for code development in multiple languages
- Introduced JSON configurations for Code Development in Greek, Finnish, Hebrew, Hindi, Hungarian, Indonesian, Italian, Dutch, Norwegian, Polish, Brazilian Portuguese, Romanian, Swedish, Turkish, and Ukrainian.
- Each configuration includes prompts for observations, summaries, and instructions tailored to the respective language.
- Ensured that all prompts emphasize the importance of generating observations without referencing the agent's actions.
* Add multilingual support links to README files in various languages
- Updated README.id.md, README.it.md, README.ja.md, README.ko.md, README.nl.md, README.no.md, README.pl.md, README.pt-br.md, README.ro.md, README.ru.md, README.sv.md, README.th.md, README.tr.md, README.uk.md, README.vi.md, and README.zh.md to include links to other language versions.
- Each README now features a centered paragraph with flags and links for easy navigation between different language documents.
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Alex Newman
@@ -1,134 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Analyze usage logs from ~/.claude-mem/usage-logs/
|
||||
*
|
||||
* Usage:
|
||||
* node scripts/analyze-usage.js [date]
|
||||
*
|
||||
* Example:
|
||||
* node scripts/analyze-usage.js 2025-11-03
|
||||
* node scripts/analyze-usage.js # Uses today's date
|
||||
*/
|
||||
|
||||
import { readFileSync, readdirSync } from 'fs';
|
||||
import { join } from 'path';
|
||||
import { homedir } from 'os';
|
||||
|
||||
const usageDir = join(homedir(), '.claude-mem', 'usage-logs');
|
||||
|
||||
// Get date from command line or use today
|
||||
const targetDate = process.argv[2] || new Date().toISOString().split('T')[0];
|
||||
const filename = `usage-${targetDate}.jsonl`;
|
||||
const filepath = join(usageDir, filename);
|
||||
|
||||
console.log(`\n📊 Usage Analysis for ${targetDate}\n`);
|
||||
console.log(`Reading from: ${filepath}\n`);
|
||||
|
||||
try {
|
||||
const content = readFileSync(filepath, 'utf-8');
|
||||
const lines = content.trim().split('\n');
|
||||
|
||||
let totalCost = 0;
|
||||
let totalInputTokens = 0;
|
||||
let totalOutputTokens = 0;
|
||||
let totalCacheCreation = 0;
|
||||
let totalCacheRead = 0;
|
||||
const projectStats = {};
|
||||
const modelStats = {};
|
||||
|
||||
lines.forEach(line => {
|
||||
if (!line.trim()) return;
|
||||
|
||||
try {
|
||||
const entry = JSON.parse(line);
|
||||
|
||||
// Aggregate totals
|
||||
totalCost += entry.totalCostUsd || 0;
|
||||
totalInputTokens += entry.usage?.inputTokens || 0;
|
||||
totalOutputTokens += entry.usage?.outputTokens || 0;
|
||||
totalCacheCreation += entry.usage?.cacheCreationInputTokens || 0;
|
||||
totalCacheRead += entry.usage?.cacheReadInputTokens || 0;
|
||||
|
||||
// Project stats
|
||||
if (!projectStats[entry.project]) {
|
||||
projectStats[entry.project] = {
|
||||
cost: 0,
|
||||
sessions: new Set(),
|
||||
tokens: 0
|
||||
};
|
||||
}
|
||||
projectStats[entry.project].cost += entry.totalCostUsd || 0;
|
||||
projectStats[entry.project].sessions.add(entry.sessionDbId);
|
||||
projectStats[entry.project].tokens += (entry.usage?.inputTokens || 0) + (entry.usage?.outputTokens || 0);
|
||||
|
||||
// Model stats
|
||||
if (!modelStats[entry.model]) {
|
||||
modelStats[entry.model] = {
|
||||
cost: 0,
|
||||
calls: 0,
|
||||
tokens: 0
|
||||
};
|
||||
}
|
||||
modelStats[entry.model].cost += entry.totalCostUsd || 0;
|
||||
modelStats[entry.model].calls += 1;
|
||||
modelStats[entry.model].tokens += (entry.usage?.inputTokens || 0) + (entry.usage?.outputTokens || 0);
|
||||
|
||||
} catch (e) {
|
||||
console.error(`Error parsing line: ${e.message}`);
|
||||
}
|
||||
});
|
||||
|
||||
// Print summary
|
||||
console.log('═══════════════════════════════════════════════════════════\n');
|
||||
console.log(`📈 Total Cost: $${totalCost.toFixed(4)}`);
|
||||
console.log(`📊 Total API Calls: ${lines.length}`);
|
||||
console.log(`\n🎯 Token Usage:`);
|
||||
console.log(` Input Tokens: ${totalInputTokens.toLocaleString()}`);
|
||||
console.log(` Output Tokens: ${totalOutputTokens.toLocaleString()}`);
|
||||
console.log(` Cache Creation Tokens: ${totalCacheCreation.toLocaleString()}`);
|
||||
console.log(` Cache Read Tokens: ${totalCacheRead.toLocaleString()}`);
|
||||
console.log(` Total Tokens: ${(totalInputTokens + totalOutputTokens).toLocaleString()}`);
|
||||
|
||||
if (totalCacheRead > 0) {
|
||||
const savings = ((totalCacheRead / (totalInputTokens + totalCacheRead)) * 100).toFixed(1);
|
||||
console.log(` Cache Hit Rate: ${savings}%`);
|
||||
}
|
||||
|
||||
console.log(`\n📁 By Project:`);
|
||||
Object.entries(projectStats)
|
||||
.sort((a, b) => b[1].cost - a[1].cost)
|
||||
.forEach(([project, stats]) => {
|
||||
console.log(` ${project}:`);
|
||||
console.log(` Cost: $${stats.cost.toFixed(4)}`);
|
||||
console.log(` Sessions: ${stats.sessions.size}`);
|
||||
console.log(` Tokens: ${stats.tokens.toLocaleString()}`);
|
||||
});
|
||||
|
||||
console.log(`\n🤖 By Model:`);
|
||||
Object.entries(modelStats)
|
||||
.sort((a, b) => b[1].cost - a[1].cost)
|
||||
.forEach(([model, stats]) => {
|
||||
console.log(` ${model}:`);
|
||||
console.log(` Cost: $${stats.cost.toFixed(4)}`);
|
||||
console.log(` Calls: ${stats.calls}`);
|
||||
console.log(` Tokens: ${stats.tokens.toLocaleString()}`);
|
||||
console.log(` Avg Cost/Call: $${(stats.cost / stats.calls).toFixed(4)}`);
|
||||
});
|
||||
|
||||
console.log('\n═══════════════════════════════════════════════════════════\n');
|
||||
|
||||
} catch (error) {
|
||||
if (error.code === 'ENOENT') {
|
||||
console.error(`❌ No usage log found for ${targetDate}`);
|
||||
console.log(`\nAvailable logs:`);
|
||||
try {
|
||||
const files = readdirSync(usageDir).filter(f => f.endsWith('.jsonl'));
|
||||
files.forEach(f => console.log(` - ${f}`));
|
||||
} catch (e) {
|
||||
console.error(` Could not read usage logs directory`);
|
||||
}
|
||||
} else {
|
||||
console.error(`❌ Error: ${error.message}`);
|
||||
}
|
||||
process.exit(1);
|
||||
}
|
||||
@@ -0,0 +1,178 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Extract prompt sections from src/sdk/prompts.ts and generate modes/code.yaml
|
||||
* This ensures the YAML contains the exact same wording as the hardcoded prompts
|
||||
*/
|
||||
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
// Read the prompts.ts from main branch (saved to /tmp)
|
||||
const promptsPath = '/tmp/prompts-main.ts';
|
||||
const promptsContent = fs.readFileSync(promptsPath, 'utf-8');
|
||||
|
||||
// Extract buildInitPrompt function content
|
||||
const initPromptMatch = promptsContent.match(/export function buildInitPrompt\([^)]+\): string \{[\s\S]*?return `([\s\S]*?)`;\s*\}/);
|
||||
if (!initPromptMatch) {
|
||||
console.error('Could not find buildInitPrompt function');
|
||||
process.exit(1);
|
||||
}
|
||||
const initPrompt = initPromptMatch[1];
|
||||
|
||||
// Extract sections from buildInitPrompt
|
||||
// Line 41: observer_role starts with "Your job is to monitor..."
|
||||
const observerRoleMatch = initPrompt.match(/Your job is to monitor[^\n]*\n\n(?:SPATIAL AWARENESS:[\s\S]*?\n\n)?/);
|
||||
const observerRole = observerRoleMatch ? observerRoleMatch[0].replace(/\n\n$/, '') : '';
|
||||
|
||||
// Extract recording_focus (WHAT TO RECORD section)
|
||||
const recordingFocusMatch = initPrompt.match(/WHAT TO RECORD\n-{14}\n([\s\S]*?)(?=\n\nWHEN TO SKIP)/);
|
||||
const recordingFocus = recordingFocusMatch ? `WHAT TO RECORD\n--------------\n${recordingFocusMatch[1]}` : '';
|
||||
|
||||
// Extract skip_guidance (WHEN TO SKIP section)
|
||||
const skipGuidanceMatch = initPrompt.match(/WHEN TO SKIP\n-{12}\n([\s\S]*?)(?=\n\nOUTPUT FORMAT)/);
|
||||
const skipGuidance = skipGuidanceMatch ? `WHEN TO SKIP\n------------\n${skipGuidanceMatch[1]}` : '';
|
||||
|
||||
// Extract type_guidance (from XML comment)
|
||||
const typeGuidanceMatch = initPrompt.match(/<!--\n\s+\*\*type\*\*: MUST be EXACTLY[^\n]*\n([\s\S]*?)-->/);
|
||||
const typeGuidance = typeGuidanceMatch ? typeGuidanceMatch[0].replace(/<!--\n\s+/, '').replace(/\s+-->/, '').trim() : '';
|
||||
|
||||
// Extract field_guidance (facts AND files comments combined)
|
||||
const factsMatch = initPrompt.match(/\*\*facts\*\*: Concise[^\n]*\n([\s\S]*?)(?=\n -->)/);
|
||||
const filesMatch = initPrompt.match(/\*\*files\*\*:[^\n]*\n/);
|
||||
|
||||
const factsText = factsMatch ? `**facts**: Concise, self-contained statements\n${factsMatch[1].trim()}` : '';
|
||||
const filesText = filesMatch ? filesMatch[0].trim() : '**files**: All files touched (full paths from project root)';
|
||||
|
||||
const fieldGuidance = `${factsText}\n\n${filesText}`;
|
||||
|
||||
// Extract concept_guidance (concepts comment)
|
||||
const conceptGuidanceMatch = initPrompt.match(/<!--\n\s+\*\*concepts\*\*: 2-5 knowledge[^\n]*\n([\s\S]*?)-->/);
|
||||
const conceptGuidance = conceptGuidanceMatch ? conceptGuidanceMatch[0].replace(/<!--\n\s+/, '').replace(/\s+-->/, '').trim() : '';
|
||||
|
||||
// Build the JSON content
|
||||
const jsonData = {
|
||||
name: "Code Development",
|
||||
description: "Software development and engineering work",
|
||||
version: "1.0.0",
|
||||
observation_types: [
|
||||
{ id: "bugfix", label: "Bug Fix", description: "Something was broken, now fixed", emoji: "🔴", work_emoji: "🛠️" },
|
||||
{ id: "feature", label: "Feature", description: "New capability or functionality added", emoji: "🟣", work_emoji: "🛠️" },
|
||||
{ id: "refactor", label: "Refactor", description: "Code restructured, behavior unchanged", emoji: "🔄", work_emoji: "🛠️" },
|
||||
{ id: "change", label: "Change", description: "Generic modification (docs, config, misc)", emoji: "✅", work_emoji: "🛠️" },
|
||||
{ id: "discovery", label: "Discovery", description: "Learning about existing system", emoji: "🔵", work_emoji: "🔍" },
|
||||
{ id: "decision", label: "Decision", description: "Architectural/design choice with rationale", emoji: "⚖️", work_emoji: "⚖️" }
|
||||
],
|
||||
observation_concepts: [
|
||||
{ id: "how-it-works", label: "How It Works", description: "Understanding mechanisms" },
|
||||
{ id: "why-it-exists", label: "Why It Exists", description: "Purpose or rationale" },
|
||||
{ id: "what-changed", label: "What Changed", description: "Modifications made" },
|
||||
{ id: "problem-solution", label: "Problem-Solution", description: "Issues and their fixes" },
|
||||
{ id: "gotcha", label: "Gotcha", description: "Traps or edge cases" },
|
||||
{ id: "pattern", label: "Pattern", description: "Reusable approach" },
|
||||
{ id: "trade-off", label: "Trade-Off", description: "Pros/cons of a decision" }
|
||||
],
|
||||
prompts: {
|
||||
observer_role: observerRole,
|
||||
recording_focus: recordingFocus,
|
||||
skip_guidance: skipGuidance,
|
||||
type_guidance: typeGuidance,
|
||||
concept_guidance: conceptGuidance,
|
||||
field_guidance: fieldGuidance,
|
||||
format_examples: ""
|
||||
}
|
||||
};
|
||||
|
||||
// OLD YAML BUILD:
|
||||
const yamlContent_OLD = `name: "Code Development"
|
||||
description: "Software development and engineering work"
|
||||
version: "1.0.0"
|
||||
|
||||
observation_types:
|
||||
- id: "bugfix"
|
||||
label: "Bug Fix"
|
||||
description: "Something was broken, now fixed"
|
||||
emoji: "🔴"
|
||||
work_emoji: "🛠️"
|
||||
- id: "feature"
|
||||
label: "Feature"
|
||||
description: "New capability or functionality added"
|
||||
emoji: "🟣"
|
||||
work_emoji: "🛠️"
|
||||
- id: "refactor"
|
||||
label: "Refactor"
|
||||
description: "Code restructured, behavior unchanged"
|
||||
emoji: "🔄"
|
||||
work_emoji: "🛠️"
|
||||
- id: "change"
|
||||
label: "Change"
|
||||
description: "Generic modification (docs, config, misc)"
|
||||
emoji: "✅"
|
||||
work_emoji: "🛠️"
|
||||
- id: "discovery"
|
||||
label: "Discovery"
|
||||
description: "Learning about existing system"
|
||||
emoji: "🔵"
|
||||
work_emoji: "🔍"
|
||||
- id: "decision"
|
||||
label: "Decision"
|
||||
description: "Architectural/design choice with rationale"
|
||||
emoji: "⚖️"
|
||||
work_emoji: "⚖️"
|
||||
|
||||
observation_concepts:
|
||||
- id: "how-it-works"
|
||||
label: "How It Works"
|
||||
description: "Understanding mechanisms"
|
||||
- id: "why-it-exists"
|
||||
label: "Why It Exists"
|
||||
description: "Purpose or rationale"
|
||||
- id: "what-changed"
|
||||
label: "What Changed"
|
||||
description: "Modifications made"
|
||||
- id: "problem-solution"
|
||||
label: "Problem-Solution"
|
||||
description: "Issues and their fixes"
|
||||
- id: "gotcha"
|
||||
label: "Gotcha"
|
||||
description: "Traps or edge cases"
|
||||
- id: "pattern"
|
||||
label: "Pattern"
|
||||
description: "Reusable approach"
|
||||
- id: "trade-off"
|
||||
label: "Trade-Off"
|
||||
description: "Pros/cons of a decision"
|
||||
|
||||
prompts:
|
||||
observer_role: |
|
||||
${observerRole}
|
||||
|
||||
recording_focus: |
|
||||
${recordingFocus}
|
||||
|
||||
skip_guidance: |
|
||||
${skipGuidance}
|
||||
|
||||
type_guidance: |
|
||||
${typeGuidance}
|
||||
|
||||
concept_guidance: |
|
||||
${conceptGuidance}
|
||||
|
||||
field_guidance: |
|
||||
${fieldGuidance}
|
||||
|
||||
format_examples: ""
|
||||
`;
|
||||
|
||||
// Write to modes/code.json
|
||||
const outputPath = path.join(__dirname, '../modes/code.json');
|
||||
fs.writeFileSync(outputPath, JSON.stringify(jsonData, null, 2), 'utf-8');
|
||||
|
||||
console.log('✅ Generated modes/code.json from prompts.ts');
|
||||
console.log('\nExtracted sections:');
|
||||
console.log('- observer_role:', observerRole.substring(0, 50) + '...');
|
||||
console.log('- recording_focus:', recordingFocus.substring(0, 50) + '...');
|
||||
console.log('- skip_guidance:', skipGuidance.substring(0, 50) + '...');
|
||||
console.log('- type_guidance:', typeGuidance.substring(0, 50) + '...');
|
||||
console.log('- concept_guidance:', conceptGuidance.substring(0, 50) + '...');
|
||||
console.log('- field_guidance:', fieldGuidance.substring(0, 50) + '...');
|
||||
@@ -12,7 +12,6 @@ interface CliArgs {
|
||||
maxBudget?: number;
|
||||
verbose: boolean;
|
||||
force: boolean;
|
||||
parallel: number;
|
||||
help: boolean;
|
||||
listLanguages: boolean;
|
||||
}
|
||||
@@ -42,12 +41,11 @@ OPTIONS:
|
||||
--max-budget <usd> Maximum budget in USD
|
||||
-v, --verbose Show detailed progress
|
||||
-f, --force Force re-translation ignoring cache
|
||||
--parallel <n> Run n translations concurrently (default: 1)
|
||||
-h, --help Show this help message
|
||||
--list-languages List all supported language codes
|
||||
|
||||
EXAMPLES:
|
||||
# Translate to Spanish and French
|
||||
# Translate to Spanish and French (runs in parallel automatically)
|
||||
translate-readme README.md es fr
|
||||
|
||||
# Translate to multiple languages with custom output
|
||||
@@ -56,6 +54,10 @@ EXAMPLES:
|
||||
# Use in npm scripts
|
||||
# package.json: "translate": "translate-readme README.md es fr de"
|
||||
|
||||
PERFORMANCE:
|
||||
All translations run in parallel automatically (up to 10 concurrent).
|
||||
Cache prevents re-translating unchanged files.
|
||||
|
||||
SUPPORTED LANGUAGES:
|
||||
Run with --list-languages to see all supported language codes
|
||||
`);
|
||||
@@ -123,7 +125,6 @@ function parseArgs(argv: string[]): CliArgs {
|
||||
preserveCode: true,
|
||||
verbose: false,
|
||||
force: false,
|
||||
parallel: 1,
|
||||
help: false,
|
||||
listLanguages: false,
|
||||
};
|
||||
@@ -168,13 +169,6 @@ function parseArgs(argv: string[]): CliArgs {
|
||||
case "--max-budget":
|
||||
args.maxBudget = parseFloat(argv[++i]);
|
||||
break;
|
||||
case "--parallel":
|
||||
args.parallel = parseInt(argv[++i], 10);
|
||||
if (isNaN(args.parallel) || args.parallel < 1) {
|
||||
console.error("Error: --parallel must be a positive integer");
|
||||
process.exit(1);
|
||||
}
|
||||
break;
|
||||
default:
|
||||
if (arg.startsWith("-")) {
|
||||
console.error(`Unknown option: ${arg}`);
|
||||
@@ -239,7 +233,6 @@ async function main(): Promise<void> {
|
||||
maxBudgetUsd: args.maxBudget,
|
||||
verbose: args.verbose,
|
||||
force: args.force,
|
||||
parallel: args.parallel,
|
||||
});
|
||||
|
||||
// Exit with error code if any translations failed
|
||||
|
||||
@@ -49,8 +49,6 @@ export interface TranslationOptions {
|
||||
verbose?: boolean;
|
||||
/** Force re-translation even if cached */
|
||||
force?: boolean;
|
||||
/** Number of concurrent translations (default: 1) */
|
||||
parallel?: number;
|
||||
}
|
||||
|
||||
export interface TranslationResult {
|
||||
@@ -258,9 +256,11 @@ export async function translateReadme(
|
||||
maxBudgetUsd,
|
||||
verbose = false,
|
||||
force = false,
|
||||
parallel = 1,
|
||||
} = options;
|
||||
|
||||
// Run all translations in parallel (up to 10 concurrent)
|
||||
const parallel = Math.min(languages.length, 10);
|
||||
|
||||
// Read source file
|
||||
const sourcePath = path.resolve(source);
|
||||
const content = await fs.readFile(sourcePath, "utf-8");
|
||||
@@ -282,9 +282,7 @@ export async function translateReadme(
|
||||
console.log(`📖 Source: ${sourcePath}`);
|
||||
console.log(`📂 Output: ${outDir}`);
|
||||
console.log(`🌍 Languages: ${languages.join(", ")}`);
|
||||
if (parallel > 1) {
|
||||
console.log(`⚡ Parallel: ${parallel} concurrent translations`);
|
||||
}
|
||||
console.log(`⚡ Running ${parallel} translations in parallel`);
|
||||
console.log("");
|
||||
}
|
||||
|
||||
@@ -334,7 +332,7 @@ export async function translateReadme(
|
||||
// Run with concurrency limit
|
||||
async function runWithConcurrency<T>(items: T[], limit: number, fn: (item: T) => Promise<TranslationResult>): Promise<TranslationResult[]> {
|
||||
const results: TranslationResult[] = [];
|
||||
const executing: Promise<void>[] = [];
|
||||
const executing = new Set<Promise<void>>();
|
||||
|
||||
for (const item of items) {
|
||||
// Check budget before starting new translation
|
||||
@@ -355,15 +353,20 @@ export async function translateReadme(
|
||||
}
|
||||
});
|
||||
|
||||
executing.push(p.then(() => {
|
||||
executing.splice(executing.indexOf(p.then(() => {})), 1);
|
||||
}));
|
||||
// Create a wrapped promise that removes itself when done
|
||||
const wrapped = p.finally(() => {
|
||||
executing.delete(wrapped);
|
||||
});
|
||||
|
||||
if (executing.length >= limit) {
|
||||
executing.add(wrapped);
|
||||
|
||||
// Wait for a slot to open up if we're at the limit
|
||||
if (executing.size >= limit) {
|
||||
await Promise.race(executing);
|
||||
}
|
||||
}
|
||||
|
||||
// Wait for all remaining translations to complete
|
||||
await Promise.all(executing);
|
||||
return results;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user