@lssm/bundle.contractspec-workspace 0.0.0-canary-20251216030333 → 0.0.0-canary-20251216033905

package/dist/adapters/fs.js

@@ -1 +1 @@
-import{access as e,mkdir as t,readFile as n,rm as r,stat as i,writeFile as a}from"node:fs/promises";import{basename as o,dirname as s,isAbsolute as c,join as l,relative as u,resolve as d}from"node:path";import{glob as f}from"glob";const p=[`**/*.contracts.ts`,`**/*.event.ts`,`**/*.presentation.ts`,`**/*.feature.ts`,`**/*.capability.ts`,`**/*.workflow.ts`,`**/*.data-view.ts`,`**/*.form.ts`,`**/*.migration.ts`,`**/*.telemetry.ts`,`**/*.experiment.ts`,`**/*.app-config.ts`,`**/*.integration.ts`,`**/*.knowledge.ts`,`**/*.policy.ts`,`**/*.test-spec.ts`],m=[`node_modules/**`,`dist/**`,`.turbo/**`];function h(h){let g=h??process.cwd();return{async exists(t){try{return await e(_(t)),!0}catch{return!1}},async readFile(e){return n(_(e),`utf-8`)},async writeFile(e,n){let r=_(e);await t(s(r),{recursive:!0}),await a(r,n,`utf-8`)},async remove(e){await r(_(e),{recursive:!0,force:!0})},async stat(e){let t=await i(_(e));return{size:t.size,isFile:t.isFile(),isDirectory:t.isDirectory(),mtime:t.mtime}},async mkdir(e){await t(_(e),{recursive:!0})},async glob(e){let t=e.patterns??(e.pattern?[e.pattern]:p),n=e.ignore??m,r=[];for(let e of t){let t=await f(e,{cwd:g,ignore:n});r.push(...t)}return Array.from(new Set(r)).sort((e,t)=>e.localeCompare(t))},resolve(...e){let[t,...n]=e;return t?d(g,t,...n):g},dirname(e){return s(e)},basename(e){return o(e)},join(...e){return l(...e)},relative(e,t){return u(e,t)}};function _(e){return c(e)?e:d(g,e)}}export{h as createNodeFsAdapter};
+import{access as e,mkdir as t,readFile as n,rm as r,stat as i,writeFile as a}from"node:fs/promises";import{basename as o,dirname as s,isAbsolute as c,join as l,relative as u,resolve as d}from"node:path";import{glob as f}from"glob";const p=[`**/*.contracts.ts`,`**/*.event.ts`,`**/*.presentation.ts`,`**/*.feature.ts`,`**/*.capability.ts`,`**/*.workflow.ts`,`**/*.data-view.ts`,`**/*.form.ts`,`**/*.migration.ts`,`**/*.telemetry.ts`,`**/*.experiment.ts`,`**/*.app-config.ts`,`**/*.integration.ts`,`**/*.knowledge.ts`,`**/*.policy.ts`,`**/*.test-spec.ts`],m=[`node_modules/**`,`dist/**`,`.turbo/**`];function h(h){let g=h??process.cwd();return{async exists(t){try{return await e(_(t)),!0}catch{return!1}},async readFile(e){return n(_(e),`utf-8`)},async writeFile(e,n){let r=_(e);await t(s(r),{recursive:!0}),await a(r,n,`utf-8`)},async remove(e){await r(_(e),{recursive:!0,force:!0})},async stat(e){let t=await i(_(e));return{size:t.size,isFile:t.isFile(),isDirectory:t.isDirectory(),mtime:t.mtime}},async mkdir(e){await t(_(e),{recursive:!0})},async glob(e){let t=e.patterns??(e.pattern?[e.pattern]:p),n=e.ignore??m,r=e.cwd??g,i=[];for(let e of t){let t=await f(e,{cwd:r,ignore:n});i.push(...t)}return Array.from(new Set(i)).sort((e,t)=>e.localeCompare(t))},resolve(...e){let[t,...n]=e;return t?d(g,t,...n):g},dirname(e){return s(e)},basename(e){return o(e)},join(...e){return l(...e)},relative(e,t){return u(e,t)}};function _(e){return c(e)?e:d(g,e)}}export{h as createNodeFsAdapter};

package/dist/services/doctor/checks/workspace.js

