Skip to content

TASKS.md

Latest commit

 

History

History
52 lines (43 loc) · 2.87 KB

TASKS.md

File metadata and controls

52 lines (43 loc) · 2.87 KB

LinearSDK Task Ledger

Goal

Create linear_sdk as the first generated consumer of prismatic:

  • provider repo with committed upstream artifacts
  • thin handwritten runtime wrapper
  • generated internal support modules and full-schema docs
  • professional docs, branding, metadata, and quality gates
  • local generation and verification tasks

Required Reading

Work Items

  • Create GitHub repo and local clone
  • Confirm prismatic is the shared runtime and codegen substrate
  • Replace mix new boilerplate with provider repo structure
  • Add upstream artifacts and provider definition
  • Add generation and verification tasks
  • Generate committed SDK artifacts
  • Add docs, guides, badge-ready README, and SVG
  • Replace the stub schema snapshot with the committed upstream full schema files as the generator inputs
  • Publish the full upstream Linear graph in HexDocs through generated API reference pages
  • Remove user-facing Prismatic and Generated leakage from the published linear_sdk docs surface
  • Run format
  • Run tests
  • Run Credo
  • Run Dialyzer
  • Run docs
  • Run full provider mix ci
  • Commit and push

Progress Log

  • 2026-04-01: GitHub repo created and cloned locally.
  • 2026-04-01: Boilerplate removal and provider-repo scaffold started.
  • 2026-04-01: Added committed upstream artifacts, copied official SDK manifest files as reference inputs, and defined the provider config under codegen/.
  • 2026-04-01: Brought up generated operations, models, enums, and a full generated reference-doc tree from prismatic_codegen.
  • 2026-04-01: Added provider mix tasks for IR inspection, generation, and artifact verification, then wired mix ci to verify committed generated artifacts before testing.
  • 2026-04-01: Replaced the stub introspection.json input with committed schema.json and schema.graphql copied from the official Linear repo and consumed directly by the generator.
  • 2026-04-01: Replaced the legacy guides/generated/ docs surface with a full public schema-reference tree under guides/api/.
  • 2026-04-01: Added rendered-doc assertions to keep public HexDocs free of LinearSDK.Generated, Prismatic.Client, and legacy generated-doc labels.
  • 2026-04-01: Verified mix ci passes cleanly across generation verification, tests, Credo, Dialyzer, docs, and rendered-doc assertions.