Skip to content

chore: retire 9 one-shot authoring scripts (closes #6)#11

Merged
ulises-jeremias merged 2 commits into
mainfrom
chore/retire-one-shot-scripts
May 22, 2026
Merged

chore: retire 9 one-shot authoring scripts (closes #6)#11
ulises-jeremias merged 2 commits into
mainfrom
chore/retire-one-shot-scripts

Conversation

@ulises-jeremias
Copy link
Copy Markdown
Member

Closes #6.

Per the audit on #6, retiring the 9 one-shot authoring scripts that bootstrapped the initial 16-module structure. None of them are referenced by CI / workflows / Makefile / pyproject; only 3 doc references in GETTING_STARTED.md (updated here).

What changes

Deleted:

  • scripts/complete_module_content.py
  • scripts/complete_module_readmes.py
  • scripts/fix_remaining_placeholders.py
  • scripts/generate_modulo_14.py
  • scripts/generate_modulo_16.py
  • scripts/generate_patrones.py
  • scripts/populate_content.py
  • scripts/update_readmes.py
  • scripts/update_references.py

Updated:

  • GETTING_STARTED.md — tree diagram now lists only the maintained scripts (progress.py, generate_structure.py, validate_all_modules.py, validate_ci_gate.py, link_check.py).

Added:

  • scripts/RETIRED.md — explains the retirement and points to the canonical authoring flow.

Verification

  • git grep against main post-Charter merge confirms 0 references in CI / workflows / Makefile / pyproject for the retired scripts.
  • The 3 doc references in GETTING_STARTED.md are removed in this PR.
  • The Charter v1.1 tracker (nan-ai-native-engineering-labs#2 item 3) calls out this exact policy. This PR is the first concrete application.

These scripts were used to bootstrap the initial 16 modules / 379 topics
and have been unmaintained since. The audit on issue #6 confirmed:

- 0 references in CI / workflows / Makefile / pyproject.
- 3 references in docs (GETTING_STARTED.md only) — updated here.

Retired scripts:

- scripts/complete_module_content.py
- scripts/complete_module_readmes.py
- scripts/fix_remaining_placeholders.py
- scripts/generate_modulo_14.py
- scripts/generate_modulo_16.py
- scripts/generate_patrones.py
- scripts/populate_content.py
- scripts/update_readmes.py
- scripts/update_references.py

Documentation:

- Update GETTING_STARTED.md tree diagram to list the maintained scripts
  (progress, generate_structure, validate_all_modules, validate_ci_gate,
  link_check).
- Add scripts/RETIRED.md explaining the retirement and pointing to the
  canonical authoring flow in AGENTS.md / docs/CHARTER.md.

Closes #6.

Per Charter v1.1 follow-up tracker (nan-ai-native-engineering-labs#2,
item 3) this establishes the 'one-shot scripts get retired with
documented audit, not silently' pattern for sibling labs.
Dependabot's auto-merge workflow merged PR #10 which bumped the
bcrypt constraint from <5 to <6. bcrypt 5.x dropped __about__,
which passlib 1.7.x relies on for version detection. Result is
'(trapped) error reading bcrypt version' on the
12_fastapi_complete/{authentication_jwt,oauth2,redis_caching}
topics, breaking validate-all-modules on main.

This PR rolls the constraint back to <5 to restore CI green.

Follow-up: tighten the auto-merge workflow to NOT auto-merge
Dependabot PRs that touch security/auth-adjacent dependencies
without a passing E2E run on the affected topics. Filing
separately.
@ulises-jeremias ulises-jeremias merged commit e198d22 into main May 22, 2026
2 checks passed
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.

chore: retire one-shot authoring scripts in scripts/

1 participant