@contractspec/bundle.workspace 1.46.2 → 1.48.0

package/dist/services/vibe/pack.mjs

@@ -0,0 +1,66 @@
+import { findWorkspaceRoot } from "../../adapters/workspace.mjs";
+import { copyFile, mkdir, readdir, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { existsSync } from "node:fs";
+
+//#region src/services/vibe/pack.ts
+/**
+* Pack installation service.
+*
+* Install vibe packs from local paths or registry.
+*/
+/**
+* Install a vibe pack from a local path.
+*/
+async function installPack(packPath, cwd) {
+	const workingDir = cwd ?? process.cwd();
+	const root = findWorkspaceRoot(workingDir) ?? workingDir;
+	if (packPath.startsWith("registry:")) return {
+		success: false,
+		workflowsInstalled: 0,
+		templatesInstalled: 0,
+		error: "Registry pack install not yet implemented. Use local path."
+	};
+	const absPackPath = resolve(workingDir, packPath);
+	if (!existsSync(absPackPath)) return {
+		success: false,
+		workflowsInstalled: 0,
+		templatesInstalled: 0,
+		error: `Pack path not found: ${absPackPath}`
+	};
+	let workflowsCount = 0;
+	let templatesCount = 0;
+	const workflowsSrc = join(absPackPath, "workflows");
+	if (existsSync(workflowsSrc)) {
+		const workflowsDest = join(root, ".contractspec", "vibe", "workflows");
+		await mkdir(workflowsDest, { recursive: true });
+		const files = await readdir(workflowsSrc);
+		for (const file of files) if (file.endsWith(".json") || file.endsWith(".yaml") || file.endsWith(".yml")) {
+			await copyFile(join(workflowsSrc, file), join(workflowsDest, file));
+			workflowsCount++;
+		}
+	}
+	const templatesSrc = join(absPackPath, "templates");
+	if (existsSync(templatesSrc)) {
+		const templatesDest = join(root, ".contractspec", "vibe", "templates");
+		await mkdir(templatesDest, { recursive: true });
+		const files = await readdir(templatesSrc);
+		for (const file of files) {
+			const srcFile = join(templatesSrc, file);
+			const destFile = join(templatesDest, file);
+			if ((await stat(srcFile)).isFile()) {
+				await copyFile(srcFile, destFile);
+				templatesCount++;
+			}
+		}
+	}
+	return {
+		success: true,
+		workflowsInstalled: workflowsCount,
+		templatesInstalled: templatesCount
+	};
+}
+
+//#endregion
+export { installPack };
+//# sourceMappingURL=pack.mjs.map

package/dist/services/vibe/pack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.mjs","names":[],"sources":["../../../src/services/vibe/pack.ts"],"sourcesContent":["/**\n * Pack installation service.\n *\n * Install vibe packs from local paths or registry.\n */\n\nimport { mkdir, copyFile, readdir, stat } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport { findWorkspaceRoot } from '../../adapters/workspace';\n\nexport interface PackInstallResult {\n  success: boolean;\n  workflowsInstalled: number;\n  templatesInstalled: number;\n  error?: string;\n}\n\n/**\n * Install a vibe pack from a local path.\n */\nexport async function installPack(\n  packPath: string,\n  cwd?: string\n): Promise<PackInstallResult> {\n  const workingDir = cwd ?? process.cwd();\n  const root = findWorkspaceRoot(workingDir) ?? workingDir;\n\n  // Handle registry packs (future)\n  if (packPath.startsWith('registry:')) {\n    return {\n      success: false,\n      workflowsInstalled: 0,\n      templatesInstalled: 0,\n      error: 'Registry pack install not yet implemented. Use local path.',\n    };\n  }\n\n  const absPackPath = resolve(workingDir, packPath);\n  if (!existsSync(absPackPath)) {\n    return {\n      success: false,\n      workflowsInstalled: 0,\n      templatesInstalled: 0,\n      error: `Pack path not found: ${absPackPath}`,\n    };\n  }\n\n  let workflowsCount = 0;\n  let templatesCount = 0;\n\n  // Install workflows\n  const workflowsSrc = join(absPackPath, 'workflows');\n  if (existsSync(workflowsSrc)) {\n    const workflowsDest = join(root, '.contractspec', 'vibe', 'workflows');\n    await mkdir(workflowsDest, { recursive: true });\n\n    const files = await readdir(workflowsSrc);\n    for (const file of files) {\n      if (\n        file.endsWith('.json') ||\n        file.endsWith('.yaml') ||\n        file.endsWith('.yml')\n      ) {\n        await copyFile(join(workflowsSrc, file), join(workflowsDest, file));\n        workflowsCount++;\n      }\n    }\n  }\n\n  // Install templates\n  const templatesSrc = join(absPackPath, 'templates');\n  if (existsSync(templatesSrc)) {\n    const templatesDest = join(root, '.contractspec', 'vibe', 'templates');\n    await mkdir(templatesDest, { recursive: true });\n\n    const files = await readdir(templatesSrc);\n    for (const file of files) {\n      const srcFile = join(templatesSrc, file);\n      const destFile = join(templatesDest, file);\n      const stats = await stat(srcFile);\n      if (stats.isFile()) {\n        await copyFile(srcFile, destFile);\n        templatesCount++;\n      }\n    }\n  }\n\n  return {\n    success: true,\n    workflowsInstalled: workflowsCount,\n    templatesInstalled: templatesCount,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAqBA,eAAsB,YACpB,UACA,KAC4B;CAC5B,MAAM,aAAa,OAAO,QAAQ,KAAK;CACvC,MAAM,OAAO,kBAAkB,WAAW,IAAI;AAG9C,KAAI,SAAS,WAAW,YAAY,CAClC,QAAO;EACL,SAAS;EACT,oBAAoB;EACpB,oBAAoB;EACpB,OAAO;EACR;CAGH,MAAM,cAAc,QAAQ,YAAY,SAAS;AACjD,KAAI,CAAC,WAAW,YAAY,CAC1B,QAAO;EACL,SAAS;EACT,oBAAoB;EACpB,oBAAoB;EACpB,OAAO,wBAAwB;EAChC;CAGH,IAAI,iBAAiB;CACrB,IAAI,iBAAiB;CAGrB,MAAM,eAAe,KAAK,aAAa,YAAY;AACnD,KAAI,WAAW,aAAa,EAAE;EAC5B,MAAM,gBAAgB,KAAK,MAAM,iBAAiB,QAAQ,YAAY;AACtE,QAAM,MAAM,eAAe,EAAE,WAAW,MAAM,CAAC;EAE/C,MAAM,QAAQ,MAAM,QAAQ,aAAa;AACzC,OAAK,MAAM,QAAQ,MACjB,KACE,KAAK,SAAS,QAAQ,IACtB,KAAK,SAAS,QAAQ,IACtB,KAAK,SAAS,OAAO,EACrB;AACA,SAAM,SAAS,KAAK,cAAc,KAAK,EAAE,KAAK,eAAe,KAAK,CAAC;AACnE;;;CAMN,MAAM,eAAe,KAAK,aAAa,YAAY;AACnD,KAAI,WAAW,aAAa,EAAE;EAC5B,MAAM,gBAAgB,KAAK,MAAM,iBAAiB,QAAQ,YAAY;AACtE,QAAM,MAAM,eAAe,EAAE,WAAW,MAAM,CAAC;EAE/C,MAAM,QAAQ,MAAM,QAAQ,aAAa;AACzC,OAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,UAAU,KAAK,cAAc,KAAK;GACxC,MAAM,WAAW,KAAK,eAAe,KAAK;AAE1C,QADc,MAAM,KAAK,QAAQ,EACvB,QAAQ,EAAE;AAClB,UAAM,SAAS,SAAS,SAAS;AACjC;;;;AAKN,QAAO;EACL,SAAS;EACT,oBAAoB;EACpB,oBAAoB;EACrB"}

package/dist/services/vibe/types.d.mts

@@ -0,0 +1,59 @@
+//#region src/services/vibe/types.d.ts
+/**
+ * Vibe workflow types.
+ *
+ * Platform-agnostic types for workflow execution.
+ */
+type Track = 'quick' | 'product' | 'regulated';
+interface WorkflowContext {
+  root: string;
+  config: Record<string, unknown>;
+  dryRun: boolean;
+  track: Track;
+  json: boolean;
+  [key: string]: unknown;
+}
+interface WorkflowStep {
+  id: string;
+  label: string;
+  command?: string;
+  args?: string[];
+  manualCheckpoint?: boolean;
+  manualMessage?: string;
+  condition?: (ctx: WorkflowContext) => boolean | Promise<boolean>;
+  execute?: (ctx: WorkflowContext) => Promise<void>;
+  tracks?: Track[];
+}
+interface WorkflowStepResult {
+  id: string;
+  name: string;
+  status: 'pass' | 'fail' | 'skip';
+  command?: string;
+  artifactsTouched?: string[];
+  error?: string;
+}
+interface Workflow {
+  id: string;
+  name: string;
+  description: string;
+  steps: WorkflowStep[];
+}
+interface WorkflowResult {
+  success: boolean;
+  steps: WorkflowStepResult[];
+  stepsExecuted: string[];
+  artifactsTouched: string[];
+  error?: Error;
+}
+interface VibeConfig {
+  canonicalRoot: string;
+  workRoot: string;
+  generatedRoot: string;
+  alwaysInjectFiles: string[];
+  contextExportAllowlist: string[];
+  [key: string]: unknown;
+}
+declare const DEFAULT_VIBE_CONFIG: VibeConfig;
+//#endregion
+export { DEFAULT_VIBE_CONFIG, Track, VibeConfig, Workflow, WorkflowContext, WorkflowResult, WorkflowStep, WorkflowStepResult };
+//# sourceMappingURL=types.d.mts.map

package/dist/services/vibe/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/vibe/types.ts"],"sourcesContent":[],"mappings":";;AAMA;AAEA;AASA;;AAOkD,KAlBtC,KAAA,GAkBsC,OAAA,GAAA,SAAA,GAAA,WAAA;AAChC,UAjBD,eAAA,CAiBC;EAAoB,IAAA,EAAA,MAAA;EAC3B,MAAA,EAhBD,MAgBC,CAAA,MAAA,EAAA,OAAA,CAAA;EAAK,MAAA,EAAA,OAAA;EAGC,KAAA,EAjBR,KAiBQ;EASA,IAAA,EAAA,OAAQ;EAOR,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAc;AAQ/B;AASa,UA7CI,YAAA,CAmDhB;;;;;;;oBA5CmB,8BAA8B;kBAChC,oBAAoB;WAC3B;;UAGM,kBAAA;;;;;;;;UASA,QAAA;;;;SAIR;;UAGQ,cAAA;;SAER;;;UAGC;;UAGO,UAAA;;;;;;;;cASJ,qBAAqB"}

package/dist/services/vibe/types.mjs

@@ -0,0 +1,12 @@
+//#region src/services/vibe/types.ts
+const DEFAULT_VIBE_CONFIG = {
+	canonicalRoot: "contracts",
+	workRoot: ".contractspec/work",
+	generatedRoot: "src/generated",
+	alwaysInjectFiles: [],
+	contextExportAllowlist: []
+};
+
+//#endregion
+export { DEFAULT_VIBE_CONFIG };
+//# sourceMappingURL=types.mjs.map

package/dist/services/vibe/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/services/vibe/types.ts"],"sourcesContent":["/**\n * Vibe workflow types.\n *\n * Platform-agnostic types for workflow execution.\n */\n\nexport type Track = 'quick' | 'product' | 'regulated';\n\nexport interface WorkflowContext {\n  root: string;\n  config: Record<string, unknown>;\n  dryRun: boolean;\n  track: Track;\n  json: boolean;\n  [key: string]: unknown;\n}\n\nexport interface WorkflowStep {\n  id: string;\n  label: string;\n  command?: string;\n  args?: string[];\n  manualCheckpoint?: boolean;\n  manualMessage?: string;\n  condition?: (ctx: WorkflowContext) => boolean | Promise<boolean>;\n  execute?: (ctx: WorkflowContext) => Promise<void>;\n  tracks?: Track[];\n}\n\nexport interface WorkflowStepResult {\n  id: string;\n  name: string;\n  status: 'pass' | 'fail' | 'skip';\n  command?: string;\n  artifactsTouched?: string[];\n  error?: string;\n}\n\nexport interface Workflow {\n  id: string;\n  name: string;\n  description: string;\n  steps: WorkflowStep[];\n}\n\nexport interface WorkflowResult {\n  success: boolean;\n  steps: WorkflowStepResult[];\n  stepsExecuted: string[];\n  artifactsTouched: string[];\n  error?: Error;\n}\n\nexport interface VibeConfig {\n  canonicalRoot: string;\n  workRoot: string;\n  generatedRoot: string;\n  alwaysInjectFiles: string[];\n  contextExportAllowlist: string[];\n  [key: string]: unknown;\n}\n\nexport const DEFAULT_VIBE_CONFIG: VibeConfig = {\n  canonicalRoot: 'contracts',\n  workRoot: '.contractspec/work',\n  generatedRoot: 'src/generated',\n  alwaysInjectFiles: [],\n  contextExportAllowlist: [],\n};\n"],"mappings":";AA8DA,MAAa,sBAAkC;CAC7C,eAAe;CACf,UAAU;CACV,eAAe;CACf,mBAAmB,EAAE;CACrB,wBAAwB,EAAE;CAC3B"}

package/dist/services/view/index.d.mts

@@ -0,0 +1,11 @@
+import { WorkspaceAdapters } from "../../ports/logger.mjs";
+
+//#region src/services/view/index.d.ts
+type ViewAudience = 'product' | 'eng' | 'qa';
+/**
+ * Generate an audience-specific view of a spec file.
+ */
+declare function generateView(specFile: string, audience: ViewAudience, adapters: WorkspaceAdapters): Promise<string>;
+//#endregion
+export { ViewAudience, generateView };
+//# sourceMappingURL=index.d.mts.map

package/dist/services/view/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/services/view/index.ts"],"sourcesContent":[],"mappings":";;;KAMY,YAAA;;AAAZ;AAKA;AAEY,iBAFU,YAAA,CAEV,QAAA,EAAA,MAAA,EAAA,QAAA,EAAA,YAAA,EAAA,QAAA,EACA,iBADA,CAAA,EAET,OAFS,CAAA,MAAA,CAAA"}

package/dist/services/view/index.mjs

@@ -0,0 +1,119 @@
+import { loadSpecFromSource } from "@contractspec/module.workspace";
+
+//#region src/services/view/index.ts
+/**
+* Generate an audience-specific view of a spec file.
+*/
+async function generateView(specFile, audience, adapters) {
+	if (!await adapters.fs.exists(specFile)) throw new Error(`File not found: ${specFile}`);
+	const specs = await loadSpecFromSource(specFile);
+	if (specs.length === 0) return `No specs found in ${specFile} (Parse result empty)`;
+	return specs.map((spec) => formatSpecForAudience(spec, audience)).join("\n\n---\n\n");
+}
+function formatSpecForAudience(spec, audience) {
+	const lines = [];
+	switch (audience) {
+		case "product":
+			formatProductView(spec, lines);
+			break;
+		case "eng":
+			formatEngView(spec, lines);
+			break;
+		case "qa":
+			formatQaView(spec, lines);
+			break;
+	}
+	return lines.join("\n");
+}
+function formatProductView(spec, lines) {
+	lines.push(`# ${spec.meta.key}`);
+	lines.push("**View**: Product (User Flow & Capabilities)");
+	lines.push("");
+	if (spec.meta.goal) lines.push(`### Goal\n${spec.meta.goal}\n`);
+	if (spec.meta.context) lines.push(`### Context\n${spec.meta.context}\n`);
+	if (spec.specType === "feature") {
+		if (spec.operations?.length) {
+			lines.push("### Capabilities (Operations)");
+			spec.operations.forEach((op) => lines.push(`- **${op.name}**`));
+			lines.push("");
+		}
+		if (spec.presentations?.length) {
+			lines.push("### User Interfaces (Presentations)");
+			spec.presentations.forEach((p) => lines.push(`- **${p.name}**`));
+			lines.push("");
+		}
+	} else if (spec.specType === "operation") {
+		lines.push("### Behavior");
+		if (spec.hasPolicy) lines.push("- ✅ Enforces Business Policies");
+		if (spec.hasIo) lines.push("- ✅ Validates Inputs/Outputs");
+		if (spec.emittedEvents?.length) {
+			lines.push("### Triggers");
+			spec.emittedEvents.forEach((ev) => lines.push(`- **${ev.name}** (Event)`));
+		}
+	} else lines.push(`Type: ${spec.specType}`);
+}
+function formatEngView(spec, lines) {
+	lines.push(`# ${spec.meta.key}`);
+	lines.push("**View**: Engineering (API, Schemas, Constraints)");
+	lines.push("");
+	lines.push(`- **Type**: \`${spec.specType}\``);
+	lines.push(`- **Version**: \`${spec.meta.version}\``);
+	if (spec.meta.stability) lines.push(`- **Stability**: \`${spec.meta.stability}\``);
+	lines.push("");
+	if (spec.specType === "operation") {
+		lines.push("### Contract Details");
+		lines.push(`- **I/O Schema**: ${spec.hasIo ? "✅ Defined" : "❌ Missing"}`);
+		lines.push(`- **Policy Config**: ${spec.hasPolicy ? "✅ Defined" : "❌ None"}`);
+		lines.push("");
+		if (spec.emittedEvents?.length) {
+			lines.push("### Emitted Events");
+			spec.emittedEvents.forEach((ev) => lines.push(`- \`${ev.name}\``));
+			lines.push("");
+		}
+	} else if (spec.specType === "feature") {
+		if (spec.operations?.length) {
+			lines.push("### Operations");
+			spec.operations.forEach((op) => lines.push(`- \`${op.name}\``));
+			lines.push("");
+		}
+		if (spec.events?.length) {
+			lines.push("### Events");
+			spec.events.forEach((ev) => lines.push(`- \`${ev.name}\``));
+			lines.push("");
+		}
+	}
+	if (spec.sourceBlock) {
+		lines.push("### Source Signature");
+		lines.push("```typescript");
+		lines.push(spec.sourceBlock);
+		lines.push("```");
+	}
+}
+function formatQaView(spec, lines) {
+	lines.push(`# ${spec.meta.key}`);
+	lines.push("**View**: QA (Scenarios, Test Coverage)");
+	lines.push("");
+	if (spec.meta.goal) lines.push(`**Goal**: ${spec.meta.goal}\n`);
+	if (spec.testRefs?.length) {
+		lines.push("### Linked Scenarios");
+		spec.testRefs.forEach((test) => lines.push(`- 🧪 \`${test.name}\``));
+		lines.push("");
+	} else {
+		lines.push("### Linked Scenarios");
+		lines.push("_(No explicit test refs found)_");
+		lines.push("");
+	}
+	lines.push("### Verification Checklist");
+	if (spec.specType === "operation") {
+		lines.push(`- [ ] Verify input validation for \`${spec.meta.key}\` (Success/Fail cases)`);
+		if (spec.hasPolicy) lines.push(`- [ ] Verify policy enforcement rules`);
+		if (spec.emittedEvents?.length) spec.emittedEvents.forEach((ev) => lines.push(`- [ ] Verify event \`${ev.name}\` is emitted`));
+	} else if (spec.specType === "feature") {
+		if (spec.operations?.length) spec.operations.forEach((op) => lines.push(`- [ ] Test Operation flow: \`${op.name}\``));
+		if (spec.presentations?.length) spec.presentations.forEach((p) => lines.push(`- [ ] Test UI Component: \`${p.name}\``));
+	}
+}
+
+//#endregion
+export { generateView };
+//# sourceMappingURL=index.mjs.map

package/dist/services/view/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/services/view/index.ts"],"sourcesContent":["import {\n  loadSpecFromSource,\n  type ParsedSpec,\n} from '@contractspec/module.workspace';\nimport type { WorkspaceAdapters } from '../../ports/logger';\n\nexport type ViewAudience = 'product' | 'eng' | 'qa';\n\n/**\n * Generate an audience-specific view of a spec file.\n */\nexport async function generateView(\n  specFile: string,\n  audience: ViewAudience,\n  adapters: WorkspaceAdapters\n): Promise<string> {\n  // Using the module's static analysis, which uses node:fs internally\n  // We check existence first using adapters for better error handling\n  if (!(await adapters.fs.exists(specFile))) {\n    throw new Error(`File not found: ${specFile}`);\n  }\n\n  const specs = await loadSpecFromSource(specFile);\n\n  if (specs.length === 0) {\n    return `No specs found in ${specFile} (Parse result empty)`;\n  }\n\n  return specs\n    .map((spec) => formatSpecForAudience(spec, audience))\n    .join('\\n\\n---\\n\\n');\n}\n\nfunction formatSpecForAudience(\n  spec: ParsedSpec,\n  audience: ViewAudience\n): string {\n  const lines: string[] = [];\n\n  switch (audience) {\n    case 'product':\n      formatProductView(spec, lines);\n      break;\n    case 'eng':\n      formatEngView(spec, lines);\n      break;\n    case 'qa':\n      formatQaView(spec, lines);\n      break;\n  }\n\n  return lines.join('\\n');\n}\n\nfunction formatProductView(spec: ParsedSpec, lines: string[]) {\n  lines.push(`# ${spec.meta.key}`);\n  lines.push('**View**: Product (User Flow & Capabilities)');\n  lines.push('');\n\n  if (spec.meta.goal) {\n    lines.push(`### Goal\\n${spec.meta.goal}\\n`);\n  }\n  if (spec.meta.context) {\n    lines.push(`### Context\\n${spec.meta.context}\\n`);\n  }\n\n  if (spec.specType === 'feature') {\n    if (spec.operations?.length) {\n      lines.push('### Capabilities (Operations)');\n      spec.operations.forEach((op) => lines.push(`- **${op.name}**`));\n      lines.push('');\n    }\n    if (spec.presentations?.length) {\n      lines.push('### User Interfaces (Presentations)');\n      spec.presentations.forEach((p) => lines.push(`- **${p.name}**`));\n      lines.push('');\n    }\n  } else if (spec.specType === 'operation') {\n    lines.push('### Behavior');\n    if (spec.hasPolicy) lines.push('- ✅ Enforces Business Policies');\n    if (spec.hasIo) lines.push('- ✅ Validates Inputs/Outputs');\n    if (spec.emittedEvents?.length) {\n      lines.push('### Triggers');\n      spec.emittedEvents.forEach((ev) =>\n        lines.push(`- **${ev.name}** (Event)`)\n      );\n    }\n  } else {\n    lines.push(`Type: ${spec.specType}`);\n  }\n}\n\nfunction formatEngView(spec: ParsedSpec, lines: string[]) {\n  lines.push(`# ${spec.meta.key}`);\n  lines.push('**View**: Engineering (API, Schemas, Constraints)');\n  lines.push('');\n\n  lines.push(`- **Type**: \\`${spec.specType}\\``);\n  lines.push(`- **Version**: \\`${spec.meta.version}\\``);\n  if (spec.meta.stability)\n    lines.push(`- **Stability**: \\`${spec.meta.stability}\\``);\n  lines.push('');\n\n  if (spec.specType === 'operation') {\n    lines.push('### Contract Details');\n    lines.push(`- **I/O Schema**: ${spec.hasIo ? '✅ Defined' : '❌ Missing'}`);\n    lines.push(\n      `- **Policy Config**: ${spec.hasPolicy ? '✅ Defined' : '❌ None'}`\n    );\n    lines.push('');\n\n    if (spec.emittedEvents?.length) {\n      lines.push('### Emitted Events');\n      spec.emittedEvents.forEach((ev) => lines.push(`- \\`${ev.name}\\``));\n      lines.push('');\n    }\n  } else if (spec.specType === 'feature') {\n    if (spec.operations?.length) {\n      lines.push('### Operations');\n      spec.operations.forEach((op) => lines.push(`- \\`${op.name}\\``));\n      lines.push('');\n    }\n    if (spec.events?.length) {\n      lines.push('### Events');\n      spec.events.forEach((ev) => lines.push(`- \\`${ev.name}\\``));\n      lines.push('');\n    }\n  }\n\n  if (spec.sourceBlock) {\n    lines.push('### Source Signature');\n    lines.push('```typescript');\n    lines.push(spec.sourceBlock);\n    lines.push('```');\n  }\n}\n\nfunction formatQaView(spec: ParsedSpec, lines: string[]) {\n  lines.push(`# ${spec.meta.key}`);\n  lines.push('**View**: QA (Scenarios, Test Coverage)');\n  lines.push('');\n\n  if (spec.meta.goal) {\n    lines.push(`**Goal**: ${spec.meta.goal}\\n`);\n  }\n\n  if (spec.testRefs?.length) {\n    lines.push('### Linked Scenarios');\n    spec.testRefs.forEach((test) => lines.push(`- 🧪 \\`${test.name}\\``));\n    lines.push('');\n  } else {\n    lines.push('### Linked Scenarios');\n    lines.push('_(No explicit test refs found)_');\n    lines.push('');\n  }\n\n  lines.push('### Verification Checklist');\n  if (spec.specType === 'operation') {\n    lines.push(\n      `- [ ] Verify input validation for \\`${spec.meta.key}\\` (Success/Fail cases)`\n    );\n    if (spec.hasPolicy) lines.push(`- [ ] Verify policy enforcement rules`);\n    if (spec.emittedEvents?.length) {\n      spec.emittedEvents.forEach((ev) =>\n        lines.push(`- [ ] Verify event \\`${ev.name}\\` is emitted`)\n      );\n    }\n  } else if (spec.specType === 'feature') {\n    if (spec.operations?.length) {\n      spec.operations.forEach((op) =>\n        lines.push(`- [ ] Test Operation flow: \\`${op.name}\\``)\n      );\n    }\n    if (spec.presentations?.length) {\n      spec.presentations.forEach((p) =>\n        lines.push(`- [ ] Test UI Component: \\`${p.name}\\``)\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/services/watch.d.mts

@@ -0,0 +1,25 @@
+import { FsAdapter } from "../ports/fs.mjs";
+import { WatchOptions, Watcher, WatcherAdapter } from "../ports/watcher.mjs";
+import { LoggerAdapter } from "../ports/logger.mjs";
+import { WorkspaceConfig } from "@contractspec/module.workspace";
+
+//#region src/services/watch.d.ts
+
+interface WatchSpecsOptions extends WatchOptions {
+  runValidate?: boolean;
+  runBuild?: boolean;
+  dryRun?: boolean;
+}
+type WatchBuildFn = (specPath: string) => Promise<void>;
+type WatchValidateFn = (specPath: string) => Promise<void>;
+declare function watchSpecs(adapters: {
+  watcher: WatcherAdapter;
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}, config: WorkspaceConfig, options: WatchSpecsOptions, overrides?: {
+  validate?: WatchValidateFn;
+  build?: WatchBuildFn;
+}): Watcher;
+//#endregion
+export { WatchBuildFn, WatchSpecsOptions, WatchValidateFn, watchSpecs };
+//# sourceMappingURL=watch.d.mts.map

package/dist/services/watch.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.mts","names":[],"sources":["../../src/services/watch.ts"],"sourcesContent":[],"mappings":";;;;;;;AAsBgB,UATC,iBAAA,SAA0B,YASjB,CAAA;EACH,WAAA,CAAA,EAAA,OAAA;EAAoB,QAAA,CAAA,EAAA,OAAA;EAAmB,MAAA,CAAA,EAAA,OAAA;;AAEnD,KANC,YAAA,GAMD,CAAA,QAAA,EAAA,MAAA,EAAA,GANsC,OAMtC,CAAA,IAAA,CAAA;AAEI,KAPH,eAAA,GAOG,CAAA,QAAA,EAAA,MAAA,EAAA,GAPqC,OAOrC,CAAA,IAAA,CAAA;AACH,iBANI,UAAA,CAMJ,QAAA,EAAA;EAET,OAAA,EAPoB,cAOpB;EAAO,EAAA,EAPiC,SAOjC;UAPoD;WACpD,0BACC;aAEI;UACH;IAET"}

package/dist/services/watch.mjs

@@ -0,0 +1,33 @@
+import { validateSpec } from "./validate/spec-validator.mjs";
+import "./validate/index.mjs";
+import { buildSpec } from "./build.mjs";
+
+//#region src/services/watch.ts
+function watchSpecs(adapters, config, options, overrides) {
+	const { watcher, fs, logger } = adapters;
+	const w = watcher.watch(options);
+	const validateFn = overrides?.validate ?? (async (specPath) => {
+		await validateSpec(specPath, {
+			fs,
+			logger
+		});
+	});
+	const buildFn = overrides?.build ?? (async (specPath) => {
+		await buildSpec(specPath, {
+			fs,
+			logger
+		}, config);
+	});
+	w.on(async (event) => {
+		if (event.type !== "change") return;
+		logger.info("watchSpecs.changed", { path: event.path });
+		if (options.runValidate) await validateFn(event.path);
+		if (options.runBuild) if (options.dryRun) logger.info("[dry-run] watchSpecs skipped build", { path: event.path });
+		else await buildFn(event.path);
+	});
+	return w;
+}
+
+//#endregion
+export { watchSpecs };
+//# sourceMappingURL=watch.mjs.map

package/dist/services/watch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.mjs","names":[],"sources":["../../src/services/watch.ts"],"sourcesContent":["/**\n * Watch service.\n *\n * Provides a reusable watcher that can trigger validate/build on spec changes.\n */\n\nimport type { WorkspaceConfig } from '@contractspec/module.workspace';\nimport type { LoggerAdapter } from '../ports/logger';\nimport type { Watcher, WatcherAdapter, WatchOptions } from '../ports/watcher';\nimport type { FsAdapter } from '../ports/fs';\nimport { buildSpec } from './build';\nimport { validateSpec } from './validate';\n\nexport interface WatchSpecsOptions extends WatchOptions {\n  runValidate?: boolean;\n  runBuild?: boolean;\n  dryRun?: boolean;\n}\n\nexport type WatchBuildFn = (specPath: string) => Promise<void>;\nexport type WatchValidateFn = (specPath: string) => Promise<void>;\n\nexport function watchSpecs(\n  adapters: { watcher: WatcherAdapter; fs: FsAdapter; logger: LoggerAdapter },\n  config: WorkspaceConfig,\n  options: WatchSpecsOptions,\n  overrides?: {\n    validate?: WatchValidateFn;\n    build?: WatchBuildFn;\n  }\n): Watcher {\n  const { watcher, fs, logger } = adapters;\n  const w = watcher.watch(options);\n\n  const validateFn: WatchValidateFn =\n    overrides?.validate ??\n    (async (specPath) => {\n      await validateSpec(specPath, { fs, logger });\n    });\n\n  const buildFn: WatchBuildFn =\n    overrides?.build ??\n    (async (specPath) => {\n      await buildSpec(specPath, { fs, logger }, config);\n    });\n\n  w.on(async (event) => {\n    if (event.type !== 'change') return;\n\n    logger.info('watchSpecs.changed', { path: event.path });\n\n    if (options.runValidate) {\n      await validateFn(event.path);\n    }\n\n    if (options.runBuild) {\n      if (options.dryRun) {\n        logger.info('[dry-run] watchSpecs skipped build', { path: event.path });\n      } else {\n        await buildFn(event.path);\n      }\n    }\n  });\n\n  return w;\n}\n"],"mappings":";;;;;AAsBA,SAAgB,WACd,UACA,QACA,SACA,WAIS;CACT,MAAM,EAAE,SAAS,IAAI,WAAW;CAChC,MAAM,IAAI,QAAQ,MAAM,QAAQ;CAEhC,MAAM,aACJ,WAAW,aACV,OAAO,aAAa;AACnB,QAAM,aAAa,UAAU;GAAE;GAAI;GAAQ,CAAC;;CAGhD,MAAM,UACJ,WAAW,UACV,OAAO,aAAa;AACnB,QAAM,UAAU,UAAU;GAAE;GAAI;GAAQ,EAAE,OAAO;;AAGrD,GAAE,GAAG,OAAO,UAAU;AACpB,MAAI,MAAM,SAAS,SAAU;AAE7B,SAAO,KAAK,sBAAsB,EAAE,MAAM,MAAM,MAAM,CAAC;AAEvD,MAAI,QAAQ,YACV,OAAM,WAAW,MAAM,KAAK;AAG9B,MAAI,QAAQ,SACV,KAAI,QAAQ,OACV,QAAO,KAAK,sCAAsC,EAAE,MAAM,MAAM,MAAM,CAAC;MAEvE,OAAM,QAAQ,MAAM,KAAK;GAG7B;AAEF,QAAO"}

package/dist/services/workspace-info.d.mts

@@ -0,0 +1,62 @@
+import { FsAdapter } from "../ports/fs.mjs";
+import { PackageManager, WorkspaceInfo, detectPackageManager, findPackageRoot, findWorkspaceRoot, getWorkspaceInfo } from "../adapters/workspace.mjs";
+
+//#region src/services/workspace-info.d.ts
+
+/**
+ * Monorepo configuration options.
+ */
+interface MonorepoConfig {
+  /**
+   * Package patterns to include (glob).
+   */
+  packages?: string[];
+  /**
+   * Package patterns to exclude (glob).
+   */
+  excludePackages?: string[];
+  /**
+   * Whether to search recursively in all packages.
+   */
+  recursive?: boolean;
+}
+/**
+ * Extended workspace info with configuration.
+ */
+interface ExtendedWorkspaceInfo extends WorkspaceInfo {
+  /**
+   * Monorepo-specific configuration.
+   */
+  monorepoConfig?: MonorepoConfig;
+  /**
+   * Path to workspace .contractsrc.json (if exists).
+   */
+  workspaceConfigPath?: string;
+  /**
+   * Path to package .contractsrc.json (if exists).
+   */
+  packageConfigPath?: string;
+}
+/**
+ * Get extended workspace information including config paths.
+ */
+declare function getExtendedWorkspaceInfo(fs: FsAdapter, startDir?: string): Promise<ExtendedWorkspaceInfo>;
+/**
+ * Find all .contractsrc.json files in a monorepo.
+ *
+ * Returns paths in order of priority (workspace first, then packages).
+ */
+declare function findAllConfigFiles(fs: FsAdapter, workspaceRoot: string): Promise<string[]>;
+/**
+ * Merge workspace and package configurations.
+ *
+ * Package config overrides workspace config.
+ */
+declare function mergeMonorepoConfigs(fs: FsAdapter, workspaceConfigPath: string | undefined, packageConfigPath: string | undefined): Promise<Record<string, unknown>>;
+/**
+ * Format workspace info for display.
+ */
+declare function formatWorkspaceInfo(info: ExtendedWorkspaceInfo): string;
+//#endregion
+export { ExtendedWorkspaceInfo, MonorepoConfig, findAllConfigFiles, formatWorkspaceInfo, getExtendedWorkspaceInfo, mergeMonorepoConfigs };
+//# sourceMappingURL=workspace-info.d.mts.map

package/dist/services/workspace-info.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-info.d.mts","names":[],"sources":["../../src/services/workspace-info.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA+GsB,UA3FL,cAAA,CA2FuB;EAgClB;;;EAInB,QAAA,CAAA,EAAA,MAAA,EAAA;EAAO;AAiEV;;;;;;;;;;;UA5KiB,qBAAA,SAA8B;;;;mBAI5B;;;;;;;;;;;;;iBAgBG,wBAAA,KAChB,+BAEH,QAAQ;;;;;;iBAgDW,kBAAA,KAChB,mCAEH;;;;;;iBA6BmB,oBAAA,KAChB,4FAGH,QAAQ;;;;iBAiEK,mBAAA,OAA0B"}

package/dist/services/workspace-info.mjs

@@ -0,0 +1,103 @@
+import { detectPackageManager, findPackageRoot, findWorkspaceRoot, getWorkspaceInfo } from "../adapters/workspace.mjs";
+
+//#region src/services/workspace-info.ts
+/**
+* Workspace info service.
+*
+* Provides workspace detection and configuration loading
+* with support for monorepos.
+*/
+/**
+* Get extended workspace information including config paths.
+*/
+async function getExtendedWorkspaceInfo(fs, startDir) {
+	const baseInfo = getWorkspaceInfo(startDir);
+	const workspaceConfigPath = fs.join(baseInfo.workspaceRoot, ".contractsrc.json");
+	const packageConfigPath = fs.join(baseInfo.packageRoot, ".contractsrc.json");
+	const hasWorkspaceConfig = await fs.exists(workspaceConfigPath);
+	const hasPackageConfig = baseInfo.workspaceRoot !== baseInfo.packageRoot ? await fs.exists(packageConfigPath) : false;
+	let monorepoConfig;
+	if (hasWorkspaceConfig) try {
+		const content = await fs.readFile(workspaceConfigPath);
+		const config = JSON.parse(content);
+		if (config.packages || config.excludePackages || config.recursive) monorepoConfig = {
+			packages: config.packages,
+			excludePackages: config.excludePackages,
+			recursive: config.recursive
+		};
+	} catch {}
+	return {
+		...baseInfo,
+		monorepoConfig,
+		workspaceConfigPath: hasWorkspaceConfig ? workspaceConfigPath : void 0,
+		packageConfigPath: hasPackageConfig ? packageConfigPath : void 0
+	};
+}
+/**
+* Find all .contractsrc.json files in a monorepo.
+*
+* Returns paths in order of priority (workspace first, then packages).
+*/
+async function findAllConfigFiles(fs, workspaceRoot) {
+	const configFiles = [];
+	const rootConfig = fs.join(workspaceRoot, ".contractsrc.json");
+	if (await fs.exists(rootConfig)) configFiles.push(rootConfig);
+	const packageConfigs = await fs.glob({
+		pattern: "**/.contractsrc.json",
+		ignore: ["node_modules/**", ".git/**"]
+	});
+	for (const config of packageConfigs) if (config !== rootConfig) configFiles.push(config);
+	return configFiles;
+}
+/**
+* Merge workspace and package configurations.
+*
+* Package config overrides workspace config.
+*/
+async function mergeMonorepoConfigs(fs, workspaceConfigPath, packageConfigPath) {
+	let merged = {};
+	if (workspaceConfigPath && await fs.exists(workspaceConfigPath)) try {
+		const content = await fs.readFile(workspaceConfigPath);
+		merged = JSON.parse(content);
+	} catch {}
+	if (packageConfigPath && await fs.exists(packageConfigPath)) try {
+		const content = await fs.readFile(packageConfigPath);
+		const packageConfig = JSON.parse(content);
+		merged = deepMerge(merged, packageConfig);
+	} catch {}
+	return merged;
+}
+/**
+* Deep merge two objects.
+*/
+function deepMerge(base, override) {
+	const result = { ...base };
+	for (const key of Object.keys(override)) {
+		const baseValue = base[key];
+		const overrideValue = override[key];
+		if (typeof baseValue === "object" && baseValue !== null && !Array.isArray(baseValue) && typeof overrideValue === "object" && overrideValue !== null && !Array.isArray(overrideValue)) result[key] = deepMerge(baseValue, overrideValue);
+		else result[key] = overrideValue;
+	}
+	return result;
+}
+/**
+* Format workspace info for display.
+*/
+function formatWorkspaceInfo(info) {
+	const lines = [];
+	lines.push(`Package Manager: ${info.packageManager}`);
+	lines.push(`Workspace Root: ${info.workspaceRoot}`);
+	if (info.isMonorepo) {
+		lines.push(`Monorepo: Yes`);
+		lines.push(`Package Root: ${info.packageRoot}`);
+		if (info.packageName) lines.push(`Current Package: ${info.packageName}`);
+		if (info.packages && info.packages.length > 0) lines.push(`Package Patterns: ${info.packages.join(", ")}`);
+	} else lines.push(`Monorepo: No`);
+	if (info.workspaceConfigPath) lines.push(`Workspace Config: ${info.workspaceConfigPath}`);
+	if (info.packageConfigPath) lines.push(`Package Config: ${info.packageConfigPath}`);
+	return lines.join("\n");
+}
+
+//#endregion
+export { findAllConfigFiles, formatWorkspaceInfo, getExtendedWorkspaceInfo, mergeMonorepoConfigs };
+//# sourceMappingURL=workspace-info.mjs.map

package/dist/services/workspace-info.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-info.mjs","names":[],"sources":["../../src/services/workspace-info.ts"],"sourcesContent":["/**\n * Workspace info service.\n *\n * Provides workspace detection and configuration loading\n * with support for monorepos.\n */\n\nimport {\n  getWorkspaceInfo,\n  findWorkspaceRoot,\n  findPackageRoot,\n  detectPackageManager,\n  type WorkspaceInfo,\n  type PackageManager,\n} from '../adapters/workspace';\nimport type { FsAdapter } from '../ports/fs';\n\n/**\n * Monorepo configuration options.\n */\nexport interface MonorepoConfig {\n  /**\n   * Package patterns to include (glob).\n   */\n  packages?: string[];\n\n  /**\n   * Package patterns to exclude (glob).\n   */\n  excludePackages?: string[];\n\n  /**\n   * Whether to search recursively in all packages.\n   */\n  recursive?: boolean;\n}\n\n/**\n * Extended workspace info with configuration.\n */\nexport interface ExtendedWorkspaceInfo extends WorkspaceInfo {\n  /**\n   * Monorepo-specific configuration.\n   */\n  monorepoConfig?: MonorepoConfig;\n\n  /**\n   * Path to workspace .contractsrc.json (if exists).\n   */\n  workspaceConfigPath?: string;\n\n  /**\n   * Path to package .contractsrc.json (if exists).\n   */\n  packageConfigPath?: string;\n}\n\n/**\n * Get extended workspace information including config paths.\n */\nexport async function getExtendedWorkspaceInfo(\n  fs: FsAdapter,\n  startDir?: string\n): Promise<ExtendedWorkspaceInfo> {\n  const baseInfo = getWorkspaceInfo(startDir);\n\n  // Check for config files\n  const workspaceConfigPath = fs.join(\n    baseInfo.workspaceRoot,\n    '.contractsrc.json'\n  );\n  const packageConfigPath = fs.join(baseInfo.packageRoot, '.contractsrc.json');\n\n  const hasWorkspaceConfig = await fs.exists(workspaceConfigPath);\n  const hasPackageConfig =\n    baseInfo.workspaceRoot !== baseInfo.packageRoot\n      ? await fs.exists(packageConfigPath)\n      : false;\n\n  // Load monorepo config from workspace config if exists\n  let monorepoConfig: MonorepoConfig | undefined;\n\n  if (hasWorkspaceConfig) {\n    try {\n      const content = await fs.readFile(workspaceConfigPath);\n      const config = JSON.parse(content);\n      if (config.packages || config.excludePackages || config.recursive) {\n        monorepoConfig = {\n          packages: config.packages,\n          excludePackages: config.excludePackages,\n          recursive: config.recursive,\n        };\n      }\n    } catch {\n      // Ignore parse errors\n    }\n  }\n\n  return {\n    ...baseInfo,\n    monorepoConfig,\n    workspaceConfigPath: hasWorkspaceConfig ? workspaceConfigPath : undefined,\n    packageConfigPath: hasPackageConfig ? packageConfigPath : undefined,\n  };\n}\n\n/**\n * Find all .contractsrc.json files in a monorepo.\n *\n * Returns paths in order of priority (workspace first, then packages).\n */\nexport async function findAllConfigFiles(\n  fs: FsAdapter,\n  workspaceRoot: string\n): Promise<string[]> {\n  const configFiles: string[] = [];\n\n  // Workspace root config (highest priority for defaults)\n  const rootConfig = fs.join(workspaceRoot, '.contractsrc.json');\n  if (await fs.exists(rootConfig)) {\n    configFiles.push(rootConfig);\n  }\n\n  // Find configs in packages\n  const packageConfigs = await fs.glob({\n    pattern: '**/.contractsrc.json',\n    ignore: ['node_modules/**', '.git/**'],\n  });\n\n  for (const config of packageConfigs) {\n    if (config !== rootConfig) {\n      configFiles.push(config);\n    }\n  }\n\n  return configFiles;\n}\n\n/**\n * Merge workspace and package configurations.\n *\n * Package config overrides workspace config.\n */\nexport async function mergeMonorepoConfigs(\n  fs: FsAdapter,\n  workspaceConfigPath: string | undefined,\n  packageConfigPath: string | undefined\n): Promise<Record<string, unknown>> {\n  let merged: Record<string, unknown> = {};\n\n  // Load workspace config as base\n  if (workspaceConfigPath && (await fs.exists(workspaceConfigPath))) {\n    try {\n      const content = await fs.readFile(workspaceConfigPath);\n      merged = JSON.parse(content);\n    } catch {\n      // Ignore parse errors\n    }\n  }\n\n  // Overlay package config\n  if (packageConfigPath && (await fs.exists(packageConfigPath))) {\n    try {\n      const content = await fs.readFile(packageConfigPath);\n      const packageConfig = JSON.parse(content);\n\n      // Deep merge (package overrides workspace)\n      merged = deepMerge(merged, packageConfig);\n    } catch {\n      // Ignore parse errors\n    }\n  }\n\n  return merged;\n}\n\n/**\n * Deep merge two objects.\n */\nfunction deepMerge(\n  base: Record<string, unknown>,\n  override: Record<string, unknown>\n): Record<string, unknown> {\n  const result = { ...base };\n\n  for (const key of Object.keys(override)) {\n    const baseValue = base[key];\n    const overrideValue = override[key];\n\n    if (\n      typeof baseValue === 'object' &&\n      baseValue !== null &&\n      !Array.isArray(baseValue) &&\n      typeof overrideValue === 'object' &&\n      overrideValue !== null &&\n      !Array.isArray(overrideValue)\n    ) {\n      result[key] = deepMerge(\n        baseValue as Record<string, unknown>,\n        overrideValue as Record<string, unknown>\n      );\n    } else {\n      result[key] = overrideValue;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Format workspace info for display.\n */\nexport function formatWorkspaceInfo(info: ExtendedWorkspaceInfo): string {\n  const lines: string[] = [];\n\n  lines.push(`Package Manager: ${info.packageManager}`);\n  lines.push(`Workspace Root: ${info.workspaceRoot}`);\n\n  if (info.isMonorepo) {\n    lines.push(`Monorepo: Yes`);\n    lines.push(`Package Root: ${info.packageRoot}`);\n\n    if (info.packageName) {\n      lines.push(`Current Package: ${info.packageName}`);\n    }\n\n    if (info.packages && info.packages.length > 0) {\n      lines.push(`Package Patterns: ${info.packages.join(', ')}`);\n    }\n  } else {\n    lines.push(`Monorepo: No`);\n  }\n\n  if (info.workspaceConfigPath) {\n    lines.push(`Workspace Config: ${info.workspaceConfigPath}`);\n  }\n\n  if (info.packageConfigPath) {\n    lines.push(`Package Config: ${info.packageConfigPath}`);\n  }\n\n  return lines.join('\\n');\n}\n\n// Re-export types and utilities\nexport {\n  getWorkspaceInfo,\n  findWorkspaceRoot,\n  findPackageRoot,\n  detectPackageManager,\n  type WorkspaceInfo,\n  type PackageManager,\n};\n"],"mappings":";;;;;;;;;;;;AA4DA,eAAsB,yBACpB,IACA,UACgC;CAChC,MAAM,WAAW,iBAAiB,SAAS;CAG3C,MAAM,sBAAsB,GAAG,KAC7B,SAAS,eACT,oBACD;CACD,MAAM,oBAAoB,GAAG,KAAK,SAAS,aAAa,oBAAoB;CAE5E,MAAM,qBAAqB,MAAM,GAAG,OAAO,oBAAoB;CAC/D,MAAM,mBACJ,SAAS,kBAAkB,SAAS,cAChC,MAAM,GAAG,OAAO,kBAAkB,GAClC;CAGN,IAAI;AAEJ,KAAI,mBACF,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,oBAAoB;EACtD,MAAM,SAAS,KAAK,MAAM,QAAQ;AAClC,MAAI,OAAO,YAAY,OAAO,mBAAmB,OAAO,UACtD,kBAAiB;GACf,UAAU,OAAO;GACjB,iBAAiB,OAAO;GACxB,WAAW,OAAO;GACnB;SAEG;AAKV,QAAO;EACL,GAAG;EACH;EACA,qBAAqB,qBAAqB,sBAAsB;EAChE,mBAAmB,mBAAmB,oBAAoB;EAC3D;;;;;;;AAQH,eAAsB,mBACpB,IACA,eACmB;CACnB,MAAM,cAAwB,EAAE;CAGhC,MAAM,aAAa,GAAG,KAAK,eAAe,oBAAoB;AAC9D,KAAI,MAAM,GAAG,OAAO,WAAW,CAC7B,aAAY,KAAK,WAAW;CAI9B,MAAM,iBAAiB,MAAM,GAAG,KAAK;EACnC,SAAS;EACT,QAAQ,CAAC,mBAAmB,UAAU;EACvC,CAAC;AAEF,MAAK,MAAM,UAAU,eACnB,KAAI,WAAW,WACb,aAAY,KAAK,OAAO;AAI5B,QAAO;;;;;;;AAQT,eAAsB,qBACpB,IACA,qBACA,mBACkC;CAClC,IAAI,SAAkC,EAAE;AAGxC,KAAI,uBAAwB,MAAM,GAAG,OAAO,oBAAoB,CAC9D,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,oBAAoB;AACtD,WAAS,KAAK,MAAM,QAAQ;SACtB;AAMV,KAAI,qBAAsB,MAAM,GAAG,OAAO,kBAAkB,CAC1D,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,kBAAkB;EACpD,MAAM,gBAAgB,KAAK,MAAM,QAAQ;AAGzC,WAAS,UAAU,QAAQ,cAAc;SACnC;AAKV,QAAO;;;;;AAMT,SAAS,UACP,MACA,UACyB;CACzB,MAAM,SAAS,EAAE,GAAG,MAAM;AAE1B,MAAK,MAAM,OAAO,OAAO,KAAK,SAAS,EAAE;EACvC,MAAM,YAAY,KAAK;EACvB,MAAM,gBAAgB,SAAS;AAE/B,MACE,OAAO,cAAc,YACrB,cAAc,QACd,CAAC,MAAM,QAAQ,UAAU,IACzB,OAAO,kBAAkB,YACzB,kBAAkB,QAClB,CAAC,MAAM,QAAQ,cAAc,CAE7B,QAAO,OAAO,UACZ,WACA,cACD;MAED,QAAO,OAAO;;AAIlB,QAAO;;;;;AAMT,SAAgB,oBAAoB,MAAqC;CACvE,MAAM,QAAkB,EAAE;AAE1B,OAAM,KAAK,oBAAoB,KAAK,iBAAiB;AACrD,OAAM,KAAK,mBAAmB,KAAK,gBAAgB;AAEnD,KAAI,KAAK,YAAY;AACnB,QAAM,KAAK,gBAAgB;AAC3B,QAAM,KAAK,iBAAiB,KAAK,cAAc;AAE/C,MAAI,KAAK,YACP,OAAM,KAAK,oBAAoB,KAAK,cAAc;AAGpD,MAAI,KAAK,YAAY,KAAK,SAAS,SAAS,EAC1C,OAAM,KAAK,qBAAqB,KAAK,SAAS,KAAK,KAAK,GAAG;OAG7D,OAAM,KAAK,eAAe;AAG5B,KAAI,KAAK,oBACP,OAAM,KAAK,qBAAqB,KAAK,sBAAsB;AAG7D,KAAI,KAAK,kBACP,OAAM,KAAK,mBAAmB,KAAK,oBAAoB;AAGzD,QAAO,MAAM,KAAK,KAAK"}

package/dist/templates/app-config.template.d.mts

@@ -0,0 +1,7 @@
+import { AppBlueprintSpecData } from "../types.mjs";
+
+//#region src/templates/app-config.template.d.ts
+declare function generateAppBlueprintSpec(data: AppBlueprintSpecData): string;
+//#endregion
+export { generateAppBlueprintSpec };
+//# sourceMappingURL=app-config.template.d.mts.map

package/dist/templates/app-config.template.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.template.d.mts","names":[],"sources":["../../src/templates/app-config.template.ts"],"sourcesContent":[],"mappings":";;;iBAEgB,wBAAA,OAA+B"}