@klarkxy/dsh-git-commit 0.3.0 → 0.3.2

package/lib/contracts.js

@@ -1,35 +1,2 @@
-import { defaultModelRoute, normalizeModelRoute } from "@klarkxy/dsh-model-route";
-//#region src/contracts.ts
-const PLUGIN_NAME = "@klarkxy/dsh-git-commit";
-const FEATURE_ID = "git-commit";
-const PURPOSE_ID = "git-commit.plan";
-const RPC_CHANNEL = "/dsh-git-commit";
-const GIT_COMMIT_CLIENT_SERVICE = "dshGitCommitClient";
-const PROMPT_VERSION = "git-commit.v1";
-const SCHEMA_VERSION = "commit-plan-json.v1";
-const CONTRACT_VERSION = 1;
-const DEFAULT_MAX_OUTPUT_TOKENS = 2048;
-/** Total character budget for the change manifest sent to the model. */
-const MAX_MANIFEST_CHARS = 48e3;
-/** Per-file preview cap for untracked files. */
-const MAX_UNTRACKED_PREVIEW_CHARS = 2e3;
-/** Recent commit subjects supplied as style reference. */
-const RECENT_LOG_COUNT = 10;
-/** Hard cap for one generated commit message line. */
-const MAX_MESSAGE_CHARS = 120;
-/** git subprocess timeout. */
-const GIT_TIMEOUT_MS = 3e4;
-const SETTINGS_KEY = "current";
-const defaultSettings = () => ({
-	revision: 0,
-	model: defaultModelRoute(),
-	allowFallback: false
-});
-/** Untrusted stored flags stay opt-in: anything but a literal true is false. */
-function normalizeFallback(value) {
-	return value === true;
-}
-//#endregion
-export { CONTRACT_VERSION, DEFAULT_MAX_OUTPUT_TOKENS, FEATURE_ID, GIT_COMMIT_CLIENT_SERVICE, GIT_TIMEOUT_MS, MAX_MANIFEST_CHARS, MAX_MESSAGE_CHARS, MAX_UNTRACKED_PREVIEW_CHARS, PLUGIN_NAME, PROMPT_VERSION, PURPOSE_ID, RECENT_LOG_COUNT, RPC_CHANNEL, SCHEMA_VERSION, SETTINGS_KEY, defaultModelRoute, defaultSettings, normalizeFallback, normalizeModelRoute };
-
-//# sourceMappingURL=contracts.js.map
+import { _ as defaultSettings, a as GIT_COMMIT_CLIENT_SERVICE, c as MAX_MESSAGE_CHARS, d as PROMPT_VERSION, f as PURPOSE_ID, g as SETTINGS_KEY, h as SCHEMA_VERSION, i as FEATURE_ID, l as MAX_UNTRACKED_PREVIEW_CHARS, m as RPC_CHANNEL, n as CONTRACT_VERSION, o as GIT_TIMEOUT_MS, p as RECENT_LOG_COUNT, r as DEFAULT_MAX_OUTPUT_TOKENS, s as MAX_MANIFEST_CHARS, t as COMMIT_PLAN_FEATURE, u as PLUGIN_NAME, v as normalizeFallback, x as normalizeModelRoute, y as defaultModelRoute } from "./contracts2.js";
+export { COMMIT_PLAN_FEATURE, CONTRACT_VERSION, DEFAULT_MAX_OUTPUT_TOKENS, FEATURE_ID, GIT_COMMIT_CLIENT_SERVICE, GIT_TIMEOUT_MS, MAX_MANIFEST_CHARS, MAX_MESSAGE_CHARS, MAX_UNTRACKED_PREVIEW_CHARS, PLUGIN_NAME, PROMPT_VERSION, PURPOSE_ID, RECENT_LOG_COUNT, RPC_CHANNEL, SCHEMA_VERSION, SETTINGS_KEY, defaultModelRoute, defaultSettings, normalizeFallback, normalizeModelRoute };

package/lib/contracts2.d.ts

