lightspeed/tooling/developer_productivity
Developer tooling polish and productivity contracts for M59.
Types
Runtime diagnostics domain.
pub type DiagnosticsDomain {
SessionDiagnostics
EventDiagnostics
DiffDiagnostics
TransportDiagnostics
}
Constructors
-
SessionDiagnostics -
EventDiagnostics -
DiffDiagnostics -
TransportDiagnostics
Editor diagnostic contract.
pub type EditorDiagnosticContract {
EditorDiagnosticContract(
code: String,
severity: String,
source_module: String,
quick_fix: String,
symbol: String,
)
}
Constructors
-
EditorDiagnosticContract( code: String, severity: String, source_module: String, quick_fix: String, symbol: String, )
Code-navigation metadata contract.
pub type NavigationContract {
NavigationContract(
module_ref: String,
symbol: String,
path: String,
command: String,
)
}
Constructors
-
NavigationContract( module_ref: String, symbol: String, path: String, command: String, )
M59 developer tooling suite contract.
pub type ProductivitySuite {
ProductivitySuite(
name: String,
diagnostics: List(RuntimeDiagnosticsSurface),
profiling: List(ProfilingSurface),
quality_gates: List(ToolingQualityGate),
refactor_workflows: List(RefactorWorkflow),
editor_diagnostics: List(EditorDiagnosticContract),
navigation_contracts: List(NavigationContract),
)
}
Constructors
-
ProductivitySuite( name: String, diagnostics: List(RuntimeDiagnosticsSurface), profiling: List(ProfilingSurface), quality_gates: List(ToolingQualityGate), refactor_workflows: List(RefactorWorkflow), editor_diagnostics: List(EditorDiagnosticContract), navigation_contracts: List(NavigationContract), )
Profiling hotspot dimension.
pub type ProfilingDimension {
LatencyHotspot
AllocationHotspot
RenderHotspot
}
Constructors
-
LatencyHotspot -
AllocationHotspot -
RenderHotspot
Actionable profiling surface for one hotspot dimension.
pub type ProfilingSurface {
ProfilingSurface(
dimension: ProfilingDimension,
command: String,
budget_label: String,
remediation_hint: String,
deterministic: Bool,
)
}
Constructors
-
ProfilingSurface( dimension: ProfilingDimension, command: String, budget_label: String, remediation_hint: String, deterministic: Bool, )
Representative refactor workflow contract.
pub type RefactorWorkflow {
RefactorWorkflow(
name: String,
baseline_patch_lines: Int,
polished_patch_lines: Int,
required_gates: List(String),
deterministic: Bool,
)
}
Constructors
-
RefactorWorkflow( name: String, baseline_patch_lines: Int, polished_patch_lines: Int, required_gates: List(String), deterministic: Bool, )
Actionable runtime diagnostics surface.
pub type RuntimeDiagnosticsSurface {
RuntimeDiagnosticsSurface(
domain: DiagnosticsDomain,
command: String,
key_signals: List(String),
remediation_hint: String,
custom_instrumentation_required: Bool,
)
}
Constructors
-
RuntimeDiagnosticsSurface( domain: DiagnosticsDomain, command: String, key_signals: List(String), remediation_hint: String, custom_instrumentation_required: Bool, )
Deterministic quality gate for generator/refactor workflows.
pub type ToolingQualityGate {
ToolingQualityGate(
name: String,
command: String,
snapshot_prefix: String,
deterministic: Bool,
)
}
Constructors
-
ToolingQualityGate( name: String, command: String, snapshot_prefix: String, deterministic: Bool, )
Values
pub fn diagnosable_without_custom_instrumentation(
suite: ProductivitySuite,
) -> Bool
True when runtime/performance issues are diagnosable without custom instrumentation.
pub fn diagnostics(
suite: ProductivitySuite,
) -> List(RuntimeDiagnosticsSurface)
Diagnostics accessor.
pub fn diagnostics_domain_label(
domain: DiagnosticsDomain,
) -> String
Diagnostics domain label.
pub fn diagnostics_signature(
surface: RuntimeDiagnosticsSurface,
) -> String
Stable diagnostics-surface signature.
pub fn editor_diagnostic_signature(
contract: EditorDiagnosticContract,
) -> String
Stable editor-diagnostic signature.
pub fn editor_diagnostics(
suite: ProductivitySuite,
) -> List(EditorDiagnosticContract)
Editor-diagnostics accessor.
pub fn fixture_snapshots() -> List(#(String, String))
Deterministic fixture snapshots for M59 drift gates.
pub fn navigation_contracts(
suite: ProductivitySuite,
) -> List(NavigationContract)
Navigation-contract accessor.
pub fn navigation_signature(
contract: NavigationContract,
) -> String
Stable navigation-contract signature.
pub fn patch_churn_reduction_percent(
workflow: RefactorWorkflow,
) -> Int
Patch-churn reduction percentage for one workflow.
pub fn profiling(
suite: ProductivitySuite,
) -> List(ProfilingSurface)
Profiling accessor.
pub fn profiling_dimension_label(
dimension: ProfilingDimension,
) -> String
Profiling dimension label.
pub fn profiling_signature(surface: ProfilingSurface) -> String
Stable profiling-surface signature.
pub fn quality_gate_signature(gate: ToolingQualityGate) -> String
Stable quality-gate signature.
pub fn quality_gates(
suite: ProductivitySuite,
) -> List(ToolingQualityGate)
Quality-gates accessor.
pub fn refactor_workflow_signature(
workflow: RefactorWorkflow,
) -> String
Stable refactor-workflow signature.
pub fn refactor_workflows(
suite: ProductivitySuite,
) -> List(RefactorWorkflow)
Refactor-workflows accessor.
pub fn reference_suites() -> List(ProductivitySuite)
Deterministic M59 reference suites.
pub const snapshot_version: Int
pub fn stable_quality_signals(suite: ProductivitySuite) -> Bool
True when tooling quality signals are stable enough for CI gating.
pub fn supports_editor_navigation(
suite: ProductivitySuite,
) -> Bool
True when editor diagnostics and navigation metadata are coherent.
pub fn workflows_reduce_patch_churn(
suite: ProductivitySuite,
) -> Bool
True when representative refactor workflows reduce patch churn.