@contractspec/bundle.workspace 0.0.0-canary-20260113162409

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# @contractspec/bundle.workspace
+
+Website: https://contractspec.io/
+
+
+Reusable use-cases and services for ContractSpec workspace operations.
+
+## Purpose
+
+This bundle provides platform-agnostic services that can be used by:
+
+- CLI tools (`@contractspec/app.cli-contractspec`)
+- Web applications
+- VS Code extensions
+- API servers
+
+## Architecture
+
+```
+bundle.contractspec-workspace
+├── services/          # Use-case implementations
+│   ├── build.ts       # Build deterministic artifacts from specs (templates-first)
+│   ├── validate.ts    # Validate spec structure (and, later, implementation checks)
+│   ├── diff.ts        # Compare specs (semantic diff)
+│   ├── deps.ts        # Analyze dependencies
+│   ├── list.ts        # Discover specs by glob
+│   └── config.ts      # Load + merge workspace config (.contractsrc.json)
+│   ├── sync.ts        # Sync all specs (validate/build across a workspace)
+│   ├── watch.ts       # Watch specs and trigger validate/build
+│   ├── clean.ts       # Safe-by-default cleanup of generated artifacts
+│   ├── test.ts        # Run TestSpec scenarios (pure runner wrapper)
+│   ├── regenerator.ts # Regenerator service wrapper (no module loading)
+│   ├── integrity.ts   # Analyze spec/feature integrity and coverage
+│   ├── layer-discovery.ts # Discover features, examples, app-configs
+│   ├── doctor/        # Health checks and auto-fixes
+│   └── ci-check/      # CI/CD validation checks
+├── adapters/          # Runtime adapters (Node defaults)
+│   ├── fs.ts          # Filesystem operations
+│   ├── git.ts         # Git operations
+│   ├── watcher.ts     # File watching
+│   ├── ai.ts          # AI providers
+│   └── logger.ts      # Logging/progress
+└── ports/             # Adapter interfaces
+    └── index.ts       # Port type definitions
+```
+
+## Design Principles
+
+- **Adapter pattern**: All I/O goes through explicit ports/adapters
+- **Testable**: Services can be tested with mock adapters
+- **Reusable**: Same services work across CLI, web, and extensions
+- **No CLI dependencies**: No `chalk`, `ora`, `commander`, or `inquirer`
+
+## Usage
+
+```typescript
+import {
+  createNodeAdapters,
+  loadWorkspaceConfig,
+  buildSpec,
+} from '@contractspec/bundle.workspace';
+
+// Create adapters for Node.js runtime
+const adapters = createNodeAdapters();
+
+// Load workspace config (or use defaults)
+const config = await loadWorkspaceConfig(adapters.fs);
+
+// Build deterministic artifacts from a spec (templates-first)
+const result = await buildSpec(
+  './my-spec.operation.ts',
+  { fs: adapters.fs, logger: adapters.logger },
+  config
+);
+```
+
+## Notes
+
+- `sync` / `watch` accept optional overrides so CLI (or an extension) can inject
+  richer build/validate behavior while reusing the deterministic orchestration.
+- `test` and `regenerator` deliberately avoid TypeScript module loading; callers
+  pass already-loaded specs/contexts/rules/sinks.
+

package/dist/_virtual/rolldown_runtime.mjs

@@ -0,0 +1,20 @@
+import { createRequire } from "node:module";
+
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __exportAll = (all, symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll };

package/dist/adapters/ai.d.mts

@@ -0,0 +1,12 @@
+import { AiAdapter } from "../ports/ai.mjs";
+import { WorkspaceConfig } from "@contractspec/module.workspace";
+
+//#region src/adapters/ai.d.ts
+
+/**
+ * Create a Node.js AI adapter using Vercel AI SDK.
+ */
+declare function createNodeAiAdapter(config: WorkspaceConfig): AiAdapter;
+//#endregion
+export { createNodeAiAdapter };
+//# sourceMappingURL=ai.d.mts.map

package/dist/adapters/ai.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.mts","names":[],"sources":["../../src/adapters/ai.ts"],"sourcesContent":[],"mappings":";;;;;;;;iBAqBgB,mBAAA,SAA4B,kBAAkB"}

package/dist/adapters/ai.mjs

