@denisvieiradev/gitwise-core 0.1.0

package/dist/testing/index.d.ts

@@ -0,0 +1,58 @@
+import { L as LLMProvider, a as LLMChatRequest, b as LLMChatResponse } from '../types-DnMpR1qf.js';
+
+interface MockResponse {
+    content: string;
+    tokens?: {
+        input: number;
+        output: number;
+    };
+}
+interface PrefixMatcher {
+    prefix: string;
+    response: MockResponse;
+}
+/**
+ * MockLLMProvider — deterministic LLM stub for tests.
+ *
+ * Usage:
+ *   const mock = new MockLLMProvider();
+ *   mock.queueByIndex({ content: "result" });                  // first call
+ *   mock.queueByPrefix("Analyze", { content: "analysis" });    // by prompt prefix
+ *   await someFunction(mock);
+ *   mock.assertCallCount(2);
+ *   mock.assertTotalTokens({ input: 10, output: 5 });
+ */
+declare class MockLLMProvider implements LLMProvider {
+    private readonly indexedResponses;
+    private readonly prefixResponses;
+    private callCount;
+    private totalInputTokens;
+    private totalOutputTokens;
+    private readonly calls;
+    /** Queue a response to return for the N-th call (0-indexed). */
+    queueByIndex(response: MockResponse): this;
+    /** Queue a response to return when userMessage starts with the given prefix. */
+    queueByPrefix(prefix: string, response: MockResponse): this;
+    chat(req: LLMChatRequest): Promise<LLMChatResponse>;
+    private buildResponse;
+    /** Returns all recorded calls. */
+    getCalls(): readonly LLMChatRequest[];
+    /** Returns the number of chat() calls made. */
+    getCallCount(): number;
+    /** Assert the provider was called exactly N times. */
+    assertCallCount(expected: number): void;
+    /** Assert accumulated token totals. */
+    assertTotalTokens(expected: {
+        input?: number;
+        output?: number;
+    }): void;
+    getTotalTokens(): {
+        input: number;
+        output: number;
+    };
+    reset(): void;
+}
+
+declare const __testingPlaceholder__: unique symbol;
+
+export { MockLLMProvider, type MockResponse, type PrefixMatcher, __testingPlaceholder__ };

package/dist/testing/index.js

