@contractspec/bundle.workspace 4.3.0 → 4.4.0

package/dist/services/build.d.ts

@@ -11,7 +11,7 @@ import type { LoggerAdapter } from '../ports/logger';
 /**
  * Build target types.
  */
-export type BuildTarget = 'handler' | 'component' | 'test';
+export type BuildTarget = 'handler' | 'component' | 'test' | 'form' | 'workflow-runner' | 'data-view-renderer' | 'package-scaffold';
 /**
  * Options for building from a spec.
  */
@@ -32,6 +32,33 @@ export interface BuildSpecOptions {
      * Skip writing files (dry run).
      */
     dryRun?: boolean;
+    /**
+     * Include target-specific test artifacts in the default build plan.
+     */
+    includeTests?: boolean;
+    /**
+     * Optional runtime generation strategy supplied by higher-level callers.
+     */
+    runtimeGeneration?: RuntimeGenerationStrategy;
+}
+export type RuntimeArtifactKind = 'handler' | 'component' | 'form';
+export type RuntimeTestKind = 'handler' | 'component';
+export interface RuntimeArtifactGenerationInput {
+    kind: RuntimeArtifactKind;
+    specCode: string;
+    outputPath: string;
+    fallbackCode: string;
+}
+export interface RuntimeTestGenerationInput {
+    kind: RuntimeTestKind;
+    specCode: string;
+    outputPath: string;
+    existingCode: string;
+    fallbackCode: string;
+}
+export interface RuntimeGenerationStrategy {
+    generateArtifact?: (input: RuntimeArtifactGenerationInput) => Promise<string | null | undefined>;
+    generateTest?: (input: RuntimeTestGenerationInput) => Promise<string | null | undefined>;
 }
 /**
  * Result of a single build target.
@@ -42,6 +69,7 @@ export interface BuildTargetResult {
     success: boolean;
     skipped?: boolean;
     error?: string;
+    generatedCode?: string;
 }
 /**
  * Result of building from a spec.
@@ -49,6 +77,7 @@ export interface BuildTargetResult {
 export interface BuildSpecResult {
     specPath: string;
     specInfo: SpecScanResult;
+    targetId: string;
     results: BuildTargetResult[];
 }
 /**
@@ -59,3 +88,9 @@ export declare function buildSpec(specPath: string, adapters: {
     logger: LoggerAdapter;
     workspace?: typeof import('@contractspec/module.workspace');
 }, config: ResolvedContractsrcConfig, options?: BuildSpecOptions): Promise<BuildSpecResult>;
+/**
+ * Detect default targets based on spec type.
+ */
+export declare function resolveDefaultBuildTargets(targetId: string, options: {
+    includeTests: boolean;
+}): BuildTarget[];

package/dist/services/connect/init.d.ts

@@ -1,7 +1,3 @@
 import type { FsAdapter } from '../../ports/fs';
-import type { ConnectInitInput } from './types';
-export declare function initConnectWorkspace(fs: FsAdapter, input?: ConnectInitInput): Promise<{
-    configPath: string;
-    targetRoot: string;
-    action: 'created' | 'merged';
-}>;
+import type { ConnectInitInput, ConnectInitResult } from './types';
+export declare function initConnectWorkspace(fs: FsAdapter, input?: ConnectInitInput): Promise<ConnectInitResult>;

package/dist/services/connect/types.d.ts

@@ -1,4 +1,5 @@
 import type { ConnectVerdict, ResolvedContractsrcConfig } from '@contractspec/lib.contracts-spec/workspace-config';
+import type { SetupFileResult, SetupGitignoreBehavior, SetupPromptCallbacks } from '../setup/types';
 export type { ConnectVerdict };
 export type ConnectActorType = 'human' | 'agent' | 'service' | 'tool';
 export type ConnectApprovalStatus = 'not_required' | 'pending' | 'approved' | 'rejected' | 'expired';
