@brainervirus/workit-cli 8.13.1 → 8.14.1

package/dist/index.js

@@ -65,7 +65,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@brainervirus/workit-cli",
-    version: "8.13.1",
+    version: "8.14.1",
     private: false,
     description: "Workit CLI — setup wizard, doctor, and task control for agentic coding workflows",
     keywords: [
@@ -103,13 +103,13 @@ var init_package = __esm(() => {
     },
     dependencies: {
       "@babel/parser": "7.29.9",
-      "@brainervirus/workit-cursor": "^8.13.1",
+      "@brainervirus/workit-cursor": "^8.14.1",
       "@inkjs/ui": "2.0.0",
       ink: "7.1.1",
       react: "19.2.8"
     },
     devDependencies: {
-      "@brainervirus/workit-core": "^8.13.1"
+      "@brainervirus/workit-core": "^8.14.1"
     },
     engines: {
       node: ">=24"
@@ -7977,6 +7977,16 @@ var init_zod = __esm(() => {
 
 // packages/workit-core/src/core/task-contract.ts
 import { createHash, randomUUID } from "node:crypto";
+function resolveIdRef(kind, ref, ids) {
+  if (ids.includes(ref))
+    return success(null, null, ref);
+  const matches = ids.filter((candidate) => candidate.startsWith(ref));
+  if (matches.length === 1)
+    return success(null, null, matches[0]);
+  if (matches.length === 0)
+    return failure2("not_found", `${kind} not found`);
+  return failure2("invalid_input", `${kind} prefix ${ref} is ambiguous; candidates: ${matches.join(", ")}`);
+}
 function parseOperation(family, input) {
   if (typeof input === "object" && input !== null && "schemaVersion" in input && input.schemaVersion !== SCHEMA_VERSION)
     return failure2("unsupported_version", "unsupported schema version", { operation: family });
@@ -8079,7 +8089,7 @@ var SCHEMA_VERSION = 1, POLICY_VERSION = "1.0.0", OPERATION_FAMILIES, uuidPatter
       return true;
   }
   return false;
-}, text, id, digest, revision, validUtc = (value) => {
+}, text, id, idRefPattern, idRef, digest, revision, validUtc = (value) => {
   const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,9}))?Z$/.exec(value);
   if (!match)
     return false;
@@ -8262,6 +8272,8 @@ var init_task_contract = __esm(() => {
       ctx.issues.push({ code: "custom", input: ctx.value, message: "invalid Unicode", path: [] });
   });
   id = text.regex(uuidPattern, "expected lowercase UUID");
+  idRefPattern = /^[0-9a-f][0-9a-f-]{7,35}$/;
+  idRef = text.regex(idRefPattern, "expected a UUID or an id prefix of 8+ characters");
   digest = text.regex(digestPattern, "expected lowercase SHA-256 digest");
   revision = text.regex(uuidPattern, "expected UUID revision");
   utcSchema = text.check((ctx) => {
@@ -8530,7 +8542,7 @@ var init_task_contract = __esm(() => {
     outcome: _enum(["completed", "failed", "cancelled"]),
     summary: text,
     evidenceIds: array(id),
-    findingIds: array(id)
+    findingIds: array(idRef)
   }).strict();
   workerSchema = object({
     assignment: assignmentSchema,
@@ -8722,7 +8734,7 @@ var init_task_contract = __esm(() => {
       action: literal("resolve"),
       ...taskId,
       expectedRevision: revision.optional(),
-      findingId: id,
+      findingId: idRef,
       disposition: _enum(["open", "fixed", "dismissed", "deferred"]),
       reason: text,
       evidenceIds: array(id),
@@ -8763,7 +8775,7 @@ var init_task_contract = __esm(() => {
       ...taskId,
       expectedRevision: revision.optional(),
       expectedWorkspaceRevision: revision.optional(),
-      workerId: id,
+      workerId: idRef,
       report: workerReportSchema
     }),
     cancel: operation({
@@ -8771,7 +8783,7 @@ var init_task_contract = __esm(() => {
       ...taskId,
       ...revisions,
       expectedWorkspaceRevision: revision.optional(),
-      workerId: id,
+      workerId: idRef,
       reason: text
     })
   };
@@ -11453,20 +11465,26 @@ class TaskStore {
     return success(null, null, { key: key.data, bound: bound.data });
   }
   taskForWorker(workerId) {
-    if (typeof workerId !== "string" || !validId(workerId))
+    if (typeof workerId !== "string" || !idRefPattern.test(workerId))
       return failure2("invalid_input", "needs a worker id: `workit worker cancel|report <workerId>`");
     const listed = this.listTaskIndex();
     if (!listed.ok)
       return listed;
+    const owners = new Map;
     for (const entry of listed.data) {
       if (entry.status === "closed")
         continue;
       const loaded = this.load(entry.id);
       if (!loaded.ok)
         return loaded;
-      if (loaded.data?.record.workers.some((worker) => worker.id === workerId))
-        return success(null, null, entry.id);
+      for (const worker of loaded.data?.record.workers ?? [])
+        owners.set(worker.id, entry.id);
     }
+    const resolved = resolveIdRef("worker", workerId, [...owners.keys()]);
+    if (resolved.ok)
+      return success(null, null, owners.get(resolved.data) ?? null);
+    if (resolved.code !== "not_found")
+      return resolved;
     return success(null, null, null);
   }
   originTaskEntry() {
@@ -14022,23 +14040,79 @@ var nonBlank, branchPreset, commitPreset, workspaceBranchPolicySchema, workspace
 }, resolveRuntimeReleaseTracks = (cwd) => {
   const matched = matchRuntimeWorkspace(cwd);
   return matched ? { workspace: matched.selected.name, releaseTracks: matched.selected.releaseTracks } : null;
-}, workspaceTrailers = (cwd, dir) => {
+}, inheritedSetting = (cwd, dir, has) => {
   let matched;
   try {
     matched = matchRuntimeWorkspace(cwd, dir);
   } catch {
-    return { enabled: true, workspace: null, from: null };
+    return null;
   }
   if (!matched)
-    return { enabled: true, workspace: null, from: null };
+    return null;
   const { selected, matches } = matched;
   const enclosing = matches.filter((entry) => entry !== selected).toSorted((a, b) => globSpecificity(b.glob) - globSpecificity(a.glob));
-  const source = [selected, ...enclosing].find((entry) => typeof entry.trailers === "boolean");
+  return { workspace: selected.name, source: [selected, ...enclosing].find(has) ?? null };
+}, workspaceTrailers = (cwd, dir) => {
+  const found = inheritedSetting(cwd, dir, (entry) => typeof entry.trailers === "boolean");
   return {
-    enabled: source?.trailers !== false,
-    workspace: selected.name,
-    from: source?.name ?? null
+    enabled: found?.source?.trailers !== false,
+    workspace: found?.workspace ?? null,
+    from: found?.source?.name ?? null
   };
+}, hostFamily = (host) => host.replace(/_(?:cli|desktop)$/u, ""), TIER_KEYS, TIER_HOSTS, workspaceTierModelIssues = (cwd, dir) => {
+  let matched;
+  try {
+    matched = matchRuntimeWorkspace(cwd, dir);
+  } catch {
+    return [];
+  }
+  const issues = [];
+  for (const entry of matched?.matches ?? []) {
+    const models = entry.fanout?.tierModels;
+    if (models === undefined)
+      continue;
+    const where = `workspace ${entry.name} fanout.tierModels`;
+    if (!models || typeof models !== "object" || Array.isArray(models)) {
+      issues.push(`${where} is not an object; ignored`);
+      continue;
+    }
+    for (const [tier, value] of Object.entries(models)) {
+      if (!TIER_KEYS.has(tier))
+        issues.push(`${where}.${tier}: unknown tier; ignored`);
+      else if (typeof value === "string") {
+        if (!value.trim())
+          issues.push(`${where}.${tier}: empty model name; ignored`);
+      } else if (!value || typeof value !== "object" || Array.isArray(value))
+        issues.push(`${where}.${tier}: not a model name or a per-host object; ignored`);
+      else
+        for (const [host, model] of Object.entries(value)) {
+          if (!TIER_HOSTS.has(host))
+            issues.push(`${where}.${tier}.${host}: unknown host; ignored`);
+          else if (typeof model !== "string" || !model.trim())
+            issues.push(`${where}.${tier}.${host}: not a model name; ignored`);
+        }
+    }
+  }
+  return issues;
+}, workspaceTierModel = (cwd, tier, host, dir) => {
+  const pick = (entry) => {
+    const fanout = entry.fanout;
+    const models = fanout?.tierModels;
+    if (!models || typeof models !== "object" || !Object.hasOwn(models, tier))
+      return null;
+    const value = models[tier];
+    if (typeof value === "string")
+      return value.trim() || null;
+    if (!value || typeof value !== "object")
+      return null;
+    const byHost = value;
+    const family = host ? hostFamily(host) : null;
+    const named = (family && Object.hasOwn(byHost, family) ? byHost[family] : undefined) ?? (host && Object.hasOwn(byHost, host) ? byHost[host] : undefined) ?? (Object.hasOwn(byHost, "default") ? byHost.default : undefined);
+    return typeof named === "string" && named.trim() ? named.trim() : null;
+  };
+  const found = inheritedSetting(cwd, dir, (entry) => pick(entry) !== null);
+  const model = found?.source ? pick(found.source) : null;
+  return model && found?.source ? { model, workspace: found.source.name } : null;
 }, resolveRuntimeWorkspaceCandidate = (cwd, kind) => {
   const matched = matchRuntimeWorkspace(cwd);
   if (!matched)
@@ -14190,6 +14264,8 @@ var init_workspaces = __esm(() => {
     defaultEndpoint: unknown().optional(),
     verification: _enum(["self", "independent"]).optional(),
     trailers: boolean2().optional(),
+    liveSessionGuard: boolean2().optional(),
+    fanout: object({ tierModels: unknown().optional() }).passthrough().optional(),
     autonomy: object(Object.fromEntries(["push", "pr", "merge", "release", "rerun"].map((kind) => [
       kind,
       union([boolean2(), literal("verified")]).optional()
@@ -14239,6 +14315,17 @@ var init_workspaces = __esm(() => {
   runtimeWorkspaceIndexSchema = object({
     workspaces: array(object({ name: nonBlank, glob: nonBlank }).passthrough()).optional()
   }).passthrough();
+  TIER_KEYS = new Set(["mundane", "standard", "hard"]);
+  TIER_HOSTS = new Set([
+    "claude_code",
+    "opencode",
+    "codex",
+    "codex_cli",
+    "codex_desktop",
+    "cursor",
+    "pi",
+    "default"
+  ]);
 });
 
 // packages/workit-core/src/core/release-tracks.ts
@@ -18749,6 +18836,10 @@ class WorkitCore {
     }
     if (helper?.ok)
       return failure2("permission_denied", "helpers cannot resolve findings");
+    const findingRef = resolveIdRef("finding", input.findingId, task.data.findings.map((entry) => entry.id));
+    if (!findingRef.ok)
+      return findingRef;
+    input.findingId = findingRef.data;
     const finding = task.data.findings.find((entry) => entry.id === input.findingId);
     if (!finding)
       return failure2("not_found", "finding not found");
@@ -18900,15 +18991,31 @@ class WorkitCore {
         return changed;
       return success(changed.data.task.revision, changed.data.workspace.revision, changed.data.task.workers.at(-1));
     }
+    const workerRef = resolveIdRef("worker", input.workerId, helperId === null ? task.data.workers.map((candidate) => candidate.id) : [helperId]);
+    if (!workerRef.ok)
+      return helperId === null ? workerRef : failure2("permission_denied", input.action === "report" ? ONLY_OWN_REPORT : NO_HELPER_CONTROL);
+    input.workerId = workerRef.data;
     const entry = task.data.workers.find((candidate) => candidate.id === input.workerId);
     if (!entry)
       return failure2("not_found", "worker not found");
     if (input.action === "report") {
       if (helperId === null || helperId !== input.workerId)
-        return failure2("permission_denied", "workers can submit only their own report");
+        return failure2("permission_denied", ONLY_OWN_REPORT);
       const helper = this.helperEntry(task.data, true, true);
       if (!helper.ok)
         return helper;
+      const ownFindings = task.data.findings.filter((candidate) => candidate.provenance.workerId === helperId).map((candidate) => candidate.id);
+      const reported = [];
+      for (const findingRef of input.report.findingIds) {
+        const found = resolveIdRef("finding", findingRef, ownFindings);
+        if (found.ok)
+          reported.push(found.data);
+        else if (found.code === "not_found")
+          reported.push(findingRef);
+        else
+          return found;
+      }
+      input.report.findingIds = reported;
       const evidence = task.data.evidence.filter((candidate) => input.report.evidenceIds.includes(candidate.id));
       const findings = task.data.findings.filter((candidate) => input.report.findingIds.includes(candidate.id));
       if (evidence.length !== input.report.evidenceIds.length || findings.length !== input.report.findingIds.length)
@@ -18936,7 +19043,7 @@ class WorkitCore {
       return updated ? success(changed.data.task.revision, changed.data.workspace.revision, updated) : failure2("recovery_required", "worker disappeared during report");
     }
     if (helperId !== null)
-      return failure2("permission_denied", "helpers cannot cancel or control workers");
+      return failure2("permission_denied", NO_HELPER_CONTROL);
     if (task.data.status === "closed")
       return failure2("invalid_transition", "closed task cannot cancel workers");
     if (entry.data.state === "stopped") {
@@ -19465,7 +19572,7 @@ var MAX_JUDGED_REFS = 5, workspaceVerification = (root) => {
     return changed;
   const updated = changed.data.task.workers.find((candidate) => candidate.id === input.workerId);
   return updated ? success(changed.data.task.revision, changed.data.workspace.revision, updated) : failure2("recovery_required", "worker disappeared during lifecycle observation");
-}, refsWithinScope = (refs, scope) => refs.every((ref) => ref.kind !== "file" || scopeCovers(scope, { description: "", paths: [ref.path], exclusions: [] })), TASK_SCOPED_ACTIONS, WORKER_ADDRESSED_ACTIONS, workerCommand = (taskId, request) => {
+}, refsWithinScope = (refs, scope) => refs.every((ref) => ref.kind !== "file" || scopeCovers(scope, { description: "", paths: [ref.path], exclusions: [] })), TASK_SCOPED_ACTIONS, ONLY_OWN_REPORT = "workers can submit only their own report", NO_HELPER_CONTROL = "helpers cannot cancel or control workers", WORKER_ADDRESSED_ACTIONS, workerCommand = (taskId, request) => {
   const { action, workerId, reason, report } = request;
   const rest = JSON.stringify({ reason, report });
   const payload = rest === "{}" ? "" : ` --payload '${rest.replace(/'/gu, "'\\''")}'`;
@@ -73303,9 +73410,15 @@ function show(argv, io) {
     return emit(io, fail("invalid_input", error instanceof Error ? error.message : String(error)));
   }
   const tracks = releaseTracksReport(io.cwd);
-  const shown = tracks.tracks.length || tracks.error ? { ...autonomy, releaseTracks: tracks } : autonomy;
+  const tierModelIssues = workspaceTierModelIssues(io.cwd);
+  const shown = {
+    ...autonomy,
+    ...tracks.tracks.length || tracks.error ? { releaseTracks: tracks } : {},
+    ...tierModelIssues.length ? { tierModelIssues } : {}
+  };
   return emit(io, ok(shown), (data) => [
     ...data.note ? [`note: ${data.note}`] : [],
+    ...tierModelIssues.map((issue) => `note: ${issue}`),
     data.workspace ? `workspace ${data.workspace} (${data.source === "default" ? "D4 defaults" : `from ${data.source}`})` : "no workspace matches this checkout: D4 defaults apply",
     ...describe2(data.grants, data.configured, data, data.verification),
     ...describeReleaseTracks(tracks).map((line) => `  ${line}`),
@@ -73401,6 +73514,7 @@ usage: ${USAGE2}`)), run9 = (argv, io) => runGrant(argv, io);
 var init_grant = __esm(() => {
   init_autonomy();
   init_release_tracks();
+  init_workspaces();
   init_output();
   init_prompt();
   AGENT_ENV = [
@@ -82374,6 +82488,7 @@ function renderBrief(cwd, plan, input) {
     what: String(row.what)
   }));
   const identity = identityOf(input.actor.host);
+  const model = workspaceTierModel(cwd, slice.tier, input.actor.host);
   const minted = workerSession(sessionSafe(input.actor.session), slice.id, input.attempt);
   const session = identity === "declared" ? minted : null;
   const fanIn = plan.fanIn === "integration" ? [
@@ -82397,6 +82512,7 @@ function renderBrief(cwd, plan, input) {
     ...slice.acceptance.map((line) => `  - ${line}`),
     `VERIFY: ${slice.verify.join("; ")}`,
     `TIER: ${slice.tier}`,
+    ...model ? [`  model: ${model.model}  (fanout.tierModels in workspace ${model.workspace})`] : [],
     `TIMEBOX: ${slice.timebox ?? DEFAULT_TIMEBOX}; past it without a new commit you will be replaced`,
     scratchLine,
     `FORBIDDEN: ${slice.forbidden.join("; ")}`,
@@ -82417,6 +82533,7 @@ function renderBrief(cwd, plan, input) {
       branch,
       base: slice.base,
       tier: slice.tier,
+      model: model?.model ?? null,
       scratch,
       session,
       standing,
@@ -82459,6 +82576,7 @@ var DEFAULT_TIMEBOX = "30 minutes", REPORT, identityOf = (host) => {
   ];
 }, sessionSafe = (text) => text.replace(/[^A-Za-z0-9_.:@/+-]/gu, "-"), SESSION_MAX = 128;
 var init_fanout_brief = __esm(() => {
+  init_workspaces();
   init_ledger();
   init_fanout();
   init_fanout_worktree();
@@ -83076,6 +83194,15 @@ function fanoutStatus(cwd, plan, options) {
     if (row.waitsFor.length && !suggested.includes(id))
       row.reasons.push(`waits for ${row.waitsFor.join(", ")}`);
   }
+  const host = options.host === undefined ? actorFromEnv(process.env).host : options.host;
+  const spawnModels = {};
+  for (const id of spawnable) {
+    const tier = plan.slices.find((slice) => slice.id === id)?.tier;
+    const model = tier ? workspaceTierModel(cwd, tier, host) : null;
+    if (model)
+      spawnModels[id] = model.model;
+  }
+  const spawnList = spawnable.map((id) => spawnModels[id] ? `${id} (model ${spawnModels[id]})` : id).join(", ");
   const stuck = order.filter((id) => out.get(id)?.stuck);
   const down = breaker.down();
   if (down)
@@ -83085,7 +83212,7 @@ function fanoutStatus(cwd, plan, options) {
     const row = out.get(id);
     return !row.landed && row.reasons.length === 1 && row.reasons[0] === "no PR";
   });
-  const next = stuck.length ? `replace ${stuck.join(", ")}: stop the worker, then workit fanout worktree release ${stuck[0]} (records git status first) and respawn it in MODE: resume` : suggested.length ? online ? `land in this order: ${suggested.join(", ")} (workit fanout check first; workit pr merge each)` : `land in this order: ${suggested.join(", ")} once each has a PR (offline: PRs unchecked; open a missing one with workit git push && workit pr create --fill, then workit fanout status online)` : noPr.length ? `open PRs for ${noPr.join(", ")}: workit git push && workit pr create --fill on each branch` : spawnable.length ? `spawn ${spawnable.join(", ")} (workit fanout worktree create <slice> on hosts without native worktrees)` : order.every((id) => out.get(id)?.landed) ? "every slice has landed" : "wait for workers, then workit fanout status again";
+  const next = stuck.length ? `replace ${stuck.join(", ")}: stop the worker, then workit fanout worktree release ${stuck[0]} (records git status first) and respawn it in MODE: resume` : suggested.length ? online ? `land in this order: ${suggested.join(", ")} (workit fanout check first; workit pr merge each)` : `land in this order: ${suggested.join(", ")} once each has a PR (offline: PRs unchecked; open a missing one with workit git push && workit pr create --fill, then workit fanout status online)` : noPr.length ? `open PRs for ${noPr.join(", ")}: workit git push && workit pr create --fill on each branch` : spawnable.length ? `spawn ${spawnList} (workit fanout worktree create <slice> on hosts without native worktrees)` : order.every((id) => out.get(id)?.landed) ? "every slice has landed" : "wait for workers, then workit fanout status again";
   return {
     ok: true,
     data: {
@@ -83099,6 +83226,7 @@ function fanoutStatus(cwd, plan, options) {
       slices: order.map((id) => out.get(id)),
       landingOrder: suggested,
       spawnable,
+      spawnModels,
       stuck,
       next,
       notes
@@ -83112,6 +83240,7 @@ var DEFAULT_STUCK_MS, isoOf = (seconds) => {
 var init_fanout_status = __esm(() => {
   init_duration();
   init_report();
+  init_workspaces();
   init_ledger();
   init_fanout_check();
   init_fanout_landed();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainervirus/workit-cli",
-  "version": "8.13.1",
+  "version": "8.14.1",
   "private": false,
   "description": "Workit CLI — setup wizard, doctor, and task control for agentic coding workflows",
   "keywords": [
@@ -38,13 +38,13 @@
   },
   "dependencies": {
     "@babel/parser": "7.29.9",
-    "@brainervirus/workit-cursor": "^8.13.1",
+    "@brainervirus/workit-cursor": "^8.14.1",
     "@inkjs/ui": "2.0.0",
     "ink": "7.1.1",
     "react": "19.2.8"
   },
   "devDependencies": {
-    "@brainervirus/workit-core": "^8.13.1"
+    "@brainervirus/workit-core": "^8.14.1"
   },
   "engines": {
     "node": ">=24"