Skip to content

fix(sync-scaffold): copy packaged docs into specfuse/loop/data/docs/ (closes #3585) - #3588

Merged
clabonte merged 1 commit into
mainfrom
fix/issue-3585-sync-scaffold-docs
Nov 15, 2026
Merged

clabonte merged 1 commit into
mainfrom
fix/issue-3585-sync-scaffold-docs

Conversation

@clabonte

Copy link
Copy Markdown
Contributor

Root cause

test_scaffold_data_in_sync byte-checks the docs shipped under specfuse/loop/data/docs/ and says "Run: scripts/sync-scaffold.sh" on drift, but the script never copied docs/. Every doc edit needed a hand copy; #3581, #3582 and #3583 all hit it.

Fix

  • New scripts/sync-scaffold-docs.txt: the one list of packaged docs.
  • sync-scaffold.sh copies each listed doc into specfuse/loop/data/docs/. A listed doc missing from docs/ fails the sync; a tree without docs/ (test fixtures) skips the stage.
  • The drift test reads the same list instead of its own hard-coded set.

Tests

tests/sync_scaffold.bats: 4 new cases (copy, stale update, missing doc fails, no docs/ skips). The first three were red before the change.

Verification

scripts/smoke-test.sh: 5072 tests OK, bats suites green, all gates pass.

Closes #3585

🤖 Generated with Claude Code

Closes #3585. tests/test_scaffold_data_in_sync.py byte-checks the docs/
files shipped under specfuse/loop/data/docs/ and tells the reader to run
scripts/sync-scaffold.sh to fix drift, but the script never copied docs/:
every edit to a tracked doc failed the drift test until the file was
copied by hand. All three monitoring PRs of the 0.33.0 cycle hit it.

The script gains a docs stage that copies each file listed in the new
scripts/sync-scaffold-docs.txt into specfuse/loop/data/docs/. The drift
test reads the same list instead of its own hard-coded set, so the two
cannot disagree. A listed doc missing from docs/ fails the sync; a tree
with no docs/ (the bats fixtures) skips the stage.

Tests:
- tests/sync_scaffold.bats — listed docs are copied, a stale copy is
  updated, a missing listed doc fails, a tree without docs/ skips.

Verification:
- scripts/smoke-test.sh green: 5072 tests OK, bats suites pass, all
  declared gates pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@clabonte
clabonte force-pushed the fix/issue-3585-sync-scaffold-docs branch from ebe945b to 051cca3 Compare November 15, 2026 10:46
@clabonte
clabonte merged commit 0e7e4b5 into main Nov 15, 2026
6 checks passed
@clabonte
clabonte deleted the fix/issue-3585-sync-scaffold-docs branch November 15, 2026 10:51
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.

sync-scaffold.sh does not copy docs/ into specfuse/loop/data/docs/

1 participant