@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217083314 → 0.0.0-canary-20251219202229

package/dist/modules/contractspec-workspace/dist/templates/telemetry.js

@@ -1,89 +0,0 @@
-import { toPascalCase } from "./utils.js";
-
-//#region ../../modules/contractspec-workspace/dist/templates/telemetry.js
-function generateTelemetrySpec(data) {
-	const specVar = toPascalCase(data.name.split(".").pop() ?? "Telemetry") + "Telemetry";
-	const providers = data.providers?.length ? `providers: [
-${data.providers.map((provider) => `      {
-        type: '${provider.type}',
-        config: ${formatConfigValue(provider.config)},
-      }`).join(",\n")}
-    ],` : "";
-	const events = data.events.map((event) => {
-		const properties = event.properties.map((prop) => `      '${prop.name}': {
-        type: '${prop.type}',
-        ${prop.required ? "required: true," : ""}
-        ${prop.pii ? "pii: true," : ""}
-        ${prop.redact ? "redact: true," : ""}
-        ${prop.description ? `description: '${escapeString(prop.description)}',` : ""}
-      }`).join(",\n");
-		const anomalyRules = event.anomalyRules?.length ? `      anomalyDetection: {
-        enabled: true,
-        ${typeof event.anomalyMinimumSample === "number" ? `minimumSample: ${event.anomalyMinimumSample},` : ""}
-        thresholds: [
-${event.anomalyRules.map((rule) => `          {
-            metric: '${escapeString(rule.metric)}',
-            ${typeof rule.min === "number" ? `min: ${rule.min},` : ""}
-            ${typeof rule.max === "number" ? `max: ${rule.max},` : ""}
-          }`).join(",\n")}
-        ],
-        actions: [${(event.anomalyActions ?? []).map((action) => `'${action}'`).join(", ")}],
-      },` : event.anomalyEnabled ? `      anomalyDetection: {
-        enabled: true,
-        ${typeof event.anomalyMinimumSample === "number" ? `minimumSample: ${event.anomalyMinimumSample},` : ""}
-      },` : "";
-		return `    {
-      name: '${escapeString(event.name)}',
-      version: ${event.version},
-      semantics: {
-        what: '${escapeString(event.what)}',
-        ${event.who ? `who: '${escapeString(event.who)}',` : ""}
-        ${event.why ? `why: '${escapeString(event.why)}',` : ""}
-      },
-      privacy: '${event.privacy}',
-      properties: {
-${properties}
-      },
-      ${typeof event.retentionDays === "number" ? `retention: { days: ${event.retentionDays}, ${event.retentionPolicy ? `policy: '${event.retentionPolicy}'` : ""} },` : ""}
-      ${typeof event.samplingRate === "number" ? `sampling: { rate: ${event.samplingRate}${event.samplingConditions ? `, conditions: ['${escapeString(event.samplingConditions)}']` : ""} },` : ""}
-${anomalyRules}
-      ${event.tags?.length ? `tags: [${event.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],` : ""}
-    }`;
-	}).join(",\n");
-	return `import type { TelemetrySpec } from '@lssm/lib.contracts/telemetry';
-
-export const ${specVar}: TelemetrySpec = {
-  meta: {
-    name: '${escapeString(data.name)}',
-    version: ${data.version},
-    title: '${escapeString(data.name)} telemetry',
-    description: '${escapeString(data.description || "Describe the purpose of this telemetry spec.")}',
-    domain: '${escapeString(data.domain)}',
-    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(", ")}],
-    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],
-    stability: '${data.stability}',
-  },
-  config: {
-    ${typeof data.defaultRetentionDays === "number" ? `defaultRetentionDays: ${data.defaultRetentionDays},` : ""}
-    ${typeof data.defaultSamplingRate === "number" ? `defaultSamplingRate: ${data.defaultSamplingRate},` : ""}
-    ${data.anomalyEnabled ? `anomalyDetection: { enabled: true${typeof data.anomalyCheckIntervalMs === "number" ? `, checkIntervalMs: ${data.anomalyCheckIntervalMs}` : ""} },` : ""}
-${providers}
-  },
-  events: [
-${events}
-  ],
-};
-`;
-}
-function escapeString(value) {
-	return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
-}
-function formatConfigValue(value) {
-	const trimmed = value.trim();
-	if (!trimmed) return "{}";
-	if (trimmed.startsWith("{") && trimmed.endsWith("}") || trimmed.startsWith("[") && trimmed.endsWith("]")) return trimmed;
-	return `'${escapeString(trimmed)}'`;
-}
-
-//#endregion
-export { generateTelemetrySpec };

package/dist/modules/contractspec-workspace/dist/templates/utils.js

@@ -1,38 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/templates/utils.js
-/**
-* Utility functions for template generation.
-*/
-/**
-* Convert string to camelCase.
-*/
-function toCamelCase(str) {
-	const pascal = toPascalCase(str);
-	return pascal.charAt(0).toLowerCase() + pascal.slice(1);
-}
-/**
-* Convert string to PascalCase.
-*/
-function toPascalCase(str) {
-	return str.split(/[-_.]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
-}
-/**
-* Convert string to kebab-case.
-*/
-function toKebabCase(str) {
-	return str.replace(/\./g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
-}
-/**
-* Capitalize first letter.
-*/
-function capitalize(str) {
-	return str.charAt(0).toUpperCase() + str.slice(1);
-}
-/**
-* Escape single quotes in string.
-*/
-function escapeString(value) {
-	return value.replace(/'/g, "\\'");
-}
-
-//#endregion
-export { capitalize, escapeString, toCamelCase, toKebabCase, toPascalCase };

package/dist/modules/contractspec-workspace/dist/templates/workflow-runner.js

@@ -1,48 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/templates/workflow-runner.js
-function generateWorkflowRunnerTemplate({ exportName, specImportPath, runnerName, workflowName }) {
-	return `import {
-  InMemoryStateStore,
-  WorkflowRegistry,
-  WorkflowRunner,
-} from '@lssm/lib.contracts/workflow';
-import { ${exportName} } from '${specImportPath}';
-
-/**
- * Runner wiring for ${workflowName}.
- *
- * 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(${exportName});
-
-const stateStore = new InMemoryStateStore();
-
-export const ${runnerName} = 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
-  },
-});
-`;
-}
-
-//#endregion
-export { generateWorkflowRunnerTemplate };

package/dist/modules/contractspec-workspace/dist/templates/workflow.js

@@ -1,67 +0,0 @@
-import { escapeString, toPascalCase } from "./utils.js";
-
-//#region ../../modules/contractspec-workspace/dist/templates/workflow.js
-/**
-* Generate workflow spec TypeScript code.
-*/
-function generateWorkflowSpec(data) {
-	const specVarName = toPascalCase(data.name.split(".").pop() ?? "Workflow") + "Workflow";
-	const stepsCode = data.steps.map((step) => formatStep(step)).join(",\n");
-	const transitionsCode = data.transitions.map((transition) => `    {
-      from: '${transition.from}',
-      to: '${transition.to}',
-${transition.condition ? `      condition: '${escapeString(transition.condition)}',` : ""}
-    }`).join(",\n");
-	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 ${specVarName}: WorkflowSpec = {
-  meta: {
-    name: '${data.name}',
-    version: ${data.version},
-    title: '${escapeString(data.title)}',
-    description: '${escapeString(data.description)}',
-    domain: '${escapeString(data.domain)}',
-    stability: '${data.stability}',
-    owners: [${data.owners.map((owner) => `'${owner}'`).join(", ")}],
-    tags: [${data.tags.map((tag) => `'${tag}'`).join(", ")}],
-  },
-  definition: {
-${data.entryStepId ? `    entryStepId: '${data.entryStepId}',\n` : ""}    steps: [
-${stepsCode}
-    ],
-    transitions: [
-${transitionsCode}
-    ],
-  },
-  ${data.policyFlags.length > 0 ? `policy: {
-    flags: [${data.policyFlags.map((flag) => `'${flag}'`).join(", ")}],
-  },` : "// policy: { flags: [] },"}
-};
-`;
-}
-function formatStep(step) {
-	const lines = [
-		`    {`,
-		`      id: '${step.id}',`,
-		`      type: '${step.type}',`,
-		`      label: '${escapeString(step.label)}',`
-	];
-	if (step.description) lines.push(`      description: '${escapeString(step.description)}',`);
-	const actionLines = [];
-	if (step.operation) actionLines.push(`operation: { name: '${step.operation.name}', version: ${step.operation.version} }`);
-	if (step.form) actionLines.push(`form: { key: '${step.form.key}', version: ${step.form.version} }`);
-	if (actionLines.length) lines.push(`      action: { ${actionLines.join(", ")} },`);
-	lines.push(`    }`);
-	return lines.join("\n");
-}
-
-//#endregion
-export { generateWorkflowSpec };

package/dist/modules/contractspec-workspace/dist/types/generation-types.js

@@ -1,20 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/types/generation-types.js
-/**
-* Default workspace configuration.
-*/
-const DEFAULT_WORKSPACE_CONFIG = {
-	aiProvider: "claude",
-	agentMode: "simple",
-	outputDir: "./src",
-	conventions: {
-		operations: "interactions/commands|queries",
-		events: "events",
-		presentations: "presentations",
-		forms: "forms"
-	},
-	defaultOwners: [],
-	defaultTags: []
-};
-
-//#endregion
-export { DEFAULT_WORKSPACE_CONFIG };

package/dist/services/agent-guide/adapters/claude-code.js

@@ -1,144 +0,0 @@
-import { AGENT_SYSTEM_PROMPTS } from "../../../libs/contracts/dist/llm/prompts.js";
-import "../../../libs/contracts/dist/llm/index.js";
-
-//#region src/services/agent-guide/adapters/claude-code.ts
-/**
-* Claude Code adapter implementation.
-* Optimized for Claude's extended thinking and code generation capabilities.
-*/
-var ClaudeCodeAdapter = class {
-	agentType = "claude-code";
-	/**
-	* Format an implementation plan for Claude Code.
-	* Uses structured markdown with clear sections and checklists.
-	*/
-	formatPlan(plan) {
-		const lines = [];
-		lines.push(`# Implement: ${plan.target.name}.v${plan.target.version}`);
-		lines.push("");
-		lines.push("## Context");
-		lines.push("");
-		lines.push(`**Goal:** ${plan.context.goal}`);
-		lines.push("");
-		lines.push(`**Description:** ${plan.context.description}`);
-		lines.push("");
-		if (plan.context.background) {
-			lines.push(`**Background:**`);
-			lines.push(plan.context.background);
-			lines.push("");
-		}
-		lines.push("## Specification");
-		lines.push("");
-		lines.push(plan.specMarkdown);
-		lines.push("");
-		if (plan.fileStructure.length > 0) {
-			lines.push("## Files to Create/Modify");
-			lines.push("");
-			for (const file of plan.fileStructure) {
-				const icon = file.type === "create" ? "📝" : "✏️";
-				lines.push(`${icon} \`${file.path}\``);
-				lines.push(`   ${file.purpose}`);
-				lines.push("");
-			}
-		}
-		lines.push("## Implementation Steps");
-		lines.push("");
-		for (const step of plan.steps) {
-			lines.push(`### ${step.order}. ${step.title}`);
-			lines.push("");
-			lines.push(step.description);
-			lines.push("");
-			lines.push("**Acceptance Criteria:**");
-			for (const criteria of step.acceptanceCriteria) lines.push(`- [ ] ${criteria}`);
-			lines.push("");
-		}
-		if (plan.constraints.policy.length > 0 || plan.constraints.security.length > 0 || plan.constraints.pii.length > 0) {
-			lines.push("## Constraints");
-			lines.push("");
-			if (plan.constraints.policy.length > 0) {
-				lines.push("### Policy");
-				for (const p of plan.constraints.policy) lines.push(`- ${p}`);
-				lines.push("");
-			}
-			if (plan.constraints.security.length > 0) {
-				lines.push("### Security");
-				for (const s of plan.constraints.security) lines.push(`- ⚠️ ${s}`);
-				lines.push("");
-			}
-			if (plan.constraints.pii.length > 0) {
-				lines.push("### PII Handling");
-				lines.push("The following fields contain personally identifiable information:");
-				for (const pii of plan.constraints.pii) lines.push(`- \`${pii}\``);
-				lines.push("");
-			}
-		}
-		lines.push("## Verification Checklist");
-		lines.push("");
-		lines.push("Before submitting, verify:");
-		for (const check of plan.verificationChecklist) lines.push(`- [ ] ${check}`);
-		lines.push("");
-		lines.push("## Instructions");
-		lines.push("");
-		lines.push("1. Implement each step in order");
-		lines.push("2. Use TypeScript with strict typing (no `any`)");
-		lines.push("3. Include JSDoc comments for public APIs");
-		lines.push("4. Handle all error cases defined in the spec");
-		lines.push("5. Emit events as specified");
-		lines.push("6. Mark checklist items as you complete them");
-		lines.push("");
-		return {
-			agent: "claude-code",
-			systemPrompt: AGENT_SYSTEM_PROMPTS["claude-code"],
-			taskPrompt: lines.join("\n")
-		};
-	}
-	/**
-	* Generate agent-specific configuration.
-	* For Claude Code, this generates a prompt that can be used as context.
-	*/
-	generateConfig(spec) {
-		const lines = [];
-		lines.push("# ContractSpec Implementation Context");
-		lines.push("");
-		lines.push("This codebase uses ContractSpec for spec-first development.");
-		lines.push("");
-		lines.push("## Spec Details");
-		lines.push("");
-		lines.push(`- **Name:** ${spec.meta.name}`);
-		lines.push(`- **Version:** ${spec.meta.version}`);
-		lines.push(`- **Kind:** ${spec.meta.kind}`);
-		lines.push(`- **Stability:** ${spec.meta.stability}`);
-		lines.push("");
-		lines.push("## Implementation Requirements");
-		lines.push("");
-		lines.push("1. Match input/output types exactly");
-		lines.push("2. Handle all defined error cases");
-		lines.push("3. Emit events as specified");
-		lines.push("4. Respect policy constraints");
-		lines.push("");
-		return lines.join("\n");
-	}
-	/**
-	* Parse Claude Code output to extract generated code.
-	*/
-	parseOutput(output) {
-		const codeBlockMatch = output.match(/```(?:typescript|ts|tsx)?\n([\s\S]*?)\n```/);
-		if (codeBlockMatch?.[1]) return { code: codeBlockMatch[1] };
-		const errors = [];
-		for (const pattern of [
-			/error:\s*(.+)/gi,
-			/failed:\s*(.+)/gi,
-			/cannot\s+(.+)/gi
-		]) {
-			const matches = output.matchAll(pattern);
-			for (const match of matches) if (match[1]) errors.push(match[1]);
-		}
-		if (errors.length > 0) return { errors };
-		return { code: output };
-	}
-};
-/** Singleton instance */
-const claudeCodeAdapter = new ClaudeCodeAdapter();
-
-//#endregion
-export { ClaudeCodeAdapter, claudeCodeAdapter };

package/dist/services/agent-guide/adapters/cursor-cli.js

@@ -1,135 +0,0 @@
-import { AGENT_SYSTEM_PROMPTS } from "../../../libs/contracts/dist/llm/prompts.js";
-import "../../../libs/contracts/dist/llm/index.js";
-
-//#region src/services/agent-guide/adapters/cursor-cli.ts
-/**
-* Cursor CLI adapter implementation.
-* Optimized for Cursor's background/composer mode.
-*/
-var CursorCLIAdapter = class {
-	agentType = "cursor-cli";
-	/**
-	* Format an implementation plan for Cursor CLI.
-	* Uses concise format optimized for Cursor's context window.
-	*/
-	formatPlan(plan) {
-		const lines = [];
-		lines.push(`# ${plan.target.name}.v${plan.target.version}`);
-		lines.push("");
-		lines.push(`> ${plan.context.goal}`);
-		lines.push("");
-		if (plan.fileStructure.length > 0) {
-			lines.push("## Files");
-			lines.push("");
-			for (const file of plan.fileStructure) lines.push(`- ${file.type}: \`${file.path}\` - ${file.purpose}`);
-			lines.push("");
-		}
-		lines.push("## Spec");
-		lines.push("");
-		lines.push(plan.specMarkdown);
-		lines.push("");
-		lines.push("## Steps");
-		lines.push("");
-		for (const step of plan.steps) lines.push(`${step.order}. **${step.title}**: ${step.description}`);
-		lines.push("");
-		const constraints = [...plan.constraints.policy, ...plan.constraints.security.map((s) => `⚠️ ${s}`)];
-		if (constraints.length > 0) {
-			lines.push("## Constraints");
-			lines.push("");
-			for (const c of constraints) lines.push(`- ${c}`);
-			lines.push("");
-		}
-		if (plan.constraints.pii.length > 0) {
-			lines.push("## PII Fields");
-			lines.push("");
-			lines.push(`Handle carefully: ${plan.constraints.pii.map((p) => `\`${p}\``).join(", ")}`);
-			lines.push("");
-		}
-		return {
-			agent: "cursor-cli",
-			systemPrompt: AGENT_SYSTEM_PROMPTS["cursor-cli"],
-			taskPrompt: lines.join("\n")
-		};
-	}
-	/**
-	* Generate Cursor rules (.mdc format) for a spec.
-	* Can be saved to .cursor/rules/ to provide persistent context.
-	*/
-	generateConfig(spec) {
-		const m = spec.meta;
-		const lines = [];
-		lines.push("---");
-		lines.push(`description: Implementation rules for ${m.name}.v${m.version}`);
-		lines.push(`globs: ["**/${m.name.replace(/\./g, "/")}/**"]`);
-		lines.push("alwaysApply: false");
-		lines.push("---");
-		lines.push("");
-		lines.push(`# ${m.name} Implementation Rules`);
-		lines.push("");
-		lines.push(`This ${m.kind} operation must follow the ContractSpec specification.`);
-		lines.push("");
-		lines.push("## Goal");
-		lines.push("");
-		lines.push(m.goal);
-		lines.push("");
-		lines.push("## Requirements");
-		lines.push("");
-		lines.push("1. Input/output types MUST match the spec schema exactly");
-		lines.push("2. All error cases MUST be handled");
-		if (spec.sideEffects?.emits?.length) lines.push("3. Events MUST be emitted as specified");
-		lines.push(`4. Auth level: ${spec.policy.auth}`);
-		if (spec.policy.idempotent !== void 0) lines.push(`5. Idempotency: ${spec.policy.idempotent}`);
-		lines.push("");
-		if (spec.io.errors && Object.keys(spec.io.errors).length > 0) {
-			lines.push("## Error Cases");
-			lines.push("");
-			for (const [code, err] of Object.entries(spec.io.errors)) lines.push(`- \`${code}\` (HTTP ${err.http ?? 400}): ${err.when}`);
-			lines.push("");
-		}
-		if (spec.sideEffects?.emits?.length) {
-			lines.push("## Events to Emit");
-			lines.push("");
-			for (const e of spec.sideEffects.emits) if ("ref" in e) lines.push(`- \`${e.ref.name}.v${e.ref.version}\`: ${e.when}`);
-			else lines.push(`- \`${e.name}.v${e.version}\`: ${e.when}`);
-			lines.push("");
-		}
-		if (spec.policy.pii?.length) {
-			lines.push("## PII Handling");
-			lines.push("");
-			lines.push("These fields contain PII and must be handled with care:");
-			for (const field of spec.policy.pii) lines.push(`- \`${field}\``);
-			lines.push("");
-		}
-		if (spec.acceptance?.scenarios?.length) {
-			lines.push("## Acceptance Scenarios");
-			lines.push("");
-			for (const s of spec.acceptance.scenarios) {
-				lines.push(`### ${s.name}`);
-				lines.push(`- Given: ${s.given.join("; ")}`);
-				lines.push(`- When: ${s.when.join("; ")}`);
-				lines.push(`- Then: ${s.then.join("; ")}`);
-				lines.push("");
-			}
-		}
-		return lines.join("\n");
-	}
-	/**
-	* Generate a cursor rules file path for a spec.
-	*/
-	getCursorRulesPath(spec) {
-		return `.cursor/rules/${spec.meta.name.replace(/\./g, "-")}.mdc`;
-	}
-	/**
-	* Parse Cursor output to extract generated code.
-	*/
-	parseOutput(output) {
-		const codeBlockMatch = output.match(/```(?:typescript|ts|tsx|javascript|js)?\n([\s\S]*?)\n```/);
-		if (codeBlockMatch?.[1]) return { code: codeBlockMatch[1] };
-		return { code: output };
-	}
-};
-/** Singleton instance */
-const cursorCLIAdapter = new CursorCLIAdapter();
-
-//#endregion
-export { CursorCLIAdapter, cursorCLIAdapter };