2026-08-03 Maintainability Convergence

This release closes the repository-wide modularity audit baseline without merging SDLX domain authorities or removing compatibility entry points.

Boundaries established

• packages/run-spec is the single immutable package loading, validation, normalization and hashing implementation used by Composer and PACE.
• deployments/topology.json owns deployment-unit membership, service order, scripts, health endpoints and console endpoints for wrappers and Supervisor.
• packages/sandbox-runtime owns generic Podman inspection and atomic sandbox audit mechanics; ASCEND, Composer and PRISM still own role-specific policy, mounts, filesystem views and network decisions.
• Capability v2 producer output, its JSON Schema and the ASCEND consumer model now agree on required and additional fields.

Maintainability gates

• Ruff 0.16.1 and Pyright 1.1.411 are pinned in CI.
• Shared job, object-store, schema, RunSpec and sandbox runtimes, Supervisor, deployment Python and all tracked shell entry points are covered by CI.
• Engineering Consoles execute strict checkJs diagnostics with checked-in, non-increasing budgets: Composer 354, LabBridge 1236, LabFlow 1067, PACE 791 and PRISM 176. A future change may lower a budget but may not raise it.
• Architecture qualification prevents Composer-to-PACE source imports, hard-coded Supervisor topology, sandbox-runtime drift and type-budget removal.
• Scoped AI-development guidance is required for 25 repository, domain, infrastructure, firmware, documentation, and shared-package boundaries. The guidance gate limits each file to 240 lines, checks managed runtime copies, and rejects known stale architecture statements.
• Active documents, production Python, frontend sources and entry components, styles, and tests have default size limits. Twenty-four existing Python/test hotspots have exact non-increasing budgets; generated contracts, archives, release records, dependencies, build output, and runtime sandboxes are excluded because they are not hand-maintained units.

First hotspot extractions

• Composer frontend formatting and session-display helpers moved out of the monolithic App.jsx into app-utils.js.
• Composer management projections and bounded integration diagnostics moved out of transport handlers into management_projection.py.
• PACE retains pace.package_loader only as a compatibility import facade.
• The normative main PRD was reduced from 1,531 to 334 lines; its detailed 2026-08-03 snapshot moved to the repository-only archive.
• Composer's 1,596-line planning Agent was separated into a 752-line orchestration module and an 896-line deterministic support module.
• PACE's 1,375-line App.jsx was reduced to 678 lines by extracting run and operations views. LabBridge's 1,282-line entry was reduced to 1,144 lines by extracting navigation and removing unused tree/compare helpers.
• The shared lab-map implementation was separated into rendering, labels, scene adaptation, and public types. ASCEND, LabBridge, and PACE style sheets were divided into focused ordered imports; no resulting style unit exceeds 652 lines.

The remaining large files and current type-diagnostic counts are explicit reduction queues. They are no longer invisible exceptions to nominal green commands.

Qualification evidence

• Pinned Ruff and scoped Pyright: passed with zero findings.
• Qualification contracts and architecture boundaries: 24 passed.
• Shared Agent, job, object-store, RunSpec, sandbox and schema runtimes plus Supervisor: passed.
• LabBridge, Composer, LabFlow, PACE, ASCEND and PRISM module suites: all exited successfully; Composer's complete suite reported 53 passed.
• Composer production Web build and all five Engineering Console locale, nominal type and lint gates: passed. LabBridge retains its explicitly bounded 15 existing Hook warnings.
• Strict Engineering Console diagnostic budgets: all five passed at their checked-in baseline values.
• Canonical topology validation, all tracked shell syntax checks and git diff --check: passed.
• Scoped Agent guidance and maintained-file size gates: passed; 25 guidance scopes are present and the 24 retained hotspots are prohibited from growth.