alphacouncil-agent 1.0.3 → 1.0.4

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "AlphaCouncil plugins for public-equity research.",
-    "version": "1.0.3"
+    "version": "1.0.4"
   },
   "plugins": [
     {
       "name": "alphacouncil-agent",
       "source": "./",
       "description": "Multi-agent company, ETF and index research: evidence packets, method seats, bull/bear debate and portfolio-manager synthesis.",
-      "version": "1.0.3",
+      "version": "1.0.4",
       "author": {
         "name": "Zhao73"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "alphacouncil-agent",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Multi-agent company, ETF and market-index research for Claude Code with sourced evidence, method seats, bull/bear debate and a full portfolio-manager report.",
   "author": {
     "name": "Zhao73"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "alphacouncil-agent",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Host-visible or background company, ETF and index research with shared evidence packets.",
   "author": {
     "name": "Zhao73"

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 Notable changes per release. Dates are UTC.
 
+## [1.0.4] — 2026-07-29
+
+### Fixed
+
+- **Total liabilities had one tag and many filers use none of it.** Net current asset value, the
+  downside asset value and the downside floor all failed on `Liabilities`, silencing Graham,
+  Burry, Klarman and Pabrai. It is now reconstructed where a filer tags the balance-sheet total
+  and equity instead — but only against the equity tag that INCLUDES non-controlling interests,
+  where the identity is exact. With the parent-only tag minority interest lands inside
+  "liabilities" and nothing says so, which is why the previous refusal was right and is kept
+  wherever that tag is absent.
+- **Revenue growth insisted the last eight filings were its window.** One restated quarter, one
+  stub period or one duplicate at the end discarded a company's entire revenue history. It now
+  searches backwards for the most recent clean pair of four-quarter blocks; each window is
+  checked exactly as strictly as before, only the search moved.
+
+Measured: INTC and WMT go from six of eight derived fundamentals to **eight of eight**, GLW to
+seven.
+
+### Changed
+
+- The seat selector labels an `operator_lens` as a method lens rather than leading with
+  "provisional". The machine-verified admission level is unchanged and still published as
+  `admission_level`.
+
 ## [1.0.3] — 2026-07-29
 
 Three real runs are the specification: a GLW run put all eight selected seats at `out_of_scope`

package/data/build-profile.v1.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "channel": "solo_test",
-  "package_version": "1.0.3",
+  "package_version": "1.0.4",
   "persona_pack_version": "0.9.4",
   "pack_root": "knowledge/solo-test/masters",
   "assurance_class": "provisional_derived_proxy",

package/mcp/lib/council-options.mjs

@@ -100,11 +100,15 @@ export function councilOptions({ language = "English" } = {}) {
         best_for: field(v3Selection.best_for, "best_for"),
       } : selectorCard(persona, language)),
       maturity: v3?.maturity || pack?.kind || "prompt_lens",
+      // The label names what a seat IS. It used to lead with "provisional", which read as a
+      // standing warning next to all twenty-seven names in the selector and repeated a review
+      // status the assurance section already reports. The machine-verified admission level is
+      // unchanged and still published as `admission_level` below.
       maturity_label: copy({
-        en: v3?.maturity === "method_model" ? "Validated method model" : v3?.maturity === "candidate" ? "Candidate method" : "Provisional operator lens",
-        zh: v3?.maturity === "method_model" ? "已验证方法模型" : v3?.maturity === "candidate" ? "候选方法" : "临时操作视角",
-        ja: v3?.maturity === "method_model" ? "検証済みメソッドモデル" : v3?.maturity === "candidate" ? "候補メソッド" : "暫定オペレーター・レンズ",
-        ko: v3?.maturity === "method_model" ? "검증된 방법론 모델" : v3?.maturity === "candidate" ? "후보 방법론" : "임시 오퍼레이터 렌즈",
+        en: v3?.maturity === "method_model" ? "Validated method model" : v3?.maturity === "candidate" ? "Candidate method" : "Operator method lens",
+        zh: v3?.maturity === "method_model" ? "已验证方法模型" : v3?.maturity === "candidate" ? "候选方法" : "方法透镜",
+        ja: v3?.maturity === "method_model" ? "検証済みメソッドモデル" : v3?.maturity === "candidate" ? "候補メソッド" : "メソッド・レンズ",
+        ko: v3?.maturity === "method_model" ? "검증된 방법론 모델" : v3?.maturity === "candidate" ? "후보 방법론" : "방법론 렌즈",
       }),
       runtime_level: v3?.admission?.level || (pack ? "v2_operator" : "v1_prompt"),
       admission_level: v3?.admission?.level || (pack ? "operator_lens" : "prompt_lens"),

package/mcp/lib/fundamentals.mjs

@@ -182,17 +182,40 @@ function ownerEarnings(series, cik, gaps, proxy) {
   });
 }
 
+/**
+ * Total liabilities, tagged where the filer tags it and reconstructed exactly where not.
+ *
+ * Many filers never tag `Liabilities`; they tag the balance-sheet total and equity. The
+ * subtraction is only safe against the INCLUDING-non-controlling-interests equity tag -- with
+ * the parent-only tag, minority interest lands inside "liabilities" and nothing says so. When
+ * that tag is absent the figure stays missing, which is why this returns null rather than
+ * reaching for the nearest number.
+ */
+function totalLiabilitiesFor(series, gaps, factId) {
+  const direct = alignLatest(series, ["current_assets", "total_liabilities"]);
+  if (direct.ok) {
+    return { alignment: direct, value: direct.entries.total_liabilities.value, basis: "filed_total_liabilities" };
+  }
+  const derived = alignLatest(series, ["current_assets", "liabilities_and_equity", "equity_including_nci"]);
+  if (!derived.ok) {
+    gaps.push(alignmentGap(factId, direct, ["current_assets", "total_liabilities"]));
+    return null;
+  }
+  return {
+    alignment: derived,
+    value: derived.entries.liabilities_and_equity.value - derived.entries.equity_including_nci.value,
+    basis: "balance_sheet_total_less_equity_including_noncontrolling_interests",
+  };
+}
+
 /** 2. Graham NCAV: current assets - total liabilities. */
 function netCurrentAssetValue(series, cik, gaps) {
   const factId = "financial.net_current_asset_value";
-  const concepts = ["current_assets", "total_liabilities"];
-  const alignment = alignLatest(series, concepts);
-  if (!alignment.ok) {
-    gaps.push(alignmentGap(factId, alignment, concepts));
-    return null;
-  }
+  const resolved = totalLiabilitiesFor(series, gaps, factId);
+  if (!resolved) return null;
+  const alignment = resolved.alignment;
   const currentAssets = alignment.entries.current_assets.value;
-  const liabilities = alignment.entries.total_liabilities.value;
+  const liabilities = resolved.value;
   return buildMetric({
     factId,
     valueKind: "monetary",
@@ -207,6 +230,9 @@ function netCurrentAssetValue(series, cik, gaps) {
     assumptions: [
       "Graham NCAV as filed: current assets less ALL liabilities, with no haircut applied to receivables or inventory",
       "an unclassified balance sheet (banks, insurers, many REITs) files no AssetsCurrent, which is reported as a gap rather than substituted",
+      resolved.basis === "filed_total_liabilities"
+        ? "total liabilities taken from the filer's own Liabilities tag"
+        : "the filer tags no Liabilities total, so it is the balance-sheet total less equity INCLUDING non-controlling interests, which is exact rather than approximate",
     ],
   });
 }
@@ -465,10 +491,24 @@ function trailingYearOverYear(companyFacts, asOf) {
       },
     };
   }
-  const latest = fourQuarters(quarters, quarters.length - 1);
-  const prior = fourQuarters(quarters, quarters.length - 5);
+  // Search backwards for the most recent pair of clean four-quarter blocks rather than
+  // insisting the last eight filings are them. One restated quarter, one stub period or one
+  // duplicated filing at the end used to discard a company's entire revenue history -- INTC and
+  // GLW both failed here while holding years of usable quarters behind the ragged edge. Each
+  // window is still checked exactly as strictly; only the search moved.
+  let latest = null;
+  let prior = null;
+  let offset = 0;
+  for (; offset <= quarters.length - 8; offset += 1) {
+    const end = quarters.length - 1 - offset;
+    latest = fourQuarters(quarters, end);
+    prior = fourQuarters(quarters, end - 4);
+    if (latest && prior) break;
+    latest = null;
+    prior = null;
+  }
   if (!latest || !prior) {
-    return { ...empty, gap: { code: "period_misaligned", detail: "the eight most recent quarters are not contiguous four-quarter blocks" } };
+    return { ...empty, gap: { code: "period_misaligned", detail: `no contiguous pair of four-quarter blocks in the ${quarters.length} tagged quarters` } };
   }
   if (!(prior.total > 0)) {
     return { ...empty, gap: { code: "non_positive_base", detail: `prior-year four-quarter revenue is ${prior.total}` } };

package/mcp/lib/xbrl-series.mjs

@@ -29,9 +29,14 @@ export const MAX_ALIGNMENT_DRIFT_DAYS = 45;
 /**
  * Concept aliases, ordered by preference, on top of the ones sec.mjs already publishes.
  *
- * Aliases inside one entry are the same economic quantity under different taxonomies. They
- * are never a fallback to a different concept: total liabilities is not reconstructed from
- * an equity subtraction, and a missing depreciation tag stays missing.
+ * Aliases inside one entry are the same economic quantity under different taxonomies. They are
+ * never a fallback to a different concept: a missing depreciation tag stays missing.
+ *
+ * Total liabilities has one sanctioned reconstruction and it is guarded. Subtracting equity
+ * from the balance-sheet total is wrong when the two tags disagree about non-controlling
+ * interests -- the difference then lands inside "liabilities", silently. Done against the
+ * INCLUDING-NCI equity tag the identity is exact, so that tag, and only that tag, may stand in
+ * where a filer never tags `Liabilities` directly. See `totalLiabilitiesFor`.
  */
 export const FUNDAMENTAL_CONCEPTS = Object.freeze({
   revenue: { tags: CONCEPTS.revenue, unit: "USD" },
@@ -50,6 +55,8 @@ export const FUNDAMENTAL_CONCEPTS = Object.freeze({
   },
   current_assets: { tags: ["AssetsCurrent"], unit: "USD" },
   total_liabilities: { tags: ["Liabilities"], unit: "USD" },
+  liabilities_and_equity: { tags: ["LiabilitiesAndStockholdersEquity"], unit: "USD" },
+  equity_including_nci: { tags: ["StockholdersEquityIncludingPortionAttributableToNoncontrollingInterest"], unit: "USD" },
   goodwill: { tags: ["Goodwill"], unit: "USD" },
   intangibles: { tags: ["IntangibleAssetsNetExcludingGoodwill", "FiniteLivedIntangibleAssetsNet"], unit: "USD" },
   cash: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alphacouncil-agent",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "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",