umlforge 0.2.0__tar.gz → 0.2.2__tar.gz

{umlforge-0.2.0 → umlforge-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: umlforge
-Version: 0.2.0
+Version: 0.2.2
 Summary: UML Forge MCP connector — architecture intelligence, security analysis, and living documentation for engineering teams
 Project-URL: Homepage, https://umlforge.dev
 Project-URL: Documentation, https://umlforge.dev/docs
@@ -29,7 +29,7 @@ Description-Content-Type: text/markdown
 **Architecture intelligence, security analysis, and living documentation — inside your coding agent.**
 
 [UML Forge](https://umlforge.dev) gives Claude Code, Cursor, Windsurf, and any
-MCP-compatible coding agent a suite of 13 specialised tools for producing
+MCP-compatible coding agent a suite of 14 specialised tools for producing
 professional UML diagrams from your codebase, schema, or architecture
 descriptions.
 
@@ -69,6 +69,7 @@ Get your API key at [umlforge.dev](https://umlforge.dev).
 | `umlforge_stakeholder_arch` | C4 context diagrams for investors, CTOs, and non-technical stakeholders |
 | `umlforge_living_docs` | Update existing diagrams to reflect sprint or PR changes |
 | `umlforge_onboarding` | Day-one knowledge-transfer package for new team members |
+| `umlforge_legacy_migration` | Legacy structure + modern architecture diagrams and 6-phase migration roadmap from COBOL, Fortran, ABAP, RPG, and other legacy languages |
 
 All tools accept `report_mode=True` to generate a written analysis report
 alongside the diagram.

{umlforge-0.2.0 → umlforge-0.2.2}/api/prompts/__init__.py

@@ -36,7 +36,7 @@ TOOL_REGISTRY: dict[str, BasePrompt] = {
     "umlforge_onboarding": OnboardingPrompt(),
     "umlforge_ai_agent": AiAgentPrompt(),
     "umlforge_deployment": DeploymentPrompt(),
-    "umlforge_legacy_migrate": LegacyMigratePrompt(),
+    "umlforge_legacy_migration": LegacyMigratePrompt(),
 }
 
 

{umlforge-0.2.0 → umlforge-0.2.2}/api/prompts/base.py

@@ -1,7 +1,7 @@
 """
 UML Forge — Base Prompt Architecture
 
-BasePrompt is the abstract base class for all 12 prompt modules.
+BasePrompt is the abstract base class for all 13 prompt modules.
 Every module inherits from this, sets tool_name + clarifying_questions,
 and implements build_prompt().
 
@@ -62,7 +62,7 @@ _DIAGRAM_TYPE_MAP: dict[str, str] = {
 
 class BaseToolInput(BaseModel):
     """
-    Base input model for all 13 prompt tools.
+    Base input model for all 14 prompt tools.
     clarifications is populated by the Socratic elicitation engine —
     tool-specific input models must inherit from this class.
     """

{umlforge-0.2.0 → umlforge-0.2.2}/api/prompts/p13_legacy_migrate.py

@@ -104,7 +104,7 @@ class LegacyMigrateInput(BaseToolInput):
 
 class LegacyMigratePrompt(BasePrompt):
 
-    tool_name = "umlforge_legacy_migrate"
+    tool_name = "umlforge_legacy_migration"
     input_class = LegacyMigrateInput
 
     clarifying_questions = [

{umlforge-0.2.0 → umlforge-0.2.2}/api/prompts/suggest.py

@@ -1,7 +1,7 @@
 """
 UML Forge — Tool Suggestion Prompt
 
-Suggests which of the 12 prompt tools best matches a plain-English
+Suggests which of the 13 prompt tools best matches a plain-English
 task description. Implemented as a standalone function rather than
 a BasePrompt subclass because it does not produce a diagram.
 Registered at POST /v1/suggest (wired in Phase 7).
@@ -68,6 +68,10 @@ umlforge_ai_agent(pipeline_purpose="", agents="", tools_available="", orchestrat
 umlforge_deployment(system_name="", cloud_provider="", environments="", services="", cicd_tool="", report_mode=False)
   → Infrastructure topology and CI/CD pipeline diagram.
   → NOT FOR: application-level architecture, security threat modelling.
+
+umlforge_legacy_migration(legacy_code="", github_url=None, source_language="COBOL", target_language="Python", system_purpose="", report_mode=False)
+  → Visualise a legacy codebase (COBOL, Fortran, ABAP, RPG, PL/I, Pascal, BASIC, Assembly, Ada, ALGOL) and produce a 6-phase migration roadmap to Python, Go, Rust, Java, TypeScript, C#, or Kotlin.
+  → NOT FOR: analysing modern codebases, generating translated source code, database schema design.
 """.strip()
 
 _VALID_TOOLS = frozenset(t.split("(")[0] for t in _TOOL_CATALOGUE.splitlines() if t.startswith("umlforge_"))

{umlforge-0.2.0 → umlforge-0.2.2}/connector/README.md

@@ -5,7 +5,7 @@
 **Architecture intelligence, security analysis, and living documentation — inside your coding agent.**
 
 [UML Forge](https://umlforge.dev) gives Claude Code, Cursor, Windsurf, and any
-MCP-compatible coding agent a suite of 13 specialised tools for producing
+MCP-compatible coding agent a suite of 14 specialised tools for producing
 professional UML diagrams from your codebase, schema, or architecture
 descriptions.
 
@@ -45,6 +45,7 @@ Get your API key at [umlforge.dev](https://umlforge.dev).
 | `umlforge_stakeholder_arch` | C4 context diagrams for investors, CTOs, and non-technical stakeholders |
 | `umlforge_living_docs` | Update existing diagrams to reflect sprint or PR changes |
 | `umlforge_onboarding` | Day-one knowledge-transfer package for new team members |
+| `umlforge_legacy_migration` | Legacy structure + modern architecture diagrams and 6-phase migration roadmap from COBOL, Fortran, ABAP, RPG, and other legacy languages |
 
 All tools accept `report_mode=True` to generate a written analysis report
 alongside the diagram.

{umlforge-0.2.0 → umlforge-0.2.2}/connector/tools.py

@@ -1,7 +1,7 @@
 """
 UML Forge Connector — MCP Tool Definitions
 
-Registers all 13 UML Forge tools with the FastMCP server.
+Registers all 14 UML Forge tools with the FastMCP server.
 
 CRITICAL CONSTRAINTS (enforced by architecture):
   - ZERO business logic in this file
@@ -131,7 +131,7 @@ _GUIDED_QUESTIONS: dict[str, list[str]] = {
         "Are there any manual steps in the current deployment "
         "process that are not yet automated and should be flagged?",
     ],
-    "umlforge_legacy_migrate": [
+    "umlforge_legacy_migration": [
         "What does this program currently do in production — is it a batch job, "
         "an online transaction processor, or a reporting/extract system?",
         "Are there hard interface contracts that must be preserved exactly — "
@@ -187,6 +187,7 @@ async def umlforge_reverse_engineer(
     codebase: str = "",
     github_url: str | None = None,
     max_nodes: int = 20,
+    github_token: str | None = None,
     report_mode: bool = False,
     ctx: Context | None = None,
 ) -> str:
@@ -222,7 +223,9 @@ async def umlforge_reverse_engineer(
                       github.com/owner/repo/blob/branch/path/to/file.py
         codebase: Paste code directly when you have files in context
                   or the repo is private.
-        max_nodes: Max classes/components per diagram (default 20).
+        max_nodes: Max classes/components per diagram (default 20, range 5–50).
+        github_token: GitHub personal access token (repo scope) — only needed
+                      for private repositories. Never stored or logged.
         report_mode: True → also produce an Architectural Intelligence Report.
                      Pro/Team/Enterprise only.
     """
@@ -231,6 +234,7 @@ async def umlforge_reverse_engineer(
         "codebase": codebase,
         "github_url": github_url,
         "max_nodes": max_nodes,
+        "github_token": github_token,
         "report_mode": report_mode,
     }
     if config.guided_mode and ctx is not None:
@@ -637,8 +641,10 @@ async def umlforge_frontend_components(
     Args:
         feature_description: The UI feature or page to diagram.
         framework: Frontend framework (default: React).
+                   Supported: React, Vue, Angular, Svelte, Next.js.
         state_management: State approach — Redux, Zustand, Context API, Pinia (optional).
-        interactions: Key user interactions (optional — improves sequence diagram).
+        interactions: Key user interactions and data flows
+                      (e.g. "user submits form, table sorts on header click") (optional).
         report_mode: True → also produce Component Analysis Notes.
                      Pro/Team/Enterprise only.
     """
@@ -917,15 +923,16 @@ async def umlforge_deployment(
     )
 
 
-# ── 13. Legacy Migrate ───────────────────────────────────────────────────────
+# ── 13. Legacy Migration ─────────────────────────────────────────────────────
 
 @mcp.tool(annotations=_READ_ONLY)
-async def umlforge_legacy_migrate(
+async def umlforge_legacy_migration(
     legacy_code: str = "",
     github_url: str | None = None,
     source_language: str = "COBOL",
     target_language: str = "Python",
     system_purpose: str = "",
+    github_token: str | None = None,
     report_mode: bool = False,
     ctx: Context | None = None,
 ) -> str:
@@ -972,6 +979,8 @@ async def umlforge_legacy_migrate(
         system_purpose: Brief description of what the program does in production
                         (e.g. "monthly payroll batch", "order entry OLTP"). Optional
                         but improves diagram labels and migration advice.
+        github_token: GitHub personal access token (repo scope) — only needed
+                      for private repositories. Never stored or logged.
         report_mode: True → also produce a Legacy Migration Assessment with
                      complexity scores and tooling recommendations.
                      Pro/Team/Enterprise only.
@@ -983,16 +992,17 @@ async def umlforge_legacy_migrate(
         "source_language": source_language,
         "target_language": target_language,
         "system_purpose": system_purpose,
+        "github_token": github_token,
         "report_mode": report_mode,
     }
     if config.guided_mode and ctx is not None:
         clarifications = await _elicit_clarifications(
-            ctx, _GUIDED_QUESTIONS["umlforge_legacy_migrate"]
+            ctx, _GUIDED_QUESTIONS["umlforge_legacy_migration"]
         )
         if clarifications:
             params["clarifications"] = clarifications
     return await api_client.generate(
-        "umlforge_legacy_migrate", params, guided_mode=config.guided_mode
+        "umlforge_legacy_migration", params, guided_mode=config.guided_mode
     )
 
 
@@ -1009,7 +1019,7 @@ async def umlforge_suggest(task_description: str) -> str:
     3. Explain why this tool fits and suggest an alternative
 
     USE THIS WHEN:
-    - You are not sure which of the 13 tools to use
+    - You are not sure which of the 14 tools to use
     - You want to describe a goal ("analyse this repo", "model our order lifecycle")
       and get a ready-to-run recommendation
     - You want to avoid trial and error with the wrong tool

{umlforge-0.2.0 → umlforge-0.2.2}/dashboard/app/docs/page.tsx

@@ -34,7 +34,7 @@ const TOOLS = [
   { name: "umlforge_onboarding", label: "Team Onboarding", desc: "System overview and developer workflow package for new team members." },
   { name: "umlforge_deployment", label: "Deployment Architecture", desc: "Infrastructure topology and CI/CD pipeline diagrams." },
   { name: "umlforge_living_docs", label: "Living Docs", desc: "Update existing diagrams to reflect sprint or PR changes." },
-  { name: "umlforge_legacy_migrate", label: "Legacy Migrate", desc: "Visualise COBOL, Fortran, or other legacy code and produce a modern equivalent architecture diagram and migration roadmap." },
+  { name: "umlforge_legacy_migration", label: "Legacy Migration", desc: "Visualise COBOL, Fortran, or other legacy code and produce a modern equivalent architecture diagram and migration roadmap." },
   { name: "umlforge_suggest", label: "Suggest a Tool", desc: "Describe your task and get a recommendation for the right diagram tool." },
 ];
 

{umlforge-0.2.0 → umlforge-0.2.2}/dashboard/app/manuals/page.tsx

@@ -218,7 +218,7 @@ const TOOLS = [
     ],
   },
   {
-    name: "umlforge_legacy_migrate",
+    name: "umlforge_legacy_migration",
     label: "Legacy Migrate",
     icon: "🏺",
     when: "You have COBOL, Fortran, ABAP, RPG, PL/I, Pascal, BASIC, Assembly, Ada, or ALGOL code and want to understand its structure and plan a migration to a modern language.",

{umlforge-0.2.0 → umlforge-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "umlforge"
-version = "0.2.0"
+version = "0.2.2"
 description = "UML Forge MCP connector — architecture intelligence, security analysis, and living documentation for engineering teams"
 readme = "connector/README.md"
 requires-python = ">=3.11"

{umlforge-0.2.0 → umlforge-0.2.2}/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/dave1362/umlforge-connector",
     "source": "github"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "umlforge",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },

{umlforge-0.2.0 → umlforge-0.2.2}/tests/test_phase7_all_prompts.py

@@ -91,7 +91,7 @@ _VALID_INPUTS = {
         "environments": "development, staging, production",
         "services": "FastAPI API, Next.js dashboard, Neon PostgreSQL, Redis cache",
     },
-    "umlforge_legacy_migrate": {
+    "umlforge_legacy_migration": {
         "legacy_code": "IDENTIFICATION DIVISION.\nPROGRAM-ID. PAYROLL.\nDATA DIVISION.\nWORKING-STORAGE SECTION.\n01 WS-HOURS PIC 9(3).\nPROCEDURE DIVISION.\n    MOVE 40 TO WS-HOURS\n    STOP RUN.",
         "source_language": "COBOL",
         "target_language": "Python",