@contractspec/app.cli-contractspec 1.44.0

package/.contractsrc.example.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "./contractsrc.schema.json",
+  "aiProvider": "claude",
+  "aiModel": "claude-3-7-sonnet-20250219",
+  "agentMode": "claude-code",
+  "customEndpoint": null,
+  "customApiKey": null,
+  "outputDir": "./src",
+  "conventions": {
+    "operations": "interactions/commands|queries",
+    "events": "events",
+    "presentations": "presentations",
+    "forms": "forms"
+  },
+  "defaultOwners": ["@team"],
+  "defaultTags": ["auto-generated"],
+  
+  "_comments": {
+    "aiProvider": "Options: 'claude', 'openai', 'ollama', 'custom'",
+    "agentMode": "Options: 'simple', 'cursor', 'claude-code', 'openai-codex'. Controls code generation strategy.",
+    "aiModel": "Specific model to use. Defaults vary by provider.",
+    "customEndpoint": "For custom providers. Example: 'https://your-llm-endpoint.com'",
+    "customApiKey": "Optional. Can also use CONTRACTSPEC_LLM_API_KEY env var"
+  }
+}

package/AGENTS.md

@@ -0,0 +1,102 @@
+# AI Agent Guide — `@contractspec/app.cli-contractspec`
+
+Scope: `packages/apps/cli-contractspec/*`
+
+This is the ContractSpec CLI (`contractspec`).
+
+## Architecture
+
+The CLI is a **thin wrapper** around business logic in `@contractspec/bundle.workspace`. The separation is:
+
+### CLI Layer (this package)
+
+- **Commands** (`src/commands/`) - Thin wrappers that call bundle services
+- **Prompts** (`src/commands/create/wizards/`) - Interactive UI using `@inquirer/prompts`
+- **CLI setup** (`src/index.ts`, `src/cli.ts`) - Commander.js configuration
+- **Types** (`src/types.ts`) - CLI-specific types
+
+### Business Logic (bundle)
+
+- **Services** (`@contractspec/bundle.workspace/services/`) - Core use-cases
+  - `create.ts` - Spec creation logic
+  - `build.ts` - Code generation from specs
+  - `openapi.ts` - OpenAPI export
+  - `registry.ts` - Registry client
+  - `examples.ts` - Examples management
+  - `validate.ts`, `diff.ts`, `deps.ts`, etc.
+- **Templates** (`@contractspec/bundle.workspace/templates/`) - Spec templates
+- **AI** (`@contractspec/bundle.workspace/ai/`) - AI agents and prompts
+- **Adapters** (`@contractspec/bundle.workspace/adapters/`) - Infrastructure
+
+## Build System
+
+The CLI is bundled with `bun build`:
+
+- Single executable output: `dist/cli.js`
+- Target: `bun` runtime
+- Minified for production
+- Type declarations generated separately with `tsc`
+
+## Test System
+
+Tests use `bun:test` (not vitest):
+
+- Run: `bun test`
+- Watch: `bun test --watch`
+- All test files import from `bun:test`
+
+## Docs consumed by MCP
+
+The CLI MCP server serves these markdown files by path:
+
+- `packages/apps/cli-contractspec/QUICK_START.md`
+- `packages/apps/cli-contractspec/QUICK_REFERENCE.md`
+- `packages/apps/cli-contractspec/README.md`
+
+If you rename/move them, update `packages/bundles/contractspec-studio/src/application/mcp/cliMcp.ts` (`CLI_DOC_PATHS`).
+
+## Local commands
+
+- **Dev/watch**: `bun run dev` - Watch mode, rebuilds on changes
+- **Build**: `bun run build` - Bundles CLI + generates types
+- **Test**: `bun test` - Run all tests
+- **Lint**: `bun run lint` - Fix linting issues
+
+## Prompt Library
+
+The CLI uses `@inquirer/prompts` (not legacy `inquirer`):
+
+- `select` - List selection
+- `input` - Text input
+- `confirm` - Yes/no confirmation
+- `number` - Numeric input
+
+## Adding a New Command
+
+1. **Create service in bundle** (`@contractspec/bundle.workspace/services/`)
+2. **Create CLI wrapper** (`src/commands/new-command.ts`)
+3. **Add to index.ts** (`src/index.ts`)
+4. **Add prompts if needed** (`src/commands/new-command/prompts.ts`)
+5. **Write tests** (`src/commands/new-command/index.test.ts`)
+
+Example CLI wrapper:
+
+```typescript
+import { Command } from 'commander';
+import { myService } from '@contractspec/bundle.workspace';
+import { createFsAdapter } from '@contractspec/bundle.workspace/adapters';
+
+export const myCommand = new Command('my-command')
+  .description('Do something')
+  .action(async () => {
+    const fs = createFsAdapter();
+    const logger = createLoggerAdapter();
+
+    await myService(
+      {
+        /* options */
+      },
+      { fs, logger }
+    );
+  });
+```

