plm-skill-packages 1.0.0__tar.gz

plm_skill_packages-1.0.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: plm-skill-packages
+Version: 1.0.0
+Summary: TracePulse PLM Skill Packages product-line — 5-agent PLM PDF→BPMN chain, CSV→BPMN process_generator, output_format_controller, build_registry, plm_orchestrator (Wave 6.5 Conv A / PRD §3 #3). Full description in README.
+Author: TracePulse
+License: Proprietary
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: plm-shared
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
+
+# plm-skill-packages
+
+PRD §3 #3 product-line carve — Wave 6.5 Conv A.
+
+Hosts the **5-agent PLM PDF→BPMN chain** + **CSV→BPMN generator** + **BPMN format controller** + **build registry** + **5-agent orchestrator**, plus skill manifests (YAML + filesystem) and the 4-state lifecycle FSM aligned verbatim with PRD §8.11.3.
+
+## Layout
+
+```
+plm_skill_packages/
+├── plm_structural_analyst.py     # PLM PDF→BPMN agent #1
+├── plm_process_scout.py          # PLM PDF→BPMN agent #2
+├── plm_logic_modeler.py          # PLM PDF→BPMN agent #3
+├── plm_bpmn_transpiler.py        # PLM PDF→BPMN agent #4
+├── plm_quality_gate.py           # PLM PDF→BPMN agent #5
+├── process_generator.py          # CSV→BPMN; only legitimate cascade fallback
+├── output_format_controller.py   # BPMN format correction + hidden retries
+├── build_registry.py             # File-handler dispatch
+├── orchestrators/
+│   └── plm_orchestrator.py       # 5-agent chain coordinator
+├── lifecycle.py                  # 4-state FSM (PRD §8.11.3 verbatim)
+├── manifests.py                  # YAML manifest loader
+├── registry.py                   # Skill manifest registry
+├── contracts.py                  # Wire-contract Pydantic v2 frozen models
+└── manifests/                    # YAML skill manifests (one per skill)
+    ├── plm.structural_analyst.yaml
+    ├── plm.process_scout.yaml
+    ├── plm.logic_modeler.yaml
+    ├── plm.bpmn_transpiler.yaml
+    ├── plm.quality_gate.yaml
+    ├── plm.orchestrate_extraction.yaml
+    ├── bpmn.generate_from_csv.yaml
+    └── bpmn.fix_format.yaml
+```
+
+## Lifecycle FSM (Decision #167 — PRD §8.11.3 verbatim)
+
+```
+draft ──► released ──► deprecated ──► retired
+              │              │
+              └──────────────┴──► (terminal)
+```
+
+States are **strictly forward-flowing** (matching PRD §8.11.3 4-state capability lifecycle). No revivals, no skips. The FSM rejects any non-canonical transition.
+
+## Manifest store (Decision #168 — YAML + filesystem)
+
+Manifests live under `plm_skill_packages/manifests/*.yaml` and load at boot via `manifests.load_all()`, matching the `litellm_config/model_list.yaml` catalog-as-truth pattern. No SQL, no admin UI in V1.
+
+## Re-export shims
+
+Every monolith path that today references the lifted modules is preserved as a re-export shim — `from agents.plm_structural_analyst import ...` continues to work. Pattern matches Wave 1 W1.4 `services/run_task_tracker.py` (canonical decommission template).
+
+## Transitional dependency note
+
+The lifted PLM agent + process_generator code keeps its existing `from services.X` / `from models.X` / `from utils.X` / `from agents.base_agent` imports. These resolve at runtime in the backend process via PYTHONPATH; standalone sibling tests configure conftest.py to extend sys.path. **Wave 7 Extraction** physically separates the repos and refactors inbound deps to ports/Protocols.
+
+## Wave 6.5 lineage
+
+- **Wave 6.5 Conv A** (this) — `plm-skill-packages` carve.
+- **Wave 6.5 Conv B** — `plm-knowledge` carve (PRD §3 #6).
+- **Wave 6.5 Conv C** — closure audit + Wave 7 readiness re-author.

plm_skill_packages-1.0.0/README.md

@@ -0,0 +1,62 @@
+# plm-skill-packages
+
+PRD §3 #3 product-line carve — Wave 6.5 Conv A.
+
+Hosts the **5-agent PLM PDF→BPMN chain** + **CSV→BPMN generator** + **BPMN format controller** + **build registry** + **5-agent orchestrator**, plus skill manifests (YAML + filesystem) and the 4-state lifecycle FSM aligned verbatim with PRD §8.11.3.
+
+## Layout
+
+```
+plm_skill_packages/
+├── plm_structural_analyst.py     # PLM PDF→BPMN agent #1
+├── plm_process_scout.py          # PLM PDF→BPMN agent #2
+├── plm_logic_modeler.py          # PLM PDF→BPMN agent #3
+├── plm_bpmn_transpiler.py        # PLM PDF→BPMN agent #4
+├── plm_quality_gate.py           # PLM PDF→BPMN agent #5
+├── process_generator.py          # CSV→BPMN; only legitimate cascade fallback
+├── output_format_controller.py   # BPMN format correction + hidden retries
+├── build_registry.py             # File-handler dispatch
+├── orchestrators/
+│   └── plm_orchestrator.py       # 5-agent chain coordinator
+├── lifecycle.py                  # 4-state FSM (PRD §8.11.3 verbatim)
+├── manifests.py                  # YAML manifest loader
+├── registry.py                   # Skill manifest registry
+├── contracts.py                  # Wire-contract Pydantic v2 frozen models
+└── manifests/                    # YAML skill manifests (one per skill)
+    ├── plm.structural_analyst.yaml
+    ├── plm.process_scout.yaml
+    ├── plm.logic_modeler.yaml
+    ├── plm.bpmn_transpiler.yaml
+    ├── plm.quality_gate.yaml
+    ├── plm.orchestrate_extraction.yaml
+    ├── bpmn.generate_from_csv.yaml
+    └── bpmn.fix_format.yaml
+```
+
+## Lifecycle FSM (Decision #167 — PRD §8.11.3 verbatim)
+
+```
+draft ──► released ──► deprecated ──► retired
+              │              │
+              └──────────────┴──► (terminal)
+```
+
+States are **strictly forward-flowing** (matching PRD §8.11.3 4-state capability lifecycle). No revivals, no skips. The FSM rejects any non-canonical transition.
+
+## Manifest store (Decision #168 — YAML + filesystem)
+
+Manifests live under `plm_skill_packages/manifests/*.yaml` and load at boot via `manifests.load_all()`, matching the `litellm_config/model_list.yaml` catalog-as-truth pattern. No SQL, no admin UI in V1.
+
+## Re-export shims
+
+Every monolith path that today references the lifted modules is preserved as a re-export shim — `from agents.plm_structural_analyst import ...` continues to work. Pattern matches Wave 1 W1.4 `services/run_task_tracker.py` (canonical decommission template).
+
+## Transitional dependency note
+
+The lifted PLM agent + process_generator code keeps its existing `from services.X` / `from models.X` / `from utils.X` / `from agents.base_agent` imports. These resolve at runtime in the backend process via PYTHONPATH; standalone sibling tests configure conftest.py to extend sys.path. **Wave 7 Extraction** physically separates the repos and refactors inbound deps to ports/Protocols.
+
+## Wave 6.5 lineage
+
+- **Wave 6.5 Conv A** (this) — `plm-skill-packages` carve.
+- **Wave 6.5 Conv B** — `plm-knowledge` carve (PRD §3 #6).
+- **Wave 6.5 Conv C** — closure audit + Wave 7 readiness re-author.

plm_skill_packages-1.0.0/plm_skill_packages/__init__.py

@@ -0,0 +1,66 @@
+"""TracePulse PLM Skill Packages — Wave 6.5 Conv A.
+
+PRD §3 #3 product-line carve. Hosts the PLM PDF→BPMN 5-agent chain
+(Structural Analyst → Process Scout → Logic Modeler → BPMN Transpiler
+→ Quality Gate), the CSV→BPMN process_generator (with the only
+legitimate cascade fallback per CLAUDE.md), output_format_controller,
+build_registry, and plm_orchestrator.
+
+Public surface:
+  * The 9 lifted modules at top level.
+  * ``lifecycle`` — 4-state FSM aligned verbatim with PRD §8.11.3
+    (Decision #167).
+  * ``manifests`` — YAML manifest loader (Decision #168 = YAML +
+    filesystem).
+  * ``contracts`` — wire-contract Pydantic v2 frozen models for the
+    public surface (Decision #160 interface-freeze pattern).
+  * ``registry`` — manifest+lifecycle registry exposed to the kernel
+    (capability registry callers).
+
+Re-export shims at every monolith path keep legacy callers working
+through Wave 7 Extraction (Wave 1 W1.4 RunTaskTracker template).
+"""
+
+from plm_skill_packages.contracts import (
+    SKILL_PACKAGES_VERSION,
+    SkillManifest,
+    SkillLifecycleState,
+    SkillKind,
+)
+from plm_skill_packages.lifecycle import (
+    LIFECYCLE_STATES,
+    LIFECYCLE_TRANSITIONS,
+    InvalidLifecycleTransition,
+    next_state,
+    is_terminal,
+    can_transition,
+)
+from plm_skill_packages.manifests import (
+    MANIFESTS_DIR,
+    ManifestLoadError,
+    load_manifest,
+    load_all,
+)
+from plm_skill_packages.registry import (
+    SkillRegistry,
+    get_skill_registry,
+)
+
+__all__ = [
+    "SKILL_PACKAGES_VERSION",
+    "SkillManifest",
+    "SkillLifecycleState",
+    "SkillKind",
+    "LIFECYCLE_STATES",
+    "LIFECYCLE_TRANSITIONS",
+    "InvalidLifecycleTransition",
+    "next_state",
+    "is_terminal",
+    "can_transition",
+    "MANIFESTS_DIR",
+    "ManifestLoadError",
+    "load_manifest",
+    "load_all",
+    "SkillRegistry",
+    "get_skill_registry",
+]

plm_skill_packages-1.0.0/plm_skill_packages/build_registry.py

@@ -0,0 +1,249 @@
+"""
+Build Registry Agent
+Manages build generators registry and handler routing.
+"""
+
+from typing import Any, Dict, List, Optional
+
+from plm_shared.agents.base_agent import BaseAgent
+
+
+# Schema: id, title, output_extension, handler_type, description (optional)
+BUILD_GENERATORS: List[Dict[str, Any]] = [
+    {
+        "id": "generate_process",
+        "title": "Processus BPMN",
+        "output_extension": "tproc",
+        "handler_type": "generate_process",
+        "description": "Génération d'un processus BPMN à partir du plan et des sources.",
+    },
+    {
+        "id": "agent_stream",
+        "title": "Document Markdown",
+        "output_extension": "md",
+        "handler_type": "agent_stream",
+        "description": "Génération d'un document Markdown par l'agent conversationnel.",
+    },
+]
+
+
+class BuildRegistryAgent(BaseAgent):
+    """
+    Build Registry Agent
+    
+    Manages the build generators registry and provides handler routing
+    for the orchestrator. Maps file extensions to handler types.
+    
+    Per SPEC_FLUX_BUILD: mapping extension -> handler for orchestrator routing.
+    
+    Phase 1: Config in code (can be moved to YAML/env later)
+    
+    Input (flexible):
+        - extension: File extension to look up handler (optional)
+        - action: "get_handler", "list_extensions", "get_generators" (optional)
+    
+    Output (flexible):
+        - handler: Handler type for extension
+        - extensions: List of supported extensions
+        - generators: Full registry list
+    """
+
+    def __init__(self):
+        super().__init__(
+            name="build_registry",
+            description="Manages build generators registry and handler routing"
+        )
+
+    def get_output_schema(self) -> Dict[str, Any]:
+        """Define build registry output schema."""
+        return {
+            "type": "object",
+            "properties": {
+                "handler": {"type": "string"},
+                "extensions": {"type": "array", "items": {"type": "string"}},
+                "generators": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "id": {"type": "string"},
+                            "title": {"type": "string"},
+                            "output_extension": {"type": "string"},
+                            "handler_type": {"type": "string"},
+                            "description": {"type": "string"},
+                        }
+                    }
+                },
+            },
+        }
+
+    def get_required_fields(self) -> list:
+        """Return required input fields (none are strictly required)."""
+        return []
+
+    def validate_input(self, input_data: Dict[str, Any]) -> bool:
+        """Validate build registry input."""
+        # No strict requirements - can be called with or without parameters
+        return True
+
+    async def execute(self, input_data: Dict[str, Any]) -> Dict[str, Any]:
+        """Execute build registry operations."""
+        self.validate_input(input_data)
+        
+        # Determine action to perform
+        action = input_data.get("action", "get_generators").lower()
+        extension = input_data.get("extension")
+        
+        if action == "get_handler":
+            handler = self._get_handler_for_extension(extension)
+            return {
+                "handler": handler,
+                "extension": extension,
+            }
+        elif action == "list_extensions":
+            extensions = self._list_extensions()
+            return {
+                "extensions": extensions,
+            }
+        else:  # Default: get_generators
+            generators = self._get_generators()
+            extensions = self._list_extensions()
+            return {
+                "generators": generators,
+                "extensions": extensions,
+            }
+
+    def _get_generators(self) -> List[Dict[str, Any]]:
+        """
+        Return the complete build generators registry.
+        
+        Returns:
+            List of generator definitions
+        """
+        return BUILD_GENERATORS
+
+    def _get_handler_for_extension(self, extension: Optional[str]) -> Optional[str]:
+        """
+        Return handler_type for the given output extension.
+        
+        Examples:
+            'tproc' → 'generate_process'
+            'md' → 'agent_stream'
+        
+        Args:
+            extension: File extension to look up (case-insensitive)
+            
+        Returns:
+            Handler type string or None if not found
+        """
+        ext = (extension or "").lower().strip()
+        if not ext:
+            return None
+        
+        for generator in BUILD_GENERATORS:
+            if (generator.get("output_extension") or "").lower() == ext:
+                return generator.get("handler_type")
+        
+        return None
+
+    def _list_extensions(self) -> List[str]:
+        """
+        Return list of supported output extensions.
+        
+        Returns:
+            List of extension strings (e.g., ['tproc', 'md'])
+        """
+        return [
+            generator.get("output_extension")
+            for generator in BUILD_GENERATORS
+            if generator.get("output_extension")
+        ]
+
+    def _get_generator_by_id(self, generator_id: str) -> Optional[Dict[str, Any]]:
+        """
+        Return generator definition by ID.
+        
+        Args:
+            generator_id: Generator ID to look up
+            
+        Returns:
+            Generator definition dict or None if not found
+        """
+        gen_id = (generator_id or "").lower().strip()
+        if not gen_id:
+            return None
+        
+        for generator in BUILD_GENERATORS:
+            if (generator.get("id") or "").lower() == gen_id:
+                return generator
+        
+        return None
+
+    def _get_generator_by_extension(self, extension: str) -> Optional[Dict[str, Any]]:
+        """
+        Return full generator definition by output extension.
+        
+        Args:
+            extension: File extension to look up
+            
+        Returns:
+            Generator definition dict or None if not found
+        """
+        ext = (extension or "").lower().strip()
+        if not ext:
+            return None
+        
+        for generator in BUILD_GENERATORS:
+            if (generator.get("output_extension") or "").lower() == ext:
+                return generator
+        
+        return None
+
+    def _is_extension_supported(self, extension: str) -> bool:
+        """
+        Check if an extension is supported.
+        
+        Args:
+            extension: File extension to check
+            
+        Returns:
+            True if extension is supported, False otherwise
+        """
+        return self._get_handler_for_extension(extension) is not None
+
+
+# Singleton instance
+build_registry_agent = BuildRegistryAgent()
+
+
+# ==================== BACKWARD COMPATIBILITY ====================
+
+def get_handler_for_extension(extension: str) -> Optional[str]:
+    """
+    Backward compatibility wrapper for original function.
+    
+    Return handler_type for the given output extension (e.g. 'tproc' -> 'generate_process').
+    
+    Args:
+        extension: File extension to look up
+        
+    Returns:
+        Handler type string or None
+    
+    Delegates to build_registry_agent singleton.
+    """
+    return build_registry_agent._get_handler_for_extension(extension)
+
+
+def list_extensions() -> List[str]:
+    """
+    Backward compatibility wrapper for original function.
+    
+    Return list of supported output extensions.
+    
+    Returns:
+        List of extension strings
+    
+    Delegates to build_registry_agent singleton.
+    """
+    return build_registry_agent._list_extensions()

