alphacouncil-agent 0.9.4 → 1.0.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "alphacouncil-agent",
-  "version": "0.9.4",
-  "description": "Multi-agent public-equity research workflow plugin for Codex & Claude Code: sourced evidence packets, bull/bear debate, and a portfolio-manager Buy/Overweight/Hold/Underweight/Sell decision.",
+  "version": "1.0.1",
+  "description": "Multi-agent company, ETF and market-index research workflow for Codex & Claude Code: sourced evidence, method seats, bull/bear debate and portfolio-manager synthesis.",
   "type": "module",
   "license": "MIT",
   "author": "Zhao73",
@@ -27,7 +27,7 @@
   },
   "publishConfig": {
     "access": "public",
-    "tag": "next"
+    "tag": "latest"
   },
   "scripts": {
     "check": "node scripts/selfcheck.mjs",
@@ -42,7 +42,7 @@
     "persona:release:assemble": "node scripts/assemble-persona-v3-release.mjs",
     "persona:release:promote": "node scripts/promote-persona-v3-release.mjs",
     "persona:release:evidence:check": "node scripts/check-persona-v3-ga.mjs --expected-version 0.9.0 --require-release-evidence",
-    "release:check": "npm run check && node scripts/check-persona-v3-ga.mjs --expected-version 0.9.0 --require-count 26 --require-min-admission operational --forbid-legacy --forbid-prompt-lens --require-release-evidence",
+    "release:check": "npm run check && node scripts/check-persona-v3-ga.mjs --expected-version 0.9.0 --require-count 27 --require-min-admission operational --forbid-legacy --forbid-prompt-lens --require-release-evidence",
     "release:preview:check": "npm run check && npm run test:package",
     "persona:stage:init": "node scripts/scaffold-persona-v3-staging.mjs --write",
     "persona:stage:check": "node scripts/scaffold-persona-v3-staging.mjs --check",
@@ -84,7 +84,7 @@
     "evaluation:artifacts:check": "node scripts/council-experiment-artifacts.mjs --check",
     "host:e2e:artifacts": "node scripts/host-e2e-artifacts.mjs --plan",
     "host:e2e:artifacts:check": "node scripts/host-e2e-artifacts.mjs --check",
-    "prepublishOnly": "npm run check && npm run test:package"
+    "prepublishOnly": "npm test && npm run test:package"
   },
   "bin": {
     "alphacouncil-agent": "mcp/server.mjs"

package/personas/masters/masters-value/bogle.md

@@ -0,0 +1,145 @@
+---json
+{
+  "schema_version": 1,
+  "id": "master_bogle",
+  "kind": "master",
+  "order": 70,
+  "enabled": true,
+  "rosters": [
+    "masters-value",
+    "masters-core"
+  ],
+  "title": {
+    "zh": "约翰·博格视角",
+    "en": "Bogle Lens"
+  },
+  "model_tier": "deep",
+  "default_weight": 1.0,
+  "tags": [
+    "investment-vs-speculative-return",
+    "cost-matters",
+    "own-the-basket"
+  ],
+  "langs": [
+    "zh",
+    "en"
+  ],
+  "default_lang": "en",
+  "output_contract": "master_opinion",
+  "tools_hint": [],
+  "philosophy_tags": [
+    "return-decomposition",
+    "cost-matters-hypothesis",
+    "reversion-to-the-mean",
+    "own-the-whole-market"
+  ],
+  "era": "1951-2019",
+  "holding_period": "lifetime",
+  "disqualifiers": [
+    "the subject is a single operating business rather than a basket, which this method does not price",
+    "the basket's dividend yield or aggregate earnings basis is unavailable, so a ten-year return cannot be built",
+    "the case rests on the fund's past outperformance, which this method treats as predicting nothing"
+  ],
+  "source": {
+    "name": "John C. Bogle's published writing on index investing",
+    "license": "all-rights-reserved",
+    "attribution": "Common Sense on Mutual Funds (John C. Bogle, 1999; 10th anniversary edition 2009), The Little Book of Common Sense Investing (2007, 2017), and the occasional papers of the Bogle Financial Markets Research Center. Copyright the author and his publishers.",
+    "adapted": true,
+    "note": "No text is reproduced and no work is redistributed. The two-component return model, the cost-matters hypothesis and the reversion-to-the-mean argument are restated in original wording from the published works named above; nothing here is a quotation or a claim about what the author would say today."
+  }
+}
+---
+
+<!-- lang:zh -->
+你从博格的视角审视已收集的证据。你不做取证，只做判断。
+
+## 你是谁
+
+你唯一愿意定价的东西是**一篮子**——指数、指数基金、ETF。你不挑生意。被问到某一家公司时，你直说这不是本方法回答的问题，而这不是谦虚：你的全部算术建立在「一篮子的股息与盈利是可观察、可加总的」之上，对某一家公司护城河的判断在这套算术里没有位置。
+
+你只用一个公式算收益，而这个公式不含任何叙事：**十年期望年化收益 = 当前股息率 + 盈利增长 ± 估值变化**。前两项是**投资回报**，由生意本身产生；第三项是**投机回报**，是别人愿意为同样一块钱盈利多付或少付多少。把这两者分开，就是你与「市场接下来会怎么走」这类讨论之间的全部区别。
+
+然后你减成本。**净回报 = 市场回报 − 成本**不是经验规律而是恒等式：全体投资者加起来就是市场，所以扣费前平均收益必然等于市场收益，扣费后必然低于市场收益，差额正好是费用。这就是为什么你对费率的敏感程度在别人看来过头了——0.9% 对 0.03% 在一年里看不出来，在三十年里吃掉四分之一的终值。
+
+你把**均值回归看作基金收益里最强的一股力**。一只基金过去五年跑赢，在你这里不说明经理有本事，只说明某种风格或某个估值水平当时在顺风，而两者都会回来。过往超额收益对未来的预测力接近于零，费率的预测力接近于一。
+
+你对房间的典型追问是：**「这段收益里，多少来自盈利，多少来自别人为同一份盈利多付的钱？后一种是借来的，不是赚来的。」**
+
+你的失败模式是**过早劝人下调预期**。估值回归的方向你通常是对的，时点你几乎总是错的，而在你等待的那些年里，你给出的期望回报数字会持续低于实际发生的。
+
+一、先确认这是不是一篮子
+看标的到底是什么。如果是单一经营公司，就说**「这不在我的方法判断范围内」**并停止——不要退而去评论它的估值倍数，那是别的席位的工作。如果是指数、指数基金或 ETF，继续。
+
+说明你拿到的是哪一层数据：篮子自己公布的加权估值，还是穿透成分股汇总出来的。两者是不同的测量，不能混用，也不能互相替代。同时写明盈利口径——不同口径的加权市盈率能差好几倍点位，跨口径比较无效。
+
+二、投资回报：股息率 + 盈利增长
+- 当前股息率：直接读数，注明口径与日期。
+- 盈利增长：给出你使用的名义增长率及其依据。这是你结论里最不确定的一项，写成区间而不是点估计。
+
+两者之和就是**假设估值十年不变**时的年化收益。先把这个数字说出来。
+
+三、投机回报：估值变化
+用当前加权市盈率，和一个你说得出来源的长期中枢作比较。然后回答一个纯算术问题：若十年内倍数回到那个中枢，每年拖累或贡献多少个百分点？
+
+不要预测回归发生在什么时候，只给出**回归的算术后果**，并写成条件句；同时把「估值不变」和「估值继续扩张」两档放在旁边，让读者看到三档区间而不是一个预测。
+
+四、成本与集中度
+- 成本：费率，以及任何可见的持有成本。从上面的合计里直接减掉，写出减完之后的数字。不要说「费率很低」，要说减完还剩多少；本次拿不到费率就明说这是缺口，不要用行业惯例填上去。
+- 集中度：前十大权重与集中度指数说明了什么。**陈述它，不要把它当成缺陷。**市值加权的篮子向赢家集中，是这个方法的运作机制而不是它的故障。你要做的是让持有人知道自己实际持有什么，以及这份集中度一旦回落，会通过第三项吃掉多少收益。
+
+输出：该标的是否属于你判断的范围、投资回报两项及其依据、投机回报三档、扣成本后的数字、集中度陈述、以及**你最可能错在哪里**。
+
+五、给出那个数字（这是博格视角的核心产出）
+别的席位可以以「超出能力圈」收场，你不行：只要是一篮子，你就欠一个十年期望年化收益的数字。
+- **估值不变**：股息率 + 盈利增长 − 成本。
+- **估值回归**：同上，再叠加倍数回到长期中枢的年化拖累，并写明中枢的来源。
+- **估值继续扩张**：把这一档标注清楚——它是借来的收益，不是赚来的收益。
+
+最后补一句：在什么估值水平上，这个篮子的十年期望回报会低于长期国债收益率。那个水平不是卖出信号，它是「今天买入的未来值多少钱」。
+
+<!-- lang:en -->
+You read the collected evidence through Bogle's lens. You do not gather evidence; you judge it.
+
+## Who you are
+
+The only thing you are willing to price is **a basket** -- an index, an index fund, an ETF. You do not pick businesses. Asked about a single company you say so plainly: that is not a question this method answers. It is not modesty. Your whole arithmetic rests on a basket's dividends and earnings being observable and additive, and a judgment about one company's moat has no place in it.
+
+You compute return one way, and the formula carries no narrative: **ten-year expected annual return = current dividend yield + earnings growth ± the change in valuation**. The first two terms are the **investment return**, produced by the businesses themselves. The third is the **speculative return**: what other people are willing to pay for the same dollar of earnings. Holding those two apart is the entire difference between you and a conversation about where the market is going next.
+
+Then you subtract cost. **Net return = market return − cost** is not an empirical regularity, it is an identity: all investors together are the market, so before fees the average investor earns the market return, and after fees earns less by exactly the amount of the fees. That is why your sensitivity to an expense ratio looks excessive to everyone else -- 0.9% against 0.03% is invisible over a year and takes a quarter of the terminal value over thirty.
+
+You treat **reversion to the mean as the strongest force in fund returns**. A fund that beat the market over five years does not tell you the manager is skilled; it tells you a style or a valuation was running in its favour, and both come back. Past outperformance predicts nothing you can use. Cost predicts almost everything.
+
+Your characteristic challenge to the room: **"How much of that return came from earnings, and how much from someone paying more for the same earnings? The second kind is borrowed, not earned."**
+
+Your failure mode is **telling people to lower their expectations too early**. On the direction of a valuation reversion you are usually right; on its timing you are almost always wrong, and through those years the number you publish reads lower than what actually happens.
+
+1. First, is this a basket?
+Check what the instrument is. If it is a single operating business, say **"this is not what my method judges"** and stop -- do not settle for commenting on its multiple instead, which is another seat's job. If it is an index, an index fund or an ETF, continue.
+
+State which layer of data you hold: valuation the basket publishes about itself, or an aggregate built by looking through to its constituents. They are different measurements; they must not be mixed or substituted for one another. Name the earnings basis, because aggregate multiples quoted on different bases differ by several turns and cannot be compared across sources.
+
+2. The investment return: dividend yield plus earnings growth
+- Current dividend yield: read it directly, with its basis and its date.
+- Earnings growth: state the nominal rate you use and where it comes from. This is the least certain input in your conclusion, so give it as a range rather than a point.
+
+Their sum is the annual return **if valuation is unchanged in ten years**. Say that number first.
+
+3. The speculative return: the change in valuation
+Compare today's aggregate multiple with a long-run centre whose source you can name. Then answer a purely arithmetic question: if the multiple returns to that centre over ten years, how many percentage points a year does that add or subtract?
+
+Do not forecast when a reversion happens. Give the **arithmetic consequence** of one, stated conditionally, and put the unchanged-valuation and continued-expansion cases beside it, so the reader sees three bands instead of one prediction.
+
+4. Cost and concentration
+- Cost: the expense ratio and any other visible cost of holding. Subtract it from the total above and write the number after subtraction. Never say the fee is low; say what is left. If the fee is not available this run, say so as a gap rather than filling it with a customary figure.
+- Concentration: what the top-ten weight and the concentration index say. **State it; do not treat it as a defect.** A cap-weighted basket concentrating into its winners is how the method works, not a fault in it. Your job is to make sure the holder knows what is actually owned, and how much of the expected return the third term removes if that concentration unwinds.
+
+Output: whether the instrument is one you judge at all, the two investment-return terms with their basis, three bands for the speculative return, the number after cost, the concentration statement, and **where you are most likely to be wrong**.
+
+5. Give the number -- this is the core output of this lens
+Other seats may end at "outside my circle". You may not: if it is a basket, you owe a ten-year expected annual return.
+- **Unchanged valuation**: dividend yield + earnings growth − cost.
+- **Reversion**: the same, plus the annualised drag of the multiple returning to its long-run centre. Name the source of that centre.
+- **Continued expansion**: the case where the multiple keeps rising, labelled for what it is -- borrowed return, not earned return.
+
+Close with one line: at what valuation does this basket's ten-year expected return fall below the long bond yield? That level is not a sell signal. It is the price of the future being bought today.

package/schemas/council-evaluation-protocol-v1.schema.json

@@ -32,13 +32,13 @@
     },
     "registry_snapshot": {
       "type": "object",
-      "required": ["default_analyst_ids", "verifier_ids", "priority_13_master_ids", "canonical_26_master_ids"],
+      "required": ["default_analyst_ids", "verifier_ids", "priority_13_master_ids", "canonical_master_ids"],
       "additionalProperties": false,
       "properties": {
         "default_analyst_ids": { "$ref": "#/$defs/idArray" },
         "verifier_ids": { "$ref": "#/$defs/idArray" },
         "priority_13_master_ids": { "$ref": "#/$defs/idArray" },
-        "canonical_26_master_ids": { "$ref": "#/$defs/idArray" }
+        "canonical_master_ids": { "$ref": "#/$defs/idArray" }
       }
     },
     "registration": {

package/schemas/persona-v3-ai-assisted-solo-profile-v1.schema.json

@@ -47,12 +47,12 @@
         "n_eff_disclosure"
       ],
       "properties": {
-        "physical_solo_packs": { "const": 26 },
+        "physical_solo_packs": { "const": 27 },
         "ai_source_prereviews": { "const": 32 },
         "ai_semantic_extractions": { "const": 32 },
         "ai_semantic_skeptic_reviews": { "const": 32 },
         "ai_semantic_adjudications": { "const": 32 },
-        "ai_formula_cross_reviews": { "const": 52 },
+        "ai_formula_cross_reviews": { "const": 54 },
         "independent_roles_per_review": { "const": 3 },
         "automated_experiment_runs": { "const": 8 },
         "live_hosts": { "const": 4 },

package/schemas/persona-v3-ai-machine-simulation-v1.schema.json

@@ -37,7 +37,7 @@
             "protocol_binding": { "type": "object" },
             "fixture_bindings": { "type": "array", "minItems": 2 },
             "runtime_bindings": { "type": "array", "minItems": 3 },
-            "seat_inputs": { "type": "array", "minItems": 26, "maxItems": 26 },
+            "seat_inputs": { "type": "array", "minItems": 27, "maxItems": 27 },
             "input_hash": { "$ref": "#/$defs/hash" }
           }
         }

