@kb-labs/commit-contracts 0.6.0

package/dist/schema.js

@@ -0,0 +1,158 @@
+import { z } from 'zod';
+
+// src/schema.ts
+var ConventionalTypeSchema = z.enum([
+  "feat",
+  "fix",
+  "refactor",
+  "chore",
+  "docs",
+  "test",
+  "build",
+  "ci",
+  "perf"
+]);
+var ReleaseHintSchema = z.enum(["none", "patch", "minor", "major"]);
+var GitStatusSchema = z.object({
+  staged: z.array(z.string()),
+  unstaged: z.array(z.string()),
+  untracked: z.array(z.string())
+});
+var FileSummarySchema = z.object({
+  path: z.string(),
+  status: z.enum(["added", "modified", "deleted", "renamed", "copied"]),
+  additions: z.number().int().min(0),
+  deletions: z.number().int().min(0),
+  binary: z.boolean().default(false),
+  /** Whether file is truly new (never existed in repo history) */
+  isNewFile: z.boolean().default(false)
+});
+var CommitReasoningSchema = z.object({
+  /** Does this change add NEW user-visible behavior? */
+  newBehavior: z.boolean().default(false),
+  /** Does this change fix BROKEN functionality? */
+  fixesBug: z.boolean().default(false),
+  /** Is this only INTERNAL restructuring? */
+  internalOnly: z.boolean().default(false),
+  /** Human-readable explanation of why this type was chosen */
+  explanation: z.string().default(""),
+  /** LLM confidence in this classification (0.0-1.0) */
+  confidence: z.number().min(0).max(1).default(0.5)
+});
+var CommitGroupSchema = z.object({
+  id: z.string(),
+  type: ConventionalTypeSchema,
+  scope: z.string().optional(),
+  message: z.string().min(1),
+  body: z.string().optional(),
+  files: z.array(z.string()).min(1),
+  releaseHint: ReleaseHintSchema.default("none"),
+  breaking: z.boolean().default(false),
+  /** Reasoning for commit type classification (optional, added by LLM) */
+  reasoning: CommitReasoningSchema.optional()
+});
+var CommitPlanSchema = z.object({
+  schemaVersion: z.literal("1.0"),
+  createdAt: z.string().datetime(),
+  repoRoot: z.string(),
+  gitStatus: GitStatusSchema,
+  commits: z.array(CommitGroupSchema),
+  metadata: z.object({
+    totalFiles: z.number().int().min(0),
+    totalCommits: z.number().int().min(0),
+    llmUsed: z.boolean(),
+    tokensUsed: z.number().int().min(0).optional(),
+    /** Whether LLM escalated to Phase 2 (requested diff for more context) */
+    escalated: z.boolean().optional()
+  })
+});
+var GitStatusSnapshotSchema = z.object({
+  schemaVersion: z.literal("1.0"),
+  createdAt: z.string().datetime(),
+  status: GitStatusSchema,
+  summaries: z.array(FileSummarySchema)
+});
+var CommitRunInputSchema = z.object({
+  scope: z.string().optional(),
+  dryRun: z.boolean().default(false),
+  withPush: z.boolean().default(false)
+});
+var CommitRunOutputSchema = z.object({
+  plan: CommitPlanSchema,
+  applied: z.boolean(),
+  pushed: z.boolean(),
+  commits: z.array(
+    z.object({
+      id: z.string(),
+      sha: z.string().optional(),
+      message: z.string()
+    })
+  )
+});
+var GenerateInputSchema = z.object({
+  scope: z.string().optional()
+});
+var GenerateOutputSchema = z.object({
+  plan: CommitPlanSchema,
+  planPath: z.string()
+});
+var ApplyInputSchema = z.object({
+  force: z.boolean().default(false)
+});
+var ApplyOutputSchema = z.object({
+  success: z.boolean(),
+  commits: z.array(
+    z.object({
+      id: z.string(),
+      sha: z.string(),
+      message: z.string()
+    })
+  ),
+  errors: z.array(z.string()).default([])
+});
+var PushInputSchema = z.object({
+  force: z.boolean().default(false)
+});
+var PushOutputSchema = z.object({
+  success: z.boolean(),
+  remote: z.string(),
+  branch: z.string(),
+  commits: z.number().int().min(0)
+});
+var OpenInputSchema = z.object({
+  json: z.boolean().default(false)
+});
+var OpenOutputSchema = z.object({
+  hasPlan: z.boolean(),
+  plan: CommitPlanSchema.optional(),
+  planPath: z.string().optional()
+});
+var ResetOutputSchema = z.object({
+  success: z.boolean(),
+  message: z.string()
+});
+var ApplyResultSchema = z.object({
+  success: z.boolean(),
+  appliedCommits: z.array(
+    z.object({
+      groupId: z.string(),
+      sha: z.string(),
+      message: z.string()
+    })
+  ),
+  errors: z.array(z.string())
+});
+var PushResultSchema = z.object({
+  success: z.boolean(),
+  remote: z.string(),
+  branch: z.string(),
+  commitsPushed: z.number().int().min(0),
+  error: z.string().optional()
+});
+var ActionsResponseSchema = z.object({
+  scope: z.string().optional()
+});
+
+export { ActionsResponseSchema, ApplyInputSchema, ApplyOutputSchema, ApplyResultSchema, CommitGroupSchema, CommitPlanSchema, CommitReasoningSchema, CommitRunInputSchema, CommitRunOutputSchema, ConventionalTypeSchema, FileSummarySchema, GenerateInputSchema, GenerateOutputSchema, GitStatusSchema, GitStatusSnapshotSchema, OpenInputSchema, OpenOutputSchema, PushInputSchema, PushOutputSchema, PushResultSchema, ReleaseHintSchema, ResetOutputSchema };
+//# sourceMappingURL=schema.js.map
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts"],"names":[],"mappings":"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","file":"schema.js","sourcesContent":["import { z } from \"zod\";\n\n// ============================================================================\n// Core Types\n// ============================================================================\n\n/**\n * Conventional commit types\n */\nexport const ConventionalTypeSchema = z.enum([\n  \"feat\",\n  \"fix\",\n  \"refactor\",\n  \"chore\",\n  \"docs\",\n  \"test\",\n  \"build\",\n  \"ci\",\n  \"perf\",\n]);\n\nexport type ConventionalType = z.infer<typeof ConventionalTypeSchema>;\n\n/**\n * Release hint for semantic versioning\n */\nexport const ReleaseHintSchema = z.enum([\"none\", \"patch\", \"minor\", \"major\"]);\n\nexport type ReleaseHint = z.infer<typeof ReleaseHintSchema>;\n\n// ============================================================================\n// Git Status\n// ============================================================================\n\n/**\n * Git status snapshot\n */\nexport const GitStatusSchema = z.object({\n  staged: z.array(z.string()),\n  unstaged: z.array(z.string()),\n  untracked: z.array(z.string()),\n});\n\nexport type GitStatus = z.infer<typeof GitStatusSchema>;\n\n/**\n * File summary with diff stats\n */\nexport const FileSummarySchema = z.object({\n  path: z.string(),\n  status: z.enum([\"added\", \"modified\", \"deleted\", \"renamed\", \"copied\"]),\n  additions: z.number().int().min(0),\n  deletions: z.number().int().min(0),\n  binary: z.boolean().default(false),\n  /** Whether file is truly new (never existed in repo history) */\n  isNewFile: z.boolean().default(false),\n});\n\nexport type FileSummary = z.infer<typeof FileSummarySchema>;\n\n// ============================================================================\n// Commit Plan\n// ============================================================================\n\n/**\n * Reasoning for commit type classification\n */\nexport const CommitReasoningSchema = z.object({\n  /** Does this change add NEW user-visible behavior? */\n  newBehavior: z.boolean().default(false),\n  /** Does this change fix BROKEN functionality? */\n  fixesBug: z.boolean().default(false),\n  /** Is this only INTERNAL restructuring? */\n  internalOnly: z.boolean().default(false),\n  /** Human-readable explanation of why this type was chosen */\n  explanation: z.string().default(''),\n  /** LLM confidence in this classification (0.0-1.0) */\n  confidence: z.number().min(0).max(1).default(0.5),\n});\n\nexport type CommitReasoning = z.infer<typeof CommitReasoningSchema>;\n\n/**\n * A single commit group in the plan\n */\nexport const CommitGroupSchema = z.object({\n  id: z.string(),\n  type: ConventionalTypeSchema,\n  scope: z.string().optional(),\n  message: z.string().min(1),\n  body: z.string().optional(),\n  files: z.array(z.string()).min(1),\n  releaseHint: ReleaseHintSchema.default(\"none\"),\n  breaking: z.boolean().default(false),\n  /** Reasoning for commit type classification (optional, added by LLM) */\n  reasoning: CommitReasoningSchema.optional(),\n});\n\nexport type CommitGroup = z.infer<typeof CommitGroupSchema>;\n\n/**\n * Complete commit plan\n */\nexport const CommitPlanSchema = z.object({\n  schemaVersion: z.literal(\"1.0\"),\n  createdAt: z.string().datetime(),\n  repoRoot: z.string(),\n  gitStatus: GitStatusSchema,\n  commits: z.array(CommitGroupSchema),\n  metadata: z.object({\n    totalFiles: z.number().int().min(0),\n    totalCommits: z.number().int().min(0),\n    llmUsed: z.boolean(),\n    tokensUsed: z.number().int().min(0).optional(),\n    /** Whether LLM escalated to Phase 2 (requested diff for more context) */\n    escalated: z.boolean().optional(),\n  }),\n});\n\nexport type CommitPlan = z.infer<typeof CommitPlanSchema>;\n\n/**\n * Git status snapshot for storage\n */\nexport const GitStatusSnapshotSchema = z.object({\n  schemaVersion: z.literal(\"1.0\"),\n  createdAt: z.string().datetime(),\n  status: GitStatusSchema,\n  summaries: z.array(FileSummarySchema),\n});\n\nexport type GitStatusSnapshot = z.infer<typeof GitStatusSnapshotSchema>;\n\n// ============================================================================\n// Command Input/Output Schemas\n// ============================================================================\n\n// --- commit (run) ---\nexport const CommitRunInputSchema = z.object({\n  scope: z.string().optional(),\n  dryRun: z.boolean().default(false),\n  withPush: z.boolean().default(false),\n});\n\nexport type CommitRunInput = z.infer<typeof CommitRunInputSchema>;\n\nexport const CommitRunOutputSchema = z.object({\n  plan: CommitPlanSchema,\n  applied: z.boolean(),\n  pushed: z.boolean(),\n  commits: z.array(\n    z.object({\n      id: z.string(),\n      sha: z.string().optional(),\n      message: z.string(),\n    }),\n  ),\n});\n\nexport type CommitRunOutput = z.infer<typeof CommitRunOutputSchema>;\n\n// --- commit:generate ---\nexport const GenerateInputSchema = z.object({\n  scope: z.string().optional(),\n});\n\nexport type GenerateInput = z.infer<typeof GenerateInputSchema>;\n\nexport const GenerateOutputSchema = z.object({\n  plan: CommitPlanSchema,\n  planPath: z.string(),\n});\n\nexport type GenerateOutput = z.infer<typeof GenerateOutputSchema>;\n\n// --- commit:apply ---\nexport const ApplyInputSchema = z.object({\n  force: z.boolean().default(false),\n});\n\nexport type ApplyInput = z.infer<typeof ApplyInputSchema>;\n\nexport const ApplyOutputSchema = z.object({\n  success: z.boolean(),\n  commits: z.array(\n    z.object({\n      id: z.string(),\n      sha: z.string(),\n      message: z.string(),\n    }),\n  ),\n  errors: z.array(z.string()).default([]),\n});\n\nexport type ApplyOutput = z.infer<typeof ApplyOutputSchema>;\n\n// --- commit:push ---\nexport const PushInputSchema = z.object({\n  force: z.boolean().default(false),\n});\n\nexport type PushInput = z.infer<typeof PushInputSchema>;\n\nexport const PushOutputSchema = z.object({\n  success: z.boolean(),\n  remote: z.string(),\n  branch: z.string(),\n  commits: z.number().int().min(0),\n});\n\nexport type PushOutput = z.infer<typeof PushOutputSchema>;\n\n// --- commit:open ---\nexport const OpenInputSchema = z.object({\n  json: z.boolean().default(false),\n});\n\nexport type OpenInput = z.infer<typeof OpenInputSchema>;\n\nexport const OpenOutputSchema = z.object({\n  hasPlan: z.boolean(),\n  plan: CommitPlanSchema.optional(),\n  planPath: z.string().optional(),\n});\n\nexport type OpenOutput = z.infer<typeof OpenOutputSchema>;\n\n// --- commit:reset ---\nexport const ResetOutputSchema = z.object({\n  success: z.boolean(),\n  message: z.string(),\n});\n\nexport type ResetOutput = z.infer<typeof ResetOutputSchema>;\n\n// ============================================================================\n// Result Types (for core package)\n// ============================================================================\n\nexport const ApplyResultSchema = z.object({\n  success: z.boolean(),\n  appliedCommits: z.array(\n    z.object({\n      groupId: z.string(),\n      sha: z.string(),\n      message: z.string(),\n    }),\n  ),\n  errors: z.array(z.string()),\n});\n\nexport type ApplyResult = z.infer<typeof ApplyResultSchema>;\n\nexport const PushResultSchema = z.object({\n  success: z.boolean(),\n  remote: z.string(),\n  branch: z.string(),\n  commitsPushed: z.number().int().min(0),\n  error: z.string().optional(),\n});\n\nexport type PushResult = z.infer<typeof PushResultSchema>;\n\n// ============================================================================\n// REST API Responses\n// ============================================================================\n\n/**\n * GET /actions response\n * Returns empty object for actions widget (widget only needs action buttons)\n */\nexport const ActionsResponseSchema = z.object({\n  scope: z.string().optional(),\n});\n\nexport type ActionsResponse = z.infer<typeof ActionsResponseSchema>;\n"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@kb-labs/commit-contracts",
+  "version": "0.6.0",
+  "type": "module",
+  "description": "Public contracts package for KB Labs Commit plugin. Provides typed guarantees about artifacts, commands, and APIs.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./contract": {
+      "import": "./dist/contract.js",
+      "types": "./dist/contract.d.ts"
+    },
+    "./schema": {
+      "import": "./dist/schema.js",
+      "types": "./dist/schema.d.ts"
+    },
+    "./dist/*": "./dist/*"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "pretype-check": "pnpm --filter @kb-labs/commit-contracts build",
+    "clean": "rimraf dist",
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@kb-labs/sdk": "^1.5.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@kb-labs/devkit": "link:../../../../infra/kb-labs-devkit",
+    "@types/node": "^24.3.3",
+    "eslint": "^9",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}