Skip to content

feat(carve S1): foundation contracts for the orchestration arc (additive, dormant)#647

Draft
isadeks wants to merge 1 commit into
aws-samples:mainfrom
isadeks:carve/s1-foundation-contracts
Draft

feat(carve S1): foundation contracts for the orchestration arc (additive, dormant)#647
isadeks wants to merge 1 commit into
aws-samples:mainfrom
isadeks:carve/s1-foundation-contracts

Conversation

@isadeks

@isadeks isadeks commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Slice 1 of a staged carve — foundation contracts

First slice landing the Linear sub-issue orchestration + Mode-B + iteration arc (developed on the linear-vercel line) onto main, in dependency-ordered, independently-reviewable pieces. This slice is purely additive shared-contract changes that later slices reference — nothing is wired or activated, so behavior on main is unchanged.

Contents

  • types.ts — additive optional TaskRecord fields the arc reads (orchestration_id, parent_task_id, depends_on, linear_issue_id, code_changed, head_sha, screenshot_url, answer_text, …). All optional → back-compatible.
  • validation.ts — attachment MIME maps + size constants. (Deliberately keeps the max-turns default unchanged; the arc's bump to a higher default is a live behavioral change that will come as its own PR.)
  • workflows.ts — register the read-only planning + restack workflow definitions + the readOnly flag on the workflow type. Registry metadata only; the workflow definitions + planners land in later slices, unused until then.
  • repo-config.ts — additive optional build_command / lint_command on the repo/blueprint config (per-repo build/lint verification commands; default to the platform commands when unset).

Combination safety

Part of a staged sequence; every later slice is built + verified so that the union of all slices reproduces the deploy-verified linear-vercel tree. This slice's files are byte-identical to that source (comments aside).

Gates

cdk compile + eslint + full jest (135 suites / 2509 tests) green.

🤖 Generated with Claude Code

…ive, dormant)

Slice 1 of the linear-vercel→main carve. Purely additive shared-contract changes
that every later orchestration slice references — nothing here is wired or
activated, so behavior on main is unchanged.

- types.ts: additive optional TaskRecord fields the orchestration/Mode-B/A6 arc
  reads (orchestration_id, parent_task_id, depends_on, linear_issue_id,
  code_changed, head_sha, screenshot_url, answer_text, …). All optional → back-compatible.
- validation.ts: attachment MIME maps + size constants. Deliberately keeps the
  max-turns default at main's value (the arc's bump to a higher default is a live
  behavioral change and belongs in its own PR, not this dormant slice).
- workflows.ts: register the read-only planning + restack workflow definitions +
  the readOnly flag on the workflow type. Registry metadata only — the workflow
  definitions + planners land in later slices, unused until then.
- repo-config.ts: additive optional build_command / lint_command on the repo +
  blueprint config (per-repo build/lint verification commands the agent runs
  before opening a PR; default to the platform commands when unset).

Gates: cdk compile + eslint + full jest green. No new imports, no runtime wiring,
no behavioral change.
@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 98.78049% with 2 lines in your changes missing coverage. Please review.
⚠️ Please upload report for BASE (main@1232a46). Learn more about missing BASE report.

Files with missing lines Patch % Lines
cdk/src/handlers/shared/validation.ts 96.07% 2 Missing ⚠️
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.
Additional details and impacted files
@@           Coverage Diff           @@
##             main     #647   +/-   ##
=======================================
  Coverage        ?   90.08%           
=======================================
  Files           ?      241           
  Lines           ?    58995           
  Branches        ?     6049           
=======================================
  Hits            ?    53147           
  Misses          ?     5848           
  Partials        ?        0           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

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.

2 participants