@@ -0,0 +1,2 @@
+import { C as SCHEMA_VERSION, E as normalizeFallback, O as defaultModelRoute, S as RpcResult, T as defaultSettings, _ as PROMPT_VERSION, a as CommitModelRoute, b as RECENT_LOG_COUNT, c as FEATURE_ID, d as GitCommitSettings, f as GitCommitStatus, g as PLUGIN_NAME, h as MAX_UNTRACKED_PREVIEW_CHARS, i as CommitModelInfo, k as normalizeModelRoute, l as GIT_COMMIT_CLIENT_SERVICE, m as MAX_MESSAGE_CHARS, n as CONTRACT_VERSION, o as CommitRunResult, p as MAX_MANIFEST_CHARS, r as CommitGroupResult, s as DEFAULT_MAX_OUTPUT_TOKENS, t as COMMIT_PLAN_FEATURE, u as GIT_TIMEOUT_MS, v as PURPOSE_ID, w as SETTINGS_KEY, x as RPC_CHANNEL, y as PartialCommitResult } from "./contracts.js";
+export { COMMIT_PLAN_FEATURE, CONTRACT_VERSION, CommitGroupResult, CommitModelInfo, CommitModelRoute, CommitRunResult, DEFAULT_MAX_OUTPUT_TOKENS, FEATURE_ID, GIT_COMMIT_CLIENT_SERVICE, GIT_TIMEOUT_MS, GitCommitSettings, GitCommitStatus, MAX_MANIFEST_CHARS, MAX_MESSAGE_CHARS, MAX_UNTRACKED_PREVIEW_CHARS, PLUGIN_NAME, PROMPT_VERSION, PURPOSE_ID, PartialCommitResult, RECENT_LOG_COUNT, RPC_CHANNEL, RpcResult, SCHEMA_VERSION, SETTINGS_KEY, defaultModelRoute, defaultSettings, normalizeFallback, normalizeModelRoute };

package/lib/contracts2.js

