rapidkit 0.41.0 → 0.41.2

package/README.md

@@ -1,12 +1,16 @@
 # RapidKit
 
-### Open-Source Workspace Intelligence for Software Systems
+## Open-Source Workspace Intelligence for Software Systems
 
 [![npm version](https://img.shields.io/npm/v/rapidkit.svg?style=flat-square)](https://www.npmjs.com/package/rapidkit)
 [![Downloads](https://img.shields.io/npm/dm/rapidkit.svg?style=flat-square)](https://www.npmjs.com/package/rapidkit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 [![Built by RapidKit](https://img.shields.io/badge/Built%20by-RapidKit-0f172a?logo=github)](https://www.getrapidkit.com)
 
+Not another AI coding assistant.
+Not another agent framework.
+Not another context engine.
+
 > One workspace. One truth. Humans and AI aligned.
 
 RapidKit turns scattered projects into a governed, agent-ready workspace.
@@ -38,8 +42,8 @@ npx rapidkit my-workspace --yes --profile polyglot
 cd ~/rapidkit/workspaces/my-workspace
 
 npx rapidkit bootstrap --profile polyglot
-npx rapidkit create project
-npx rapidkit create frontend nextjs my-web --yes
+npx rapidkit create project nextjs my-web --yes
+npx rapidkit create project fastapi.standard my-api --yes
 
 npx rapidkit workspace model --json
 npx rapidkit workspace context --for-agent --json --write
@@ -142,6 +146,7 @@ For the visual experience, install the [Workspai VS Code extension](https://mark
 - [From Code to Shared Understanding](#from-code-to-shared-understanding)
 - [Typical workflows](#typical-workflows)
 - [Mental model](#mental-model)
+- [Why this architecture helps](#why-this-architecture-helps)
 - [Workspace Intelligence Commands](#workspace-intelligence-commands)
 - [Agent Customization Pack](#agent-customization-pack)
 - [Requirements](#requirements)
@@ -211,27 +216,92 @@ New workspaces go under `~/rapidkit/workspaces/<name>`. Legacy `~/Workspai/rapid
 
 ## Mental model
 
-### Two-layer model
+### Two capabilities, one workspace intelligence layer
 
 ```text
-First-class engine kits  →  FastAPI and NestJS (modules + deep generation)
-Workspace intelligence   →  frontend apps, Go, Spring, .NET, adopted/imported repos
+Workspace Intelligence  →  every project in the workspace
+Native generation       →  first-class scaffolds and stack-specific project creation
+Deep module generation  →  selected backend engine kits such as FastAPI and NestJS
 ```
 
-RapidKit treats the **workspace** as the operating boundary: policy, registry, evidence, contracts, and release readiness. Projects can live inside the workspace or be **adopted** from outside.
+Workspace Intelligence is not limited to a framework lane. It works across
+RapidKit-created projects, frontend apps, Go, Spring Boot, .NET, FastAPI, NestJS,
+and adopted/imported repositories. The difference is generation depth:
+some stacks have first-class scaffolds, some use official ecosystem generators,
+and existing projects can be adopted in place.
+
+RapidKit treats the **workspace** as the operating boundary: policy, registry,
+evidence, contracts, and release readiness. Projects can live inside the
+workspace or be **adopted** from outside.
 
 ```text
 workspace/
+  .rapidkit-workspace
   .rapidkit/workspace.json
   .rapidkit/reports/
+    workspace-model.json
+    workspace-context-agent.json
+    INDEX.json
+    agent-customization-pack.json
+    workspace-skills-index.json
+    rapidkit-mcp-design.json
+  .rapidkit/skills/
+  .rapidkit/AGENT-GROUNDING.md
   services/api/
+    .rapidkit/project.json
+  AGENTS.md
+  .github/copilot-instructions.md
+  .github/instructions/
+  .github/prompts/
+  .github/skills/
+  .github/agents/
+  .cursor/rules/rapidkit-grounding.mdc
+  CLAUDE.md
+  .vscode/rapidkit-agent-hooks.json
 
 external-project/
   .rapidkit/project.json
   .rapidkit/adopt.json
 ```
 
-Every tool gets the same answers: what projects exist, what stack they use, which commands are safe, what evidence exists, and what context agents should receive.
+`.rapidkit/workspace.json` is the workspace manifest, not the project list.
+Projects are discovered from workspace project metadata, imported/adopted
+records, and workspace intelligence reports.
+
+Agent-facing outputs are generated from the same evidence layer:
+`workspace context --for-agent --write` writes the agent context report, and
+`workspace agent-sync --write --refresh-context --preset enterprise` writes the
+portable `AGENTS.md`, report index, skills, Copilot/Cursor/Claude surfaces, and
+agent handoff files. The exact generated output inventory is recorded in
+`.rapidkit/reports/agent-customization-pack.json` and summarized in the
+[Agent Customization Pack](#agent-customization-pack) section below.
+
+Every tool gets the same answers for every registered project: what projects
+exist, what stack they use, which commands are safe, what evidence exists, what
+changed, what release gates apply, and what context agents should receive.
+
+## Why this architecture helps
+
+You do not have to change frameworks to benefit from RapidKit.
+
+Use the frontend or backend stack that already fits your product: Next.js,
+Vite, FastAPI, NestJS, Go, Spring Boot, .NET, or an existing repository you
+adopt in place. RapidKit adds the workspace layer around it: project registry,
+safe commands, evidence, impact analysis, agent context, verification, and
+release gates.
+
+That means you can move faster without turning the product into a fragile
+prototype:
+
+- Start new products with governed scaffolds when RapidKit owns the create path
+- Adopt existing products without moving source code or rewriting the stack
+- Give humans, CI, IDEs, and AI agents the same workspace truth
+- Know what changed, what is affected, and what must be verified before release
+- Keep framework stability while adding professional product-development
+  workflows around the codebase
+
+The result is faster product development with clearer boundaries, safer AI
+assistance, and release decisions backed by evidence instead of guesswork.
 
 ## Workspace Intelligence Commands
 
@@ -413,13 +483,20 @@ cd ~/rapidkit/workspaces/my-workspace
 
 npx rapidkit bootstrap --profile polyglot
 npx rapidkit create project          # interactive kit picker
-npx rapidkit create frontend nextjs my-web --yes
+npx rapidkit create project nextjs my-web --yes
+npx rapidkit create project fastapi.standard my-api --yes
 cd <project-name> && npx rapidkit init && npx rapidkit dev
 ```
 
 Backend kits: `fastapi.standard`, `nestjs.standard`, `springboot.standard`, `gofiber.standard`, `dotnet.webapi.clean`, and more.
 
-Frontend: `create frontend nextjs|remix|vite-react|angular|astro|…` or `create project frontend.nextjs <name>`.
+Frontend kits: `nextjs`, `remix`, `vite-react`, `nuxt`, `angular`, `astro`, `sveltekit`, and more — same command shape:
+
+```bash
+npx rapidkit create project <kit> <name>
+```
+
+(`create frontend <id>` remains supported as an alias.)
 
 Shortcut: `npx rapidkit platform` (interactive workspace wizard).
 
@@ -484,7 +561,7 @@ Search **Workspai** in the marketplace or install via:
 | Enterprise evidence loop        | Partial                      | Full dashboard                  |
 | Module catalog (FastAPI/NestJS) | Limited                      | Browser UI                      |
 
-The extension invokes this npm CLI. For the latest `adopt` and `create frontend` features, install matching CLI version: `npm install -g rapidkit@latest` or `npm link` from this repo ([Development](#development)).
+The extension invokes this npm CLI. For the latest `adopt` and frontend generator features, install matching CLI version: `npm install -g rapidkit@latest` or `npm link` from this repo ([Development](#development)).
 
 ## Documentation
 

package/contracts/extension-cli-compatibility.v1.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "rapidkit-extension-cli-compatibility.v1",
   "cli": "rapidkit-npm",
-  "minimumVerifiedCliVersion": "0.41.0",
+  "minimumVerifiedCliVersion": "0.41.2",
   "publishedContractSchemas": {
     "runtimeCommandSurface": "rapidkit-runtime-command-surface-v1",
     "cliLogEvent": "cli-log-event-v1",

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

@@ -76,7 +76,9 @@
     "verify",
     "context",
     "agent-sync",
-    "explain"
+    "explain",
+    "why",
+    "trace"
   ],
   "moduleSuggestionFrameworks": [
     "fastapi",

package/contracts/workspace-intelligence/agent-action-outcome.v1.json

@@ -16,7 +16,23 @@
     "verifyBefore": { "type": "string" },
     "verifyAfter": { "type": "string" },
     "evidenceSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
-    "evidencePath": { "type": "string" }
+    "evidencePath": { "type": "string" },
+    "patchMetadata": {
+      "type": "object",
+      "required": ["appliedCount", "rejectedCount", "failedCount", "affectedFiles"],
+      "properties": {
+        "patchId": { "type": "string" },
+        "sourceAction": { "enum": ["auto-fix", "apply-patch"] },
+        "reviewRequired": { "type": "boolean" },
+        "branchCreated": { "type": "string" },
+        "appliedCount": { "type": "integer", "minimum": 0 },
+        "rejectedCount": { "type": "integer", "minimum": 0 },
+        "failedCount": { "type": "integer", "minimum": 0 },
+        "affectedFiles": { "type": "array", "items": { "type": "string" } },
+        "rollbackCommand": { "type": "string" }
+      },
+      "additionalProperties": false
+    }
   },
   "additionalProperties": false
 }

package/contracts/workspace-intelligence/studio-blocker-handoff.v1.json

@@ -65,6 +65,30 @@
     "studioMode": {
       "enum": ["FIX", "RUN_ONCE", "VERIFY_ONLY", "EXPLAIN"]
     },
+    "incidentSummary": {
+      "type": "object",
+      "required": ["title", "phase", "primaryAction", "verifyRequired", "auditStatus"],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "phase": {
+          "enum": ["detect", "diagnose", "fix", "verify", "audit"]
+        },
+        "primaryAction": {
+          "type": "string",
+          "minLength": 1
+        },
+        "verifyRequired": {
+          "type": "boolean"
+        },
+        "auditStatus": {
+          "enum": ["not-started", "pending", "saved", "failed", "unknown"]
+        }
+      },
+      "additionalProperties": false
+    },
     "resolutionHints": {
       "type": "array",
       "items": {

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

@@ -23,7 +23,33 @@
           "path": { "type": "string", "minLength": 1 },
           "runtime": { "type": "string" },
           "framework": { "type": "string" },
-          "kind": { "type": "string" }
+          "kind": { "type": "string" },
+          "operationalProfile": {
+            "type": "object",
+            "required": ["weight", "score", "verificationPriority", "reasons", "centrality"],
+            "properties": {
+              "weight": { "enum": ["low", "medium", "high", "critical"] },
+              "score": { "type": "integer", "minimum": 0, "maximum": 100 },
+              "verificationPriority": { "enum": ["normal", "elevated", "strict"] },
+              "reasons": {
+                "type": "array",
+                "items": { "type": "string" }
+              },
+              "centrality": {
+                "type": "object",
+                "required": ["fanIn", "fanOut", "reach", "betweenness", "isHotspot"],
+                "properties": {
+                  "fanIn": { "type": "integer", "minimum": 0 },
+                  "fanOut": { "type": "integer", "minimum": 0 },
+                  "reach": { "type": "integer", "minimum": 0 },
+                  "betweenness": { "type": "number", "minimum": 0 },
+                  "isHotspot": { "type": "boolean" }
+                },
+                "additionalProperties": true
+              }
+            },
+            "additionalProperties": true
+          }
         },
         "additionalProperties": true
       }
@@ -75,6 +101,14 @@
         "inferredEdges",
         "contractEdges",
         "manualEdges",
+        "authoritativeEdges",
+        "lowConfidenceEdges",
+        "orphanCount",
+        "connectedNodeCount",
+        "density",
+        "edgeCoverageRatio",
+        "evidenceCoverageRatio",
+        "hotspotCount",
         "hasCycle"
       ],
       "properties": {
@@ -83,9 +117,35 @@
         "inferredEdges": { "type": "integer", "minimum": 0 },
         "contractEdges": { "type": "integer", "minimum": 0 },
         "manualEdges": { "type": "integer", "minimum": 0 },
+        "authoritativeEdges": { "type": "integer", "minimum": 0 },
+        "lowConfidenceEdges": { "type": "integer", "minimum": 0 },
+        "orphanCount": { "type": "integer", "minimum": 0 },
+        "connectedNodeCount": { "type": "integer", "minimum": 0 },
+        "density": { "type": "number", "minimum": 0 },
+        "edgeCoverageRatio": { "type": "number", "minimum": 0, "maximum": 1 },
+        "evidenceCoverageRatio": { "type": "number", "minimum": 0, "maximum": 1 },
+        "hotspotCount": { "type": "integer", "minimum": 0 },
         "hasCycle": { "type": "boolean" }
       },
       "additionalProperties": true
+    },
+    "diagnostics": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code", "severity", "message"],
+        "properties": {
+          "code": { "type": "string", "minLength": 1 },
+          "severity": { "enum": ["info", "warning", "error"] },
+          "message": { "type": "string", "minLength": 1 },
+          "recommendation": { "type": "string" },
+          "nodeIds": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 }
+          }
+        },
+        "additionalProperties": true
+      }
     }
   },
   "additionalProperties": true

package/dist/analyze-QYHMGLSG.js

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

package/dist/autopilot-release-YDEUKRW6.js

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

package/dist/{chunk-WA6JYVJM.js → chunk-33LR2QEM.js}

@@ -1,2 +1,2 @@
-import {j as j$1}from'./chunk-QN2LPLHO.js';import {a}from'./chunk-DMUEGR36.js';import d from'path';import g from'fs-extra';var f="workspace-context.v1",w=".rapidkit/reports/workspace-context-agent.json";function h(e){if(typeof e!="string"||!e.trim()||e==="true")return "generic";let t=e.trim().toLowerCase();return t==="codex"||t==="claude"||t==="cursor"||t==="orca"?t:"generic"}function y(e){return `npx --yes --package rapidkit rapidkit ${e}`.trim()}function j(e){return `npx rapidkit ${e}`.trim()}function i(e){return {id:e.id,scope:e.scope,display:j(e.args),execute:y(e.args),description:e.description,...e.project?{project:e.project}:{}}}function k(e,t){return `workspace run ${t} --scope project:${e.name}`}function C(e){return (e.startsWith("project:")?e.slice(8):e).trim().toLowerCase()}function v(e){return [e.name,e.path,d.basename(e.path),e.absolutePath].filter(t=>typeof t=="string"&&t.trim().length>0).map(t=>t.trim().toLowerCase())}function x(e,t){let s=[i({id:"workspace.model",scope:"workspace",args:"workspace model --json",description:"Read the canonical workspace intelligence model."}),i({id:"workspace.doctor",scope:"workspace",args:"doctor workspace --json",description:"Check workspace health before claiming verification."}),i({id:"workspace.pipeline",scope:"workspace",args:"pipeline --json",description:"Run the governed sync, doctor, analyze, readiness, and autopilot loop."}),i({id:"workspace.contract.verify",scope:"workspace",args:"workspace contract verify --json",description:"Verify workspace contract and dependency edges."}),i({id:"workspace.verify",scope:"workspace",args:"workspace verify --json",description:"Evaluate evidence freshness and verification gates before release decisions."})],r=t?[t]:e.projects;for(let o of r)o.commands.fleetStages.includes("test")&&s.push(i({id:`project.${o.name}.test`,scope:"project",project:o.name,args:k(o,"test"),description:`Run tests for ${o.name} through workspace orchestration.`})),o.commands.fleetStages.includes("build")&&s.push(i({id:`project.${o.name}.build`,scope:"project",project:o.name,args:k(o,"build"),description:`Build ${o.name} through workspace orchestration.`}));return s}function W(e){return e.commands.fleetStages.filter(t=>t==="test"||t==="build").map(t=>`workspace run ${t}`)}function b(e,t){if(!t?.startsWith("project:"))return;let s=C(t);if(s)return e.projects.find(r=>v(r).includes(s))}function S(e,t,s){let r=[...e.validation?.issues??[]];t?.startsWith("project:")&&!s&&r.push({severity:"error",code:"context.scope.project.missing",message:`Requested project scope was not found: ${t}`,target:t});let o=r.filter(a=>a.severity==="error").length,c=r.filter(a=>a.severity==="warning").length;return {status:o>0?"failed":c>0?"warning":"passed",errors:o,warnings:c,issues:r}}function P(e){let t=[],s=[];for(let[r,o]of Object.entries(e.evidence))o?.exists?t.push(`${r}: ${o.path}`):s.push(r);return {available:t.sort(),missing:s.sort()}}function A(e){let t=e.summary.projectCount,s=e.summary.runtimes.length?e.summary.runtimes.join(", "):"no runtime",r=e.identity.surfaces.length?e.identity.surfaces.join(", "):"no detected surfaces";return `${e.workspace.name} is a ${e.identity.workspaceType} with ${t} project${t===1?"":"s"}, ${s} runtime coverage, and ${r}.`}function M(e){let t=["Do not claim a command passed unless a report or command output proves it.","Do not infer secrets or environment values from file names.","Do not change project scope without checking the selected project."];return e.contracts.exists||t.push("Workspace contract is missing; dependency and API edges may be incomplete."),e.summary.observedProjects>0&&t.push("Some projects are observed rather than first-class; command support may be partial."),t}async function V(e){let t=e.model??await j$1({workspacePath:e.workspacePath,includeEvidence:e.includeEvidence===true,observableScanDepth:e.observableScanDepth,now:e.now}),s=h(e.agent),r=b(t,e.scope),o=S(t,e.scope,r);if(e.strict===true&&o.status!=="passed"){let n=o.issues.map(p=>`${p.severity}:${p.code}:${p.target}`).join(", ");throw new Error(`Workspace context strict validation failed: ${n}`)}let c=(r?[r]:t.projects).map(n=>({name:n.name,path:n.path,kind:n.kind,runtime:n.runtime,framework:n.frameworkDisplayName,...n.generator?{generator:n.generator}:{},createCapability:n.createCapability,supportTier:n.supportTier,safeCommands:W(n),importantFiles:n.importantFiles})),a=P(t),m=A(t);return {schemaVersion:f,generatedAt:(e.now??new Date).toISOString(),agent:s,workspaceSummary:m,modelRef:".rapidkit/reports/workspace-model.json",workspace:{name:t.workspace.name,root:t.workspace.root,type:t.identity.workspaceType,...t.workspace.profile?{profile:t.workspace.profile}:{}},scope:{requested:e.scope??"workspace",...r?{activeProject:r.name}:{}},projects:c,safeCommands:x(t,r),evidence:a,policies:{mode:t.policies.mode,source:t.policies.source},contracts:{exists:t.contracts.exists,path:t.contracts.workspaceContractPath},validation:o,agentInstructions:["Read `.rapidkit/reports/INDEX.json` first, then this context pack and linked evidence reports.","Use this context as the workspace source of truth before inspecting random files.","Prefer workspace-level evidence over generic framework assumptions.","Use `display` commands when explaining steps to a human.","Use `execute` commands when launching commands from automation or tooling.","Keep project-scoped advice tied to the active project scope.","Regenerate stale grounding with `npx rapidkit workspace agent-sync --write --refresh-context`."],unsafeAssumptions:M(t),humanSummary:[m,`Evidence available: ${a.available.length}. Missing evidence groups: ${a.missing.join(", ")||"none"}.`,r?`Active project scope: ${r.name} (${r.frameworkDisplayName}).`:"Scope: whole workspace."].join(`
+import {j as j$1}from'./chunk-EN6YCX36.js';import {a}from'./chunk-3PTJID76.js';import d from'path';import g from'fs-extra';var f="workspace-context.v1",w=".rapidkit/reports/workspace-context-agent.json";function h(e){if(typeof e!="string"||!e.trim()||e==="true")return "generic";let t=e.trim().toLowerCase();return t==="codex"||t==="claude"||t==="cursor"||t==="orca"?t:"generic"}function y(e){return `npx --yes --package rapidkit rapidkit ${e}`.trim()}function j(e){return `npx rapidkit ${e}`.trim()}function i(e){return {id:e.id,scope:e.scope,display:j(e.args),execute:y(e.args),description:e.description,...e.project?{project:e.project}:{}}}function k(e,t){return `workspace run ${t} --scope project:${e.name}`}function C(e){return (e.startsWith("project:")?e.slice(8):e).trim().toLowerCase()}function v(e){return [e.name,e.path,d.basename(e.path),e.absolutePath].filter(t=>typeof t=="string"&&t.trim().length>0).map(t=>t.trim().toLowerCase())}function x(e,t){let s=[i({id:"workspace.model",scope:"workspace",args:"workspace model --json",description:"Read the canonical workspace intelligence model."}),i({id:"workspace.doctor",scope:"workspace",args:"doctor workspace --json",description:"Check workspace health before claiming verification."}),i({id:"workspace.pipeline",scope:"workspace",args:"pipeline --json",description:"Run the governed sync, doctor, analyze, readiness, and autopilot loop."}),i({id:"workspace.contract.verify",scope:"workspace",args:"workspace contract verify --json",description:"Verify workspace contract and dependency edges."}),i({id:"workspace.verify",scope:"workspace",args:"workspace verify --json",description:"Evaluate evidence freshness and verification gates before release decisions."})],r=t?[t]:e.projects;for(let o of r)o.commands.fleetStages.includes("test")&&s.push(i({id:`project.${o.name}.test`,scope:"project",project:o.name,args:k(o,"test"),description:`Run tests for ${o.name} through workspace orchestration.`})),o.commands.fleetStages.includes("build")&&s.push(i({id:`project.${o.name}.build`,scope:"project",project:o.name,args:k(o,"build"),description:`Build ${o.name} through workspace orchestration.`}));return s}function W(e){return e.commands.fleetStages.filter(t=>t==="test"||t==="build").map(t=>`workspace run ${t}`)}function b(e,t){if(!t?.startsWith("project:"))return;let s=C(t);if(s)return e.projects.find(r=>v(r).includes(s))}function S(e,t,s){let r=[...e.validation?.issues??[]];t?.startsWith("project:")&&!s&&r.push({severity:"error",code:"context.scope.project.missing",message:`Requested project scope was not found: ${t}`,target:t});let o=r.filter(a=>a.severity==="error").length,c=r.filter(a=>a.severity==="warning").length;return {status:o>0?"failed":c>0?"warning":"passed",errors:o,warnings:c,issues:r}}function P(e){let t=[],s=[];for(let[r,o]of Object.entries(e.evidence))o?.exists?t.push(`${r}: ${o.path}`):s.push(r);return {available:t.sort(),missing:s.sort()}}function A(e){let t=e.summary.projectCount,s=e.summary.runtimes.length?e.summary.runtimes.join(", "):"no runtime",r=e.identity.surfaces.length?e.identity.surfaces.join(", "):"no detected surfaces";return `${e.workspace.name} is a ${e.identity.workspaceType} with ${t} project${t===1?"":"s"}, ${s} runtime coverage, and ${r}.`}function M(e){let t=["Do not claim a command passed unless a report or command output proves it.","Do not infer secrets or environment values from file names.","Do not change project scope without checking the selected project."];return e.contracts.exists||t.push("Workspace contract is missing; dependency and API edges may be incomplete."),e.summary.observedProjects>0&&t.push("Some projects are observed rather than first-class; command support may be partial."),t}async function V(e){let t=e.model??await j$1({workspacePath:e.workspacePath,includeEvidence:e.includeEvidence===true,observableScanDepth:e.observableScanDepth,now:e.now}),s=h(e.agent),r=b(t,e.scope),o=S(t,e.scope,r);if(e.strict===true&&o.status!=="passed"){let n=o.issues.map(p=>`${p.severity}:${p.code}:${p.target}`).join(", ");throw new Error(`Workspace context strict validation failed: ${n}`)}let c=(r?[r]:t.projects).map(n=>({name:n.name,path:n.path,kind:n.kind,runtime:n.runtime,framework:n.frameworkDisplayName,...n.generator?{generator:n.generator}:{},createCapability:n.createCapability,supportTier:n.supportTier,safeCommands:W(n),importantFiles:n.importantFiles})),a=P(t),m=A(t);return {schemaVersion:f,generatedAt:(e.now??new Date).toISOString(),agent:s,workspaceSummary:m,modelRef:".rapidkit/reports/workspace-model.json",workspace:{name:t.workspace.name,root:t.workspace.root,type:t.identity.workspaceType,...t.workspace.profile?{profile:t.workspace.profile}:{}},scope:{requested:e.scope??"workspace",...r?{activeProject:r.name}:{}},projects:c,safeCommands:x(t,r),evidence:a,policies:{mode:t.policies.mode,source:t.policies.source},contracts:{exists:t.contracts.exists,path:t.contracts.workspaceContractPath},validation:o,agentInstructions:["Read `.rapidkit/reports/INDEX.json` first, then this context pack and linked evidence reports.","Use this context as the workspace source of truth before inspecting random files.","Prefer workspace-level evidence over generic framework assumptions.","Use `display` commands when explaining steps to a human.","Use `execute` commands when launching commands from automation or tooling.","Keep project-scoped advice tied to the active project scope.","Regenerate stale grounding with `npx rapidkit workspace agent-sync --write --refresh-context`."],unsafeAssumptions:M(t),humanSummary:[m,`Evidence available: ${a.available.length}. Missing evidence groups: ${a.missing.join(", ")||"none"}.`,r?`Active project scope: ${r.name} (${r.frameworkDisplayName}).`:"Scope: whole workspace."].join(`
 `)}}async function N(e,t){let s=d.join(t,w);return await g.ensureDir(d.dirname(s)),await g.writeJSON(s,a(e),{spaces:2}),s}export{f as a,w as b,V as c,N as d};

package/dist/{chunk-DMUEGR36.js → chunk-3PTJID76.js}

@@ -1,2 +1,2 @@
-import {e}from'./chunk-MIWDCR6I.js';import {a as a$1}from'./chunk-HHJAANUC.js';import {l}from'./chunk-OCGZNSOE.js';import a from'path';import d from'fs-extra';var _="unknown-run";function A(e$1){let r=e();return !r||r===_?e$1:{...e$1,runId:r}}var j=".rapidkit/workspace.contract.json",V=".rapidkit/reports/workspace-contract-verify-last-run.json",P=1,N="workspace-contract-verify.v1";function E(e){return e.replace(/\\/g,"/")}function C(e){let r=E(e).trim();return !r||r.startsWith("/")||r.startsWith("~")||/^[a-zA-Z]:\//.test(r)||r.includes("\0")?false:!r.split("/").filter(Boolean).some(o=>o===".."||o===".")}function I(e,r){return e.trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/-+/g,"-").replace(/^[-_.]+|[-_.]+$/g,"").slice(0,80)||r}function J(e){return Array.isArray(e)?e.filter(r=>typeof r=="string"&&r.trim().length>0):[]}async function T(e){let r=a.join(e,".rapidkit","workspace.json");try{let o=await d.readJson(r);return {name:typeof o.workspace_name=="string"&&o.workspace_name.trim()||typeof o.name=="string"&&o.name.trim()||a.basename(e),profile:typeof o.profile=="string"?o.profile:void 0}}catch{return {name:a.basename(e)}}}async function D(e){let r=[],o=[e],n=new Set,i=new Set([".git","node_modules",".venv","venv","dist","build","target",".next",".turbo",".cache"]);for(;o.length>0;){let c=o.shift();if(!c||n.has(c))continue;n.add(c);let p=a.join(c,".rapidkit","project.json"),u=a.join(c,".rapidkit","context.json");if(await d.pathExists(p)||await d.pathExists(u)){r.push(await d.pathExists(p)?p:u);continue}let t;try{t=await d.readdir(c,{withFileTypes:true});}catch{continue}for(let s of t)!s.isDirectory()||i.has(s.name)||o.push(a.join(c,s.name));}return r.sort()}function G(e){let r=(e||"").toLowerCase();if(r.includes("fastapi"))return "fastapi";if(r.includes("nestjs"))return "nestjs";if(r.includes("springboot"))return "springboot";if(r.includes("gofiber"))return "fiber";if(r.includes("gogin"))return "gin"}function K(e,r){let o=(e||"").toLowerCase(),n=(r||"").toLowerCase();return o.includes("fastapi")?8e3:o.includes("nestjs")?3e3:o.includes("springboot")?8080:o.includes("gofiber")?3e3:o.includes("gogin")?8080:n==="node"?3e3:n==="python"?8e3:n==="java"||n==="go"?8080:null}function F(e,r){let o=e;for(;r.has(o)&&o<65535;)o+=1;return o}function w(e,r,o){let n=K(r.kit,r.runtime),i=e?.ports||[],c=i.length>0?i:n?[{name:"http",port:F(n,o),protocol:"http"}]:[];for(let t of c)o.add(t.port);let p={...r,...e,slug:e?.slug||r.slug,relativePath:e?.relativePath&&C(e.relativePath)?e.relativePath:r.relativePath,source:e?.source||r.source,relationship:e?.relationship||r.relationship,externalPath:e?.externalPath||r.externalPath,runtime:e?.runtime||r.runtime,framework:e?.framework||r.framework,kit:e?.kit||r.kit,modules:e?.modules?.length?e.modules:r.modules,ports:c,contracts:{owns:e?.contracts?.owns||[],apis:e?.contracts?.apis||[],publishes:e?.contracts?.publishes||[],consumes:e?.contracts?.consumes||[],dependsOn:e?.contracts?.dependsOn||[],env:e?.contracts?.env||[]}},u=JSON.stringify(e||null)!==JSON.stringify(p);return {project:p,changed:u}}async function S(e){let r=a.resolve(e.workspacePath),o=await T(r),n=await D(r),i=await a$1(r),c=[];for(let t of i){let s=a.resolve(t.path),h=a.join(s,".rapidkit","project.json"),f=a.join(s,".rapidkit","context.json"),k=await d.pathExists(h)?h:await d.pathExists(f)?f:null;!k||n.some(l=>a.resolve(l)===a.resolve(k))||c.push({projectJsonPath:k,registryEntry:t});}let p=[],u=[...n.map(t=>({projectJsonPath:t})),...c];for(let{projectJsonPath:t,registryEntry:s}of u){let h=a.dirname(a.dirname(t)),f=E(a.relative(r,h)),k=s!==void 0&&!C(f),l=I(s?.name||a.basename(h),a.basename(h)),m=k?`external/${l}`:f||l,g=await d.readJson(t),y=typeof g.kit_name=="string"&&g.kit_name||typeof g.kit=="string"&&g.kit||void 0,x=typeof g.framework=="string"&&g.framework||G(y);p.push({slug:s?.name||m||a.basename(h),relativePath:m,source:s?.source??"workspace",relationship:s?.relationship,externalPath:k?h:void 0,runtime:typeof g.runtime=="string"?g.runtime:void 0,framework:x,kit:y,modules:J(g.modules),ports:[],contracts:{owns:[],apis:[],publishes:[],consumes:[],dependsOn:[],env:[]}});}return {schemaVersion:P,kind:"rapidkit.workspace.contract",generatedAt:(e.now??new Date).toISOString(),workspace:o,projects:p}}async function Q(e){let r=a.resolve(e.outputPath||a.join(e.workspacePath,j));if(await d.pathExists(r)&&e.force!==true)throw new Error(`Workspace contract already exists: ${r}. Use --force to overwrite.`);let o=await S({workspacePath:e.workspacePath,now:e.now}),n=new Set,i={...o,projects:o.projects.map(p=>w(void 0,p,n).project)};await d.ensureDir(a.dirname(r)),await d.writeJson(r,i,{spaces:2});let{publishWorkspaceRegistrySummary:c}=await import('./workspace-registry-summary-ZXGKL2NT.js');return await c(e.workspacePath,{now:e.now}),{contractPath:r,contract:i}}async function X(e){let r=a.resolve(e.workspacePath),o=a.join(r,j),n=await S({workspacePath:r,now:e.now}),i=await d.pathExists(o)?await d.readJson(o):null,c=new Map((i?.projects||[]).map(l=>[l.slug,l])),p=new Set,u=[],t=[],s=[];for(let l of n.projects){let m=c.get(l.slug),g=w(m,l,p);m?g.changed&&t.push(l.slug):u.push(l.slug),s.push(g.project),c.delete(l.slug);}for(let l of c.values()){let m=w(l,l,p);s.push(m.project);}let h={schemaVersion:P,kind:"rapidkit.workspace.contract",generatedAt:(e.now??new Date).toISOString(),workspace:{...n.workspace,...i?.workspace||{},name:i?.workspace?.name||n.workspace.name},projects:s.sort((l,m)=>l.slug.localeCompare(m.slug))};await d.ensureDir(a.dirname(o)),await d.writeJson(o,h,{spaces:2});let f=await M({workspacePath:r}),{publishWorkspaceRegistrySummary:k}=await import('./workspace-registry-summary-ZXGKL2NT.js');return await k(r,{now:e.now}),{contractPath:o,contract:h,addedProjects:u,updatedProjects:t,verification:f}}async function R(e){let r=a.resolve(e.contractPath||a.join(e.workspacePath,j)),o=await d.readJson(r);return {contractPath:r,contract:o}}async function tt(e){let{contractPath:r,contract:o}=await R(e),n=o.projects.map(t=>({id:t.slug,label:t.slug,relativePath:t.relativePath,source:t.source,relationship:t.relationship,externalPath:t.externalPath,runtime:t.runtime,framework:t.framework,kit:t.kit,modules:t.modules,ports:t.ports,apis:t.contracts.apis,owns:t.contracts.owns,env:t.contracts.env})),i=new Set(n.map(t=>t.id)),c=new Map,p=[];for(let t of o.projects){for(let s of t.contracts.dependsOn||[])i.has(s)&&p.push({from:s,to:t.slug,type:"dependency",label:"dependsOn"});for(let s of t.contracts.publishes||[])c.has(s)||c.set(s,new Set),c.get(s)?.add(t.slug);}for(let t of o.projects)for(let s of t.contracts.consumes||[]){let h=c.get(s);if(h)for(let f of h)f!==t.slug&&p.push({from:f,to:t.slug,type:"event",label:s});}let u={schemaVersion:1,kind:"rapidkit.workspace.contract.graph",workspace:o.workspace,generatedAt:new Date().toISOString(),nodes:n.sort((t,s)=>t.id.localeCompare(s.id)),edges:p.sort((t,s)=>`${t.from}:${t.to}:${t.type}:${t.label}`.localeCompare(`${s.from}:${s.to}:${s.type}:${s.label}`)),summary:{projectCount:n.length,dependencyEdges:p.filter(t=>t.type==="dependency").length,eventEdges:p.filter(t=>t.type==="event").length,portCount:n.reduce((t,s)=>t+s.ports.length,0),apiCount:n.reduce((t,s)=>t+s.apis.length,0)}};return {contractPath:r,graph:u}}async function M(e){let{contractPath:r,contract:o}=await R(e),n=[],i=[];o.kind!=="rapidkit.workspace.contract"&&n.push("Contract kind must be rapidkit.workspace.contract."),o.schemaVersion!==P&&n.push(`Contract schemaVersion must be ${P}.`),o.workspace?.name||n.push("Contract workspace.name is required."),Array.isArray(o.projects)||n.push("Contract projects must be an array.");let c=new Set,p=new Map;for(let t of o.projects||[]){if(!t.slug){n.push("Every project must declare slug.");continue}c.has(t.slug)&&n.push(`Duplicate project slug: ${t.slug}.`),c.add(t.slug),t.relativePath?C(t.relativePath)||n.push(`Project ${t.slug} declares unsafe relativePath: ${t.relativePath}.`):n.push(`Project ${t.slug} must declare relativePath.`),t.externalPath&&(t.relationship==="adopted"||t.source==="adopted-local"||t.source==="local-folder"||t.source==="git-url"||n.push(`Project ${t.slug} declares externalPath without imported/adopted provenance.`),a.isAbsolute(t.externalPath)||n.push(`Project ${t.slug} declares non-absolute externalPath.`));for(let s of t.ports||[]){(!Number.isInteger(s.port)||s.port<1||s.port>65535)&&n.push(`Project ${t.slug} declares invalid port: ${s.port}.`);let h=p.get(s.port);h&&n.push(`Port ${s.port} is claimed by both ${h} and ${t.slug}.`),p.set(s.port,t.slug);}for(let s of t.contracts?.apis||[])(!s.name?.trim()||!s.basePath?.startsWith("/"))&&n.push(`Project ${t.slug} declares invalid API contract.`);for(let s of [...t.contracts?.publishes||[],...t.contracts?.consumes||[]])s.trim()||n.push(`Project ${t.slug} declares an empty event contract.`);for(let s of t.contracts?.env||[])/^[A-Z_][A-Z0-9_]*$/.test(s)||n.push(`Project ${t.slug} declares invalid env contract: ${s}.`);for(let s of t.contracts?.dependsOn||[])c.has(s);}for(let t of o.projects||[])for(let s of t.contracts?.dependsOn||[])c.has(s)||n.push(`Project ${t.slug} depends on unknown project: ${s}.`);i.push({id:"schema",status:o.kind==="rapidkit.workspace.contract"&&o.schemaVersion===P?"passed":"failed",message:"Contract schema and kind are valid."}),i.push({id:"projects",status:Array.isArray(o.projects)?"passed":"failed",message:`Contract declares ${Array.isArray(o.projects)?o.projects.length:0} project(s).`}),i.push({id:"ports",status:n.some(t=>t.toLowerCase().includes("port"))?"failed":"passed",message:"Project port declarations are valid and collision-free."}),i.push({id:"dependencies",status:n.some(t=>t.includes("depends on unknown project"))?"failed":"passed",message:"Project dependencies point to known project slugs."}),i.push({id:"contracts",status:n.some(t=>t.includes("unsafe relativePath")||t.includes("invalid API contract")||t.includes("event contract")||t.includes("env contract"))?"failed":"passed",message:"Project path, API, event, and env contracts are valid."});let u=await l(e.workspacePath);if(u.moduleCount>0){for(let t of u.issues)n.push(`${a.basename(t.projectRoot)}: ${t.message} (slug=${t.slug})`);i.push({id:"module-paths",status:u.status,message:u.status==="passed"?`All ${u.moduleCount} registered module(s) resolve under canonical paths.`:`${u.issues.length} registered module(s) missing canonical install paths.`});}else e.strict&&i.push({id:"module-paths",status:"passed",message:"No registry-backed modules declared in workspace projects."});return {status:n.length>0?"failed":"passed",contractPath:r,projectCount:Array.isArray(o.projects)?o.projects.length:0,checks:i,violations:n}}async function et(e){let r=a.resolve(e.workspacePath),o=a.join(r,V);await d.ensureDir(a.dirname(o));let n={schemaVersion:N,generatedAt:e.generatedAt??new Date().toISOString(),status:e.result.status,contractPath:e.result.contractPath,projectCount:e.result.projectCount,checks:e.result.checks,violations:e.result.violations};return await d.writeJSON(o,A(n),{spaces:2}),o}
+import {l}from'./chunk-OCGZNSOE.js';import {e}from'./chunk-MIWDCR6I.js';import {a as a$1}from'./chunk-HHJAANUC.js';import a from'path';import d from'fs-extra';var _="unknown-run";function A(e$1){let r=e();return !r||r===_?e$1:{...e$1,runId:r}}var j=".rapidkit/workspace.contract.json",V=".rapidkit/reports/workspace-contract-verify-last-run.json",P=1,N="workspace-contract-verify.v1";function E(e){return e.replace(/\\/g,"/")}function C(e){let r=E(e).trim();return !r||r.startsWith("/")||r.startsWith("~")||/^[a-zA-Z]:\//.test(r)||r.includes("\0")?false:!r.split("/").filter(Boolean).some(o=>o===".."||o===".")}function I(e,r){return e.trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/-+/g,"-").replace(/^[-_.]+|[-_.]+$/g,"").slice(0,80)||r}function J(e){return Array.isArray(e)?e.filter(r=>typeof r=="string"&&r.trim().length>0):[]}async function T(e){let r=a.join(e,".rapidkit","workspace.json");try{let o=await d.readJson(r);return {name:typeof o.workspace_name=="string"&&o.workspace_name.trim()||typeof o.name=="string"&&o.name.trim()||a.basename(e),profile:typeof o.profile=="string"?o.profile:void 0}}catch{return {name:a.basename(e)}}}async function D(e){let r=[],o=[e],n=new Set,i=new Set([".git","node_modules",".venv","venv","dist","build","target",".next",".turbo",".cache"]);for(;o.length>0;){let c=o.shift();if(!c||n.has(c))continue;n.add(c);let p=a.join(c,".rapidkit","project.json"),u=a.join(c,".rapidkit","context.json");if(await d.pathExists(p)||await d.pathExists(u)){r.push(await d.pathExists(p)?p:u);continue}let t;try{t=await d.readdir(c,{withFileTypes:true});}catch{continue}for(let s of t)!s.isDirectory()||i.has(s.name)||o.push(a.join(c,s.name));}return r.sort()}function G(e){let r=(e||"").toLowerCase();if(r.includes("fastapi"))return "fastapi";if(r.includes("nestjs"))return "nestjs";if(r.includes("springboot"))return "springboot";if(r.includes("gofiber"))return "fiber";if(r.includes("gogin"))return "gin"}function K(e,r){let o=(e||"").toLowerCase(),n=(r||"").toLowerCase();return o.includes("fastapi")?8e3:o.includes("nestjs")?3e3:o.includes("springboot")?8080:o.includes("gofiber")?3e3:o.includes("gogin")?8080:n==="node"?3e3:n==="python"?8e3:n==="java"||n==="go"?8080:null}function F(e,r){let o=e;for(;r.has(o)&&o<65535;)o+=1;return o}function w(e,r,o){let n=K(r.kit,r.runtime),i=e?.ports||[],c=i.length>0?i:n?[{name:"http",port:F(n,o),protocol:"http"}]:[];for(let t of c)o.add(t.port);let p={...r,...e,slug:e?.slug||r.slug,relativePath:e?.relativePath&&C(e.relativePath)?e.relativePath:r.relativePath,source:e?.source||r.source,relationship:e?.relationship||r.relationship,externalPath:e?.externalPath||r.externalPath,runtime:e?.runtime||r.runtime,framework:e?.framework||r.framework,kit:e?.kit||r.kit,modules:e?.modules?.length?e.modules:r.modules,ports:c,contracts:{owns:e?.contracts?.owns||[],apis:e?.contracts?.apis||[],publishes:e?.contracts?.publishes||[],consumes:e?.contracts?.consumes||[],dependsOn:e?.contracts?.dependsOn||[],env:e?.contracts?.env||[]}},u=JSON.stringify(e||null)!==JSON.stringify(p);return {project:p,changed:u}}async function S(e){let r=a.resolve(e.workspacePath),o=await T(r),n=await D(r),i=await a$1(r),c=[];for(let t of i){let s=a.resolve(t.path),h=a.join(s,".rapidkit","project.json"),f=a.join(s,".rapidkit","context.json"),k=await d.pathExists(h)?h:await d.pathExists(f)?f:null;!k||n.some(l=>a.resolve(l)===a.resolve(k))||c.push({projectJsonPath:k,registryEntry:t});}let p=[],u=[...n.map(t=>({projectJsonPath:t})),...c];for(let{projectJsonPath:t,registryEntry:s}of u){let h=a.dirname(a.dirname(t)),f=E(a.relative(r,h)),k=s!==void 0&&!C(f),l=I(s?.name||a.basename(h),a.basename(h)),m=k?`external/${l}`:f||l,g=await d.readJson(t),y=typeof g.kit_name=="string"&&g.kit_name||typeof g.kit=="string"&&g.kit||void 0,x=typeof g.framework=="string"&&g.framework||G(y);p.push({slug:s?.name||m||a.basename(h),relativePath:m,source:s?.source??"workspace",relationship:s?.relationship,externalPath:k?h:void 0,runtime:typeof g.runtime=="string"?g.runtime:void 0,framework:x,kit:y,modules:J(g.modules),ports:[],contracts:{owns:[],apis:[],publishes:[],consumes:[],dependsOn:[],env:[]}});}return {schemaVersion:P,kind:"rapidkit.workspace.contract",generatedAt:(e.now??new Date).toISOString(),workspace:o,projects:p}}async function Q(e){let r=a.resolve(e.outputPath||a.join(e.workspacePath,j));if(await d.pathExists(r)&&e.force!==true)throw new Error(`Workspace contract already exists: ${r}. Use --force to overwrite.`);let o=await S({workspacePath:e.workspacePath,now:e.now}),n=new Set,i={...o,projects:o.projects.map(p=>w(void 0,p,n).project)};await d.ensureDir(a.dirname(r)),await d.writeJson(r,i,{spaces:2});let{publishWorkspaceRegistrySummary:c}=await import('./workspace-registry-summary-X5WRUU3T.js');return await c(e.workspacePath,{now:e.now}),{contractPath:r,contract:i}}async function X(e){let r=a.resolve(e.workspacePath),o=a.join(r,j),n=await S({workspacePath:r,now:e.now}),i=await d.pathExists(o)?await d.readJson(o):null,c=new Map((i?.projects||[]).map(l=>[l.slug,l])),p=new Set,u=[],t=[],s=[];for(let l of n.projects){let m=c.get(l.slug),g=w(m,l,p);m?g.changed&&t.push(l.slug):u.push(l.slug),s.push(g.project),c.delete(l.slug);}for(let l of c.values()){let m=w(l,l,p);s.push(m.project);}let h={schemaVersion:P,kind:"rapidkit.workspace.contract",generatedAt:(e.now??new Date).toISOString(),workspace:{...n.workspace,...i?.workspace||{},name:i?.workspace?.name||n.workspace.name},projects:s.sort((l,m)=>l.slug.localeCompare(m.slug))};await d.ensureDir(a.dirname(o)),await d.writeJson(o,h,{spaces:2});let f=await M({workspacePath:r}),{publishWorkspaceRegistrySummary:k}=await import('./workspace-registry-summary-X5WRUU3T.js');return await k(r,{now:e.now}),{contractPath:o,contract:h,addedProjects:u,updatedProjects:t,verification:f}}async function R(e){let r=a.resolve(e.contractPath||a.join(e.workspacePath,j)),o=await d.readJson(r);return {contractPath:r,contract:o}}async function tt(e){let{contractPath:r,contract:o}=await R(e),n=o.projects.map(t=>({id:t.slug,label:t.slug,relativePath:t.relativePath,source:t.source,relationship:t.relationship,externalPath:t.externalPath,runtime:t.runtime,framework:t.framework,kit:t.kit,modules:t.modules,ports:t.ports,apis:t.contracts.apis,owns:t.contracts.owns,env:t.contracts.env})),i=new Set(n.map(t=>t.id)),c=new Map,p=[];for(let t of o.projects){for(let s of t.contracts.dependsOn||[])i.has(s)&&p.push({from:s,to:t.slug,type:"dependency",label:"dependsOn"});for(let s of t.contracts.publishes||[])c.has(s)||c.set(s,new Set),c.get(s)?.add(t.slug);}for(let t of o.projects)for(let s of t.contracts.consumes||[]){let h=c.get(s);if(h)for(let f of h)f!==t.slug&&p.push({from:f,to:t.slug,type:"event",label:s});}let u={schemaVersion:1,kind:"rapidkit.workspace.contract.graph",workspace:o.workspace,generatedAt:new Date().toISOString(),nodes:n.sort((t,s)=>t.id.localeCompare(s.id)),edges:p.sort((t,s)=>`${t.from}:${t.to}:${t.type}:${t.label}`.localeCompare(`${s.from}:${s.to}:${s.type}:${s.label}`)),summary:{projectCount:n.length,dependencyEdges:p.filter(t=>t.type==="dependency").length,eventEdges:p.filter(t=>t.type==="event").length,portCount:n.reduce((t,s)=>t+s.ports.length,0),apiCount:n.reduce((t,s)=>t+s.apis.length,0)}};return {contractPath:r,graph:u}}async function M(e){let{contractPath:r,contract:o}=await R(e),n=[],i=[];o.kind!=="rapidkit.workspace.contract"&&n.push("Contract kind must be rapidkit.workspace.contract."),o.schemaVersion!==P&&n.push(`Contract schemaVersion must be ${P}.`),o.workspace?.name||n.push("Contract workspace.name is required."),Array.isArray(o.projects)||n.push("Contract projects must be an array.");let c=new Set,p=new Map;for(let t of o.projects||[]){if(!t.slug){n.push("Every project must declare slug.");continue}c.has(t.slug)&&n.push(`Duplicate project slug: ${t.slug}.`),c.add(t.slug),t.relativePath?C(t.relativePath)||n.push(`Project ${t.slug} declares unsafe relativePath: ${t.relativePath}.`):n.push(`Project ${t.slug} must declare relativePath.`),t.externalPath&&(t.relationship==="adopted"||t.source==="adopted-local"||t.source==="local-folder"||t.source==="git-url"||n.push(`Project ${t.slug} declares externalPath without imported/adopted provenance.`),a.isAbsolute(t.externalPath)||n.push(`Project ${t.slug} declares non-absolute externalPath.`));for(let s of t.ports||[]){(!Number.isInteger(s.port)||s.port<1||s.port>65535)&&n.push(`Project ${t.slug} declares invalid port: ${s.port}.`);let h=p.get(s.port);h&&n.push(`Port ${s.port} is claimed by both ${h} and ${t.slug}.`),p.set(s.port,t.slug);}for(let s of t.contracts?.apis||[])(!s.name?.trim()||!s.basePath?.startsWith("/"))&&n.push(`Project ${t.slug} declares invalid API contract.`);for(let s of [...t.contracts?.publishes||[],...t.contracts?.consumes||[]])s.trim()||n.push(`Project ${t.slug} declares an empty event contract.`);for(let s of t.contracts?.env||[])/^[A-Z_][A-Z0-9_]*$/.test(s)||n.push(`Project ${t.slug} declares invalid env contract: ${s}.`);for(let s of t.contracts?.dependsOn||[])c.has(s);}for(let t of o.projects||[])for(let s of t.contracts?.dependsOn||[])c.has(s)||n.push(`Project ${t.slug} depends on unknown project: ${s}.`);i.push({id:"schema",status:o.kind==="rapidkit.workspace.contract"&&o.schemaVersion===P?"passed":"failed",message:"Contract schema and kind are valid."}),i.push({id:"projects",status:Array.isArray(o.projects)?"passed":"failed",message:`Contract declares ${Array.isArray(o.projects)?o.projects.length:0} project(s).`}),i.push({id:"ports",status:n.some(t=>t.toLowerCase().includes("port"))?"failed":"passed",message:"Project port declarations are valid and collision-free."}),i.push({id:"dependencies",status:n.some(t=>t.includes("depends on unknown project"))?"failed":"passed",message:"Project dependencies point to known project slugs."}),i.push({id:"contracts",status:n.some(t=>t.includes("unsafe relativePath")||t.includes("invalid API contract")||t.includes("event contract")||t.includes("env contract"))?"failed":"passed",message:"Project path, API, event, and env contracts are valid."});let u=await l(e.workspacePath);if(u.moduleCount>0){for(let t of u.issues)n.push(`${a.basename(t.projectRoot)}: ${t.message} (slug=${t.slug})`);i.push({id:"module-paths",status:u.status,message:u.status==="passed"?`All ${u.moduleCount} registered module(s) resolve under canonical paths.`:`${u.issues.length} registered module(s) missing canonical install paths.`});}else e.strict&&i.push({id:"module-paths",status:"passed",message:"No registry-backed modules declared in workspace projects."});return {status:n.length>0?"failed":"passed",contractPath:r,projectCount:Array.isArray(o.projects)?o.projects.length:0,checks:i,violations:n}}async function et(e){let r=a.resolve(e.workspacePath),o=a.join(r,V);await d.ensureDir(a.dirname(o));let n={schemaVersion:N,generatedAt:e.generatedAt??new Date().toISOString(),status:e.result.status,contractPath:e.result.contractPath,projectCount:e.result.projectCount,checks:e.result.checks,violations:e.result.violations};return await d.writeJSON(o,A(n),{spaces:2}),o}
 export{A as a,j as b,V as c,P as d,N as e,D as f,S as g,Q as h,X as i,R as j,tt as k,M as l,et as m};