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

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 default_suite() -> ProductivitySuite

Default developer tooling suite.

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 monorepo_suite() -> ProductivitySuite

Monorepo-focused suite.

pub fn name(suite: ProductivitySuite) -> String

Suite name accessor.

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 plugin_suite() -> ProductivitySuite

Plugin-heavy suite.

pub fn profile_version_label() -> String

Stable M59 profile version label.

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 fn signature(suite: ProductivitySuite) -> String

Stable suite signature.

pub fn snapshot_signature() -> String

Deterministic M59 snapshot signature.

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 valid_suite(suite: ProductivitySuite) -> Bool

Validate one M59 suite contract.

pub fn workflows_reduce_patch_churn(
  suite: ProductivitySuite,
) -> Bool

True when representative refactor workflows reduce patch churn.

Search Document