@akagilnc/pi-workflow-roles 0.1.2120 → 0.1.2124

package/dist/public-cli/main.js

@@ -15597,7 +15597,6 @@ function resolveTaishiMode(presentOptionIds) {
   }
   if (selected.size === 0) return TAISHI_DEFAULT_MODE;
   if (selected.has("cohort")) return "cohort";
-  if (selected.has("model-groups")) return "model-groups";
   if (selected.has("sweep")) return "sweep";
   if (selected.has("issue")) return "issue";
   return TAISHI_DEFAULT_MODE;
@@ -15653,12 +15652,6 @@ function evaluateTaishiModeOptionContract(mode, counts) {
         message: "usage: ak-role taishi --cohort --group-a-label <L> --group-a-issues <N[,N...]> --group-b-label <L> --group-b-issues <N[,N...]"
       };
     }
-    if (mode === "model-groups") {
-      return {
-        ok: false,
-        message: "usage: ak-role taishi --model-groups --project-root <P> [--project-root <P> ...]"
-      };
-    }
     return {
       ok: false,
       message: `usage: ak-role taishi ${mode} requires ${missingRequired.map((def) => def.canonical).join(" ")}`
@@ -15671,7 +15664,7 @@ function evaluateTaishiModeOptionContract(mode, counts) {
     if (mode === "issue") {
       return {
         ok: false,
-        message: "usage: ak-role taishi ((--ticket <N> | --project-root <P>) | [sweep] --attach <sweep.json> | --cohort ... | --model-groups ...)"
+        message: "usage: ak-role taishi ([--ticket <N>] | [sweep] --attach <sweep.json> | --cohort ...)"
       };
     }
     const flags = rule.optionIds.map((id) => byId.get(id)?.canonical ?? id).join(" | ");
@@ -15850,9 +15843,7 @@ var init_option_definitions = __esm({
   "src/public-cli/option-definitions.ts"() {
     "use strict";
     init_cli_errors();
-    TAISHI_REQUIRE_ANY_OF = [
-      { mode: "issue", optionIds: ["ticket", "project-root"] }
-    ];
+    TAISHI_REQUIRE_ANY_OF = [];
     TAISHI_DEFAULT_MODE = "issue";
     REJECTED_PUBLIC_SPELLINGS = [
       {
@@ -15870,6 +15861,22 @@ var init_option_definitions = __esm({
           en: "Merger input packet is assembled internally; not a public flag.",
           zh: "\u6821\u4E66\u90CE input packet \u7531\u5185\u90E8\u88C5\u914D\uFF0C\u4E0D\u662F\u516C\u5F00\u65D7\u6807\u3002"
         }
+      },
+      {
+        owner: "taishi",
+        spellings: ["--project-root"],
+        reason: {
+          en: "Deleted (#399). taishi no longer accepts --project-root; use bare call for whole book or --ticket N (cwd git common-dir selects the book).",
+          zh: "\u5DF2\u5220\u9664\uFF08#399\uFF09\u3002taishi \u4E0D\u518D\u63A5\u53D7 --project-root\uFF1B\u88F8\u8C03\u7528=\u6574\u7C3F\uFF0C\u6216 --ticket N\uFF08cwd git common-dir \u5B9A\u7C3F\uFF09\u3002"
+        }
+      },
+      {
+        owner: "taishi",
+        spellings: ["--model-groups"],
+        reason: {
+          en: "Public CLI face disabled (#399). Input face is being redesigned for multi-issue comparison (see follow-up ticket). Library kernel retained.",
+          zh: "\u516C\u5F00 CLI \u9762\u5DF2\u505C\u7528\uFF08#399\uFF09\u3002\u8F93\u5165\u9762\u6309\u591A issue \u91CD\u8BBE\u8BA1\u4E2D\uFF08\u89C1\u540E\u7EED\u7968\uFF09\u3002\u805A\u5408\u5185\u6838\u4FDD\u7559\u3002"
+        }
       }
     ];
     GLOBAL_OPTIONS = [
@@ -16159,23 +16166,6 @@ var init_option_definitions = __esm({
           zh: "\u53EF\u9009 sweep \u6A21\u5F0F\u8BCD\u5143\uFF08\u81F3\u591A\u4E00\u6B21\uFF1B\u4E0D\u5F97\u5939\u5E26\u5176\u4ED6 positional\uFF09\u3002"
         }
       },
-      {
-        id: "project-root",
-        owner: "taishi",
-        canonical: "--project-root",
-        aliases: [],
-        valueMetavar: "path",
-        required: false,
-        repeatable: true,
-        form: "option",
-        modes: ["issue", "model-groups"],
-        requiredInModes: ["model-groups"],
-        maxCountByMode: { issue: 1 },
-        description: {
-          en: "Project-root scope key. Issue: at most one (with --ticket at least one of the two). Model-groups: one or more required.",
-          zh: "projectRoot \u8303\u56F4\u952E\u3002issue\uFF1A\u81F3\u591A\u4E00\u4E2A\uFF08\u4E0E --ticket \u81F3\u5C11\u5C45\u5176\u4E00\uFF09\u3002model-groups\uFF1A\u4E00\u4E2A\u6216\u591A\u4E2A\u4E14\u5FC5\u586B\u3002"
-        }
-      },
       {
         id: "ticket",
         owner: "taishi",
@@ -16187,8 +16177,8 @@ var init_option_definitions = __esm({
         form: "option",
         modes: ["issue"],
         description: {
-          en: "Ticket/issue number for issue mode (with --project-root at least one of the two).",
-          zh: "issue \u6A21\u5F0F\u7684\u7968\u53F7\uFF08\u4E0E --project-root \u81F3\u5C11\u5C45\u5176\u4E00\uFF09\u3002"
+          en: "Ticket/issue number; live filter by invocation.ticketNumber inside the cwd book (git common-dir). Bare call = whole book. No library-index bootstrap.",
+          zh: "\u7968\u53F7\uFF1B\u5728 cwd \u5019\u7C3F\uFF08git common-dir\uFF09\u5185\u6309 invocation.ticketNumber \u73B0\u53D6\u73B0\u7B97\u3002\u88F8\u8C03\u7528=\u6574\u7C3F\u3002\u4E0D\u4F9D\u8D56 library-index \u81EA\u4E3E\u3002"
         }
       },
       {
@@ -16219,28 +16209,10 @@ var init_option_definitions = __esm({
         repeatable: false,
         form: "option",
         modes: ["cohort"],
-        exclusiveWith: ["model-groups"],
         selectsMode: "cohort",
         description: {
-          en: "Select cohort mode (mutually exclusive with --model-groups).",
-          zh: "\u9009\u62E9 cohort \u6A21\u5F0F\uFF08\u4E0E --model-groups \u4E92\u65A5\uFF09\u3002"
-        }
-      },
-      {
-        id: "model-groups",
-        owner: "taishi",
-        canonical: "--model-groups",
-        aliases: [],
-        valueMetavar: null,
-        required: false,
-        repeatable: false,
-        form: "option",
-        modes: ["model-groups"],
-        exclusiveWith: ["cohort"],
-        selectsMode: "model-groups",
-        description: {
-          en: "Select model-groups mode (mutually exclusive with --cohort).",
-          zh: "\u9009\u62E9 model-groups \u6A21\u5F0F\uFF08\u4E0E --cohort \u4E92\u65A5\uFF09\u3002"
+          en: "Select cohort mode.",
+          zh: "\u9009\u62E9 cohort \u6A21\u5F0F\u3002"
         }
       },
       {
@@ -16395,14 +16367,14 @@ var init_option_definitions = __esm({
       },
       taishi: {
         command: "taishi",
-        summary: "Deterministic analysis seat (issue / sweep / cohort / model-groups).",
+        summary: "Deterministic analysis seat (issue / sweep / cohort).",
         usage: [
-          "ak-role taishi (--ticket <N> | --project-root <P>) [options]",
+          "ak-role taishi [--ticket <N>]",
           "ak-role taishi [sweep] --attach <path>",
-          "ak-role taishi --cohort --group-a-label <L> --group-a-issues <N[,N...]> --group-b-label <L> --group-b-issues <N[,N...]>",
-          "ak-role taishi --model-groups --project-root <P> [--project-root <P> ...]"
+          "ak-role taishi --cohort --group-a-label <L> --group-a-issues <N[,N...]> --group-b-label <L> --group-b-issues <N[,N...]>"
         ],
         examples: [
+          "ak-role taishi",
           "ak-role taishi --ticket 125",
           "ak-role taishi sweep --attach ./sweep.json"
         ]
@@ -17877,13 +17849,6 @@ function parseTaishiArgv(args) {
         pushValue("ticket", taken.value);
         continue;
       }
-      if (taken.def.id === "project-root") {
-        pushValue(
-          "project-root",
-          requireOptionPath(taken.def.canonical, taken.value)
-        );
-        continue;
-      }
       if (taken.def.id === "attach") {
         pushValue(
           "attach",
@@ -17912,6 +17877,19 @@ function parseTaishiArgv(args) {
       throw new CliUsageError(`unknown taishi option: ${taken.def.canonical}`);
     }
     const token = tokens.shift();
+    if (isRejectedPublicSpelling("taishi", token)) {
+      if (token === "--project-root" || token.startsWith("--project-root=")) {
+        throw new CliUsageError(
+          "taishi no longer accepts --project-root (deleted); use bare call for whole book or --ticket N (cwd git common-dir selects the book)"
+        );
+      }
+      if (token === "--model-groups" || token.startsWith("--model-groups=")) {
+        throw new CliUsageError(
+          "taishi --model-groups public CLI face is disabled; input face is being redesigned for multi-issue comparison (see follow-up ticket)"
+        );
+      }
+      throw new CliUsageError(`unknown taishi option: ${token}`);
+    }
     if (token.startsWith("-") && token !== "-") {
       throw new CliUsageError(`unknown taishi option: ${token}`);
     }
@@ -17951,12 +17929,6 @@ function parseTaishiArgv(args) {
       ]
     };
   }
-  if (mode === "model-groups") {
-    return {
-      query: "model-groups",
-      projectRoots: valueLists.get("project-root") ?? []
-    };
-  }
   if (mode === "sweep") {
     return {
       query: "sweep",
@@ -17964,11 +17936,9 @@ function parseTaishiArgv(args) {
     };
   }
   const ticketRaw = valueLists.get("ticket")?.[0];
-  const projectRoot = valueLists.get("project-root")?.[0];
   return {
     query: "issue",
-    ...ticketRaw === void 0 ? {} : { ticket: parseTaishiTicketNumber(ticketRaw) },
-    ...projectRoot === void 0 ? {} : { projectRoot }
+    ...ticketRaw === void 0 ? {} : { ticket: parseTaishiTicketNumber(ticketRaw) }
   };
 }
 var MergerEnvelopeDerivationError, DOCTOR_ISSUE_NUMBER_PATTERN, DOCTOR_CASE_RUNS_PATH_PATTERN, TAISHI_TICKET_NUMBER_PATTERN;
@@ -25064,6 +25034,7 @@ function taishiLibraryIndexPath(ledgerHome) {
 }
 function rowFromIssueMetricsPage(page) {
   return {
+    bookKey: page.bookKey,
     projectRoot: page.projectRoot,
     // exactOptionalPropertyTypes: only materialize when page carries it.
     ...page.issueNumber === void 0 ? {} : { issueNumber: page.issueNumber },
@@ -25075,6 +25046,8 @@ function rowFromIssueMetricsPage(page) {
 }
 function sortRows(rows) {
   return [...rows].sort((a, b) => {
+    const byBook = a.bookKey.localeCompare(b.bookKey);
+    if (byBook !== 0) return byBook;
     const byRoot = a.projectRoot.localeCompare(b.projectRoot);
     if (byRoot !== 0) return byRoot;
     const aNum = a.issueNumber;
@@ -25095,23 +25068,31 @@ function findTaishiLibraryIndexRow(index, issueNumber) {
   if (index === void 0) return void 0;
   return index.rows.find((row) => row.issueNumber === issueNumber);
 }
+function indexRowKey(row) {
+  return `${row.bookKey}\0${row.projectRoot}`;
+}
+function issueBookKey(bookKey, issueNumber) {
+  return `${bookKey}\0${issueNumber}`;
+}
 function upsertTaishiLibraryIndexRows(existing, upserts) {
-  const byRoot = /* @__PURE__ */ new Map();
-  const rootByIssue = /* @__PURE__ */ new Map();
+  const byKey = /* @__PURE__ */ new Map();
+  const keyByIssue = /* @__PURE__ */ new Map();
   const ingest = (row) => {
+    const key = indexRowKey(row);
     if (row.issueNumber !== void 0) {
-      const priorRoot = rootByIssue.get(row.issueNumber);
-      if (priorRoot !== void 0 && priorRoot !== row.projectRoot) {
-        byRoot.delete(priorRoot);
+      const issueKey = issueBookKey(row.bookKey, row.issueNumber);
+      const priorKey = keyByIssue.get(issueKey);
+      if (priorKey !== void 0 && priorKey !== key) {
+        byKey.delete(priorKey);
       }
     }
-    const prior = byRoot.get(row.projectRoot);
+    const prior = byKey.get(key);
     if (prior !== void 0 && prior.issueNumber !== void 0 && prior.issueNumber !== row.issueNumber) {
-      rootByIssue.delete(prior.issueNumber);
+      keyByIssue.delete(issueBookKey(prior.bookKey, prior.issueNumber));
     }
-    byRoot.set(row.projectRoot, row);
+    byKey.set(key, row);
     if (row.issueNumber !== void 0) {
-      rootByIssue.set(row.issueNumber, row.projectRoot);
+      keyByIssue.set(issueBookKey(row.bookKey, row.issueNumber), key);
     }
   };
   if (existing !== void 0) {
@@ -25122,7 +25103,7 @@ function upsertTaishiLibraryIndexRows(existing, upserts) {
   for (const row of upserts) {
     ingest(row);
   }
-  return buildTaishiLibraryIndexPage([...byRoot.values()]);
+  return buildTaishiLibraryIndexPage([...byKey.values()]);
 }
 async function readTaishiLibraryIndexPage(ledgerHome) {
   const path = taishiLibraryIndexPath(ledgerHome);
@@ -25233,11 +25214,13 @@ async function aggregateGroup(index, input, ensureIssuePage) {
     }
     const page = await ensureIssuePage({
       projectRoot: row.projectRoot,
-      issueNumber
+      issueNumber,
+      bookKey: row.bookKey
     });
     issueEntries.push({
       issueNumber,
       status: "present",
+      bookKey: row.bookKey,
       projectRoot: row.projectRoot
     });
     const acceptance = page.acceptanceSuccessRework;
@@ -25612,6 +25595,22 @@ function parseRunDirectoryName(name) {
   if (at <= 0 || at === name.length - 1) return void 0;
   return { runId: name.slice(0, at), role: name.slice(at + 1) };
 }
+function tryResolveBookKeyFromProjectRoot(projectRoot) {
+  try {
+    return resolveBookKeyFromGit(projectRoot);
+  } catch {
+    return void 0;
+  }
+}
+async function listLedgerBookNames(booksRoot) {
+  try {
+    const entries = await readdir5(booksRoot, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory()).map((e) => e.name).sort();
+  } catch (error) {
+    if (isMissingPathError4(error)) return [];
+    throw error;
+  }
+}
 async function readInvocationScopeFields(runDirectory) {
   let raw;
   try {
@@ -25632,14 +25631,18 @@ async function readInvocationScopeFields(runDirectory) {
   return { projectRoot };
 }
 function decideIssueScope(input) {
-  const projectRootMatch = input.runProjectRootIdentity === input.scopeProjectRootIdentity;
-  if (input.scopeTicketNumber !== void 0 && input.runTicketNumber !== void 0) {
-    if (input.runTicketNumber === input.scopeTicketNumber) {
-      return { inScope: true, conflict: !projectRootMatch };
-    }
-    return { inScope: false, conflict: false };
+  if (input.scopeTicketNumber !== void 0) {
+    return { inScope: input.runTicketNumber === input.scopeTicketNumber };
+  }
+  if (input.wholeBook) {
+    return { inScope: true };
+  }
+  if (input.scopeRootIdentity !== void 0) {
+    return {
+      inScope: input.runProjectRootIdentity === input.scopeRootIdentity
+    };
   }
-  return { inScope: projectRootMatch, conflict: false };
+  return { inScope: true };
 }
 async function resolveSessionFile(runDirectory) {
   try {
@@ -25774,18 +25777,29 @@ async function classifyScopedRun(input) {
 }
 async function scanTaishiIssueRuns(input) {
   const ledgerHome = resolveActivationLedgerHome();
-  const scopeIdentity = physicalPathIdentity(input.projectRoot);
   const scopeTicketNumber = input.ticketNumber;
   const booksRoot = join22(ledgerHome, "books");
+  let wholeBook = false;
+  let scopeRootIdentity;
   let bookNames;
-  try {
-    const entries = await readdir5(booksRoot, { withFileTypes: true });
-    bookNames = entries.filter((e) => e.isDirectory()).map((e) => e.name).sort();
-  } catch (error) {
-    if (isMissingPathError4(error)) {
-      return { runs: [], unreadable: [], scopeConflicts: [] };
+  if (input.bookKey !== void 0 && input.bookKey.trim() !== "") {
+    bookNames = [input.bookKey];
+    wholeBook = true;
+  } else if (input.projectRoot !== void 0) {
+    const resolved = tryResolveBookKeyFromProjectRoot(input.projectRoot);
+    if (resolved !== void 0) {
+      bookNames = [resolved];
+      wholeBook = true;
+    } else {
+      bookNames = await listLedgerBookNames(booksRoot);
+      scopeRootIdentity = physicalPathIdentity(input.projectRoot);
     }
-    throw error;
+  } else {
+    bookNames = await listLedgerBookNames(booksRoot);
+    wholeBook = true;
+  }
+  if (bookNames.length === 0) {
+    return { runs: [], unreadable: [], scopeConflicts: [] };
   }
   const runs = [];
   const unreadable = [];
@@ -25814,20 +25828,13 @@ async function scanTaishiIssueRuns(input) {
       if (scopeFields === void 0) continue;
       const runProjectRootIdentity = physicalPathIdentity(scopeFields.projectRoot);
       const decision = decideIssueScope({
-        scopeProjectRootIdentity: scopeIdentity,
         scopeTicketNumber,
+        wholeBook,
+        scopeRootIdentity,
         runProjectRootIdentity,
         runTicketNumber: scopeFields.ticketNumber
       });
       if (!decision.inScope) continue;
-      if (decision.conflict) {
-        scopeConflicts.push({
-          runId: parsed.runId,
-          ticketNumber: scopeFields.ticketNumber,
-          projectRoot: runProjectRootIdentity,
-          fact: "typed-ticketNumber-over-projectRoot"
-        });
-      }
       const classified = await classifyScopedRun({
         book,
         runId: parsed.runId,
@@ -25848,6 +25855,7 @@ var LIVE_RUN_STATES;
 var init_taishi_ledger = __esm({
   "src/taishi-ledger.ts"() {
     "use strict";
+    init_activation_ledger_git();
     init_activation_ledger_topology();
     init_ledger_session_read();
     init_run_terminal_artifacts();
@@ -26583,12 +26591,24 @@ var init_taishi_metric_family = __esm({
 // src/taishi-page.ts
 import { createHash as createHash4 } from "node:crypto";
 import { dirname as dirname10, join as join23 } from "node:path";
-function taishiIssuePageKey(projectRoot) {
-  const identity = physicalPathIdentity(projectRoot);
-  return createHash4("sha256").update(identity).digest("hex").slice(0, 32);
+function taishiIssuePageKey(address) {
+  const parts = ["book", address.bookKey];
+  if (address.issueNumber !== void 0) {
+    parts.push("ticket", String(address.issueNumber));
+  } else if (address.scopeRootIdentity !== void 0) {
+    parts.push("root", physicalPathIdentity(address.scopeRootIdentity));
+  }
+  return createHash4("sha256").update(parts.join("\0")).digest("hex").slice(0, 32);
 }
-function taishiIssuePagePath(ledgerHome, projectRoot) {
-  return join23(ledgerHome, "taishi", "issues", `${taishiIssuePageKey(projectRoot)}.json`);
+function taishiIssuePagePath(ledgerHome, address) {
+  return join23(ledgerHome, "taishi", "issues", `${taishiIssuePageKey(address)}.json`);
+}
+function taishiIssuePageAddressFromPage(page) {
+  return {
+    bookKey: page.bookKey,
+    ...page.issueNumber === void 0 ? {} : { issueNumber: page.issueNumber },
+    ...page.scopeRootIdentity === void 0 ? {} : { scopeRootIdentity: page.scopeRootIdentity }
+  };
 }
 function sortLegs(legs) {
   return [...legs].sort((a, b) => {
@@ -26677,9 +26697,11 @@ async function buildTaishiIssueMetricsPage(input) {
   const envelope = {
     kind: "taishi-issue-metrics",
     mode: "issue",
+    bookKey: input.bookKey,
     projectRoot,
     // exactOptionalPropertyTypes: only materialize when caller supplied it.
     ...input.issueNumber === void 0 ? {} : { issueNumber: input.issueNumber },
+    ...input.scopeRootIdentity === void 0 ? {} : { scopeRootIdentity: physicalPathIdentity(input.scopeRootIdentity) },
     legs,
     unreadable,
     unreadableCount: unreadable.length,
@@ -26697,7 +26719,7 @@ async function buildTaishiIssueMetricsPage(input) {
   return { ...envelope, ...sections };
 }
 async function writeTaishiIssueMetricsPage(ledgerHome, page) {
-  const path = taishiIssuePagePath(ledgerHome, page.projectRoot);
+  const path = taishiIssuePagePath(ledgerHome, taishiIssuePageAddressFromPage(page));
   ensureRealDirectoryTree(ledgerHome, dirname10(path));
   assertLedgerFileInsideHome(path, ledgerHome);
   await writeFileAtomically(path, `${JSON.stringify(page, null, 2)}
@@ -26720,27 +26742,51 @@ function isMissingPathError5(error) {
   return error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
 }
 function cachedPageMatchesRequestedScope(page, input) {
+  if (page.bookKey !== input.bookKey) return false;
   const requestedTicket = input.ticketNumber ?? input.issueNumber;
   if (requestedTicket === void 0) {
     return page.issueNumber === void 0;
   }
   return page.issueNumber === requestedTicket;
 }
+function tryResolveBookKey(projectRoot) {
+  try {
+    return resolveBookKeyFromGit(projectRoot);
+  } catch {
+    return void 0;
+  }
+}
+function resolveIssueBookKey(input) {
+  if (input.bookKey !== void 0 && input.bookKey.trim() !== "") {
+    return input.bookKey;
+  }
+  const fromGit = tryResolveBookKey(input.projectRoot);
+  if (fromGit !== void 0) return fromGit;
+  return `root:${physicalPathIdentity(input.projectRoot)}`;
+}
 async function readOrComputeTaishiIssuePage(input) {
   const ledgerHome = resolveActivationLedgerHome();
   const projectRoot = physicalPathIdentity(input.projectRoot);
-  const pagePath = taishiIssuePagePath(ledgerHome, projectRoot);
+  const bookKey = resolveIssueBookKey(input);
+  const issueNumber = input.ticketNumber ?? input.issueNumber;
+  const pagePath = taishiIssuePagePath(ledgerHome, {
+    bookKey,
+    ...issueNumber === void 0 ? {} : { issueNumber },
+    // Sweep/legacy path-narrow pages (no ticket, no explicit CLI book-only scope).
+    ...issueNumber === void 0 && input.bookKey === void 0 ? { scopeRootIdentity: projectRoot } : {}
+  });
   try {
     const raw = await readFile14(pagePath, "utf8");
     const page = JSON.parse(raw);
-    if (cachedPageMatchesRequestedScope(page, input)) {
+    if (cachedPageMatchesRequestedScope(page, { bookKey, ...input })) {
       return { mode: "issue", page, pagePath };
     }
   } catch (error) {
     if (!isMissingPathError5(error)) {
       throw new TaishiIssueComputeError({
+        bookKey,
         projectRoot,
-        ...input.issueNumber === void 0 ? {} : { issueNumber: input.issueNumber },
+        ...issueNumber === void 0 ? {} : { issueNumber },
         cause: error
       });
     }
@@ -26750,8 +26796,9 @@ async function readOrComputeTaishiIssuePage(input) {
   } catch (error) {
     if (error instanceof TaishiIssueComputeError) throw error;
     throw new TaishiIssueComputeError({
+      bookKey,
       projectRoot,
-      ...input.issueNumber === void 0 ? {} : { issueNumber: input.issueNumber },
+      ...issueNumber === void 0 ? {} : { issueNumber },
       cause: error
     });
   }
@@ -26761,28 +26808,26 @@ async function runTaishiIssueMode(input, precomputedScan) {
   const ledgerHome = resolveActivationLedgerHome();
   const projectRoot = input.projectRoot;
   const ticketNumber = "ticketNumber" in input ? input.ticketNumber : void 0;
-  const scan = precomputedScan ?? (ticketNumber === void 0 ? await scanTaishiIssueRuns({ projectRoot }) : await scanTaishiIssueRuns({ projectRoot, ticketNumber }));
+  const inputBookKey = "bookKey" in input && typeof input.bookKey === "string" && input.bookKey.trim() !== "" ? input.bookKey : void 0;
+  const scan = precomputedScan ?? (inputBookKey !== void 0 ? await scanTaishiIssueRuns({
+    bookKey: inputBookKey,
+    ...ticketNumber === void 0 ? {} : { ticketNumber }
+  }) : ticketNumber === void 0 ? await scanTaishiIssueRuns({ projectRoot }) : await scanTaishiIssueRuns({ projectRoot, ticketNumber }));
   const issueNumber = "issueNumber" in input ? input.issueNumber : void 0;
-  const conflictingProjectRoot = "conflictingProjectRoot" in input ? input.conflictingProjectRoot : void 0;
-  const scopeConflicts = [...scan.scopeConflicts];
-  if (conflictingProjectRoot !== void 0 && ticketNumber !== void 0) {
-    const losingRoot = physicalPathIdentity(conflictingProjectRoot);
-    const winningRoot = physicalPathIdentity(projectRoot);
-    if (losingRoot !== winningRoot) {
-      scopeConflicts.push({
-        ticketNumber,
-        projectRoot: losingRoot,
-        fact: "typed-ticketNumber-over-projectRoot"
-      });
-    }
-  }
+  const bookKey = resolveIssueBookKey({
+    ...inputBookKey === void 0 ? {} : { bookKey: inputBookKey },
+    projectRoot
+  });
+  const scopeRootIdentity = inputBookKey === void 0 && ticketNumber === void 0 && issueNumber === void 0 ? physicalPathIdentity(projectRoot) : void 0;
   const page = await buildTaishiIssueMetricsPage({
+    bookKey,
     projectRoot,
     runs: scan.runs,
     unreadable: scan.unreadable,
-    scopeConflicts,
+    scopeConflicts: scan.scopeConflicts,
     ...input.changedLines === void 0 ? {} : { changedLines: input.changedLines },
-    ...issueNumber === void 0 ? {} : { issueNumber }
+    ...issueNumber === void 0 ? {} : { issueNumber },
+    ...scopeRootIdentity === void 0 ? {} : { scopeRootIdentity }
   });
   const pagePath = await writeTaishiIssueMetricsPage(ledgerHome, page);
   if (issueNumber !== void 0) {
@@ -26818,19 +26863,23 @@ async function runTaishiModelGroupsMode(input) {
     const scan = await scanTaishiIssueRuns({ projectRoot });
     runs.push(...scan.runs);
     unreadable.push(...scan.unreadable);
-    const pagePath = taishiIssuePagePath(ledgerHome, projectRoot);
+    const bookKey = resolveIssueBookKey({ projectRoot });
+    const pagePath = taishiIssuePagePath(ledgerHome, {
+      bookKey,
+      scopeRootIdentity: projectRoot
+    });
     try {
       const raw = await readFile14(pagePath, "utf8");
       JSON.parse(raw);
     } catch (error) {
       if (!isMissingPathError5(error)) {
-        throw new TaishiIssueComputeError({ projectRoot, cause: error });
+        throw new TaishiIssueComputeError({ bookKey, projectRoot, cause: error });
       }
       try {
         await runTaishiIssueMode({ mode: "issue", projectRoot }, scan);
       } catch (computeError) {
         if (computeError instanceof TaishiIssueComputeError) throw computeError;
-        throw new TaishiIssueComputeError({ projectRoot, cause: computeError });
+        throw new TaishiIssueComputeError({ bookKey, projectRoot, cause: computeError });
       }
     }
   }
@@ -26848,11 +26897,13 @@ async function runTaishi(input) {
   }
   if (input.mode === "cohort") {
     const ledgerHome = resolveActivationLedgerHome();
-    return runTaishiCohortMode(ledgerHome, input, async ({ projectRoot, issueNumber }) => {
+    return runTaishiCohortMode(ledgerHome, input, async ({ projectRoot, issueNumber, bookKey }) => {
+      const realBookKey = bookKey !== void 0 && !bookKey.startsWith("root:") ? bookKey : void 0;
       const ensured = await readOrComputeTaishiIssuePage({
         mode: "issue",
         projectRoot,
-        issueNumber
+        issueNumber,
+        ...realBookKey === void 0 ? {} : { bookKey: realBookKey }
       });
       return ensured.page;
     });
@@ -26872,19 +26923,22 @@ var init_taishi_entry = __esm({
     init_taishi_ledger();
     init_taishi_index();
     init_taishi_model_groups();
+    init_activation_ledger_git();
     init_taishi_page();
     TaishiIssueComputeError = class extends Error {
       code = "taishi-issue-compute-failed";
+      bookKey;
       projectRoot;
       issueNumber;
       constructor(input) {
         const root = physicalPathIdentity(input.projectRoot);
         const causeText = input.cause instanceof Error ? input.cause.message || input.cause.name : String(input.cause);
-        const issueFace = input.issueNumber === void 0 ? `projectRoot ${root}` : `issue ${input.issueNumber} (projectRoot ${root})`;
+        const issueFace = input.issueNumber === void 0 ? `book ${input.bookKey} (projectRoot ${root})` : `issue ${input.issueNumber} book ${input.bookKey} (projectRoot ${root})`;
         super(`taishi compute failed for ${issueFace}: ${causeText}`, {
           cause: input.cause
         });
         this.name = "TaishiIssueComputeError";
+        this.bookKey = input.bookKey;
         this.projectRoot = root;
         if (input.issueNumber !== void 0) {
           this.issueNumber = input.issueNumber;
@@ -26915,34 +26969,37 @@ var init_taishi_entry = __esm({
 // src/public-cli/taishi-run.ts
 import { readFile as readFile15 } from "node:fs/promises";
 import { isAbsolute as isAbsolute5, resolve as resolve7 } from "node:path";
-async function buildTaishiIssueModeInputFromPublicArgv(parsed, ledgerHome) {
+function resolveTaishiIssueBookKeyFromCwd(cwd = process.cwd()) {
+  try {
+    return resolveBookKeyFromGit(cwd);
+  } catch (error) {
+    if (error instanceof ActivationGitRepositoryRequiredError) {
+      throw new CliUsageError(
+        "taishi issue query requires a git repository cwd (book = git common-dir); run inside a repository (bare = whole book, or --ticket N)",
+        { cause: error }
+      );
+    }
+    throw error;
+  }
+}
+async function buildTaishiIssueModeInputFromPublicArgv(parsed, _ledgerHome) {
+  const cwd = process.cwd();
+  const bookKey = resolveTaishiIssueBookKeyFromCwd(cwd);
+  const projectRoot = physicalPathIdentity(cwd);
   const ticket = parsed.ticket;
-  const directRoot = parsed.projectRoot;
   if (ticket === void 0) {
     return {
       mode: "issue",
-      projectRoot: directRoot
+      bookKey,
+      projectRoot
     };
   }
-  const index = await readTaishiLibraryIndexPage(ledgerHome);
-  const row = findTaishiLibraryIndexRow(index, ticket);
-  let projectRoot;
-  if (row !== void 0) {
-    projectRoot = row.projectRoot;
-  } else if (directRoot !== void 0) {
-    projectRoot = directRoot;
-  } else {
-    throw new CliUsageError(
-      `taishi library index has no row for ticket ${ticket}`
-    );
-  }
-  const dualParamConflict = row !== void 0 && directRoot !== void 0 && physicalPathIdentity(directRoot) !== physicalPathIdentity(projectRoot);
   return {
     mode: "issue",
+    bookKey,
     projectRoot,
     ticketNumber: ticket,
-    issueNumber: ticket,
-    ...dualParamConflict ? { conflictingProjectRoot: directRoot } : {}
+    issueNumber: ticket
   };
 }
 function parseTaishiSweepModeInputFromJsonValue(value) {
@@ -27007,15 +27064,6 @@ async function runPublicTaishi(argv, _env, io, parseTaishiArgv2) {
         groups: parsed.groups
       });
       io.stdout(`${JSON.stringify(result3, null, 2)}
-`);
-      return { exitCode: 0 };
-    }
-    if (parsed.query === "model-groups") {
-      const result3 = await runTaishi({
-        mode: "model-groups",
-        projectRoots: parsed.projectRoots
-      });
-      io.stdout(`${JSON.stringify(result3, null, 2)}
 `);
       return { exitCode: 0 };
     }
@@ -27037,6 +27085,7 @@ async function runPublicTaishi(argv, _env, io, parseTaishiArgv2) {
         ...code === void 0 ? {} : { identity: { code } },
         details: {
           code: error.code,
+          bookKey: error.bookKey,
           projectRoot: error.projectRoot,
           ...error.issueNumber === void 0 ? {} : { issueNumber: error.issueNumber }
         }
@@ -27050,9 +27099,9 @@ var init_taishi_run = __esm({
   "src/public-cli/taishi-run.ts"() {
     "use strict";
     init_value2();
+    init_activation_ledger_git();
     init_activation_ledger_topology();
     init_exact_utf8();
-    init_taishi_index();
     init_taishi_entry();
     init_cli_errors();
     init_settlement();