package/CHANGELOG.md

@@ -0,0 +1,521 @@
+# Changelog
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @contractspec/lib.contracts-transformers@1.44.0
+  - @contractspec/bundle.workspace@1.44.0
+  - @contractspec/lib.ai-providers@1.44.0
+  - @contractspec/module.examples@1.44.0
+  - @contractspec/module.ai-chat@1.44.0
+  - @contractspec/lib.contracts@1.44.0
+  - @contractspec/lib.testing@1.44.0
+  - @contractspec/lib.schema@1.44.0
+
+## 1.43.4
+
+### Patch Changes
+
+- 9216062: fix: cross-platform compatibility
+- Updated dependencies [9216062]
+  - @contractspec/bundle.workspace@1.43.4
+  - @contractspec/module.examples@1.43.4
+  - @contractspec/lib.contracts-transformers@1.43.4
+  - @contractspec/lib.ai-providers@1.43.3
+  - @contractspec/module.ai-chat@1.43.4
+  - @contractspec/lib.contracts@1.43.4
+  - @contractspec/lib.testing@1.43.4
+  - @contractspec/lib.schema@1.43.3
+
+## 1.43.3
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @contractspec/bundle.workspace@1.43.3
+  - @contractspec/module.examples@1.43.3
+  - @contractspec/lib.contracts-transformers@1.43.3
+  - @contractspec/lib.ai-providers@1.43.2
+  - @contractspec/module.ai-chat@1.43.3
+  - @contractspec/lib.contracts@1.43.3
+  - @contractspec/lib.testing@1.43.3
+  - @contractspec/lib.schema@1.43.2
+
+## 1.43.2
+
+### Patch Changes
+
+- e147271: fix: improve stability
+- Updated dependencies [e147271]
+  - @contractspec/bundle.workspace@1.43.2
+  - @contractspec/module.examples@1.43.2
+  - @contractspec/lib.contracts-transformers@1.43.2
+  - @contractspec/module.ai-chat@1.43.2
+  - @contractspec/lib.contracts@1.43.2
+  - @contractspec/lib.testing@1.43.2
+  - @contractspec/lib.ai-providers@1.43.1
+  - @contractspec/lib.schema@1.43.1
+
+## 1.43.1
+
+### Patch Changes
+
+- f28fdad: fix
+- Updated dependencies [f28fdad]
+  - @contractspec/lib.contracts@1.43.1
+  - @contractspec/bundle.workspace@1.43.1
+  - @contractspec/lib.contracts-transformers@1.43.1
+  - @contractspec/lib.testing@1.43.1
+  - @contractspec/module.ai-chat@1.43.1
+  - @contractspec/module.examples@1.43.1
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @contractspec/bundle.workspace@1.43.0
+  - @contractspec/module.examples@1.43.0
+  - @contractspec/lib.contracts-transformers@1.43.0
+  - @contractspec/lib.ai-providers@1.43.0
+  - @contractspec/module.ai-chat@1.43.0
+  - @contractspec/lib.contracts@1.43.0
+  - @contractspec/lib.testing@1.43.0
+  - @contractspec/lib.schema@1.43.0
+
+## 1.42.10
+
+### Patch Changes
+
+- 1e6a0f1: fix: mcp server
+- Updated dependencies [1e6a0f1]
+  - @contractspec/bundle.workspace@1.42.10
+  - @contractspec/module.examples@1.42.10
+  - @contractspec/lib.contracts-transformers@1.42.10
+  - @contractspec/lib.ai-providers@1.42.10
+  - @contractspec/module.ai-chat@1.42.10
+  - @contractspec/lib.contracts@1.42.10
+  - @contractspec/lib.testing@1.42.10
+  - @contractspec/lib.schema@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/bundle.workspace@1.42.9
+  - @contractspec/module.examples@1.42.9
+  - @contractspec/lib.contracts-transformers@1.42.9
+  - @contractspec/lib.ai-providers@1.42.9
+  - @contractspec/module.ai-chat@1.42.9
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.testing@1.42.9
+  - @contractspec/lib.schema@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/bundle.workspace@1.42.8
+  - @contractspec/module.examples@1.42.8
+  - @contractspec/lib.contracts-transformers@1.42.8
+  - @contractspec/lib.ai-providers@1.42.8
+  - @contractspec/module.ai-chat@1.42.8
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.testing@1.42.8
+  - @contractspec/lib.schema@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/bundle.workspace@1.42.7
+  - @contractspec/module.examples@1.42.7
+  - @contractspec/lib.contracts-transformers@1.42.7
+  - @contractspec/lib.ai-providers@1.42.7
+  - @contractspec/module.ai-chat@1.42.7
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.testing@1.42.7
+  - @contractspec/lib.schema@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/bundle.workspace@1.42.6
+  - @contractspec/module.examples@1.42.6
+  - @contractspec/lib.contracts-transformers@1.42.6
+  - @contractspec/lib.ai-providers@1.42.6
+  - @contractspec/module.ai-chat@1.42.6
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.testing@1.42.6
+  - @contractspec/lib.schema@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @contractspec/bundle.workspace@1.42.5
+  - @contractspec/module.examples@1.42.5
+  - @contractspec/lib.contracts-transformers@1.42.5
+  - @contractspec/lib.ai-providers@1.42.5
+  - @contractspec/module.ai-chat@1.42.5
+  - @contractspec/lib.contracts@1.42.5
+  - @contractspec/lib.testing@1.42.5
+  - @contractspec/lib.schema@1.42.5
+
+## 1.42.4
+
+### Patch Changes
+
+- ac28b99: fix: generate from openapi
+- Updated dependencies [ac28b99]
+  - @contractspec/bundle.workspace@1.42.4
+  - @contractspec/module.examples@1.42.4
+  - @contractspec/lib.contracts-transformers@1.42.4
+  - @contractspec/lib.ai-providers@1.42.4
+  - @contractspec/module.ai-chat@1.42.4
+  - @contractspec/lib.contracts@1.42.4
+  - @contractspec/lib.testing@1.42.4
+  - @contractspec/lib.schema@1.42.4
+
+## 1.42.3
+
+### Patch Changes
+
+- 3f5d015: fix(tooling): cicd
+- Updated dependencies [3f5d015]
+  - @contractspec/lib.contracts-transformers@1.42.3
+  - @contractspec/bundle.workspace@1.42.3
+  - @contractspec/lib.ai-providers@1.42.3
+  - @contractspec/lib.contracts@1.42.3
+  - @contractspec/lib.schema@1.42.3
+  - @contractspec/lib.testing@1.42.3
+  - @contractspec/module.ai-chat@1.42.3
+  - @contractspec/module.examples@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/bundle.workspace@1.42.2
+  - @contractspec/lib.ai-providers@1.42.2
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.contracts-transformers@1.42.2
+  - @contractspec/lib.schema@1.42.2
+  - @contractspec/lib.testing@1.42.2
+  - @contractspec/module.ai-chat@1.42.2
+  - @contractspec/module.examples@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @contractspec/bundle.workspace@1.42.1
+  - @contractspec/module.examples@1.42.1
+  - @contractspec/lib.contracts-transformers@1.42.1
+  - @contractspec/lib.ai-providers@1.42.1
+  - @contractspec/module.ai-chat@1.42.1
+  - @contractspec/lib.contracts@1.42.1
+  - @contractspec/lib.testing@1.42.1
+  - @contractspec/lib.schema@1.42.1
+
+## 1.42.0
+
+### Minor Changes
+
+- 8eefd9c: initial release
+
+### Patch Changes
+
+- Updated dependencies [8eefd9c]
+  - @contractspec/bundle.workspace@1.42.0
+  - @contractspec/lib.ai-providers@1.42.0
+  - @contractspec/lib.contracts@1.42.0
+  - @contractspec/lib.contracts-transformers@1.42.0
+  - @contractspec/lib.schema@1.42.0
+  - @contractspec/lib.testing@1.42.0
+  - @contractspec/module.ai-chat@1.42.0
+  - @contractspec/module.examples@1.42.0
+
+## 0.12.0
+
+### Minor Changes
+
+- Refactor to be compatible with ai-sdk v6
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/app.cli-database@1.12.0
+  - @contractspec/lib.contracts@1.12.0
+  - @contractspec/lib.schema@1.12.0
+  - @contractspec/lib.testing@0.5.0
+
+## 0.11.1
+
+### Patch Changes
+
+- Fix dependencies
+- Updated dependencies
+  - @contractspec/app.cli-database@1.11.1
+  - @contractspec/lib.contracts@1.11.1
+  - @contractspec/lib.schema@1.11.1
+  - @contractspec/lib.testing@0.4.1
+
+## 0.11.0
+
+### Minor Changes
+
+- b7621d3: Fix version
+
+### Patch Changes
+
+- Updated dependencies [b7621d3]
+  - @contractspec/app.cli-database@1.11.0
+  - @contractspec/lib.contracts@1.11.0
+  - @contractspec/lib.schema@1.11.0
+  - @contractspec/lib.testing@0.4.0
+
+## 0.10.0
+
+### Minor Changes
+
+- fix
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/app.cli-database@1.10.0
+  - @contractspec/lib.contracts@1.10.0
+  - @contractspec/lib.schema@1.10.0
+  - @contractspec/lib.testing@0.3.0
+
+## 0.9.2
+
+### Patch Changes
+
+- fix dependencies
+- Updated dependencies
+  - @contractspec/lib.testing@0.2.2
+  - @contractspec/app.cli-database@1.9.2
+  - @contractspec/lib.contracts@1.9.2
+  - @contractspec/lib.schema@1.9.2
+
+## 0.9.1
+
+### Patch Changes
+
+- fix
+- Updated dependencies
+  - @contractspec/app.cli-database@1.9.1
+  - @contractspec/lib.contracts@1.9.1
+  - @contractspec/lib.testing@0.2.1
+  - @contractspec/lib.schema@1.9.1
+
+## 0.9.0
+
+### Minor Changes
+
+- b1d0876: Managed platform
+
+### Patch Changes
+
+- Updated dependencies [b1d0876]
+  - @contractspec/app.cli-database@1.9.0
+  - @contractspec/lib.contracts@1.9.0
+  - @contractspec/lib.testing@0.2.0
+  - @contractspec/lib.schema@1.9.0
+
+## 0.8.0
+
+### Minor Changes
+
+- f1f4ddd: Foundation Hardening
+
+### Patch Changes
+
+- Updated dependencies [f1f4ddd]
+  - @contractspec/lib.contracts@1.8.0
+  - @contractspec/lib.schema@1.8.0
+
+## 0.7.4
+
+### Patch Changes
+
+- fix typing
+- Updated dependencies
+  - @contractspec/lib.contracts@1.7.4
+  - @contractspec/lib.schema@1.7.4
+
+## 0.7.3
+
+### Patch Changes
+
+- add right-sidebar
+- Updated dependencies
+  - @contractspec/lib.contracts@1.7.3
+  - @contractspec/lib.schema@1.7.3
+
+## 0.7.2
+
+### Patch Changes
+
+- fix typing
+- Updated dependencies
+  - @contractspec/lib.contracts@1.7.2
+  - @contractspec/lib.schema@1.7.2
+
+## 0.7.1
+
+### Patch Changes
+
+- fix typing
+- Updated dependencies
+  - @contractspec/lib.contracts@1.7.1
+  - @contractspec/lib.schema@1.7.1
+
+## 0.7.0
+
+### Minor Changes
+
+- fixii
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/lib.contracts@1.7.0
+  - @contractspec/lib.schema@1.7.0
+
+## 0.6.0
+
+### Minor Changes
+
+- fix versionnnn
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/lib.contracts@1.6.0
+  - @contractspec/lib.schema@1.6.0
+
+## 0.5.0
+
+### Minor Changes
+
+- fix
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/lib.contracts@1.5.0
+  - @contractspec/lib.schema@1.5.0
+
+## 0.4.0
+
+### Minor Changes
+
+- fix exports
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/lib.contracts@1.4.0
+  - @contractspec/lib.schema@1.4.0
+
+## 0.3.0
+
+### Minor Changes
+
+- fix it
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/lib.contracts@1.3.0
+  - @contractspec/lib.schema@1.3.0
+
+## 0.2.0
+
+### Minor Changes
+
+- fix
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/lib.contracts@1.2.0
+  - @contractspec/lib.schema@1.2.0
+
+## 0.1.0
+
+### Minor Changes
+
+- fix
+- 748b3a2: fix publish
+
+### Patch Changes
+
+- Updated dependencies
+- Updated dependencies [748b3a2]
+  - @contractspec/lib.contracts@1.1.0
+  - @contractspec/lib.schema@1.1.0
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+Initial version
+
+### Added
+
+- Initial release of contracts-cli
+- `contractspec create` command with interactive wizards
+- AI-assisted spec creation using Vercel AI SDK
+- Multi-provider support (Claude, OpenAI, Ollama, custom endpoints)
+- `contractspec build` command for code generation
+- `contractspec validate` command for spec validation
+- TypeScript templates for operations, events, and presentations
+- Handler and component generation
+- Test generation
+- Comprehensive documentation and examples
+- Agent-driven build workflow with automatic fallback to deterministic templates
+- AI-powered implementation validation with consistent agent orchestration
+
+### Features
+
+- Interactive CLI with Commander.js
+- Beautiful terminal output with Chalk and Ora
+- Configuration via `.contractsrc.json`
+- Environment variable support
+- BYOLLM (Bring Your Own LLM) support
+- Validation with detailed error messages
+- Type-safe code generation
+- `contractspec validate` now prompts for spec-only vs implementation validation unless `--check-implementation` is provided

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.