secrets-engine/.claude/rules/stack-and-commands.md at 864383c7b520a279e22ec81a6ec2f7e6d79aff09

tegwick a852d3f1ff feat(mvp): working secrets-engine CLI for the whynot-design npm publish lane

Implements SECRETS-WP-0002 end to end as a uv-managed Python package:

- catalog: non-secret lane registry + strict validator (build/test/prod)
- stage roles + OpenBao ACL policies; guards refuse wildcards, sys/, identity/,
  admin names, and cross-stage paths before any backend call
- plan/apply: dry-run-first, idempotent policy + approle apply, decision-gated
- decisions: State Hub lookup with local-fixture fallback; non-secret evidence
  to JSONL + hub progress, scrubbed of any value
- provision/verify: mode-0600 file import + generated test values; positive/
  negative checks that never print the value
- exec delivery: `exec --catalog ... -- npm publish` injects the token via a
  temp .npmrc for the child only, cleaned up on exit/failure/interrupt
- ops-warden routing contract + hardening backlog docs
- 34 tests incl. live OpenBao integration; scripts/demo-e2e.sh runs the full
  chain against a throwaway bao dev server

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-28 12:28:45 +02:00

969 B

Raw Blame History

Stack

Language: Python 3.11+ CLI (src/secrets_engine/), uv-managed, hatchling build
Backend: OpenBao, reached only via the bao CLI adapter (openbao.py)
Key deps: PyYAML (runtime), pytest (dev); State Hub for decisions/evidence
Entry point: secrets-engine (console script → secrets_engine.cli:main)

Dev Commands

# Install (editable, with dev extras)
uv venv && uv pip install -e ".[dev]"
source .venv/bin/activate

# Run the CLI
secrets-engine --version
secrets-engine catalog list

# Test (unit + live OpenBao integration; integration auto-skips without `bao`)
SECRETS_ENGINE_HUB_URL="" python -m pytest -q

# Full pilot chain live against a throwaway OpenBao dev server
SECRETS_ENGINE_HUB_URL="" bash scripts/demo-e2e.sh

# Orient (offline-safe)
cat .custodian-brief.md
ls workplans/

# After workplan edits — from ~/state-hub
make fix-consistency REPO=secrets-engine

# Sanity-check edits
git diff --check

969 B Raw Blame History

Stack

Dev Commands

969 B

Raw Blame History