rapidkit 0.38.0 → 0.39.0

package/README.md

@@ -237,18 +237,45 @@ Every tool gets the same answers: what projects exist, what stack they use, whic
 
 Workspace Intelligence provides a shared understanding of projects, dependencies, operational context, and release readiness for developers, CI pipelines, and AI agents.
 
-| Command                                          | Purpose                                                          |
-| ------------------------------------------------ | ---------------------------------------------------------------- |
-| `workspace model --json`                         | Canonical workspace model                                        |
-| `workspace context --for-agent --json --write`   | Agent-ready context pack + auto agent grounding sync             |
-| `workspace agent-sync --write`                   | Cross-tool grounding (AGENTS.md, Copilot, Cursor, Claude, INDEX) |
-| `workspace snapshot --json`                      | Persist model snapshot                                           |
-| `workspace diff --from <file\|git[:ref]> --json` | Diff against snapshot or git                                     |
-| `workspace impact --from <file> --json`          | Blast-radius evidence                                            |
-| `workspace verify [--strict] --json`             | Impact verification gate                                         |
+| Command                                           | Purpose                                                          |
+| ------------------------------------------------- | ---------------------------------------------------------------- |
+| `workspace model [--cache\|--incremental] --json` | Canonical workspace model (graph-aware, incremental rebuilds)    |
+| `workspace context --for-agent --json --write`    | Agent-ready context pack + auto agent grounding sync             |
+| `workspace agent-sync --write`                    | Cross-tool grounding (AGENTS.md, Copilot, Cursor, Claude, INDEX) |
+| `workspace snapshot --json`                       | Persist model snapshot                                           |
+| `workspace diff --from <file\|git[:ref]> --json`  | Diff against snapshot or git                                     |
+| `workspace impact --from <file> --json`           | Graph-aware transitive blast-radius evidence                     |
+| `workspace verify [--strict] --json`              | Definitive verification gate (subgraph + freshness + policy)     |
+| `workspace graph <emit\|explain\|dot\|mermaid>`   | Inspect and visualize the dependency graph                       |
+| `workspace watch [--json] [--once]`               | Daemon mode: keep model + graph in memory, stream change events  |
 
 JSON schemas: `contracts/workspace-intelligence/`. Details: [commands-reference.md](docs/commands-reference.md).
 
+### Graph-aware intelligence engine
+
+The workspace model carries a deterministic, first-class **dependency graph** that
+`impact`, `verify`, and `graph` all reason over — so the same evidence drives blast
+radius, gating, and visualization:
+
+- **Transitive blast radius** — `workspace impact` reports each affected project's
+  `distance`, `path`, and `via` edge back to the change, plus centrality-weighted
+  **critical-path hotspots**.
+- **Whole-subgraph gate** — `workspace verify` gates the changed projects **and** their
+  transitive dependents, surfaces graph **integrity** issues (cycles, dangling edges,
+  orphans), and emits a structured `gate` (`passed`/`mode`/`exitCode`/`reasons`).
+- **Transitive freshness** — a deterministic `fresh | stale | unknown` verdict chained
+  through the graph: a dependency change makes every dependent stale, not just by
+  timestamp.
+- **Policy violations** — model/contract violations are surfaced as structured
+  `policyViolations[]` (not just an exit code) so IDEs and CI can render blockers.
+- **Health history** — every verify run appends to a bounded
+  `.rapidkit/reports/workspace-intelligence-history.json` ring buffer for trends.
+- **Fast rebuilds** — `workspace model --cache` / `--incremental` reuse unchanged
+  project models and re-infer only incident edges, keyed by a structural `inputsHash`.
+- **Watch / daemon** — `workspace watch` keeps the model + graph in memory and streams
+  deterministic `workspace-watch-event.v1` change events (changed projects, graph edge
+  deltas, structural hash) via fast incremental rebuilds.
+
 ### Agent grounding (CLI-only, no extension required)
 
 RapidKit can sync **cross-tool instruction files** so Copilot, Cursor, Claude Code, Codex, Grok, and other agents read the same evidence before guessing:

package/contracts/runtime-command-surface.v1.json

@@ -39,6 +39,39 @@
   "coreProjectCommands": [
     "docs"
   ],
