@kb-labs/commit-contracts 0.6.0

package/LICENSE

@@ -0,0 +1,4 @@
+This project is licensed under the same terms as the KB Labs Plugin Template root project.
+
+See the root LICENSE file at the repository root for full details.
+

package/README.md

@@ -0,0 +1,90 @@
+# @kb-labs/plugin-template-contracts
+
+Lightweight public contracts package for the plugin: it describes guaranteed artifacts, commands, workflows, API payloads, and the version of these promises.
+
+## Why this package exists
+
+Every KB Labs plugin is expected to publish a clear, lightweight “promise” to the rest of the ecosystem. This package is that promise: it contains only types, manifests, and validation helpers, so other teams (CLI, Workflow Engine, Studio, REST, marketplace tooling) can rely on a single source of truth without dragging in plugin runtime code.
+
+## Quick start checklist
+
+1. Clone this package as part of your plugin workspace (`packages/contracts`).
+2. Update `pluginContractsManifest` with your plugin ID and initial artifacts/commands.
+3. Adjust Zod schemas in `src/schema.ts` (or add new ones) to match your payloads.
+4. Bump `contractsVersion` whenever the public promise changes (SemVer rules below).
+5. Run `pnpm test` and `pnpm type-check` to ensure the manifest validates.
+6. Import the manifest in your CLI/REST/workflow code to avoid hard-coded IDs.
+
+### Renaming this package
+
+When you turn the template into your own plugin:
+- Change the npm name in `package.json` (e.g. `@kb-labs/my-plugin-contracts`).
+- Update `pluginContractsManifest.pluginId` in `src/contract.ts`.
+- Adjust aliases in `tsconfig.paths.json` and imports across the workspace (`@kb-labs/plugin-template-contracts` → your new name).
+- Replace sample artifact IDs (`template.hello.*`) with your own naming scheme.
+
+## What's inside
+
+- `pluginContractsManifest` — the single source of truth for the plugin's public capabilities
+- TypeScript types (`src/types`) and Zod schemas (`src/schema`) for artifacts, commands, workflows, and API payloads
+- `parsePluginContracts` utility for runtime validation of the manifest and third-party contracts
+
+## Versioning rules
+
+- `contractsVersion` follows SemVer and is **independent** from the plugin's npm version.
+- **MAJOR** — breaking changes (removing/renaming artifacts, changing payload formats).
+- **MINOR** — backwards-compatible extensions (new artifacts, commands, fields).
+- **PATCH** — documentation/metadata updates without altering payload formats.
+
+## Minimal manifest example
+
+```ts
+import type { PluginContracts } from '@kb-labs/plugin-template-contracts';
+
+export const pluginContractsManifest: PluginContracts = {
+  schema: 'kb.plugin.contracts/1',
+  pluginId: '@kb-labs/my-plugin',
+  contractsVersion: '1.0.0',
+  artifacts: {
+    'my-plugin.result': {
+      id: 'my-plugin.result',
+      kind: 'json',
+      description: 'Primary output of the CLI command.'
+    }
+  }
+  // commands/workflows/api can be added later when needed
+};
+```
+
+## Optional sections
+
+All additional sections are **optional** — include only what your plugin actually supports:
+
+- `commands` — define CLI or workflow commands that produce/consume artifacts.
+- `workflows` — describe composed workflows and their steps.
+- `api` — document REST (or future surfaces) when the plugin exposes them.
+
+If your plugin only ships a CLI command, keep `commands` + `artifacts` and omit `workflows`/`api`. The Zod schema accepts missing sections.
+
+## Usage in plugin code
+
+```ts
+import { pluginContractsManifest } from '@kb-labs/plugin-template-contracts';
+
+const helloArtifactId = pluginContractsManifest.artifacts['template.hello.greeting'].id;
+```
+
+Use the manifest to avoid magic strings, assert that required artifacts exist, or log which promises were fulfilled.
+
+## Who relies on the contract
+
+- **Workflow Engine** — verifies allowed steps, required artifacts, and matches produced results with the contract.
+- **Studio** — builds UI and hints based on declared artifacts and commands.
+- **CLI / REST / other plugins** — reuse types and schemas as the source of truth, validate inputs/outputs.
+- **Marketplace & QA tooling** — checks plugin compatibility and correctness before publishing.
+
+## Looking ahead
+
+- Generate JSON Schema / OpenAPI from the `api` contract surface.
+- Add automatic inspectors in Studio and validators for the marketplace.
+