plm_skill_packages-1.0.0/plm_skill_packages/common/__init__.py

@@ -0,0 +1,59 @@
+"""
+Common utilities package for PLM skill agents.
+
+Wave 9 Conv C (US-AS-9): canonical home for the BPMN-side common
+helpers. The legacy ``agents.common`` import path stays live via
+``02_App/backend/agents/common/__init__.py`` re-export shim.
+"""
+
+from plm_skill_packages.common.validators import (
+    validate_bpmn_structure,
+    validate_required_fields,
+    sanitize_bpmn_xml,
+)
+
+from plm_skill_packages.common.scoring import (
+    build_error_payload,
+    derive_plan_name_from_message,
+    derive_process_name_from_plan,
+    BUILD_ERROR_QUALITY_OR_ITERATIONS,
+    BUILD_ERROR_LLM_CONFIG,
+    BUILD_ERROR_LLM_UNAVAILABLE,
+    BUILD_ERROR_GENERIC,
+)
+
+from plm_skill_packages.common.formatters import (
+    parse_personas_systems_from_documentation,
+    parse_personas_systems_from_bpmn,
+    parse_process_name_from_bpmn,
+    filter_personas_to_plm_skills,
+    count_lines,
+    extract_bpmn_from_reply,
+    split_reply_markdown_bpmn,
+    looks_like_bpmn,
+    is_binary_or_encoded,
+    is_editable_text_document,
+)
+
+__all__ = [
+    "validate_bpmn_structure",
+    "validate_required_fields",
+    "sanitize_bpmn_xml",
+    "build_error_payload",
+    "derive_plan_name_from_message",
+    "derive_process_name_from_plan",
+    "BUILD_ERROR_QUALITY_OR_ITERATIONS",
+    "BUILD_ERROR_LLM_CONFIG",
+    "BUILD_ERROR_LLM_UNAVAILABLE",
+    "BUILD_ERROR_GENERIC",
+    "parse_personas_systems_from_documentation",
+    "parse_personas_systems_from_bpmn",
+    "parse_process_name_from_bpmn",
+    "filter_personas_to_plm_skills",
+    "count_lines",
+    "extract_bpmn_from_reply",
+    "split_reply_markdown_bpmn",
+    "looks_like_bpmn",
+    "is_binary_or_encoded",
+    "is_editable_text_document",
+]