@@ -0,0 +1,83 @@
+import { anthropic } from "@ai-sdk/anthropic";
+import { openai } from "@ai-sdk/openai";
+import { ollama } from "ollama-ai-provider";
+import { generateObject, generateText, streamText } from "ai";
+
+//#region src/adapters/ai.ts
+/**
+* Node.js AI adapter implementation using Vercel AI SDK.
+*/
+/**
+* Create a Node.js AI adapter using Vercel AI SDK.
+*/
+function createNodeAiAdapter(config) {
+	return {
+		async validateProvider(providerConfig) {
+			try {
+				const { aiProvider } = providerConfig;
+				if (aiProvider === "ollama") return { success: true };
+				if (aiProvider === "claude" && !process.env["ANTHROPIC_API_KEY"]) return {
+					success: false,
+					error: "ANTHROPIC_API_KEY environment variable not set"
+				};
+				if (aiProvider === "openai" && !process.env["OPENAI_API_KEY"]) return {
+					success: false,
+					error: "OPENAI_API_KEY environment variable not set"
+				};
+				return { success: true };
+			} catch (error) {
+				return {
+					success: false,
+					error: error instanceof Error ? error.message : String(error)
+				};
+			}
+		},
+		async generateText(options) {
+			return { text: (await generateText({
+				model: getAIProvider(config),
+				prompt: options.prompt,
+				system: options.systemPrompt
+			})).text };
+		},
+		async generateStructured(options) {
+			return { object: (await generateObject({
+				model: getAIProvider(config),
+				schema: options.schema,
+				prompt: options.prompt,
+				system: options.systemPrompt
+			})).object };
+		},
+		async streamText(options, onChunk) {
+			const result = await streamText({
+				model: getAIProvider(config),
+				prompt: options.prompt,
+				system: options.systemPrompt
+			});
+			let fullText = "";
+			for await (const chunk of result.textStream) {
+				fullText += chunk;
+				onChunk(chunk);
+			}
+			return fullText;
+		}
+	};
+}
+/**
+* Get AI provider based on configuration.
+*/
+function getAIProvider(config) {
+	const { aiProvider, aiModel, customEndpoint } = config;
+	switch (aiProvider) {
+		case "claude": return anthropic(aiModel ?? "claude-3-5-sonnet-20241022");
+		case "openai": return openai(aiModel ?? "gpt-4o");
+		case "ollama": return ollama(aiModel ?? "codellama");
+		case "custom":
+			if (!customEndpoint) throw new Error("Custom endpoint required. Set customEndpoint in config or CONTRACTSPEC_LLM_ENDPOINT env var");
+			return openai(aiModel ?? "default");
+		default: throw new Error(`Unknown AI provider: ${aiProvider}`);
+	}
+}
+
+//#endregion
+export { createNodeAiAdapter };
+//# sourceMappingURL=ai.mjs.map

