@contractspec/bundle.workspace 4.1.3 → 4.2.0

package/dist/services/upgrade/guided-upgrade.d.ts

@@ -0,0 +1,10 @@
+import type { GuidedUpgradeAnalysisResult, GuidedUpgradeApplyResult, UpgradeOptions } from './types';
+import type { FsAdapter } from '../../ports/fs';
+import type { LoggerAdapter } from '../../ports/logger';
+interface ServiceAdapters {
+    fs: FsAdapter;
+    logger: LoggerAdapter;
+}
+export declare function analyzeGuidedUpgrade(adapters: ServiceAdapters, options: UpgradeOptions): Promise<GuidedUpgradeAnalysisResult>;
+export declare function applyGuidedUpgrade(adapters: ServiceAdapters, options: UpgradeOptions): Promise<GuidedUpgradeApplyResult>;
+export {};

package/dist/services/upgrade/guided-upgrade.test.d.ts

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

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

@@ -5,3 +5,4 @@
  */
 export * from './types';
 export { analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand, } from './upgrade-service';
+export { analyzeGuidedUpgrade, applyGuidedUpgrade, } from './guided-upgrade';

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

@@ -3,6 +3,7 @@
  *
  * Types for upgrading ContractSpec SDK and configuration.
  */
+import type { AgentPromptBundle, AgentTarget, UpgradePlan, UpgradePlanStep } from '@contractspec/lib.contracts-spec';
 /**
  * Options for running an upgrade.
  */
@@ -17,6 +18,10 @@ export interface UpgradeOptions {
     dryRun?: boolean;
     /** Use @latest tag instead of caret range. */
     useLatest?: boolean;
+    /** Generated upgrade manifest candidate paths. */
+    manifestPaths?: string[];
+    /** Preferred agent prompt target. */
+    agentTarget?: AgentTarget;
 }
 /**
  * Result of a package upgrade check.
@@ -71,4 +76,23 @@ export interface UpgradeApplyResult {
     error?: string;
     /** Summary message. */
     summary: string;
+    /** Applied deterministic autofixes. */
+    appliedAutofixes?: string[];
+    /** Remaining non-automatic steps. */
+    remainingSteps?: UpgradePlanStep[];
+    /** Human-readable follow-up checklist. */
+    humanChecklist?: string[];
+    /** Generated agent prompt for unresolved work. */
+    promptBundle?: AgentPromptBundle;
+    /** Upgrade plan that drove the apply step. */
+    plan?: UpgradePlan;
+}
+export interface GuidedUpgradeAnalysisResult {
+    packageManager: string;
+    manifestPath?: string;
+    plan: UpgradePlan;
+    humanChecklist: string[];
+}
+export interface GuidedUpgradeApplyResult extends UpgradeApplyResult {
+    manifestPath?: string;
 }

package/dist/services/upgrade/upgrade-service.d.ts

@@ -38,4 +38,6 @@ export declare function getDefaultVersioningConfig(): Record<string, unknown>;
  * Get default hooks configuration.
  */
 export declare function getDefaultHooksConfig(): Record<string, string[]>;
+export declare function getDefaultReleaseConfig(): Record<string, unknown>;
+export declare function getDefaultUpgradeConfig(): Record<string, unknown>;
 export {};

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

@@ -5,5 +5,8 @@
  */
 export { formatChangelogJson, formatConventionalChangelog, formatKeepAChangelog, } from './changelog-formatter';
 export * from './conventional-commits';
+export * from './release-formatters';
+export * from './release-service.types';
 export * from './types';
 export { analyzeVersions, analyzeVersionsFromCommits, applyVersionBump, generateChangelogs, } from './versioning-service';
+export { buildReleaseArtifacts, checkReleaseArtifacts, initReleaseArtifacts, } from './release-service';

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

@@ -0,0 +1,19 @@
+import type { ReleaseCapsule, ReleaseCapsulePackage } from '@contractspec/lib.contracts-spec';
+import type { FsAdapter } from '../../ports/fs';
+export interface WorkspacePackageInfo {
+    name: string;
+    dir: string;
+    version: string;
+}
+export interface ParsedChangesetFile {
+    slug: string;
+    summary: string;
+    packages: ReleaseCapsulePackage[];
+}
+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 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;

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

@@ -0,0 +1,8 @@
+import type { AgentTarget, GeneratedReleaseManifest, GeneratedReleaseManifestEntry, UpgradePlan } from '@contractspec/lib.contracts-spec';
+export declare function renderMaintainerSummary(entry: GeneratedReleaseManifestEntry): string;
+export declare function renderCustomerPatchNote(entry: GeneratedReleaseManifestEntry): string;
+export declare function renderMigrationGuide(entry: GeneratedReleaseManifestEntry): string;
+export declare function renderPatchNotes(manifest: GeneratedReleaseManifest): string;
+export declare function renderCustomerGuide(manifest: GeneratedReleaseManifest): string;
+export declare function renderUpgradeChecklist(plan: UpgradePlan): string;
+export declare function renderUpgradePrompt(agent: AgentTarget, plan: UpgradePlan): string;

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