@@ -0,0 +1,83 @@
+// src/testing/mock-llm-provider.ts
+var MockLLMProvider = class {
+  indexedResponses = [];
+  prefixResponses = [];
+  callCount = 0;
+  totalInputTokens = 0;
+  totalOutputTokens = 0;
+  calls = [];
+  /** Queue a response to return for the N-th call (0-indexed). */
+  queueByIndex(response) {
+    this.indexedResponses.push(response);
+    return this;
+  }
+  /** Queue a response to return when userMessage starts with the given prefix. */
+  queueByPrefix(prefix, response) {
+    this.prefixResponses.push({ prefix, response });
+    return this;
+  }
+  async chat(req) {
+    this.calls.push(req);
+    const idx = this.callCount++;
+    for (const matcher of this.prefixResponses) {
+      if (req.userMessage.startsWith(matcher.prefix) || req.systemPrompt.startsWith(matcher.prefix)) {
+        return this.buildResponse(matcher.response);
+      }
+    }
+    const indexed = this.indexedResponses[idx];
+    if (indexed) {
+      return this.buildResponse(indexed);
+    }
+    return this.buildResponse({ content: `mock-response-${idx}` });
+  }
+  buildResponse(r) {
+    const tokens = r.tokens ?? { input: 10, output: 5 };
+    this.totalInputTokens += tokens.input;
+    this.totalOutputTokens += tokens.output;
+    return { content: r.content, tokens };
+  }
+  /** Returns all recorded calls. */
+  getCalls() {
+    return this.calls;
+  }
+  /** Returns the number of chat() calls made. */
+  getCallCount() {
+    return this.callCount;
+  }
+  /** Assert the provider was called exactly N times. */
+  assertCallCount(expected) {
+    if (this.callCount !== expected) {
+      throw new Error(`Expected ${expected} LLM call(s), got ${this.callCount}`);
+    }
+  }
+  /** Assert accumulated token totals. */
+  assertTotalTokens(expected) {
+    if (expected.input !== void 0 && this.totalInputTokens !== expected.input) {
+      throw new Error(`Expected ${expected.input} input tokens, got ${this.totalInputTokens}`);
+    }
+    if (expected.output !== void 0 && this.totalOutputTokens !== expected.output) {
+      throw new Error(`Expected ${expected.output} output tokens, got ${this.totalOutputTokens}`);
+    }
+  }
+  getTotalTokens() {
+    return { input: this.totalInputTokens, output: this.totalOutputTokens };
+  }
+  reset() {
+    this.indexedResponses.length = 0;
+    this.prefixResponses.length = 0;
+    this.calls.length = 0;
+    this.callCount = 0;
+    this.totalInputTokens = 0;
+    this.totalOutputTokens = 0;
+  }
+};
+
+// src/testing/index.ts
+var __testingPlaceholder__ = /* @__PURE__ */ Symbol.for(
+  "@denisvieiradev/gitwise-core/testing#placeholder"
+);
+export {
+  MockLLMProvider,
+  __testingPlaceholder__
+};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/mock-llm-provider.ts","../../src/testing/index.ts"],"sourcesContent":["import type { LLMProvider, LLMChatRequest, LLMChatResponse } from \"../providers/types.js\";\n\nexport interface MockResponse {\n  content: string;\n  tokens?: { input: number; output: number };\n}\n\nexport interface PrefixMatcher {\n  prefix: string;\n  response: MockResponse;\n}\n\n/**\n * MockLLMProvider — deterministic LLM stub for tests.\n *\n * Usage:\n *   const mock = new MockLLMProvider();\n *   mock.queueByIndex({ content: \"result\" });                  // first call\n *   mock.queueByPrefix(\"Analyze\", { content: \"analysis\" });    // by prompt prefix\n *   await someFunction(mock);\n *   mock.assertCallCount(2);\n *   mock.assertTotalTokens({ input: 10, output: 5 });\n */\nexport class MockLLMProvider implements LLMProvider {\n  private readonly indexedResponses: MockResponse[] = [];\n  private readonly prefixResponses: PrefixMatcher[] = [];\n  private callCount = 0;\n  private totalInputTokens = 0;\n  private totalOutputTokens = 0;\n  private readonly calls: LLMChatRequest[] = [];\n\n  /** Queue a response to return for the N-th call (0-indexed). */\n  queueByIndex(response: MockResponse): this {\n    this.indexedResponses.push(response);\n    return this;\n  }\n\n  /** Queue a response to return when userMessage starts with the given prefix. */\n  queueByPrefix(prefix: string, response: MockResponse): this {\n    this.prefixResponses.push({ prefix, response });\n    return this;\n  }\n\n  async chat(req: LLMChatRequest): Promise<LLMChatResponse> {\n    this.calls.push(req);\n    const idx = this.callCount++;\n\n    // Prefix matching takes precedence\n    for (const matcher of this.prefixResponses) {\n      if (req.userMessage.startsWith(matcher.prefix) || req.systemPrompt.startsWith(matcher.prefix)) {\n        return this.buildResponse(matcher.response);\n      }\n    }\n\n    // Index-based fallback\n    const indexed = this.indexedResponses[idx];\n    if (indexed) {\n      return this.buildResponse(indexed);\n    }\n\n    // Default response\n    return this.buildResponse({ content: `mock-response-${idx}` });\n  }\n\n  private buildResponse(r: MockResponse): LLMChatResponse {\n    const tokens = r.tokens ?? { input: 10, output: 5 };\n    this.totalInputTokens += tokens.input;\n    this.totalOutputTokens += tokens.output;\n    return { content: r.content, tokens };\n  }\n\n  /** Returns all recorded calls. */\n  getCalls(): readonly LLMChatRequest[] {\n    return this.calls;\n  }\n\n  /** Returns the number of chat() calls made. */\n  getCallCount(): number {\n    return this.callCount;\n  }\n\n  /** Assert the provider was called exactly N times. */\n  assertCallCount(expected: number): void {\n    if (this.callCount !== expected) {\n      throw new Error(`Expected ${expected} LLM call(s), got ${this.callCount}`);\n    }\n  }\n\n  /** Assert accumulated token totals. */\n  assertTotalTokens(expected: { input?: number; output?: number }): void {\n    if (expected.input !== undefined && this.totalInputTokens !== expected.input) {\n      throw new Error(`Expected ${expected.input} input tokens, got ${this.totalInputTokens}`);\n    }\n    if (expected.output !== undefined && this.totalOutputTokens !== expected.output) {\n      throw new Error(`Expected ${expected.output} output tokens, got ${this.totalOutputTokens}`);\n    }\n  }\n\n  getTotalTokens(): { input: number; output: number } {\n    return { input: this.totalInputTokens, output: this.totalOutputTokens };\n  }\n\n  reset(): void {\n    this.indexedResponses.length = 0;\n    this.prefixResponses.length = 0;\n    this.calls.length = 0;\n    this.callCount = 0;\n    this.totalInputTokens = 0;\n    this.totalOutputTokens = 0;\n  }\n}\n","export const __testingPlaceholder__ = Symbol.for(\n  \"@denisvieiradev/gitwise-core/testing#placeholder\",\n);\n\nexport { MockLLMProvider } from \"./mock-llm-provider.js\";\nexport type { MockResponse, PrefixMatcher } from \"./mock-llm-provider.js\";\n"],"mappings":";AAuBO,IAAM,kBAAN,MAA6C;AAAA,EACjC,mBAAmC,CAAC;AAAA,EACpC,kBAAmC,CAAC;AAAA,EAC7C,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,oBAAoB;AAAA,EACX,QAA0B,CAAC;AAAA;AAAA,EAG5C,aAAa,UAA8B;AACzC,SAAK,iBAAiB,KAAK,QAAQ;AACnC,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,cAAc,QAAgB,UAA8B;AAC1D,SAAK,gBAAgB,KAAK,EAAE,QAAQ,SAAS,CAAC;AAC9C,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,KAAK,KAA+C;AACxD,SAAK,MAAM,KAAK,GAAG;AACnB,UAAM,MAAM,KAAK;AAGjB,eAAW,WAAW,KAAK,iBAAiB;AAC1C,UAAI,IAAI,YAAY,WAAW,QAAQ,MAAM,KAAK,IAAI,aAAa,WAAW,QAAQ,MAAM,GAAG;AAC7F,eAAO,KAAK,cAAc,QAAQ,QAAQ;AAAA,MAC5C;AAAA,IACF;AAGA,UAAM,UAAU,KAAK,iBAAiB,GAAG;AACzC,QAAI,SAAS;AACX,aAAO,KAAK,cAAc,OAAO;AAAA,IACnC;AAGA,WAAO,KAAK,cAAc,EAAE,SAAS,iBAAiB,GAAG,GAAG,CAAC;AAAA,EAC/D;AAAA,EAEQ,cAAc,GAAkC;AACtD,UAAM,SAAS,EAAE,UAAU,EAAE,OAAO,IAAI,QAAQ,EAAE;AAClD,SAAK,oBAAoB,OAAO;AAChC,SAAK,qBAAqB,OAAO;AACjC,WAAO,EAAE,SAAS,EAAE,SAAS,OAAO;AAAA,EACtC;AAAA;AAAA,EAGA,WAAsC;AACpC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,eAAuB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,gBAAgB,UAAwB;AACtC,QAAI,KAAK,cAAc,UAAU;AAC/B,YAAM,IAAI,MAAM,YAAY,QAAQ,qBAAqB,KAAK,SAAS,EAAE;AAAA,IAC3E;AAAA,EACF;AAAA;AAAA,EAGA,kBAAkB,UAAqD;AACrE,QAAI,SAAS,UAAU,UAAa,KAAK,qBAAqB,SAAS,OAAO;AAC5E,YAAM,IAAI,MAAM,YAAY,SAAS,KAAK,sBAAsB,KAAK,gBAAgB,EAAE;AAAA,IACzF;AACA,QAAI,SAAS,WAAW,UAAa,KAAK,sBAAsB,SAAS,QAAQ;AAC/E,YAAM,IAAI,MAAM,YAAY,SAAS,MAAM,uBAAuB,KAAK,iBAAiB,EAAE;AAAA,IAC5F;AAAA,EACF;AAAA,EAEA,iBAAoD;AAClD,WAAO,EAAE,OAAO,KAAK,kBAAkB,QAAQ,KAAK,kBAAkB;AAAA,EACxE;AAAA,EAEA,QAAc;AACZ,SAAK,iBAAiB,SAAS;AAC/B,SAAK,gBAAgB,SAAS;AAC9B,SAAK,MAAM,SAAS;AACpB,SAAK,YAAY;AACjB,SAAK,mBAAmB;AACxB,SAAK,oBAAoB;AAAA,EAC3B;AACF;;;AC9GO,IAAM,yBAAyB,uBAAO;AAAA,EAC3C;AACF;","names":[]}

