@decantr/cli 3.6.2 → 3.7.0

package/README.md

@@ -19,11 +19,11 @@ npx @decantr/cli new my-app --blueprint=esports-hq
 ```
 
 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 right entry path.
-Use `decantr scan` when you want a zero-commit Brownfield preview. It reads local files, detects framework/routes/styling/static-hosting/assistant-rule signals, previews typed Contract graph readiness in memory when a Decantr contract already exists, reports the contract capsule source-handle count and limit, prints a terminal report, and writes no `.decantr` files or report artifacts. Add `--json` when automation needs the `ScanReportV1` payload.
+Use `decantr scan` when you want a zero-commit Brownfield preview. It reads local files through the shared verifier discovery substrate, detects workspace/app scope, package manager, framework, language, route signals, taskable routes, component inventory confidence, styling/static-hosting/assistant-rule signals, previews typed Contract graph readiness in memory when a Decantr contract already exists, reports the contract capsule source-handle count and limit, prints a terminal report, and writes no `.decantr` files or report artifacts. Add `--json` when automation needs the `ScanReportV2` payload.
 Use `decantr new` for a greenfield workspace in a fresh directory. With a starter-kit blueprint or archetype it uses the runnable adapter and Decantr CSS; without certified vocabulary content it creates a contract-only workspace unless you explicitly pass `--adoption=decantr-css`.
 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, hydrates hosted execution packs when online, and only applies the contract when you explicitly accept or merge it.
 Use `decantr studio` after adoption when you want a local Control Room for routes, findings, evidence, authority, and next actions. Use `decantr connect cursor` when the opened workspace should get Cursor Agent MCP and project-rule activation; in monorepos use `decantr connect cursor --project apps/web` so the rule keeps the app scope. Use `decantr doctor` when the next step is unclear, `decantr task <route> "<intent>"` before asking an LLM to modify a route, `decantr verify` after the edit, `decantr resolve` when source and contract disagree, and `decantr ci` in required automation. If runtime source and Decantr context disagree, report the drift instead of guessing; in Brownfield the existing source is observed truth, accepted local law/style bridge is project authority where present, Essence V4 is the structural contract, and hosted packs stay advisory until mapped into local law. Use `decantr graph` when you want the Decantr 3 typed Contract graph, typed graph diff summary, manifest, content-addressed snapshot history, and cache-friendly contract capsule written under `.decantr/graph`; the capsule includes a bounded SourceArtifact path index so agents can discover valid file-impact handles without reading the full snapshot, and `--capsule-source-limit <count>` can tune that index for large repos. Add `--route /feed --task "improve loading" --json` when you want the exact task-ranked route-scoped subgraph an agent should inspect before editing, `--node cmp:button --impact --json` when you need the graph-shaped blast radius for a component, token, rule, finding, or source artifact, or `--file src/app/page.tsx --impact --json` when the agent knows the source file it is about to change. Route and impact ranking use deterministic weighted traversal plus local personalized PageRank and task boosts. Use `--snapshot-id <id>` to inspect a replayable history snapshot and `--compare-to <id> --include-diff-ops --json` to compare the selected/current graph against a prior snapshot. Use `decantr codify --from-audit --style-bridge` when you want project-owned UI patterns, optional `behavior_obligations`, local rules, and token/class bridge mappings such as button/card/shell/theme standards to appear in future task context and verification. Once accepted, that local law is the first Hybrid lane: the app still owns source and styling, but Decantr treats accepted local patterns, behavior obligations, rules, and style bridge mappings as project authority.
-In monorepos, app-scoped commands accept `--project <app-path>`. `setup` shows attach guidance before adoption and the day-two loop after adoption. Candidate discovery ranks product UI apps ahead of docs, Storybook, API, MCP helper, workbench, and package surfaces; `decantr workspace list --json` includes rank, category, score, and reason metadata so automation can explain why `apps/web`, `apps/remix`, or `apps/dashboard` was suggested first. Hosted pack hydration also follows the essence path: `decantr registry compile-packs apps/web/decantr.essence.json --write-context` writes into `apps/web/.decantr/context`. In contract-only/offline Brownfield, deferred hosted packs are optional context unless a present manifest references missing files.
+In monorepos, app-scoped commands accept `--project <app-path>`. `setup` shows attach guidance before adoption and the day-two loop after adoption. Candidate discovery ranks product UI apps ahead of docs, Storybook, API, MCP helper, workbench, and package surfaces; `decantr workspace list --json` includes rank, category, score, and reason metadata so automation can explain why `apps/web`, `apps/remix`, or `apps/dashboard` was suggested first. Once an app path is selected, scan/setup/adopt/doctor/task/verify/ci/connect preserve that app scope and inherit package-manager evidence from the workspace root, so a React app inside a pnpm Angular/React monorepo is reported as the React app, not the root or sibling app. Hosted pack hydration also follows the essence path: `decantr registry compile-packs apps/web/decantr.essence.json --write-context` writes into `apps/web/.decantr/context`. In contract-only/offline Brownfield, deferred hosted packs are optional context unless a present manifest references missing files.
 Use `decantr init`, `decantr analyze`, `decantr check`, and `decantr health` as advanced primitives when you need direct control over one step.
 
 App-scoped primitives now share the same `--project` posture as the primary workflow commands. From a workspace root, `health`, `status`, `upgrade`, `add`, `remove`, `theme`, `export`, `suggest`, `magic`, `rules`, and `telemetry` target the selected app instead of the root. Task/read paths, local-law summaries, and refresh change summaries are printed as openable workspace paths. Nonexistent project paths fail immediately, and Brownfield adoption refuses component packages unless you intentionally pass `--force-package`.
@@ -102,6 +102,7 @@ Assistant rule integration is preview-first: `--assistant-bridge=preview` writes
 
 - scaffolds Decantr projects from blueprints, archetypes, or prompts
 - previews existing apps with read-only Brownfield scan reports
+- emits `scan-report.v2` JSON with discovery evidence, app scope, route signal/taskable route counts, component inventory confidence, and limitations
 - guides users through human workflow commands: setup, adopt, doctor, task, verify, ci, codify, and connect
 - supports explicit workflow lanes: greenfield blueprint, greenfield contract-only, brownfield adoption, Hybrid local law, Hybrid style bridge, Hybrid Decantr CSS, and hybrid composition
 - ranks monorepo app candidates with explainable metadata so product UI apps come before docs, Storybook, API, helper packages, and workbench surfaces

package/dist/bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import "./chunk-4HFBFQNN.js";
-import "./chunk-SIDKK73N.js";
+import "./chunk-O7N4CCWS.js";
+import "./chunk-NDH3BDXY.js";
 import "./chunk-56HUEUO3.js";
 import "./chunk-WAGVDMJV.js";
 import "./chunk-24JR4ZNG.js";

package/dist/{chunk-SIDKK73N.js → chunk-NDH3BDXY.js}

@@ -5075,65 +5075,65 @@ function generateSyntheticSlots(patternId, description) {
   const desc = description.toLowerCase();
   const syntheticSlots = {};
   if (patternId.includes("feature") || desc.includes("feature")) {
-    syntheticSlots["grid"] = "Grid of feature cards (icon + title + description)";
+    syntheticSlots.grid = "Grid of feature cards (icon + title + description)";
     syntheticSlots["feature-card"] = "Individual feature with icon, heading, and description text";
   }
   if (patternId.includes("pricing") || desc.includes("pricing")) {
-    syntheticSlots["tiers"] = "Pricing tier cards (name, price, features list, CTA button)";
-    syntheticSlots["toggle"] = "Monthly/annual billing toggle (optional)";
+    syntheticSlots.tiers = "Pricing tier cards (name, price, features list, CTA button)";
+    syntheticSlots.toggle = "Monthly/annual billing toggle (optional)";
   }
   if (patternId.includes("testimonial") || desc.includes("testimonial")) {
-    syntheticSlots["quotes"] = "Testimonial cards (quote text, author name, role, avatar)";
+    syntheticSlots.quotes = "Testimonial cards (quote text, author name, role, avatar)";
   }
   if (patternId.includes("cta") || desc.includes("call-to-action") || desc.includes("call to action")) {
-    syntheticSlots["headline"] = "CTA headline text";
-    syntheticSlots["description"] = "Supporting description text";
-    syntheticSlots["actions"] = "CTA button(s)";
+    syntheticSlots.headline = "CTA headline text";
+    syntheticSlots.description = "Supporting description text";
+    syntheticSlots.actions = "CTA button(s)";
   }
   if (patternId.includes("how-it-works") || desc.includes("how it works") || desc.includes("timeline") || desc.includes("steps")) {
-    syntheticSlots["steps"] = "Numbered steps (step number, title, description)";
+    syntheticSlots.steps = "Numbered steps (step number, title, description)";
   }
   if (patternId.includes("team") || desc.includes("team")) {
-    syntheticSlots["members"] = "Team member cards (avatar, name, role)";
+    syntheticSlots.members = "Team member cards (avatar, name, role)";
   }
   if (patternId.includes("story") || desc.includes("story") || desc.includes("about")) {
-    syntheticSlots["content"] = "Story/about narrative text content";
+    syntheticSlots.content = "Story/about narrative text content";
   }
   if (patternId.includes("values") || desc.includes("values")) {
-    syntheticSlots["values"] = "Value cards (icon/emoji, title, description)";
+    syntheticSlots.values = "Value cards (icon/emoji, title, description)";
   }
   if (patternId.includes("form") || desc.includes("form") || desc.includes("contact")) {
-    syntheticSlots["fields"] = "Form fields (name, email, message, etc.)";
-    syntheticSlots["submit"] = "Submit button";
+    syntheticSlots.fields = "Form fields (name, email, message, etc.)";
+    syntheticSlots.submit = "Submit button";
   }
   if (patternId.includes("content") || desc.includes("legal") || desc.includes("privacy") || desc.includes("policy")) {
-    syntheticSlots["body"] = "Long-form text content with headings and paragraphs";
-    syntheticSlots["toc"] = "Table of contents sidebar (optional)";
+    syntheticSlots.body = "Long-form text content with headings and paragraphs";
+    syntheticSlots.toc = "Table of contents sidebar (optional)";
   }
   if (patternId.includes("settings") || desc.includes("settings") || desc.includes("preferences")) {
-    syntheticSlots["sections"] = "Settings sections (label, description, input/toggle)";
+    syntheticSlots.sections = "Settings sections (label, description, input/toggle)";
   }
   if (patternId.includes("security") || desc.includes("security") || desc.includes("password")) {
-    syntheticSlots["sections"] = "Security sections (password change, MFA toggle, session list)";
+    syntheticSlots.sections = "Security sections (password change, MFA toggle, session list)";
   }
   if (patternId.includes("session") || desc.includes("session")) {
-    syntheticSlots["list"] = "Active sessions list (device, location, last active, revoke button)";
+    syntheticSlots.list = "Active sessions list (device, location, last active, revoke button)";
   }
   if (patternId.includes("message") || desc.includes("message") || desc.includes("chat")) {
-    syntheticSlots["messages"] = "Message bubbles (user/assistant, content, timestamp)";
+    syntheticSlots.messages = "Message bubbles (user/assistant, content, timestamp)";
   }
   if (patternId.includes("input") && desc.includes("chat")) {
-    syntheticSlots["textarea"] = "Auto-expanding message input";
-    syntheticSlots["actions"] = "Attach file button, send button";
+    syntheticSlots.textarea = "Auto-expanding message input";
+    syntheticSlots.actions = "Attach file button, send button";
   }
   if (patternId.includes("empty") || desc.includes("empty")) {
-    syntheticSlots["illustration"] = "Empty state illustration or icon";
-    syntheticSlots["message"] = "Welcome/empty state message";
-    syntheticSlots["suggestions"] = "Suggested actions or prompts";
+    syntheticSlots.illustration = "Empty state illustration or icon";
+    syntheticSlots.message = "Welcome/empty state message";
+    syntheticSlots.suggestions = "Suggested actions or prompts";
   }
   if (patternId.includes("header") && desc.includes("chat")) {
-    syntheticSlots["title"] = "Conversation title or model name";
-    syntheticSlots["actions"] = "Header action buttons (new chat, settings)";
+    syntheticSlots.title = "Conversation title or model name";
+    syntheticSlots.actions = "Header action buttons (new chat, settings)";
   }
   return syntheticSlots;
 }