@@ -33,6 +34,15 @@ export interface ConnectWorkspaceInput {
 }
 export interface ConnectInitInput extends ConnectWorkspaceInput {
     scope?: 'workspace' | 'package';
+    interactive?: boolean;
+    gitignoreBehavior?: SetupGitignoreBehavior;
+    prompts?: Pick<SetupPromptCallbacks, 'confirm'>;
+}
+export interface ConnectInitResult {
+    configPath: string;
+    targetRoot: string;
+    action: 'created' | 'merged';
+    gitignore: SetupFileResult;
 }
 export interface ConnectTaskInput extends ConnectWorkspaceInput {
     taskId: string;

package/dist/services/contractsrc-schema-ref.d.ts

@@ -0,0 +1,4 @@
+export declare function getBundledContractsrcSchemaRef(options: {
+    configRoot: string;
+    workspaceRoot: string;
+}): string;

package/dist/services/deps.d.ts

@@ -2,6 +2,7 @@
  * Dependency analysis service.
  */
 import { type ContractGraph, type ContractNode } from '@contractspec/module.workspace';
+import type { ResolvedContractsrcConfig } from '@contractspec/lib.contracts-spec';
 import type { FsAdapter } from '../ports/fs';
 /**
  * Options for dependency analysis.
@@ -11,6 +12,7 @@ export interface AnalyzeDepsOptions {
      * File pattern to search.
      */
     pattern?: string;
+    config?: ResolvedContractsrcConfig;
 }
 /**
  * Result of dependency analysis.

package/dist/services/discover.d.ts

@@ -0,0 +1,15 @@
+import type { ResolvedContractsrcConfig } from '@contractspec/lib.contracts-spec';
+import type { MaybeArray } from '@contractspec/lib.utils-typescript';
+import { type SpecScanResult } from '@contractspec/module.workspace';
+import type { FsAdapter } from '../ports/fs';
+export interface DiscoverSpecsOptions {
+    pattern?: string;
+    paths?: string[];
+    cwd?: string;
+    type?: MaybeArray<string>;
+    config?: ResolvedContractsrcConfig;
+}
+export declare function discoverSpecFiles(fs: FsAdapter, options?: DiscoverSpecsOptions): Promise<string[]>;
+export declare function discoverSpecs(adapters: {
+    fs: FsAdapter;
+}, options?: DiscoverSpecsOptions): Promise<SpecScanResult[]>;

package/dist/services/discover.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/generate-artifacts.d.ts

@@ -1,11 +1,15 @@
+import { type ResolvedContractsrcConfig } from '@contractspec/lib.contracts-spec';
 import type { WorkspaceAdapters } from '../ports/logger';
 export interface GenerateArtifactsResult {
     specsCount: number;
     docsCount: number;
+    materializedCount: number;
 }
 export interface GenerateArtifactsOptions {
     scanAllSpecs?: boolean;
     specPattern?: string;
     specSearchRoot?: string;
+    config?: ResolvedContractsrcConfig;
+    includeRuntimeTests?: boolean;
 }
 export declare function generateArtifacts(adapters: WorkspaceAdapters, contractsDir: string, generatedDir: string, rootPath?: string, options?: GenerateArtifactsOptions): Promise<GenerateArtifactsResult>;

package/dist/services/index.d.ts

@@ -13,6 +13,7 @@ export * from './create/index';
 export * from './delete';
 export * from './deps';
 export * from './diff';
+export * from './discover';
 export * from './docs/index';
 export * from './doctor/index';
 export * from './extract';
@@ -30,7 +31,9 @@ export * from './integrity-diagram';
 export * from './layer-discovery';
 export * from './list';
 export * from './llm/index';
+export * from './module-loader';
 export * from './openapi/index';
+export * from './package-scaffold';
 export * from './quickstart/index';
 export * from './regenerator';
 export * from './registry';

package/dist/services/integrity.d.ts

@@ -7,6 +7,7 @@
  * - Feature coverage metrics
  */
 import { type AnalyzedSpecType, type FeatureScanResult, type RefInfo } from '@contractspec/module.workspace';
