@forwardimpact/libutil 0.1.91 → 0.1.93

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/libutil",
-  "version": "0.1.91",
+  "version": "0.1.93",
   "description": "Cross-cutting utilities: retry, hashing, token counting, and project discovery.",
   "keywords": [
     "util",

package/src/calendar.js

@@ -3,7 +3,7 @@
 // Every `new Date(...)` here operates only on a value the caller passed (a ms
 // timestamp, a `Date`, or an ISO string) — never the ambient wall clock, which
 // lives behind `runtime.clock.now()`. That is why this module is allow-listed
-// in `scripts/check-ambient-deps.allow.yml` for the same reason `runtime.js`
+// in `.coaligned/invariants/ambient-deps.allow.yml` for the same reason `runtime.js`
 // is: it produces deterministic time values from its arguments rather than
 // reaching for an ambient dependency. Consumers read "now" from
 // `runtime.clock.now()` and pass the result here when they need a formatted or

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

@@ -1,8 +1,8 @@
 /**
  * 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.
+ * (plus any docs flagged by `.coaligned/invariants/model-defaults.rules.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