package/dist/contract.d.ts

@@ -0,0 +1,135 @@
+/**
+ * KB Labs Commit Plugin - Contracts Manifest
+ *
+ * Level 2: Type-safe contracts with as const for type extraction.
+ * Defines artifacts, commands, and their relationships.
+ */
+declare const pluginContractsManifest: {
+    readonly schema: "kb.plugin.contracts/1";
+    readonly pluginId: "@kb-labs/commit";
+    readonly contractsVersion: "1.0.0";
+    readonly artifacts: {
+        readonly "commit.plan.json": {
+            readonly id: "commit.plan.json";
+            readonly kind: "json";
+            readonly description: "Current commit plan generated by LLM analysis of git changes.";
+            readonly pathPattern: ".kb/commit/current/plan.json";
+            readonly mediaType: "application/json";
+            readonly schemaRef: "@kb-labs/commit-contracts/schema#CommitPlan";
+            readonly example: {
+                readonly summary: "Example commit plan with two commits";
+                readonly payload: {
+                    readonly schemaVersion: "1.0";
+                    readonly commits: readonly [{
+                        readonly id: "c1";
+                        readonly type: "feat";
+                        readonly scope: "ui";
+                        readonly message: "add button component";
+                        readonly files: readonly ["src/components/Button.tsx"];
+                        readonly releaseHint: "minor";
+                    }];
+                };
+            };
+        };
+        readonly "commit.status.json": {
+            readonly id: "commit.status.json";
+            readonly kind: "json";
+            readonly description: "Git status snapshot at plan generation time.";
+            readonly pathPattern: ".kb/commit/current/status.json";
+            readonly mediaType: "application/json";
+            readonly schemaRef: "@kb-labs/commit-contracts/schema#GitStatusSnapshot";
+        };
+        readonly "commit.history": {
+            readonly id: "commit.history";
+            readonly kind: "dir";
+            readonly description: "History of applied commit plans with results.";
+            readonly pathPattern: ".kb/commit/history/";
+        };
+    };
+    readonly commands: {
+        readonly commit: {
+            readonly id: "commit";
+            readonly description: "Generate and apply commits (default flow).";
+            readonly input: {
+                readonly ref: "@kb-labs/commit-contracts/schema#CommitRunInput";
+                readonly format: "zod";
+            };
+            readonly output: {
+                readonly ref: "@kb-labs/commit-contracts/schema#CommitRunOutput";
+                readonly format: "zod";
+            };
+            readonly produces: ["commit.plan.json", "commit.status.json"];
+            readonly examples: ["kb commit", "kb commit --dry-run", "kb commit --with-push"];
+        };
+        readonly "commit:generate": {
+            readonly id: "commit:generate";
+            readonly description: "Generate commit plan from git changes using LLM.";
+            readonly input: {
+                readonly ref: "@kb-labs/commit-contracts/schema#GenerateInput";
+                readonly format: "zod";
+            };
+            readonly output: {
+                readonly ref: "@kb-labs/commit-contracts/schema#GenerateOutput";
+                readonly format: "zod";
+            };
+            readonly produces: ["commit.plan.json", "commit.status.json"];
+            readonly examples: ["kb commit generate", "kb commit generate --json", "kb commit generate --scope src/**"];
+        };
+        readonly "commit:apply": {
+            readonly id: "commit:apply";
+            readonly description: "Apply current commit plan (create local git commits).";
+            readonly input: {
+                readonly ref: "@kb-labs/commit-contracts/schema#ApplyInput";
+                readonly format: "zod";
+            };
+            readonly output: {
+                readonly ref: "@kb-labs/commit-contracts/schema#ApplyOutput";
+                readonly format: "zod";
+            };
+            readonly produces: [];
+            readonly examples: ["kb commit apply", "kb commit apply --force"];
+        };
+        readonly "commit:push": {
+            readonly id: "commit:push";
+            readonly description: "Push commits to remote repository.";
+            readonly input: {
+                readonly ref: "@kb-labs/commit-contracts/schema#PushInput";
+                readonly format: "zod";
+            };
+            readonly output: {
+                readonly ref: "@kb-labs/commit-contracts/schema#PushOutput";
+                readonly format: "zod";
+            };
+            readonly produces: [];
+            readonly examples: ["kb commit push", "kb commit push --force"];
+        };
+        readonly "commit:open": {
+            readonly id: "commit:open";
+            readonly description: "Show current commit plan.";
+            readonly input: {
+                readonly ref: "@kb-labs/commit-contracts/schema#OpenInput";
+                readonly format: "zod";
+            };
+            readonly output: {
+                readonly ref: "@kb-labs/commit-contracts/schema#OpenOutput";
+                readonly format: "zod";
+            };
+            readonly produces: [];
+            readonly examples: ["kb commit open", "kb commit open --json"];
+        };
+        readonly "commit:reset": {
+            readonly id: "commit:reset";
+            readonly description: "Clear current commit plan.";
+            readonly output: {
+                readonly ref: "@kb-labs/commit-contracts/schema#ResetOutput";
+                readonly format: "zod";
+            };
+            readonly produces: [];
+            readonly examples: ["kb commit reset"];
+        };
+    };
+};
+type PluginArtifactIds = keyof typeof pluginContractsManifest.artifacts;
+type PluginCommandIds = keyof typeof pluginContractsManifest.commands;
+
+export { type PluginArtifactIds, type PluginCommandIds, pluginContractsManifest };

