@denisvieiradev/gitwise-core 0.1.0 → 1.3.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { L as LLMProvider, P as ProviderConfig, M as ModelTier } from './types-DnMpR1qf.js';
-export { a as LLMChatRequest, b as LLMChatResponse, c as ModelConfig } from './types-DnMpR1qf.js';
+import { P as ProviderKind, L as LLMProvider, a as ProviderConfig, M as ModelTier } from './types-BURqSokx.js';
+export { b as LLMChatRequest, c as LLMChatResponse, d as ModelConfig, e as PROVIDER_KINDS } from './types-BURqSokx.js';
 
 declare const EXIT_CODES: Readonly<Record<string, number>>;
 interface GitwiseErrorArgs {
@@ -283,6 +283,12 @@ declare function acquireRepoLock(repoPath: string, options?: AcquireRepoLockOpti
 
 declare function resolveClaudeBinary(customPath?: string): string | null;
 
+declare function resolveCodexBinary(customPath?: string): string | null;
+
+declare function resolveCopilotBinary(customPath?: string): string | null;
+
+declare function resolveKiroBinary(customPath?: string): string | null;
+
 /**
  * Release-lifecycle strategy abstraction. Narrow on purpose (per ADR-002):
  * it covers branch creation, merge targets, and the develop-branch requirement
@@ -307,18 +313,24 @@ interface ModelConfig {
     balanced: string;
     powerful: string;
 }
+/** MDL-01: per-provider model map — each ProviderKind keeps its own tier IDs. */
+type ModelsByProvider = Record<ProviderKind, ModelConfig>;
 /** Persisted in ~/.gitwise/config.json */
 interface UserConfig {
-    provider: "api" | "claude-code";
+    provider: ProviderKind;
     claudeCliPath?: string;
-    models: ModelConfig;
+    codexCliPath?: string;
+    copilotCliPath?: string;
+    kiroCliPath?: string;
+    models: ModelsByProvider;
     language: Language;
     defaultBaseBranch?: string;
     commitConvention: CommitConvention;
 }
 /** Loaded from <cwd>/.gitwise.json — all fields are optional */
 interface RepoConfig {
-    models?: Partial<ModelConfig>;
+    /** Flat tiers apply to the active provider; provider-keyed blocks target that provider and win over flat tiers. */
+    models?: Partial<ModelConfig> & Partial<Record<ProviderKind, Partial<ModelConfig>>>;
     language?: Language;
     defaultBaseBranch?: string;
     commitConvention?: CommitConvention;
@@ -409,6 +421,8 @@ interface CommitPlan {
         input: number;
         output: number;
     };
+    /** AD-002: false when the active provider doesn't report token usage. */
+    tokensAvailable: boolean;
 }
 type SplitMode = "auto" | "never" | "always";
 interface CommitOptions {
@@ -430,6 +444,8 @@ interface CommitAlternatives {
         input: number;
         output: number;
     };
+    /** AD-002: false when the active provider doesn't report token usage. */
+    tokensAvailable: boolean;
 }
 interface ApplyCommitPlanOptions {
     push?: boolean;
@@ -505,6 +521,8 @@ interface ReviewResult {
         input: number;
         output: number;
     };
+    /** AD-002: false when the active provider doesn't report token usage. */
+    tokensAvailable: boolean;
 }
 interface ReviewOptions {
     cwd: string;
@@ -525,6 +543,8 @@ interface PrDraft {
         input: number;
         output: number;
     };
+    /** AD-002: false when the active provider doesn't report token usage. */
+    tokensAvailable: boolean;
 }
 interface PrOptions {
     cwd: string;
@@ -567,6 +587,12 @@ interface PersistedReleasePlan {
         input: number;
         output: number;
     };
+    /**
+     * AD-002: false when the active provider didn't report token usage.
+     * Missing on a plan persisted before this field existed — the validator
+     * (isPersistedReleasePlan) defaults an absent field to `true` (T15).
+     */
+    tokensAvailable: boolean;
 }
 declare function saveReleasePlan(cwd: string, plan: PersistedReleasePlan): Promise<void>;
 declare function loadReleasePlan(cwd: string): Promise<PersistedReleasePlan | null>;
@@ -591,6 +617,13 @@ interface ReleasePlan {
         input: number;
         output: number;
     };
+    /**
+     * AD-002: the logical AND of every contributing LLM call's tokensAvailable
+     * (version-suggestion, changelog, notes) — false if any of them didn't
+     * report usage. In practice always uniform within one run, since a run
+     * uses exactly one provider.
+     */
+    tokensAvailable: boolean;
 }
 interface ReleaseOptions {
     cwd: string;
@@ -721,7 +754,12 @@ interface FinishReleaseOptions {
  * failed strategy merge (typically gitflow's develop merge when develop has
  * advanced) surfaces as `FINISH_MERGE_CONFLICT` — the repo is left mid-merge
  * for manual recovery (`git merge --continue` then tag + push by hand) since
- * the plan can no longer be re-run.
+ * the plan can no longer be re-run. A failure in step 9 (tag creation, or a
+ * rejected push — typically a non-fast-forward because origin's mainBranch
+ * advanced, e.g. a CI bot commit, while this release was being prepared or
+ * finished) surfaces as `FINISH_PUSH_FAILED` with the exact fetch/merge/push
+ * recovery commands embedded in the message; merge (never rebase) is required
+ * because the tag, if already created, is pinned to the release commit's hash.
  */
 declare function finishRelease(opts: FinishReleaseOptions): Promise<void>;
 interface AbortReleaseOptions {
@@ -784,19 +822,7 @@ interface RunReleaseInProcessOptions extends PrepareReleaseOptions {
  * caller declined via `confirm`.
  */
 declare function runReleaseInProcess(opts: RunReleaseInProcessOptions): Promise<PersistedReleasePlan | null>;
-/**
- * Step factory for atomically bumping the `version` field of a single
- * manifest (package.json or sibling plugin.json) under a {@link Transaction}.
- *
- * `apply` reads the manifest's prior bytes (Buffer, not parsed JSON, so any
- * trailing newline or formatting in the on-disk file is preserved verbatim
- * for rollback), rewrites the `version` field in place via `writeJSON`, and
- * returns the captured prior bytes as the step result. `compensate` writes
- * those bytes back, restoring the file byte-for-byte regardless of what the
- * apply path produced. Steps are intended to run sequentially so ordering is
- * deterministic per ADR-004.
- */
-declare function writeWorkspaceVersionStep(manifestPath: string, newVersion: string): Step<Buffer>;
+declare function writeWorkspaceVersionStep(manifestPath: string, newVersion: string, workspaceNames?: ReadonlySet<string>): Step<Buffer>;
 /**
  * Propagate `version` into every workspace manifest under a {@link Transaction}
  * so that a write failure on `packages[N]/package.json` reliably restores the
@@ -828,7 +854,21 @@ declare function propagateVersionToWorkspaces(cwd: string, version: string): Pro
  */
 declare function detectWorkspaceRoot(cwd: string): Promise<boolean>;
 
+declare function formatTokens(tokens: {
+    input: number;
+    output: number;
+}, tokensAvailable: boolean): string;
+
 declare function createProvider(config: ProviderConfig): LLMProvider;
+/**
+ * The single place that turns a MergedConfig (+ optional API key) into the
+ * ProviderConfig createProvider() expects — narrowing the per-provider
+ * `models` map down to the active provider's tier block and threading every
+ * per-tool CLI path field through. Replaces the 8 duplicated inline
+ * `{ kind: config.provider, models: config.models, ... }` object literals
+ * that predated the per-provider models map (MDL-03, MDL-04).
+ */
+declare function buildProviderConfig(merged: MergedConfig, apiKey?: string): ProviderConfig;
 
 declare const COMMAND_TIER_MAP: Record<string, ModelTier>;
 declare function resolveModelTier(command: string): ModelTier;
@@ -837,4 +877,4 @@ declare const SUPPORTED_COMMANDS: (keyof typeof COMMAND_TIER_MAP)[];
 declare const version: string;
 declare const __placeholder__: unique symbol;
 
-export { type AbortReleaseOptions, type AcquireRepoLockOptions, type ApplyCommitParams, type ApplyCommitPlanOptions, type ApplyPrOptions, type ApplyPrResult, type ApplyReleaseOptions, type BumpType, type ChangedFile, type CommitAlternatives, type CommitConvention, type CommitEntry, type CommitOptions, type CommitPlan, type CommitStepResult, type ModelConfig as ConfigModelConfig, type CreatePRParams, type CreateReleaseParams, DEFAULT_USER_CONFIG, EXIT_CODES, type FinishReleaseOptions, GitwiseError, type GitwiseErrorArgs, LLMProvider, type Language, type LoadTemplateOptions, type LockPayload, type Logger, type MergedConfig, ModelTier, type PRResult, type PersistedReleasePlan, type PrDraft, type PrOptions, type PrepareReleaseOptions, ProviderConfig, type ReleaseOptions, type ReleasePlan, type ReleaseStrategy, type ReleaseStrategyName, type RepoConfig, type ReviewFinding, type ReviewOptions, type ReviewResult, type RollbackFailure, type RollbackResult, type RunReleaseInProcessOptions, STALE_LOCK_MS, SUPPORTED_COMMANDS, type SplitMode, type Step, Transaction, type UpdatePRParams, type UserConfig, __placeholder__, abortRelease, acquireRepoLock, applyCommitPlan, applyOneCommitStep, applyPr, applyRelease, bumpVersion, commit, createProvider, createReleaseStrategy, debug, deleteReleasePlan, detectWorkspaceRoot, ensureDir, ensureGitignored, env, error, fileExists, finishRelease, getApiKey, getMergedConfig, git, github, heuristicBump, info, interpolate, isVerbose, loadAndInterpolate, loadReleasePlan, loadTemplate, parseCommitResponse, pr, prepareRelease, propagateVersionToWorkspaces, readJSON, readRepoConfig, readUserConfig, release, resolveClaudeBinary, resolveModelTier, review, runReleaseInProcess, saveReleasePlan, setVerbose, stashList, takeNamedStashStep, version, warn, wrapError, writeApiKey, writeJSON, writeUserConfig, writeWorkspaceVersionStep };
+export { type AbortReleaseOptions, type AcquireRepoLockOptions, type ApplyCommitParams, type ApplyCommitPlanOptions, type ApplyPrOptions, type ApplyPrResult, type ApplyReleaseOptions, type BumpType, type ChangedFile, type CommitAlternatives, type CommitConvention, type CommitEntry, type CommitOptions, type CommitPlan, type CommitStepResult, type ModelConfig as ConfigModelConfig, type CreatePRParams, type CreateReleaseParams, DEFAULT_USER_CONFIG, EXIT_CODES, type FinishReleaseOptions, GitwiseError, type GitwiseErrorArgs, LLMProvider, type Language, type LoadTemplateOptions, type LockPayload, type Logger, type MergedConfig, ModelTier, type ModelsByProvider, type PRResult, type PersistedReleasePlan, type PrDraft, type PrOptions, type PrepareReleaseOptions, ProviderConfig, ProviderKind, type ReleaseOptions, type ReleasePlan, type ReleaseStrategy, type ReleaseStrategyName, type RepoConfig, type ReviewFinding, type ReviewOptions, type ReviewResult, type RollbackFailure, type RollbackResult, type RunReleaseInProcessOptions, STALE_LOCK_MS, SUPPORTED_COMMANDS, type SplitMode, type Step, Transaction, type UpdatePRParams, type UserConfig, __placeholder__, abortRelease, acquireRepoLock, applyCommitPlan, applyOneCommitStep, applyPr, applyRelease, buildProviderConfig, bumpVersion, commit, createProvider, createReleaseStrategy, debug, deleteReleasePlan, detectWorkspaceRoot, ensureDir, ensureGitignored, env, error, fileExists, finishRelease, formatTokens, getApiKey, getMergedConfig, git, github, heuristicBump, info, interpolate, isVerbose, loadAndInterpolate, loadReleasePlan, loadTemplate, parseCommitResponse, pr, prepareRelease, propagateVersionToWorkspaces, readJSON, readRepoConfig, readUserConfig, release, resolveClaudeBinary, resolveCodexBinary, resolveCopilotBinary, resolveKiroBinary, resolveModelTier, review, runReleaseInProcess, saveReleasePlan, setVerbose, stashList, takeNamedStashStep, version, warn, wrapError, writeApiKey, writeJSON, writeUserConfig, writeWorkspaceVersionStep };