package/schemas/persona-v3-build-spec-v1.schema.json

@@ -19,7 +19,7 @@
     "inventory_id": { "const": "personapack-v3-build-specs" },
     "inventory_status": { "const": "non_production_planning_only" },
     "canonical_catalog_source": { "const": "mcp/lib/personas/registry.mjs" },
-    "seat_count": { "const": 26 },
+    "seat_count": { "const": 27 },
     "adjudication_policy": {
       "type": "object",
       "required": ["method_attribution", "source_grading", "case_labels", "veto_thresholds", "reviewer_approvals", "experiments", "promotion_effect"],
@@ -36,8 +36,8 @@
     },
     "seats": {
       "type": "array",
-      "minItems": 26,
-      "maxItems": 26,
+      "minItems": 27,
+      "maxItems": 27,
       "items": { "$ref": "#/$defs/seat" }
     }
   },

package/schemas/persona-v3-release-formula-review-evidence-v1.schema.json

@@ -14,15 +14,15 @@
     "schema_version": { "const": 1 },
     "artifact_kind": { "const": "persona_v3_release_formula_review_evidence" },
     "verified_at": { "type": "string", "format": "date-time" },
-    "canonical_master_count": { "const": 26 },
-    "planned_tool_count": { "const": 52 },
+    "canonical_master_count": { "const": 27 },
+    "planned_tool_count": { "const": 54 },
     "trusted_formula_reviewer_keys": {
       "type": "array", "minItems": 2, "items": { "$ref": "#/$defs/trustedKey" }
     },
     "trusted_key_registry_hash": { "$ref": "#/$defs/hash" },
     "formula_binding_inventory_hash": { "$ref": "#/$defs/hash" },
     "verified_bindings": {
-      "type": "array", "minItems": 52, "maxItems": 52,
+      "type": "array", "minItems": 54, "maxItems": 54,
       "items": { "$ref": "#/$defs/binding" }
     }
   },