@@ -0,0 +1,85 @@
+//#region ../dsh-model-route/src/route.ts
+/** Empty route: no explicit model, the feature follows the host default. */
+function defaultModelRoute() {
+	return {
+		provider: "",
+		model: ""
+	};
+}
+const MAX_ID_CHARS = 250;
+const MAX_EFFORT_CHARS = 80;
+function asText(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+/**
+* Coerce a stored value into a ModelRoute. Anything malformed collapses to the
+* empty route, matching the per-plugin normalizers this contract replaces.
+*/
+function normalizeModelRoute(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return defaultModelRoute();
+	const row = value;
+	const provider = asText(row.provider) ?? "";
+	const model = asText(row.model) ?? "";
+	const effort = asText(row.reasoningEffort);
+	if (!provider || !model || provider.length > MAX_ID_CHARS || model.length > MAX_ID_CHARS) return defaultModelRoute();
+	return effort && effort.length <= MAX_EFFORT_CHARS ? {
+		provider,
+		model,
+		reasoningEffort: effort
+	} : {
+		provider,
+		model
+	};
+}
+/** The override to actually call with: undefined when the route is empty. */
+function modelRouteOverride(route) {
+	const provider = route?.provider?.trim();
+	const model = route?.model?.trim();
+	if (!provider || !model) return void 0;
+	const effort = route?.reasoningEffort?.trim();
+	return effort ? {
+		provider,
+		model,
+		reasoningEffort: effort
+	} : {
+		provider,
+		model
+	};
+}
+//#endregion
+//#region src/contracts.ts
+const PLUGIN_NAME = "@klarkxy/dsh-git-commit";
+const FEATURE_ID = "git-commit";
+const PURPOSE_ID = "git-commit.plan";
+const RPC_CHANNEL = "/dsh-git-commit";
+const GIT_COMMIT_CLIENT_SERVICE = "dshGitCommitClient";
+const PROMPT_VERSION = "git-commit.v1";
+/** Feature id stamped on the auxiliary-context envelope for this call. */
+const COMMIT_PLAN_FEATURE = "git-commit-plan";
+const SCHEMA_VERSION = "commit-plan-json.v1";
+const CONTRACT_VERSION = 1;
+const DEFAULT_MAX_OUTPUT_TOKENS = 2048;
+/** Total character budget for the change manifest sent to the model. */
+const MAX_MANIFEST_CHARS = 48e3;
+/** Per-file preview cap for untracked files. */
+const MAX_UNTRACKED_PREVIEW_CHARS = 2e3;
+/** Recent commit subjects supplied as style reference. */
+const RECENT_LOG_COUNT = 10;
+/** Hard cap for one generated commit message line. */
+const MAX_MESSAGE_CHARS = 120;
+/** git subprocess timeout. */
+const GIT_TIMEOUT_MS = 3e4;
+const SETTINGS_KEY = "current";
+const defaultSettings = () => ({
+	revision: 0,
+	model: defaultModelRoute(),
+	allowFallback: false
+});
+/** Untrusted stored flags stay opt-in: anything but a literal true is false. */
+function normalizeFallback(value) {
+	return value === true;
+}
+//#endregion
+export { defaultSettings as _, GIT_COMMIT_CLIENT_SERVICE as a, modelRouteOverride as b, MAX_MESSAGE_CHARS as c, PROMPT_VERSION as d, PURPOSE_ID as f, SETTINGS_KEY as g, SCHEMA_VERSION as h, FEATURE_ID as i, MAX_UNTRACKED_PREVIEW_CHARS as l, RPC_CHANNEL as m, CONTRACT_VERSION as n, GIT_TIMEOUT_MS as o, RECENT_LOG_COUNT as p, DEFAULT_MAX_OUTPUT_TOKENS as r, MAX_MANIFEST_CHARS as s, COMMIT_PLAN_FEATURE as t, PLUGIN_NAME as u, normalizeFallback as v, normalizeModelRoute as x, defaultModelRoute as y };
+
+//# sourceMappingURL=contracts2.js.map

package/lib/contracts2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts2.js","names":[],"sources":["../../dsh-model-route/src/route.ts","../src/contracts.ts"],"sourcesContent":["/**\n * Shared model-route value contract.\n *\n * A feature plugin stores its model override as a ModelRoute on its own\n * settings page. Empty provider/model means \"follow the host default model\".\n * Pure and browser-safe: no cordis, no React, no schema library.\n */\n\n/** A concrete provider model a feature call should use. */\nexport interface ModelRoute {\n  provider: string\n  model: string\n  reasoningEffort?: string\n}\n\n/** Empty route: no explicit model, the feature follows the host default. */\nexport function defaultModelRoute(): ModelRoute {\n  return { provider: '', model: '' }\n}\n\n/** Structural check: both id fields are strings (either may be empty). */\nexport function isModelRouteValue(value: unknown): value is ModelRoute {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return false\n  const row = value as Record<string, unknown>\n  return typeof row.provider === 'string' && typeof row.model === 'string'\n}\n\nconst MAX_ID_CHARS = 250\nconst MAX_EFFORT_CHARS = 80\n\nfunction asText(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value.trim() : undefined\n}\n\n/**\n * Coerce a stored value into a ModelRoute. Anything malformed collapses to the\n * empty route, matching the per-plugin normalizers this contract replaces.\n */\nexport function normalizeModelRoute(value: unknown): ModelRoute {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return defaultModelRoute()\n  const row = value as Record<string, unknown>\n  const provider = asText(row.provider) ?? ''\n  const model = asText(row.model) ?? ''\n  const effort = asText(row.reasoningEffort)\n  if (!provider || !model || provider.length > MAX_ID_CHARS || model.length > MAX_ID_CHARS) return defaultModelRoute()\n  return effort && effort.length <= MAX_EFFORT_CHARS ? { provider, model, reasoningEffort: effort } : { provider, model }\n}\n\n/** The override to actually call with: undefined when the route is empty. */\nexport function modelRouteOverride(route: ModelRoute | undefined): ModelRoute | undefined {\n  const provider = route?.provider?.trim()\n  const model = route?.model?.trim()\n  if (!provider || !model) return undefined\n  const effort = route?.reasoningEffort?.trim()\n  return effort ? { provider, model, reasoningEffort: effort } : { provider, model }\n}\n\nconst KEY_SEPARATOR = '\\u001f'\n\n/** Stable key for one route, safe to use as a select-option value. */\nexport function modelRouteKey(provider: string, model: string): string {\n  return provider && model ? `${provider}${KEY_SEPARATOR}${model}` : ''\n}\n\n/** Inverse of modelRouteKey; undefined for malformed keys. */\nexport function parseModelRouteKey(value: string): { provider: string; model: string } | undefined {\n  const index = value.indexOf(KEY_SEPARATOR)\n  if (index <= 0) return undefined\n  const provider = value.slice(0, index)\n  const model = value.slice(index + KEY_SEPARATOR.length)\n  if (!provider || !model) return undefined\n  return { provider, model }\n}\n\n/** True when both routes name the same target; two empty routes are equal. */\nexport function sameModelRoute(a: ModelRoute | undefined, b: ModelRoute | undefined): boolean {\n  const left = modelRouteOverride(a)\n  const right = modelRouteOverride(b)\n  if (!left || !right) return !left === !right\n  return left.provider === right.provider && left.model === right.model\n    && (left.reasoningEffort ?? '') === (right.reasoningEffort ?? '')\n}\n","import { defaultModelRoute, normalizeModelRoute, type ModelRoute } from '@klarkxy/dsh-model-route'\nexport { defaultModelRoute, normalizeModelRoute }\n\n/** Browser-safe contracts. Shared RPC/result types stay on @klarkxy/dsh-plugin-kit. */\nimport type { RpcResult as SharedRpcResult } from '@klarkxy/dsh-plugin-kit/contracts'\nexport type RpcResult<T = unknown> = Extract<SharedRpcResult<T>, { ok: true }> | {\n  ok: false\n  error: { code: string; message: string; partial?: PartialCommitResult }\n}\n\nexport const PLUGIN_NAME = '@klarkxy/dsh-git-commit'\nexport const FEATURE_ID = 'git-commit'\nexport const PURPOSE_ID = 'git-commit.plan'\nexport const RPC_CHANNEL = '/dsh-git-commit'\nexport const GIT_COMMIT_CLIENT_SERVICE = 'dshGitCommitClient'\nexport const PROMPT_VERSION = 'git-commit.v1'\n/** Feature id stamped on the auxiliary-context envelope for this call. */\nexport const COMMIT_PLAN_FEATURE = 'git-commit-plan'\nexport const SCHEMA_VERSION = 'commit-plan-json.v1'\nexport const CONTRACT_VERSION = 1\n\nexport const DEFAULT_MAX_OUTPUT_TOKENS = 2048\n/** Total character budget for the change manifest sent to the model. */\nexport const MAX_MANIFEST_CHARS = 48_000\n/** Per-file preview cap for untracked files. */\nexport const MAX_UNTRACKED_PREVIEW_CHARS = 2_000\n/** Recent commit subjects supplied as style reference. */\nexport const RECENT_LOG_COUNT = 10\n/** Hard cap for one generated commit message line. */\nexport const MAX_MESSAGE_CHARS = 120\n/** git subprocess timeout. */\nexport const GIT_TIMEOUT_MS = 30_000\nexport const SETTINGS_KEY = 'current'\n\n/**\n * Plugin-page model selection. Empty provider/model means \"follow the default\".\n * The value shape, empty default, and 250/80 normalizer live in\n * @klarkxy/dsh-model-route; this alias keeps the commit-specific name.\n */\nexport type CommitModelRoute = ModelRoute\n\nexport interface GitCommitSettings {\n  readonly revision: number\n  readonly model: CommitModelRoute\n  /**\n   * Opt-in single commit when the model produced no usable plan. Off by\n   * default: an unplanned commit is one the user never reviewed, so a failed\n   * or unusable model call rejects the run instead of writing to the index.\n   */\n  readonly allowFallback: boolean\n}\n\nexport const defaultSettings = (): GitCommitSettings => ({\n  revision: 0, model: defaultModelRoute(), allowFallback: false,\n})\n\n/** Untrusted stored flags stay opt-in: anything but a literal true is false. */\nexport function normalizeFallback(value: unknown): boolean {\n  return value === true\n}\n\nexport interface CommitModelInfo {\n  readonly provider: string\n  readonly model: string\n  /** 'page' is the plugin-page selection; 'aux' the shared default auxiliary model; 'default' follows the session or host chat model. */\n  readonly source: 'page' | 'aux' | 'default'\n}\n\nexport interface GitCommitStatus {\n  readonly available: boolean\n  /** Machine-readable reason when unavailable: 'no-session' | 'no-cwd' | 'not-a-repo' | 'no-git'. */\n  readonly reason?: string\n  readonly detail?: string\n  readonly root?: string\n  readonly branch?: string\n  readonly workspace: { readonly files: number }\n  readonly model?: CommitModelInfo\n}\n\nexport interface CommitGroupResult {\n  /** Empty only when a created commit's hash could not be read. */\n  readonly hash: string\n  readonly message: string\n  readonly files: readonly string[]\n}\n\nexport interface CommitRunResult {\n  readonly branch: string\n  readonly commits: readonly CommitGroupResult[]\n  /** True when the model plan was unavailable and a single fallback commit was used. */\n  readonly fallback: boolean\n  readonly model?: CommitModelInfo\n}\n\n/**\n * Commits that already exist when a later group fails or the run is cancelled.\n * `commits` is the durable outcome; `failure` is why the rest did not run.\n * A recorded commit is never rolled back and never retried by this plugin.\n */\nexport interface PartialCommitResult {\n  readonly branch: string\n  readonly commits: readonly CommitGroupResult[]\n  readonly fallback: boolean\n  readonly model?: CommitModelInfo\n  readonly failure: { readonly code: string; readonly message: string }\n  readonly remaining: readonly { readonly message: string; readonly files: readonly string[] }[]\n  /** After a rejected commit command, unchanged HEAD could not be proved; completion and ownership are unconfirmed. */\n  readonly uncertain?: readonly { readonly message: string; readonly files: readonly string[] }[]\n}\n"],"mappings":";;AAgBA,SAAgB,oBAAgC;CAC9C,OAAO;EAAE,UAAU;EAAI,OAAO;CAAG;AACnC;AASA,MAAM,eAAe;AACrB,MAAM,mBAAmB;AAEzB,SAAS,OAAO,OAAoC;CAClD,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,IAAI,MAAM,KAAK,IAAI,KAAA;AACpE;;;;;AAMA,SAAgB,oBAAoB,OAA4B;CAC9D,IAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG,OAAO,kBAAkB;CAC1F,MAAM,MAAM;CACZ,MAAM,WAAW,OAAO,IAAI,QAAQ,KAAK;CACzC,MAAM,QAAQ,OAAO,IAAI,KAAK,KAAK;CACnC,MAAM,SAAS,OAAO,IAAI,eAAe;CACzC,IAAI,CAAC,YAAY,CAAC,SAAS,SAAS,SAAS,gBAAgB,MAAM,SAAS,cAAc,OAAO,kBAAkB;CACnH,OAAO,UAAU,OAAO,UAAU,mBAAmB;EAAE;EAAU;EAAO,iBAAiB;CAAO,IAAI;EAAE;EAAU;CAAM;AACxH;;AAGA,SAAgB,mBAAmB,OAAuD;CACxF,MAAM,WAAW,OAAO,UAAU,KAAK;CACvC,MAAM,QAAQ,OAAO,OAAO,KAAK;CACjC,IAAI,CAAC,YAAY,CAAC,OAAO,OAAO,KAAA;CAChC,MAAM,SAAS,OAAO,iBAAiB,KAAK;CAC5C,OAAO,SAAS;EAAE;EAAU;EAAO,iBAAiB;CAAO,IAAI;EAAE;EAAU;CAAM;AACnF;;;AC7CA,MAAa,cAAc;AAC3B,MAAa,aAAa;AAC1B,MAAa,aAAa;AAC1B,MAAa,cAAc;AAC3B,MAAa,4BAA4B;AACzC,MAAa,iBAAiB;;AAE9B,MAAa,sBAAsB;AACnC,MAAa,iBAAiB;AAC9B,MAAa,mBAAmB;AAEhC,MAAa,4BAA4B;;AAEzC,MAAa,qBAAqB;;AAElC,MAAa,8BAA8B;;AAE3C,MAAa,mBAAmB;;AAEhC,MAAa,oBAAoB;;AAEjC,MAAa,iBAAiB;AAC9B,MAAa,eAAe;AAoB5B,MAAa,yBAA4C;CACvD,UAAU;CAAG,OAAO,kBAAkB;CAAG,eAAe;AAC1D;;AAGA,SAAgB,kBAAkB,OAAyB;CACzD,OAAO,UAAU;AACnB"}

package/lib/index.d.ts

@@ -1,6 +1,8 @@
-import { CommitRunResult, GitCommitSettings, GitCommitStatus, RpcResult, defaultSettings, normalizeFallback, normalizeModelRoute } from "./contracts.js";
-import { LlmTextCaller } from "@klarkxy/dsh-plugin-kit";
+import { D as LlmRuntime, E as normalizeFallback, S as RpcResult, T as defaultSettings, d as GitCommitSettings, f as GitCommitStatus, k as normalizeModelRoute, o as CommitRunResult } from "./contracts.js";
 import { Context } from "@deepseek-ai/cordis";
+//#region ../dsh-plugin-kit/src/llm-call.d.ts
+type LlmTextCaller = Pick<LlmRuntime, 'prepareCall' | 'resolveCallConfig'>;
+//#endregion
 //#region src/git.d.ts
 interface GitRunOptions {
   readonly cwd: string;
@@ -105,6 +107,11 @@ interface PlanInput {
   readonly diff: string;
   readonly untracked: readonly UntrackedPreview[];
 }
+/**
+ * The complete single-message input kept for callers that cannot split
+ * stable context from the live request; identical material to
+ * buildPlanContext + buildPlanText laid out in the same order as before.
+ */
 declare function buildPlanInput(input: PlanInput): string;
 /**
  * Validate the model plan against the exact change set. Returns undefined when
@@ -121,7 +128,7 @@ declare module '@deepseek-ai/cordis' {
   }
 }
 declare function handleRpc(service: GitCommitService, endpoint: string, payload: unknown, signal: AbortSignal): Promise<RpcResult>;
-declare function apply(ctx: Context): void;
+declare function apply(ctx: Context): Promise<void>;
 //#endregion
 export { GitCommitService, apply, buildPlanInput, defaultSettings, handleRpc, inject, name, normalizeFallback, normalizeModelRoute, parsePlan, parsePorcelain };
 //# sourceMappingURL=index.d.ts.map