feat(schemas): enforce LinkML-generated types from cradle to grave

[IanMayo]

Summary

• Eliminate dict[str, Any] and Record<string, unknown> from domain data throughout the monorepo — every function that touches features, provenance, or session-state now uses LinkML-generated types
• Delete the propsRecord escape hatch (featureProps.ts) and migrate all 10 consumers to isTrackFeature() / isReferenceLocation() type guards
• Extend schema generation to emit session-state, tool-result, and new STAC view types into both Python and TypeScript
• Add DebriefFeature union type in both languages as the canonical type for feature collections

Changes

Phase 1: Schema Completeness

• Add PlotSummary, StacItemSummary to stac-extension.yaml
• Add ResultsSlice, BrowserFilterSlice to session-state.yaml
• Reconcile DatasetEntry with runtime DatasetEnvelope shape
• Add DebriefFeature Python union type (unions.py)

Phase 2: TypeScript Generator Extension

• Add session-state and tool-result imports to master debrief.yaml
• Regenerate TypeScript types — all domain types now in @debrief/schemas
• Fix .js extensions in index.ts for NodeNext module resolution

Phase 3: Delete TypeScript Duplicates

• Delete TrackFeature, LocationFeature, PositionStyle, TimestampedPosition from plot.ts
• Delete PositionStyle, PositionStyleOverride from shared/utils/types.ts
• Delete ParameterValue, InputFeatureState from LogPanel/types.ts
• Delete LogEntry from web-shell/toolService.ts
• Rename Track → TrackViewModel (UI projection)

Phase 4: Delete Python Duplicates

• Delete provenance models (ParameterValue, LogEntry, WasGeneratedBy, etc.) from calc/models.py
• Delete snapshot/branch models (SnapshotRef, BranchRecord, etc.) from calc/models.py
• Re-export from debrief_schemas for backward compatibility

Phase 5: Strongly Type Python Internal Logic

• Replace Feature = dict[str, Any] with DebriefFeature union in debrief_io/types.py
• Retype 13 calc tool functions with Pydantic model annotations
• Replace feature.get("properties") with typed access in validation/provenance/executor
• Add Pydantic validation on STAC feature read (previously only on write)

Phase 6: Strongly Type TypeScript Internal Logic

• Eliminate propsRecord in 10 consumer files, delete featureProps.ts
• Add type guard validation after JSON.parse in calcService, stacService
• Remove as unknown as casts on domain data in mapPanel, stacService, logService

Phase 7: Remaining Migrations

• Migrate session-state TS types to @debrief/schemas imports
• Replace DatasetEnvelope with generated DatasetEntry in ChartRenderer
• Replace CatalogOverviewItem with StacItemSummary in filter-engine

Evidence

Test Results

Metric	Value
Python Tests (pytest)	1273 passed, 1 skipped, 1 xfailed
TypeScript Tests (vitest)	1053 passed
Python Type Check (pyright)	0 errors, 0 warnings
TypeScript Type Check (tsc)	0 errors (all 7 packages)
Python Lint (ruff)	All checks passed
TypeScript Lint (eslint)	0 errors, 2 warnings

Prohibited Pattern Check

Pattern	Before	After
Feature = dict[str, Any]	1 location	0
propsRecord usage	10 files	0
featureProps.ts	exists	deleted
as unknown as DebriefFeature	9 locations	4 (complex data flows)

Test Plan

• pyright: 0 errors across all Python services
• tsc --noEmit: 0 errors across all 7 TS packages
• pytest: 1273 passed (no regressions)
• vitest: 1053 passed (no regressions)
• ruff: all checks passed
• eslint: 0 errors (2 acceptable warnings)
• Prohibited patterns eliminated (Feature alias, propsRecord, featureProps.ts)

Related

• Spec: specs/173-cradle-to-grave-typing/spec.md
• Plan: specs/173-cradle-to-grave-typing/plan.md
• Tasks: specs/173-cradle-to-grave-typing/tasks.md
• Evidence: specs/173-cradle-to-grave-typing/evidence/

https://claude.ai/code/session_01NVvcfZz3YgcdEm855v2UKB

[github-actions]

🚀 Preview Deployments

Code Server (Full VS Code Extension)

🖥️ Open Code Server

Browser-based VS Code with the Debrief extension and sample data pre-installed.

Web Shell (Standalone App)

📱 Open Web Shell

Use this for Playwright testing and demos - runs outside Storybook.

Storybook (Component Library)

📚 Open Storybook

Browse all components, stories, and documentation.

---

All Links

Environment	Code Server	Web Shell	Storybook
This PR	Open IDE	Open App	Open Storybook
Main branch	—	Open App	Open Storybook

Updated on commit 9ebbbc2