@contractspec/bundle.library 3.7.6 → 3.8.2

package/src/components/docs/generated/docs-index.workspace-cli.json

@@ -1,10 +1,10 @@
 [
-  {
-    "id": "workspace-cli/workspace-cli",
-    "title": "workspace-cli",
-    "summary": "Core CLI operations for managing ContractSpec workspaces\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @lssm/core\n- **Tags**: cli, core\n- **File**: `packages/bundles/workspace/src/contracts/features/cli.feature.ts`",
-    "route": "/docs/reference/workspace-cli/workspace-cli",
-    "source": "generated",
-    "contentPath": "workspace-cli/workspace-cli.md"
-  }
+	{
+		"id": "workspace-cli/workspace-cli",
+		"title": "workspace-cli",
+		"summary": "Core CLI operations for managing ContractSpec workspaces\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @lssm/core\n- **Tags**: cli, core\n- **File**: `packages/bundles/workspace/src/contracts/features/cli.feature.ts`",
+		"route": "/docs/reference/workspace-cli/workspace-cli",
+		"source": "generated",
+		"contentPath": "workspace-cli/workspace-cli.md"
+	}
 ]

package/src/components/docs/generated/index.ts

@@ -1,10 +1,10 @@
 export type {
-  DocsIndexEntry,
-  DocsIndexManifest,
-  DocsIndexSource,
+	DocsIndexEntry,
+	DocsIndexManifest,
+	DocsIndexSource,
 } from './docs-index.generated';
 export {
-  getDocsIndexManifest,
-  getGeneratedDocById,
-  listGeneratedDocs,
+	getDocsIndexManifest,
+	getGeneratedDocById,
+	listGeneratedDocs,
 } from './loader';

package/src/components/docs/generated/loader.ts