package/dist/types-DnMpR1qf.d.ts

@@ -0,0 +1,29 @@
+type ModelTier = "fast" | "balanced" | "powerful";
+interface LLMChatRequest {
+    systemPrompt: string;
+    userMessage: string;
+    tier: ModelTier;
+}
+interface LLMChatResponse {
+    content: string;
+    tokens: {
+        input: number;
+        output: number;
+    };
+}
+interface LLMProvider {
+    chat(req: LLMChatRequest): Promise<LLMChatResponse>;
+}
+interface ModelConfig {
+    fast: string;
+    balanced: string;
+    powerful: string;
+}
+interface ProviderConfig {
+    kind: "api" | "claude-code";
+    models: ModelConfig;
+    apiKey?: string;
+    claudeCliPath?: string;
+}
+
+export type { LLMProvider as L, ModelTier as M, ProviderConfig as P, LLMChatRequest as a, LLMChatResponse as b, ModelConfig as c };

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@denisvieiradev/gitwise-core",
+  "version": "0.1.0",
+  "description": "Shared logic for gitwise: non-interactive commit/review/pr/release commands, LLM providers, git/github primitives, prompt templates.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "node --experimental-vm-modules ../../node_modules/.bin/jest --passWithNoTests",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "gitwise",
+    "git",
+    "ai",
+    "claude",
+    "commit",
+    "pull-request",
+    "release",
+    "code-review"
+  ],
+  "author": "Denis Vieira <denisvieira05@gmail.com> (https://github.com/denisvieiradev)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/denisvieiradev/gitwise.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/denisvieiradev/gitwise/issues"
+  },
+  "homepage": "https://github.com/denisvieiradev/gitwise#readme",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.109.0"
+  }
+}

