Skip to content

docs: track upstream contribution strategy with workspace-aware 5-PR revision#13

Merged
stanleykao72 merged 1 commit intomainfrom
docs/upstream-contribution-workspace-revision
May 5, 2026
Merged

docs: track upstream contribution strategy with workspace-aware 5-PR revision#13
stanleykao72 merged 1 commit intomainfrom
docs/upstream-contribution-workspace-revision

Conversation

@stanleykao72
Copy link
Copy Markdown
Owner

Summary

Adds the long-tracked umbrella change openspec/changes/upstream-contribution/ that maps fork's 26 commits to a 5-PR upstream contribution plan. Originally drafted 2026-04-17 (memory project_openspec_upstream_strategy.md), updated 2026-05-04 to account for upstream's workspace-foundation landing (PR Fission-AI#1045) and TabishB's 21-day silence since the 2026-04-13 PR Fission-AI#891 ack.

Key Revisions

PR Old plan New plan
T0 icebreaker WAITING for response Stalled-not-negative; push T1 to force review
T1 plugin foundation MEDIUM risk, submit first HIGH risk (workspace churned same surface), still submit first; reference sync PR #12
T5 fingerprinting submit last Submit in parallel with T1 (independent)
T3 orchestration hints MEDIUM risk, after T1+T2 LOW risk, after T1 lands
T2 verify/archive phases submit second DEFERRED — overlaps slice 6 workspace-verify-and-archive
T4 pipeline runner submit fourth DEFERRED — overlaps slice 5 workspace-apply-repo-slice

Why Submit a PR Instead of Push to main

This is fork-internal planning docs (never goes upstream), but the commit affects strategy decisions that future contributors / agents will reference. PR keeps the audit trail consistent with sync PR #12.

Test plan

  • Validate change parses: node bin/openspec.js validate upstream-contribution --strict — fails on "no deltas" because this is a planning umbrella, not a capability change. Pre-existing condition since 2026-04-17 draft. Acceptable.

🤖 Generated with Claude Code

…th workspace-aware revisions

Adds the long-tracked umbrella change that maps fork's 26 commits to a
5-PR upstream contribution plan. Originally drafted 2026-04-17 (memory
project_openspec_upstream_strategy.md). Updated 2026-05-04 to account for
workspace-foundation landing (PR Fission-AI#1045) and TabishB's 21-day silence
since the 04-13 PR Fission-AI#891 ack.

Key revisions:
- T0 icebreaker: marked stalled-not-negative; push T1 to force review
- T1 (plugin foundation): risk MEDIUM → HIGH, surface area churned by
  workspace-foundation; submit FIRST despite higher rebase cost
- T5 (fingerprinting): submit IN PARALLEL with T1 (independent, no
  workspace coupling)
- T3 (orchestration hints): risk MEDIUM → LOW, submit AFTER T1 lands
- T2 (verify/archive phases): DEFERRED — overlaps slice 6
  workspace-verify-and-archive proposal
- T4 (pipeline runner): DEFERRED — overlaps slice 5
  workspace-apply-repo-slice proposal; apply semantics being redefined

Section 0.5 records the 2026-05-04 sync merge (fork PR #12).

Constraint: spec-driven schema validation fails (no deltas) — acceptable,
this is a planning umbrella, not a capability change
Confidence: high (analysis based on reading all 4 workspace slice proposals
on upstream/main)
Scope-risk: narrow (fork-only docs, never contributed)
Reversibility: clean
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@stanleykao72 stanleykao72 merged commit 67ff635 into main May 5, 2026
@stanleykao72 stanleykao72 deleted the docs/upstream-contribution-workspace-revision branch May 5, 2026 00:29
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