specforge-mcp 0.2.2 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specforge-mcp",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "SpecForge — MCP Server for Spec Driven Development. Manages specs, estimations, reverse engineering, and auto-learning across any language/framework.",
   "type": "module",
   "main": "dist/index.js",
@@ -9,7 +9,8 @@
   },
   "files": [
     "dist/",
-    "src/config/"
+    "src/config/",
+    "src/i18n/messages/"
   ],
   "engines": {
     "node": ">=22.0.0"

package/src/i18n/messages/en.json

@@ -0,0 +1,333 @@
+{
+  "spec": {
+    "created": "Spec {id} created successfully",
+    "updated": "Spec {id} status updated to {status}",
+    "notFound": "Spec {id} not found",
+    "invalidTransition": "Invalid transition from {from} to {to}. Valid: draft → review → approved → implementing → done",
+    "actualsRequired": "Actuals (real metrics) are required when marking spec as done",
+    "duplicateTitle": "A spec with title '{title}' already exists. Using slug: {slug}"
+  },
+  "project": {
+    "initialized": "Project initialized: {language} / {framework} detected",
+    "notFound": "Project not found. Run init_project first",
+    "alreadyExists": "Project already initialized. Updating knowledge...",
+    "emptyProject": "Empty project detected. Use create_spec to define your first feature and SpecForge will guide you through setup.",
+    "unknownLanguage": "Could not detect language. Set manually via learn_pattern"
+  },
+  "locale": {
+    "changed": "Locale changed to {locale}",
+    "unsupported": "Unsupported locale '{locale}'. Available: {available}. Add new locales in templates/ and i18n/messages/",
+    "globalChanged": "Default locale changed to {locale}"
+  },
+  "estimate": {
+    "noHistory": "No historical data. Using base heuristics (confidence: low)",
+    "withHistory": "Based on {count} similar specs (confidence: {confidence})"
+  },
+  "reverseEngineer": {
+    "analyzing": "Analyzing {count} files...",
+    "completed": "Spec draft generated from {count} files. Marked as draft — review required",
+    "pathNotFound": "Path not found: {path}",
+    "tooLarge": "Directory has {count} files. Use depth: 'deep' for full analysis"
+  },
+  "validate": {
+    "score": "Implementation coverage: {score}%",
+    "allGood": "All spec files accounted for",
+    "missing": "{count} files from spec not found in implementation"
+  },
+  "docs": {
+    "found": "Documentation found for {framework}: {topic}",
+    "notFound": "No documentation found for '{topic}' in {framework}",
+    "registryMissing": "Framework '{framework}' not in docs registry. Add it to config/docs-registry.json"
+  },
+  "mcps": {
+    "discovered": "Found {count} MCP servers",
+    "configNotFound": "Config file not found at {path}",
+    "noneFound": "No MCP servers configured"
+  },
+  "sections": {
+    "metadata": "Metadata",
+    "estimation": "Estimation",
+    "postImplementation": "Post-implementation (fill on completion)",
+    "interfaces": "Interfaces / Types",
+    "models": "Models / Types",
+    "structs": "Structs / Interfaces",
+    "schemaDb": "Database Schema",
+    "behavior": "Behavior",
+    "happyPath": "Happy Path",
+    "edgeCases": "Edge Cases",
+    "dataFlow": "Data Flow",
+    "files": "Files",
+    "toCreate": "To create",
+    "toModify": "To modify",
+    "verification": "Verification Criteria",
+    "technicalNotes": "Technical Notes",
+    "availableMcps": "Available MCPs (auto-detected)"
+  },
+  "tools": {
+    "set_locale": {
+      "description": "Change the active locale for messages and spec templates",
+      "success": "Locale set to {locale}",
+      "notImplemented": "set_locale is not yet implemented"
+    },
+    "init_project": {
+      "description": "Initialize a project — detects language, framework, architecture, and stores project knowledge",
+      "success": "Project initialized at {projectPath}",
+      "notImplemented": "init_project is not yet implemented"
+    },
+    "init_constitution": {
+      "description": "Generate the project constitution — immutable architectural principles and quality rules",
+      "success": "Constitution initialized for project {projectId} with {count} principles",
+      "notImplemented": "init_constitution is not yet implemented"
+    },
+    "clarify_requirements": {
+      "description": "Generate targeted clarification questions before creating a spec",
+      "success": "Generated {count} clarification questions for topic: {topic}",
+      "notImplemented": "clarify_requirements is not yet implemented"
+    },
+    "create_spec": {
+      "description": "Create a full SDD spec (HU.md + FICHA-TECNICA.md) from a description",
+      "success": "Spec {id} created: {title}",
+      "notImplemented": "create_spec is not yet implemented"
+    },
+    "list_specs": {
+      "description": "List all specs for a project, optionally filtering by status",
+      "success": "Found {count} specs",
+      "notImplemented": "list_specs is not yet implemented"
+    },
+    "update_status": {
+      "description": "Transition a spec through its lifecycle (draft → review → approved → implementing → done)",
+      "success": "Spec {specId} status updated to {status}",
+      "notImplemented": "update_status is not yet implemented"
+    },
+    "estimate": {
+      "description": "Estimate effort, cost, and token usage for a spec using multi-agent analysis",
+      "success": "Estimation complete for spec {specId} — {devHours}h dev, ${totalCostUsd} total",
+      "notImplemented": "estimate is not yet implemented"
+    },
+    "reverse_engineer": {
+      "description": "Analyze existing code and generate an SDD spec from it",
+      "success": "Reverse-engineered spec from {path}",
+      "notImplemented": "reverse_engineer is not yet implemented"
+    },
+    "validate": {
+      "description": "Validate implementation against its spec — coverage, drift, and quality",
+      "success": "Validation complete: {score}% coverage",
+      "notImplemented": "validate is not yet implemented"
+    },
+    "detect_drift": {
+      "description": "Detect drift between spec and implementation",
+      "success": "Drift analysis complete: {driftScore}% drift detected",
+      "notImplemented": "detect_drift is not yet implemented"
+    },
+    "summarize_spec": {
+      "description": "Generate a concise summary of a spec",
+      "success": "Summary generated for spec {specId}",
+      "notImplemented": "summarize_spec is not yet implemented"
+    },
+    "generate_checklist": {
+      "description": "Generate a quality checklist for a spec",
+      "success": "Checklist generated: {totalCount} items",
+      "notImplemented": "generate_checklist is not yet implemented"
+    },
+    "reconcile_spec": {
+      "description": "Reconcile spec with implementation changes",
+      "success": "Spec {specId} reconciled with {count} changes",
+      "notImplemented": "reconcile_spec is not yet implemented"
+    },
+    "learn_pattern": {
+      "description": "Teach the system a new pattern (architecture, convention, estimation, stack, quality)",
+      "success": "Pattern learned: {type} — {pattern}",
+      "notImplemented": "learn_pattern is not yet implemented"
+    },
+    "capture_learning": {
+      "description": "Capture a discovered pattern or lesson into the spec system with semantic deduplication",
+      "success": "Pattern captured and routed to {specId}",
+      "duplicate": "Pattern already covered in {specId} ({similarity}% similarity)",
+      "lesson": "Lesson captured: {type}"
+    },
+    "audit": {
+      "description": "Audit code for SOLID, clean code, architecture, security, and quality issues",
+      "success": "Audit complete: {score}/100 — {findingsCount} findings",
+      "notImplemented": "audit is not yet implemented"
+    },
+    "consult_docs": {
+      "description": "Consult framework documentation for a specific topic",
+      "success": "Found docs for {framework}: {topic}",
+      "notImplemented": "consult_docs is not yet implemented"
+    },
+    "discover_mcps": {
+      "description": "Discover MCP servers configured in the environment",
+      "success": "Discovered {count} MCP servers",
+      "notImplemented": "discover_mcps is not yet implemented"
+    },
+    "suggest_mcps": {
+      "description": "Suggest MCP servers that could benefit the project",
+      "success": "Found {count} recommended MCP servers",
+      "notImplemented": "suggest_mcps is not yet implemented"
+    },
+    "generate_adr": {
+      "description": "Generate Architecture Decision Records for a spec",
+      "success": "ADR generated with {count} decisions",
+      "notImplemented": "generate_adr is not yet implemented"
+    },
+    "design_schema": {
+      "description": "Design database schema from spec requirements",
+      "success": "Schema designed: {tableCount} tables, {indexCount} indexes",
+      "notImplemented": "design_schema is not yet implemented"
+    },
+    "define_ui_contract": {
+      "description": "Define UI component contracts, data flow, and state management",
+      "success": "UI contract defined: {componentCount} components",
+      "notImplemented": "define_ui_contract is not yet implemented"
+    },
+    "challenge_spec": {
+      "description": "Stress-test a spec for failures, concurrency, scale, and edge cases",
+      "success": "Challenge complete: {scenarioCount} failure scenarios analyzed",
+      "notImplemented": "challenge_spec is not yet implemented"
+    },
+    "generate_execution_plan": {
+      "description": "Generate a step-by-step execution plan for implementing a spec",
+      "success": "Execution plan generated: {phaseCount} phases, {stepCount} steps",
+      "notImplemented": "generate_execution_plan is not yet implemented"
+    },
+    "suggest_stack": {
+      "description": "Suggest a technology stack based on project requirements",
+      "success": "Stack recommended: {language}/{framework}",
+      "notImplemented": "suggest_stack is not yet implemented"
+    },
+    "check_versions": {
+      "description": "Check dependency versions for updates, deprecations, and security issues",
+      "success": "Checked {count} dependencies: {updatesAvailable} updates, {securityAlerts} security alerts",
+      "notImplemented": "check_versions is not yet implemented"
+    },
+    "generate_skill": {
+      "description": "Generate an agent skill file for a specific platform",
+      "success": "Skill '{name}' generated for {platform}",
+      "notImplemented": "generate_skill is not yet implemented"
+    },
+    "detect_agent": {
+      "description": "Detect the AI coding agent platform in use",
+      "success": "Detected agent: {platform} (confidence: {confidence}%)",
+      "notImplemented": "detect_agent is not yet implemented"
+    },
+    "generate_sub_agent": {
+      "description": "Generate a sub-agent definition for multi-agent orchestration",
+      "success": "Sub-agent '{agentName}' generated for {framework}",
+      "notImplemented": "generate_sub_agent is not yet implemented"
+    },
+    "generate_rules": {
+      "description": "Generate agent rules files (.cursorrules, CLAUDE.md, etc.)",
+      "success": "Rules generated for {platform}: {rulesCount} rules",
+      "notImplemented": "generate_rules is not yet implemented"
+    },
+    "generate_orchestration_script": {
+      "description": "Generate a 3-layer parallel automation script (worktrees + claude -p)",
+      "success": "Orchestration script generated for {specCount} specs",
+      "notImplemented": "generate_orchestration_script is not yet implemented"
+    },
+    "suggest_tooling": {
+      "description": "Assess and suggest dev lifecycle tooling (CI/CD, testing, monitoring, etc.)",
+      "success": "Tooling assessment complete: {maturityScore}/100",
+      "notImplemented": "suggest_tooling is not yet implemented"
+    },
+    "generate_tests": {
+      "description": "Generate test plan and test files from a spec",
+      "success": "Test plan generated: {unitCount} unit, {integrationCount} integration, {e2eCount} e2e tests",
+      "notImplemented": "generate_tests is not yet implemented"
+    },
+    "generate_docs": {
+      "description": "Generate documentation from specs and code",
+      "success": "Generated {count} documents",
+      "notImplemented": "generate_docs is not yet implemented"
+    },
+    "manage_context": {
+      "description": "Save, load, and manage persistent context notes across sessions",
+      "success": "Context {action}: {key}",
+      "notImplemented": "manage_context is not yet implemented"
+    },
+    "manage_git": {
+      "description": "Git integration — branches, PRs, changelogs, hooks linked to specs",
+      "success": "Git {action} completed",
+      "notImplemented": "manage_git is not yet implemented"
+    },
+    "orchestrate": {
+      "description": "Multi-agent orchestration — register agents, lock resources, distribute tasks",
+      "success": "Orchestration {action} completed",
+      "notImplemented": "orchestrate is not yet implemented"
+    },
+    "integrate_pm": {
+      "description": "Integrate with project management tools (Jira, Linear, GitHub Issues, etc.)",
+      "success": "PM integration: {action} on {platform}",
+      "notImplemented": "integrate_pm is not yet implemented"
+    },
+    "security_check": {
+      "description": "Analyze a spec against OWASP Top 10, scan code for insecure patterns, generate security score (A-F) and drift detection",
+      "success": "Security check complete: {specId} — grade {grade}",
+      "notImplemented": "security_check is not yet implemented"
+    },
+    "data_governance": {
+      "description": "Detect PII in specs, generate retention policies, draft privacy notices, and audit compliance with GDPR/CCPA/LGPD",
+      "detectSuccess": "PII detection complete — {count} field(s) found, hasPII: {hasPII}",
+      "retentionSuccess": "Retention policy generated for model: {model}",
+      "privacyNoticeSuccess": "Privacy notice draft generated — {count} spec(s) with PII",
+      "auditSuccess": "Privacy audit complete — {total} spec(s) reviewed, {nonCompliant} non-compliant"
+    },
+    "migrate_tech": {
+      "description": "Guide tech stack migration (language, framework, DB, services): analyze source codebase, map equivalences, generate migration plan, recommend transition strategy, validate functional parity, and plan DB migration",
+      "analyzeSuccess": "Source stack analysis complete — review implicit contracts and hot components before migrating",
+      "mapSuccess": "Equivalence map generated — review manual mappings and differences before proceeding",
+      "planSuccess": "Migration plan generated with ordered specs and circular dependency resolution",
+      "strategySuccess": "Migration strategy recommended — review and override if needed",
+      "validateSuccess": "Parity validation checklist and contract tests generated",
+      "analyzeDbSuccess": "Database schema analyzed — review schema, ORM, and estimated data volume",
+      "mapDbSuccess": "DB type mapping generated — all data loss warnings must be reviewed before migration",
+      "planDbSuccess": "DB migration plan generated with phased approach and rollback strategy",
+      "analyzeServicesSuccess": "External services analysis complete — review critical services and migration priorities",
+      "mapServicesSuccess": "Service equivalence map generated — review adapters and behavior differences",
+      "planServicesSuccess": "Service migration plan generated — stateless services scheduled first",
+      "validateServiceSuccess": "Service validation checklist generated — fill in expected values from your baseline",
+      "rollbackPlanSuccess": "Rollback plan generated — review irreversible steps and checkpoint conditions",
+      "checkpointSuccess": "Migration checkpoint recorded — use this ID to rollback to this state if needed",
+      "rollbackSuccess": "Rollback execution plan generated — confirm each manual step before proceeding",
+      "featureFlagsSuccess": "Feature flag spec generated — configure your provider and set expiration date",
+      "statusSuccess": "Migration status report generated — update completed components as specs are finished"
+    },
+    "paradigm_report": {
+      "description": "Detect and report the programming paradigms used in a project",
+      "success": "Paradigm report generated: {dominant} detected",
+      "notFound": "Project not found. Run init_project first."
+    },
+    "check_readiness": {
+      "description": "Evaluate if a spec is ready for implementation by checking completeness, criteria quality, and dependency status"
+    },
+    "package_handoff": {
+      "description": "Generate a structured handoff package for an AI agent to implement a spec, including objective, criteria, file list, out-of-scope items, and constraints"
+    }
+  },
+  "resources": {
+    "process": {
+      "description": "SDD methodology process steps and workflow",
+      "notFound": "Process information not available"
+    },
+    "specs": {
+      "description": "Current project specs list",
+      "notFound": "No specs found. Use create_spec or init_project first"
+    },
+    "templates": {
+      "description": "Available spec templates",
+      "notFound": "No templates found"
+    },
+    "patterns": {
+      "description": "Learned project patterns",
+      "notFound": "No patterns learned yet. Use learn_pattern to add patterns"
+    }
+  },
+  "errors": {
+    "notImplemented": "Tool '{tool}' is not yet implemented",
+    "invalidInput": "Invalid input: {details}",
+    "projectRequired": "Project ID is required. Run init_project first",
+    "specRequired": "Spec ID is required",
+    "unknownTool": "Unknown tool: {tool}",
+    "internalError": "Internal error: {message}"
+  }
+}