+  "workspaceSubcommands": [
+    "list",
+    "sync",
+    "registry",
+    "foundation",
+    "model",
+    "snapshot",
+    "diff",
+    "impact",
+    "verify",
+    "graph",
+    "watch",
+    "context",
+    "agent-sync",
+    "policy",
+    "contract",
+    "share",
+    "export",
+    "archive",
+    "hydrate",
+    "import",
+    "run",
+    "init"
+  ],
+  "workspaceIntelligenceSubcommands": [
+    "model",
+    "snapshot",
+    "diff",
+    "impact",
+    "verify",
+    "context",
+    "agent-sync"
+  ],
   "moduleSuggestionFrameworks": [
     "fastapi",
     "nestjs"

package/contracts/workspace-intelligence/workspace-dependency-graph.v1.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/workspace-dependency-graph.v1.json",
+  "title": "RapidKit Workspace Dependency Graph",
+  "description": "First-class, versioned dependency graph of inter-project relationships consumed by impact, verify, run --blast-radius, and risk weighting.",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "nodes", "edges", "stats"],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspace-dependency-graph.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "nodes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "path"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "path": { "type": "string", "minLength": 1 },
+          "runtime": { "type": "string" },
+          "framework": { "type": "string" },
+          "kind": { "type": "string" }
+        },
+        "additionalProperties": true
+      }
+    },
+    "edges": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["from", "to", "kind", "source", "confidence", "evidence"],
+        "properties": {
+          "from": { "type": "string", "minLength": 1 },
+          "to": { "type": "string", "minLength": 1 },
+          "kind": {
+            "enum": [
+              "code-import",
+              "package-dep",
+              "event-pub-sub",
+              "service-dependsOn",
+              "shared-resource"
+            ]
+          },
+          "source": {
+            "enum": ["inferred", "contract", "manual"]
+          },
+          "confidence": {
+            "enum": ["high", "medium", "low"]
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["file"],
+              "properties": {
+                "file": { "type": "string", "minLength": 1 },
+                "detail": { "type": "string" }
+              },
+              "additionalProperties": true
+            }
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "stats": {
+      "type": "object",
+      "required": [
+        "nodeCount",
+        "edgeCount",
+        "inferredEdges",
+        "contractEdges",
+        "manualEdges",
+        "hasCycle"
+      ],
+      "properties": {
+        "nodeCount": { "type": "integer", "minimum": 0 },
+        "edgeCount": { "type": "integer", "minimum": 0 },
+        "inferredEdges": { "type": "integer", "minimum": 0 },
+        "contractEdges": { "type": "integer", "minimum": 0 },
+        "manualEdges": { "type": "integer", "minimum": 0 },
+        "hasCycle": { "type": "boolean" }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/contracts/workspace-intelligence/workspace-impact.v1.json

@@ -11,6 +11,8 @@
     "workspace",
     "summary",
     "affectedProjects",
+    "transitiveImpact",
+    "criticalPathHotspots",
     "workspaceImpact",
     "verificationPlan",
     "agentBrief",
@@ -43,7 +45,8 @@
         "risk",
         "affectedProjects",
         "workspaceItems",
-        "recommendedCommands"
+        "recommendedCommands",
+        "blastRadius"
       ],
       "properties": {
         "changed": { "type": "boolean" },
@@ -52,11 +55,38 @@
         },
         "affectedProjects": { "type": "integer", "minimum": 0 },
         "workspaceItems": { "type": "integer", "minimum": 0 },
-        "recommendedCommands": { "type": "integer", "minimum": 0 }
+        "recommendedCommands": { "type": "integer", "minimum": 0 },
+        "blastRadius": {
+          "type": "object",
+          "required": ["directlyAffected", "transitivelyAffected", "maxDistance", "graphEdges"],
+          "properties": {
+            "directlyAffected": { "type": "integer", "minimum": 0 },
+            "transitivelyAffected": { "type": "integer", "minimum": 0 },
+            "maxDistance": { "type": "integer", "minimum": 0 },
+            "graphEdges": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        }
       },
       "additionalProperties": false
     },
     "affectedProjects": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "transitiveImpact": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "criticalPathHotspots": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["project", "fanIn", "fanOut", "reach", "betweenness"],
+        "properties": {
+          "project": { "type": "string" },
+          "fanIn": { "type": "integer", "minimum": 0 },
+          "fanOut": { "type": "integer", "minimum": 0 },
+          "reach": { "type": "integer", "minimum": 0 },
+          "betweenness": { "type": "number", "minimum": 0 }
+        },
+        "additionalProperties": true
+      }
+    },
     "workspaceImpact": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
     "verificationPlan": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
     "agentBrief": {

package/contracts/workspace-intelligence/workspace-model.v1.json

@@ -41,6 +41,11 @@
       "items": { "type": "object", "additionalProperties": true }
     },
     "contracts": { "type": "object", "additionalProperties": true },
+    "graph": {
+      "type": "object",
+      "description": "First-class inferred dependency graph (workspace-dependency-graph.v1). Additive/optional.",
+      "additionalProperties": true
+    },
     "evidence": { "type": "object", "additionalProperties": true },
     "discovery": { "type": "object", "additionalProperties": true },
     "policies": { "type": "object", "additionalProperties": true },

package/contracts/workspace-intelligence/workspace-verify.v1.json

@@ -13,7 +13,12 @@
     "steps",
     "missingEvidence",
     "blockingReasons",
