@dombaras/agent-harness 0.1.6 → 0.1.7

package/README.md

@@ -123,6 +123,10 @@ npx @dombaras/agent-harness update --target /path/to/project
   modified harness files. Your unrelated uncommitted work is never staged.
   - `--no-commit` to skip commit+push, `--no-push` to commit but not push.
   - `init` never commits.
+  - Harness-owned paths are **force-added**, so a project that gitignores deployment
+    artifacts (an inherited `.agents/` `.opencode/` `AGENTS.md` pattern) still gets the
+    harness commit instead of a raw `git add` failure that silently skips it — force-added
+    files are called out in the summary.
 - **`[Nothing-to-Update]` confirmation**: if the target is already at this CLI's version and no
   harness-owned file changed, `update` says so explicitly, writes nothing, and makes no commit —
   a no-op is never mistaken for a sync and never churns `.harness.json`.

package/bin/agent-harness.js

@@ -210,9 +210,12 @@ function isGitRepo(target) {
 // project's next session never sees "unexplained" modified harness files. Scoped
 // to this run's changed harness files (never `git add -A`) so unrelated uncommitted
 // work is NEVER swept in. Memory/backup files are excluded (project data / rollback).
-// Returns { committed:boolean, staged:string[], skipped:string[], pushed:boolean|null }.
+// Harness-owned paths are force-added (`-f`): target projects often gitignore
+// .agents/ .opencode/ AGENTS.md (inherited from the harness's own .gitignore), and
+// a plain `git add` would fail on the first ignored path and commit NOTHING.
+// Returns { committed:boolean, staged:string[], skipped:string[], pushed:boolean|null, forceAdded:string[] }.
 function commitHarnessChanges(target, changedRels, opts) {
-  const out = { committed: false, staged: [], skipped: [], pushed: null };
+  const out = { committed: false, staged: [], skipped: [], pushed: null, forceAdded: [] };
   if (!opts.commit) return out;
   if (!isGitRepo(target)) {
     out.skipped.push("not a git repo");
@@ -222,9 +225,13 @@ function commitHarnessChanges(target, changedRels, opts) {
     out.skipped.push("no harness files changed");
     return out;
   }
-  const addR = runGit(target, ["add", "--", ...changedRels]);
+  const ignored = runGit(target, ["check-ignore", ...changedRels]);
+  if (ignored.ok && ignored.out) {
+    out.forceAdded = ignored.out.split(/\r?\n/).filter(Boolean).map(relKey);
+  }
+  const addR = runGit(target, ["add", "-f", "--", ...changedRels]);
   if (!addR.ok) {
-    out.skipped.push("git add failed: " + addR.err);
+    out.skipped.push("git add failed: " + firstGitErrorLine(addR.err));
     return out;
   }
   const diffCached = runGit(target, ["diff", "--cached", "--name-only"]);
@@ -238,7 +245,7 @@ function commitHarnessChanges(target, changedRels, opts) {
   const message = `chore(harness): @dombaras/agent-harness ${prior}${PKG.version}`;
   const commitR = runGit(target, ["commit", "-m", message]);
   if (!commitR.ok) {
-    out.skipped.push("commit failed: " + commitR.err);
+    out.skipped.push("commit failed: " + firstGitErrorLine(commitR.err));
     return out;
   }
   out.committed = true;
@@ -247,7 +254,7 @@ function commitHarnessChanges(target, changedRels, opts) {
     if (hasRemote) {
       const pushR = runGit(target, ["push", "origin", "HEAD"]);
       out.pushed = pushR.ok;
-      if (!pushR.ok) out.skipped.push("push failed: " + pushR.err);
+      if (!pushR.ok) out.skipped.push("push failed: " + firstGitErrorLine(pushR.err));
     } else {
       out.skipped.push("no git remote to push");
     }
@@ -255,6 +262,16 @@ function commitHarnessChanges(target, changedRels, opts) {
   return out;
 }
 
+/* Pull the first real error line out of git's stderr, dropping the LF/CRLF
+ * warnings and `hint:` noise that bury the actual message. */
+function firstGitErrorLine(err) {
+  const line = String(err || "")
+    .split(/\r?\n/)
+    .map((l) => l.trim())
+    .find((l) => l && !/^warning:/i.test(l) && !/^hint:/i.test(l));
+  return line || "git command failed";
+}
+
 // ---------------------------------------------------------------- deploy
 
 function backup(target, rel, content) {
@@ -537,6 +554,12 @@ function printCommitResult(result) {
   console.log("");
   if (c.committed) {
     console.log("  committed harness files: " + c.staged.join(", "));
+    if (c.forceAdded.length) {
+      console.log(
+        "  force-added (gitignored in this project, but harness-owned): " +
+          c.forceAdded.join(", ")
+      );
+    }
     console.log(
       c.pushed === true
         ? "  pushed to origin."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dombaras/agent-harness",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Reusable multi-agent harness for AI-assisted development: personas, skills, operating rules, model routing, and QA gates. Deploy into any project with `npx @dombaras/agent-harness init`.",
   "bin": {
     "agent-harness": "bin/agent-harness.js"