@awebai/oats 0.29.0 → 0.29.1

package/bin/oats.mjs

@@ -958,7 +958,8 @@ function instanceCmd() {
       console.log(`  upstream: ${observed.upstream.ref ? `${observed.upstream.ref} +${observed.upstream.ahead} -${observed.upstream.behind}` : "none (ahead/behind unknown)"}`);
       console.log(`  base: ${observed.base.ref ? `${observed.base.ref} +${observed.base.ahead} -${observed.base.behind} (merge-base ${observed.base.mergeBase?.slice(0, 12)})` : "unknown"}`);
       console.log(`  files: ${observed.files.length} (${Object.entries(observed.summary).filter(([, n]) => n).map(([k, n]) => `${n} ${k}`).join(", ") || "clean"})`);
-      for (const f of observed.files) console.log(`    ${f.xy} ${f.origPath ? `${f.origPath} -> ` : ""}${f.path}  [${f.id}]`);
+      const lines = (f) => (f.binary ? "  binary" : Number.isInteger(f.additions) ? `  +${f.additions} -${f.deletions}` : "");
+      for (const f of observed.files) console.log(`    ${f.xy} ${f.origPath ? `${f.origPath} -> ` : ""}${f.path}${lines(f)}  [${f.id}]`);
       for (const n of observed.notes) console.log(`  note: ${n}`);
       return;
     }

package/docs/desktop-cli-api.md

@@ -19,9 +19,12 @@ prints exactly one JSON object on stdout:
 
 `version` is the installed package's exact semver (e.g. `0.20.0`).
 The Desktop accepts `desktopApi === 1` and gates on the kernel feature