-    "verificationPlan"
+    "verificationPlan",
+    "affectedSubgraph",
+    "graphIntegrity",
+    "freshness",
+    "policyMode",
+    "policyViolations"
   ],
   "properties": {
     "schemaVersion": {
@@ -105,6 +110,103 @@
     "verificationPlan": {
       "type": "array",
       "items": { "type": "object", "additionalProperties": true }
+    },
+    "affectedSubgraph": {
+      "type": "object",
+      "required": [
+        "totalProjects",
+        "directlyChanged",
+        "transitiveDependents",
+        "covered",
+        "uncovered",
+        "unverifiable"
+      ],
+      "properties": {
+        "totalProjects": { "type": "integer", "minimum": 0 },
+        "directlyChanged": { "type": "array", "items": { "type": "string" } },
+        "transitiveDependents": { "type": "array", "items": { "type": "string" } },
+        "covered": { "type": "array", "items": { "type": "string" } },
+        "uncovered": { "type": "array", "items": { "type": "string" } },
+        "unverifiable": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "graphIntegrity": {
+      "type": "object",
+      "required": ["ok", "cycles", "danglingEdges", "orphans", "stats"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "cycles": {
+          "type": "array",
+          "items": { "type": "array", "items": { "type": "string" } }
+        },
+        "danglingEdges": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["from", "to", "kind", "missing"],
+            "properties": {
+              "from": { "type": "string" },
+              "to": { "type": "string" },
+              "kind": { "type": "string" },
+              "missing": { "enum": ["from", "to", "both"] }
+            },
+            "additionalProperties": true
+          }
+        },
+        "orphans": { "type": "array", "items": { "type": "string" } },
+        "stats": {
+          "type": "object",
+          "required": [
+            "nodeCount",
+            "edgeCount",
+            "cycleCount",
+            "danglingCount",
+            "orphanCount"
+          ],
+          "properties": {
+            "nodeCount": { "type": "integer", "minimum": 0 },
+            "edgeCount": { "type": "integer", "minimum": 0 },
+            "cycleCount": { "type": "integer", "minimum": 0 },
+            "danglingCount": { "type": "integer", "minimum": 0 },
+            "orphanCount": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "freshness": {
+      "type": "object",
+      "required": ["verdict", "baseline", "changed", "added", "removed", "projectHashes"],
+      "properties": {
+        "verdict": { "enum": ["fresh", "stale", "unknown"] },
+        "baseline": { "enum": ["none", "recorded"] },
+        "changed": { "type": "array", "items": { "type": "string" } },
+        "added": { "type": "array", "items": { "type": "string" } },
+        "removed": { "type": "array", "items": { "type": "string" } },
+        "projectHashes": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "policyMode": { "type": "string" },
+    "policyViolations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["source", "severity", "code", "message"],
+        "properties": {
+          "source": { "enum": ["model", "contract"] },
+          "severity": { "enum": ["error", "warning"] },
+          "code": { "type": "string" },
+          "message": { "type": "string" },
+          "target": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
     }
   },
   "additionalProperties": true

package/dist/analyze-RHQM4AB2.js

@@ -0,0 +1 @@
+export{b as printAnalyzeReport,a as runAnalyze}from'./chunk-VQMZC5TC.js';

package/dist/autopilot-release-FWKOY2BD.js

@@ -0,0 +1 @@
+export{b as AUTOPILOT_RELEASE_ALIAS_FILENAME,a as AUTOPILOT_RELEASE_LAST_RUN_FILENAME,c as runAutopilotRelease}from'./chunk-GYNIVEYP.js';

package/dist/chunk-3YLMCP3V.js

@@ -0,0 +1 @@
+import {a as a$1}from'./chunk-6G2KSHP6.js';import {b}from'./chunk-GOM3RFB3.js';import {intro,confirm,isCancel,password,text,multiselect,select,cancel}from'@clack/prompts';var c=false;function S(n){if(b()||c)return;c=true;let i=`${a$1.brand("\u25C6")} ${a$1.white("RapidKit")}${n?a$1.dim(`  ${n}`):""}`;intro(i);}function a(n="Cancelled"){b()||(cancel(a$1.dim(n)),c=false);}function m(n){if(n)return i=>{let e=n(i);if(e!==true)return e===false?"Invalid value":e}}function v(n){return n.replace(/^[\p{Emoji_Presentation}\p{Extended_Pictographic}\s]+/u,"").trim()}function E(n){let i=v(n);for(let e of [" \u2014 "," \u2013 "," - "]){let t=i.indexOf(e);if(t>0)return {label:i.slice(0,t).trim(),hint:i.slice(t+e.length).trim()}}return {label:i}}function g(n){if(n.label)return {label:n.label,hint:n.hint};let i=E(n.name??String(n.value));return {label:i.label,hint:n.hint??i.hint}}function w(n,i){if(typeof n=="number")return n;if(n===void 0)return;let e=i.findIndex(t=>t.value===n);return e>=0?e:void 0}function h(n,i){return n.when===void 0?true:typeof n.when=="function"?n.when(i):n.when}async function Q(n,i){let e=n,t=v(e.message??e.name);if(e.type==="confirm"){let r=await confirm({message:t,initialValue:typeof e.default=="boolean"?e.default:false,active:a$1.success("yes"),inactive:a$1.dim("no")});return isCancel(r)&&(a(),process.exit(130)),r}if(e.type==="password"){let r=await password({message:t,validate:m(e.validate)});return isCancel(r)&&(a(),process.exit(130)),r}if(e.type==="input"){let r=await text({message:t,defaultValue:typeof e.default=="string"?e.default:void 0,initialValue:typeof e.default=="string"?e.default:void 0,validate:m(e.validate),placeholder:typeof e.default=="string"?e.default:void 0});return isCancel(r)&&(a(),process.exit(130)),r}if(e.type==="checkbox"){let r=[...e.choices??[]],l=await multiselect({message:t,options:r.map(u=>{let s=g(u);return {value:u.value,label:s.label,hint:s.hint}}),required:false});return isCancel(l)&&(a(),process.exit(130)),l}if(e.type==="rawlist"||e.type==="list"){let r=[...e.choices??[]].filter(s=>!s.disabled),l=w(e.default,r),u=await select({message:t,options:r.map(s=>{let p=g(s);return {value:s.value,label:p.label,hint:p.hint}}),initialValue:l!==void 0?r[l]?.value:void 0});return isCancel(u)&&(a(),process.exit(130)),u}throw new Error(`Unsupported prompt type: ${e.type}`)}async function A(n){if(b()){let e={};for(let t of n)if(h(t,e))if(t.default!==void 0)e[t.name]=t.default;else if(t.type==="confirm")e[t.name]=false;else if(t.type==="checkbox")e[t.name]=[];else if(t.choices?.length){let r=w(t.default,[...t.choices]);e[t.name]=r!==void 0?t.choices[r]?.value:t.choices[0]?.value;}else e[t.name]="";return e}let i={};for(let e of n)h(e,i)&&(i[e.name]=await Q(e));return i}export{S as a,A as b};

package/dist/chunk-4FJQWL7P.js

@@ -0,0 +1,4 @@
+import {c as c$1}from'./chunk-NFUXULIF.js';import {a as a$1,b as b$1,d as d$1,c,f as f$1}from'./chunk-YBS2HGO3.js';import {a,b}from'./chunk-KMUWWZRT.js';import {f,e}from'./chunk-4Q2ZZKGB.js';import u from'chalk';import d from'fs';import h from'fs-extra';import l from'path';var G="release-readiness-v1";function $(t,e){let a=l.resolve(t);if(!b(a))return a;let s=l.join(e,".rapidkit","workspace.contract.json");if(d.existsSync(s))try{let i=JSON.parse(d.readFileSync(s,"utf-8")),n=Array.isArray(i.projects)?i.projects:[];for(let c of n){let f=p(c),g=typeof f.relativePath=="string"?f.relativePath.trim():"";if(g)return l.join(e,g)}}catch{}let r=x(e),o=Array.isArray(r.payload?.projects)?r.payload.projects:[];for(let i of o){let n=p(i),c=typeof n.path=="string"?n.path.trim():"";if(c)return l.resolve(c)}return a}function I(t){let e=a$1(t);return b$1(e,t)?"go":d$1(e,t)?"java":c(e,t)?"node":f$1(e,t)?"python":"unknown"}function O(t,e){if(!d.existsSync(t))return null;let a=d.readdirSync(t).filter(s=>s.endsWith(".json")&&e.some(r=>r.test(s))).map(s=>l.join(t,s));return a.length===0?null:(a.sort((s,r)=>d.statSync(r).mtimeMs-d.statSync(s).mtimeMs),a[0])}function p(t){return t&&typeof t=="object"&&!Array.isArray(t)?t:{}}async function V(t){let{readWorkspaceRegistrySummary:e,resolveWorkspaceRegisteredProjects:a}=await import('./workspace-registry-summary-MIPHVB56.js'),s=await e(t);return s?s.projectCount:(await a(t)).summary.projectCount}function z(t,e,a){let s=l.join(t,".rapidkit","toolchain.lock");if(!d.existsSync(s))return {gate:"env",status:"fail",summary:"toolchain.lock is missing",details:["Run rapidkit bootstrap to pin runtime versions and generate a reproducible toolchain."],evidencePath:s};try{let r=JSON.parse(d.readFileSync(s,"utf-8")),o=p(r.runtime),n=["python","node","go","java"].filter(c=>{let f=p(o[c]);return typeof f.version=="string"&&f.version.trim().length>0});if(n.length===0)return {gate:"env",status:"fail",summary:"No runtime versions are pinned in toolchain.lock",details:["Pin at least one runtime version via rapidkit setup <runtime> and re-run bootstrap."],evidencePath:s};if(e!=="unknown"){let c=p(o[e]);if(typeof c.version!="string"||c.version.trim().length===0)return {gate:"env",status:"fail",summary:`${a?.hasRegisteredProjects?"Project runtime":"Workspace"} (${e}) is not pinned in toolchain.lock`,details:[`Run rapidkit setup ${e} and rapidkit bootstrap to lock ${e} for this workspace.`],evidencePath:s}}return {gate:"env",status:"pass",summary:`Pinned runtimes: ${n.join(", ")}`,details:[],evidencePath:s}}catch{return {gate:"env",status:"fail",summary:"toolchain.lock is invalid JSON",details:["Regenerate lockfile with rapidkit bootstrap."],evidencePath:s}}}function x(t){let e=l.join(t,".rapidkit","reports","doctor-last-run.json");if(!d.existsSync(e))return {payload:null,path:e};try{let a=JSON.parse(d.readFileSync(e,"utf-8"));return c$1(a,"workspace")?{payload:a,path:e}:{payload:null,path:e}}catch{return {payload:null,path:e}}}function L(t){let e=x(t);if(!e.payload)return {gate:{gate:"doctor",status:"fail",summary:"Doctor evidence is missing",details:["Run rapidkit doctor workspace --json before release readiness checks."],evidencePath:e.path},payload:null};let a=p(e.payload.summary),s=Number(a.totalIssues??0);return a.hasSystemErrors?{gate:{gate:"doctor",status:"fail",summary:"Doctor reported system errors",details:["Resolve system-level doctor errors before proceeding."],evidencePath:e.path},payload:e.payload}:s>0?{gate:{gate:"doctor",status:"warn",summary:`Doctor found ${s} issue(s)`,details:["Run rapidkit doctor workspace --fix and re-run readiness checks."],evidencePath:e.path},payload:e.payload}:{gate:{gate:"doctor",status:"pass",summary:"Doctor checks passed without issues",details:[],evidencePath:e.path},payload:e.payload}}function D(t){let e=l.join(t,".rapidkit","reports","analyze-last-run.json");if(!d.existsSync(e))return {gate:"analyze",status:"fail",summary:"Analyze evidence is missing",details:["Run rapidkit analyze --json before release readiness checks."],evidencePath:e};try{let a=JSON.parse(d.readFileSync(e,"utf-8")),s=p(a.summary),r=String(s.verdict??"").toLowerCase(),o=Number(s.score??0),i=p(s.findings),n=Number(i.fail??0);return r==="blocked"||n>0?{gate:"analyze",status:"fail",summary:`Analyze verdict is blocked (score ${o}/100)`,details:["Resolve analyze findings and regenerate analyze-last-run.json."],evidencePath:e}:r==="needs-attention"?{gate:"analyze",status:"warn",summary:`Analyze needs attention (score ${o}/100)`,details:["Review analyze warnings before release."],evidencePath:e}:{gate:"analyze",status:"pass",summary:`Analyze passed (score ${o}/100)`,details:[],evidencePath:e}}catch{return {gate:"analyze",status:"fail",summary:"Analyze evidence is invalid JSON",details:["Re-run rapidkit analyze --json to regenerate evidence."],evidencePath:e}}}function J(t){try{let e=JSON.parse(d.readFileSync(t,"utf-8")),a=String(e.status??"").toLowerCase(),s=p(e.summary),r=Number(s.failedChecks??0);return a==="fail"||r>0?{gate:"verify",status:"fail",summary:"Verify-pack contract reports failed checks",details:["Fix failed verify checks and regenerate verify-pack contract evidence."],evidencePath:t}:a==="pass"?{gate:"verify",status:"pass",summary:"Verify-pack contract passed",details:[],evidencePath:t}:{gate:"verify",status:"warn",summary:"Verify-pack contract status is not explicit",details:["Ensure contract status is pass/fail and keep schema aligned with v1 contract."],evidencePath:t}}catch{return {gate:"verify",status:"fail",summary:"Verify-pack contract is invalid JSON",details:["Regenerate verify-pack contract artifact."],evidencePath:t}}}async function W(t,e){if(e.skipVerify)return {gate:"verify",status:"pass",summary:"Verify gate skipped (--skip-verify)",details:["Verification was explicitly skipped for this readiness run."]};let a=l.join(t,".rapidkit","reports"),s=O(a,[/verify-pack-contract/i,/^verify.*\.json$/i]);if(s)return J(s);let r=l.join(a,"workspace-contract-verify-last-run.json"),o=O(a,[/workspace-contract-verify-last-run/i,/workspace-contract-verify/i]);if(o)try{let i=JSON.parse(d.readFileSync(o,"utf-8")),n=String(i.status??"").toLowerCase();if(n==="passed"||n==="pass")return {gate:"verify",status:"pass",summary:"Workspace contract verification passed (CLI cache)",details:[],evidencePath:o};if(n==="failed"||n==="fail")return {gate:"verify",status:"fail",summary:"Workspace contract verification failed (CLI cache)",details:(Array.isArray(i.violations)?i.violations:[]).slice(0,5),evidencePath:o}}catch{}try{let{verifyWorkspaceContract:i}=await import('./workspace-contract-D5O4OZD5.js'),n=await i({workspacePath:t}),c={schemaVersion:"v1",source:"cli",generatedAt:new Date().toISOString(),status:n.status,contractPath:n.contractPath,projectCount:n.projectCount,checks:n.checks,violations:n.violations};return await h.ensureDir(a),await h.writeJSON(r,c,{spaces:2}),n.status==="failed"?{gate:"verify",status:"fail",summary:"Workspace contract verification failed (CLI)",details:n.violations.slice(0,5),evidencePath:r}:{gate:"verify",status:"pass",summary:"Workspace contract verification passed (CLI)",details:[],evidencePath:r}}catch(i){return {gate:"verify",status:"fail",summary:"No verify evidence and workspace contract verification unavailable",details:["Run rapidkit workspace contract verify --json or export verify-pack contract from CI.",i instanceof Error?i.message:String(i)],evidencePath:l.join(a,"*verify*.json")}}}function F(t,e){let a=l.join(e,".rapidkit","reports","doctor-last-run.json");if(!t)return {gate:"dependency",status:"warn",summary:"Dependency risk check skipped (doctor evidence missing)",details:["Run rapidkit doctor workspace --json to include dependency findings."],evidencePath:a};let s=Array.isArray(t.projects)?t.projects:[],r=s.reduce((i,n)=>{let c=Number(n.vulnerabilities??0);return Number.isFinite(c)?i+Math.max(0,c):i},0),o=s.filter(i=>i.depsInstalled===false).length;return r>0?{gate:"dependency",status:"fail",summary:`${r} dependency vulnerability(ies) reported`,details:["Resolve vulnerabilities (npm/pip/go audit pipelines) before release."],evidencePath:a}:o>0?{gate:"dependency",status:"warn",summary:`${o} project(s) report missing dependencies`,details:["Run project init/bootstrap and regenerate doctor evidence."],evidencePath:a}:{gate:"dependency",status:"pass",summary:"No dependency vulnerabilities reported",details:[],evidencePath:a}}function M(t){return t.some(e=>e.status==="fail")?"fail":t.some(e=>e.status==="warn")?"warn":"pass"}async function _(t,e){let a=l.join(t,".rapidkit","reports","release-readiness-last-run.json");return await h.ensureDir(l.dirname(a)),await h.writeJSON(a,e,{spaces:2}),a}async function K(t={}){let e$1=l.resolve(t.startPath??process.cwd()),a$1=a(e$1)??e$1,s=$(e$1,a$1),r=I(s),o=await V(a$1)>0,i=z(a$1,r,{hasRegisteredProjects:o}),n=L(a$1),c=D(a$1),f$1=await W(a$1,{skipVerify:t.skipVerify}),g=F(n.payload,a$1),k=[i,n.gate,c,f$1,g],v=M(k),m={schemaVersion:G,generatedAt:new Date().toISOString(),workspacePath:a$1,projectPath:s,action:t.action,overallStatus:v,blocking:v==="fail",blockingReasons:k.filter(y=>y.status==="fail").map(y=>`${y.gate}: ${y.summary}`),gates:k};if(t.writeReport!==false){let y=f(m,{commandId:"workspaceReadiness",exitCode:v==="fail"?2:v==="warn"?1:0,generatedAt:m.generatedAt,blockers:m.blockingReasons,runId:e()});m.evidencePath=await _(a$1,y);}return m}function H(t){return t==="pass"?u.green("PASS"):t==="warn"?u.yellow("WARN"):u.red("FAIL")}function B(t){return t==="pass"?u.green("PASS"):t==="warn"?u.yellow("WARN"):u.red("FAIL")}async function se(t){let e=await K({writeReport:true,skipVerify:t.skipVerify===true});if(t.json)console.log(JSON.stringify(e,null,2));else {console.log(u.bold.cyan(`
+\u{1F6A6} RapidKit Release Readiness
+`)),console.log(u.bold(`Workspace: ${u.cyan(l.basename(e.workspacePath))}`)),console.log(u.gray(`Path: ${e.workspacePath}`)),console.log(`Overall: ${B(e.overallStatus)}`);for(let a of e.gates){console.log(` - ${a.gate}: ${H(a.status)} ${a.summary}`);for(let s of a.details)console.log(u.gray(`   ${s}`));a.evidencePath&&console.log(u.gray(`   evidence: ${a.evidencePath}`));}e.evidencePath&&console.log(u.gray(`
+Evidence saved: ${e.evidencePath}`));}t.strict&&e.overallStatus!=="pass"&&process.exit(1);}export{K as a,se as b};

package/dist/chunk-4Q2ZZKGB.js

@@ -0,0 +1 @@
+import {d,b,g as g$1,a,c}from'./chunk-GOM3RFB3.js';import {randomUUID}from'crypto';var i=null;function f(){return i}function V(t){let r=t.argv??process.argv,n=m(r.slice(2)),e={runId:randomUUID(),startedAt:new Date().toISOString(),command:n,cwd:t.cwd??process.cwd(),rapidkitVersion:t.rapidkitVersion,finalized:false};return i=e,d(e.runId),b(r)&&g$1(l(e,"run.started","info","CLI run started")),e}function E(t,r){if(!(!i||i.finalized)){if(i.finalized=true,!b()){i=null;return}t===0?g$1(l(i,"run.completed","info",r??"CLI run completed",{exitCode:t})):g$1(l(i,"run.failed","error",r??"CLI run failed",{exitCode:t})),i=null;}}function w(t=process.argv){a(t)==="json"&&(process.env.RAPIDKIT_LOG_FORMAT="json");let r=t.slice(0,2),n=m(t.slice(2));n.length!==t.length-2&&(process.argv=[...r,...n]);}function m(t){let r=[];for(let n=0;n<t.length;n+=1){let e=t[n];if(e!=="--log-json"){if(e==="--log-format"){n+=1;continue}e.startsWith("--log-format=")||r.push(e);}}return r}function l(t,r,n,e,o){return {schemaVersion:c,runId:t.runId,timestamp:new Date().toISOString(),level:n,event:r,component:"cli",message:e,command:t.command,metadata:{cwd:t.cwd,rapidkitVersion:t.rapidkitVersion,startedAt:t.startedAt,...o}}}var g=false;function L(t){if(g||!t?.force&&(process.env.VITEST==="true"||process.env.VITEST==="1"||process.env.NODE_ENV==="test"))return;g=true;let r=process.exit.bind(process);process.exit=(n=>{let e=typeof n=="number"?n:typeof n=="string"?Number.parseInt(n,10):0,o=Number.isFinite(e)?e:1;return E(o),r(n)});}function O(){return f()?.runId}function _(t,r){let{blockers:n,stderrTail:e,runId:o,generatedAt:p,...C}=r,x=p||(typeof t.generatedAt=="string"?t.generatedAt:void 0)||(typeof t.timestamp=="string"?t.timestamp:void 0)||new Date().toISOString();return {...t,...C,generatedAt:x,...n&&n.length>0?{blockers:n}:{},...e&&e.trim()?{stderrTail:e.trim()}:{},...o?{runId:o}:{}}}export{V as a,E as b,w as c,L as d,O as e,_ as f};

package/dist/chunk-6G2KSHP6.js

@@ -0,0 +1,2 @@
+import {b as b$1,f}from'./chunk-GOM3RFB3.js';import {spinner,log,note}from'@clack/prompts';import a from'picocolors';function c(r,t,e){f({level:t==="failed"?"error":t==="warn"?"warn":"info",event:"progress",component:r.component,message:e,metadata:{phase:r.phase,status:t,...r.metadata}});}function b(r,t){let e=r;if(b$1())return c(t,"started",r),{start(n){return n&&(e=n),c(t,"started",e),this},succeed(n){c(t,"succeeded",n??e);},fail(n){c(t,"failed",n??e);},warn(n){c(t,"warn",n??e);},stop(n){c(t,"succeeded",n??e);},get text(){return e},set text(n){e=n,c(t,"started",n);}};let i=spinner();return i.start(r),{start(n){return i.start(n??e),n&&(e=n),this},succeed(n){i.stop(n??e);},fail(n){i.stop(n??e,1);},warn(n){i.stop(n??e);},stop(n){i.stop(n??e);},get text(){return e},set text(n){e=n,i.message(n);}}}function R(r,t){return b(r,t)}function h(r,t,e,i="create"){f({level:"info",event:"progress",component:i,message:e,metadata:{phase:"step",stepNum:r,total:t,status:"started"}});}function J(r){f({level:r.status==="failed"?"error":r.status==="warn"?"warn":"info",event:"progress",component:"workspace",message:r.message,metadata:{phase:`workspace.${r.action}`,action:r.action,status:r.status,...r.metadata??{}}});}function F(r){f({level:r.status==="failed"?"error":"info",event:"progress",component:r.component??"create",message:r.message,metadata:{phase:r.phase??"workspace.install.pypi",status:r.status,installMethod:r.installMethod,...r.attempt!==void 0?{attempt:r.attempt}:{},...r.maxAttempts!==void 0?{maxAttempts:r.maxAttempts}:{}}});}var p={brand:r=>a.cyan(r),accent:r=>a.magenta(r),value:r=>a.cyan(r),dim:r=>a.gray(r),muted:r=>a.dim(r),success:r=>a.green(r),warn:r=>a.yellow(r),error:r=>a.red(r),white:r=>a.white(r),bold:r=>a.bold(r)};function d(r,t,e){b$1()&&f({level:r,event:"log",component:"cli",message:t,metadata:e});}var g={info(r){d("info",r),!b$1()&&log.info(r);},success(r){d("info",r,{outcome:"success"}),!b$1()&&log.success(r);},warn(r){d("warn",r),!b$1()&&log.warn(r);},error(r){d("error",r),!b$1()&&log.error(r);},step(r){d("info",r,{phase:"step"}),!b$1()&&log.step(r);},stepNumbered(r,t,e){let i=`${p.dim(`[${r}/${t}]`)} ${e}`;d("info",e,{phase:"step",stepNum:r,total:t}),!b$1()&&log.step(i);},note(r,t){d("info",r,{kind:"note",title:t}),!b$1()&&note(r,t);},message(r,t=p.brand("\u25C7")){d("info",r),!b$1()&&log.message(r,{symbol:t});},dim(r){b$1()||console.log(p.dim(r));},plain(r){b$1()||console.log(r);},nextSteps(r){b$1()||g.note(r.map(t=>p.white(t)).join(`
+`),p.brand("Next steps"));}};var w=class{debugEnabled=false;setDebug(t){this.debugEnabled=t;}isJsonMode(){return b$1()}debug(t,...e){this.debugEnabled&&this.write("debug",t,e);}info(t,...e){this.write("info",t,e);}success(t,...e){this.write("info",t,e,{outcome:"success"},"success");}warn(t,...e){this.write("warn",t,e,void 0,"warn");}error(t,...e){this.write("error",t,e,void 0,"error");}step(t,e,i){if(b$1()){h(t,e,i);return}g.stepNumbered(t,e,i);}write(t,e,i,n,v="info"){let k=i.length>0?{details:i.map(x=>y(x))}:void 0;if(b$1()){f({level:t,event:"log",component:"cli",message:e,metadata:{...n,...k}});return}let m=t==="debug"?`[debug] ${e}`:e;switch(v){case "success":g.success(m);break;case "warn":g.warn(m);break;case "error":g.error(m);break;default:t==="debug"?g.dim(m):g.info(m);}}};function y(r){return r instanceof Error?{name:r.name,message:r.message}:r===null||typeof r=="string"||typeof r=="number"||typeof r=="boolean"?r:String(r)}var Y=new w;export{p as a,b,R as c,J as d,F as e,Y as f};

package/dist/{chunk-PPQYTYQG.js → chunk-6KD5F6LX.js}

@@ -1,5 +1,5 @@
-import {e}from'./chunk-RELR4O5E.js';import {b as b$1}from'./chunk-2FIX2MDC.js';import {execa}from'execa';import m from'chalk';import {createRequire}from'module';import {promises}from'fs';import l from'path';import g from'os';var v="rapidkit",A=createRequire(import.meta.url),C=A("../package.json"),i=C?.version??"0.0.0";function b(r){let e=r.trim().match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/);if(!e)return null;let t=e[4]?e[4].split(".").map(o=>o.match(/^\d+$/)?Number(o):o):[];return {major:Number(e[1]),minor:Number(e[2]),patch:Number(e[3]),prerelease:t}}function k(r,n){let e=b(r),t=b(n);if(!e||!t)return 0;if(e.major!==t.major)return e.major>t.major?1:-1;if(e.minor!==t.minor)return e.minor>t.minor?1:-1;if(e.patch!==t.patch)return e.patch>t.patch?1:-1;if(e.prerelease.length===0&&t.prerelease.length===0)return 0;if(e.prerelease.length===0)return 1;if(t.prerelease.length===0)return  -1;let o=Math.max(e.prerelease.length,t.prerelease.length);for(let u=0;u<o;u+=1){let a=e.prerelease[u],s=t.prerelease[u];if(a===void 0)return  -1;if(s===void 0)return 1;if(a===s)continue;let d=typeof a=="number",h=typeof s=="number";return d&&h?a>s?1:-1:d?-1:h||String(a)>String(s)?1:-1}return 0}var _=14400*1e3;function y(){let r=process.env.RAPIDKIT_CACHE_DIR?.trim()||(process.env.VITEST_WORKER_ID?l.join(g.homedir(),".rapidkit","cache",`vitest-${process.env.VITEST_WORKER_ID}`):l.join(g.homedir(),".rapidkit","cache"));return l.join(r,"update-check.json")}async function U(){try{let r=await promises.readFile(y(),"utf-8"),n=JSON.parse(r);return typeof n.latestVersion=="string"&&typeof n.checkedAt=="number"&&n.currentVersion===i&&Date.now()-n.checkedAt<_?n:null}catch{return null}}async function N(r){try{let n=y();await promises.mkdir(l.dirname(n),{recursive:true}),await promises.writeFile(n,JSON.stringify({latestVersion:r,checkedAt:Date.now(),currentVersion:i}),"utf-8");}catch{}}async function F(){try{e.debug("Checking for updates...");let r=await U();if(r){let t=Math.round((Date.now()-r.checkedAt)/6e4);e.debug(`Update check: cache hit (${t}m old)`),k(r.latestVersion,i)>0&&(console.log(m.yellow(`
+import {f}from'./chunk-6G2KSHP6.js';import {b as b$1}from'./chunk-2FIX2MDC.js';import {execa}from'execa';import m from'chalk';import {createRequire}from'module';import {promises}from'fs';import l from'path';import g from'os';var v="rapidkit",A=createRequire(import.meta.url),C=A("../package.json"),i=C?.version??"0.0.0";function b(r){let e=r.trim().match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/);if(!e)return null;let t=e[4]?e[4].split(".").map(o=>o.match(/^\d+$/)?Number(o):o):[];return {major:Number(e[1]),minor:Number(e[2]),patch:Number(e[3]),prerelease:t}}function k(r,n){let e=b(r),t=b(n);if(!e||!t)return 0;if(e.major!==t.major)return e.major>t.major?1:-1;if(e.minor!==t.minor)return e.minor>t.minor?1:-1;if(e.patch!==t.patch)return e.patch>t.patch?1:-1;if(e.prerelease.length===0&&t.prerelease.length===0)return 0;if(e.prerelease.length===0)return 1;if(t.prerelease.length===0)return  -1;let o=Math.max(e.prerelease.length,t.prerelease.length);for(let u=0;u<o;u+=1){let a=e.prerelease[u],s=t.prerelease[u];if(a===void 0)return  -1;if(s===void 0)return 1;if(a===s)continue;let d=typeof a=="number",h=typeof s=="number";return d&&h?a>s?1:-1:d?-1:h||String(a)>String(s)?1:-1}return 0}var _=14400*1e3;function y(){let r=process.env.RAPIDKIT_CACHE_DIR?.trim()||(process.env.VITEST_WORKER_ID?l.join(g.homedir(),".rapidkit","cache",`vitest-${process.env.VITEST_WORKER_ID}`):l.join(g.homedir(),".rapidkit","cache"));return l.join(r,"update-check.json")}async function U(){try{let r=await promises.readFile(y(),"utf-8"),n=JSON.parse(r);return typeof n.latestVersion=="string"&&typeof n.checkedAt=="number"&&n.currentVersion===i&&Date.now()-n.checkedAt<_?n:null}catch{return null}}async function N(r){try{let n=y();await promises.mkdir(l.dirname(n),{recursive:true}),await promises.writeFile(n,JSON.stringify({latestVersion:r,checkedAt:Date.now(),currentVersion:i}),"utf-8");}catch{}}async function F(){try{f.debug("Checking for updates...");let r=await U();if(r){let t=Math.round((Date.now()-r.checkedAt)/6e4);f.debug(`Update check: cache hit (${t}m old)`),k(r.latestVersion,i)>0&&(console.log(m.yellow(`
 \u26A0\uFE0F  Update available: ${i} \u2192 ${r.latestVersion}`)),console.log(m.cyan(`Run: npm install -g rapidkit@latest
-`)));return}let{stdout:n}=await execa("npm",["view",v,"version"],{timeout:b$1()}),e$1=n.trim();await N(e$1),e$1&&k(e$1,i)>0?(console.log(m.yellow(`
-\u26A0\uFE0F  Update available: ${i} \u2192 ${e$1}`)),console.log(m.cyan(`Run: npm install -g rapidkit@latest
-`))):e.debug("You are using the latest version");}catch{e.debug("Could not check for updates");}}function M(){return i}export{F as a,M as b};
+`)));return}let{stdout:n}=await execa("npm",["view",v,"version"],{timeout:b$1()}),e=n.trim();await N(e),e&&k(e,i)>0?(console.log(m.yellow(`
+\u26A0\uFE0F  Update available: ${i} \u2192 ${e}`)),console.log(m.cyan(`Run: npm install -g rapidkit@latest
+`))):f.debug("You are using the latest version");}catch{f.debug("Could not check for updates");}}function M(){return i}export{F as a,M as b};