Skip to content

refarch: create labs namespace for experimental commands (Issue #ARCH-13)#1005

Merged
arockwell merged 1 commit intomainfrom
feature/get-to-1-0
Mar 7, 2026
Merged

refarch: create labs namespace for experimental commands (Issue #ARCH-13)#1005
arockwell merged 1 commit intomainfrom
feature/get-to-1-0

Conversation

@arockwell
Copy link
Owner

Summary

  • Create emdx labs namespace for experimental commands, establishing a clean 1.0 API surface
  • Move 7 experimental top-level commands under labs: wiki, explore, distill, compact, briefing, serve, context
  • Extract AI-powered find flags (--ask, --think, --debug, --wander, --watch) into dedicated labs ask, labs wander, labs watch commands — find goes from 30+ flags to ~20
  • Move experimental maintain subcommands (drift, gaps, contradictions, code-drift, wikify, entities, cloud-backup) to labs maintain
  • All labs commands print a stderr warning: "experimental command — may change or be removed"
  • Top-level commands reduced from 23 to 18

Stable 1.0 surface

save, find, view, edit, delete, gist, tag, task, db, status, prime, stale, touch, trash, history, diff, maintain, gui

Experimental (labs)

ask, wander, watch, wiki, explore, distill, compact, context, briefing, serve, maintain (experimental subcommands)

Test plan

  • 2036 tests pass, 0 failures
  • ruff check and ruff format clean
  • mypy passes (pre-commit hook)
  • emdx --help shows 18 stable commands + labs
  • emdx labs --help shows all experimental commands
  • emdx labs wiki --help prints experimental warning
  • emdx labs ask "question" works (was find --ask)
  • emdx find --help shows clean flag set without AI modes
  • emdx maintain --help shows only stable subcommands
  • emdx labs maintain --help shows moved experimental subcommands

🤖 Generated with Claude Code

…-13)

Move experimental/unstable commands behind `emdx labs` to establish a
clean, committed API surface for 1.0. Stable commands remain at top level.

Moved to `emdx labs`:
- wiki (entire group), explore, distill, compact, briefing, serve, context
- find --ask/--think/--debug/--wander/--watch → labs ask/wander/watch
- maintain drift/gaps/contradictions/code-drift/wikify/entities/cloud-backup
  → labs maintain

Stable top-level commands (18): save, find, view, edit, delete, gist, tag,
task, db, status, prime, stale, touch, trash, history, diff, maintain, gui

All labs commands print a stderr warning on use. find retains --context.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@arockwell arockwell merged commit ab1e14d into main Mar 7, 2026
5 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.

1 participant