@forwardimpact/libutil 0.1.90 → 0.1.92

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/libutil",
-  "version": "0.1.90",
+  "version": "0.1.92",
   "description": "Cross-cutting utilities: retry, hashing, token counting, and project discovery.",
   "keywords": [
     "util",
@@ -21,6 +21,7 @@
   "main": "./src/index.js",
   "exports": {
     ".": "./src/index.js",
+    "./models": "./src/models.js",
     "./runtime": "./src/runtime.js",
     "./trusted-origins": "./src/trusted-origins.js",
     "./completion-ticket": "./src/completion-ticket.js",

package/src/git-client.js

@@ -56,14 +56,17 @@ export class GitClient {
     return this.#runRaw(args, { cwd });
   }
 
-  /** Return `git status --porcelain` output. */
-  async status({ cwd }) {
-    return this.#runRaw(["status", "--porcelain"], { cwd });
+  /** Return `git status --porcelain` output, optionally limited to `paths`. */
+  async status({ cwd, paths } = {}) {
+    const args = ["status", "--porcelain"];
+    if (paths?.length) args.push("--", ...paths);
+    return this.#runRaw(args, { cwd });
   }
 
   /** Rebase the current branch onto `upstream`, optionally with a merge strategy. */
-  async rebase(upstream, { cwd, strategy } = {}) {
+  async rebase(upstream, { cwd, strategy, autostash = false } = {}) {
     const args = ["rebase"];
+    if (autostash) args.push("--autostash");
     if (strategy) args.push("-X", strategy);
     args.push(upstream);
     return this.#runRaw(args, { cwd, allowFailure: true });
@@ -75,8 +78,11 @@ export class GitClient {
   }
 
   /** Merge `ref` into the current branch resolving conflicts with `-X ours`. */
-  async mergeOursStrategy({ cwd, ref }) {
-    return this.#runRaw(["merge", "-X", "ours", "--no-edit", ref], { cwd });
+  async mergeOursStrategy({ cwd, ref, autostash = false }) {
+    const args = ["merge"];
+    if (autostash) args.push("--autostash");
+    args.push("-X", "ours", "--no-edit", ref);
+    return this.#runRaw(args, { cwd });
   }
 
   /** Stage all changes and commit with `message`. */
@@ -87,6 +93,19 @@ export class GitClient {
     return this.#runRaw(args, { cwd });
   }
 
+  /**
+   * Stage and commit only `paths`, leaving the rest of the working tree
+   * untouched. The commit carries the same pathspec so content staged by
+   * other writers is never swept in.
+   */
+  async commitPaths(message, paths, { cwd, author } = {}) {
+    await this.#runRaw(["add", "--", ...paths], { cwd });
+    const args = ["commit", "-m", message];
+    if (author) args.push("--author", author);
+    args.push("--", ...paths);
+    return this.#runRaw(args, { cwd });
+  }
+
   /** Push `branch` to `remote`. */
   async push(remote = "origin", branch, { cwd, force = false } = {}) {
     const args = ["push", remote];

package/src/models.js

@@ -0,0 +1,46 @@
+/**
+ * Canonical Claude model identifiers, named by role. One home for every
+ * model default in the monorepo — a model upgrade edits the values here
+ * (plus any docs flagged by `scripts/check-model-defaults.mjs`) and
+ * nothing else.
+ *
+ * Markdown docs cannot import these constants, so the invariant script
+ * cross-checks every model ID mentioned in docs and skills against the
+ * values exported below.
+ */
+
+/**
+ * Long-horizon agents under direct evaluation (eval sessions) — most
+ * capable model with the 1M-context suffix.
+ */
+export const AGENT_MODEL = "claude-fable-5[1m]";
+
+/**
+ * Lead roles — supervisor, facilitator, discussion lead, benchmark
+ * lead, and judge. Leads orchestrate whole multi-agent sessions, so
+ * they get the most capable model with the 1M-context suffix. The
+ * suffix is an Agent SDK identifier; use CHAT_MODEL or FAST_MODEL for
+ * direct Messages API calls.
+ */
+export const LEAD_MODEL = "claude-fable-5[1m]";
+
+/**
+ * Benchmark agent-under-test — a pinned reference model so pass@k
+ * results stay comparable across runs. Deliberately separate from
+ * AGENT_MODEL: upgrading the agent tier must not silently move the
+ * benchmark baseline.
+ */
+export const BENCHMARK_AGENT_MODEL = "claude-sonnet-4-6";
+
+/**
+ * Interactive chat (fit-guide) and direct Messages API calls — best
+ * speed/intelligence balance, valid both as an Agent SDK and a raw
+ * API model ID.
+ */
+export const CHAT_MODEL = "claude-sonnet-4-6";
+
+/**
+ * Cheap mechanical tasks (wiki prose fixes, synthetic-data generation)
+ * — fastest and most cost-effective model.
+ */
+export const FAST_MODEL = "claude-haiku-4-5";