package/dist/adapters/ai.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.mjs","names":[],"sources":["../../src/adapters/ai.ts"],"sourcesContent":["/**\n * Node.js AI adapter implementation using Vercel AI SDK.\n */\n\nimport { anthropic } from '@ai-sdk/anthropic';\nimport { openai } from '@ai-sdk/openai';\nimport { ollama } from 'ollama-ai-provider';\nimport type { LanguageModel } from 'ai';\nimport { generateObject, generateText, streamText } from 'ai';\nimport type { WorkspaceConfig } from '@contractspec/module.workspace';\nimport type {\n  AiAdapter,\n  AiGenerateOptions,\n  AiGenerateResult,\n  AiGenerateStructuredOptions,\n  AiValidationResult,\n} from '../ports/ai';\n\n/**\n * Create a Node.js AI adapter using Vercel AI SDK.\n */\nexport function createNodeAiAdapter(config: WorkspaceConfig): AiAdapter {\n  return {\n    async validateProvider(\n      providerConfig: WorkspaceConfig\n    ): Promise<AiValidationResult> {\n      try {\n        const { aiProvider } = providerConfig;\n\n        // For Ollama, we can't easily validate without making a request\n        if (aiProvider === 'ollama') {\n          return { success: true };\n        }\n\n        // For cloud providers, check API key exists\n        if (aiProvider === 'claude' && !process.env['ANTHROPIC_API_KEY']) {\n          return {\n            success: false,\n            error: 'ANTHROPIC_API_KEY environment variable not set',\n          };\n        }\n\n        if (aiProvider === 'openai' && !process.env['OPENAI_API_KEY']) {\n          return {\n            success: false,\n            error: 'OPENAI_API_KEY environment variable not set',\n          };\n        }\n\n        return { success: true };\n      } catch (error) {\n        return {\n          success: false,\n          error: error instanceof Error ? error.message : String(error),\n        };\n      }\n    },\n\n    async generateText(options: AiGenerateOptions): Promise<AiGenerateResult> {\n      const model = getAIProvider(config);\n\n      const result = await generateText({\n        model,\n        prompt: options.prompt,\n        system: options.systemPrompt,\n      });\n\n      return { text: result.text };\n    },\n\n    async generateStructured<T>(\n      options: AiGenerateStructuredOptions<T>\n    ): Promise<{ object: T }> {\n      const model = getAIProvider(config);\n\n      // Use generateObject with schema cast to expected type\n      const generateObjectOptions = {\n        model,\n        schema: options.schema,\n        prompt: options.prompt,\n        system: options.systemPrompt,\n      };\n\n      const result = await generateObject(\n        generateObjectOptions as Parameters<typeof generateObject>[0]\n      );\n\n      return { object: result.object as T };\n    },\n\n    async streamText(\n      options: AiGenerateOptions,\n      onChunk: (text: string) => void\n    ): Promise<string> {\n      const model = getAIProvider(config);\n\n      const result = await streamText({\n        model,\n        prompt: options.prompt,\n        system: options.systemPrompt,\n      });\n\n      let fullText = '';\n\n      for await (const chunk of result.textStream) {\n        fullText += chunk;\n        onChunk(chunk);\n      }\n\n      return fullText;\n    },\n  };\n}\n\n/**\n * Get AI provider based on configuration.\n */\nfunction getAIProvider(config: WorkspaceConfig): LanguageModel {\n  const { aiProvider, aiModel, customEndpoint } = config;\n\n  switch (aiProvider) {\n    case 'claude': {\n      const model = aiModel ?? 'claude-3-5-sonnet-20241022';\n      return anthropic(model);\n    }\n\n    case 'openai': {\n      const model = aiModel ?? 'gpt-4o';\n      return openai(model);\n    }\n\n    case 'ollama': {\n      const model = aiModel ?? 'codellama';\n      // ollama-ai-provider returns LanguageModelV1, wrap it to satisfy LanguageModel interface\n      const ollamaModel = ollama(model);\n      // Return as unknown then LanguageModel to bypass strict type checking\n      // This is safe because ollama models are compatible at runtime\n      return ollamaModel as unknown as LanguageModel;\n    }\n\n    case 'custom': {\n      if (!customEndpoint) {\n        throw new Error(\n          'Custom endpoint required. Set customEndpoint in config or CONTRACTSPEC_LLM_ENDPOINT env var'\n        );\n      }\n\n      const model = aiModel ?? 'default';\n      // For custom endpoints, use openai with environment variable for baseURL\n      return openai(model);\n    }\n\n    default:\n      throw new Error(`Unknown AI provider: ${aiProvider}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAqBA,SAAgB,oBAAoB,QAAoC;AACtE,QAAO;EACL,MAAM,iBACJ,gBAC6B;AAC7B,OAAI;IACF,MAAM,EAAE,eAAe;AAGvB,QAAI,eAAe,SACjB,QAAO,EAAE,SAAS,MAAM;AAI1B,QAAI,eAAe,YAAY,CAAC,QAAQ,IAAI,qBAC1C,QAAO;KACL,SAAS;KACT,OAAO;KACR;AAGH,QAAI,eAAe,YAAY,CAAC,QAAQ,IAAI,kBAC1C,QAAO;KACL,SAAS;KACT,OAAO;KACR;AAGH,WAAO,EAAE,SAAS,MAAM;YACjB,OAAO;AACd,WAAO;KACL,SAAS;KACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;KAC9D;;;EAIL,MAAM,aAAa,SAAuD;AASxE,UAAO,EAAE,OANM,MAAM,aAAa;IAChC,OAHY,cAAc,OAAO;IAIjC,QAAQ,QAAQ;IAChB,QAAQ,QAAQ;IACjB,CAAC,EAEoB,MAAM;;EAG9B,MAAM,mBACJ,SACwB;AAexB,UAAO,EAAE,SAJM,MAAM,eAPS;IAC5B,OAJY,cAAc,OAAO;IAKjC,QAAQ,QAAQ;IAChB,QAAQ,QAAQ;IAChB,QAAQ,QAAQ;IACjB,CAIA,EAEuB,QAAa;;EAGvC,MAAM,WACJ,SACA,SACiB;GAGjB,MAAM,SAAS,MAAM,WAAW;IAC9B,OAHY,cAAc,OAAO;IAIjC,QAAQ,QAAQ;IAChB,QAAQ,QAAQ;IACjB,CAAC;GAEF,IAAI,WAAW;AAEf,cAAW,MAAM,SAAS,OAAO,YAAY;AAC3C,gBAAY;AACZ,YAAQ,MAAM;;AAGhB,UAAO;;EAEV;;;;;AAMH,SAAS,cAAc,QAAwC;CAC7D,MAAM,EAAE,YAAY,SAAS,mBAAmB;AAEhD,SAAQ,YAAR;EACE,KAAK,SAEH,QAAO,UADO,WAAW,6BACF;EAGzB,KAAK,SAEH,QAAO,OADO,WAAW,SACL;EAGtB,KAAK,SAMH,QAHoB,OAFN,WAAW,YAEQ;EAMnC,KAAK;AACH,OAAI,CAAC,eACH,OAAM,IAAI,MACR,8FACD;AAKH,UAAO,OAFO,WAAW,UAEL;EAGtB,QACE,OAAM,IAAI,MAAM,wBAAwB,aAAa"}

package/dist/adapters/factory.d.mts

@@ -0,0 +1,29 @@
+import { WorkspaceAdapters } from "../ports/logger.mjs";
+import { WorkspaceConfig } from "@contractspec/module.workspace";
+
+//#region src/adapters/factory.d.ts
+
+/**
+ * Options for creating adapters.
+ */
+interface CreateAdaptersOptions {
+  /**
+   * Working directory for file operations.
+   */
+  cwd?: string;
+  /**
+   * Workspace configuration for AI.
+   */
+  config?: WorkspaceConfig;
+  /**
+   * Use no-op logger (for testing).
+   */
+  silent?: boolean;
+}
+/**
+ * Create all Node.js adapters with default configuration.
+ */
+declare function createNodeAdapters(options?: CreateAdaptersOptions): WorkspaceAdapters;
+//#endregion
+export { CreateAdaptersOptions, createNodeAdapters };
+//# sourceMappingURL=factory.d.mts.map

package/dist/adapters/factory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.mts","names":[],"sources":["../../src/adapters/factory.ts"],"sourcesContent":[],"mappings":";;;;;AAmCA;;;UApBiB,qBAAA;;;;;;;;WASN;;;;;;;;;iBAWK,kBAAA,WACL,wBACR"}

package/dist/adapters/factory.mjs

@@ -0,0 +1,37 @@
+import { createNodeFsAdapter } from "./fs.mjs";
+import { createNodeGitAdapter } from "./git.mjs";
+import { createNodeWatcherAdapter } from "./watcher.mjs";
+import { createNodeAiAdapter } from "./ai.mjs";
+import { createConsoleLoggerAdapter, createNoopLoggerAdapter } from "./logger.mjs";
+
+//#region src/adapters/factory.ts
+/**
+* Create all Node.js adapters with default configuration.
+*/
+function createNodeAdapters(options = {}) {
+	const { cwd, config, silent } = options;
+	const workspaceConfig = config ?? {
+		aiProvider: "claude",
+		agentMode: "simple",
+		outputDir: "./src",
+		conventions: {
+			operations: "interactions/commands|queries",
+			events: "events",
+			presentations: "presentations",
+			forms: "forms"
+		},
+		defaultOwners: [],
+		defaultTags: []
+	};
+	return {
+		fs: createNodeFsAdapter(cwd),
+		git: createNodeGitAdapter(cwd),
+		watcher: createNodeWatcherAdapter(cwd),
+		ai: createNodeAiAdapter(workspaceConfig),
+		logger: silent ? createNoopLoggerAdapter() : createConsoleLoggerAdapter()
+	};
+}
+
+//#endregion
+export { createNodeAdapters };
+//# sourceMappingURL=factory.mjs.map

package/dist/adapters/factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.mjs","names":[],"sources":["../../src/adapters/factory.ts"],"sourcesContent":["/**\n * Factory for creating workspace adapters.\n */\n\nimport type { WorkspaceConfig } from '@contractspec/module.workspace';\nimport type { WorkspaceAdapters } from '../ports/logger';\nimport { createNodeFsAdapter } from './fs';\nimport { createNodeGitAdapter } from './git';\nimport { createNodeWatcherAdapter } from './watcher';\nimport { createNodeAiAdapter } from './ai';\nimport { createConsoleLoggerAdapter, createNoopLoggerAdapter } from './logger';\n\n/**\n * Options for creating adapters.\n */\nexport interface CreateAdaptersOptions {\n  /**\n   * Working directory for file operations.\n   */\n  cwd?: string;\n\n  /**\n   * Workspace configuration for AI.\n   */\n  config?: WorkspaceConfig;\n\n  /**\n   * Use no-op logger (for testing).\n   */\n  silent?: boolean;\n}\n\n/**\n * Create all Node.js adapters with default configuration.\n */\nexport function createNodeAdapters(\n  options: CreateAdaptersOptions = {}\n): WorkspaceAdapters {\n  const { cwd, config, silent } = options;\n\n  // Use default config if not provided\n  const workspaceConfig: WorkspaceConfig = config ?? {\n    aiProvider: 'claude',\n    agentMode: 'simple',\n    outputDir: './src',\n    conventions: {\n      operations: 'interactions/commands|queries',\n      events: 'events',\n      presentations: 'presentations',\n      forms: 'forms',\n    },\n    defaultOwners: [],\n    defaultTags: [],\n  };\n\n  return {\n    fs: createNodeFsAdapter(cwd),\n    git: createNodeGitAdapter(cwd),\n    watcher: createNodeWatcherAdapter(cwd),\n    ai: createNodeAiAdapter(workspaceConfig),\n    logger: silent ? createNoopLoggerAdapter() : createConsoleLoggerAdapter(),\n  };\n}\n"],"mappings":";;;;;;;;;;AAmCA,SAAgB,mBACd,UAAiC,EAAE,EAChB;CACnB,MAAM,EAAE,KAAK,QAAQ,WAAW;CAGhC,MAAM,kBAAmC,UAAU;EACjD,YAAY;EACZ,WAAW;EACX,WAAW;EACX,aAAa;GACX,YAAY;GACZ,QAAQ;GACR,eAAe;GACf,OAAO;GACR;EACD,eAAe,EAAE;EACjB,aAAa,EAAE;EAChB;AAED,QAAO;EACL,IAAI,oBAAoB,IAAI;EAC5B,KAAK,qBAAqB,IAAI;EAC9B,SAAS,yBAAyB,IAAI;EACtC,IAAI,oBAAoB,gBAAgB;EACxC,QAAQ,SAAS,yBAAyB,GAAG,4BAA4B;EAC1E"}

package/dist/adapters/fs.d.mts

@@ -0,0 +1,12 @@
+import { FsAdapter } from "../ports/fs.mjs";
+
+//#region src/adapters/fs.d.ts
+
+declare const DEFAULT_SPEC_PATTERNS: string[];
+/**
+ * Create a Node.js filesystem adapter.
+ */
+declare function createNodeFsAdapter(cwd?: string): FsAdapter;
+//#endregion
+export { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter };
+//# sourceMappingURL=fs.d.mts.map

package/dist/adapters/fs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.mts","names":[],"sources":["../../src/adapters/fs.ts"],"sourcesContent":[],"mappings":";;;;AA8EgB,cAvDH,qBAuDsC,EAAA,MAAS,EAAA;;;;iBAA5C,mBAAA,gBAAmC"}

package/dist/adapters/fs.mjs

@@ -0,0 +1,133 @@
+import { access, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { glob } from "glob";
+
+//#region src/adapters/fs.ts
+/**
+* Node.js filesystem adapter implementation.
+*/
+const DEFAULT_SPEC_PATTERNS = [
+	"**/*.operation.ts",
+	"**/*.operations.ts",
+	"**/*.event.ts",
+	"**/*.presentation.ts",
+	"**/*.feature.ts",
+	"**/*.capability.ts",
+	"**/*.workflow.ts",
+	"**/*.data-view.ts",
+	"**/*.form.ts",
+	"**/*.migration.ts",
+	"**/*.telemetry.ts",
+	"**/*.experiment.ts",
+	"**/*.app-config.ts",
+	"**/*.integration.ts",
+	"**/*.knowledge.ts",
+	"**/*.policy.ts",
+	"**/*.test-spec.ts",
+	"**/contracts/*.ts",
+	"**/contracts/index.ts",
+	"**/operations/*.ts",
+	"**/operations/index.ts",
+	"**/operations.ts",
+	"**/events.ts",
+	"**/presentations.ts",
+	"**/events/index.ts",
+	"**/presentations/index.ts",
+	"**/tests/*.ts",
+	"**/tests/*.test-spec.ts"
+];
+const DEFAULT_IGNORES = [
+	"**/node_modules/**",
+	"**/dist/**",
+	"**/.turbo/**",
+	"**/.next/**",
+	"**/build/**",
+	"**/coverage/**",
+	"**/*.d.ts",
+	"**/importer/**",
+	"**/exporter/**",
+	"**/docs/**/*.docblock.ts",
+	"**/docs/presentations.ts"
+];
+/**
+* Create a Node.js filesystem adapter.
+*/
+function createNodeFsAdapter(cwd) {
+	const baseCwd = cwd ?? process.cwd();
+	return {
+		async exists(path$1) {
+			try {
+				await access(resolvePath(path$1));
+				return true;
+			} catch {
+				return false;
+			}
+		},
+		async readFile(path$1) {
+			return readFile(resolvePath(path$1), "utf-8");
+		},
+		async writeFile(path$1, content) {
+			const fullPath = resolvePath(path$1);
+			await mkdir(dirname(fullPath), { recursive: true });
+			await writeFile(fullPath, content, "utf-8");
+		},
+		async remove(path$1) {
+			await rm(resolvePath(path$1), {
+				recursive: true,
+				force: true
+			});
+		},
+		async stat(path$1) {
+			const stats = await stat(resolvePath(path$1));
+			return {
+				size: stats.size,
+				isFile: stats.isFile(),
+				isDirectory: stats.isDirectory(),
+				mtime: stats.mtime
+			};
+		},
+		async mkdir(path$1) {
+			await mkdir(resolvePath(path$1), { recursive: true });
+		},
+		async glob(options) {
+			const patterns = options.patterns ?? (options.pattern ? [options.pattern] : DEFAULT_SPEC_PATTERNS);
+			const ignore = options.ignore ?? DEFAULT_IGNORES;
+			const globCwd = options.cwd ?? baseCwd;
+			const absolute = options.absolute ?? true;
+			const all = [];
+			for (const pattern of patterns) {
+				const matches = await glob(pattern, {
+					cwd: globCwd,
+					ignore,
+					absolute
+				});
+				all.push(...matches);
+			}
+			return Array.from(new Set(all)).sort((a, b) => a.localeCompare(b));
+		},
+		resolve(...paths) {
+			const [first, ...rest] = paths;
+			if (!first) return baseCwd;
+			return resolve(baseCwd, first, ...rest);
+		},
+		dirname(path$1) {
+			return dirname(path$1);
+		},
+		basename(path$1) {
+			return basename(path$1);
+		},
+		join(...paths) {
+			return join(...paths);
+		},
+		relative(from, to) {
+			return relative(from, to);
+		}
+	};
+	function resolvePath(path$1) {
+		return isAbsolute(path$1) ? path$1 : resolve(baseCwd, path$1);
+	}
+}
+
+//#endregion
+export { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter };
+//# sourceMappingURL=fs.mjs.map

package/dist/adapters/fs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.mjs","names":["path","fsStat","globFn"],"sources":["../../src/adapters/fs.ts"],"sourcesContent":["/**\n * Node.js filesystem adapter implementation.\n */\n\nimport {\n  access,\n  mkdir,\n  readFile,\n  rm,\n  stat as fsStat,\n  writeFile,\n} from 'node:fs/promises';\nimport {\n  basename,\n  dirname,\n  isAbsolute,\n  join,\n  relative,\n  resolve,\n} from 'node:path';\nimport { glob as globFn } from 'glob';\nimport type { DiscoverOptions, FileStat, FsAdapter } from '../ports/fs';\n\nexport const DEFAULT_SPEC_PATTERNS = [\n  // Standard dot-prefixed naming convention\n  '**/*.operation.ts',\n  '**/*.operations.ts',\n  '**/*.event.ts',\n  '**/*.presentation.ts',\n  '**/*.feature.ts',\n  '**/*.capability.ts',\n  '**/*.workflow.ts',\n  '**/*.data-view.ts',\n  '**/*.form.ts',\n  '**/*.migration.ts',\n  '**/*.telemetry.ts',\n  '**/*.experiment.ts',\n  '**/*.app-config.ts',\n  '**/*.integration.ts',\n  '**/*.knowledge.ts',\n  '**/*.policy.ts',\n  '**/*.test-spec.ts',\n  // Directory-based patterns (contracts/ and operations/ directories)\n  '**/contracts/*.ts',\n  '**/contracts/index.ts',\n  '**/operations/*.ts',\n  '**/operations/index.ts',\n  // Standalone file patterns (events.ts, presentations.ts)\n  '**/operations.ts',\n  '**/events.ts',\n  '**/presentations.ts',\n  // Directory index patterns (/events/index.ts, /presentations/index.ts)\n  '**/events/index.ts',\n  '**/presentations/index.ts',\n  // Test specs in tests directory\n  '**/tests/*.ts',\n  '**/tests/*.test-spec.ts',\n];\n\nconst DEFAULT_IGNORES = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/.turbo/**',\n  '**/.next/**',\n  '**/build/**',\n  '**/coverage/**',\n  '**/*.d.ts',\n  // Code generators and transformers (not actual specs)\n  '**/importer/**',\n  '**/exporter/**',\n  // Documentation blocks (treated separately)\n  '**/docs/**/*.docblock.ts',\n  '**/docs/presentations.ts',\n];\n\n/**\n * Create a Node.js filesystem adapter.\n */\nexport function createNodeFsAdapter(cwd?: string): FsAdapter {\n  const baseCwd = cwd ?? process.cwd();\n\n  return {\n    async exists(path: string): Promise<boolean> {\n      try {\n        await access(resolvePath(path));\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async readFile(path: string): Promise<string> {\n      return readFile(resolvePath(path), 'utf-8');\n    },\n\n    async writeFile(path: string, content: string): Promise<void> {\n      const fullPath = resolvePath(path);\n      const dir = dirname(fullPath);\n      await mkdir(dir, { recursive: true });\n      await writeFile(fullPath, content, 'utf-8');\n    },\n\n    async remove(path: string): Promise<void> {\n      await rm(resolvePath(path), { recursive: true, force: true });\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const stats = await fsStat(resolvePath(path));\n      return {\n        size: stats.size,\n        isFile: stats.isFile(),\n        isDirectory: stats.isDirectory(),\n        mtime: stats.mtime,\n      };\n    },\n\n    async mkdir(path: string): Promise<void> {\n      await mkdir(resolvePath(path), { recursive: true });\n    },\n\n    async glob(options: DiscoverOptions): Promise<string[]> {\n      const patterns =\n        options.patterns ??\n        (options.pattern ? [options.pattern] : DEFAULT_SPEC_PATTERNS);\n      const ignore = options.ignore ?? DEFAULT_IGNORES;\n      // Use provided cwd or fall back to adapter's baseCwd\n      const globCwd = options.cwd ?? baseCwd;\n      // Default to absolute paths for safer file operations\n      const absolute = options.absolute ?? true;\n\n      const all: string[] = [];\n      for (const pattern of patterns) {\n        const matches = await globFn(pattern, {\n          cwd: globCwd,\n          ignore,\n          absolute,\n        });\n        all.push(...matches);\n      }\n\n      return Array.from(new Set(all)).sort((a, b) => a.localeCompare(b));\n    },\n\n    resolve(...paths: string[]): string {\n      const [first, ...rest] = paths;\n      if (!first) return baseCwd;\n      return resolve(baseCwd, first, ...rest);\n    },\n\n    dirname(path: string): string {\n      return dirname(path);\n    },\n\n    basename(path: string): string {\n      return basename(path);\n    },\n\n    join(...paths: string[]): string {\n      return join(...paths);\n    },\n\n    relative(from: string, to: string): string {\n      return relative(from, to);\n    },\n  };\n\n  function resolvePath(path: string): string {\n    return isAbsolute(path) ? path : resolve(baseCwd, path);\n  }\n}\n"],"mappings":";;;;;;;;AAuBA,MAAa,wBAAwB;CAEnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACD;AAED,MAAM,kBAAkB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACD;;;;AAKD,SAAgB,oBAAoB,KAAyB;CAC3D,MAAM,UAAU,OAAO,QAAQ,KAAK;AAEpC,QAAO;EACL,MAAM,OAAO,QAAgC;AAC3C,OAAI;AACF,UAAM,OAAO,YAAYA,OAAK,CAAC;AAC/B,WAAO;WACD;AACN,WAAO;;;EAIX,MAAM,SAAS,QAA+B;AAC5C,UAAO,SAAS,YAAYA,OAAK,EAAE,QAAQ;;EAG7C,MAAM,UAAU,QAAc,SAAgC;GAC5D,MAAM,WAAW,YAAYA,OAAK;AAElC,SAAM,MADM,QAAQ,SAAS,EACZ,EAAE,WAAW,MAAM,CAAC;AACrC,SAAM,UAAU,UAAU,SAAS,QAAQ;;EAG7C,MAAM,OAAO,QAA6B;AACxC,SAAM,GAAG,YAAYA,OAAK,EAAE;IAAE,WAAW;IAAM,OAAO;IAAM,CAAC;;EAG/D,MAAM,KAAK,QAAiC;GAC1C,MAAM,QAAQ,MAAMC,KAAO,YAAYD,OAAK,CAAC;AAC7C,UAAO;IACL,MAAM,MAAM;IACZ,QAAQ,MAAM,QAAQ;IACtB,aAAa,MAAM,aAAa;IAChC,OAAO,MAAM;IACd;;EAGH,MAAM,MAAM,QAA6B;AACvC,SAAM,MAAM,YAAYA,OAAK,EAAE,EAAE,WAAW,MAAM,CAAC;;EAGrD,MAAM,KAAK,SAA6C;GACtD,MAAM,WACJ,QAAQ,aACP,QAAQ,UAAU,CAAC,QAAQ,QAAQ,GAAG;GACzC,MAAM,SAAS,QAAQ,UAAU;GAEjC,MAAM,UAAU,QAAQ,OAAO;GAE/B,MAAM,WAAW,QAAQ,YAAY;GAErC,MAAM,MAAgB,EAAE;AACxB,QAAK,MAAM,WAAW,UAAU;IAC9B,MAAM,UAAU,MAAME,KAAO,SAAS;KACpC,KAAK;KACL;KACA;KACD,CAAC;AACF,QAAI,KAAK,GAAG,QAAQ;;AAGtB,UAAO,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,cAAc,EAAE,CAAC;;EAGpE,QAAQ,GAAG,OAAyB;GAClC,MAAM,CAAC,OAAO,GAAG,QAAQ;AACzB,OAAI,CAAC,MAAO,QAAO;AACnB,UAAO,QAAQ,SAAS,OAAO,GAAG,KAAK;;EAGzC,QAAQ,QAAsB;AAC5B,UAAO,QAAQF,OAAK;;EAGtB,SAAS,QAAsB;AAC7B,UAAO,SAASA,OAAK;;EAGvB,KAAK,GAAG,OAAyB;AAC/B,UAAO,KAAK,GAAG,MAAM;;EAGvB,SAAS,MAAc,IAAoB;AACzC,UAAO,SAAS,MAAM,GAAG;;EAE5B;CAED,SAAS,YAAY,QAAsB;AACzC,SAAO,WAAWA,OAAK,GAAGA,SAAO,QAAQ,SAASA,OAAK"}

package/dist/adapters/git.d.mts

@@ -0,0 +1,11 @@
+import { GitAdapter } from "../ports/git.mjs";
+
+//#region src/adapters/git.d.ts
+
+/**
+ * Create a Node.js git adapter.
+ */
+declare function createNodeGitAdapter(cwd?: string): GitAdapter;
+//#endregion
+export { createNodeGitAdapter };
+//# sourceMappingURL=git.d.mts.map

package/dist/adapters/git.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.mts","names":[],"sources":["../../src/adapters/git.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAYgB,oBAAA,gBAAoC"}

package/dist/adapters/git.mjs

@@ -0,0 +1,84 @@
+import { access } from "node:fs/promises";
+import { resolve } from "node:path";
+import { execSync } from "node:child_process";
+
+//#region src/adapters/git.ts
+/**
+* Node.js git adapter implementation.
+*/
+/**
+* Create a Node.js git adapter.
+*/
+function createNodeGitAdapter(cwd) {
+	const baseCwd = cwd ?? process.cwd();
+	return {
+		async showFile(ref, filePath) {
+			try {
+				return execSync(`git show ${ref}:${filePath}`, {
+					cwd: baseCwd,
+					encoding: "utf-8",
+					stdio: [
+						"ignore",
+						"pipe",
+						"pipe"
+					]
+				});
+			} catch (error) {
+				throw new Error(`Could not load ${filePath} at ref ${ref}: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		},
+		async clean(options) {
+			const flags = [];
+			if (options?.force) flags.push("-f");
+			if (options?.directories) flags.push("-d");
+			if (options?.ignored) flags.push("-x");
+			if (options?.dryRun) flags.push("--dry-run");
+			execSync(`git clean ${flags.join(" ")}`, {
+				cwd: baseCwd,
+				stdio: "inherit"
+			});
+		},
+		async isGitRepo(path$1) {
+			const targetPath = path$1 ? resolve(baseCwd, path$1) : baseCwd;
+			try {
+				await access(resolve(targetPath, ".git"));
+				return true;
+			} catch {
+				return false;
+			}
+		},
+		async log(baseline) {
+			const ref = baseline ?? "HEAD~10";
+			const format = "--format=%H|||%s|||%an|||%aI";
+			try {
+				const output = execSync(`git log ${ref}..HEAD ${format}`, {
+					cwd: baseCwd,
+					encoding: "utf-8",
+					stdio: [
+						"ignore",
+						"pipe",
+						"pipe"
+					]
+				});
+				const entries = [];
+				for (const line of output.trim().split("\n")) {
+					if (!line) continue;
+					const [hash, message, author, date] = line.split("|||");
+					if (hash && message) entries.push({
+						hash,
+						message,
+						author,
+						date
+					});
+				}
+				return entries;
+			} catch {
+				return [];
+			}
+		}
+	};
+}
+
+//#endregion
+export { createNodeGitAdapter };
+//# sourceMappingURL=git.mjs.map

package/dist/adapters/git.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.mjs","names":["path"],"sources":["../../src/adapters/git.ts"],"sourcesContent":["/**\n * Node.js git adapter implementation.\n */\n\nimport { execSync } from 'node:child_process';\nimport { access } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport type { GitAdapter, GitCleanOptions, GitLogEntry } from '../ports/git';\n\n/**\n * Create a Node.js git adapter.\n */\nexport function createNodeGitAdapter(cwd?: string): GitAdapter {\n  const baseCwd = cwd ?? process.cwd();\n\n  return {\n    async showFile(ref: string, filePath: string): Promise<string> {\n      try {\n        return execSync(`git show ${ref}:${filePath}`, {\n          cwd: baseCwd,\n          encoding: 'utf-8',\n          stdio: ['ignore', 'pipe', 'pipe'],\n        });\n      } catch (error) {\n        throw new Error(\n          `Could not load ${filePath} at ref ${ref}: ${\n            error instanceof Error ? error.message : String(error)\n          }`\n        );\n      }\n    },\n\n    async clean(options?: GitCleanOptions): Promise<void> {\n      const flags: string[] = [];\n      if (options?.force) flags.push('-f');\n      if (options?.directories) flags.push('-d');\n      if (options?.ignored) flags.push('-x');\n      if (options?.dryRun) flags.push('--dry-run');\n\n      execSync(`git clean ${flags.join(' ')}`, {\n        cwd: baseCwd,\n        stdio: 'inherit',\n      });\n    },\n\n    async isGitRepo(path?: string): Promise<boolean> {\n      const targetPath = path ? resolve(baseCwd, path) : baseCwd;\n      try {\n        await access(resolve(targetPath, '.git'));\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async log(baseline?: string): Promise<GitLogEntry[]> {\n      const ref = baseline ?? 'HEAD~10';\n      const format = '--format=%H|||%s|||%an|||%aI';\n\n      try {\n        const output = execSync(`git log ${ref}..HEAD ${format}`, {\n          cwd: baseCwd,\n          encoding: 'utf-8',\n          stdio: ['ignore', 'pipe', 'pipe'],\n        });\n\n        const entries: GitLogEntry[] = [];\n\n        for (const line of output.trim().split('\\n')) {\n          if (!line) continue;\n          const [hash, message, author, date] = line.split('|||');\n          if (hash && message) {\n            entries.push({ hash, message, author, date });\n          }\n        }\n\n        return entries;\n      } catch {\n        // Return empty if git log fails (e.g., not enough commits)\n        return [];\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,qBAAqB,KAA0B;CAC7D,MAAM,UAAU,OAAO,QAAQ,KAAK;AAEpC,QAAO;EACL,MAAM,SAAS,KAAa,UAAmC;AAC7D,OAAI;AACF,WAAO,SAAS,YAAY,IAAI,GAAG,YAAY;KAC7C,KAAK;KACL,UAAU;KACV,OAAO;MAAC;MAAU;MAAQ;MAAO;KAClC,CAAC;YACK,OAAO;AACd,UAAM,IAAI,MACR,kBAAkB,SAAS,UAAU,IAAI,IACvC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAEzD;;;EAIL,MAAM,MAAM,SAA0C;GACpD,MAAM,QAAkB,EAAE;AAC1B,OAAI,SAAS,MAAO,OAAM,KAAK,KAAK;AACpC,OAAI,SAAS,YAAa,OAAM,KAAK,KAAK;AAC1C,OAAI,SAAS,QAAS,OAAM,KAAK,KAAK;AACtC,OAAI,SAAS,OAAQ,OAAM,KAAK,YAAY;AAE5C,YAAS,aAAa,MAAM,KAAK,IAAI,IAAI;IACvC,KAAK;IACL,OAAO;IACR,CAAC;;EAGJ,MAAM,UAAU,QAAiC;GAC/C,MAAM,aAAaA,SAAO,QAAQ,SAASA,OAAK,GAAG;AACnD,OAAI;AACF,UAAM,OAAO,QAAQ,YAAY,OAAO,CAAC;AACzC,WAAO;WACD;AACN,WAAO;;;EAIX,MAAM,IAAI,UAA2C;GACnD,MAAM,MAAM,YAAY;GACxB,MAAM,SAAS;AAEf,OAAI;IACF,MAAM,SAAS,SAAS,WAAW,IAAI,SAAS,UAAU;KACxD,KAAK;KACL,UAAU;KACV,OAAO;MAAC;MAAU;MAAQ;MAAO;KAClC,CAAC;IAEF,MAAM,UAAyB,EAAE;AAEjC,SAAK,MAAM,QAAQ,OAAO,MAAM,CAAC,MAAM,KAAK,EAAE;AAC5C,SAAI,CAAC,KAAM;KACX,MAAM,CAAC,MAAM,SAAS,QAAQ,QAAQ,KAAK,MAAM,MAAM;AACvD,SAAI,QAAQ,QACV,SAAQ,KAAK;MAAE;MAAM;MAAS;MAAQ;MAAM,CAAC;;AAIjD,WAAO;WACD;AAEN,WAAO,EAAE;;;EAGd"}

package/dist/adapters/index.d.mts

@@ -0,0 +1,7 @@
+import { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter } from "./fs.mjs";
+import { createNodeGitAdapter } from "./git.mjs";
+import { createNodeWatcherAdapter } from "./watcher.mjs";
+import { createNodeAiAdapter } from "./ai.mjs";
+import { createConsoleLoggerAdapter, createNoopLoggerAdapter } from "./logger.mjs";
+import { CreateAdaptersOptions, createNodeAdapters } from "./factory.mjs";
+import { MetaRepoInfo, PackageManager, RepositoryType, SubmoduleInfo, WorkspaceInfo, detectPackageManager, detectRepositoryType, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, getExecCommand, getInstallCommand, getMetaRepoInfo, getPackageName, getRunCommand, getWorkspaceInfo, getWorkspacePackages, isMonorepo, parseGitModules } from "./workspace.mjs";

package/dist/adapters/index.mjs

@@ -0,0 +1,9 @@
+import { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter } from "./fs.mjs";
+import { createNodeGitAdapter } from "./git.mjs";
+import { createNodeWatcherAdapter } from "./watcher.mjs";
+import { createNodeAiAdapter } from "./ai.mjs";
+import { createConsoleLoggerAdapter, createNoopLoggerAdapter } from "./logger.mjs";
+import { createNodeAdapters } from "./factory.mjs";
+import { detectPackageManager, detectRepositoryType, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, getExecCommand, getInstallCommand, getMetaRepoInfo, getPackageName, getRunCommand, getWorkspaceInfo, getWorkspacePackages, isMonorepo, parseGitModules } from "./workspace.mjs";
+
+export {  };

package/dist/adapters/logger.d.mts

@@ -0,0 +1,18 @@
+import { LoggerAdapter } from "../ports/logger.mjs";
+
+//#region src/adapters/logger.d.ts
+
+/**
+ * Create a console-based logger adapter.
+ * This is a basic implementation - CLI apps should inject their own
+ * logger with chalk/ora for better terminal output.
+ */
+declare function createConsoleLoggerAdapter(): LoggerAdapter;
+/**
+ * Create a no-op logger adapter.
+ * Useful for testing or when logging is not desired.
+ */
+declare function createNoopLoggerAdapter(): LoggerAdapter;
+//#endregion
+export { createConsoleLoggerAdapter, createNoopLoggerAdapter };
+//# sourceMappingURL=logger.d.mts.map

package/dist/adapters/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","names":[],"sources":["../../src/adapters/logger.ts"],"sourcesContent":[],"mappings":";;;;;;;;;iBAagB,0BAAA,CAAA,GAA8B;;;;;iBA8B9B,uBAAA,CAAA,GAA2B"}