worktrust 0.6.18 → 0.7.0

package/README.md

@@ -158,6 +158,7 @@ nothing it does not:
 | `project` | a one-way hash of the project's name: which days belong together, never which project |
 | `stretch_ref` | a hash of the session's id and the day, so a stretch is archived once |
 | `device_id`, `profile_id` | which computer and which user profile on it, as one-way hashes (the machine's own id never appears) |
+| `signals`, `analyzer_version` | the behaviour signals of that stretch as keys and counts from the local counter's rubric (framing, steering, verification, recovery), and the rubric's version; derived on this computer from your own turns, never a word of them (0.7.0) |
 | `collector_version` | the CLI version that measured it |
 | `seq`, `prev`, `hash` | the line's place, the hash of the line before it, and its own hash |
 

package/count-behaviour.mjs

@@ -788,6 +788,18 @@ export const isoWeek = (day) => {
   return `${thursday.getUTCFullYear()}-W${String(week).padStart(2, "0")}`;
 };
 const byWeek = new Map(); // "month|week" → Map(signal → count)
+/**
+ * THE WORK STRETCH (0.7.0, the owner's capability framework v4 §13: "work_stretch_id, the stable unit joining AI
+ * activity, verification, failures and delivery"). The same observation is tallied a third time, per stretch: one
+ * session's UTC day, named by the hash the session hook files the stretch under (`stretch_ref` in log-session.mjs), so a
+ * signal and the stretch's clocks, tokens and commits meet on one key. Only sessions read from a file carry it (Claude
+ * Code, Codex, Antigravity); the session's id is hashed with the day and never leaves the computer. Read by `preserve`
+ * through --stretch-signals; nothing of it is sent yet.
+ */
+const byStretch = new Map(); // stretch_ref → { day, signals: { signal: count } }
+let currentStretchBase = null; // the session's own id, as the session hook hashes it — local only
+const stretchBaseOf = (session) => !session.path ? null : /(^|[\\/])brain[\\/][^\\/]+[\\/]\.system_generated[\\/]logs[\\/]transcript\.jsonl$/.test(session.path) ? String(session.path).split(/[\\/]/).at(-4) : String(session.path).split(/[\\/]/).pop().replace(/\.jsonl?$/, "");
+const stretchRefOf = (base, day) => createHash("sha256").update(`worktrust-stretch|${base}|${day}`).digest("base64url");
 const bump = (month, signal, n = 1) => {
   {
     const key = `${month}|${currentDay && currentDay.startsWith(month) ? isoWeek(currentDay) : "U"}`;
@@ -795,6 +807,11 @@ const bump = (month, signal, n = 1) => {
     week.set(signal, (week.get(signal) ?? 0) + n);
     byWeek.set(key, week);
   }
+  if (currentStretchBase && currentDay) {
+    const ref = stretchRefOf(currentStretchBase, currentDay), entry = byStretch.get(ref) ?? { day: currentDay, signals: {} };
+    entry.signals[signal] = (entry.signals[signal] ?? 0) + n;
+    byStretch.set(ref, entry);
+  }
   if (currentUnit) {
     const bag = unitsByMonth.get(month) ?? new Map();
     bag.set(`${currentUnit}|${signal}`, { unit: currentUnit, signal, induced: currentInduced, day: currentDay, context: currentContext });
@@ -827,10 +844,10 @@ const seenLines = new Set(); // v0.10: line identities already counted (a uuid o
 const manifest = [];
 for(const session of sessions())manifest.push(sessionDigest(session));
 exportConversations = 0; copilotSessionCount = 0; codexRolloutCount = 0; antigravityCount = 0; skippedDirs.length = 0; countedDirs.length = 0; skippedConversations.length = 0;
-const checkpoint = flag("no-checkpoint") || LABEL_OUT ? null : checkpointStore(
+const checkpoint = flag("no-checkpoint") || flag("stretch-signals") || LABEL_OUT ? null : checkpointStore(
   value("checkpoint") ?? join(homedir(), ".worktrust", "counter-checkpoint.json"),
   fingerprint({code:readFileSync(new URL(import.meta.url)),version:ANALYZER_VERSION,months:MONTHS_BACK,thisMonth,exclude:EXCLUDE,leaveOut:LEAVE_OUT,exports:EXPORTS}),manifest);
-const checkpointMaps = {byMonth,byWeek,unitsByMonth,contextNames,contextBasenames,byMonthContext,monthToolNames,modelFirstSeen,monthMcpServers,rolePatterns,contextCwds,projectFirstSeen,sessionsByMonth};
+const checkpointMaps = {byMonth,byWeek,byStretch,unitsByMonth,contextNames,contextBasenames,byMonthContext,monthToolNames,modelFirstSeen,monthMcpServers,rolePatterns,contextCwds,projectFirstSeen,sessionsByMonth};
 const checkpointSets = {openingHashes,toolFirstSeen,seenLines};
 if (checkpoint?.saved) {
   for(const [key,map] of Object.entries(checkpointMaps)) for(const [k,v] of checkpoint.saved.state.maps[key] ?? []) map.set(k,v);
@@ -849,6 +866,7 @@ for (const session of sessions()) {
   if(sessionIndex++<resumeAt)continue;
   const streamHash = session.path ? createHash("sha256").update(`file:${session.path}\n`) : null;
   const file = session.key;
+  currentStretchBase = stretchBaseOf(session);
   files += 1;
   // One file is one session: order preserved, so the STRUCTURAL half reads the shape.
   let sessionMonth = null;
@@ -1152,7 +1170,7 @@ for (const session of sessions()) {
     checkpoint?.close();process.exit(0);
   }
 }
-currentUnit = null; currentDay = null; // month-level aggregates carry no unit and no day
+currentUnit = null; currentDay = null; currentStretchBase = null; // month-level aggregates carry no unit, no day and no stretch
 for (const [month, set] of monthToolNames) bump(month, "toolBreadth", set.size);
 for (const [month, set] of monthMcpServers) if (set.size > 0) bump(month, "mcpServersDistinct", set.size);
 for (const [month, byPattern] of rolePatterns) for (const sessions of byPattern.values()) if (sessions.size >= RECURRENCE_FLOOR) bump(month, "recurringPatternCandidate");
@@ -1190,6 +1208,14 @@ for (let i = 0; i < sessionSpans.length; i += 1) {
   if (overlapping.has(i)) { currentUnit = a.unit; currentDay = a.day ?? null; currentContext = a.context ?? null; bump(a.month, "parallelSessions"); currentUnit = null; currentDay = null; currentContext = null; }
 }
 
+// THE STRETCHES, FOR PRESERVE (0.7.0): one JSON line per stretch that carries a signal, the analyzer's version on each,
+// and a closing count so the reader can tell a whole answer from a cut one. Counts and keys only; nothing is sent.
+if (flag("stretch-signals")) {
+  const rows = [...byStretch.entries()].sort(([, a], [, b]) => a.day.localeCompare(b.day)).map(([stretch_ref, entry]) => JSON.stringify({ stretch_ref, day: entry.day, analyzer_version: ANALYZER_VERSION, signals: Object.fromEntries(Object.entries(entry.signals).sort().map(([signal, count]) => [signal, Math.min(COUNT_CEILING, count)])) }));
+  await new Promise((resolve) => process.stdout.write(`${[...rows, JSON.stringify({ stretch_signals_end: rows.length })].join("\n")}\n`, resolve));
+  process.exit(0);
+}
+
 const months = [...byMonth.keys()].sort();
 console.log(`${ANALYZER_VERSION} · ${files} transcript file(s), ${messages} own messages, ${months.length} month(s) with counts`);
 console.log(` projects counted: ${countedDirs.length}${countedDirs.length ? ` (${countedDirs.join(", ")})` : ""}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "worktrust",
-  "version": "0.6.18",
+  "version": "0.7.0",
   "description": "Couple this computer to WorkTrust: approve a code in your browser, and every AI app here reports what you built. Metadata only, no dependencies.",
   "type": "module",
   "bin": {

package/preserve.mjs

@@ -187,7 +187,22 @@ function computerIds() {
   const hash = (text) => createHash("sha256").update(text).digest("base64url");
   return { device_id: hash(`worktrust-machine|${machine.toLowerCase()}`), profile_id: hash(`worktrust-profile|${machine.toLowerCase()}|${homedir()}`) };
 }
-function archiveLine(entry) {
+/**
+ * THE STRETCH'S BEHAVIOUR SIGNALS (0.7.0): the local counter's keys and counts per stretch, joined on `stretch_ref`,
+ * with the rubric's version. Read on this computer by count-behaviour.mjs --stretch-signals, which sends nothing; a
+ * counter that is missing, fails or answers cut leaves the archive without signals and says so, never half of them.
+ */
+function stretchSignals() {
+  const counter = join(HERE, "count-behaviour.mjs");
+  if (!existsSync(counter)) return null;
+  const run = spawnSync(process.execPath, [counter, "--stretch-signals", "--months", "120"], { encoding: "utf8", maxBuffer: 1 << 29, env: { ...process.env, WORKTRUST_MCP_URL: "", WORKTRUST_MCP_TOKEN: "" } });
+  const rows = (run.stdout ?? "").split("\n").filter((text) => text.startsWith("{")).map((text) => { try { return JSON.parse(text); } catch { return null; } });
+  const end = rows.at(-1)?.stretch_signals_end;
+  if (run.status !== 0 || !Number.isInteger(end) || end !== rows.length - 1) { say("  The behaviour counter did not answer whole, so these lines carry no signals; the next run adds them to new lines."); return null; }
+  return new Map(rows.slice(0, -1).filter(Boolean).map((row) => [row.stretch_ref, row]));
+}
+const SIGNAL = /^[a-zA-Z][A-Za-z0-9._-]{1,63}$/;
+function archiveLine(entry, behaviour = null) {
   if (typeof entry?.client !== "string" || !/^[a-z][a-z0-9-]{0,31}$/.test(entry.client) || !ISO.test(entry.started_at ?? "") || !ISO.test(entry.at ?? "") || !/^[A-Za-z0-9_-]{16,128}$/.test(entry.stretch_ref ?? "")) return null;
   const line = { client: entry.client, day: entry.started_at.slice(0, 10), started_at: entry.started_at, ended_at: entry.at };
   for (const key of COUNTS) if (typeof entry[key] === "number" && Number.isFinite(entry[key]) && entry[key] >= 0) line[key] = entry[key];
@@ -202,6 +217,11 @@ function archiveLine(entry) {
   // The project as a one-way hash of its name (owner/name, else the folder's own name): which days belong together, never which project.
   const name = entry.repo ?? entry.folder;
   if (typeof name === "string" && name) line.project = sha256(`worktrust-project|${name}`);
+  // The behaviour signals of this stretch (0.7.0): keys of the counter's rubric and whole counts, never a word of a turn.
+  if (behaviour && behaviour.signals && typeof behaviour.analyzer_version === "string" && /^counter@\d+\.\d+\.\d+$/.test(behaviour.analyzer_version)) {
+    const kept = Object.entries(behaviour.signals).filter(([key, count]) => SIGNAL.test(key) && Number.isInteger(count) && count > 0).sort();
+    if (kept.length > 0) { line.signals = Object.fromEntries(kept); line.analyzer_version = behaviour.analyzer_version; }
+  }
   return { ...line, stretch_ref: entry.stretch_ref, ...IDS, collector_version: COLLECTOR };
 }
 
@@ -282,11 +302,12 @@ function archive(dir) {
   // A WHOLE ANSWER OR NOTHING: the hook ends with its own count; one line missing or cut is a read to refuse, never part of an archive.
   const rows = hook.stdout.split("\n").filter(Boolean), end = (() => { try { return JSON.parse(rows.at(-1) ?? "").archive_end; } catch { return undefined; } })();
   if (!Number.isInteger(end) || end !== rows.length - 1) { say(`  The session hook's answer came back incomplete (${rows.length - 1} of ${end ?? "an unknown number of"} lines), so nothing was added. Run it again.`); process.exit(1); }
+  const signals = stretchSignals();
   const known = new Set(existing.lines.map((line) => line.stretch_ref)), fresh = [], measured = new Set();
   let waiting = 0;
   for (const text of rows.slice(0, -1)) {
     let entry; try { entry = JSON.parse(text); } catch { continue; }
-    const line = archiveLine(entry);
+    const line = archiveLine(entry, signals?.get(entry.stretch_ref) ?? null);
     if (line && line.day < today()) measured.add(line.stretch_ref); if (!line || known.has(line.stretch_ref)) continue; // a file present twice is one stretch
     if (line.day >= today()) { waiting += 1; continue; }
     known.add(line.stretch_ref);

package/worktrust.mjs

@@ -71,7 +71,7 @@ const command = args.find((arg, at) => !arg.startsWith("--") && !(at > 0 && VALU
 const flag = (name) => { const at = args.indexOf(`--${name}`); return at >= 0 ? args[at + 1] : undefined; };
 const has = (name) => args.includes(`--${name}`);
 /** This CLI's version, said to the door so the app can tell which computer runs an old one (check-cli-package holds it equal to package.json). */
-const CLI_VERSION = "0.6.18";
+const CLI_VERSION = "0.7.0";
 const ORIGIN = (flag("origin") ?? process.env.WORKTRUST_ORIGIN ?? "https://app.worktrust.io").replace(/\/$/, "");
 const MCP = flag("url") ?? process.env.WORKTRUST_MCP_URL ?? `${ORIGIN}/api/mcp`;
 const HOME_DIR = join(homedir(), ".worktrust");