Skip to content

Freeze generated files or mark generated/ writable - #2

Merged
ORESoftware merged 1 commit into
mainfrom
freeze-generated-readonly
Aug 28, 2026
Merged

ORESoftware merged 1 commit into
mainfrom
freeze-generated-readonly

Conversation

@ORESoftware

Copy link
Copy Markdown
Contributor

Summary

  • Add generated/README.md with <!-- generated-policy: frozen|writable -->.
  • Frozen trees (flags-2-env env.dart, api-docs route keys) are chmod a-w after generate.
  • Writable trees (scratch, music, wasm, some gitignored output) stay editable.
  • Gitignored generated artifacts still keep this README in VCS (git add -f).
  • JSON Schema remains a runtime cross-check, not necessarily the generator's primary input.

Test plan

  • Confirm the README policy marker matches how the tree is produced
  • Regenerating still works (thaw → write → chmod a-w for frozen trees)

@ORESoftware
ORESoftware merged commit 4b483dd into main Aug 28, 2026
1 check passed
ORESoftware added a commit that referenced this pull request Sep 11, 2026
clients/generated/README.md: both sides documented the generated/ freeze
policy (local: 'Freeze generated/ output', with checker + hooks; origin: PR #2's
shorter note). Kept the local text and appended the two sections only origin
had (gitignored trees, runtime contract cross-check).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G7RjB22qc4AaKq4zqeVBVY
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