docs: record slice 23 relay update

Author: rohans0509

docs/codealmanac-launch/next-agent-brief.md

@@ -10,39 +10,35 @@ verification, launch-folder updates, commit, and push.
 
 ## Last Completed Slice
 
-Slice 22 made `codealmanac init` the agent-backed first-build command and
-removed public `codealmanac build`.
+Slice 23 removed manual `ingest` and `garden` from the normal public top-level
+CLI and moved them under hidden `codealmanac dev`.
 
 Implemented:
 
-- `app.workflows.init.initialize_workspace(...)`
-- `app.workflows.init.run(...)`
-- `app.workflows.init.run_with_run(...)`
-- `RunOperation.INIT`
-- durable queued init specs
-- `RunQueueWorkflow.queue_init(...)`
-- `RunQueueWorkflow.start_init_background(...)`
-- public `codealmanac init` first-build flags
-- public `codealmanac build` parser removal
-- diagnostics and starter README text pointing to `codealmanac init`
+- hidden `codealmanac dev ingest <inputs...>`
+- hidden `codealmanac dev garden`
+- top-level parser/dispatch removal for `ingest` and `garden`
+- root argparse help filtering for `argparse.SUPPRESS` subcommands
+- README/public-contract examples for public local setup/update commands
+- architecture tests pinning `dev` as its own parser/dispatch domain
 
 Verified:
 
 ```text
-uv run pytest tests/test_init_workflow.py tests/test_cli.py tests/test_diagnostics.py tests/test_run_queue_workflow.py tests/test_runs_service.py tests/test_build_workflow.py tests/test_architecture.py
+uv run pytest tests/test_cli.py tests/test_architecture.py
+uv run pytest tests/test_public_contract.py tests/test_cli.py tests/test_architecture.py
 uv run pytest
 uv run ruff check .
 git diff --check
 uv run codealmanac --help
-uv run codealmanac init --help
+uv run codealmanac dev ingest --help
+uv run codealmanac dev garden --help
 ```
 
 ## Next Pressure Test
 
 Choose the next substantial slice from the launch plan. Good candidates:
 
-- finish the public launch CLI surface by hiding or dev-namespacing public
-  `ingest` and `garden` while preserving internal workflows
 - local run storage bridge from repo-local job files to the control DB, if
   needed for compatibility
 - cloud public API/auth slice in `codealmanac-hosted`
@@ -53,8 +49,9 @@ progress update, commit, and push.
 
 ## Known Repo State
 
-The branch is `dev`. At the end of Slice 22 verification it was ready to
-commit on top of `origin/dev`.
+The branch is `dev`. Slice 23 implementation commit `a58bdc43` is pushed to
+`origin/dev`. Start from the latest `origin/dev`, which includes the Slice 23
+bookkeeping commit once this brief is committed and pushed.
 
 The local wiki command currently fails on this checkout with:
 

docs/codealmanac-launch/progress.md

@@ -8,7 +8,7 @@ Percentages are planning estimates, not accounting metrics.
 
 ## Latest RelayForge Update
 
-Sent: 2026-07-02 after Slice 22 verification.
+Sent: 2026-07-02 after Slice 23 verification.
 
 Route:
 
@@ -26,8 +26,8 @@ It was not present in `codealmanac/prd` when checked.
 
 | Area | Latest | Previous | Basis |
 | --- | ---: | ---: | --- |
-| CodeAlmanac backend/local | 87% | 84% | Slice 22 added `InitWorkflow`, `RunOperation.INIT`, queued init specs, and shared page-run execution for first-build. |
-| CodeAlmanac CLI/public UX | 35% | 30% | `codealmanac init` is now the agent-backed first-build command and public `codealmanac build` is removed. |
+| CodeAlmanac backend/local | 87% | 87% | Slice 23 did not change local worker/control architecture. |
+| CodeAlmanac CLI/public UX | 40% | 35% | Slice 23 removed top-level `ingest`/`garden` from public help and moved the manual lifecycle surface under hidden `codealmanac dev`. |
 | CodeAlmanac-hosted backend/auth/API | 8% | 8% | WorkOS/Doppler setup and hosted rename groundwork exist; public API migration is not implemented yet. |
 | Hosted frontend/onboarding | 5% | 5% | Existing frontend is deployed under CodeAlmanac; new onboarding/configuration screens are not implemented yet. |
 | Infra/deploy rename | 5% | 5% | GitHub rename, Modal, Render, Vercel production deploy, and health checks were exercised; durable cleanup remains. |

docs/codealmanac-launch/worklog.md

@@ -473,3 +473,26 @@
   CodeAlmanac backend/local 87%, CLI/public UX 35%,
   CodeAlmanac-hosted backend/auth/API 8%, hosted frontend/onboarding 5%, and
   infra/deploy rename 5%.
+- Planned Slice 23 in
+  `docs/plans/2026-07-02-slice-23-dev-lifecycle-cli.md`.
+- Added a hidden `codealmanac dev` parser and dispatch namespace.
+- Moved manual `ingest` and `garden` CLI access to
+  `codealmanac dev ingest` and `codealmanac dev garden`.
+- Removed top-level `ingest` and `garden` from lifecycle parser and dispatch.
+- Fixed root argparse help so commands registered with `argparse.SUPPRESS`
+  do not print as `==SUPPRESS==` in normal top-level help.
+- Updated README update examples to use public local commands:
+  `local setup`, `local update`, local trigger policy, and local jobs.
+- Verified Slice 23 focused behavior with
+  `uv run pytest tests/test_cli.py tests/test_architecture.py` (`113
+  passed`) and
+  `uv run pytest tests/test_public_contract.py tests/test_cli.py tests/test_architecture.py`
+  (`140 passed`).
+- Verified Slice 23 full gate with `uv run pytest` (`466 passed`),
+  `uv run ruff check .`, `git diff --check`, `uv run codealmanac --help`,
+  `uv run codealmanac dev ingest --help`, and
+  `uv run codealmanac dev garden --help`.
+- Sent the Slice 23 RelayForge update and recorded progress as:
+  CodeAlmanac backend/local 87%, CLI/public UX 40%,
+  CodeAlmanac-hosted backend/auth/API 8%, hosted frontend/onboarding 5%, and
+  infra/deploy rename 5%.