docs: add missing workflow features and regenerate llms-full.txt#3250
Open
seanmartinsmith wants to merge 1 commit intogastownhall:mainfrom
Open
docs: add missing workflow features and regenerate llms-full.txt#3250seanmartinsmith wants to merge 1 commit intogastownhall:mainfrom
seanmartinsmith wants to merge 1 commit intogastownhall:mainfrom
Conversation
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
6e5dc72 to
fe68884
Compare
Add documentation for features implemented in Go source but missing from the website docs: formulas.md: - Convoy formula type (multi-agent coordination) - Formula inheritance (extends field) - Conditional steps (condition field with truthy/negated/equality) - Loop/iteration (count, range, until with max) - Runtime expansion (on_complete with for_each) - bd cook command (compile-time vs runtime modes) - Expanded gate types and aspect composition wisps.md: - Squash lifecycle (bd mol squash - promote to persistent) - Burn lifecycle (bd mol burn - delete without trace) - Garbage collection (bd mol wisp gc) - Corrected storage model (Ephemeral=true in main DB) - Updated commands to match actual CLI surface index.md: - Added swarm commands (validate, create, status, list) - Added cook command - Added wisp lifecycle commands (squash, burn, gc) - Added bond and formula list commands Regenerated website/static/llms-full.txt via scripts/generate-llms-full.sh. Before: 0 hits for swarm, convoy, cook, extends, condition, loop, squash, burn, promote, for_each in llms-full.txt. After: all terms present with substantive documentation. Closes gastownhall#3244
fe68884 to
0b5e5b2
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
website/static/llms-full.txtis generated from the versioned docs, but the source docs inwebsite/versioned_docs/version-1.0.0/workflows/are missing documentation for features that are fully implemented in the Go source. Agents relying on llms-full.txt for context conclude these features do not exist.Verified 0 hits in llms-full.txt for: swarm, convoy, cook, extends, condition, loop, squash, burn, promote, for_each.
Root Cause
The generation script (
scripts/generate-llms-full.sh) works correctly - it picks up all files. The gap is in the source markdown files themselves, which were written for an earlier version of the workflow system and never updated as features shipped.Fix
Updated 3 workflow docs and regenerated llms-full.txt:
formulas.md (+205 lines of content):
internal/formula/types.goTypeConvoyextendsfield) - fromFormula.Extendsin types.goconditionfield) - fromStep.ConditionandFilterStepsByConditionLoopSpecstruct in types.goon_completewithfor_each) - fromOnCompleteSpecin types.gobd cookcommand (compile-time vs runtime modes) - fromcmd/bd/cook.gowisps.md (rewritten):
bd mol squash- promote to persistent) - fromcmd/bd/wisp.golines 56, 532bd mol burn- delete without trace) - from wisp.go line 57, 305bd mol wisp gc) - from wisp.go GC subcommandEphemeral=truein main DB, not separate.beads-wisp/directorybd mol wispnotbd wisp)index.md (expanded command table):
cmd/bd/swarm.gollms-full.txt: Regenerated via
scripts/generate-llms-full.sh(6070 -> 6275 lines).Test Plan
scripts/generate-llms-full.shruns cleanly (verified)Context
Closes #3244. Source of truth for all additions is
internal/formula/types.go(848 lines),cmd/bd/swarm.go(1192 lines),cmd/bd/cook.go(1047 lines), andcmd/bd/wisp.go(832 lines).