Skip to content

GitHub-native artifact fallback: refs travel as issue comments when Notion is absent#44

Merged
parsakhaz merged 1 commit into
mainfrom
parsa/github-artifact-fallback
Jul 11, 2026
Merged

GitHub-native artifact fallback: refs travel as issue comments when Notion is absent#44
parsakhaz merged 1 commit into
mainfrom
parsa/github-artifact-fallback

Conversation

@parsakhaz

Copy link
Copy Markdown
Member

Summary

First real Orchestra run (bloomapi/bloom-mono epic) hit this: Notion wasn't configured, publish degraded to "GitHub + local only", and the refs (discussion log, code research) existed only in local ./tmp/. A remote agent running /do <issue#> would plan from the bare issue body — no prior context.

Fix, additive:

  • publish-work-item.md step 5: on NOTION UNAVAILABLE, post each refs/ file as its own issue comment wrapped in <!-- ORCHESTRA-ARTIFACT path="..." --> markers (part=n splits for oversized files). The issue becomes self-contained.
  • /do Step 0: when the issue has no Notion link, harvest the marker comments back into ./tmp//refs/ before planning; a bare issue (neither channel) gets named in the plan's Known mismatches instead of silently proceeding.

This was the "issue-marker reconstruction" idea deferred in the substance-loss audit as "Notion is the channel" — the first unconfigured machine proved the channel needs a fallback.

🤖 Generated with Claude Code

Real-world gap from the first bloom-mono epic run: with Notion unconfigured,
publish dropped to 'GitHub + local only' and a remote /do would get the
issue body with none of the discussion/research refs. Now degraded publish
posts each ref as a marker-delimited issue comment and /do Step 0
reconstructs ./tmp/<id>/refs/ from them.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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