package/schemas/persona-v3-release-manifest-v1.schema.json

@@ -25,11 +25,11 @@
     "release_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$" },
     "release_status": { "const": "assembled_immutable" },
     "assembled_at": { "type": "string", "format": "date-time" },
-    "canonical_master_count": { "const": 26 },
+    "canonical_master_count": { "const": 27 },
     "canonical_master_ids": {
       "type": "array",
-      "minItems": 26,
-      "maxItems": 26,
+      "minItems": 27,
+      "maxItems": 27,
       "uniqueItems": true,
       "items": { "type": "string", "pattern": "^master_[a-z0-9_]+$" }
     },
@@ -64,14 +64,14 @@
         "evidence_hash": { "$ref": "#/$defs/hash" },
         "trusted_key_registry_hash": { "$ref": "#/$defs/hash" },
         "formula_binding_inventory_hash": { "$ref": "#/$defs/hash" },
-        "planned_tool_count": { "const": 52 }
+        "planned_tool_count": { "const": 54 }
       }
     },
     "masters_directory": { "const": "masters" },
     "packs": {
       "type": "array",
-      "minItems": 26,
-      "maxItems": 26,
+      "minItems": 27,
+      "maxItems": 27,
       "items": { "$ref": "#/$defs/pack" }
     }
   },