+import type { ResolvedContractsrcConfig } from '@contractspec/lib.contracts-spec';
 import type { FsAdapter } from '../ports/fs';
 import type { LoggerAdapter } from '../ports/logger';
 import { type ExtractedTestTarget } from './test-link';
@@ -34,6 +35,7 @@ export interface IntegrityAnalysisOptions {
      * Filter by spec type.
      */
     specType?: AnalyzedSpecType;
+    config?: ResolvedContractsrcConfig;
     /**
      * Require tests for specific spec types.
      */

package/dist/services/module-loader.d.ts

@@ -0,0 +1,25 @@
+import type { FsAdapter } from '../ports/fs';
+export interface LoadedAuthoredModule {
+    modulePath: string;
+    exports: Record<string, unknown>;
+}
+export interface LoadAuthoredModuleValueOptions<T> {
+    description: string;
+    isValue: (value: unknown) => value is T;
+    instanceKeys?: string[];
+    factoryKeys?: string[];
+}
+export declare function loadAuthoredModule(modulePath: string, options?: {
+    runtime?: 'bun' | 'node';
+}): Promise<LoadedAuthoredModule>;
+export declare function loadAuthoredModuleIfExists(modulePath: string, fs: FsAdapter): Promise<LoadedAuthoredModule | null>;
+export declare function loadAuthoredModuleExports(modulePath: string, options?: {
+    runtime?: 'bun' | 'node';
+}): Promise<Record<string, unknown>>;
+export declare function loadAuthoredModuleValue<T>(modulePath: string, options: LoadAuthoredModuleValueOptions<T>): Promise<T>;
+export declare function formatModuleLoadError(modulePath: string, error: unknown): string;
+export declare function resolveAuthoredModuleValue<T>(exports: Record<string, unknown>, modulePath: string, options: LoadAuthoredModuleValueOptions<T>): Promise<T>;
+export declare const __moduleLoaderInternals: {
+    formatModuleLoadError: typeof formatModuleLoadError;
+    resolveAuthoredModuleValue: typeof resolveAuthoredModuleValue;
+};

package/dist/services/module-loader.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/package-scaffold.d.ts

@@ -0,0 +1,22 @@
+import type { AuthoringTargetId } from '@contractspec/module.workspace';
+import type { FsAdapter } from '../ports/fs';
+export interface PackageScaffoldOptions {
+    target: Extract<AuthoringTargetId, 'module-bundle' | 'builder-spec' | 'provider-spec'>;
+    specPath: string;
+    specCode: string;
+    overwrite?: boolean;
+}
+export interface PackageScaffoldResult {
+    packageRoot: string;
+    files: string[];
+    created: string[];
+    skipped: string[];
+}
+export declare function ensurePackageScaffold(fs: FsAdapter, options: PackageScaffoldOptions): Promise<PackageScaffoldResult>;
+export declare function createPackageTargetSpecSource(input: {
+    target: PackageScaffoldOptions['target'];
+    key: string;
+    title: string;
+    description: string;
+    exportName: string;
+}): string;

package/dist/services/setup/config-generators.d.ts

@@ -13,7 +13,7 @@ export declare function generateContractsrcConfig(options: SetupOptions): object
 /**
  * Generate .vscode/settings.json ContractSpec settings.
  */
-export declare function generateVscodeSettings(): object;
+export declare function generateVscodeSettings(options: SetupOptions): object;
 /**
  * Generate .cursor/mcp.json content.
  */

package/dist/services/setup/gitignore.d.ts

@@ -0,0 +1,10 @@
+import type { FsAdapter } from '../../ports/fs';
+import type { SetupFileResult, SetupGitignoreBehavior, SetupPromptCallbacks } from './types';
+export declare function setupGitignore(fs: FsAdapter, input: {
+    interactive: boolean;
+    patterns: string[];
+    root: string;
+    behavior?: SetupGitignoreBehavior;
+    prompts?: Pick<SetupPromptCallbacks, 'confirm'>;
+}): Promise<SetupFileResult>;
+export declare function mergeGitignoreContent(existingContent: string, patterns: string[]): string;

package/dist/services/setup/gitignore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/setup/index.d.ts

@@ -5,5 +5,7 @@
  */
 export * from './config-generators';
 export * from './file-merger';
+export * from './gitignore';
+export * from './presets';
 export * from './setup-service';
 export * from './types';

package/dist/services/setup/presets.d.ts

@@ -0,0 +1,16 @@
+import type { ResolvedContractsrcConfig } from '@contractspec/lib.contracts-spec/workspace-config';
+import { type SetupOptions, type SetupPreset, type SetupTarget } from './types';
+export declare const SETUP_GITIGNORE_PATTERNS: {
+    readonly connect: "**/.contractspec/connect/";
+    readonly verificationCache: "**/.contractspec/verification-cache.json";
+};
+export declare function inferSetupPresetFromConfig(config: Partial<ResolvedContractsrcConfig> | null | undefined): SetupPreset;
+export declare function resolveSetupPreset(options: Pick<SetupOptions, 'preset'>): SetupPreset;
+export declare function resolveSetupTargets(preset: SetupPreset, explicitTargets: SetupTarget[]): SetupTarget[];
+export declare function getBuilderRuntimeModeForPreset(preset: SetupPreset): 'managed' | 'local' | 'hybrid' | undefined;
+export declare function getBuilderBootstrapPresetForSetupPreset(preset: SetupPreset): 'managed_mvp' | 'local_daemon_mvp' | 'hybrid_mvp' | undefined;
+export declare function isBuilderPreset(preset: SetupPreset): boolean;
+export declare function isConnectPreset(preset: SetupPreset): boolean;
+export declare function createSetupNextSteps(options: Pick<SetupOptions, 'builderLocalGrantedTo' | 'builderLocalRuntimeId' | 'preset' | 'projectName'>): string[];
+export declare function createBuilderWorkspaceId(projectName?: string): string;
+export declare function createSetupGitignorePatterns(options: Pick<SetupOptions, 'preset'>): string[];

package/dist/services/setup/targets/cli-config.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/setup/types.d.ts

@@ -13,6 +13,11 @@ export declare const ALL_SETUP_TARGETS: SetupTarget[];
  * Human-readable labels for setup targets.
  */
 export declare const SETUP_TARGET_LABELS: Record<SetupTarget, string>;
+export type SetupPreset = 'core' | 'connect' | 'builder-managed' | 'builder-local' | 'builder-hybrid';
+export declare const ALL_SETUP_PRESETS: SetupPreset[];
+export declare const SETUP_PRESET_LABELS: Record<SetupPreset, string>;
+export declare const SETUP_PRESET_DESCRIPTIONS: Record<SetupPreset, string>;
+export type SetupGitignoreBehavior = 'auto' | 'force' | 'skip';
 /**
  * Scope of configuration in a monorepo.
  */
@@ -33,19 +38,37 @@ export interface SetupOptions {
     packageName?: string;
     /** If true, skip prompts and use defaults. */
     interactive: boolean;
+    /** High-level onboarding preset. */
+    preset?: SetupPreset;
     /** Specific targets to configure (defaults to all). */
     targets: SetupTarget[];
     /** Project name (defaults to directory name). */
     projectName?: string;
     /** Default code owners. */
     defaultOwners?: string[];
+    /** Builder API base URL for managed or hybrid presets. */
+    builderApiBaseUrl?: string;
+    /** Builder control-plane token environment variable name. */
+    builderControlPlaneTokenEnvVar?: string;
+    /** Builder local runtime target id for local or hybrid presets. */
+    builderLocalRuntimeId?: string;
+    /** Builder local runtime lease/grant target for local or hybrid presets. */
+    builderLocalGrantedTo?: string;
+    /** Builder local-capable providers for local or hybrid presets. */
+    builderLocalProviderIds?: string[];
+    /** Optional Connect Studio bridge endpoint. */
+    connectStudioEndpoint?: string;
+    /** Optional Connect Studio bridge queue. */
+    connectStudioQueue?: string;
+    /** How init should handle recommended ContractSpec .gitignore entries. */
+    gitignoreBehavior?: SetupGitignoreBehavior;
 }
 /**
  * Result of a single file setup operation.
  */
 export interface SetupFileResult {
     /** Target that was configured. */
-    target: SetupTarget;
+    target: SetupTarget | 'gitignore';
     /** File path that was created or modified. */
     filePath: string;
     /** Action taken. */
@@ -59,17 +82,28 @@ export interface SetupFileResult {
 export interface SetupResult {
     /** Whether all operations succeeded. */
     success: boolean;
+    /** Final resolved setup preset. */
+    preset: SetupPreset;
     /** Results for each file. */
     files: SetupFileResult[];
     /** Summary message. */
     summary: string;
+    /** Tailored follow-up commands for the selected preset. */
+    nextSteps: string[];
 }
 /**
  * Callback for interactive prompts during setup.
  */
 export interface SetupPromptCallbacks {
     /** Confirm an action. */
-    confirm: (message: string) => Promise<boolean>;
+    confirm: (message: string, defaultValue?: boolean) => Promise<boolean>;
+    /** Select a single option. */
+    select: <T extends string>(message: string, options: {
+        value: T;
+        label: string;
+        description?: string;
+        selected?: boolean;
+    }[]) => Promise<T>;
     /** Select multiple options. */
     multiSelect: <T extends string>(message: string, options: {
         value: T;

package/dist/services/update.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/validate/index.d.ts

@@ -1,5 +1,6 @@
 export * from './blueprint-validator';
 export * from './implementation-agent-validator';
 export * from './implementation-validator';
+export * from './package-scaffold-validator';
 export * from './spec-validator';
 export * from './tenant-validator';

package/dist/services/validate/module-loader-usage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/validate/package-scaffold-validator.d.ts

@@ -0,0 +1,8 @@
+import type { SpecScanResult } from '@contractspec/module.workspace';
+import type { FsAdapter } from '../../ports/fs';
+export interface PackageScaffoldValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare function validatePackageScaffold(spec: SpecScanResult, fs: FsAdapter): Promise<PackageScaffoldValidationResult>;

package/dist/services/validate/package-scaffold-validator.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/validate/spec-validator.d.ts

@@ -1,7 +1,7 @@
 /**
  * Validation service.
  */
-import { type ValidationResult } from '@contractspec/module.workspace';
+import { type SpecScanResult, type ValidationResult } from '@contractspec/module.workspace';
 import type { FsAdapter } from '../../ports/fs';
 import type { LoggerAdapter } from '../../ports/logger';
 /**
@@ -23,6 +23,11 @@ export interface ValidateSpecResult {
     warnings: string[];
     code?: string;
 }
+export interface DiscoveredSpecValidationResult extends ValidateSpecResult {
+    spec: SpecScanResult;
+}
+export declare function validateScannedSpec(spec: SpecScanResult, options?: ValidateSpecOptions): ValidateSpecResult;
+export declare function validateDiscoveredSpecs(specs: SpecScanResult[], options?: ValidateSpecOptions): Promise<DiscoveredSpecValidationResult[]>;
 /**
  * Validate a spec file.
  */

package/dist/services/vibe/definitions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/templates/data-view-renderer.template.d.ts

@@ -0,0 +1,6 @@
+export declare function generateDataViewRendererTemplate({ exportName, specImportPath, rendererName, viewKind, }: {
+    exportName: string;
+    specImportPath: string;
+    rendererName: string;
+    viewKind: string;
+}): string;

package/dist/templates/feature.template.d.ts

@@ -3,26 +3,27 @@
  */
 export interface FeatureSpecParams {
     key: string;
+    version: string;
     title: string;
+    domain: string;
     description?: string;
-    stability?: 'experimental' | 'alpha' | 'beta' | 'stable' | 'deprecated';
+    stability?: 'experimental' | 'beta' | 'stable' | 'deprecated';
     owners: string[];
     tags: string[];
-    display?: string;
     operations: {
-        name: string;
+        key: string;
         version: string;
     }[];
     events: {
-        name: string;
+        key: string;
         version: string;
     }[];
     presentations: {
-        name: string;
+        key: string;
         version: string;
     }[];
     experiments: {
-        name: string;
+        key: string;
         version: string;
     }[];
 }

package/dist/templates/form.template.d.ts

@@ -0,0 +1,16 @@
+export interface FormSpecParams {
+    key: string;
+    version: string;
+    title: string;
+    description?: string;
+    domain: string;
+    owners: string[];
+    tags: string[];
+    stability?: 'experimental' | 'beta' | 'stable' | 'deprecated';
+    primaryFieldKey: string;
+    primaryFieldLabel: string;
+    primaryFieldPlaceholder?: string;
+    actionKey: string;
+    actionLabel: string;
+}
+export declare function generateFormSpec(params: FormSpecParams): string;

package/dist/templates/form.template.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/templates/index.d.ts

@@ -3,9 +3,11 @@
  */
 export * from './app-config.template';
 export * from './data-view.template';
+export * from './data-view-renderer.template';
 export * from './event.template';
 export * from './experiment.template';
 export * from './feature.template';
+export * from './form.template';
 export * from './handler.template';
 export * from './integration.template';
 export * from './knowledge.template';
@@ -14,4 +16,5 @@ export * from './operation.template';
 export * from './presentation.template';
 export * from './telemetry.template';
 export * from './workflow.template';
+export * from './workflow-devkit.template';
 export * from './workflow-runner.template';

package/dist/templates/workflow-devkit.template.d.ts

@@ -0,0 +1,11 @@
+interface WorkflowDevkitTemplateOptions {
+    exportName: string;
+    specImportPath: string;
+    workflowFunctionName: string;
+}
+export declare function generateWorkflowDevkitWorkflowTemplate({ exportName, specImportPath, workflowFunctionName, }: WorkflowDevkitTemplateOptions): string;
+export declare function generateWorkflowDevkitStartRouteTemplate(workflowImportPath: string, workflowFunctionName: string): string;
+export declare function generateWorkflowDevkitFollowUpRouteTemplate(): string;
+export declare function generateWorkflowDevkitStreamRouteTemplate(): string;
+export declare function generateWorkflowDevkitGenericTemplate(workflowImportPath: string, workflowFunctionName: string): string;
+export {};

package/dist/utils/index.d.ts

@@ -1,3 +1,2 @@
 export * from './filter';
-export * from './module-loader';
 export * from './validation';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.workspace",
-  "version": "4.3.0",
+  "version": "4.4.0",
   "description": "Workspace utilities for monorepo development",
   "keywords": [
     "contractspec",
@@ -34,14 +34,14 @@
     "@ai-sdk/anthropic": "3.0.68",
     "@ai-sdk/openai": "3.0.52",
     "@contractspec/biome-config": "3.8.7",
-    "@contractspec/integration.runtime": "3.9.0",
-    "@contractspec/lib.ai-agent": "8.0.6",
+    "@contractspec/integration.runtime": "3.9.1",
+    "@contractspec/lib.ai-agent": "8.0.7",
     "@contractspec/lib.ai-providers": "3.7.13",
-    "@contractspec/lib.contracts-spec": "5.2.0",
-    "@contractspec/lib.contracts-integrations": "3.8.10",
-    "@contractspec/lib.contracts-transformers": "3.7.18",
-    "@contractspec/lib.source-extractors": "2.7.18",
-    "@contractspec/module.workspace": "4.1.5",
+    "@contractspec/lib.contracts-spec": "5.3.0",
+    "@contractspec/lib.contracts-integrations": "3.8.11",
+    "@contractspec/lib.contracts-transformers": "3.7.19",
+    "@contractspec/lib.source-extractors": "2.7.19",
+    "@contractspec/module.workspace": "4.2.0",
     "@contractspec/lib.utils-typescript": "3.7.13",
     "ai": "6.0.156",
     "chalk": "^5.6.2",

package/dist/utils/module-loader.d.ts

@@ -1 +0,0 @@
-export declare function loadTypeScriptModule(filePath: string): Promise<any>;