@@ -0,0 +1,7 @@
+import { type AgentTarget, type GeneratedReleaseManifest, type GeneratedReleaseManifestEntry, type UpgradePlan } from '@contractspec/lib.contracts-spec';
+export interface InstalledPackageVersion {
+    name: string;
+    currentVersion?: string;
+}
+export declare function selectUpgradeReleases(manifest: GeneratedReleaseManifest, packages: InstalledPackageVersion[]): GeneratedReleaseManifestEntry[];
+export declare function createUpgradePlan(manifest: GeneratedReleaseManifest, packages: InstalledPackageVersion[], agentTargets: AgentTarget[], renderPrompt: (agent: AgentTarget, plan: UpgradePlan) => string): UpgradePlan;

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

@@ -0,0 +1,13 @@
+import type { FsAdapter } from '../../ports/fs';
+import type { GitAdapter } from '../../ports/git';
+import type { LoggerAdapter } from '../../ports/logger';
+import type { ReleaseBuildOptions, ReleaseBuildResult, ReleaseCheckOptions, ReleaseCheckResult, ReleaseInitOptions, ReleaseInitResult } from './release-service.types';
+interface ServiceAdapters {
+    fs: FsAdapter;
+    git: GitAdapter;
+    logger: LoggerAdapter;
+}
+export declare function initReleaseArtifacts(adapters: ServiceAdapters, options?: ReleaseInitOptions): Promise<ReleaseInitResult>;
+export declare function buildReleaseArtifacts(adapters: ServiceAdapters, options?: ReleaseBuildOptions): Promise<ReleaseBuildResult>;
+export declare function checkReleaseArtifacts(adapters: ServiceAdapters, options?: ReleaseCheckOptions): Promise<ReleaseCheckResult>;
+export {};

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

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

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

@@ -0,0 +1,55 @@
+import type { AgentTarget, GeneratedReleaseManifest, ReleaseCapsulePackage, UpgradePlan, VersionBumpType } from '@contractspec/lib.contracts-spec';
+export interface ReleaseInitOptions {
+    workspaceRoot?: string;
+    baseline?: string;
+    slug?: string;
+    summary?: string;
+    releaseType?: VersionBumpType;
+    packages?: string[];
+    dryRun?: boolean;
+    force?: boolean;
+}
+export interface ReleaseInitResult {
+    slug: string;
+    changesetPath: string;
+    capsulePath: string;
+    changesetContent: string;
+    capsuleContent: string;
+    packages: ReleaseCapsulePackage[];
+    releaseType: VersionBumpType;
+    isBreaking: boolean;
+}
+export interface ReleaseBuildOptions {
+    workspaceRoot?: string;
+    outputDir?: string;
+    dryRun?: boolean;
+    agentTargets?: AgentTarget[];
+}
+export interface ReleaseBuildResult {
+    outputDir: string;
+    manifestPath: string;
+    upgradeManifestPath: string;
+    patchNotesPath: string;
+    customerGuidePath: string;
+    promptPaths: Record<string, string>;
+    manifest: GeneratedReleaseManifest;
+    upgradePlan: UpgradePlan;
+    releasesBuilt: number;
+}
+export interface ReleaseCheckOptions {
+    workspaceRoot?: string;
+    baseline?: string;
+    outputDir?: string;
+    strict?: boolean;
+}
+export interface ReleaseCheckStatus {
+    name: string;
+    ok: boolean;
+    message: string;
+}
+export interface ReleaseCheckResult {
+    success: boolean;
+    errors: string[];
+    warnings: string[];
+    checks: ReleaseCheckStatus[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.workspace",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "Workspace utilities for monorepo development",
   "keywords": [
     "contractspec",
@@ -18,7 +18,7 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build": "bun run build:bundle && bun run build:types",
     "build:bundle": "contractspec-bun-build transpile",
     "build:types": "contractspec-bun-build types",
     "dev": "contractspec-bun-build dev",
@@ -33,15 +33,15 @@
   "dependencies": {
     "@ai-sdk/anthropic": "3.0.64",
     "@ai-sdk/openai": "3.0.48",
-    "@contractspec/biome-config": "3.8.5",
-    "@contractspec/lib.ai-agent": "8.0.3",
-    "@contractspec/lib.ai-providers": "3.7.11",
-    "@contractspec/lib.contracts-spec": "5.0.3",
-    "@contractspec/lib.contracts-integrations": "3.8.7",
-    "@contractspec/lib.contracts-transformers": "3.7.15",
-    "@contractspec/lib.source-extractors": "2.7.15",
-    "@contractspec/module.workspace": "4.1.2",
-    "@contractspec/lib.utils-typescript": "3.7.11",
+    "@contractspec/biome-config": "3.8.7",
+    "@contractspec/lib.ai-agent": "8.0.5",
+    "@contractspec/lib.ai-providers": "3.7.13",
+    "@contractspec/lib.contracts-spec": "5.1.0",
+    "@contractspec/lib.contracts-integrations": "3.8.9",
+    "@contractspec/lib.contracts-transformers": "3.7.17",
+    "@contractspec/lib.source-extractors": "2.7.17",
+    "@contractspec/module.workspace": "4.1.4",
+    "@contractspec/lib.utils-typescript": "3.7.13",
     "ai": "6.0.138",
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
@@ -54,12 +54,12 @@
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.11",
+    "@contractspec/tool.typescript": "3.7.13",
     "@types/bun": "^1.3.11",
     "@types/micromatch": "^4.0.10",
     "@types/node": "^25.3.5",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.11"
+    "@contractspec/tool.bun": "3.7.13"
   },
   "exports": {
     ".": {