@@ -1 +1 @@
-async function e(e,a){let o=[];return o.push(await t(e,a)),o.push(await n(e,a)),o.push(await r(e,a)),o.push(await i(e,a)),o}async function t(e,t){let n=e.join(t.workspaceRoot,`package.json`);return await e.exists(n)?{category:`workspace`,name:`Valid Workspace`,status:`pass`,message:`package.json found`}:{category:`workspace`,name:`Valid Workspace`,status:`fail`,message:`No package.json found`,details:`This does not appear to be a Node.js/TypeScript project`}}async function n(e,t){for(let n of[`src/contracts`,`contracts`,`src/specs`,`specs`]){let r=e.join(t.workspaceRoot,n);if(await e.exists(r))return{category:`workspace`,name:`Contracts Directory`,status:`pass`,message:`Contracts directory found: ${n}`}}return{category:`workspace`,name:`Contracts Directory`,status:`warn`,message:`No contracts directory found`,details:`Create src/contracts/ to organize your specs`,fix:{description:`Create src/contracts/ directory`,apply:async()=>{try{let n=e.join(t.workspaceRoot,`src`,`contracts`);return await e.mkdir(n),{success:!0,message:`Created src/contracts/`}}catch(e){return{success:!1,message:`Failed: ${e instanceof Error?e.message:String(e)}`}}}}}}async function r(e,t){try{let n=await e.glob({patterns:[`**/*.contracts.ts`,`**/*.event.ts`,`**/*.presentation.ts`,`**/*.feature.ts`],ignore:[`node_modules/**`,`dist/**`]});return n.length>0?{category:`workspace`,name:`Contract Files`,status:`pass`,message:`Found ${n.length} contract file(s)`,details:t.verbose?n.slice(0,5).join(`, `):void 0}:{category:`workspace`,name:`Contract Files`,status:`warn`,message:`No contract files found`,details:`Create specs using "contractspec create" or VS Code command`}}catch{return{category:`workspace`,name:`Contract Files`,status:`skip`,message:`Could not search for contract files`}}}async function i(e,t){let n=e.join(t.workspaceRoot,`.contractsrc.json`);try{if(!await e.exists(n))return{category:`workspace`,name:`Output Directory`,status:`skip`,message:`No config file to check output directory`};let r=await e.readFile(n),i=JSON.parse(r).outputDir??`./src`,a=e.join(t.workspaceRoot,i);return await e.exists(a)?{category:`workspace`,name:`Output Directory`,status:`pass`,message:`Output directory exists: ${i}`}:{category:`workspace`,name:`Output Directory`,status:`warn`,message:`Output directory not found: ${i}`,fix:{description:`Create ${i} directory`,apply:async()=>{try{return await e.mkdir(a),{success:!0,message:`Created ${i}`}}catch(e){return{success:!1,message:`Failed: ${e instanceof Error?e.message:String(e)}`}}}}}}catch{return{category:`workspace`,name:`Output Directory`,status:`skip`,message:`Could not check output directory`}}}export{e as runWorkspaceChecks};
+const e=[`src/contracts`,`contracts`,`src/specs`,`specs`];async function t(e,t){let o=[];return o.push(n(t)),o.push(await r(e,t)),o.push(await i(e,t)),o.push(await a(e,t)),o.push(await s(e,t)),o}function n(e){if(e.isMonorepo){let t=e.packageName?` in package "${e.packageName}"`:``,n=e.packageRoot===e.workspaceRoot?``:` (package root: ${e.packageRoot})`;return{category:`workspace`,name:`Monorepo Detection`,status:`pass`,message:`Monorepo detected${t}`,details:e.verbose?`Workspace root: ${e.workspaceRoot}${n}`:void 0}}return{category:`workspace`,name:`Monorepo Detection`,status:`pass`,message:`Single project (not a monorepo)`}}async function r(e,t){let n=t.isMonorepo?[t.packageRoot,t.workspaceRoot]:[t.workspaceRoot];for(let r of n){let n=e.join(r,`package.json`);if(await e.exists(n))return{category:`workspace`,name:`Valid Workspace`,status:`pass`,message:`package.json found`,details:t.verbose&&t.isMonorepo?`Found at: ${r}`:void 0}}return{category:`workspace`,name:`Valid Workspace`,status:`fail`,message:`No package.json found`,details:`This does not appear to be a Node.js/TypeScript project`}}async function i(t,n){let r=n.isMonorepo?[n.packageRoot,n.workspaceRoot]:[n.workspaceRoot],i=n.isMonorepo?n.packageRoot:n.workspaceRoot;for(let i of r)for(let r of e){let e=t.join(i,r);if(await t.exists(e)){let e=i===n.packageRoot?`package`:`workspace`;return{category:`workspace`,name:`Contracts Directory`,status:`pass`,message:`Contracts directory found: ${r}`,details:n.isMonorepo?`Found at ${e} level`:void 0}}}let a=(n.isMonorepo,`src/contracts`),o=n.isMonorepo?` in package "${n.packageName??n.packageRoot}"`:``;return{category:`workspace`,name:`Contracts Directory`,status:`warn`,message:`No contracts directory found`,details:`Create ${a}/${o} to organize your specs`,fix:{description:`Create ${a}/ directory${o}`,apply:async()=>{try{let e=t.join(i,`src`,`contracts`);return await t.mkdir(e),{success:!0,message:`Created ${a}/`}}catch(e){return{success:!1,message:`Failed: ${e instanceof Error?e.message:String(e)}`}}}}}}async function a(e,t){try{let n=[`**/*.contracts.ts`,`**/*.event.ts`,`**/*.presentation.ts`,`**/*.feature.ts`],r=t.isMonorepo?t.packageRoot:t.workspaceRoot,i=await e.glob({patterns:n,ignore:[`node_modules/**`,`dist/**`],cwd:r});if(i.length>0){let e=t.isMonorepo?` (in current package)`:``;return{category:`workspace`,name:`Contract Files`,status:`pass`,message:`Found ${i.length} contract file(s)${e}`,details:t.verbose?i.slice(0,5).join(`, `):void 0}}return{category:`workspace`,name:`Contract Files`,status:`warn`,message:t.isMonorepo?`No contract files found in package "${t.packageName??`current`}"`:`No contract files found`,details:`Create specs using "contractspec create" or VS Code command`}}catch{return{category:`workspace`,name:`Contract Files`,status:`skip`,message:`Could not search for contract files`}}}async function o(e,t){if(t.isMonorepo&&t.packageRoot!==t.workspaceRoot){let n=e.join(t.packageRoot,`.contractsrc.json`);if(await e.exists(n))return{path:n,root:t.packageRoot,level:`package`}}let n=e.join(t.workspaceRoot,`.contractsrc.json`);return await e.exists(n)?{path:n,root:t.workspaceRoot,level:`workspace`}:null}async function s(e,t){try{let n=await o(e,t);if(!n)return{category:`workspace`,name:`Output Directory`,status:`skip`,message:t.isMonorepo?`No config file found at package or workspace level`:`No config file to check output directory`};let r=await e.readFile(n.path),i=JSON.parse(r).outputDir??`./src`,a=e.join(n.root,i),s=t.isMonorepo?` (${n.level} level)`:``;return await e.exists(a)?{category:`workspace`,name:`Output Directory`,status:`pass`,message:`Output directory exists: ${i}${s}`,details:t.verbose?`Resolved to: ${a}`:void 0}:{category:`workspace`,name:`Output Directory`,status:`warn`,message:`Output directory not found: ${i}${s}`,details:t.verbose?`Expected at: ${a}`:void 0,fix:{description:`Create ${i} directory`,apply:async()=>{try{return await e.mkdir(a),{success:!0,message:`Created ${i}`}}catch(e){return{success:!1,message:`Failed: ${e instanceof Error?e.message:String(e)}`}}}}}}catch{return{category:`workspace`,name:`Output Directory`,status:`skip`,message:`Could not check output directory`}}}export{t as runWorkspaceChecks};

package/dist/services/doctor/doctor-service.js

@@ -1,2 +1,2 @@
-import{ALL_CHECK_CATEGORIES as e,CHECK_CATEGORY_LABELS as t}from"./types.js";import{runCliChecks as n}from"./checks/cli.js";import{runConfigChecks as r}from"./checks/config.js";import{runMcpChecks as i}from"./checks/mcp.js";import{runDepsChecks as a}from"./checks/deps.js";import{runWorkspaceChecks as o}from"./checks/workspace.js";import{runAiChecks as s}from"./checks/ai.js";import"./checks/index.js";const c={confirm:async()=>!1,input:async()=>``};async function l(n,r,i=c){let{fs:a,logger:o}=n,s=r.categories??e,l={workspaceRoot:r.workspaceRoot,verbose:r.verbose??!1},d=[];for(let e of s){if(r.skipAi&&e===`ai`)continue;o.info(`Checking ${t[e]}...`);let n=await u(e,a,l,i);for(let e of n){if(e.fix&&(e.status===`fail`||e.status===`warn`)&&(r.autoFix||await i.confirm(`Fix "${e.name}"? ${e.fix.description}`))){o.info(`Applying fix: ${e.fix.description}`);let t=await e.fix.apply();t.success?(o.info(`✓ ${t.message}`),e.status=`pass`,e.message=`Fixed: ${t.message}`,e.fix=void 0):o.warn(`✗ ${t.message}`)}d.push(e)}}let f=d.filter(e=>e.status===`pass`).length,p=d.filter(e=>e.status===`warn`).length,m=d.filter(e=>e.status===`fail`).length;return{checks:d,passed:f,warnings:p,failures:m,skipped:d.filter(e=>e.status===`skip`).length,healthy:m===0}}async function u(e,t,c,l){switch(e){case`cli`:return n(t,c);case`config`:return r(t,c);case`mcp`:return i(t,c);case`deps`:return a(t,c);case`workspace`:return o(t,c);case`ai`:return s(t,c,l);default:return[]}}function d(e){let t=[];return t.push(``),t.push(`=== Health Check Summary ===`),t.push(``),e.healthy?t.push(`✓ All checks passed!`):t.push(`✗ Some issues found`),t.push(``),t.push(`  Passed:   ${e.passed}`),t.push(`  Warnings: ${e.warnings}`),t.push(`  Failures: ${e.failures}`),t.push(`  Skipped:  ${e.skipped}`),t.join(`
-`)}function f(e){let t=`${e.status===`pass`?`✓`:e.status===`warn`?`⚠`:e.status===`fail`?`✗`:`○`} ${e.name}: ${e.message}`;return e.details&&(t+=`\n    ${e.details}`),e.fix&&(t+=`\n    Fix available: ${e.fix.description}`),t}export{f as formatCheckResult,d as formatDoctorSummary,l as runDoctor};
+import{findPackageRoot as e,findWorkspaceRoot as t,getPackageName as n,isMonorepo as r}from"../../adapters/workspace.js";import{ALL_CHECK_CATEGORIES as i,CHECK_CATEGORY_LABELS as a}from"./types.js";import{runCliChecks as o}from"./checks/cli.js";import{runConfigChecks as s}from"./checks/config.js";import{runMcpChecks as c}from"./checks/mcp.js";import{runDepsChecks as l}from"./checks/deps.js";import{runWorkspaceChecks as u}from"./checks/workspace.js";import{runAiChecks as d}from"./checks/ai.js";import"./checks/index.js";const f={confirm:async()=>!1,input:async()=>``};async function p(o,s,c=f){let{fs:l,logger:u}=o,d=s.categories??i,p=t(s.workspaceRoot),h=e(s.workspaceRoot),g=r(p),_=g?n(h):void 0,v={workspaceRoot:p,packageRoot:h,isMonorepo:g,packageName:_,verbose:s.verbose??!1};if(g){let e=_?` (package: ${_})`:``;u.info(`Detected monorepo${e}`)}let y=[];for(let e of d){if(s.skipAi&&e===`ai`)continue;u.info(`Checking ${a[e]}...`);let t=await m(e,l,v,c);for(let e of t){if(e.fix&&(e.status===`fail`||e.status===`warn`)&&(s.autoFix||await c.confirm(`Fix "${e.name}"? ${e.fix.description}`))){u.info(`Applying fix: ${e.fix.description}`);let t=await e.fix.apply();t.success?(u.info(`✓ ${t.message}`),e.status=`pass`,e.message=`Fixed: ${t.message}`,e.fix=void 0):u.warn(`✗ ${t.message}`)}y.push(e)}}let b=y.filter(e=>e.status===`pass`).length,x=y.filter(e=>e.status===`warn`).length,S=y.filter(e=>e.status===`fail`).length;return{checks:y,passed:b,warnings:x,failures:S,skipped:y.filter(e=>e.status===`skip`).length,healthy:S===0}}async function m(e,t,n,r){switch(e){case`cli`:return o(t,n);case`config`:return s(t,n);case`mcp`:return c(t,n);case`deps`:return l(t,n);case`workspace`:return u(t,n);case`ai`:return d(t,n,r);default:return[]}}function h(e){let t=[];return t.push(``),t.push(`=== Health Check Summary ===`),t.push(``),e.healthy?t.push(`✓ All checks passed!`):t.push(`✗ Some issues found`),t.push(``),t.push(`  Passed:   ${e.passed}`),t.push(`  Warnings: ${e.warnings}`),t.push(`  Failures: ${e.failures}`),t.push(`  Skipped:  ${e.skipped}`),t.join(`
+`)}function g(e){let t=`${e.status===`pass`?`✓`:e.status===`warn`?`⚠`:e.status===`fail`?`✗`:`○`} ${e.name}: ${e.message}`;return e.details&&(t+=`\n    ${e.details}`),e.fix&&(t+=`\n    Fix available: ${e.fix.description}`),t}export{g as formatCheckResult,h as formatDoctorSummary,p as runDoctor};

package/dist/services/index.js

@@ -1 +1 @@
-import{detectPackageManager as e,findPackageRoot as t,findWorkspaceRoot as n,getWorkspaceInfo as r}from"../adapters/workspace.js";import{validateSpec as i,validateSpecs as a}from"./validate.js";import{validateImplementationFiles as o}from"./validate-implementation.js";import{compareSpecs as s}from"./diff.js";import{analyzeDeps as c,exportGraphAsDot as l,getContractNode as u,getGraphStats as d}from"./deps.js";import{groupSpecsByType as f,listSpecs as p}from"./list.js";import{getApiKey as m,loadWorkspaceConfig as h,mergeWorkspaceConfig as g}from"./config.js";import{buildSpec as _}from"./build.js";import{exportOpenApi as v}from"./openapi.js";import{RegistryClient as y,addToRegistry as b,listFromRegistry as x,resolveRegistryUrl as S,searchRegistry as C}from"./registry.js";import{syncSpecs as w}from"./sync.js";import{watchSpecs as T}from"./watch.js";import{cleanArtifacts as E}from"./clean.js";import{runTests as D}from"./test.js";import{createRegeneratorService as O}from"./regenerator.js";import{findAllConfigFiles as k,formatWorkspaceInfo as A,getExtendedWorkspaceInfo as j,mergeMonorepoConfigs as M}from"./workspace-info.js";import{analyzeIntegrity as N,filterIssuesBySeverity as P,filterIssuesByType as F,getAllSpecs as I}from"./integrity.js";import{generateMermaidDiagram as L}from"./integrity-diagram.js";import{ALL_SETUP_TARGETS as R,SETUP_TARGET_LABELS as z}from"./setup/types.js";import{generateAgentsMd as B,generateClaudeMcpConfig as V,generateContractsrcConfig as H,generateCursorMcpConfig as U,generateCursorRules as W,generateVscodeSettings as G,getClaudeDesktopConfigPath as K}from"./setup/config-generators.js";import{deepMergeOverwrite as q,deepMergePreserve as J,formatJson as Y,safeParseJson as X}from"./setup/file-merger.js";import{runSetup as Z}from"./setup/setup-service.js";import{ALL_CHECK_CATEGORIES as Q,CHECK_CATEGORY_LABELS as $}from"./doctor/types.js";import{formatCheckResult as ee,formatDoctorSummary as te,runDoctor as ne}from"./doctor/doctor-service.js";import"./doctor/index.js";
+import{detectPackageManager as e,findPackageRoot as t,findWorkspaceRoot as n,getWorkspaceInfo as r}from"../adapters/workspace.js";import{validateSpec as i,validateSpecs as a}from"./validate.js";import{validateImplementationFiles as o}from"./validate-implementation.js";import{compareSpecs as s}from"./diff.js";import{analyzeDeps as c,exportGraphAsDot as l,getContractNode as u,getGraphStats as d}from"./deps.js";import{groupSpecsByType as f,listSpecs as p}from"./list.js";import{getApiKey as m,loadWorkspaceConfig as h,mergeWorkspaceConfig as g}from"./config.js";import{buildSpec as _}from"./build.js";import{exportOpenApi as v}from"./openapi.js";import{RegistryClient as y,addToRegistry as b,listFromRegistry as x,resolveRegistryUrl as S,searchRegistry as C}from"./registry.js";import{syncSpecs as w}from"./sync.js";import{watchSpecs as T}from"./watch.js";import{cleanArtifacts as E}from"./clean.js";import{runTests as D}from"./test.js";import{createRegeneratorService as O}from"./regenerator.js";import{findAllConfigFiles as k,formatWorkspaceInfo as A,getExtendedWorkspaceInfo as j,mergeMonorepoConfigs as M}from"./workspace-info.js";import{analyzeIntegrity as N,filterIssuesBySeverity as P,filterIssuesByType as F,getAllSpecs as I}from"./integrity.js";import{generateMermaidDiagram as L}from"./integrity-diagram.js";import{ALL_SETUP_TARGETS as R,SETUP_TARGET_LABELS as z}from"./setup/types.js";import{generateAgentsMd as B,generateClaudeMcpConfig as V,generateContractsrcConfig as H,generateCursorMcpConfig as U,generateCursorRules as W,generateVscodeSettings as G,getClaudeDesktopConfigPath as K}from"./setup/config-generators.js";import{deepMergeOverwrite as q,deepMergePreserve as J,formatJson as Y,safeParseJson as X}from"./setup/file-merger.js";import{runSetup as Z}from"./setup/setup-service.js";import"./setup/index.js";import{ALL_CHECK_CATEGORIES as Q,CHECK_CATEGORY_LABELS as $}from"./doctor/types.js";import{formatCheckResult as ee,formatDoctorSummary as te,runDoctor as ne}from"./doctor/doctor-service.js";import"./doctor/index.js";

package/dist/services/setup/config-generators.js

@@ -1,4 +1,4 @@
-function e(e){return{$schema:`https://contractspec.dev/schemas/contractsrc.json`,aiProvider:`claude`,aiModel:`claude-sonnet-4-20250514`,agentMode:`claude-code`,outputDir:`./src`,conventions:{operations:`contracts/operations`,events:`contracts/events`,presentations:`contracts/presentations`,forms:`contracts/forms`,features:`contracts/features`},defaultOwners:e.defaultOwners??[`@team`],defaultTags:[]}}function t(){return{"contractspec.validation.enabled":!0,"contractspec.validation.validateOnSave":!0,"contractspec.validation.validateOnOpen":!0,"contractspec.codeLens.enabled":!0,"contractspec.diagnostics.showWarnings":!0,"contractspec.diagnostics.showHints":!0,"contractspec.integrity.enabled":!0,"contractspec.integrity.checkOnSave":!0}}function n(){return{mcpServers:{"contractspec-local":{command:`bunx`,args:[`contractspec-mcp`]}}}}function r(){return{mcpServers:{"contractspec-local":{command:`bunx`,args:[`contractspec-mcp`]}}}}function i(e){return`# ContractSpec Development Rules
+function e(e){let t=e.isMonorepo&&e.scope===`package`;return{$schema:`https://contractspec.dev/schemas/contractsrc.json`,aiProvider:`claude`,aiModel:`claude-sonnet-4-20250514`,agentMode:`claude-code`,outputDir:`./src`,conventions:{operations:`contracts/operations`,events:`contracts/events`,presentations:`contracts/presentations`,forms:`contracts/forms`,features:`contracts/features`},defaultOwners:e.defaultOwners??[`@team`],defaultTags:[],...t&&e.packageName?{package:e.packageName}:{}}}function t(){return{"contractspec.validation.enabled":!0,"contractspec.validation.validateOnSave":!0,"contractspec.validation.validateOnOpen":!0,"contractspec.codeLens.enabled":!0,"contractspec.diagnostics.showWarnings":!0,"contractspec.diagnostics.showHints":!0,"contractspec.integrity.enabled":!0,"contractspec.integrity.checkOnSave":!0}}function n(){return{mcpServers:{"contractspec-local":{command:`bunx`,args:[`contractspec-mcp`]}}}}function r(){return{mcpServers:{"contractspec-local":{command:`bunx`,args:[`contractspec-mcp`]}}}}function i(e){let t=e.projectName??`this project`,n=e.isMonorepo&&e.scope===`package`&&e.packageRoot?`${e.packageRoot.split(`/`).slice(-2).join(`/`)}/src/contracts`:`src/contracts`;return`# ContractSpec Development Rules
 
 This project uses ContractSpec for spec-first development. Follow these guidelines when working with AI agents.
 
@@ -7,14 +7,22 @@ This project uses ContractSpec for spec-first development. Follow these guidelin
 - **Always update contracts first** before changing implementation code.
 - Contracts are the source of truth for operations, events, and presentations.
 - Implementation code should be generated or derived from contracts.
+${e.isMonorepo?`
+## Monorepo Structure
 
+This is a monorepo. Contracts may exist at:
+- Package level: \`packages/*/src/contracts/\`
+- Workspace level: \`src/contracts/\`
+
+Check the appropriate level based on the feature scope.
+`:``}
 ## Contract Locations
 
 Contracts are located in:
-- \`src/contracts/operations/\` - Command and query specs
-- \`src/contracts/events/\` - Event specs
-- \`src/contracts/presentations/\` - UI presentation specs
-- \`src/contracts/features/\` - Feature module specs
+- \`${n}/operations/\` - Command and query specs
+- \`${n}/events/\` - Event specs
+- \`${n}/presentations/\` - UI presentation specs
+- \`${n}/features/\` - Feature module specs
 
 ## When Making Changes
 
@@ -42,17 +50,17 @@ defineCommand({
 });
 \`\`\`
 
-## Rules for ${e.projectName??`this project`}
+## Rules for ${t}
 
 - All API endpoints must have a corresponding operation contract.
 - Events must be declared in contracts before being emitted.
 - UI components should reference presentation contracts.
 - Feature flags should be defined in feature modules.
-`}function a(e){return`# AI Agent Guide
+`}function a(e){let t=e.projectName??`This Project`,n=e.isMonorepo&&e.scope===`package`,r=`src/contracts/`;return`# AI Agent Guide
 
 This repository uses **ContractSpec** for spec-first development. AI agents should follow these guidelines.
 
-## Project: ${e.projectName??`This Project`}
+## Project: ${t}
 
 ## ContractSpec Overview
 
@@ -63,12 +71,29 @@ ContractSpec is a deterministic, spec-first compiler that keeps AI-written softw
 1. **Contracts are the source of truth** - Always check/update contracts before modifying implementation.
 2. **Safe regeneration** - Code can be regenerated from specs without breaking invariants.
 3. **Multi-surface consistency** - API, events, and UI stay in sync via shared contracts.
+${e.isMonorepo?`
+## Monorepo Structure
+
+This is a monorepo. Contracts can exist at multiple levels:
+
+| Level | Location | Use Case |
+|-------|----------|----------|
+| Package | \`packages/*/src/contracts/\` | Package-specific contracts |
+| Workspace | \`src/contracts/\` | Shared cross-package contracts |
+
+When adding a contract, consider:
+- Is this specific to one package? → Add at package level
+- Is this shared across packages? → Add at workspace level
+
+### Current Scope
 
+${n?`You are working at the **package level**: \`${e.packageName??e.packageRoot}\``:`You are working at the **workspace level**.`}
+`:``}
 ## Working in This Repository
 
 ### Before Making Changes
 
-1. Check for existing contracts in \`src/contracts/\`
+1. Check for existing contracts in \`${r}\`
 2. If a contract exists, update it first
 3. Regenerate implementation with \`contractspec build\`
 4. Validate with \`contractspec validate\`
@@ -84,10 +109,10 @@ ContractSpec is a deterministic, spec-first compiler that keeps AI-written softw
 
 | Type | Location |
 |------|----------|
-| Operations | \`src/contracts/operations/\` |
-| Events | \`src/contracts/events/\` |
-| Presentations | \`src/contracts/presentations/\` |
-| Features | \`src/contracts/features/\` |
+| Operations | \`${r}operations/\` |
+| Events | \`${r}events/\` |
+| Presentations | \`${r}presentations/\` |
+| Features | \`${r}features/\` |
 
 ## MCP Tools Available
 

package/dist/services/setup/index.js

@@ -0,0 +1 @@
+import{ALL_SETUP_TARGETS as e,SETUP_TARGET_LABELS as t}from"./types.js";import{generateAgentsMd as n,generateClaudeMcpConfig as r,generateContractsrcConfig as i,generateCursorMcpConfig as a,generateCursorRules as o,generateVscodeSettings as s,getClaudeDesktopConfigPath as c}from"./config-generators.js";import{deepMergeOverwrite as l,deepMergePreserve as u,formatJson as d,safeParseJson as f}from"./file-merger.js";import{runSetup as p}from"./setup-service.js";

package/dist/services/setup/setup-service.js

@@ -1 +1 @@
-import{ALL_SETUP_TARGETS as e,SETUP_TARGET_LABELS as t}from"./types.js";import{setupCliConfig as n}from"./targets/cli-config.js";import{setupVscodeSettings as r}from"./targets/vscode-settings.js";import{setupMcpCursor as i}from"./targets/mcp-cursor.js";import{setupMcpClaude as a}from"./targets/mcp-claude.js";import{setupCursorRules as o}from"./targets/cursor-rules.js";import{setupAgentsMd as s}from"./targets/agents-md.js";const c={confirm:async()=>!0,multiSelect:async(e,t)=>t.filter(e=>e.selected!==!1).map(e=>e.value),input:async(e,t)=>t??``};async function l(n,r,i=c){let a=[],o=r.targets.length>0?r.targets:e,s=o;r.interactive&&(s=await i.multiSelect(`Select components to configure:`,e.map(e=>({value:e,label:t[e],selected:o.includes(e)}))));let l=r.projectName;if(r.interactive&&!l){let e=r.workspaceRoot.split(`/`).pop()??`my-project`;l=await i.input(`Project name:`,e)}let d={...r,projectName:l,targets:s};for(let e of s){let t=await u(n,e,d,i);a.push(t)}let f=a.filter(e=>e.action!==`error`).length,p=a.filter(e=>e.action===`error`).length;return{success:p===0,files:a,summary:`Setup complete: ${f} configured, ${p} failed.`}}async function u(e,t,c,l){switch(t){case`cli-config`:return n(e,c,l);case`vscode-settings`:return r(e,c,l);case`mcp-cursor`:return i(e,c,l);case`mcp-claude`:return a(e,c,l);case`cursor-rules`:return o(e,c,l);case`agents-md`:return s(e,c,l);default:return{target:t,filePath:``,action:`error`,message:`Unknown target: ${t}`}}}export{l as runSetup};
+import{findPackageRoot as e,findWorkspaceRoot as t,getPackageName as n,isMonorepo as r}from"../../adapters/workspace.js";import{ALL_SETUP_TARGETS as i,SETUP_TARGET_LABELS as a}from"./types.js";import{setupCliConfig as o}from"./targets/cli-config.js";import{setupVscodeSettings as s}from"./targets/vscode-settings.js";import{setupMcpCursor as c}from"./targets/mcp-cursor.js";import{setupMcpClaude as l}from"./targets/mcp-claude.js";import{setupCursorRules as u}from"./targets/cursor-rules.js";import{setupAgentsMd as d}from"./targets/agents-md.js";const f={confirm:async()=>!0,multiSelect:async(e,t)=>t.filter(e=>e.selected!==!1).map(e=>e.value),input:async(e,t)=>t??``};async function p(o,s,c=f){let l=[],u=s.targets.length>0?s.targets:i,d=s.workspaceRoot,p=t(d),h=s.packageRoot??e(d),g=s.isMonorepo??r(p),_=s.packageName??(g?n(h):void 0),v=s.scope??`workspace`,y=h!==p;g&&s.interactive&&y&&(v=(await c.multiSelect(`Monorepo detected. Configure at which level?`,[{value:`package`,label:`Package level (${_??h})`,selected:!0},{value:`workspace`,label:`Workspace level (${p})`}]))[0]??`package`);let b=u;s.interactive&&(b=await c.multiSelect(`Select components to configure:`,i.map(e=>({value:e,label:a[e],selected:u.includes(e)}))));let x=s.projectName;if(s.interactive&&!x){let e=v===`package`&&_?_:d.split(`/`).pop()??`my-project`;x=await c.input(`Project name:`,e)}let S={...s,workspaceRoot:p,packageRoot:h,isMonorepo:g,scope:v,packageName:_,projectName:x,targets:b};for(let e of b){let t=await m(o,e,S,c);l.push(t)}let C=l.filter(e=>e.action!==`error`).length,w=l.filter(e=>e.action===`error`).length,T=g?` (${v} level)`:``;return{success:w===0,files:l,summary:`Setup complete${T}: ${C} configured, ${w} failed.`}}async function m(e,t,n,r){switch(t){case`cli-config`:return o(e,n,r);case`vscode-settings`:return s(e,n,r);case`mcp-cursor`:return c(e,n,r);case`mcp-claude`:return l(e,n,r);case`cursor-rules`:return u(e,n,r);case`agents-md`:return d(e,n,r);default:return{target:t,filePath:``,action:`error`,message:`Unknown target: ${t}`}}}export{p as runSetup};

package/dist/services/setup/targets/agents-md.js

@@ -1 +1 @@
-import{generateAgentsMd as e}from"../config-generators.js";async function t(t,n,r){let i=t.join(n.workspaceRoot,`AGENTS.md`);try{let a=await t.exists(i),o=e(n);if(a)if(n.interactive){if(!await r.confirm(`${i} exists. Overwrite?`))return{target:`agents-md`,filePath:i,action:`skipped`,message:`User kept existing AGENTS.md`}}else return{target:`agents-md`,filePath:i,action:`skipped`,message:`File already exists`};return await t.writeFile(i,o),{target:`agents-md`,filePath:i,action:a?`merged`:`created`,message:a?`Updated AGENTS.md`:`Created AGENTS.md`}}catch(e){return{target:`agents-md`,filePath:i,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{t as setupAgentsMd};
+import{generateAgentsMd as e}from"../config-generators.js";async function t(t,n,r){let i=n.isMonorepo&&n.scope===`package`?n.packageRoot??n.workspaceRoot:n.workspaceRoot,a=t.join(i,`AGENTS.md`);try{let i=await t.exists(a),o=e(n);if(i)if(n.interactive){if(!await r.confirm(`${a} exists. Overwrite?`))return{target:`agents-md`,filePath:a,action:`skipped`,message:`User kept existing AGENTS.md`}}else return{target:`agents-md`,filePath:a,action:`skipped`,message:`File already exists`};return await t.writeFile(a,o),{target:`agents-md`,filePath:a,action:i?`merged`:`created`,message:i?`Updated AGENTS.md`:`Created AGENTS.md`}}catch(e){return{target:`agents-md`,filePath:a,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{t as setupAgentsMd};

package/dist/services/setup/targets/cli-config.js

@@ -1 +1 @@
-import{generateContractsrcConfig as e}from"../config-generators.js";import{deepMergePreserve as t,formatJson as n,safeParseJson as r}from"../file-merger.js";async function i(i,a,o){let s=i.join(a.workspaceRoot,`.contractsrc.json`);try{let c=await i.exists(s),l=e(a);if(c){let e=r(await i.readFile(s));if(!e)return{target:`cli-config`,filePath:s,action:`error`,message:`Existing file is not valid JSON`};if(a.interactive&&!await o.confirm(`${s} exists. Merge ContractSpec defaults?`))return{target:`cli-config`,filePath:s,action:`skipped`,message:`User skipped merge`};let c=t(e,l);return await i.writeFile(s,n(c)),{target:`cli-config`,filePath:s,action:`merged`,message:`Merged with existing configuration`}}return await i.writeFile(s,n(l)),{target:`cli-config`,filePath:s,action:`created`,message:`Created CLI configuration`}}catch(e){return{target:`cli-config`,filePath:s,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{i as setupCliConfig};
+import{generateContractsrcConfig as e}from"../config-generators.js";import{deepMergePreserve as t,formatJson as n,safeParseJson as r}from"../file-merger.js";async function i(i,a,o){let s=a.isMonorepo&&a.scope===`package`?a.packageRoot??a.workspaceRoot:a.workspaceRoot,c=i.join(s,`.contractsrc.json`);try{let s=await i.exists(c),l=e(a);if(s){let e=r(await i.readFile(c));if(!e)return{target:`cli-config`,filePath:c,action:`error`,message:`Existing file is not valid JSON`};if(a.interactive&&!await o.confirm(`${c} exists. Merge ContractSpec defaults?`))return{target:`cli-config`,filePath:c,action:`skipped`,message:`User skipped merge`};let s=t(e,l);return await i.writeFile(c,n(s)),{target:`cli-config`,filePath:c,action:`merged`,message:`Merged with existing configuration`}}return await i.writeFile(c,n(l)),{target:`cli-config`,filePath:c,action:`created`,message:`Created CLI configuration`}}catch(e){return{target:`cli-config`,filePath:c,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{i as setupCliConfig};

package/dist/services/setup/targets/vscode-settings.js

@@ -1 +1 @@
-import{generateVscodeSettings as e}from"../config-generators.js";import{deepMergePreserve as t,formatJson as n,safeParseJson as r}from"../file-merger.js";async function i(i,a,o){let s=i.join(a.workspaceRoot,`.vscode`),c=i.join(s,`settings.json`);try{await i.exists(s)||await i.mkdir(s);let l=await i.exists(c),u=e();if(l){let e=r(await i.readFile(c));if(!e)return{target:`vscode-settings`,filePath:c,action:`error`,message:`Existing file is not valid JSON`};if(a.interactive&&!await o.confirm(`${c} exists. Add ContractSpec settings?`))return{target:`vscode-settings`,filePath:c,action:`skipped`,message:`User skipped merge`};let s=t(e,u);return await i.writeFile(c,n(s)),{target:`vscode-settings`,filePath:c,action:`merged`,message:`Added ContractSpec settings`}}return await i.writeFile(c,n(u)),{target:`vscode-settings`,filePath:c,action:`created`,message:`Created VS Code settings`}}catch(e){return{target:`vscode-settings`,filePath:c,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{i as setupVscodeSettings};
+import{generateVscodeSettings as e}from"../config-generators.js";import{deepMergePreserve as t,formatJson as n,safeParseJson as r}from"../file-merger.js";async function i(i,a,o){let s=a.isMonorepo&&a.scope===`package`?a.packageRoot??a.workspaceRoot:a.workspaceRoot,c=i.join(s,`.vscode`),l=i.join(c,`settings.json`);try{await i.exists(c)||await i.mkdir(c);let s=await i.exists(l),u=e();if(s){let e=r(await i.readFile(l));if(!e)return{target:`vscode-settings`,filePath:l,action:`error`,message:`Existing file is not valid JSON`};if(a.interactive&&!await o.confirm(`${l} exists. Add ContractSpec settings?`))return{target:`vscode-settings`,filePath:l,action:`skipped`,message:`User skipped merge`};let s=t(e,u);return await i.writeFile(l,n(s)),{target:`vscode-settings`,filePath:l,action:`merged`,message:`Added ContractSpec settings`}}return await i.writeFile(l,n(u)),{target:`vscode-settings`,filePath:l,action:`created`,message:`Created VS Code settings`}}catch(e){return{target:`vscode-settings`,filePath:l,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{i as setupVscodeSettings};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/bundle.contractspec-workspace",
-  "version": "0.0.0-canary-20251216030333",
+  "version": "0.0.0-canary-20251216033905",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",