Skip to content

docs(cleanup): remove implemented/outdated plans, keep roadmap + 4.x backlog - #3452

Merged
bpamiri merged 1 commit into
developfrom
docs/plans-cleanup
Aug 30, 2026
Merged

bpamiri merged 1 commit into
developfrom
docs/plans-cleanup

Conversation

@bpamiri

@bpamiri bpamiri commented Aug 30, 2026

Copy link
Copy Markdown
Collaborator

Summary

Cleanup of the plans/docs corpus after a full audit against the live codebase. Everything audited was either shipped or deliberately superseded; the genuinely-open items are consolidated into two forward-looking files. −56,060 lines.

Kept (2 files)

  • docs/releases/wheels-5-roadmap.md — updated: audit-note header, RustCFML paragraph corrected (it graduated to a supported engine with a required PR check after the roadmap was written), scheduled-matrix wording (weekly cron, not nightly).
  • docs/releases/wheels-4.x-backlog.md — new: every not-yet-implemented item from the removed plans:
    • wheels dbmigrate diff CLI (framework layer shipped; command never wired into the live CLI)
    • framework gaps from the guides phase-1 rewrite (bcrypt helper, wheels.auth.enableSession, migrate --offline, generate --dry-run, route bindBy=, DI toFactory(), i18n, services.cfm stub, stale user-mailer.txt snippet)
    • bot-pipeline squash-only repo setting (allow_merge_commit=false)
    • deploy-secrets flat-alias specs (still xdescribed)
    • version-surface unification (0.0.0-dev debug bar)
    • Kamal Boot.cfc, RocketUnit deprecation warning, empty packages/ shells, vestigial wheels-cli-lucli repo
    • uncertain items (stripTags/stripLinks encoding default, LuCLI upstream race/PR)

Removed (implemented / outdated / superseded)

  • docs/superpowers/ — all plans, specs, and artifacts
  • docs/plans/ — superseded phase-1 verify plan
  • .grove/ — superseded W-007 LuCLI distribution plan + session summary
  • cli/lucli/PLAN.md — superseded by the shipped distribution work
  • docs/AI_INTEGRATION_GUIDE.md — outdated (described the retired node MCP server; canonical surface is wheels mcp wheels), removed from the artifact allowlist

Reference updates

AGENTS.md index, consumer-ai + scaffold-template AGENTS.md/CLAUDE.md (dead guide link removed), v3.0.0 MCP guide link, prepare-core.sh allowlist, ship-consumer-docs.sh / prepare-starterApp.sh / deploy-config-diff.sh comments, release.yml / deploy-ci.yml comments, .ai/wheels/deploy.md related links, wheels-vs-frameworks.md dbmigrate diff claim, wheels-3.0-vs-4.0.md upgrade-guide pointer.

docs/releases/wheels-4.0-audit.md and wheels-3.0-vs-4.0.md stay: CHANGELOG and published blog posts link to the audit as the 4.0 receipt.

ship-consumer-docs.sh check passes; the defensive leak-check patterns for the removed dirs are intentionally left in place.

…backlog

Audit of the plans/specs corpus against the live codebase found
everything either shipped or deliberately superseded, with a small set
of genuinely-open items. Consolidate into two forward-looking files:

- docs/releases/wheels-5-roadmap.md — kept and updated: audit-note header,
  RustCFML paragraph corrected (now a supported engine with a required
  PR check), scheduled-matrix wording (weekly cron, not nightly).
- docs/releases/wheels-4.x-backlog.md — NEW: every not-yet-implemented
  item from the removed plans (wheels dbmigrate diff CLI, framework
  gaps from the guides phase-1 rewrite, bot-pipeline squash-only
  setting, deploy-secrets disabled specs, version-surface unification,
  Kamal Boot.cfc, RocketUnit deprecation warning, and more).

Removed (-56k lines): docs/superpowers/ (plans, specs, artifacts),
docs/plans/, .grove/, cli/lucli/PLAN.md, and the outdated
docs/AI_INTEGRATION_GUIDE.md (superseded by the wheels mcp stdio
surface).

Reference updates: AGENTS.md index, consumer-ai/template AGENTS+CLAUDE
(dead guide link removed), v3.0.0 MCP guide link, prepare-core.sh
allowlist, ship-consumer-docs/prepare-starterApp/deploy-config-diff
comments, release.yml/deploy-ci.yml comments, .ai/wheels/deploy.md
related links, wheels-vs-frameworks.md dbmigrate claim, and the
3.0-vs-4.0 upgrade-guide pointer.

wheels-4.0-audit.md and wheels-3.0-vs-4.0.md are kept as historical
records — CHANGELOG and published blog posts link to the audit.

Signed-off-by: Peter Amiri <peter@alurium.com>
@github-actions github-actions Bot added the docs label Aug 30, 2026
@bpamiri
bpamiri merged commit c8c22ac into develop Aug 30, 2026
18 checks passed
@bpamiri
bpamiri deleted the docs/plans-cleanup branch August 30, 2026 19:29
bpamiri added a commit that referenced this pull request Aug 31, 2026
Records the bcrypt helper's RustCFML native-builtin path and credits
the full 4.x-backlog branch series (#3452-#3455).

Signed-off-by: Peter Amiri <peter@alurium.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant