@contractspec/bundle.workspace 4.4.0 → 4.5.1

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

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

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

@@ -5,6 +5,7 @@
  */
 export { formatChangelogJson, formatConventionalChangelog, formatKeepAChangelog, } from './changelog-formatter';
 export * from './conventional-commits';
+export { prepareReleaseAuthoring, saveReleaseDraft, } from './release-authoring';
 export * from './release-formatters';
 export { buildReleaseArtifacts, checkReleaseArtifacts, initReleaseArtifacts, } from './release-service';
 export * from './release-service.types';

package/dist/services/versioning/release-authoring.d.ts

@@ -0,0 +1,14 @@
+import type { AiAdapter } from '../../ports/ai';
+import type { FsAdapter } from '../../ports/fs';
+import type { GitAdapter } from '../../ports/git';
+import type { LoggerAdapter } from '../../ports/logger';
+import type { ReleaseAuthoringOptions, ReleaseAuthoringResult, SaveReleaseDraftOptions, SaveReleaseDraftResult } from './release-service.types';
+interface ReleaseAuthoringAdapters {
+    fs: FsAdapter;
+    git: GitAdapter;
+    logger: LoggerAdapter;
+    ai?: AiAdapter;
+}
+export declare function prepareReleaseAuthoring(adapters: ReleaseAuthoringAdapters, options?: ReleaseAuthoringOptions): Promise<ReleaseAuthoringResult>;
+export declare function saveReleaseDraft(adapters: ReleaseAuthoringAdapters, options: SaveReleaseDraftOptions): Promise<SaveReleaseDraftResult>;
+export {};

package/dist/services/versioning/release-authoring.test.d.ts

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

package/dist/services/versioning/release-files.d.ts

@@ -1,5 +1,6 @@
 import type { ReleaseCapsule, ReleaseCapsulePackage } from '@contractspec/lib.contracts-spec';
 import type { FsAdapter } from '../../ports/fs';
