@tablation/crew 0.68.0 → 0.68.1

package/dist/cli.js

@@ -3887,6 +3887,9 @@ function ticketMentions(text) {
 var TicketAttributionTracker = class {
   #tokensByTicket = /* @__PURE__ */ new Map();
   #current;
+  /** Tracker record uuid → ticket key, learned when a write names both (a claim resolves the key from the last mention). */
+  #keyByRecord = /* @__PURE__ */ new Map();
+  #lastBy = {};
   /** The ticket key most recently named in the transcript, or undefined before any. */
   get current() {
     return this.#current;
@@ -3903,6 +3906,37 @@ var TicketAttributionTracker = class {
     if (this.#current === void 0 || tokens <= 0) return;
     this.#tokensByTicket.set(this.#current, (this.#tokensByTicket.get(this.#current) ?? 0) + tokens);
   }
+  /**
+   * Record a tool call if it is a ticket-targeted tracker write (claim,
+   * hand-off or comment). The ticket key comes from a record uuid seen on an
+   * earlier write when known, else from the key last named in the transcript
+   * (a claim or hand-off announces its ticket). A comment on a record never
+   * seen before is ignored: its uuid cannot be resolved to a key.
+   */
+  noteWrite(tool, input) {
+    const w = classifyWrite(tool, input);
+    if (!w) return;
+    let key = w.recordId ? this.#keyByRecord.get(w.recordId) : void 0;
+    if (w.kind !== "comment") key ??= this.#current;
+    if (!key) return;
+    if (w.kind !== "comment" && w.recordId) this.#keyByRecord.set(w.recordId, key);
+    this.#lastBy[w.kind] = key;
+  }
+  /**
+   * How the attribution is decided: a hand-off write beats a claim, a claim
+   * beats a comment (so a follow-up ticket filed or commented on while
+   * working never displaces the claimed one), and any write beats the
+   * mention-token heuristic, which is only the fallback for runs that made
+   * no ticket-targeted write. The pre-run hint is last.
+   */
+  decide(hint) {
+    for (const by of ["handoff", "claim", "comment"]) {
+      const ticket = this.#lastBy[by];
+      if (ticket) return { ticket, by };
+    }
+    if (this.#tokensByTicket.size > 0) return { ticket: this.winner(hint), by: "mentions" };
+    return { ticket: hint, by: "hint" };
+  }
   /**
    * The ticket key the run spent the most tokens on, or `fallback` (the
    * pre-run poll hint) when the transcript never named one — an
@@ -3926,6 +3960,20 @@ function isClaimWrite(tool, input) {
   const body = input?.body;
   return typeof body === "object" && body !== null && body.status === "in_progress";
 }
+var HANDOFF_STATUSES = /* @__PURE__ */ new Set(["fixed", "verified", "needs_info", "accepted"]);
+function classifyWrite(tool, input) {
+  if (!tool) return void 0;
+  const body = input?.body;
+  if (typeof body !== "object" || body === null) return void 0;
+  const b = body;
+  if (/records_controller_update$/.test(tool)) {
+    const recordId = typeof input?.recordId === "string" ? input.recordId : void 0;
+    if (b.status === "in_progress" || b.status === "qa") return { kind: "claim", recordId };
+    if (typeof b.status === "string" && HANDOFF_STATUSES.has(b.status)) return { kind: "handoff", recordId };
+  }
+  if (/records_controller_create$/.test(tool) && typeof b.ticket_id === "string") return { kind: "comment", recordId: b.ticket_id };
+  return void 0;
+}
 
 // src/agent.ts
 var DIGEST_MAX_AGE_SECONDS = 600;
@@ -4216,6 +4264,7 @@ var RunObserver = class {
     let turnText = "";
     for (const ev of events) if ((ev.kind === "thought" || ev.kind === "text") && ev.text) this.attribution.note(ev.text);
     for (const ev of events) {
+      if (ev.kind === "tool") this.attribution.noteWrite(ev.tool, ev.input);
       if (ev.kind === "tool" && isClaimWrite(ev.tool, ev.input)) {
         const claimed = this.attribution.current;
         if (claimed && claimed !== this.liveTicket) {
@@ -4300,12 +4349,13 @@ function writeRunMeta(id, startedAt, liveTicket, extra) {
   }
 }
 async function finishRun(id, obs, emit, startedAt, end, agentLogKey) {
-  const attributedTicket = obs.attribution.winner(obs.liveTicket);
+  const { ticket: attributedTicket, by: attributedBy } = obs.attribution.decide(obs.liveTicket);
   const identity = { toolchain: id.toolchain, harness: id.harness, provider: id.provider };
   const { result } = obs;
   try {
     writeRunMeta(id, startedAt, obs.liveTicket, {
       attributedTicket: attributedTicket ?? null,
+      attributedBy,
       running: void 0,
       exitCode: end.code,
       ...end.interrupted ? { interrupted: end.interrupted } : {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tablation/crew",
-  "version": "0.68.0",
+  "version": "0.68.1",
   "description": "A standing team of headless agents that picks work off a Tablation board, does it on a machine you control, and reports back.",
   "type": "module",
   "license": "MIT",