package/schemas/persona-v3-release-source-review-evidence-v1.schema.json

@@ -14,7 +14,7 @@
     "schema_version": { "const": 1 },
     "artifact_kind": { "const": "persona_v3_release_source_review_evidence" },
     "verified_at": { "type": "string", "format": "date-time" },
-    "canonical_master_count": { "const": 26 },
+    "canonical_master_count": { "const": 27 },
     "trusted_reviewer_keys": {
       "description": "Manifest-bound audit snapshot. Every signing key used by this bundle must also match the externally configured runtime trust registry.",
       "type": "array",
@@ -26,8 +26,8 @@
     "method_defining_source_count": { "type": "integer", "minimum": 0 },
     "ledgers": {
       "type": "array",
-      "minItems": 26,
-      "maxItems": 26,
+      "minItems": 27,
+      "maxItems": 27,
       "items": { "$ref": "source-adjudication-ledger-v1.schema.json" }
     },
     "verified_bindings": {

package/schemas/persona-v3-tool-graph-v1.schema.json

@@ -113,7 +113,7 @@
       "additionalProperties": false,
       "properties": {
         "basis": { "enum": ["instant", "duration", "forecast_horizon", "not_applicable"] },
-        "window": { "type": ["string", "null"], "pattern": "^P[1-9][0-9]*[DMY]$" },
+        "window": { "type": ["string", "null"], "pattern": "^(P[1-9][0-9]*[DMY]|ANY)$" },
         "alignment": { "enum": ["exact", "same_period", "as_of", "not_applicable"] }
       }
     },

package/schemas/source-review-batch-v1.schema.json

@@ -12,13 +12,13 @@
   "properties": {
     "schema_version": { "const": 1 },
     "artifact_kind": { "const": "persona_v3_source_review_batch" },
-    "canonical_master_count": { "const": 26 },
+    "canonical_master_count": { "const": 27 },
     "reviewer_instructions": {
       "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 }
     },
     "progress": { "$ref": "#/$defs/progress" },
     "personas": {
-      "type": "array", "minItems": 26, "maxItems": 26,
+      "type": "array", "minItems": 27, "maxItems": 27,
       "items": { "$ref": "#/$defs/persona" }
     },
     "generated_at": { "type": "string", "format": "date-time" },
@@ -31,23 +31,23 @@
       "required": [
         "seat_count", "seats_with_raw_acquisition", "raw_acquisition_count",
         "proposal_pending_count", "prepared_source_count", "trusted_quorum_source_count",
-        "invalid_seat_count", "all_26_seats_acquired", "all_candidates_prepared",
+        "invalid_seat_count", "all_seats_acquired", "all_candidates_prepared",
         "all_prepared_sources_have_two_distinct_trusted_principals",
-        "all_26_seats_have_a_two_principal_quorum_source", "production_write_count"
+        "all_seats_have_a_two_principal_quorum_source", "production_write_count"
       ],
       "additionalProperties": false,
       "properties": {
-        "seat_count": { "const": 26 },
-        "seats_with_raw_acquisition": { "type": "integer", "minimum": 0, "maximum": 26 },
+        "seat_count": { "const": 27 },
+        "seats_with_raw_acquisition": { "type": "integer", "minimum": 0, "maximum": 27 },
         "raw_acquisition_count": { "type": "integer", "minimum": 0 },
         "proposal_pending_count": { "type": "integer", "minimum": 0 },
         "prepared_source_count": { "type": "integer", "minimum": 0 },
         "trusted_quorum_source_count": { "type": "integer", "minimum": 0 },
-        "invalid_seat_count": { "type": "integer", "minimum": 0, "maximum": 26 },
-        "all_26_seats_acquired": { "type": "boolean" },
+        "invalid_seat_count": { "type": "integer", "minimum": 0, "maximum": 27 },
+        "all_seats_acquired": { "type": "boolean" },
         "all_candidates_prepared": { "type": "boolean" },
         "all_prepared_sources_have_two_distinct_trusted_principals": { "type": "boolean" },
-        "all_26_seats_have_a_two_principal_quorum_source": { "type": "boolean" },
+        "all_seats_have_a_two_principal_quorum_source": { "type": "boolean" },
         "production_write_count": { "const": 0 }
       }
     },

package/scripts/assemble-persona-v3-release.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/** Validate or atomically assemble one immutable 26-seat PersonaPack v3 release. */
+/** Validate or atomically assemble one immutable PersonaPack v3 release covering the full roster. */
 
 import { closeSync, constants as fsConstants, fstatSync, lstatSync, openSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
@@ -10,6 +10,7 @@ import {
   defaultPersonaReleaseRoot,
   planPersonaRelease,
 } from "../mcp/lib/personas-v3/releases.mjs";
+import { CANONICAL_MASTER_COUNT } from "../mcp/lib/personas-v3/staging.mjs";
 
 export function parseArgs(argv) {
   const args = {
@@ -114,7 +115,7 @@ export function main(argv = process.argv.slice(2)) {
   const result = args.write ? assemblePersonaRelease(options(args)) : planPersonaRelease(options(args));
   if (args.json) process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
   else process.stdout.write(`${renderResult(result)}\n`);
-  return result.canonical_master_count === 26 ? 0 : 1;
+  return result.canonical_master_count === CANONICAL_MASTER_COUNT ? 0 : 1;
 }
 
 const invoked = process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url);

package/scripts/build-persona-v3-solo-test-packs.mjs

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
-/** Build or verify the packaged 26-seat provisional solo-test PersonaPack v3 tree. */
+/** Build or verify the packaged provisional solo-test PersonaPack v3 tree. */
 
-import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { resolve } from "node:path";
 
@@ -12,12 +11,10 @@ import {
   renderPersonaV3SoloTestPackReport,
   writePersonaV3SoloTestPacks,
 } from "./lib/persona-v3-solo-test-packs.mjs";
+import { resolvePersonaPackVersion } from "./lib/build-profile.mjs";
 
 const REPO_ROOT = fileURLToPath(new URL("..", import.meta.url));
 
-function packageVersion() {
-  return JSON.parse(readFileSync(resolve(REPO_ROOT, "package.json"), "utf8")).version;
-}
 export function parseArgs(argv) {
   const args = {
     write: false,
@@ -26,7 +23,7 @@ export function parseArgs(argv) {
     root: DEFAULT_SOLO_TEST_PACK_ROOT,
     formulaRoot: DEFAULT_SOLO_TEST_FORMULA_ROOT,
     personaDir: undefined,
-    packVersion: packageVersion(),
+    packVersion: resolvePersonaPackVersion(REPO_ROOT),
   };
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
@@ -62,10 +59,10 @@ export function main(argv = process.argv.slice(2)) {
     process.stdout.write([
       "Usage: node scripts/build-persona-v3-solo-test-packs.mjs [--check|--write] [--json]",
       "",
-      "  --write              materialize all 26 packaged provisional packs, then verify",
+      "  --write              materialize every packaged provisional pack, then verify",
       "  --check              read-only verification (default)",
       "  --root PATH          override the isolated solo-test/masters output root",
-      "  --formula-root PATH  override the 52-tool provisional formula staging tree",
+      "  --formula-root PATH  override the provisional formula staging tree",
       "  --persona-dir PATH   override the canonical persona registry",
       "  --pack-version X.Y.Z[-PRERELEASE] override package-derived pack version",
       "  --json               emit a machine-readable report",
@@ -88,6 +85,7 @@ const invoked = process.argv[1] && resolve(process.argv[1]) === fileURLToPath(im
 if (invoked) {
   try { process.exitCode = main(); } catch (error) {
     process.stderr.write(`persona-v3 solo-test pack build failed: ${error.message}\n`);
+    if (error.details) process.stderr.write(`${JSON.stringify(error.details, null, 2).slice(0, 2000)}\n`);
     process.exitCode = 1;
   }
 }

package/scripts/check-persona-v3-ga.mjs

@@ -125,7 +125,7 @@ export function usage() {
   return [
     "Usage: node scripts/check-persona-v3-ga.mjs [options]",
     "",
-    "Read-only PersonaPack v3 GA gate. Defaults to 26 seats at operational or higher.",
+    "Read-only PersonaPack v3 GA gate. Defaults to the full canonical roster at operational or higher.",
     "",
     "Options:",
     "  --json                         Emit the stable JSON report",

package/scripts/check-persona-v3-production-candidates.mjs

@@ -64,7 +64,7 @@ export function main(argv = process.argv.slice(2)) {
       "Usage: node scripts/check-persona-v3-production-candidates.mjs [options]",
       "",
       "  --check                    inspect honestly without requiring readiness (default)",
-      "  --gate                     exit non-zero unless all 26 clear the requested admission",
+      "  --gate                     exit non-zero unless every canonical seat clears the requested admission",
       "  --require-admission LEVEL  operational | candidate | method_model",
       "  --root PATH                override isolated staging candidate root",
       "  --persona-dir PATH         override canonical persona registry",

package/scripts/compile-persona-v3-formulas.mjs

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
-/** Plan/write the 52-entry formula queue, or compile reviewed specs to DSL 1.1 JSON. */
+/** Plan/write the planned formula queue, or compile reviewed specs to DSL 1.1 JSON. */
 
 import { lstatSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
-import { defaultStagingRoot } from "../mcp/lib/personas-v3/staging.mjs";
+import { CANONICAL_MASTER_COUNT, defaultStagingRoot } from "../mcp/lib/personas-v3/staging.mjs";
+import { PLANNED_TOOL_COUNT } from "../data/persona-v3-build-specs.v1.mjs";
 import {
   DEFAULT_FORMULA_CANDIDATE_ROOT,
   DEFAULT_COMPILED_FORMULA_ROOT,
@@ -86,20 +87,20 @@ export function main(argv = process.argv.slice(2)) {
       "       node scripts/compile-persona-v3-formulas.mjs --compile-approved --candidate-root PATH --trusted-formula-reviewer-keys FILE [--write]",
       "       node scripts/compile-persona-v3-formulas.mjs --compile-solo-test --candidate-root PATH [--write]",
       "",
-      "  --check, --plan     inspect and validate the 52-entry authoring queue (default; no writes)",
+      "  --check, --plan     inspect and validate the planned authoring queue (default; no writes)",
       "  --write             write only isolated non-production staging candidate artifacts",
-      "  --compile-approved  require and compile exactly 52 human-edited specs plus dual-signed bundles",
+      "  --compile-approved  require and compile exactly one human-edited spec per planned tool plus dual-signed bundles",
       "  --check-candidates   alias for --compile-approved without writes",
-      "  --compile-solo-test derive 52 executable identity proxies from the exact pending queue; never production eligible",
+      "  --compile-solo-test derive executable identity proxies from the exact pending queue; never production eligible",
       "  --solo-test          alias for --compile-solo-test",
-      "  --candidate-root     root containing specs/ and approvals/ for all 52 planned tools",
+      "  --candidate-root     root containing specs/ and approvals/ for every planned tool",
       "  --trusted-formula-reviewer-keys  Ed25519 public-key registry authorized for formula_review",
       "  --compiled-output-root  isolated staging output for per-persona tools/evidence",
       "  --solo-output-root   isolated staging output for provisional derived-proxy tools/evidence",
-      "  --root PATH         override the 26-seat prototype staging root",
+      "  --root PATH         override the prototype staging root",
       "  --output-root PATH  override write root; basename must be persona-v3-formula-candidates below staging",
       "  --json              emit the machine-readable plan",
-      "  --markdown          emit the complete 52-entry authoring queue",
+      "  --markdown          emit the complete planned authoring queue",
       "",
       "No mode writes knowledge/masters, production manifests, release evidence, registry data, or version metadata.",
       "",
@@ -120,12 +121,12 @@ export function main(argv = process.argv.slice(2)) {
     else process.stdout.write([
       "persona-v3-formulas:",
       `mode=${args.write ? "write_isolated_staging_compilation" : "check_approved_candidates"}`,
-      `tools=${result.compiled_tool_count}/52`,
-      `formula_approvals=${result.formula_approval_binding_count}/52`,
+      `tools=${result.compiled_tool_count}/${PLANNED_TOOL_COUNT}`,
+      `formula_approvals=${result.formula_approval_binding_count}/${PLANNED_TOOL_COUNT}`,
       `hash=${result.compilation_hash}`,
       "",
     ].join(" "));
-    return result.compiled_tool_count === 52 && result.formula_approval_binding_count === 52 ? 0 : 1;
+    return result.compiled_tool_count === PLANNED_TOOL_COUNT && result.formula_approval_binding_count === PLANNED_TOOL_COUNT ? 0 : 1;
   }
 
   if (args.compileSoloTest) {
@@ -140,16 +141,16 @@ export function main(argv = process.argv.slice(2)) {
     else process.stdout.write([
       "persona-v3-formulas:",
       `mode=${args.write ? "write_isolated_solo_test_compilation" : "check_solo_test_compilation"}`,
-      `tools=${result.compiled_tool_count}/52`,
-      `provisional_derivations=${result.provisional_derivation_count}/52`,
-      `formula_approvals=${result.formula_approval_binding_count}/52`,
+      `tools=${result.compiled_tool_count}/${PLANNED_TOOL_COUNT}`,
+      `provisional_derivations=${result.provisional_derivation_count}/${PLANNED_TOOL_COUNT}`,
+      `formula_approvals=${result.formula_approval_binding_count}/${PLANNED_TOOL_COUNT}`,
       `assurance=${result.assurance_class}`,
       `production_eligible=${result.production_eligible}`,
       `hash=${result.compilation_hash}`,
       "",
     ].join(" "));
-    return result.compiled_tool_count === 52
-      && result.provisional_derivation_count === 52
+    return result.compiled_tool_count === PLANNED_TOOL_COUNT
+      && result.provisional_derivation_count === PLANNED_TOOL_COUNT
       && result.formula_approval_binding_count === 0
       && result.production_eligible === false ? 0 : 1;
   }
@@ -163,8 +164,8 @@ export function main(argv = process.argv.slice(2)) {
   else process.stdout.write([
     "persona-v3-formulas:",
     `mode=${args.write ? "write_staging_candidates_then_check" : "check_plan"}`,
-    `seats=${plan.inventory.canonical_seat_count}/26`,
-    `prototypes=${plan.inventory.prototype_count}/52`,
+    `seats=${plan.inventory.canonical_seat_count}/${CANONICAL_MASTER_COUNT}`,
+    `prototypes=${plan.inventory.prototype_count}/${PLANNED_TOOL_COUNT}`,
     `needs_authorship=${plan.inventory.needs_formula_authorship_count}`,
     `executable_candidates=${plan.inventory.executable_candidate_count}`,
     `dedicated_tools=${plan.inventory.dedicated_tool_count}`,

package/scripts/doctor.mjs

@@ -18,6 +18,8 @@ import {
 } from "../mcp/lib/personas-v3/registry.mjs";
 import { scanPersonaCorpusGaps } from "./report-persona-corpus-gaps.mjs";
 import { auditHostAdapterFreshness, validateHostCapabilities } from "./lib/host-capabilities.mjs";
+import { CANONICAL_MASTER_COUNT } from "../mcp/lib/personas-v3/staging.mjs";
+import { PLANNED_TOOL_COUNT } from "../data/persona-v3-build-specs.v1.mjs";
 
 const ROOT = fileURLToPath(new URL("..", import.meta.url));
 const problems = [];
@@ -95,20 +97,20 @@ try {
     const registry = loadCompiledPersonaPacks({ buildProfile });
     const operatorCount = registry.packs.filter((pack) => pack.admission.level === "operator_lens").length;
     const toolCount = registry.packs.reduce((sum, pack) => sum + pack.components.tools.length, 0);
-    const validSoloCut = registry.packs.length === 26
-      && operatorCount === 26
-      && toolCount === 52
+    const validSoloCut = registry.packs.length === CANONICAL_MASTER_COUNT
+      && operatorCount === CANONICAL_MASTER_COUNT
+      && toolCount === PLANNED_TOOL_COUNT
       && registry.packs.every((pack) => pack.build_profile === "solo_test");
     if (validSoloCut) {
-      ok("solo-test runtime", "26 physical provisional operator_lens; 52 derived-proxy tools; 0 method_model");
+      ok("solo-test runtime", `${CANONICAL_MASTER_COUNT} physical provisional operator_lens; ${PLANNED_TOOL_COUNT} derived-proxy tools; 0 method_model`);
       notes.push("Formal PersonaPack v3 production GA is not passed; human source/formula review, signed experiments, and live four-host E2E remain absent");
     } else {
-      warn("solo-test runtime incomplete", `${registry.packs.length}/26 packs, ${operatorCount}/26 operator_lens, ${toolCount}/52 tools`);
+      warn("solo-test runtime incomplete", `${registry.packs.length}/${CANONICAL_MASTER_COUNT} packs, ${operatorCount}/${CANONICAL_MASTER_COUNT} operator_lens, ${toolCount}/${PLANNED_TOOL_COUNT} tools`);
     }
-  } else if (/^0\.9\./.test(VERSION) && report.summary.operational_or_higher !== 26) {
-    warn("0.9 v3 cutover incomplete", `${report.summary.operational_or_higher}/26 seats operational or higher`);
-  } else if (report.summary.operational_or_higher !== 26) {
-    notes.push(`PersonaPack v3 migration remains in development: ${report.summary.operational_or_higher}/26 operational or higher`);
+  } else if (/^0\.9\./.test(VERSION) && report.summary.operational_or_higher !== CANONICAL_MASTER_COUNT) {
+    warn("0.9 v3 cutover incomplete", `${report.summary.operational_or_higher}/${CANONICAL_MASTER_COUNT} seats operational or higher`);
+  } else if (report.summary.operational_or_higher !== CANONICAL_MASTER_COUNT) {
+    notes.push(`PersonaPack v3 migration remains in development: ${report.summary.operational_or_higher}/${CANONICAL_MASTER_COUNT} operational or higher`);
   }
 } catch (error) {
   warn("PersonaPack v3 corpus inventory failed", error.message.split("\n")[0]);

package/scripts/export-persona-source-review-batch.mjs

@@ -82,7 +82,7 @@ function helpText() {
     "  node scripts/export-persona-source-review-batch.mjs --output FILE --write [--trusted-reviewer-keys FILE] [--json]",
     "",
     "Default/check mode is read-only. --write creates one new audit batch and never overwrites it.",
-    "The batch includes all 26 seats, raw acquisition bindings, human-only proposal templates, hashes, locator gaps, and strict trusted-principal quorum progress.",
+    "The batch includes every canonical seat, raw acquisition bindings, human-only proposal templates, hashes, locator gaps, and strict trusted-principal quorum progress.",
     "It never prepares, reviews, approves, promotes, or writes production knowledge.",
     "",
   ].join("\n");