Skip to content

feat(helix): drain alignment queue — story floor, JSON backbone, FR-23 closeout - #12

Merged
easel merged 3 commits into
mainfrom
work/alignment-queue-drain-2026-07-22
Jul 23, 2026
Merged

feat(helix): drain alignment queue — story floor, JSON backbone, FR-23 closeout#12
easel merged 3 commits into
mainfrom
work/alignment-queue-drain-2026-07-22

Conversation

@easel

@easel easel commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Summary

Drains the HELIX desired-state alignment epic (tablespec-263a0248) against current main after the spec/bead surgery and FEAT-034 app work landed.

  • FEAT-034: closed shipped beads (config precedence, provision, manifest inputs, startup diagnostics, CFG-02, optional degrade) with evidence pointing at PR App startup validation + declared deployment inputs (FEAT-034 DIAG/PKG) #10 implementations and tests.
  • Story floor: authored US-040, US-042, US-043, US-050 with stable ACs citing existing unit tests; linked from FEAT-031.
  • JSON residual (FR-21.7): backbone _declared_source + Spark/DuckDB _load_raw accept kind=json (projection via JsonReader / read_json_auto).
  • FR-23 e2e slot: unit whole-stack composition test apps/data-profiling/tests/test_fr23_stack.py; concerns + test-plan updated.
  • Hygiene: US-046 @covers + AC evidence; US-045 residual ACs evidenced with explicit CI/workspace limitations.
  • Alignment epic auto-closed when all children reached terminal state.

Test plan

  • uv run pytest apps/data-profiling/tests/ tests/unit/test_ingestion_package.py tests/unit/test_guidebook_generate.py tests/unit/test_guidebook_renderer.py tests/docs/ -q (401 passed)
  • CI green on PR
  • Spot-check US-040/042/043/050 files and FEAT-031 user-stories links

Out of scope (still open)

  • Databricks dialect canonicalization epic (tablespec-ed74497c and children) — execution-eligible: false / needs refinement
  • Legacy US-001–020 AC ID normalization (tablespec-dbf90b8d)

easel added 3 commits July 22, 2026 18:07
…3 closeout

Close the HELIX desired-state alignment epic against main after the
spec/bead surgery landed:

- Close shipped FEAT-034 beads (config, provision, manifest, diagnostics,
  CFG-02, optional degrade) with evidence from PR #10.
- Author story-floor US-040/042/043/050 with ACs citing existing tests.
- Implement JSON kind on the e2e backbone (Spark + DuckDB load paths).
- Add FR-23 unit whole-stack composition test; update e2e-framework slot.
- Link US-046 ACs via @Covers; evidence/waive residual US-045 ACs.
- Update FEAT-031/032, PRD FR-21.7, feature registry, and test plan.
generate_pyspark_schema used datetime.now() when source_file_modified was
absent, so two compile passes a second apart produced different artifacts
and flaked test_candidate_mode_does_not_change_generated_runtime_artifacts
in CI. Match DDL: omit the timestamp line unless metadata supplies it.
@easel
easel merged commit 04b06ce into main Jul 23, 2026
2 checks passed
dmautz1 pushed a commit to dmautz1/tablespec that referenced this pull request Jul 24, 2026
Alignment review after beads queue drain (DocumentDrivenDX#12/DocumentDrivenDX#13). Notes PR DocumentDrivenDX#14 as
in-flight plan-to-code for FEAT-034/US-044 and bulk citation hygiene.

Agent-executable follow-ups only:
- @Covers US-037-AC1..5 on test_safe_timestamp (+ Connect sail)
- @Covers US-038-AC1..5 on Playwright + pages artifact tests

No beads filed for workspace-only residual (live app deploy, FM API job).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant