@lssm/module.contractspec-workspace 0.0.0-canary-20251213172311

package/README.md

@@ -0,0 +1,39 @@
+# @lssm/module.contractspec-workspace
+
+Pure, deterministic domain logic and static analysis utilities for ContractSpec workspace operations.
+
+## Purpose
+
+This module contains platform-agnostic logic used by ContractSpec tooling:
+
+- **Types**: Shared type definitions for specs, templates, and analysis results
+- **Analysis**: Static code analysis (spec scanning, dependency graphs, semantic diff)
+- **Templates**: Code generation templates for specs and handlers
+- **AI Prompts**: Prompt builders for AI-assisted spec creation and code generation
+
+## Design Principles
+
+- **No side effects**: All functions are pure and deterministic
+- **No CLI dependencies**: No `chalk`, `ora`, `commander`, or `inquirer`
+- **No filesystem access**: Operations take code/data as input, return results
+- **Reusable**: Can be used by CLI, web apps, VS Code extensions, etc.
+
+## Usage
+
+```typescript
+import {
+  scanSpecSource,
+  computeSemanticDiff,
+  buildDependencyGraph,
+  validateSpecStructure,
+  generateOperationSpec,
+} from '@lssm/module.contractspec-workspace';
+```
+
+## Exports
+
+- `analysis/` - Static analysis utilities
+- `templates/` - Code generation templates
+- `ai/` - AI prompt builders
+- `types/` - Shared type definitions
+

package/dist/ai/code-generation.js

@@ -0,0 +1,100 @@
+function e(e){return`You are a senior TypeScript developer implementing a handler for a contract specification.
+
+Here is the contract spec:
+
+\`\`\`typescript
+${e}
+\`\`\`
+
+Generate a complete handler implementation that:
+
+1. **Matches the spec signature**: Input/output types from the spec
+2. **Handles errors**: Implement error cases defined in spec.io.errors
+3. **Emits events**: Use the events declared in spec.sideEffects.emits
+4. **Validates input**: Use zod validation from the schema
+5. **Follows best practices**: Clean, type-safe TypeScript
+6. **Includes comments**: Explain business logic
+
+The handler should be production-ready with proper error handling, logging points, and clear structure.
+
+Return only the TypeScript code for the handler function.`}function t(e){return`You are a senior React developer creating a component for a presentation specification.
+
+Here is the presentation spec:
+
+\`\`\`typescript
+${e}
+\`\`\`
+
+Generate a complete React component that:
+
+1. **Props interface**: Typed props from the spec
+2. **Accessibility**: Proper ARIA labels, roles, keyboard navigation
+3. **Mobile-first**: Optimized for small screens and touch
+4. **Clean UI**: Simple, intuitive interface
+5. **Type-safe**: Full TypeScript with no 'any' types
+6. **Best practices**: React hooks, proper state management
+
+The component should follow Atomic Design principles and be reusable.
+
+Return only the TypeScript/TSX code for the component.`}function n(e){return`You are a senior React developer creating a form component from a form specification.
+
+Here is the form spec:
+
+\`\`\`typescript
+${e}
+\`\`\`
+
+Generate a complete form component using react-hook-form that:
+
+1. **Form validation**: Use zod schema for validation
+2. **Field types**: Proper inputs for each field type
+3. **Conditional logic**: Support visibleWhen, enabledWhen, requiredWhen predicates
+4. **Error handling**: Clear, user-friendly error messages
+5. **Accessibility**: Labels, hints, ARIA attributes
+6. **Mobile-optimized**: Touch-friendly, appropriate input types
+7. **Type-safe**: Full TypeScript
+
+The form should provide excellent UX with real-time validation and helpful feedback.
+
+Return only the TypeScript/TSX code for the form component.`}function r(e,t,n){return`You are a senior developer writing comprehensive tests.
+
+Spec:
+\`\`\`typescript
+${e}
+\`\`\`
+
+Implementation:
+\`\`\`typescript
+${t}
+\`\`\`
+
+Generate complete test suite using Vitest that:
+${n===`handler`?`
+  - Test all acceptance scenarios from the spec
+  - Test error cases defined in spec.io.errors
+  - Verify events are emitted correctly
+  - Test input validation
+  - Test happy path and edge cases`:`
+  - Test rendering with various props
+  - Test user interactions
+  - Test accessibility (a11y)
+  - Test responsive behavior
+  - Test error states`}
+
+Use clear test descriptions and follow AAA pattern (Arrange, Act, Assert).
+
+Return only the TypeScript test code.`}function i(){return`You are an expert TypeScript developer with deep knowledge of:
+- Type-safe API design
+- React and modern hooks
+- Test-driven development
+- Accessibility best practices
+- Clean code principles
+
+Generate production-ready code that is:
+- Fully typed (no 'any' or type assertions unless absolutely necessary)
+- Well-documented with TSDoc comments
+- Following project conventions
+- Defensive and error-safe
+- Easy to maintain and extend
+
+Always prioritize code quality, safety, and user experience.`}export{t as buildComponentPrompt,n as buildFormPrompt,e as buildHandlerPrompt,r as buildTestPrompt,i as getCodeGenSystemPrompt};

package/dist/ai/spec-creation.js

@@ -0,0 +1,69 @@
+function e(e,t){return`You are a senior software architect creating a contract specification for an operation.
+
+The operation is a ${t} (${t===`command`?`changes state, has side effects`:`read-only, idempotent`}).
+
+User description: ${e}
+
+Create a complete contract specification following these guidelines:
+
+1. **Name**: Use dot notation like "domain.operationName" (e.g., "user.signup", "payment.charge")
+2. **Version**: Start at 1
+3. **Description**: Clear, concise summary (1-2 sentences)
+4. **Goal**: Business purpose - why this operation exists
+5. **Context**: Background, constraints, scope (what it does and doesn't do)
+6. **Input/Output**: Describe the shape (we'll create schemas separately)
+7. **Auth**: Who can call this - anonymous, user, or admin
+8. **Feature Flags**: Any flags that gate this operation
+9. **Side Effects**: What events might be emitted, analytics to track
+
+Respond with a structured spec.`}function t(e){return`You are a senior software architect creating an event specification.
+
+User description: ${e}
+
+Create a complete event specification following these guidelines:
+
+1. **Name**: Use dot notation like "domain.event_name" (e.g., "user.signup_completed", "payment.charged")
+2. **Version**: Start at 1
+3. **Description**: Clear description of when this event is emitted
+4. **Payload**: Describe what data the event carries
+5. **PII Fields**: List any personally identifiable information fields (e.g., ["email", "name"])
+
+Events represent things that have already happened and should use past tense.
+
+Respond with a structured spec.`}function n(e,t){return`You are a senior software architect creating a presentation specification.
+
+This is a ${t} presentation - ${{web_component:`a React component with props schema`,markdown:`markdown/MDX documentation or guide`,data:`structured data export (JSON/XML)`}[t]}.
+
+User description: ${e}
+
+Create a complete presentation specification following these guidelines:
+
+1. **Name**: Use dot notation like "domain.presentation_name" (e.g., "user.profile_card", "docs.api_guide")
+2. **Version**: Start at 1
+3. **Description**: What this presentation shows/provides
+4. **Kind-specific details**:
+   ${t===`web_component`?`- Component key (symbolic, resolved by host app)
+   - Props structure
+   - Analytics events to track`:t===`markdown`?`- Content or resource URI
+   - Target audience`:`- MIME type (e.g., application/json)
+   - Data structure description`}
+
+Respond with a structured spec.`}function r(){return`You are an expert software architect specializing in API design and contract-driven development.
+
+You create clear, well-documented specifications that serve as the single source of truth for operations, events, and presentations.
+
+Your specs are:
+- Precise and unambiguous
+- Following TypeScript conventions
+- Business-oriented (capturing the "why" not just "what")
+- Designed for both humans and AI agents to understand
+
+Always use proper dot notation for names and ensure all metadata is meaningful and accurate.`}function i(e,t){return t.length===0?e:`${e}
+
+Here are some good examples for reference:
+
+${t.join(`
+
+`)}
+
+Follow this structure and quality level.`}export{i as addExampleContext,t as buildEventSpecPrompt,e as buildOperationSpecPrompt,n as buildPresentationSpecPrompt,r as getSystemPrompt};

package/dist/analysis/deps/graph.js

@@ -0,0 +1,2 @@
+function e(e){for(let t of e.values())t.dependents=[];for(let[t,n]of e)for(let r of n.dependencies){let n=e.get(r);n&&n.dependents.push(t)}for(let t of e.values())t.dependents.sort((e,t)=>e.localeCompare(t))}function t(e){let t=new Set,n=new Set,r=[];function i(a,o){if(n.has(a)){let e=o.indexOf(a);e>=0&&r.push([...o.slice(e),a]);return}if(t.has(a))return;t.add(a),n.add(a);let s=e.get(a);if(s)for(let e of s.dependencies)i(e,[...o,a]);n.delete(a)}for(let n of e.keys())t.has(n)||i(n,[]);return r}function n(e){let t=[];for(let[n,r]of e){let i=r.dependencies.filter(t=>!e.has(t));i.length>0&&t.push({contract:n,missing:i})}return t}function r(e){let t=[];t.push(`digraph ContractDependencies {`),t.push(`  rankdir=LR;`),t.push(`  node [shape=box];`);for(let[n,r]of e){for(let e of r.dependencies)t.push(`  "${n}" -> "${e}";`);r.dependencies.length===0&&t.push(`  "${n}";`)}return t.push(`}`),t.join(`
+`)}function i(){return new Map}function a(e,t,n,r){e.set(t,{name:t,file:n,dependencies:r,dependents:[]})}export{a as addContractNode,e as buildReverseEdges,i as createContractGraph,t as detectCycles,n as findMissingDependencies,r as toDot};

package/dist/analysis/deps/parse-imports.js

@@ -0,0 +1 @@
+function e(e,t){let n=[],r=/import\s+.*?\s+from\s+['"]([^'"]+\.(?:contracts|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)(?:\.[jt]s)?)['"]/g,i;for(;(i=r.exec(e))!==null;){let e=i[1];if(!e||!e.startsWith(`.`)&&!e.startsWith(`/`))continue;let t=e.split(`/`),r=(t[t.length-1]??``).replace(/\.(ts|js)$/,``).replace(/\.(contracts|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)$/,``);r.length>0&&n.push(r)}return Array.from(new Set(n)).sort((e,t)=>e.localeCompare(t))}export{e as parseImportedSpecNames};

package/dist/analysis/diff/semantic.js

@@ -0,0 +1 @@
+import{scanSpecSource as e}from"../spec-scan.js";function t(t,o,s,c,l={}){let u=e(t,o),d=e(s,c),f=[];return n(f,`specType`,u.specType,d.specType,{breaking:!0,label:`Spec type`}),n(f,`name`,u.name,d.name,{breaking:!0,label:`Name`}),n(f,`version`,u.version,d.version,{breaking:!0,label:`Version`}),n(f,`kind`,u.kind,d.kind,{breaking:!0,label:`Kind`}),n(f,`stability`,u.stability,d.stability,{breaking:i(u,d),label:`Stability`}),r(f,`owners`,u.owners??[],d.owners??[],{label:`Owners`}),r(f,`tags`,u.tags??[],d.tags??[],{label:`Tags`}),a(f,u,d),l.breakingOnly?f.filter(e=>e.type===`breaking`):f}function n(e,t,n,r,i){n!==r&&e.push({type:i.breaking?`breaking`:`changed`,path:t,oldValue:n,newValue:r,description:`${i.label} changed`})}function r(e,t,n,r,i){let a=[...n].sort(),o=[...r].sort();JSON.stringify(a)!==JSON.stringify(o)&&e.push({type:`changed`,path:t,oldValue:a,newValue:o,description:`${i.label} changed`})}function i(e,t){let n={experimental:0,beta:1,stable:2,deprecated:3},r=e.stability?n[e.stability]??0:0;return(t.stability?n[t.stability]??0:0)>r}function a(e,t,r){n(e,`hasMeta`,t.hasMeta,r.hasMeta,{breaking:t.specType===`operation`||r.specType===`operation`,label:`meta section presence`}),n(e,`hasIo`,t.hasIo,r.hasIo,{breaking:t.specType===`operation`||r.specType===`operation`,label:`io section presence`}),n(e,`hasPolicy`,t.hasPolicy,r.hasPolicy,{breaking:t.specType===`operation`||r.specType===`operation`,label:`policy section presence`}),n(e,`hasPayload`,t.hasPayload,r.hasPayload,{breaking:t.specType===`event`||r.specType===`event`,label:`payload section presence`}),n(e,`hasContent`,t.hasContent,r.hasContent,{breaking:t.specType===`presentation`||r.specType===`presentation`,label:`content section presence`}),n(e,`hasDefinition`,t.hasDefinition,r.hasDefinition,{breaking:t.specType===`workflow`||r.specType===`workflow`,label:`definition section presence`})}export{t as computeSemanticDiff};

package/dist/analysis/spec-scan.js

@@ -0,0 +1 @@
+function e(e){return e.includes(`.contracts.`)?`operation`:e.includes(`.event.`)?`event`:e.includes(`.presentation.`)?`presentation`:e.includes(`.workflow.`)?`workflow`:e.includes(`.data-view.`)?`data-view`:e.includes(`.migration.`)?`migration`:e.includes(`.telemetry.`)?`telemetry`:e.includes(`.experiment.`)?`experiment`:e.includes(`.app-config.`)?`app-config`:e.includes(`.integration.`)?`integration`:e.includes(`.knowledge.`)?`knowledge`:`unknown`}function t(t,o){let s=e(o),c=n(t,`name`),l=n(t,`description`),u=n(t,`stability`),d=a(u)?u:void 0,f=i(t,`owners`),p=i(t,`tags`),m=r(t,`version`),h=n(t,`kind`),g=h===`command`||h===`query`?h:`unknown`,_=/meta\s*:\s*{/.test(t),v=/\bio\s*:\s*{/.test(t),y=/\bpolicy\s*:\s*{/.test(t),b=/\bpayload\s*:\s*{/.test(t),x=/\bcontent\s*:\s*{/.test(t),S=/\bdefinition\s*:\s*{/.test(t);return{filePath:o,specType:s,name:c??void 0,description:l??void 0,stability:d,owners:f,tags:p,version:m??void 0,kind:g,hasMeta:_,hasIo:v,hasPolicy:y,hasPayload:b,hasContent:x,hasDefinition:S}}function n(e,t){let n=RegExp(`${o(t)}\\s*:\\s*['"]([^'"]+)['"]`);return e.match(n)?.[1]??null}function r(e,t){let n=RegExp(`${o(t)}\\s*:\\s*(\\d+)`),r=e.match(n);if(!r?.[1])return null;let i=Number(r[1]);return Number.isFinite(i)?i:null}function i(e,t){let n=RegExp(`${o(t)}\\s*:\\s*\\[([\\s\\S]*?)\\]`),r=e.match(n);if(!r?.[1])return;let i=r[1],a=Array.from(i.matchAll(/['"]([^'"]+)['"]/g)).map(e=>e[1]).filter(e=>typeof e==`string`&&e.length>0);return a.length>0?a:void 0}function a(e){return e===`experimental`||e===`beta`||e===`stable`||e===`deprecated`}function o(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}export{e as inferSpecTypeFromFilePath,t as scanSpecSource};

package/dist/analysis/validate/spec-structure.js

@@ -0,0 +1 @@
+function e(e,d){let f=[],p=[];return/export\s+(const|let)\s+\w+/.test(e)||f.push(`No exported spec found`),d.includes(`.contracts.`)&&t(e,f,p),d.includes(`.event.`)&&a(e,f,p),d.includes(`.presentation.`)&&o(e,f,p),d.includes(`.workflow.`)&&s(e,f,p),d.includes(`.data-view.`)&&u(e,f,p),d.includes(`.migration.`)&&c(e,f,p),d.includes(`.telemetry.`)&&n(e,f,p),d.includes(`.experiment.`)&&r(e,f,p),d.includes(`.app-config.`)&&i(e,f,p),l(e,f,p),{valid:f.length===0,errors:f,warnings:p}}function t(e,t,n){/define(Command|Query)/.test(e)||t.push(`Missing defineCommand or defineQuery call`),e.includes(`meta:`)||t.push(`Missing meta section`),e.includes(`io:`)||t.push(`Missing io section`),e.includes(`policy:`)||t.push(`Missing policy section`),e.match(/name:\s*['"][^'"]+['"]/)||t.push(`Missing or invalid name field`),e.match(/version:\s*\d+/)||t.push(`Missing or invalid version field`),e.match(/kind:\s*['"](?:command|query)['"]/)||t.push(`Missing or invalid kind field (must be "command" or "query")`),e.includes(`acceptance:`)||n.push(`No acceptance scenarios defined`),e.includes(`examples:`)||n.push(`No examples provided`),e.includes(`TODO`)&&n.push(`Contains TODO items that need completion`)}function n(e,t,n){e.match(/:\s*TelemetrySpec\s*=/)||t.push(`Missing TelemetrySpec type annotation`),e.match(/meta:\s*{[\s\S]*name:/)||t.push(`TelemetrySpec.meta is required`),e.includes(`events:`)||t.push(`TelemetrySpec must declare events`),e.match(/privacy:\s*'(public|internal|pii|sensitive)'/)||n.push(`No explicit privacy classification found`)}function r(e,t,n){e.match(/:\s*ExperimentSpec\s*=/)||t.push(`Missing ExperimentSpec type annotation`),e.includes(`controlVariant`)||t.push(`ExperimentSpec must declare controlVariant`),e.includes(`variants:`)||t.push(`ExperimentSpec must declare variants`),e.match(/allocation:\s*{/)||n.push(`ExperimentSpec missing allocation configuration`)}function i(e,t,n){e.match(/:\s*AppBlueprintSpec\s*=/)||t.push(`Missing AppBlueprintSpec type annotation`),e.includes(`meta:`)||t.push(`AppBlueprintSpec must define meta`),e.includes(`appId`)||n.push(`AppBlueprint meta missing appId assignment`),e.includes(`capabilities`)||n.push(`App blueprint spec does not declare capabilities`)}function a(e,t,n){e.includes(`defineEvent`)||t.push(`Missing defineEvent call`),e.match(/name:\s*['"][^'"]+['"]/)||t.push(`Missing or invalid name field`),e.match(/version:\s*\d+/)||t.push(`Missing or invalid version field`),e.includes(`payload:`)||t.push(`Missing payload field`);let r=e.match(/name:\s*['"]([^'"]+)['"]/);r?.[1]&&((r[1].split(`.`).pop()??``).match(/(ed|created|updated|deleted|completed)$/i)||n.push(`Event name should use past tense (e.g., "created", "updated")`))}function o(e,t,n){e.match(/:\s*PresentationSpec\s*=/)||t.push(`Missing PresentationSpec type annotation`),e.includes(`meta:`)||t.push(`Missing meta section`),e.includes(`content:`)||t.push(`Missing content section`),e.match(/kind:\s*['"](?:web_component|markdown|data)['"]/)||t.push(`Missing or invalid kind field`)}function s(e,t,n){e.match(/:\s*WorkflowSpec\s*=/)||t.push(`Missing WorkflowSpec type annotation`),e.includes(`definition:`)||t.push(`Missing definition section`),e.includes(`steps:`)||t.push(`Workflow must declare steps`),e.includes(`transitions:`)||n.push(`No transitions declared; workflow will complete after first step.`),e.match(/title:\s*['"][^'"]+['"]/)||n.push(`Missing workflow title`),e.match(/domain:\s*['"][^'"]+['"]/)||n.push(`Missing domain field`),e.includes(`TODO`)&&n.push(`Contains TODO items that need completion`)}function c(e,t,n){e.match(/:\s*MigrationSpec\s*=/)||t.push(`Missing MigrationSpec type annotation`),e.includes(`plan:`)?e.includes(`up:`)||t.push(`Migration must define at least one up step`):t.push(`Missing plan section`),e.match(/name:\s*['"][^'"]+['"]/)||t.push(`Missing or invalid migration name`),e.match(/version:\s*\d+/)||t.push(`Missing or invalid migration version`),e.includes(`TODO`)&&n.push(`Contains TODO items that need completion`)}function l(e,t,n){e.includes(`SchemaModel`)&&!e.includes(`from '@lssm/lib.schema'`)&&t.push(`Missing import for SchemaModel from @lssm/lib.schema`),e.includes(`from '@lssm/lib.contracts'`)||t.push(`Missing import from @lssm/lib.contracts`);let r=e.match(/owners:\s*\[(.*?)\]/s);r?.[1]&&(r[1].includes(`@`)||n.push(`Owners should start with @ (e.g., "@team")`)),e.match(/stability:\s*['"](?:experimental|beta|stable|deprecated)['"]/)||n.push(`Missing or invalid stability field`)}function u(e,t,n){e.match(/:\s*DataViewSpec\s*=/)||t.push(`Missing DataViewSpec type annotation`),e.includes(`meta:`)||t.push(`Missing meta section`),e.includes(`source:`)||t.push(`Missing source section`),e.includes(`view:`)||t.push(`Missing view section`),e.match(/kind:\s*['"](list|table|detail|grid)['"]/)||t.push(`Missing or invalid view.kind (list/table/detail/grid)`),e.match(/fields:\s*\[/)||t.push(`No fields defined for data view`)}export{e as validateSpecStructure};

package/dist/index.js

@@ -0,0 +1 @@
+import{DEFAULT_WORKSPACE_CONFIG as e}from"./types/generation-types.js";import{inferSpecTypeFromFilePath as t,scanSpecSource as n}from"./analysis/spec-scan.js";import{computeSemanticDiff as r}from"./analysis/diff/semantic.js";import{addContractNode as i,buildReverseEdges as a,createContractGraph as o,detectCycles as s,findMissingDependencies as c,toDot as l}from"./analysis/deps/graph.js";import{parseImportedSpecNames as u}from"./analysis/deps/parse-imports.js";import{validateSpecStructure as d}from"./analysis/validate/spec-structure.js";import{capitalize as f,escapeString as p,toCamelCase as m,toKebabCase as h,toPascalCase as g}from"./templates/utils.js";import{generateOperationSpec as _}from"./templates/operation.js";import{generateEventSpec as v}from"./templates/event.js";import{generatePresentationSpec as y}from"./templates/presentation.js";import{generateWorkflowSpec as b}from"./templates/workflow.js";import{generateWorkflowRunnerTemplate as x}from"./templates/workflow-runner.js";import{generateDataViewSpec as S}from"./templates/data-view.js";import{generateTelemetrySpec as C}from"./templates/telemetry.js";import{generateExperimentSpec as w}from"./templates/experiment.js";import{generateAppBlueprintSpec as T}from"./templates/app-config.js";import{generateMigrationSpec as E}from"./templates/migration.js";import{generateIntegrationSpec as D}from"./templates/integration.js";import{generateKnowledgeSpaceSpec as O}from"./templates/knowledge.js";import{generateComponentTemplate as k,generateHandlerTemplate as A,generateTestTemplate as j}from"./templates/handler.js";import{addExampleContext as M,buildEventSpecPrompt as N,buildOperationSpecPrompt as P,buildPresentationSpecPrompt as F,getSystemPrompt as I}from"./ai/spec-creation.js";import{buildComponentPrompt as L,buildFormPrompt as R,buildHandlerPrompt as z,buildTestPrompt as B,getCodeGenSystemPrompt as V}from"./ai/code-generation.js";export{e as DEFAULT_WORKSPACE_CONFIG,i as addContractNode,M as addExampleContext,L as buildComponentPrompt,N as buildEventSpecPrompt,R as buildFormPrompt,z as buildHandlerPrompt,P as buildOperationSpecPrompt,F as buildPresentationSpecPrompt,a as buildReverseEdges,B as buildTestPrompt,f as capitalize,r as computeSemanticDiff,o as createContractGraph,s as detectCycles,p as escapeString,c as findMissingDependencies,T as generateAppBlueprintSpec,k as generateComponentTemplate,S as generateDataViewSpec,v as generateEventSpec,w as generateExperimentSpec,A as generateHandlerTemplate,D as generateIntegrationSpec,O as generateKnowledgeSpaceSpec,E as generateMigrationSpec,_ as generateOperationSpec,y as generatePresentationSpec,C as generateTelemetrySpec,j as generateTestTemplate,x as generateWorkflowRunnerTemplate,b as generateWorkflowSpec,V as getCodeGenSystemPrompt,I as getSystemPrompt,t as inferSpecTypeFromFilePath,u as parseImportedSpecNames,n as scanSpecSource,m as toCamelCase,l as toDot,h as toKebabCase,g as toPascalCase,d as validateSpecStructure};

package/dist/templates/app-config.js

@@ -0,0 +1,33 @@
+import{toPascalCase as e}from"./utils.js";function t(t){let d=e(t.name.split(`.`).pop()??`App`)+`AppConfig`,f=n(t),m=r(t),h=i(`dataViews`,t.dataViews),g=i(`workflows`,t.workflows),_=a(t),v=o(t),y=s(t),b=c(t),x=l(t),S=u(t),C=t.notes?`  notes: '${p(t.notes)}',\n`:``;return`import type { AppBlueprintSpec } from '@lssm/lib.contracts/app-config';
+
+export const ${d}: AppBlueprintSpec = {
+  meta: {
+    name: '${p(t.name)}',
+    version: ${t.version},
+    title: '${p(t.title)}',
+    description: '${p(t.description)}',
+    domain: '${p(t.domain)}',
+    owners: [${t.owners.map(e=>`'${p(e)}'`).join(`, `)}],
+    tags: [${t.tags.map(e=>`'${p(e)}'`).join(`, `)}],
+    stability: '${t.stability}',
+    appId: '${p(t.appId)}',
+  },
+${f}${m}${h}${g}${_}${v}${y}${b}${x}${S}${C}};\n`}function n(e){return e.capabilitiesEnabled.length===0&&e.capabilitiesDisabled.length===0?``:`  capabilities: {\n${e.capabilitiesEnabled.length>0?`    enabled: [${e.capabilitiesEnabled.map(e=>d(e)).join(`, `)}],\n`:``}${e.capabilitiesDisabled.length>0?`    disabled: [${e.capabilitiesDisabled.map(e=>d(e)).join(`, `)}],\n`:``}  },\n`}function r(e){return e.featureIncludes.length===0&&e.featureExcludes.length===0?``:`  features: {\n${e.featureIncludes.length>0?`    include: [${e.featureIncludes.map(e=>`{ key: '${p(e)}' }`).join(`, `)}],\n`:``}${e.featureExcludes.length>0?`    exclude: [${e.featureExcludes.map(e=>`{ key: '${p(e)}' }`).join(`, `)}],\n`:``}  },\n`}function i(e,t){return t.length===0?``:`  ${e}: {\n${t.map(e=>`    ${e.slot}: {
+      name: '${p(e.name)}',
+      ${typeof e.version==`number`?`version: ${e.version},`:``}
+    }`).join(`,
+`)}\n  },\n`}function a(e){return e.policyRefs.length===0?``:`  policies: [\n${e.policyRefs.map(e=>`    {
+      name: '${p(e.name)}'${typeof e.version==`number`?`,\n      version: ${e.version}`:``}
+    }`).join(`,
+`)}\n  ],\n`}function o(e){return e.theme?`  theme: {\n${`    primary: { name: '${p(e.theme.name)}', version: ${e.theme.version} },\n`}${e.themeFallbacks.length>0?`    fallbacks: [${e.themeFallbacks.map(e=>`{ name: '${p(e.name)}', version: ${e.version} }`).join(`, `)}],\n`:``}  },\n`:``}function s(e){return e.telemetry?`  telemetry: {
+    spec: {
+      name: '${p(e.telemetry.name)}'${typeof e.telemetry.version==`number`?`,\n      version: ${e.telemetry.version}`:``}
+    },
+  },\n`:``}function c(e){return e.activeExperiments.length===0&&e.pausedExperiments.length===0?``:`  experiments: {\n${e.activeExperiments.length>0?`    active: [${e.activeExperiments.map(e=>f(e)).join(`, `)}],\n`:``}${e.pausedExperiments.length>0?`    paused: [${e.pausedExperiments.map(e=>f(e)).join(`, `)}],\n`:``}  },\n`}function l(e){return e.featureFlags.length===0?``:`  featureFlags: [\n${e.featureFlags.map(e=>`    {
+      key: '${p(e.key)}',
+      enabled: ${e.enabled},
+      ${e.variant?`variant: '${p(e.variant)}',`:``}
+      ${e.description?`description: '${p(e.description)}',`:``}
+    }`).join(`,
+`)}\n  ],\n`}function u(e){return e.routes.length===0?``:`  routes: [\n${e.routes.map(e=>`    { ${[`path: '${p(e.path)}'`,e.label?`label: '${p(e.label)}'`:null,e.dataView?`dataView: '${p(e.dataView)}'`:null,e.workflow?`workflow: '${p(e.workflow)}'`:null,e.guardName?`guard: { name: '${p(e.guardName)}'${typeof e.guardVersion==`number`?`, version: ${e.guardVersion}`:``} }`:null,e.featureFlag?`featureFlag: '${p(e.featureFlag)}'`:null,e.experimentName?`experiment: { name: '${p(e.experimentName)}'${typeof e.experimentVersion==`number`?`, version: ${e.experimentVersion}`:``} }`:null].filter(Boolean).join(`, `)} }`).join(`,
+`)}\n  ],\n`}function d(e){return`{ key: '${p(e)}' }`}function f(e){let t=typeof e.version==`number`?`, version: ${e.version}`:``;return`{ name: '${p(e.name)}'${t} }`}function p(e){return e.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}export{t as generateAppBlueprintSpec};

package/dist/templates/data-view.js

@@ -0,0 +1,54 @@
+import{escapeString as e,toPascalCase as t}from"./utils.js";function n(n){let i=t(n.name.split(`.`).pop()??`DataView`)+`DataView`,a=n.fields.map(t=>`      {
+        key: '${e(t.key)}',
+        label: '${r(t.label)}',
+        dataPath: '${e(t.dataPath)}',
+        ${t.format?`format: '${e(t.format)}',`:``}
+        ${t.sortable?`sortable: true,`:``}
+        ${t.filterable?`filterable: true,`:``}
+      }`).join(`,
+`),o=n.secondaryFields?.length?`secondaryFields: [${n.secondaryFields.map(t=>`'${e(t)}'`).join(`, `)}],`:``,s=n.itemOperation?`item: { name: '${e(n.itemOperation.name)}', version: ${n.itemOperation.version} },`:``;return`import type { DataViewSpec } from '@lssm/lib.contracts/data-views';
+
+export const ${i}: DataViewSpec = {
+  meta: {
+    name: '${e(n.name)}',
+    version: ${n.version},
+    entity: '${e(n.entity)}',
+    title: '${r(n.title)}',
+    description: '${r(n.description||`Describe the purpose of this data view.`)}',
+    domain: '${r(n.domain||n.entity)}',
+    owners: [${n.owners.map(t=>`'${e(t)}'`).join(`, `)}],
+    tags: [${n.tags.map(t=>`'${e(t)}'`).join(`, `)}],
+    stability: '${n.stability}',
+  },
+  source: {
+    primary: {
+      name: '${e(n.primaryOperation.name)}',
+      version: ${n.primaryOperation.version},
+    },
+    ${s}
+    refreshEvents: [
+      // { name: 'entity.updated', version: 1 },
+    ],
+  },
+  view: {
+    kind: '${n.kind}',
+    fields: [
+${a}
+    ],
+    ${n.primaryField?`primaryField: '${e(n.primaryField)}',`:``}
+    ${o}
+    filters: [
+      // Example filter:
+      // { key: 'search', label: 'Search', field: 'fullName', type: 'search' },
+    ],
+    actions: [
+      // Example action:
+      // { key: 'open', label: 'Open', kind: 'navigation' },
+    ],
+  },
+  states: {
+    // empty: { name: 'app.data.empty', version: 1 },
+    // error: { name: 'app.data.error', version: 1 },
+  },
+};
+`}function r(e){return e.replace(/'/g,`\\'`)}export{n as generateDataViewSpec};

package/dist/templates/event.js

@@ -0,0 +1,24 @@
+import{toPascalCase as e}from"./utils.js";function t(t){let{name:n,version:r,description:i,stability:a,owners:o,tags:s,piiFields:c}=t,l=e(n.replace(/\./g,`_`))+`V`+r,u=l+`Payload`;return`import { defineEvent } from '@lssm/lib.contracts';
+import { ScalarTypeEnum, SchemaModel } from '@lssm/lib.schema';
+
+// TODO: Define event payload schema
+export const ${u} = new SchemaModel({
+  name: '${u}',
+  description: 'Payload for ${n}',
+  fields: {
+    // Add your payload fields here
+    // example: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+  },
+});
+
+export const ${l} = defineEvent({
+  name: '${n}',
+  version: ${r},
+  description: '${i}',
+  stability: '${a}',
+  owners: [${o.map(e=>`'${e}'`).join(`, `)}],
+  tags: [${s.map(e=>`'${e}'`).join(`, `)}],
+  ${c.length>0?`pii: [${c.map(e=>`'${e}'`).join(`, `)}],`:`// pii: [],`}
+  payload: ${u},
+});
+`}export{t as generateEventSpec};

package/dist/templates/experiment.js

@@ -0,0 +1,62 @@
+import{toPascalCase as e}from"./utils.js";function t(t){let i=e(t.name.split(`.`).pop()??`Experiment`)+`Experiment`,a=t.variants.map(e=>{let t=e.overrides?.length?`      overrides: [
+${e.overrides.map(e=>`        {
+          type: '${e.type}',
+          target: '${r(e.target)}',
+          ${typeof e.version==`number`?`version: ${e.version},`:``}
+        }`).join(`,
+`)}
+      ],`:``;return`    {
+      id: '${r(e.id)}',
+      name: '${r(e.name)}',
+      ${e.description?`description: '${r(e.description)}',`:``}
+      ${typeof e.weight==`number`?`weight: ${e.weight},`:``}
+${t}
+    }`}).join(`,
+`),o=n(t.allocation),s=t.successMetrics?.length?`  successMetrics: [
+${t.successMetrics.map(e=>`    {
+      name: '${r(e.name)}',
+      telemetryEvent: { name: '${r(e.eventName)}', version: ${e.eventVersion} },
+      aggregation: '${e.aggregation}',
+      ${typeof e.target==`number`?`target: ${e.target},`:``}
+    }`).join(`,
+`)}
+  ],`:``;return`import type { ExperimentSpec } from '@lssm/lib.contracts/experiments';
+
+export const ${i}: ExperimentSpec = {
+  meta: {
+    name: '${r(t.name)}',
+    version: ${t.version},
+    title: '${r(t.name)} experiment',
+    description: '${r(t.description||`Describe the experiment goal.`)}',
+    domain: '${r(t.domain)}',
+    owners: [${t.owners.map(e=>`'${r(e)}'`).join(`, `)}],
+    tags: [${t.tags.map(e=>`'${r(e)}'`).join(`, `)}],
+    stability: '${t.stability}',
+  },
+  controlVariant: '${r(t.controlVariant)}',
+  variants: [
+${a}
+  ],
+  allocation: ${o},
+${s}
+};
+`}function n(e){switch(e.type){case`random`:return`{
+    type: 'random',
+    ${e.salt?`salt: '${r(e.salt)}',`:``}
+  }`;case`sticky`:return`{
+    type: 'sticky',
+    attribute: '${e.attribute}',
+    ${e.salt?`salt: '${r(e.salt)}',`:``}
+  }`;case`targeted`:return`{
+    type: 'targeted',
+    rules: [
+${e.rules.map(e=>`      {
+        variantId: '${r(e.variantId)}',
+        ${typeof e.percentage==`number`?`percentage: ${e.percentage},`:``}
+        ${e.policy?`policy: { name: '${r(e.policy.name)}'${typeof e.policy.version==`number`?`, version: ${e.policy.version}`:``} },`:``}
+        ${e.expression?`expression: '${r(e.expression)}',`:``}
+      }`).join(`,
+`)}
+    ],
+    fallback: '${e.fallback??`control`}',
+  }`;default:return i(e)}}function r(e){return e.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}function i(e){throw Error(`Unsupported allocation type ${e}`)}export{t as generateExperimentSpec};

package/dist/templates/handler.js

@@ -0,0 +1,63 @@
+import{toCamelCase as e,toKebabCase as t,toPascalCase as n}from"./utils.js";function r(r,i){let a=e(r.split(`.`).pop()??`unknown`)+`Handler`,o=n(r.split(`.`).pop()??`Unknown`)+`Spec`;return`import type { ContractHandler } from '@lssm/lib.contracts';
+import { ${o} } from '../contracts/${t(r)}.contracts';
+
+/**
+ * Handler for ${r}
+ */
+export const ${a}: ContractHandler<typeof ${o}> = async (
+  input,
+  context
+) => {
+  // TODO: Implement ${i} logic
+  
+  try {
+    // 1. Validate prerequisites
+    // 2. Perform business logic
+    // 3. Emit events if needed
+    // 4. Return result
+    
+    return {
+      ok: true,
+    };
+  } catch (error) {
+    // Handle and map errors to spec.io.errors
+    throw error;
+  }
+};
+`}function i(e,t){let r=n(e);return`import React from 'react';
+
+interface ${r}Props {
+  // TODO: Define props based on presentation spec
+}
+
+/**
+ * ${t}
+ */
+export const ${r}: React.FC<${r}Props> = (props) => {
+  return (
+    <div>
+      {/* TODO: Implement component UI */}
+      <p>Component: ${r}</p>
+    </div>
+  );
+};
+`}function a(e,r){let i=r===`handler`?`../handlers`:`../components`,a=n(e);return`import { describe, it, expect } from 'bun:test';
+import { ${a} } from '${i}/${t(e)}';
+
+describe('${a}', () => {
+  it('should ${r===`handler`?`handle valid input`:`render correctly`}', async () => {
+    // TODO: Implement test
+    expect(true).toBe(true);
+  });
+
+  it('should handle edge cases', async () => {
+    // TODO: Test edge cases
+  });
+
+  ${r===`handler`?`it('should handle errors appropriately', async () => {
+    // TODO: Test error scenarios
+  });`:`it('should be accessible', async () => {
+    // TODO: Test accessibility
+  });`}
+});
+`}export{i as generateComponentTemplate,r as generateHandlerTemplate,a as generateTestTemplate};

package/dist/templates/integration-utils.js

@@ -0,0 +1,33 @@
+function e(e){let t=e.filter(e=>e.required);return`    schema: {
+      type: 'object',
+${t.length>0?`      required: [${t.map(e=>`'${e.key}'`).join(`, `)}],
+`:``}      properties: {
+${(e.length?e.map(e=>{let t=e.description?`, description: '${u(e.description)}'`:``;return`        ${e.key}: { type: '${o(e.type)}'${t} }`}).join(`,
+`):``)||`      `}
+      },
+    },\n`}function t(e){let t=e.filter(e=>e.required);return`    schema: {
+      type: 'object',
+${t.length>0?`      required: [${t.map(e=>`'${e.key}'`).join(`, `)}],
+`:``}      properties: {
+${(e.length?e.map(e=>{let t=e.description?`, description: '${u(e.description)}'`:``;return`        ${e.key}: { type: 'string'${t} }`}).join(`,
+`):``)||`      `}
+      },
+    },\n`}function n(e){return e.length===0?`{}`:`{
+${e.map(e=>{switch(e.type){case`number`:return`    ${e.key}: 0`;case`boolean`:return`    ${e.key}: true`;case`string`:default:return`    ${e.key}: '${e.key.toUpperCase()}_VALUE'`}}).join(`,
+`)}
+  }`}function r(e){return e.length===0?`{}`:`{
+${e.map(e=>`    ${e.key}: '${e.key.toUpperCase()}_SECRET'`).join(`,
+`)}
+  }`}function i(e,t){if(e==null&&t==null)return``;let n=[];return e!=null&&n.push(`      rpm: ${e}`),t!=null&&n.push(`      rph: ${t}`),`  constraints: {
+    rateLimit: {
+${n.join(`,
+`)}
+    },
+  },
+`}function a(e,t,n){if(!e.includes(`byok`))return``;let r=t?`    setupInstructions: '${u(t)}',\n`:``,i=n&&n.length?`    requiredScopes: [${n.map(e=>`'${u(e)}'`).join(`, `)}],\n`:``;return!r&&!i?``:`  byokSetup: {
+${r}${i}  },
+`}function o(e){switch(e){case`number`:return`number`;case`boolean`:return`boolean`;case`string`:default:return`string`}}function s(e){switch(e){case`beta`:return`Beta`;case`stable`:return`Stable`;case`deprecated`:return`Deprecated`;case`experimental`:default:return`Experimental`}}function c(e){return e.capabilitiesProvided.map(e=>`      { key: '${e.key}', version: ${e.version} }`).join(`,
+`)}function l(e){return e.capabilitiesRequired.length===0?``:`    requires: [
+${e.capabilitiesRequired.map(e=>{let t=typeof e.version==`number`?`, version: ${e.version}`:``,n=e.optional?`, optional: true`:``,r=e.reason?`, reason: '${u(e.reason)}'`:``;return`      { key: '${e.key}'${t}${n}${r} }`}).join(`,
+`)}
+    ],`}function u(e){return e.replace(/`/g,"\\`").replace(/'/g,`\\'`)}export{u as escape,a as renderByokSetup,n as renderConfigExample,e as renderConfigSchema,i as renderConstraints,c as renderProvides,l as renderRequires,r as renderSecretExample,t as renderSecretSchema,s as stabilityToEnum};

package/dist/templates/integration.js

@@ -0,0 +1,39 @@
+import{toPascalCase as e}from"./utils.js";import{escape as t,renderByokSetup as n,renderConfigExample as r,renderConfigSchema as i,renderConstraints as a,renderProvides as o,renderRequires as s,renderSecretExample as c,renderSecretSchema as l,stabilityToEnum as u}from"./integration-utils.js";function d(d){let f=e(d.name.split(`.`).pop()??`Integration`),p=`${f}IntegrationSpec`,m=`register${f}Integration`,h=d.supportedModes.length?d.supportedModes:[`managed`],g=h.map(e=>`'${e}'`).join(`, `),_=o(d),v=s(d),y=i(d.configFields),b=r(d.configFields),x=l(d.secretFields),S=c(d.secretFields),C=d.docsUrl?`  docsUrl: '${t(d.docsUrl)}',\n`:``,w=a(d.rateLimitRpm,d.rateLimitRph),T=n(h,d.byokSetupInstructions,d.byokRequiredScopes);return`import { StabilityEnum } from '@lssm/lib.contracts/ownership';
+import type { IntegrationSpec } from '@lssm/lib.contracts/integrations/spec';
+import type { IntegrationSpecRegistry } from '@lssm/lib.contracts/integrations/spec';
+
+export const ${p}: IntegrationSpec = {
+  meta: {
+    key: '${t(d.name)}',
+    version: ${d.version},
+    category: '${d.category}',
+    displayName: '${t(d.displayName)}',
+    title: '${t(d.title)}',
+    description: '${t(d.description)}',
+    domain: '${t(d.domain)}',
+    owners: [${d.owners.map(e=>`'${t(e)}'`).join(`, `)}],
+    tags: [${d.tags.map(e=>`'${t(e)}'`).join(`, `)}],
+    stability: StabilityEnum.${u(d.stability)},
+  },
+  supportedModes: [${g}],
+  capabilities: {
+    provides: [
+${_}
+    ],
+${v.length>0?`${v}\n`:``}  },
+  configSchema: {
+${y}    example: ${b},
+  },
+  secretSchema: {
+${x}    example: ${S},
+  },
+${C}${w}${T}  healthCheck: {
+    method: '${d.healthCheckMethod}',
+    timeoutMs: ${d.healthCheckTimeoutMs??5e3},
+  },
+};
+
+export function ${m}(registry: IntegrationSpecRegistry): IntegrationSpecRegistry {
+  return registry.register(${p});
+}
+`}export{d as generateIntegrationSpec};

package/dist/templates/knowledge.js

@@ -0,0 +1,28 @@
+import{escapeString as e,toPascalCase as t}from"./utils.js";function n(n){let c=t(n.name.split(`.`).pop()??`KnowledgeSpace`),l=`${c}KnowledgeSpace`,u=`register${c}KnowledgeSpace`,d=r(n),f=i(n),p=a(n),m=n.policyName&&!n.policyVersion?` // defaults to latest version`:``;return`import { StabilityEnum } from '@lssm/lib.contracts/ownership';
+import type { KnowledgeSpaceSpec } from '@lssm/lib.contracts/knowledge/spec';
+import type { KnowledgeSpaceRegistry } from '@lssm/lib.contracts/knowledge/spec';
+
+export const ${l}: KnowledgeSpaceSpec = {
+  meta: {
+    key: '${e(n.name)}',
+    version: ${n.version},
+    category: '${n.category}',
+    displayName: '${s(n.displayName)}',
+    title: '${s(n.title)}',
+    description: '${s(n.description)}',
+    domain: '${s(n.domain)}',
+    owners: [${n.owners.map(t=>`'${e(t)}'`).join(`, `)}],
+    tags: [${n.tags.map(t=>`'${e(t)}'`).join(`, `)}],
+    stability: StabilityEnum.${o(n.stability)},
+  },
+  retention: ${d},
+  access: {
+${f}${n.policyName?`    policy: { name: '${e(n.policyName)}',${n.policyVersion?` version: ${n.policyVersion}`:``} },${m}\n`:``}  },
+${p}  description: '${s(n.description||n.displayName)}',
+};
+
+export function ${u}(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry {
+  return registry.register(${l});
+}
+`}function r(e){return`{ ttlDays: ${e.retention.ttlDays===null?`null`:typeof e.retention.ttlDays==`number`?String(e.retention.ttlDays):`null`}${typeof e.retention.archiveAfterDays==`number`?`, archiveAfterDays: ${e.retention.archiveAfterDays}`:``} }`}function i(e){return`${`    trustLevel: '${e.trustLevel}',\n`}${`    automationWritable: ${e.automationWritable},\n`}`}function a(e){let t=[];return e.embeddingModel&&t.push(`    embeddingModel: '${s(e.embeddingModel)}'`),typeof e.chunkSize==`number`&&t.push(`    chunkSize: ${e.chunkSize}`),e.vectorDbIntegration&&t.push(`    vectorDbIntegration: '${s(e.vectorDbIntegration)}'`),t.length===0?``:`  indexing: {\n${t.join(`,
+`)}\n  },\n`}function o(e){switch(e){case`beta`:return`Beta`;case`stable`:return`Stable`;case`deprecated`:return`Deprecated`;case`experimental`:default:return`Experimental`}}function s(e){return e.replace(/`/g,"\\`").replace(/'/g,`\\'`)}export{n as generateKnowledgeSpaceSpec};

package/dist/templates/migration.js

@@ -0,0 +1,37 @@
+import{escapeString as e,toPascalCase as t}from"./utils.js";function n(n){let a=`${t(n.name.split(`.`).pop()??`Migration`)}Migration`,o=n.dependencies.length>0?`dependencies: [${n.dependencies.map(t=>`'${e(t)}'`).join(`, `)}],`:``;return`import type { MigrationSpec } from '@lssm/lib.contracts/migrations';
+
+export const ${a}: MigrationSpec = {
+  meta: {
+    name: '${e(n.name)}',
+    version: ${n.version},
+    title: '${i(n.title)}',
+    description: '${i(n.description??``)}',
+    domain: '${i(n.domain)}',
+    owners: [${n.owners.map(t=>`'${e(t)}'`).join(`, `)}],
+    tags: [${n.tags.map(t=>`'${e(t)}'`).join(`, `)}],
+    stability: '${n.stability}',
+  },
+  plan: {
+    up: [
+${r(n.up)}
+    ],${n.down&&n.down.length?`
+    down: [
+${r(n.down)}
+    ],`:``}
+  },
+  ${o}
+};
+`}function r(e){return e.map(e=>{let t=e.description?`description: '${i(e.description)}',`:``;switch(e.kind){case`schema`:return`      {
+        kind: 'schema',
+        ${t}
+        sql: \`${i(e.sql??``)}\`,
+      }`;case`data`:return`      {
+        kind: 'data',
+        ${t}
+        script: \`${i(e.script??``)}\`,
+      }`;case`validation`:default:return`      {
+        kind: 'validation',
+        ${t}
+        assertion: \`${i(e.assertion??``)}\`,
+      }`}}).join(`,
+`)}function i(e){return e.replace(/`/g,"\\`").replace(/'/g,`\\'`)}export{n as generateMigrationSpec};

package/dist/templates/operation.js

@@ -0,0 +1,88 @@
+import{capitalize as e,toPascalCase as t}from"./utils.js";function n(n){let{name:r,version:i,kind:a,description:o,goal:s,context:c,stability:l,owners:u,tags:d,auth:f,flags:p}=n,m=t(r.split(`.`).pop()??`Unknown`)+`Spec`,h=m.replace(`Spec`,`Input`),g=m.replace(`Spec`,`Output`);return`import { define${e(a)} } from '@lssm/lib.contracts';
+import { ScalarTypeEnum, SchemaModel } from '@lssm/lib.schema';
+
+// TODO: Define input schema
+export const ${h} = new SchemaModel({
+  name: '${h}',
+  description: 'Input for ${r}',
+  fields: {
+    // Add your fields here
+    // example: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+  },
+});
+
+// TODO: Define output schema
+export const ${g} = new SchemaModel({
+  name: '${g}',
+  description: 'Output for ${r}',
+  fields: {
+    // Add your fields here
+    ok: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+  },
+});
+
+export const ${m} = define${e(a)}({
+  meta: {
+    name: '${r}',
+    version: ${i},
+    stability: '${l}',
+    owners: [${u.map(e=>`'${e}'`).join(`, `)}],
+    tags: [${d.map(e=>`'${e}'`).join(`, `)}],
+    description: '${o}',
+    goal: '${s}',
+    context: '${c}',
+  },
+
+  io: {
+    input: ${h},
+    output: ${g},
+    errors: {
+      // Define possible errors
+      // EXAMPLE_ERROR: {
+      //   description: 'Example error description',
+      //   http: 400,
+      //   when: 'When this error occurs',
+      // },
+    },
+  },
+
+  policy: {
+    auth: '${f}',
+    ${p.length>0?`flags: [${p.map(e=>`'${e}'`).join(`, `)}],`:`// flags: [],`}
+  },
+
+  sideEffects: {
+    ${n.emitsEvents?`emits: [
+      // Define events to emit
+      // { ref: SomeEventSpec, when: 'always' }
+    ],`:`// emits: [],`}
+    analytics: [
+      // Define analytics events
+    ],
+  },
+
+  transport: {
+    rest: { method: '${a===`command`?`POST`:`GET`}' },
+    gql: { field: '${r.replace(/\./g,`_`)}' },
+    mcp: { toolName: '${r}.v${i}' },
+  },
+
+  acceptance: {
+    scenarios: [
+      {
+        name: 'Happy path',
+        given: ['preconditions'],
+        when: ['action taken'],
+        then: ['expected outcome'],
+      },
+    ],
+    examples: [
+      {
+        name: 'Example usage',
+        input: { /* example input */ },
+        output: { ok: true },
+      },
+    ],
+  },
+});
+`}export{n as generateOperationSpec};

package/dist/templates/presentation.js

@@ -0,0 +1,53 @@
+import{toPascalCase as e}from"./utils.js";function t(t){let{name:n,version:r,description:i,stability:a,owners:o,tags:s,presentationKind:c}=t,l=e(n.replace(/\./g,`_`))+`Presentation`,u=``;switch(c){case`web_component`:u=`  content: {
+    kind: 'web_component',
+    framework: 'react',
+    componentKey: '${n.replace(/\./g,`_`)}',
+    props: new SchemaModel({
+      name: '${l}Props',
+      description: 'Props for ${n}',
+      fields: {
+        // TODO: Define component props
+      },
+    }),
+    analytics: [
+      // TODO: Define analytics events
+    ],
+  },`;break;case`markdown`:u=`  content: {
+    kind: 'markdown',
+    content: \`
+# ${i}
+
+TODO: Add markdown content here
+    \`,
+    // Or use resourceUri: 'feature://${n}/guide.md'
+  },`;break;case`data`:u=`  content: {
+    kind: 'data',
+    mimeType: 'application/json',
+    model: new SchemaModel({
+      name: '${l}Data',
+      description: 'Data structure for ${n}',
+      fields: {
+        // TODO: Define data structure
+      },
+    }),
+  },`;break}return`import type { PresentationSpec } from '@lssm/lib.contracts/presentations';
+import { SchemaModel, ScalarTypeEnum } from '@lssm/lib.schema';
+
+export const ${l}: PresentationSpec = {
+  meta: {
+    name: '${n}',
+    version: ${r},
+    stability: '${a}',
+    owners: [${o.map(e=>`'${e}'`).join(`, `)}],
+    tags: [${s.map(e=>`'${e}'`).join(`, `)}],
+    description: '${i}',
+  },
+  
+  policy: {
+    // flags: [],
+    // pii: [],
+  },
+  
+${u}
+};
+`}export{t as generatePresentationSpec};

package/dist/templates/telemetry.js

@@ -0,0 +1,69 @@
+import{toPascalCase as e}from"./utils.js";function t(t){let i=e(t.name.split(`.`).pop()??`Telemetry`)+`Telemetry`,a=t.providers?.length?`providers: [
+${t.providers.map(e=>`      {
+        type: '${e.type}',
+        config: ${r(e.config)},
+      }`).join(`,
+`)}
+    ],`:``,o=t.events.map(e=>{let t=e.properties.map(e=>`      '${e.name}': {
+        type: '${e.type}',
+        ${e.required?`required: true,`:``}
+        ${e.pii?`pii: true,`:``}
+        ${e.redact?`redact: true,`:``}
+        ${e.description?`description: '${n(e.description)}',`:``}
+      }`).join(`,
+`),r=e.anomalyRules?.length?`      anomalyDetection: {
+        enabled: true,
+        ${typeof e.anomalyMinimumSample==`number`?`minimumSample: ${e.anomalyMinimumSample},`:``}
+        thresholds: [
+${e.anomalyRules.map(e=>`          {
+            metric: '${n(e.metric)}',
+            ${typeof e.min==`number`?`min: ${e.min},`:``}
+            ${typeof e.max==`number`?`max: ${e.max},`:``}
+          }`).join(`,
+`)}
+        ],
+        actions: [${(e.anomalyActions??[]).map(e=>`'${e}'`).join(`, `)}],
+      },`:e.anomalyEnabled?`      anomalyDetection: {
+        enabled: true,
+        ${typeof e.anomalyMinimumSample==`number`?`minimumSample: ${e.anomalyMinimumSample},`:``}
+      },`:``;return`    {
+      name: '${n(e.name)}',
+      version: ${e.version},
+      semantics: {
+        what: '${n(e.what)}',
+        ${e.who?`who: '${n(e.who)}',`:``}
+        ${e.why?`why: '${n(e.why)}',`:``}
+      },
+      privacy: '${e.privacy}',
+      properties: {
+${t}
+      },
+      ${typeof e.retentionDays==`number`?`retention: { days: ${e.retentionDays}, ${e.retentionPolicy?`policy: '${e.retentionPolicy}'`:``} },`:``}
+      ${typeof e.samplingRate==`number`?`sampling: { rate: ${e.samplingRate}${e.samplingConditions?`, conditions: ['${n(e.samplingConditions)}']`:``} },`:``}
+${r}
+      ${e.tags?.length?`tags: [${e.tags.map(e=>`'${n(e)}'`).join(`, `)}],`:``}
+    }`}).join(`,
+`);return`import type { TelemetrySpec } from '@lssm/lib.contracts/telemetry';
+
+export const ${i}: TelemetrySpec = {
+  meta: {
+    name: '${n(t.name)}',
+    version: ${t.version},
+    title: '${n(t.name)} telemetry',
+    description: '${n(t.description||`Describe the purpose of this telemetry spec.`)}',
+    domain: '${n(t.domain)}',
+    owners: [${t.owners.map(e=>`'${n(e)}'`).join(`, `)}],
+    tags: [${t.tags.map(e=>`'${n(e)}'`).join(`, `)}],
+    stability: '${t.stability}',
+  },
+  config: {
+    ${typeof t.defaultRetentionDays==`number`?`defaultRetentionDays: ${t.defaultRetentionDays},`:``}
+    ${typeof t.defaultSamplingRate==`number`?`defaultSamplingRate: ${t.defaultSamplingRate},`:``}
+    ${t.anomalyEnabled?`anomalyDetection: { enabled: true${typeof t.anomalyCheckIntervalMs==`number`?`, checkIntervalMs: ${t.anomalyCheckIntervalMs}`:``} },`:``}
+${a}
+  },
+  events: [
+${o}
+  ],
+};
+`}function n(e){return e.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}function r(e){let t=e.trim();return t?t.startsWith(`{`)&&t.endsWith(`}`)||t.startsWith(`[`)&&t.endsWith(`]`)?t:`'${n(t)}'`:`{}`}export{t as generateTelemetrySpec};

package/dist/templates/utils.js

@@ -0,0 +1 @@
+function e(e){let n=t(e);return n.charAt(0).toLowerCase()+n.slice(1)}function t(e){return e.split(/[-_.]/).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(``)}function n(e){return e.replace(/\./g,`-`).replace(/([a-z])([A-Z])/g,`$1-$2`).toLowerCase()}function r(e){return e.charAt(0).toUpperCase()+e.slice(1)}function i(e){return e.replace(/'/g,`\\'`)}export{r as capitalize,i as escapeString,e as toCamelCase,n as toKebabCase,t as toPascalCase};

package/dist/templates/workflow-runner.js

@@ -0,0 +1,42 @@
+function e({exportName:e,specImportPath:t,runnerName:n,workflowName:r}){return`import {
+  InMemoryStateStore,
+  WorkflowRegistry,
+  WorkflowRunner,
+} from '@lssm/lib.contracts/workflow';
+import { ${e} } from '${t}';
+
+/**
+ * Runner wiring for ${r}.
+ *
+ * TODO:
+ *  - Replace the in-memory state store with a persistent adapter if needed.
+ *  - Implement opExecutor to invoke the correct contract handlers.
+ *  - Wire eventEmitter to telemetry sinks.
+ */
+const registry = new WorkflowRegistry();
+registry.register(${e});
+
+const stateStore = new InMemoryStateStore();
+
+export const ${n} = new WorkflowRunner({
+  registry,
+  stateStore,
+  opExecutor: async (operation, input, ctx) => {
+    // TODO: route to the appropriate contract handler
+    // Example: return contractRegistry.execute(operation.name, operation.version, input, ctx);
+    throw new Error(
+      \`opExecutor for \${operation.name}.v\${operation.version} is not implemented\`
+    );
+  },
+  // appConfigProvider: async (state) => {
+  //   // TODO: return the ResolvedAppConfig for this workflow run (tenant/environment)
+  //   return undefined;
+  // },
+  // enforceCapabilities: async (operation, context) => {
+  //   // TODO: ensure required capabilities are satisfied using context.integrations/context.resolvedAppConfig
+  // },
+  eventEmitter: (_event, _payload) => {
+    // TODO: forward workflow events to telemetry or logging sinks
+  },
+});
+`}export{e as generateWorkflowRunnerTemplate};

package/dist/templates/workflow.js

@@ -0,0 +1,41 @@
+import{escapeString as e,toPascalCase as t}from"./utils.js";function n(n){let i=t(n.name.split(`.`).pop()??`Workflow`)+`Workflow`,a=n.steps.map(e=>r(e)).join(`,
+`),o=n.transitions.map(t=>`    {
+      from: '${t.from}',
+      to: '${t.to}',
+${t.condition?`      condition: '${e(t.condition)}',`:``}
+    }`).join(`,
+`);return`import type { WorkflowSpec } from '@lssm/lib.contracts/workflow';
+
+/**
+ * Workflow generated via contractspec CLI.
+ * TODO:
+ *  - Review step definitions and descriptions.
+ *  - Wire automation steps to actual operations.
+ *  - Provide form renderers for human steps.
+ *  - Add guards/conditions as needed.
+ */
+export const ${i}: WorkflowSpec = {
+  meta: {
+    name: '${n.name}',
+    version: ${n.version},
+    title: '${e(n.title)}',
+    description: '${e(n.description)}',
+    domain: '${e(n.domain)}',
+    stability: '${n.stability}',
+    owners: [${n.owners.map(e=>`'${e}'`).join(`, `)}],
+    tags: [${n.tags.map(e=>`'${e}'`).join(`, `)}],
+  },
+  definition: {
+${n.entryStepId?`    entryStepId: '${n.entryStepId}',\n`:``}    steps: [
+${a}
+    ],
+    transitions: [
+${o}
+    ],
+  },
+  ${n.policyFlags.length>0?`policy: {
+    flags: [${n.policyFlags.map(e=>`'${e}'`).join(`, `)}],
+  },`:`// policy: { flags: [] },`}
+};
+`}function r(t){let n=[`    {`,`      id: '${t.id}',`,`      type: '${t.type}',`,`      label: '${e(t.label)}',`];t.description&&n.push(`      description: '${e(t.description)}',`);let r=[];return t.operation&&r.push(`operation: { name: '${t.operation.name}', version: ${t.operation.version} }`),t.form&&r.push(`form: { key: '${t.form.key}', version: ${t.form.version} }`),r.length&&n.push(`      action: { ${r.join(`, `)} },`),n.push(`    }`),n.join(`
+`)}export{n as generateWorkflowSpec};

package/dist/types/generation-types.js

@@ -0,0 +1 @@
+const e={aiProvider:`claude`,agentMode:`simple`,outputDir:`./src`,conventions:{operations:`interactions/commands|queries`,events:`events`,presentations:`presentations`,forms:`forms`},defaultOwners:[],defaultTags:[]};export{e as DEFAULT_WORKSPACE_CONFIG};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@lssm/module.contractspec-workspace",
+  "version": "0.0.0-canary-20251213172311",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "build": "bun build:bundle && bun build:types",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun run"
+  },
+  "dependencies": {
+    "@lssm/lib.contracts": "workspace:*",
+    "@lssm/lib.schema": "workspace:*",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
+    "tsdown": "^0.17.0",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./*": "./*"
+    }
+  }
+}