package/templates/commit.md

@@ -0,0 +1 @@
+{{type}}({{scope}}): {{description}}

package/templates/pr.md

@@ -0,0 +1,11 @@
+## Summary
+
+{{summary}}
+
+## Changes
+
+{{changelog}}
+
+## Test Plan
+
+{{test_plan}}

package/templates/release-changelog.md

@@ -0,0 +1,19 @@
+You are a technical writer generating a changelog entry following the Keep a Changelog format (https://keepachangelog.com).
+
+Group changes under these sections (omit empty sections):
+### Added
+### Changed
+### Fixed
+### Removed
+### Deprecated
+### Security
+
+Rules:
+- Each entry is a bullet point starting with a verb in past tense
+- Be concise but specific; include scope when relevant (e.g., "Added `release` command for automated versioning")
+- Do NOT include commit hashes, author names, or dates
+- Do NOT include a version header — it will be added programmatically
+- Do NOT wrap the output in markdown fences
+- Collapse minor related changes into single entries when appropriate
+
+Project: {{projectName}}

package/templates/release-notes.md

@@ -0,0 +1,13 @@
+You are a product communications specialist writing user-facing release notes for version {{version}} of {{projectName}}.
+
+Write entirely in {{language}}.
+
+Rules:
+- Write for non-technical users (product managers, stakeholders, end users)
+- Focus on WHAT changed and WHY it matters, not HOW it was implemented
+- Use a friendly, professional tone
+- Start with a brief summary paragraph (2-3 sentences)
+- Then list highlights as bullet points
+- End with a brief closing note if appropriate
+- Do NOT include code snippets, file paths, commit hashes, or technical jargon
+- Do NOT wrap the output in markdown fences

package/templates/release-version.md

@@ -0,0 +1,11 @@
+You are a release engineer analyzing git commits to determine the appropriate semantic version bump.
+
+Rules:
+- MAJOR: breaking changes, removed public APIs, incompatible interface changes
+- MINOR: new features, new commands, new public APIs (backward compatible)
+- PATCH: bug fixes, documentation updates, refactoring, dependency updates, chore tasks
+
+Current version: {{currentVersion}}
+
+Analyze the commits below and respond with JSON only (no markdown fences, no extra text):
+{"suggestion": "major|minor|patch", "reasoning": "one sentence explaining why"}

package/templates/review.md

@@ -0,0 +1,19 @@
+You are a senior code reviewer. Analyze the diff and produce a code review with findings in these categories:
+
+## Critical
+Issues that must be fixed before merging (bugs, security, data loss).
+
+## Suggestions
+Improvements worth considering (performance, readability, patterns).
+
+## Nitpicks
+Minor style or convention issues.
+
+For each finding, include:
+- File and line reference
+- Description of the issue
+- Suggested fix
+
+End with a summary: total findings count per category and overall recommendation (approve, request changes).
+
+{{diff}}