package/dist/contract.js

@@ -0,0 +1,140 @@
+// src/version.ts
+var contractsSchemaId = "kb.plugin.contracts/1";
+var contractsVersion = "1.0.0";
+
+// src/contract.ts
+var pluginContractsManifest = {
+  schema: contractsSchemaId,
+  pluginId: "@kb-labs/commit",
+  contractsVersion,
+  artifacts: {
+    "commit.plan.json": {
+      id: "commit.plan.json",
+      kind: "json",
+      description: "Current commit plan generated by LLM analysis of git changes.",
+      pathPattern: ".kb/commit/current/plan.json",
+      mediaType: "application/json",
+      schemaRef: "@kb-labs/commit-contracts/schema#CommitPlan",
+      example: {
+        summary: "Example commit plan with two commits",
+        payload: {
+          schemaVersion: "1.0",
+          commits: [
+            {
+              id: "c1",
+              type: "feat",
+              scope: "ui",
+              message: "add button component",
+              files: ["src/components/Button.tsx"],
+              releaseHint: "minor"
+            }
+          ]
+        }
+      }
+    },
+    "commit.status.json": {
+      id: "commit.status.json",
+      kind: "json",
+      description: "Git status snapshot at plan generation time.",
+      pathPattern: ".kb/commit/current/status.json",
+      mediaType: "application/json",
+      schemaRef: "@kb-labs/commit-contracts/schema#GitStatusSnapshot"
+    },
+    "commit.history": {
+      id: "commit.history",
+      kind: "dir",
+      description: "History of applied commit plans with results.",
+      pathPattern: ".kb/commit/history/"
+    }
+  },
+  commands: {
+    commit: {
+      id: "commit",
+      description: "Generate and apply commits (default flow).",
+      input: {
+        ref: "@kb-labs/commit-contracts/schema#CommitRunInput",
+        format: "zod"
+      },
+      output: {
+        ref: "@kb-labs/commit-contracts/schema#CommitRunOutput",
+        format: "zod"
+      },
+      produces: ["commit.plan.json", "commit.status.json"],
+      examples: ["kb commit", "kb commit --dry-run", "kb commit --with-push"]
+    },
+    "commit:generate": {
+      id: "commit:generate",
+      description: "Generate commit plan from git changes using LLM.",
+      input: {
+        ref: "@kb-labs/commit-contracts/schema#GenerateInput",
+        format: "zod"
+      },
+      output: {
+        ref: "@kb-labs/commit-contracts/schema#GenerateOutput",
+        format: "zod"
+      },
+      produces: ["commit.plan.json", "commit.status.json"],
+      examples: [
+        "kb commit generate",
+        "kb commit generate --json",
+        "kb commit generate --scope src/**"
+      ]
+    },
+    "commit:apply": {
+      id: "commit:apply",
+      description: "Apply current commit plan (create local git commits).",
+      input: {
+        ref: "@kb-labs/commit-contracts/schema#ApplyInput",
+        format: "zod"
+      },
+      output: {
+        ref: "@kb-labs/commit-contracts/schema#ApplyOutput",
+        format: "zod"
+      },
+      produces: [],
+      examples: ["kb commit apply", "kb commit apply --force"]
+    },
+    "commit:push": {
+      id: "commit:push",
+      description: "Push commits to remote repository.",
+      input: {
+        ref: "@kb-labs/commit-contracts/schema#PushInput",
+        format: "zod"
+      },
+      output: {
+        ref: "@kb-labs/commit-contracts/schema#PushOutput",
+        format: "zod"
+      },
+      produces: [],
+      examples: ["kb commit push", "kb commit push --force"]
+    },
+    "commit:open": {
+      id: "commit:open",
+      description: "Show current commit plan.",
+      input: {
+        ref: "@kb-labs/commit-contracts/schema#OpenInput",
+        format: "zod"
+      },
+      output: {
+        ref: "@kb-labs/commit-contracts/schema#OpenOutput",
+        format: "zod"
+      },
+      produces: [],
+      examples: ["kb commit open", "kb commit open --json"]
+    },
+    "commit:reset": {
+      id: "commit:reset",
+      description: "Clear current commit plan.",
+      output: {
+        ref: "@kb-labs/commit-contracts/schema#ResetOutput",
+        format: "zod"
+      },
+      produces: [],
+      examples: ["kb commit reset"]
+    }
+  }
+};
+
+export { pluginContractsManifest };
+//# sourceMappingURL=contract.js.map
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts","../src/contract.ts"],"names":[],"mappings":"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","file":"contract.js","sourcesContent":["export const contractsSchemaId = \"kb.plugin.contracts/1\" as const;\n\nexport type ContractsSchemaId = typeof contractsSchemaId;\n\nexport const contractsVersion = \"1.0.0\" as const;\n","import type { PluginContracts } from \"./types\";\nimport { contractsSchemaId, contractsVersion } from \"./version\";\n\n/**\n * KB Labs Commit Plugin - Contracts Manifest\n *\n * Level 2: Type-safe contracts with as const for type extraction.\n * Defines artifacts, commands, and their relationships.\n */\nexport const pluginContractsManifest = {\n  schema: contractsSchemaId,\n  pluginId: \"@kb-labs/commit\",\n  contractsVersion,\n  artifacts: {\n    \"commit.plan.json\": {\n      id: \"commit.plan.json\",\n      kind: \"json\",\n      description:\n        \"Current commit plan generated by LLM analysis of git changes.\",\n      pathPattern: \".kb/commit/current/plan.json\",\n      mediaType: \"application/json\",\n      schemaRef: \"@kb-labs/commit-contracts/schema#CommitPlan\",\n      example: {\n        summary: \"Example commit plan with two commits\",\n        payload: {\n          schemaVersion: \"1.0\",\n          commits: [\n            {\n              id: \"c1\",\n              type: \"feat\",\n              scope: \"ui\",\n              message: \"add button component\",\n              files: [\"src/components/Button.tsx\"],\n              releaseHint: \"minor\",\n            },\n          ],\n        },\n      },\n    },\n    \"commit.status.json\": {\n      id: \"commit.status.json\",\n      kind: \"json\",\n      description: \"Git status snapshot at plan generation time.\",\n      pathPattern: \".kb/commit/current/status.json\",\n      mediaType: \"application/json\",\n      schemaRef: \"@kb-labs/commit-contracts/schema#GitStatusSnapshot\",\n    },\n    \"commit.history\": {\n      id: \"commit.history\",\n      kind: \"dir\",\n      description: \"History of applied commit plans with results.\",\n      pathPattern: \".kb/commit/history/\",\n    },\n  },\n  commands: {\n    commit: {\n      id: \"commit\",\n      description: \"Generate and apply commits (default flow).\",\n      input: {\n        ref: \"@kb-labs/commit-contracts/schema#CommitRunInput\",\n        format: \"zod\",\n      },\n      output: {\n        ref: \"@kb-labs/commit-contracts/schema#CommitRunOutput\",\n        format: \"zod\",\n      },\n      produces: [\"commit.plan.json\", \"commit.status.json\"],\n      examples: [\"kb commit\", \"kb commit --dry-run\", \"kb commit --with-push\"],\n    },\n    \"commit:generate\": {\n      id: \"commit:generate\",\n      description: \"Generate commit plan from git changes using LLM.\",\n      input: {\n        ref: \"@kb-labs/commit-contracts/schema#GenerateInput\",\n        format: \"zod\",\n      },\n      output: {\n        ref: \"@kb-labs/commit-contracts/schema#GenerateOutput\",\n        format: \"zod\",\n      },\n      produces: [\"commit.plan.json\", \"commit.status.json\"],\n      examples: [\n        \"kb commit generate\",\n        \"kb commit generate --json\",\n        \"kb commit generate --scope src/**\",\n      ],\n    },\n    \"commit:apply\": {\n      id: \"commit:apply\",\n      description: \"Apply current commit plan (create local git commits).\",\n      input: {\n        ref: \"@kb-labs/commit-contracts/schema#ApplyInput\",\n        format: \"zod\",\n      },\n      output: {\n        ref: \"@kb-labs/commit-contracts/schema#ApplyOutput\",\n        format: \"zod\",\n      },\n      produces: [],\n      examples: [\"kb commit apply\", \"kb commit apply --force\"],\n    },\n    \"commit:push\": {\n      id: \"commit:push\",\n      description: \"Push commits to remote repository.\",\n      input: {\n        ref: \"@kb-labs/commit-contracts/schema#PushInput\",\n        format: \"zod\",\n      },\n      output: {\n        ref: \"@kb-labs/commit-contracts/schema#PushOutput\",\n        format: \"zod\",\n      },\n      produces: [],\n      examples: [\"kb commit push\", \"kb commit push --force\"],\n    },\n    \"commit:open\": {\n      id: \"commit:open\",\n      description: \"Show current commit plan.\",\n      input: {\n        ref: \"@kb-labs/commit-contracts/schema#OpenInput\",\n        format: \"zod\",\n      },\n      output: {\n        ref: \"@kb-labs/commit-contracts/schema#OpenOutput\",\n        format: \"zod\",\n      },\n      produces: [],\n      examples: [\"kb commit open\", \"kb commit open --json\"],\n    },\n    \"commit:reset\": {\n      id: \"commit:reset\",\n      description: \"Clear current commit plan.\",\n      output: {\n        ref: \"@kb-labs/commit-contracts/schema#ResetOutput\",\n        format: \"zod\",\n      },\n      produces: [],\n      examples: [\"kb commit reset\"],\n    },\n  },\n} as const satisfies PluginContracts;\n\n// Extract types for use in manifest and commands\nexport type PluginArtifactIds = keyof typeof pluginContractsManifest.artifacts;\nexport type PluginCommandIds = keyof typeof pluginContractsManifest.commands;\n"]}