@decantr/cli 2.7.0 → 2.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +9 -7
- package/dist/bin.js +1 -1
- package/dist/{chunk-ZYHR3BGT.js → chunk-QTPNV5WU.js} +798 -271
- package/dist/index.js +1 -1
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -20,7 +20,7 @@ npx @decantr/cli new my-app --blueprint=esports-hq
|
|
|
20
20
|
Use `decantr setup` when you are unsure which path applies. It detects whether the repo is empty, already attached, or a Brownfield app and recommends the next command.
|
|
21
21
|
Use `decantr new` for a greenfield workspace in a fresh directory. With a blueprint/archetype it uses the runnable adapter and Decantr CSS; without registry content it creates a contract-only workspace unless you explicitly pass `--adoption=decantr-css`.
|
|
22
22
|
Use `decantr adopt` when you already have an app and want Decantr governance without adopting a blueprint. Brownfield attach is proposal-driven: Decantr inventories the app, writes an observed essence proposal, and only applies it when you explicitly accept or merge it.
|
|
23
|
-
Use `decantr task` before asking an LLM to modify a route, and `decantr verify` after the edit. Use `decantr codify` when you want project-owned UI patterns such as
|
|
23
|
+
Use `decantr task` before asking an LLM to modify a route, and `decantr verify` after the edit. Use `decantr codify --from-audit` when you want project-owned UI patterns and local rules such as button/card/shell/theme standards to appear in future task context and verification.
|
|
24
24
|
Use `decantr init`, `decantr analyze`, `decantr check`, and `decantr health` as advanced primitives when you need direct control over one step.
|
|
25
25
|
|
|
26
26
|
Current starter adapter availability:
|
|
@@ -39,10 +39,10 @@ Explicit workflow/adoption flags:
|
|
|
39
39
|
```bash
|
|
40
40
|
decantr setup
|
|
41
41
|
decantr adopt --base-url http://localhost:3000 --evidence --yes
|
|
42
|
-
decantr
|
|
43
|
-
decantr verify --brownfield
|
|
44
|
-
decantr codify
|
|
42
|
+
decantr codify --from-audit
|
|
45
43
|
decantr codify --accept
|
|
44
|
+
decantr task /feed "add saved recipe actions"
|
|
45
|
+
decantr verify --brownfield --local-patterns
|
|
46
46
|
decantr init --workflow=greenfield --adoption=contract-only
|
|
47
47
|
decantr analyze
|
|
48
48
|
decantr init --existing --accept-proposal
|
|
@@ -65,7 +65,7 @@ Monorepos store both `workspaceRoot` and `appRoot`. In non-interactive workspace
|
|
|
65
65
|
|
|
66
66
|
Assistant rule integration is preview-first: `--assistant-bridge=preview` writes `.decantr/context/assistant-bridge.md`, `decantr rules preview` prints the bridge, and `--assistant-bridge=apply` or `decantr rules apply` mutates supported rule files with idempotent marked blocks.
|
|
67
67
|
|
|
68
|
-
Brownfield analysis also writes `.decantr/doctrine-map.json`, a ranked source-precedence map across security/data, architecture, design-system, workflow/CI, feature/business, assistant-specific, stale, and unsafe-to-cite evidence. It also writes `.decantr/brownfield-intelligence.json`, `.decantr/theme-inventory.json`, and `.decantr/enrichment-backlog.md`. The proposal groups routes into observed semantic domains such as auth, RBAC, billing, reporting, facilities, settings, and public surfaces across Next App/Pages Router, React Router, Angular Router, SvelteKit, Vue Router, and Nuxt file routes. Existing styling systems such as Tailwind, Bootstrap, MUI, Chakra, plain CSS, and Decantr CSS are observed as evidence instead of replaced. Theme variants are observed in the theme inventory without changing Essence V4. `decantr verify --brownfield` uses the Brownfield guard layer to flag actionable missing doctrine coverage, unsafe context, missing assistant bridges, style drift, and unsafe defaults without treating current database migrations as stale docs.
|
|
68
|
+
Brownfield analysis also writes `.decantr/doctrine-map.json`, a ranked source-precedence map across security/data, architecture, design-system, workflow/CI, feature/business, assistant-specific, stale, and unsafe-to-cite evidence. It also writes `.decantr/brownfield-intelligence.json`, `.decantr/theme-inventory.json`, and `.decantr/enrichment-backlog.md`. The proposal groups routes into observed semantic domains such as auth, RBAC, billing, reporting, facilities, settings, and public surfaces across Next App/Pages Router, React Router, Angular Router, SvelteKit, Vue Router, and Nuxt file routes. Existing styling systems such as Tailwind, Bootstrap, MUI, Chakra, plain CSS, and Decantr CSS are observed as evidence instead of replaced. Theme variants are observed in the theme inventory without changing Essence V4. `decantr codify --from-audit` proposes `.decantr/local-patterns.proposal.json` and `.decantr/rules.proposal.json`; after review, `decantr codify --accept` promotes `.decantr/local-patterns.json` and `.decantr/rules.json`. `decantr verify --brownfield --local-patterns` uses the Brownfield guard layer plus accepted local law to flag actionable missing doctrine coverage, unsafe context, missing assistant bridges, style drift, raw local-rule violations, and unsafe defaults without treating current database migrations as stale docs.
|
|
69
69
|
|
|
70
70
|
## What It Does
|
|
71
71
|
|
|
@@ -87,9 +87,10 @@ Brownfield analysis also writes `.decantr/doctrine-map.json`, a ranked source-pr
|
|
|
87
87
|
decantr setup
|
|
88
88
|
decantr new my-app --blueprint=esports-hq
|
|
89
89
|
decantr adopt --base-url http://localhost:3000 --evidence --yes
|
|
90
|
+
decantr codify --from-audit
|
|
91
|
+
decantr codify --accept
|
|
90
92
|
decantr task /feed "add saved recipe actions"
|
|
91
93
|
decantr verify --brownfield --local-patterns
|
|
92
|
-
decantr codify
|
|
93
94
|
decantr init --existing --blueprint=esports-hq
|
|
94
95
|
decantr init --workflow=greenfield --adoption=contract-only
|
|
95
96
|
decantr rules preview
|
|
@@ -114,13 +115,14 @@ decantr showcase verification --json
|
|
|
114
115
|
|
|
115
116
|
## Project Health And Studio
|
|
116
117
|
|
|
117
|
-
`decantr verify` is the workflow command most users should run locally and in CI. It delegates to Project Health, can add Brownfield guard validation with `--brownfield`, requires an accepted local pattern pack with `--local-patterns`, supports workspace mode, and writes evidence to `.decantr/evidence/latest.json` by default when `--evidence` is used.
|
|
118
|
+
`decantr verify` is the workflow command most users should run locally and in CI. It delegates to Project Health, can add Brownfield guard validation with `--brownfield`, requires an accepted local pattern pack with `--local-patterns`, scans `.decantr/rules.json` when present, supports workspace mode, and writes evidence to `.decantr/evidence/latest.json` by default when `--evidence` is used.
|
|
118
119
|
|
|
119
120
|
`decantr health` remains the advanced project observability primitive. It composes the existing verifier audit, guard checks, brownfield route drift checks, runtime evidence, and execution-pack files into a `ProjectHealthReport` with a status, score, route summary, pack summary, findings, and AI-ready remediation prompts.
|
|
120
121
|
|
|
121
122
|
```bash
|
|
122
123
|
decantr verify
|
|
123
124
|
decantr verify --brownfield --local-patterns
|
|
125
|
+
decantr verify --brownfield --local-patterns --fail-on warn
|
|
124
126
|
decantr verify --base-url http://localhost:3000 --evidence
|
|
125
127
|
decantr verify --since-baseline
|
|
126
128
|
decantr verify init-ci --project apps/registry
|
package/dist/bin.js
CHANGED