-`packages-no-approval` (semver range `>=0.25.8 <0.27.0`: the floor admits the
-main-branch kernel before 0.26.0 is tagged; the feature fence is the real gate).
-Earlier bands were `>=0.22.0 <0.26.0` (Desktop 0.25) and `>=0.22.0 <0.24.0`
+`packages-no-approval` (semver range `>=0.25.8 <0.30.0`, spelled once in
+`packages/desktop/cli-locator.mjs` `ACCEPT_RANGE`: the floor admits the
+main-branch kernel before 0.26.0 was tagged; the feature fences are the real gate,
+and 0.29's reads are gated on `automations` and `desktop-facts`).
+Earlier bands were `>=0.25.8 <0.29.0` (Desktop 0.28), `<0.28.0` (Desktop 0.27),
+`<0.27.0` (Desktop 0.26), `>=0.22.0 <0.26.0` (Desktop 0.25) and `>=0.22.0 <0.24.0`
 (Desktop 0.23). It does not establish complete
 UI, backend, plugin, retirement or recovery parity; capability checks and explicit
 refusals below remain authoritative.
@@ -483,7 +486,7 @@ un-materialized tree → `E_NO_WORKTREE`.
  "base":{"ref":"origin/main","source":"origin/HEAD","mergeBase":"<oid>","ahead":2,"behind":0},
  "remote":{"name":"origin","url":"git@github.com:acme/one.git","host":"github.com","path":"acme/one","source":"branch-upstream|origin"},
  "summary":{"changed":1,"renamed":1,"copied":0,"unmerged":0,"untracked":1},
- "files":[{"id":"<24 hex>","kind":"renamed","xy":"R.","submodule":false,"score":"R100","path":"src/new.txt","origPath":"src/old.txt"}],
+ "files":[{"id":"<24 hex>","kind":"renamed","xy":"R.","submodule":false,"score":"R100","path":"src/new.txt","origPath":"src/old.txt","additions":84,"deletions":3,"binary":false}],
  "notes":[]}
 ```
 
@@ -496,6 +499,19 @@ un-materialized tree → `E_NO_WORKTREE`.
   unmerged | untracked. Ignored files are not listed.
 - `files[].id` is **opaque**, minted under (`revision`, `indexRevision`). It is
   the only way to ask for a diff.
+- `files[].additions`, `deletions` and `binary` (0.29.1, additive;
+  `instanceGitApi` stays 1) are each file's line counts.
+  - They come from one `git diff <revision> --numstat -z -M` per observation:
+    the working tree against the observed commit, **staged and unstaged
+    combined**. That is the baseline of the status letters and of
+    `oats instance diff`.
+  - An unborn tree counts against the empty tree. A rename counts on its new
+    `path`.
+  - A binary file is `additions: null, deletions: null, binary: true`. An
+    untracked file (no baseline; its contents are not read) and a submodule
+    are all `null`.
+  - If the count itself fails, every entry is `null` and `notes` says line
+    counts are unavailable. `null` means unknown, never zero.
 - `remote` (0.24.8+): the branch's configured remote (`source: branch-upstream`),
   else `origin`, else `null` — never invented. `host`/`path` are **parsed** from
   the URL (ssh/https forms; `.git` stripped) so an ADE can choose a forge backend

package/docs/release-notes/v0.29.1.md

@@ -0,0 +1,79 @@
+# OATS 0.29.1
+
+## Added
+
+- **Per-file line counts in `oats instance git`.** Each tracked file entry has
+  `additions` and `deletions` (integers) and `binary`, so the Desktop can show
+  `+84 −3` beside a changed file. They come from one `git diff --numstat`
+  against the observed commit, counting staged and unstaged changes together,
+  which is the same baseline as the status letters and `oats instance diff`.
+  - A binary file has `additions: null, deletions: null, binary: true`.
+  - An untracked file or a submodule has all three `null`.
+  - A rename is counted on its new path.
+  - `instanceGitApi` stays 1: the fields are additive. The text output shows
+    `+N -M` after each path. See
+    [desktop-cli-api.md](../desktop-cli-api.md#instance-git-state-oats-instance-gitdiff-instancegitapi-1-oats-0247).
+
+## Changed
+
+- **The `oats-setup-admin` soul is never harvested.** Its `soul.yaml` opts out
+  of OKF harvest with `knowledge: { harvest: off }`: its sessions work on the
+  deployment's own config and carry deployment specifics that must not reach
+  the shared knowledge base. oats.okf 4.0.0 makes a soul's opt-out absolute, so
+  a deployment that switches harvest on (`settings.oats.okf.harvest: on`)
+  still registers no source, captures nothing and takes no custody for its
+  instances. `oats okf harvest-status` in one of its homes reports
+  `harvest: off` with the soul's reason.
+
+## Desktop
+
+The Desktop now shows the kernel's 0.29 Desktop facts and the Workspace v4
+design's Git & GitHub section. On an older kernel, each fact is absent and its
+view shows nothing new.
+
+- **Souls say when a spawn here would refuse** (#228, #231). A soul the kernel
+  reports as not spawnable shows "Can't spawn here" with the kernel's reason on
+  its card and page, and its Spawn and Schedule… are disabled with that reason.
+  A soul page offers Open file for a hosted soul file, and shows the file's path
+  when it has no web address.
+- **The server passes the kernel's Desktop facts through** (#230). Its souls,
+  capabilities, workspace status and instance projections keep those fields,
+  bounded, instead of dropping them. A soul's spawn default is nested as
+  `spawnDefault`, so it is never read as the soul's own harness or model.
+- **Capability pages** (#232) show the description, what the capability
+  provides (skills, commands and hooks by name, or "Not listable"), its file and
+  its fingerprint.
+- **Setup names the files and this computer's state** (#233). It names the
+  workspace and membership files, and links them when they are hosted. A member
+  panel has Open repository and its clone on this computer. This computer lists
+  the lock file, disabled souls and each member's clone, or "not cloned here".
+  Packages with a newer version say "X available".
+- **Setup shows the workspace defaults** (#237): each slot and its source ("not
+  set" or "none" when empty), the default capabilities, and what each team adds
+  or turns off.
+- **The instance page** (#235) says when the session started, where its model
+  came from (the soul, the spawn, the start, the launch configuration or the
+  harness default), and its messaging address.
+- **Each local instance's pull request on its roster row** (#234, #236). A new
+  `POST /api/forge-roster` maps each instance to its member's clone from the
+  kernel's workspace status and reads the branch's PR with `gh`, cached for a
+  minute. The row shows `#N`, with draft, merged or closed in words. Remote
+  instances, and hosts without a signed-in `gh`, show no badge.
+- **W6 Git & GitHub** (#239, #240, #241, #242, #243). The instance's Git panel
+  follows the design:
+  - **Branch** shows the work mode, the distance from the default branch and
+    whether the tree is clean, with the rest behind Details.
+  - **Changes** is a list of status letters and paths, with Open diff.
+  - **Pull request** shows the title and state, the issues it closes and the
+    checks: failing first, with how long each took. It also shows the review
+    decision with the count of unresolved review threads, and has Open on
+    GitHub.
+  - Check marks are icons. The thread count is read only for the open
+    instance's PR, never for the roster.
+- **Automations through the app proxy** (#224). `/api/automations` has its own
+  proxy route, pinned to the verified workspace like the other workspace
+  endpoints. It has a 90 s deadline, so `trigger test` (which polls the forge)
+  is no longer cut off in the packaged app. The automations docs describe the
+  API and the proxy.
+- **Docs** (#227): the documented Desktop band is `>=0.25.8 <0.30.0`.
+- The Desktop still accepts OATS CLIs `>=0.25.8 <0.30.0`.

package/lib/instance-git.mjs

@@ -138,6 +138,33 @@ function remoteOf(work, branch) {
   if (!url) return null;
   return { name, url, ...parseRemoteUrl(url), source: configured && configured !== "." ? "branch-upstream" : "origin" };
 }
+/** Per-file line counts (0.29.1), from ONE `git diff <captured HEAD> --numstat -z -M`: the working tree
+ *  against the observed commit, staged and unstaged combined. That is the same baseline as the status letters
+ *  and `oats instance diff`. An unborn tree counts against the empty tree (`hash-object` without -w writes nothing).
+ *  → Map path → { additions, deletions, binary }, keyed by the NEW path for a rename; null when git failed.
+ *  -z records: "A\tD\tpath\0", or "A\tD\t\0old\0new\0" for a rename; "-\t-" is a binary file. */
+function lineCounts(work, headOid) {
+  const against = headOid ?? trim(git(work, ["hash-object", "-t", "tree", "/dev/null"], { allowFail: true }));
+  if (!against) return null;
+  const raw = git(work, ["diff", against, "--numstat", "-z", "-M", "--"], { allowFail: true });
+  if (raw === null) return null;
+  const counts = new Map(), recs = raw.split("\0");
+  for (let i = 0; i < recs.length;) {
+    const m = /^(-|\d+)\t(-|\d+)\t([\s\S]*)$/.exec(recs[i++]);
+    if (!m) continue;
+    let path = m[3];
+    if (path === "") { i++; path = recs[i++]; } // a rename: skip the old path, key the new one
+    if (typeof path !== "string" || !path) continue;
+    counts.set(path, m[1] === "-" ? { additions: null, deletions: null, binary: true } : { additions: Number(m[1]), deletions: Number(m[2]), binary: false });
+  }
+  return counts;
+}
+/** An entry's counts: untracked (no baseline; contents are not read) and submodules have none (all null). */
+function countsOf(counts, entry) {
+  if (entry.kind === "untracked" || entry.submodule) return { additions: null, deletions: null, binary: null };
+  return counts?.get(entry.path) ?? { additions: null, deletions: null, binary: null };
+}
+
 function fileId(revision, indexOid, entry) {
   return createHash("sha256").update(`${revision}\0${indexOid}\0${entry.kind}\0${entry.path}\0${entry.origPath ?? ""}`).digest("hex").slice(0, 24);
 }
@@ -164,7 +191,8 @@ export function observeInstanceGit(home) {
     const counts = mergeBase ? countRange(work, `${base.ref}...HEAD`) : null;
     baseComparison = { ref: base.ref, source: base.source, mergeBase, ahead: counts ? counts.right : null, behind: counts ? counts.left : null };
   }
-  const files = entries.filter((e) => e.kind !== "ignored").map((e) => ({ id: fileId(revision, indexOid, e), ...e }));
+  const counts = lineCounts(work, headOid);
+  const files = entries.filter((e) => e.kind !== "ignored").map((e) => ({ id: fileId(revision, indexOid, e), ...e, ...countsOf(counts, e) }));
   const summary = { changed: 0, renamed: 0, copied: 0, unmerged: 0, untracked: 0 };
   for (const f of files) summary[f.kind]++;
   return {
@@ -178,6 +206,7 @@ export function observeInstanceGit(home) {
     notes: [
       ...(upstream.ref === null ? ["no upstream configured: upstream ahead/behind are unknown, not zero"] : []),
       ...(baseComparison.ref === null ? ["no default branch found (origin/HEAD, origin/main, origin/master, main, master): base comparison unknown"] : []),
+      ...(counts === null ? ["line counts unavailable (git diff --numstat failed): additions/deletions are unknown, not zero"] : []),
     ],
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awebai/oats",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "description": "OATS (Open Agent Team Specification) — durable souls, disposable instances, targetable capability packages, and the runtime-neutral oats CLI/kernel.",
   "keywords": [
     "agents",