+import type { ReleaseCapsuleReadIssue } from './release-service.types';
 export interface WorkspacePackageInfo {
     name: string;
     dir: string;
@@ -10,10 +11,16 @@ export interface ParsedChangesetFile {
     summary: string;
     packages: ReleaseCapsulePackage[];
 }
+export interface ReadReleaseCapsulesResult {
+    capsules: Map<string, ReleaseCapsule>;
+    issues: ReleaseCapsuleReadIssue[];
+}
 export declare function listChangesetFiles(fs: FsAdapter, workspaceRoot: string): Promise<string[]>;
 export declare function readChangesets(fs: FsAdapter, workspaceRoot: string): Promise<ParsedChangesetFile[]>;
 export declare function readReleaseCapsules(fs: FsAdapter, workspaceRoot: string, changesets: ParsedChangesetFile[]): Promise<Map<string, ReleaseCapsule>>;
+export declare function readReleaseCapsulesDetailed(fs: FsAdapter, workspaceRoot: string, changesets: ParsedChangesetFile[]): Promise<ReadReleaseCapsulesResult>;
 export declare function discoverWorkspacePackages(fs: FsAdapter, workspaceRoot: string): Promise<WorkspacePackageInfo[]>;
 export declare function matchChangedFilesToPackages(changedFiles: string[], packages: WorkspacePackageInfo[]): string[];
 export declare function renderChangesetMarkdown(summary: string, packages: ReleaseCapsulePackage[]): string;
 export declare function renderReleaseCapsuleYaml(capsule: ReleaseCapsule): string;
+export declare function formatReleaseCapsuleReadIssues(issues: ReleaseCapsuleReadIssue[]): string;

package/dist/services/versioning/release-service.types.d.ts

@@ -1,4 +1,4 @@
-import type { AgentTarget, GeneratedReleaseManifest, ReleaseCapsulePackage, UpgradePlan, VersionBumpType } from '@contractspec/lib.contracts-spec';
+import type { AgentTarget, GeneratedReleaseManifest, MigrationInstruction, ReleaseCapsulePackage, ReleaseCapsuleValidation, ReleaseImpactAudience, UpgradePlan, UpgradePlanStep, VersionBumpType } from '@contractspec/lib.contracts-spec';
 export interface ReleaseInitOptions {
     workspaceRoot?: string;
     baseline?: string;
@@ -36,6 +36,58 @@ export interface ReleaseBuildResult {
     upgradePlan: UpgradePlan;
     releasesBuilt: number;
 }
+export interface ReleaseCapsuleReadIssue {
+    slug: string;
+    filePath: string;
+    message: string;
+    line?: number;
+    column?: number;
+    suggestion?: string;
+}
+export interface ReleaseAuthoringDraft {
+    slug: string;
+    summary: string;
+    releaseType: VersionBumpType;
+    isBreaking: boolean;
+    packages: ReleaseCapsulePackage[];
+    affectedRuntimes: string[];
+    affectedFrameworks: string[];
+    audiences: ReleaseImpactAudience[];
+    deprecations: string[];
+    migrationInstructions: MigrationInstruction[];
+    upgradeSteps: UpgradePlanStep[];
+    validation: ReleaseCapsuleValidation;
+}
+export interface ReleaseAuthoringOptions {
+    workspaceRoot?: string;
+    baseline?: string;
+    slug?: string;
+    summary?: string;
+    releaseType?: VersionBumpType;
+    packages?: string[];
+}
+export interface ReleaseAuthoringResult {
+    workspaceRoot: string;
+    source: 'created' | 'existing';
+    changesetPath: string;
+    capsulePath: string;
+    draft: ReleaseAuthoringDraft;
+    warnings: string[];
+    parseIssues: ReleaseCapsuleReadIssue[];
+    aiAssisted: boolean;
+}
+export interface SaveReleaseDraftOptions {
+    workspaceRoot?: string;
+    draft: ReleaseAuthoringDraft;
+    force?: boolean;
+}
+export interface SaveReleaseDraftResult {
+    source: 'created' | 'updated';
+    changesetPath: string;
+    capsulePath: string;
+    changesetContent: string;
+    capsuleContent: string;
+}
 export interface ReleaseCheckOptions {
     workspaceRoot?: string;
     baseline?: string;

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

@@ -40,10 +40,13 @@ export interface ExtendedWorkspaceInfo extends WorkspaceInfo {
      */
     packageConfigPath?: string;
 }
+export interface WorkspaceInfoDeps {
+    getWorkspaceInfo?: typeof getWorkspaceInfo;
+}
 /**
  * Get extended workspace information including config paths.
  */
-export declare function getExtendedWorkspaceInfo(fs: FsAdapter, startDir?: string): Promise<ExtendedWorkspaceInfo>;
+export declare function getExtendedWorkspaceInfo(fs: FsAdapter, startDir?: string, deps?: WorkspaceInfoDeps): Promise<ExtendedWorkspaceInfo>;
 /**
  * Find all .contractsrc.json files in a monorepo.
  *

package/dist/templates/additional-contracts.template.d.ts

@@ -0,0 +1,40 @@
+type Stability = 'experimental' | 'beta' | 'stable' | 'deprecated';
+interface BaseTemplateData {
+    key: string;
+    version: string;
+    description: string;
+    owners: string[];
+    tags: string[];
+    stability: Stability;
+    title?: string;
+    domain?: string;
+}
+export interface CapabilitySpecTemplateData extends BaseTemplateData {
+    kind?: 'api' | 'event' | 'data' | 'ui' | 'integration';
+}
+export interface PolicySpecTemplateData extends BaseTemplateData {
+    scope?: 'global' | 'feature' | 'operation';
+}
+export interface TestSpecTemplateData extends BaseTemplateData {
+    targetType: 'operation' | 'workflow';
+    targetKey: string;
+    targetVersion?: string;
+}
+export interface TranslationSpecTemplateData extends BaseTemplateData {
+    locale: string;
+    fallback?: string;
+}
+export interface JobSpecTemplateData extends BaseTemplateData {
+    intervalMs?: number;
+}
+export interface VisualizationSpecTemplateData extends BaseTemplateData {
+    sourceOperationKey: string;
+    sourceOperationVersion?: string;
+}
+export declare function generateCapabilitySpec(data: CapabilitySpecTemplateData): string;
+export declare function generatePolicySpec(data: PolicySpecTemplateData): string;
+export declare function generateTestSpec(data: TestSpecTemplateData): string;
+export declare function generateTranslationSpec(data: TranslationSpecTemplateData): string;
+export declare function generateJobSpec(data: JobSpecTemplateData): string;
+export declare function generateVisualizationSpec(data: VisualizationSpecTemplateData): string;
+export {};

package/dist/templates/advanced-contracts.template.d.ts

@@ -0,0 +1,39 @@
+type Stability = 'experimental' | 'beta' | 'stable' | 'deprecated';
+interface BaseTemplateData {
+    key: string;
+    version: string;
+    description: string;
+    owners: string[];
+    tags: string[];
+    stability: Stability;
+    title?: string;
+    domain?: string;
+}
+export interface ExampleSpecTemplateData extends BaseTemplateData {
+    packageName?: string;
+}
+export interface AgentSpecTemplateData {
+    key: string;
+    version: string;
+    description: string;
+    owners: string[];
+    tags: string[];
+    stability: Stability;
+    instructions: string;
+}
+export interface ProductIntentSpecTemplateData extends BaseTemplateData {
+    id?: string;
+    question: string;
+}
+export interface HarnessScenarioSpecTemplateData extends BaseTemplateData {
+}
+export interface HarnessSuiteSpecTemplateData extends BaseTemplateData {
+    scenarioKey: string;
+    scenarioVersion?: string;
+}
+export declare function generateExampleSpec(data: ExampleSpecTemplateData): string;
+export declare function generateAgentSpec(data: AgentSpecTemplateData): string;
+export declare function generateProductIntentSpec(data: ProductIntentSpecTemplateData): string;
+export declare function generateHarnessScenarioSpec(data: HarnessScenarioSpecTemplateData): string;
+export declare function generateHarnessSuiteSpec(data: HarnessSuiteSpecTemplateData): string;
+export {};

package/dist/templates/index.d.ts

@@ -1,6 +1,8 @@
 /**
  * Spec templates for generation.
  */
+export * from './additional-contracts.template';
+export * from './advanced-contracts.template';
 export * from './app-config.template';
 export * from './data-view.template';
 export * from './data-view-renderer.template';
@@ -15,6 +17,7 @@ export * from './migration.template';
 export * from './operation.template';
 export * from './presentation.template';
 export * from './telemetry.template';
+export * from './theme.template';
 export * from './workflow.template';
 export * from './workflow-devkit.template';
 export * from './workflow-runner.template';

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

@@ -0,0 +1,12 @@
+export interface ThemeSpecParams {
+    key: string;
+    version: string;
+    title: string;
+    description: string;
+    domain: string;
+    owners: string[];
+    tags: string[];
+    stability: 'experimental' | 'beta' | 'stable' | 'deprecated';
+    scopes: Array<'global' | 'tenant' | 'user'>;
+}
+export declare function generateThemeSpec(params: ThemeSpecParams): string;

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

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

package/dist/types.d.ts

@@ -1,4 +1,3 @@
-export type SpecType = 'operation' | 'event' | 'presentation' | 'form' | 'feature' | 'workflow' | 'data-view' | 'migration' | 'telemetry' | 'experiment' | 'app-config' | 'integration' | 'knowledge';
 export type OpKind = 'command' | 'query';
 export type PresentationKind = 'web_component' | 'markdown' | 'data';
 export type Stability = 'experimental' | 'beta' | 'stable' | 'deprecated';
@@ -194,7 +193,7 @@ export interface ExperimentSpecData extends BaseSpecData {
 }
 export interface AppConfigMappingData {
     slot: string;
-    name: string;
+    key: string;
     version?: string;
 }
 export interface AppConfigFeatureFlagData {
@@ -208,15 +207,21 @@ export interface AppRouteConfigData {
     label?: string;
     dataView?: string;
     workflow?: string;
-    guardName?: string;
+    guardKey?: string;
     guardVersion?: string;
     featureFlag?: string;
-    experimentName?: string;
+    experimentKey?: string;
     experimentVersion?: string;
 }
-export interface AppBlueprintSpecData extends BaseSpecData {
+export interface AppBlueprintSpecData {
+    key: string;
+    version: string;
     title: string;
+    description: string;
     domain: string;
+    owners: string[];
+    tags: string[];
+    stability: Stability;
     appId: string;
     capabilitiesEnabled: string[];
     capabilitiesDisabled: string[];
@@ -225,27 +230,27 @@ export interface AppBlueprintSpecData extends BaseSpecData {
     dataViews: AppConfigMappingData[];
     workflows: AppConfigMappingData[];
     policyRefs: {
-        name: string;
+        key: string;
         version?: string;
     }[];
     theme?: {
-        name: string;
+        key: string;
         version: string;
     };
     themeFallbacks: {
-        name: string;
+        key: string;
         version: string;
     }[];
     telemetry?: {
-        name: string;
+        key: string;
         version?: string;
     };
     activeExperiments: {
-        name: string;
+        key: string;
         version?: string;
     }[];
     pausedExperiments: {
-        name: string;
+        key: string;
         version?: string;
     }[];
     featureFlags: AppConfigFeatureFlagData[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.workspace",
-  "version": "4.4.0",
+  "version": "4.5.1",
   "description": "Workspace utilities for monorepo development",
   "keywords": [
     "contractspec",
@@ -33,16 +33,17 @@
   "dependencies": {
     "@ai-sdk/anthropic": "3.0.68",
     "@ai-sdk/openai": "3.0.52",
-    "@contractspec/biome-config": "3.8.7",
-    "@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.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",
+    "@contractspec/biome-config": "3.8.8",
+    "@contractspec/integration.runtime": "3.9.3",
+    "@contractspec/lib.ai-agent": "8.0.9",
+    "@contractspec/lib.ai-providers": "3.7.14",
+    "@contractspec/lib.contracts-spec": "5.5.0",
+    "@contractspec/lib.contracts-integrations": "3.8.13",
+    "@contractspec/lib.contracts-transformers": "3.7.21",
+    "@contractspec/lib.surface-runtime": "0.5.21",
+    "@contractspec/lib.source-extractors": "2.7.21",
+    "@contractspec/module.workspace": "4.3.1",
+    "@contractspec/lib.utils-typescript": "3.7.14",
     "ai": "6.0.156",
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
@@ -56,11 +57,11 @@
   },
   "devDependencies": {
     "@contractspec/tool.typescript": "3.7.13",
-    "@types/bun": "^1.3.11",
+    "@types/bun": "^1.3.12",
     "@types/micromatch": "^4.0.10",
     "@types/node": "^25.6.0",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.14"
+    "@contractspec/tool.bun": "3.7.15"
   },
   "exports": {
     ".": {