@kb-labs/release-manager-contracts 0.6.0

package/dist/index.js

@@ -0,0 +1,573 @@
+import { z } from 'zod';
+
+// src/version.ts
+var contractsSchemaId = "kb.plugin.contracts/1";
+var contractsVersion = "1.0.0";
+
+// src/contract.ts
+var pluginContractsManifest = {
+  schema: contractsSchemaId,
+  pluginId: "@kb-labs/release-manager",
+  contractsVersion,
+  artifacts: {
+    "release.plan.json": {
+      id: "release.plan.json",
+      kind: "json",
+      description: "Serialized release plan generated by `kb release plan`.",
+      pathPattern: ".kb/release/plan.json",
+      mediaType: "application/json"
+    },
+    "release.report.json": {
+      id: "release.report.json",
+      kind: "json",
+      description: "Execution report emitted by `kb release run`.",
+      pathPattern: ".kb/release/report.json",
+      mediaType: "application/json"
+    },
+    "release.changelog.md": {
+      id: "release.changelog.md",
+      kind: "markdown",
+      description: "Workspace changelog output produced during release.",
+      pathPattern: ".kb/release/changelog.md",
+      mediaType: "text/markdown"
+    }
+  },
+  commands: {
+    "release:plan": {
+      id: "release:plan",
+      description: "Analyze changes and prepare release plan",
+      examples: [
+        "kb release plan",
+        "kb release plan --scope packages/*",
+        "kb release plan --bump minor",
+        "kb release plan --json"
+      ]
+    },
+    "release:run": {
+      id: "release:run",
+      description: "Execute release process (plan, check, publish)",
+      examples: [
+        "kb release run",
+        "kb release run --scope packages/*",
+        "kb release run --dry-run",
+        "kb release run --strict"
+      ]
+    },
+    "release:rollback": {
+      id: "release:rollback",
+      description: "Rollback last release",
+      examples: ["kb release rollback"]
+    },
+    "release:report": {
+      id: "release:report",
+      description: "Show release report",
+      examples: ["kb release report"]
+    },
+    "release:changelog": {
+      id: "release:changelog",
+      description: "Generate changelog",
+      examples: ["kb release changelog"]
+    },
+    "release:preview": {
+      id: "release:preview",
+      description: "Preview release plan without executing",
+      examples: [
+        "kb release preview",
+        "kb release preview --scope packages/*"
+      ]
+    },
+    "release:verify": {
+      id: "release:verify",
+      description: "Verify release readiness (checks, tests, etc.)",
+      examples: [
+        "kb release verify",
+        "kb release verify --scope packages/*"
+      ]
+    }
+  }
+};
+
+// src/routes.ts
+var RELEASE_BASE_PATH = "/v1/plugins/release";
+var RELEASE_ROUTES = {
+  // === Scopes (аналогично commit-plugin) ===
+  /** GET /scopes - List available scopes (packages/repos) */
+  SCOPES: "/scopes",
+  // === Status ===
+  /** GET /status - Get current status */
+  STATUS: "/status",
+  // === Plan ===
+  /** GET /plan - Get current release plan */
+  PLAN: "/plan",
+  /** POST /generate - Generate new release plan */
+  GENERATE: "/generate",
+  /** DELETE /plan - Delete current plan */
+  RESET: "/plan",
+  // === Preview ===
+  /** GET /preview - Preview release plan without changes */
+  PREVIEW: "/preview",
+  // === Verify ===
+  /** GET /verify - Validate release readiness */
+  VERIFY: "/verify",
+  // === Changelog ===
+  /** GET /changelog - Get current changelog */
+  CHANGELOG: "/changelog",
+  /** POST /changelog/generate - Generate changelog using AI */
+  CHANGELOG_GENERATE: "/changelog/generate",
+  /** POST /changelog/save - Save edited changelog */
+  CHANGELOG_SAVE: "/changelog/save",
+  // === Release ===
+  /** POST /run - Execute full release process */
+  RUN: "/run",
+  /** POST /publish - Publish packages to npm */
+  PUBLISH: "/publish",
+  /** POST /rollback - Rollback last release */
+  ROLLBACK: "/rollback",
+  // === Report ===
+  /** GET /report - Get latest release report */
+  REPORT: "/report",
+  // === History ===
+  /** GET /history - List all releases (supports ?scope= filter) */
+  HISTORY: "/history",
+  /** GET /history/:scope/:id/report - Get specific release report */
+  HISTORY_REPORT: "/history/:scope/:id/report",
+  /** GET /history/:scope/:id/plan - Get specific release plan */
+  HISTORY_PLAN: "/history/:scope/:id/plan",
+  /** GET /history/:scope/:id/changelog - Get specific release changelog */
+  HISTORY_CHANGELOG: "/history/:scope/:id/changelog",
+  // === Git Timeline ===
+  /** GET /git-timeline - Get git commit timeline and version preview */
+  GIT_TIMELINE: "/git-timeline",
+  // === Build ===
+  /** POST /build - Trigger package build */
+  BUILD: "/build",
+  // === Checklist ===
+  /** GET /checklist - Get unified release checklist status */
+  CHECKLIST: "/checklist",
+  // === Pre-release Checks ===
+  /** GET /checks - Get list of configured checks (without running them) */
+  CHECKS: "/checks",
+  /** POST /checks/run - Run pre-release checks from kb.config.json */
+  CHECKS_RUN: "/checks/run"
+};
+var RELEASE_FULL_ROUTES = {
+  SCOPES: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.SCOPES}`,
+  STATUS: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.STATUS}`,
+  PLAN: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.PLAN}`,
+  GENERATE: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.GENERATE}`,
+  RESET: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.RESET}`,
+  PREVIEW: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.PREVIEW}`,
+  VERIFY: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.VERIFY}`,
+  CHANGELOG: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.CHANGELOG}`,
+  CHANGELOG_GENERATE: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.CHANGELOG_GENERATE}`,
+  CHANGELOG_SAVE: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.CHANGELOG_SAVE}`,
+  RUN: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.RUN}`,
+  PUBLISH: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.PUBLISH}`,
+  ROLLBACK: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.ROLLBACK}`,
+  REPORT: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.REPORT}`,
+  HISTORY: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.HISTORY}`,
+  HISTORY_REPORT: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.HISTORY_REPORT}`,
+  HISTORY_PLAN: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.HISTORY_PLAN}`,
+  HISTORY_CHANGELOG: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.HISTORY_CHANGELOG}`,
+  GIT_TIMELINE: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.GIT_TIMELINE}`,
+  BUILD: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.BUILD}`,
+  CHECKLIST: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.CHECKLIST}`,
+  CHECKS: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.CHECKS}`,
+  CHECKS_RUN: `${RELEASE_BASE_PATH}${RELEASE_ROUTES.CHECKS_RUN}`
+};
+var RELEASE_WIDGET_ROUTES = {
+  SCOPES: "scopes",
+  STATUS: "status",
+  PLAN: "plan",
+  GENERATE: "generate",
+  RESET: "plan",
+  PREVIEW: "preview",
+  VERIFY: "verify",
+  CHANGELOG: "changelog",
+  CHANGELOG_GENERATE: "changelog/generate",
+  CHANGELOG_SAVE: "changelog/save",
+  RUN: "run",
+  PUBLISH: "publish",
+  ROLLBACK: "rollback",
+  REPORT: "report",
+  HISTORY: "history",
+  HISTORY_REPORT: "history/:scope/:id/report",
+  HISTORY_PLAN: "history/:scope/:id/plan",
+  HISTORY_CHANGELOG: "history/:scope/:id/changelog",
+  GIT_TIMELINE: "git-timeline",
+  BUILD: "build",
+  CHECKLIST: "checklist",
+  CHECKS_RUN: "checks/run"
+};
+var ReleaseScopeInfoSchema = z.object({
+  id: z.string().min(1),
+  name: z.string().min(1),
+  path: z.string().min(1),
+  currentVersion: z.string().optional(),
+  description: z.string().optional(),
+  type: z.enum(["package", "monorepo", "root"])
+});
+var ScopesResponseSchema = z.object({
+  scopes: z.array(ReleaseScopeInfoSchema)
+});
+var PlanStatusSchema = z.enum(["idle", "ready", "running", "completed", "failed"]);
+var StatusInputSchema = z.object({
+  scope: z.string().default("root")
+});
+var StatusResponseSchema = z.object({
+  scope: z.string(),
+  scopeInfo: ReleaseScopeInfoSchema.optional(),
+  // Package metadata (name, version, description)
+  hasPlan: z.boolean(),
+  hasReport: z.boolean(),
+  hasChangelog: z.boolean(),
+  planStatus: PlanStatusSchema,
+  packagesInPlan: z.number().int().min(0),
+  lastReleaseAt: z.string().datetime().optional()
+});
+var VersionBumpSchema = z.enum(["patch", "minor", "major", "auto"]);
+var PackageVersionSchema = z.object({
+  name: z.string().min(1),
+  path: z.string().min(1),
+  currentVersion: z.string(),
+  nextVersion: z.string(),
+  bump: VersionBumpSchema,
+  isPublished: z.boolean(),
+  dependencies: z.array(z.string()).optional(),
+  reason: z.string().optional()
+  // LLM-generated reasoning for version bump
+});
+var ReleasePlanSchema = z.object({
+  schemaVersion: z.literal("1.0"),
+  scope: z.string(),
+  packages: z.array(PackageVersionSchema),
+  strategy: z.literal("semver"),
+  registry: z.string().url(),
+  rollbackEnabled: z.boolean(),
+  createdAt: z.string().datetime()
+});
+var PlanInputSchema = z.object({
+  scope: z.string().default("root")
+});
+var PlanResponseSchema = z.object({
+  hasPlan: z.boolean(),
+  plan: ReleasePlanSchema.optional(),
+  scope: z.string()
+});
+var GeneratePlanRequestSchema = z.object({
+  scope: z.string(),
+  scopePath: z.string().optional(),
+  // Absolute path to monorepo/package dir — takes priority over scope name for discovery
+  bump: VersionBumpSchema.optional(),
+  strict: z.boolean().optional(),
+  useLLM: z.boolean().optional().default(true)
+  // Use LLM for intelligent version bump analysis
+});
+var GeneratePlanResponseSchema = z.object({
+  plan: ReleasePlanSchema,
+  planPath: z.string(),
+  scope: z.string(),
+  tokensUsed: z.number().optional(),
+  // Track LLM token usage
+  confidence: z.number().min(0).max(1).optional()
+  // LLM confidence score (0-1)
+});
+var ResetPlanRequestSchema = z.object({
+  scope: z.string().default("root")
+});
+var ResetPlanResponseSchema = z.object({
+  success: z.boolean(),
+  scope: z.string(),
+  message: z.string()
+});
+var ChangelogInputSchema = z.object({
+  scope: z.string().default("root"),
+  from: z.string().optional(),
+  to: z.string().optional()
+});
+var ChangelogResponseSchema = z.object({
+  scope: z.string(),
+  markdown: z.string().optional(),
+  from: z.string().optional(),
+  to: z.string().optional(),
+  generatedAt: z.string().datetime().optional()
+});
+var GenerateChangelogRequestSchema = z.object({
+  scope: z.string(),
+  from: z.string().optional(),
+  to: z.string().optional(),
+  template: z.string().optional(),
+  locale: z.enum(["en", "ru"]).optional(),
+  useLLM: z.boolean().optional().default(true)
+});
+var GenerateChangelogResponseSchema = z.object({
+  scope: z.string(),
+  markdown: z.string(),
+  changelogPath: z.string(),
+  tokensUsed: z.number().int().min(0).optional(),
+  usedLLM: z.boolean().optional(),
+  commitsCount: z.number().int().min(0).optional()
+});
+var SaveChangelogRequestSchema = z.object({
+  scope: z.string(),
+  markdown: z.string()
+});
+var SaveChangelogResponseSchema = z.object({
+  success: z.boolean(),
+  scope: z.string(),
+  path: z.string()
+});
+var CheckResultSchema = z.object({
+  id: z.string(),
+  ok: z.boolean(),
+  details: z.unknown().optional(),
+  hint: z.string().optional(),
+  timingMs: z.number().int().min(0).optional()
+});
+var ReleaseStageSchema = z.enum([
+  "planning",
+  "checking",
+  "versioning",
+  "publishing",
+  "verifying",
+  "rollback"
+]);
+var ReleaseReportSchema = z.object({
+  schemaVersion: z.literal("1.0"),
+  ts: z.string().datetime(),
+  scope: z.string(),
+  context: z.object({
+    repo: z.string(),
+    cwd: z.string(),
+    branch: z.string(),
+    profile: z.string().optional(),
+    dryRun: z.boolean().optional()
+  }),
+  stage: ReleaseStageSchema,
+  plan: ReleasePlanSchema.optional(),
+  result: z.object({
+    ok: z.boolean(),
+    version: z.string().optional(),
+    published: z.array(z.string()).optional(),
+    skipped: z.array(z.string()).optional(),
+    changelog: z.string().optional(),
+    checks: z.record(z.string(), CheckResultSchema).optional(),
+    git: z.object({
+      committed: z.boolean(),
+      tagged: z.array(z.string()),
+      pushed: z.boolean()
+    }).optional(),
+    timingMs: z.number().int().min(0),
+    errors: z.array(z.string()).optional()
+  })
+});
+var RunReleaseRequestSchema = z.object({
+  scope: z.string(),
+  strict: z.boolean().optional(),
+  dryRun: z.boolean().optional(),
+  skipChecks: z.boolean().optional(),
+  otp: z.string().length(6).optional()
+});
+var RunReleaseResponseSchema = z.object({
+  scope: z.string(),
+  report: ReleaseReportSchema,
+  success: z.boolean(),
+  errors: z.array(z.string()).optional()
+});
+var ReportResponseSchema = z.object({
+  hasReport: z.boolean(),
+  report: ReleaseReportSchema.optional(),
+  scope: z.string().optional()
+});
+var ReleaseHistoryItemSchema = z.object({
+  id: z.string(),
+  timestamp: z.string().datetime(),
+  scope: z.string(),
+  version: z.string().optional(),
+  packages: z.array(z.string()),
+  success: z.boolean(),
+  stage: ReleaseStageSchema,
+  error: z.string().optional()
+});
+var HistoryResponseSchema = z.object({
+  releases: z.array(ReleaseHistoryItemSchema)
+});
+var HistoryReportResponseSchema = z.object({
+  id: z.string(),
+  report: ReleaseReportSchema
+});
+var HistoryPlanResponseSchema = z.object({
+  id: z.string(),
+  plan: ReleasePlanSchema
+});
+var HistoryChangelogResponseSchema = z.object({
+  id: z.string(),
+  markdown: z.string(),
+  scope: z.string()
+});
+var VerifyCheckSchema = z.object({
+  name: z.string(),
+  passed: z.boolean(),
+  warning: z.string().optional(),
+  error: z.string().optional()
+});
+var VerifyResponseSchema = z.object({
+  scope: z.string(),
+  passed: z.boolean(),
+  checks: z.array(VerifyCheckSchema),
+  warnings: z.array(z.string()),
+  errors: z.array(z.string())
+});
+var PublishRequestSchema = z.object({
+  scope: z.string(),
+  packages: z.array(z.string()).optional(),
+  registry: z.string().url().optional(),
+  dryRun: z.boolean().optional()
+});
+var PublishResponseSchema = z.object({
+  scope: z.string(),
+  published: z.array(z.string()),
+  failed: z.array(z.string()).optional(),
+  success: z.boolean()
+});
+var RollbackRequestSchema = z.object({
+  scope: z.string(),
+  releaseId: z.string().optional()
+});
+var RollbackResponseSchema = z.object({
+  scope: z.string(),
+  success: z.boolean(),
+  message: z.string(),
+  rolledBackPackages: z.array(z.string()).optional()
+});
+var GitCommitSchema = z.object({
+  sha: z.string(),
+  shortSha: z.string(),
+  message: z.string(),
+  type: z.enum(["feat", "fix", "chore", "docs", "refactor", "test", "style", "perf", "ci", "build", "revert", "BREAKING", "unknown"]),
+  bump: z.enum(["major", "minor", "patch", "none"]),
+  scope: z.string().optional(),
+  author: z.string(),
+  date: z.string().datetime()
+});
+var GitTimelineInputSchema = z.object({
+  scope: z.string().default("root")
+});
+var GitTimelineResponseSchema = z.object({
+  scope: z.string(),
+  currentVersion: z.string().optional(),
+  suggestedVersion: z.string().optional(),
+  suggestedBump: z.enum(["major", "minor", "patch", "none"]).optional(),
+  commits: z.array(GitCommitSchema),
+  unreleased: z.number().int().min(0),
+  lastTag: z.string().optional(),
+  hasUnreleasedChanges: z.boolean()
+});
+var PackageFileSchema = z.object({
+  path: z.string(),
+  size: z.number().int().min(0)
+});
+var BuildStatusSchema = z.enum(["ready", "not_built", "outdated", "building"]);
+var PackagePreviewSchema = z.object({
+  name: z.string(),
+  version: z.string(),
+  path: z.string(),
+  buildStatus: BuildStatusSchema,
+  files: z.array(PackageFileSchema),
+  expectedFiles: z.array(z.string()).optional(),
+  // From package.json "files" field
+  totalSize: z.number().int().min(0),
+  fileCount: z.number().int().min(0)
+});
+var PreviewInputSchema = z.object({
+  scope: z.string().default("root")
+});
+var PreviewResponseSchema = z.object({
+  scope: z.string(),
+  packages: z.array(PackagePreviewSchema),
+  totalSize: z.number().int().min(0),
+  totalFiles: z.number().int().min(0),
+  allBuilt: z.boolean()
+  // True if all packages have dist/
+});
+var BuildRequestSchema = z.object({
+  scope: z.string()
+});
+var BuildResponseSchema = z.object({
+  scope: z.string(),
+  success: z.boolean(),
+  packages: z.array(z.object({
+    name: z.string(),
+    success: z.boolean(),
+    error: z.string().optional(),
+    durationMs: z.number().int().min(0).optional()
+  })),
+  builtCount: z.number().int().min(0),
+  totalCount: z.number().int().min(0),
+  totalDurationMs: z.number().int().min(0)
+});
+var ChecklistItemStatusSchema = z.enum(["pending", "ready", "warning", "error", "running"]);
+var ReleaseChecklistSchema = z.object({
+  scope: z.string(),
+  plan: z.object({
+    status: ChecklistItemStatusSchema,
+    message: z.string(),
+    packagesCount: z.number().int().min(0).optional(),
+    bump: z.string().optional()
+  }),
+  changelog: z.object({
+    status: ChecklistItemStatusSchema,
+    message: z.string(),
+    commitsCount: z.number().int().min(0).optional()
+  }),
+  build: z.object({
+    status: ChecklistItemStatusSchema,
+    message: z.string(),
+    builtCount: z.number().int().min(0).optional(),
+    totalCount: z.number().int().min(0).optional()
+  }),
+  preview: z.object({
+    status: ChecklistItemStatusSchema,
+    message: z.string(),
+    filesCount: z.number().int().min(0).optional(),
+    totalSize: z.number().int().min(0).optional()
+  }),
+  npm: z.object({
+    status: ChecklistItemStatusSchema,
+    message: z.string()
+  }),
+  canPublish: z.boolean()
+});
+var RunChecksRequestSchema = z.object({
+  scope: z.string()
+});
+var CheckResultItemSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  success: z.boolean(),
+  error: z.string().optional(),
+  durationMs: z.number().int().min(0),
+  optional: z.boolean().optional()
+});
+var RunChecksResponseSchema = z.object({
+  scope: z.string(),
+  success: z.boolean(),
+  checks: z.array(CheckResultItemSchema),
+  totalDurationMs: z.number().int().min(0)
+});
+var CheckDefinitionSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  optional: z.boolean().optional()
+});
+var GetChecksResponseSchema = z.object({
+  scope: z.string(),
+  checks: z.array(CheckDefinitionSchema)
+});
+
+// src/index.ts
+var RELEASE_CACHE_PREFIX = "release:";
+
+export { BuildRequestSchema, BuildResponseSchema, BuildStatusSchema, ChangelogInputSchema, ChangelogResponseSchema, CheckDefinitionSchema, CheckResultItemSchema, CheckResultSchema, ChecklistItemStatusSchema, GenerateChangelogRequestSchema, GenerateChangelogResponseSchema, GeneratePlanRequestSchema, GeneratePlanResponseSchema, GetChecksResponseSchema, GitCommitSchema, GitTimelineInputSchema, GitTimelineResponseSchema, HistoryChangelogResponseSchema, HistoryPlanResponseSchema, HistoryReportResponseSchema, HistoryResponseSchema, PackageFileSchema, PackagePreviewSchema, PackageVersionSchema, PlanInputSchema, PlanResponseSchema, PlanStatusSchema, PreviewInputSchema, PreviewResponseSchema, PublishRequestSchema, PublishResponseSchema, RELEASE_BASE_PATH, RELEASE_CACHE_PREFIX, RELEASE_FULL_ROUTES, RELEASE_ROUTES, RELEASE_WIDGET_ROUTES, ReleaseChecklistSchema, ReleaseHistoryItemSchema, ReleasePlanSchema, ReleaseReportSchema, ReleaseScopeInfoSchema, ReleaseStageSchema, ReportResponseSchema, ResetPlanRequestSchema, ResetPlanResponseSchema, RollbackRequestSchema, RollbackResponseSchema, RunChecksRequestSchema, RunChecksResponseSchema, RunReleaseRequestSchema, RunReleaseResponseSchema, SaveChangelogRequestSchema, SaveChangelogResponseSchema, ScopesResponseSchema, StatusInputSchema, StatusResponseSchema, VerifyCheckSchema, VerifyResponseSchema, VersionBumpSchema, contractsSchemaId, contractsVersion, pluginContractsManifest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map