@@ -1,8 +1,8 @@
 import { readFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { DOCS_INDEX_MANIFEST } from './docs-index.generated';
 import type { DocsIndexEntry, DocsIndexManifest } from './docs-index.generated';
+import { DOCS_INDEX_MANIFEST } from './docs-index.generated';
 
 const baseDir = dirname(fileURLToPath(import.meta.url));
 let manifestPromise: Promise<DocsIndexManifest> | null = null;
@@ -10,75 +10,75 @@ let docsPromise: Promise<DocsIndexEntry[]> | null = null;
 const chunkCache = new Map<string, Promise<DocsIndexEntry[]>>();
 
 function chunkKeyForId(id: string): string {
-  if (!id) return '_common';
-  if (id.includes('/')) {
-    const [prefix] = id.split('/');
-    return prefix || '_common';
-  }
-  return '_common';
+	if (!id) return '_common';
+	if (id.includes('/')) {
+		const [prefix] = id.split('/');
+		return prefix || '_common';
+	}
+	return '_common';
 }
 
 async function loadManifest(): Promise<DocsIndexManifest> {
-  if (!manifestPromise) {
-    manifestPromise = readFile(join(baseDir, DOCS_INDEX_MANIFEST), 'utf8').then(
-      (content) => JSON.parse(content) as DocsIndexManifest
-    );
-  }
-  return manifestPromise;
+	if (!manifestPromise) {
+		manifestPromise = readFile(join(baseDir, DOCS_INDEX_MANIFEST), 'utf8').then(
+			(content) => JSON.parse(content) as DocsIndexManifest
+		);
+	}
+	return manifestPromise;
 }
 
 function resolveContentRoot(manifest: DocsIndexManifest): string {
-  const root = manifest.contentRoot ?? '.';
-  return join(baseDir, root);
+	const root = manifest.contentRoot ?? '.';
+	return join(baseDir, root);
 }
 
 async function loadChunk(fileName: string): Promise<DocsIndexEntry[]> {
-  const cached = chunkCache.get(fileName);
-  if (cached) return cached;
+	const cached = chunkCache.get(fileName);
+	if (cached) return cached;
 
-  const load = readFile(join(baseDir, fileName), 'utf8').then(
-    (content) => JSON.parse(content) as DocsIndexEntry[]
-  );
-  chunkCache.set(fileName, load);
-  return load;
+	const load = readFile(join(baseDir, fileName), 'utf8').then(
+		(content) => JSON.parse(content) as DocsIndexEntry[]
+	);
+	chunkCache.set(fileName, load);
+	return load;
 }
 
 export async function listGeneratedDocs(): Promise<readonly DocsIndexEntry[]> {
-  if (!docsPromise) {
-    docsPromise = (async () => {
-      const manifest = await loadManifest();
-      const chunks = await Promise.all(
-        manifest.chunks.map((chunk) => loadChunk(chunk.file))
-      );
-      return chunks.flat();
-    })();
-  }
+	if (!docsPromise) {
+		docsPromise = (async () => {
+			const manifest = await loadManifest();
+			const chunks = await Promise.all(
+				manifest.chunks.map((chunk) => loadChunk(chunk.file))
+			);
+			return chunks.flat();
+		})();
+	}
 
-  return docsPromise;
+	return docsPromise;
 }
 
 export async function getDocsIndexManifest(): Promise<DocsIndexManifest> {
-  return loadManifest();
+	return loadManifest();
 }
 
 export async function getGeneratedDocById(id: string): Promise<{
-  entry: DocsIndexEntry;
-  content: string;
+	entry: DocsIndexEntry;
+	content: string;
 } | null> {
-  const manifest = await loadManifest();
-  const key = chunkKeyForId(id);
-  const chunk = manifest.chunks.find((item) => item.key === key);
-  if (!chunk) return null;
+	const manifest = await loadManifest();
+	const key = chunkKeyForId(id);
+	const chunk = manifest.chunks.find((item) => item.key === key);
+	if (!chunk) return null;
 
-  const entries = await loadChunk(chunk.file);
-  const entry = entries.find((doc) => doc.id === id);
-  if (!entry || !entry.contentPath) return null;
+	const entries = await loadChunk(chunk.file);
+	const entry = entries.find((doc) => doc.id === id);
+	if (!entry || !entry.contentPath) return null;
 
-  const contentPath = join(resolveContentRoot(manifest), entry.contentPath);
-  try {
-    const content = await readFile(contentPath, 'utf8');
-    return { entry, content };
-  } catch {
-    return null;
-  }
+	const contentPath = join(resolveContentRoot(manifest), entry.contentPath);
+	try {
+		const content = await readFile(contentPath, 'utf8');
+		return { entry, content };
+	} catch {
+		return null;
+	}
 }

package/src/components/docs/getting-started/CLIPage.tsx

@@ -1,78 +1,78 @@
+import { CodeBlock, InstallCommand } from '@contractspec/lib.design-system';
 import Link from '@contractspec/lib.ui-link';
 import { ChevronRight } from 'lucide-react';
-import { CodeBlock, InstallCommand } from '@contractspec/lib.design-system';
 
 export function CLIPage() {
-  const commands = [
-    {
-      name: 'create',
-      description: 'Interactive wizard to create contract specifications',
-      usage: 'contractspec create [--type operation] [--ai]',
-    },
-    {
-      name: 'build',
-      description:
-        'Generate implementation code from contract specs using AI agents',
-      usage: 'contractspec build <spec-file> [--agent-mode claude-code]',
-    },
-    {
-      name: 'validate',
-      description: 'Validate contract specifications and implementations',
-      usage: 'contractspec validate <spec-file> [--check-implementation]',
-    },
-    {
-      name: 'list',
-      description: 'List all contract specifications in the project',
-      usage: 'contractspec list [--type operation] [--json]',
-    },
-    {
-      name: 'watch',
-      description: 'Watch specs and auto-regenerate on changes',
-      usage: 'contractspec watch [--build] [--validate]',
-    },
-    {
-      name: 'sync',
-      description: 'Sync contracts by building all discovered specs',
-      usage: 'contractspec sync [--dry-run]',
-    },
-    {
-      name: 'ci',
-      description: 'Run all validation checks for CI/CD pipelines',
-      usage: 'contractspec ci [--format sarif] [--output results.sarif]',
-    },
-    {
-      name: 'deps',
-      description: 'Analyze contract dependencies and relationships',
-      usage: 'contractspec deps [--circular] [--format dot]',
-    },
-    {
-      name: 'diff',
-      description: 'Compare contract specifications and show differences',
-      usage: 'contractspec diff <spec1> <spec2> [--breaking]',
-    },
-  ];
+	const commands = [
+		{
+			name: 'create',
+			description: 'Interactive wizard to create contract specifications',
+			usage: 'contractspec create [--type operation] [--ai]',
+		},
+		{
+			name: 'build',
+			description:
+				'Generate implementation code from contract specs using AI agents',
+			usage: 'contractspec build <spec-file> [--agent-mode claude-code]',
+		},
+		{
+			name: 'validate',
+			description: 'Validate contract specifications and implementations',
+			usage: 'contractspec validate <spec-file> [--check-implementation]',
+		},
+		{
+			name: 'list',
+			description: 'List all contract specifications in the project',
+			usage: 'contractspec list [--type operation] [--json]',
+		},
+		{
+			name: 'watch',
+			description: 'Watch specs and auto-regenerate on changes',
+			usage: 'contractspec watch [--build] [--validate]',
+		},
+		{
+			name: 'sync',
+			description: 'Sync contracts by building all discovered specs',
+			usage: 'contractspec sync [--dry-run]',
+		},
+		{
+			name: 'ci',
+			description: 'Run all validation checks for CI/CD pipelines',
+			usage: 'contractspec ci [--format sarif] [--output results.sarif]',
+		},
+		{
+			name: 'deps',
+			description: 'Analyze contract dependencies and relationships',
+			usage: 'contractspec deps [--circular] [--format dot]',
+		},
+		{
+			name: 'diff',
+			description: 'Compare contract specifications and show differences',
+			usage: 'contractspec diff <spec1> <spec2> [--breaking]',
+		},
+	];
 
-  return (
-    <div className="space-y-8">
-      <div className="space-y-2">
-        <h1 className="text-4xl font-bold">ContractSpec CLI</h1>
-        <p className="text-muted-foreground text-lg">
-          Command-line interface for creating, building, and validating contract
-          specifications with AI-powered code generation.
-        </p>
-      </div>
+	return (
+		<div className="space-y-8">
+			<div className="space-y-2">
+				<h1 className="font-bold text-4xl">ContractSpec CLI</h1>
+				<p className="text-lg text-muted-foreground">
+					Command-line interface for creating, building, and validating contract
+					specifications with AI-powered code generation.
+				</p>
+			</div>
 
-      <div className="space-y-6">
-        <div className="space-y-3">
-          <h2 className="text-2xl font-bold">Installation</h2>
-          <InstallCommand package="contractspec" dev />
-        </div>
+			<div className="space-y-6">
+				<div className="space-y-3">
+					<h2 className="font-bold text-2xl">Installation</h2>
+					<InstallCommand package="contractspec" dev />
+				</div>
 
-        <div className="space-y-3">
-          <h2 className="text-2xl font-bold">Quick Start</h2>
-          <CodeBlock
-            language="bash"
-            code={`# Initialize project
+				<div className="space-y-3">
+					<h2 className="font-bold text-2xl">Quick Start</h2>
+					<CodeBlock
+						language="bash"
+						code={`# Initialize project
 bunx contractspec init
 
 # Create a spec
@@ -83,92 +83,92 @@ contractspec build src/contracts/mySpec.ts
 
 # Validate
 contractspec validate src/contracts/mySpec.ts`}
-          />
-        </div>
+					/>
+				</div>
 
-        <div className="space-y-4">
-          <h2 className="text-2xl font-bold">Commands</h2>
-          <div className="grid gap-4">
-            {commands.map((cmd) => (
-              <div key={cmd.name} className="card-subtle space-y-2 p-4">
-                <h3 className="font-mono font-bold text-violet-400">
-                  {cmd.name}
-                </h3>
-                <p className="text-muted-foreground text-sm">
-                  {cmd.description}
-                </p>
-                <CodeBlock
-                  language="bash"
-                  code={cmd.usage}
-                  showCopyButton={false}
-                />
-              </div>
-            ))}
-          </div>
-        </div>
+				<div className="space-y-4">
+					<h2 className="font-bold text-2xl">Commands</h2>
+					<div className="grid gap-4">
+						{commands.map((cmd) => (
+							<div key={cmd.name} className="card-subtle space-y-2 p-4">
+								<h3 className="font-bold font-mono text-violet-400">
+									{cmd.name}
+								</h3>
+								<p className="text-muted-foreground text-sm">
+									{cmd.description}
+								</p>
+								<CodeBlock
+									language="bash"
+									code={cmd.usage}
+									showCopyButton={false}
+								/>
+							</div>
+						))}
+					</div>
+				</div>
 
-        <div className="space-y-3">
-          <h2 className="text-2xl font-bold">AI Agent Modes</h2>
-          <p className="text-muted-foreground">
-            The CLI supports multiple AI agent modes for different use cases:
-          </p>
-          <div className="grid gap-3 md:grid-cols-2">
-            <div className="card-subtle p-4">
-              <h4 className="font-bold">simple</h4>
-              <p className="text-muted-foreground text-sm">
-                Direct LLM API calls, fast and straightforward. Best for rapid
-                prototyping.
-              </p>
-            </div>
-            <div className="card-subtle p-4">
-              <h4 className="font-bold">claude-code</h4>
-              <p className="text-muted-foreground text-sm">
-                Extended thinking with Claude. Best for production-quality code.
-              </p>
-            </div>
-            <div className="card-subtle p-4">
-              <h4 className="font-bold">openai-codex</h4>
-              <p className="text-muted-foreground text-sm">
-                GPT-4o/o1 models. Excellent for algorithms and optimization.
-              </p>
-            </div>
-            <div className="card-subtle p-4">
-              <h4 className="font-bold">cursor</h4>
-              <p className="text-muted-foreground text-sm">
-                Leverages Cursor agentic capabilities. Requires Cursor
-                environment.
-              </p>
-            </div>
-          </div>
-        </div>
+				<div className="space-y-3">
+					<h2 className="font-bold text-2xl">AI Agent Modes</h2>
+					<p className="text-muted-foreground">
+						The CLI supports multiple AI agent modes for different use cases:
+					</p>
+					<div className="grid gap-3 md:grid-cols-2">
+						<div className="card-subtle p-4">
+							<h4 className="font-bold">simple</h4>
+							<p className="text-muted-foreground text-sm">
+								Direct LLM API calls, fast and straightforward. Best for rapid
+								prototyping.
+							</p>
+						</div>
+						<div className="card-subtle p-4">
+							<h4 className="font-bold">claude-code</h4>
+							<p className="text-muted-foreground text-sm">
+								Extended thinking with Claude. Best for production-quality code.
+							</p>
+						</div>
+						<div className="card-subtle p-4">
+							<h4 className="font-bold">openai-codex</h4>
+							<p className="text-muted-foreground text-sm">
+								GPT-4o/o1 models. Excellent for algorithms and optimization.
+							</p>
+						</div>
+						<div className="card-subtle p-4">
+							<h4 className="font-bold">cursor</h4>
+							<p className="text-muted-foreground text-sm">
+								Leverages Cursor agentic capabilities. Requires Cursor
+								environment.
+							</p>
+						</div>
+					</div>
+				</div>
 
-        <div className="space-y-3">
-          <h2 className="text-2xl font-bold">CI/CD Integration</h2>
-          <p className="text-muted-foreground">
-            Run all validation checks in CI/CD with machine-readable output:
-          </p>
-          <CodeBlock
-            language="yaml"
-            filename=".github/workflows/validate.yml"
-            code={`- name: Validate Contracts
+				<div className="space-y-3">
+					<h2 className="font-bold text-2xl">CI/CD Integration</h2>
+					<p className="text-muted-foreground">
+						Run all validation checks in CI/CD with machine-readable output:
+					</p>
+					<CodeBlock
+						language="yaml"
+						filename=".github/workflows/validate.yml"
+						code={`- name: Validate Contracts
   run: contractspec ci --format sarif --output results.sarif
 
 - name: Upload SARIF
   uses: github/codeql-action/upload-sarif@v3
   with:
     sarif_file: results.sarif`}
-          />
-        </div>
+					/>
+				</div>
 
-        <div className="card-subtle space-y-4 p-6">
-          <h3 className="font-bold">Configuration</h3>
-          <p className="text-muted-foreground text-sm">
-            Create a <code>.contractsrc.json</code> file in your project root:
-          </p>
-          <CodeBlock
-            language="json"
-            filename=".contractsrc.json"
-            code={`{
+				<div className="card-subtle space-y-4 p-6">
+					<h3 className="font-bold">Configuration</h3>
+					<p className="text-muted-foreground text-sm">
+						Create a <code>.contractsrc.json</code> file in your project root:
+					</p>
+					<CodeBlock
+						language="json"
+						filename=".contractsrc.json"
+						code={`{
   "aiProvider": "claude",
   "agentMode": "claude-code",
   "outputDir": "./src",
@@ -177,18 +177,18 @@ contractspec validate src/contracts/mySpec.ts`}
     "events": "events"
   }
 }`}
-          />
-        </div>
-      </div>
+					/>
+				</div>
+			</div>
 
-      <div className="flex items-center gap-4 pt-4">
-        <Link href="/docs/getting-started/tools/vscode" className="btn-primary">
-          Next: VS Code Extension <ChevronRight size={16} />
-        </Link>
-        <Link href="/docs/getting-started/tools" className="btn-ghost">
-          Back to Tools
-        </Link>
-      </div>
-    </div>
-  );
+			<div className="flex items-center gap-4 pt-4">
+				<Link href="/docs/getting-started/tools/vscode" className="btn-primary">
+					Next: VS Code Extension <ChevronRight size={16} />
+				</Link>
+				<Link href="/docs/getting-started/tools" className="btn-ghost">
+					Back to Tools
+				</Link>
+			</div>
+		</div>
+	);
 }