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.

Skill Manifest v1 profile (FTR-1990)

A declarative, additive metadata artifact describing what a skill manifest must contain — 28 fields, their types, tiers, validation rules, and decision references. It does not execute rules, enforce requiredness, or mutate the frozen SkillManifest / SKILL_PACKAGES_VERSION.

Versions: profile_version = "manifest-profile/1.0" (independent from SKILL_PACKAGES_VERSION = "v1.0.0-wave6.5").

from plm_skill_packages import load_profile, PROFILE_VERSION
from plm_skill_packages.manifest_profile import is_field_effective, get_execution_status

profile = load_profile()          # frozen ManifestProfile (28 fields, 14 sections)
is_field_effective(profile.fields[0])          # False (all candidate in v1.0)
get_execution_status(profile.fields[0])        # NOT_EXECUTABLE (profile unpublished)

Run the conformance fixture tests:

python -m pytest tests/test_manifest_profile.py tests/test_manifest_profile_fixtures.py -v

Full documentation: docs/manifest_profile/

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.