tools — com.wagoe/wagoe-observability 1.1.0-rc-1

tools

Babashka-powered developer tooling for the Wagoe framework. Available out of the box in every Wagoe project via bb.edn — no separate install needed.

Published to Clojars as com.wagoe/wagoe-tools, in lockstep with the rest of the suite. Dev-only describes when you use it — inside this monorepo it is consumed through the :local/root dep in bb.edn at libs/tools.

Commands

Config & Environment

bb doctor                    # Validate config (`bb doctor --help` lists the checks)
bb doctor --env all --ci     # Check all envs, exit non-zero on error
bb setup                     # Interactive config setup wizard
bb setup --database postgresql --payment stripe  # Non-interactive
bb setup ai "PostgreSQL with Stripe payments"    # AI-powered setup

Scaffolding

bb scaffold                          # Interactive module generation wizard
bb scaffold ai "product module with name, price, stock"  # NL scaffolding
bb scaffold integrate product        # Wire scaffolded module into project
bb scaffold integrate product --dry-run  # Preview changes only

AI Tooling

bb ai explain --file stacktrace.txt          # Explain error
bb ai gen-tests libs/user/src/.../validation.clj  # Generate test namespace
bb ai sql "find active users last 7 days"    # NL → HoneySQL
bb ai docs --module libs/user --type agents  # Generate AGENTS.md
bb ai admin-entity "products with name, price, status"  # Generate admin entity EDN

bb ai admin-entity and bb scaffold ai ask before writing. Without a terminal — in a script or CI — they refuse unless you pass --yes (write) or --force (overwrite), neither of which prompts.

Deployment (framework repository only)

These publish the Wagoe libraries themselves and exist only in the framework repository — a project created by wagoe new has no bb deploy task.

bb deploy --all              # Deploy all 33 libraries to Clojars
bb deploy --missing          # Deploy only unpublished versions
bb deploy core platform user # Deploy specific libraries

Requires CLOJARS_USERNAME and CLOJARS_PASSWORD environment variables.

i18n Management

bb i18n:find "Sign in"       # Find key by substring
bb i18n:scan                 # Scan for unexternalised strings (CI gate)
bb i18n:missing              # Keys in en.edn missing from other locales
bb i18n:unused               # Catalogue keys not referenced in source

Utilities

bb create-admin              # Create first admin user (interactive)
bb migrate up                # Run database migrations
bb db:reset                  # Drop the app's tables and migrate (dev, test, acc only)
bb check-links               # Validate AGENTS.md local links
bb smoke-check               # Verify deps.edn aliases and tool entrypoints
bb install-hooks             # Configure git hooks path to .githooks

Doctor checks

Check Level What it catches

Check	Level	What it catches
`config-loadable`	error	`config.edn` does not parse, or has no `:active` section
`env-refs`	error	`#env VAR` without `#or` fallback and not set. A warning instead when the setting is optional: inside a `:fallback` block, or a Redis `:password`
`secret-refs`	error	`#secret` references with no default that resolve to nothing
`providers`	error	Unknown `:provider` values
`jwt-secret`	error	`JWT_SECRET` not set when user module is active, in config or through `:extra-modules` in `system_config.clj`
`admin-parity`	warn	Admin entity EDN mismatch between dev and test
`prod-placeholders`	error	Placeholder values in prod/acc configs
`reset-endpoint-flag`	error	`:test/reset-endpoint-enabled?` true outside the profiles that allow it
`upgrade-wiring`	error	A namespace that moved between releases, and where it went

config-loadable

error

config.edn does not parse, or has no :active section

env-refs

error

#env VAR without #or fallback and not set. A warning instead when the setting is optional: inside a :fallback block, or a Redis :password

secret-refs

error

#secret references with no default that resolve to nothing

providers

error

Unknown :provider values

jwt-secret

error

JWT_SECRET not set when user module is active, in config or through :extra-modules in system_config.clj

admin-parity

warn

Admin entity EDN mismatch between dev and test

prod-placeholders

error

Placeholder values in prod/acc configs

reset-endpoint-flag

error

:test/reset-endpoint-enabled? true outside the profiles that allow it

upgrade-wiring

error

A namespace that moved between releases, and where it went

--edn prints the results as data instead of for a person; that is what wagoe doctor reads so it can end with a single next action.

Key namespaces

Namespace Purpose

Namespace	Purpose
`wagoe.tools.scaffold`	Scaffolding wizards + AI passthrough + integrate dispatch
`wagoe.tools.ai`	AI CLI frontend (explain, gen-tests, sql, docs, admin-entity)
`wagoe.tools.doctor`	Config Doctor — rule-based config checks
`wagoe.tools.setup`	Config Setup Wizard — interactive + template-based
`wagoe.tools.integrate`	Module Integration — write the config key into config.edn
`wagoe.tools.deploy`	Clojars deployment for all 33 published artifacts
`wagoe.tools.i18n`	i18n catalogue management (find/scan/missing/unused)
`wagoe.tools.admin`	First admin user creation wizard
`wagoe.tools.dev`	migrate + check-links + smoke-check + install-hooks

wagoe.tools.scaffold

Scaffolding wizards + AI passthrough + integrate dispatch

wagoe.tools.ai

AI CLI frontend (explain, gen-tests, sql, docs, admin-entity)

wagoe.tools.doctor

Config Doctor — rule-based config checks

wagoe.tools.setup

Config Setup Wizard — interactive + template-based

wagoe.tools.integrate

Module Integration — write the config key into config.edn

wagoe.tools.deploy

Clojars deployment for all 33 published artifacts

wagoe.tools.i18n

i18n catalogue management (find/scan/missing/unused)

wagoe.tools.admin

First admin user creation wizard

wagoe.tools.dev

migrate + check-links + smoke-check + install-hooks

`Ctrl`+`k`	Jump to recent docs
`←`	Move to previous article
`→`	Move to next article
`Ctrl`+`/`	Jump to the search field