alphacouncil-agent 0.9.2 → 1.0.0

package/scripts/review-persona-v3-solo-formulas.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/** Build or verify the isolated 52-tool AI-assisted formula cross-review tree. */
+/** Build or verify the isolated AI-assisted formula cross-review tree. */
 
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -11,6 +11,10 @@ import {
   writeAIFormulaCrossReviews,
 } from "./lib/persona-v3-ai-formula-review.mjs";
 import { DEFAULT_SOLO_TEST_FORMULA_ROOT } from "./lib/persona-v3-solo-formula-pipeline.mjs";
+import { PLANNED_TOOL_COUNT } from "../data/persona-v3-build-specs.v1.mjs";
+
+/** The review profile gives every tool three independent machine roles. */
+const INDEPENDENT_ROLES_PER_REVIEW = 3;
 
 export function parseArgs(argv) {
   const args = {
@@ -57,13 +61,13 @@ function compact(result) {
   return [
     "persona-v3-ai-formula-review:",
     `mode=${result.mode || "plan_ai_formula_cross_reviews"}`,
-    `reviews=${result.review_count}/52`,
-    `roles=${result.role_count}/156`,
+    `reviews=${result.review_count}/${PLANNED_TOOL_COUNT}`,
+    `roles=${result.role_count}/${PLANNED_TOOL_COUNT * INDEPENDENT_ROLES_PER_REVIEW}`,
     `vectors=${result.test_vector_count}`,
     `invariants=${result.invariant_count}`,
-    `mechanical_pass=${result.mechanical_pass_count}/52`,
+    `mechanical_pass=${result.mechanical_pass_count}/${PLANNED_TOOL_COUNT}`,
     `disagreements=${result.disagreement_count}`,
-    `semantic_unknown=${result.semantic_unknown_count}/52`,
+    `semantic_unknown=${result.semantic_unknown_count}/${PLANNED_TOOL_COUNT}`,
     `human_reviewers=${result.human_reviewer_count}`,
     `approvals=${result.approval_count}`,
     `production_eligible=${result.production_eligible}`,
@@ -88,11 +92,11 @@ export function main(argv = process.argv.slice(2)) {
   }
   if (args.json) process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
   else process.stdout.write(compact(result));
-  const okay = result.review_count === 52
+  const okay = result.review_count === PLANNED_TOOL_COUNT
     && result.role_count === 156
-    && result.mechanical_pass_count === 52
+    && result.mechanical_pass_count === PLANNED_TOOL_COUNT
     && result.disagreement_count === 0
-    && result.semantic_unknown_count === 52
+    && result.semantic_unknown_count === PLANNED_TOOL_COUNT
     && result.human_reviewer_count === 0
     && result.approval_count === 0
     && result.production_eligible === false;

package/scripts/run-tests.mjs

@@ -32,6 +32,23 @@ export const SOURCE_PORTABLE_EXCLUDED_TESTS = Object.freeze([
 ]);
 
 export const SOURCE_PORTABLE_EXCLUDED_TEST_COUNT = 14;
+// The suite contains several package-install and hash-audit files that each spawn
+// their own child processes. Node's CPU-count default can oversubscribe large CI
+// hosts and turn deterministic sub-second fixtures into platform-specific timeouts.
+export const SOURCE_TEST_CONCURRENCY = 4;
+
+export function sourceTestConcurrencyArg(concurrency = SOURCE_TEST_CONCURRENCY, nodeVersion = process.versions.node) {
+  const [major = 0, minor = 0] = String(nodeVersion).split(".").map(Number);
+  const supported = (major === 18 && minor >= 19)
+    || (major === 20 && minor >= 10)
+    || major >= 21;
+  return supported ? `--test-concurrency=${concurrency}` : null;
+}
+
+function sourceTestArgs(files = []) {
+  const concurrencyArg = sourceTestConcurrencyArg();
+  return Object.freeze(["--test", ...(concurrencyArg ? [concurrencyArg] : []), ...files]);
+}
 
 function listMjsFiles(root, directory = join(root, "test")) {
   if (!existsSync(directory)) return [];
@@ -81,7 +98,11 @@ export function buildTestPlan(root = repoRoot) {
     return Object.freeze({ mode: "installed_package", excluded: Object.freeze([]), args: Object.freeze(["scripts/package-smoke.mjs"]) });
   }
   if (staging === "present") {
-    return Object.freeze({ mode: "source_with_staging", excluded: Object.freeze([]), args: Object.freeze(["--test"]) });
+    return Object.freeze({
+      mode: "source_with_staging",
+      excluded: Object.freeze([]),
+      args: sourceTestArgs(),
+    });
   }
 
   const excluded = new Set(SOURCE_PORTABLE_EXCLUDED_TESTS);
@@ -91,7 +112,7 @@ export function buildTestPlan(root = repoRoot) {
   return Object.freeze({
     mode: "source_portable",
     excluded: SOURCE_PORTABLE_EXCLUDED_TESTS,
-    args: Object.freeze(["--test", ...selected]),
+    args: sourceTestArgs(selected),
   });
 }
 

package/scripts/scaffold-persona-v3-staging.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/** Create only missing PersonaPack v3 staging artifacts, then validate the full 26-seat tree. */
+/** Create only missing PersonaPack v3 staging artifacts, then validate the full staging tree. */
 
 import { fileURLToPath } from "node:url";
 import { resolve } from "node:path";

package/skills/agent-skills-governance/SKILL.md

@@ -37,7 +37,9 @@ Before giving a final investment answer, all gates below must be satisfied:
    when at least two completed and every failed role has a recorded diagnostic/data gap.
 5. Source gate: every material claim maps to scoped source IDs like `<task>:S1`; never cite bare `S1`.
 6. Master gate: every master named in the confirmed receipt has either reported or produced
-   a deterministic `out_of_scope` result. An unexecuted selected seat keeps the run incomplete.
+   a deterministic `out_of_scope` result, every result has a readable final statement, and
+   every stable ID appears in the published Master Bench. An unexecuted or hidden selected
+   seat keeps the run incomplete or `needs_revision`.
 7. Debate gate: full requires all three bull/bear rounds, exact round-3 Q&A and PM. Quick
    requires one parallel statement round and PM; one degraded side is allowed only if the
    other side and PM completed, while two degraded sides or PM failure is incomplete.
@@ -53,7 +55,9 @@ Before giving a final investment answer, all gates below must be satisfied:
     winner, confidence, valuation/position, material gaps and saved file locations. Full
     also carries forward setup and invalidations. Quick names all four analyst statuses,
     selected method IDs/stances, dated recent company/industry news, every degraded item,
-    and that it is not equivalent to full council.
+    and that it is not equivalent to full council. Full handoff ends with the exact selected
+    seat count and every per-seat method statement; use returned `user_response_markdown`
+    rather than an ACK-only recap.
 12. Deadline gate: plugin-managed quick uses headless `analyze_symbol`; `plan_visible_run`
     quick is rejected. Never extend its end-to-end deadline above 600000 ms or silently
     omit work to appear complete.
@@ -73,6 +77,8 @@ Before giving a final investment answer, all gates below must be satisfied:
 | "Quick report quality passed, so full passed." | Keep `full_council_equivalent=false`; only `quick_v1` passed. |
 | "The ten-minute clock expired, so skip a seat quietly." | Return the exact degraded/incomplete ledger; never extend the ceiling or invent evidence. |
 | "The master said this." | Call it a recorded method-seat result, never a quote from the named person. |
+| "The PM ACK says complete, so I can summarize it." | Deliver the returned `user_response_markdown`; the final per-seat section is part of the contract. |
+| "QQQ has an SEC CIK, so the company screen applies." | Classify first. ETF/fund/index company financial routes are not applicable; require look-through or aggregate evidence. |
 
 ## Exit Criteria
 

package/skills/alphacouncil-agent/SKILL.md

@@ -20,10 +20,15 @@ after Stage 0.
 - **Full council (`full_v2`)**: run all 8 planned evidence roles (`market_data`,
   `earnings_deep_dive`, `forward_expectations`, `quant_factor`, `valuation_long_short`,
   `news_industry_management`, `insider_sec`, `ib_event_analysis`), then every selected
-  master, then the three-round bull/bear cross-exam, then `portfolio_manager`. When a plan
+  master, then the three-round bull/bear cross-exam, then `portfolio_manager`. In the
+  plugin-managed headless path the eight roles start in one parallel wave; each selected v3
+  method freezes its deterministic stance before one isolated voice worker explains it; and
+  Bull/Bear run in parallel within each round with a barrier between rounds. When a plan
   explicitly adds optional analyst seats, every added seat is equally mandatory. A mandatory
   evidence failure is a fail-fast barrier: persist the failure and final diagnostic artifacts,
   skip masters/debate/PM model calls, and terminate `incomplete`; do not synthesize around it.
+  Headless full has a hard 1800000 ms queue-to-terminal-persistence ceiling. It fails closed
+  at expiry and does not promise all-seat success when external services deteriorate.
 - **Quick council (`quick_v1`)**: only the plugin-managed headless `analyze_symbol` path may
   execute it. It runs the four fixed evidence roles in parallel, 1-4 selected methods in
   parallel, one parallel bull/bear statement, and one short PM inside the hard 600000 ms
@@ -53,7 +58,8 @@ council and skip Stage 0.
 Use the inferred language for the Stage 0 catalog, visible progress, agent prompts, evidence
 packets, debate packets and final synthesis unless the user explicitly requests another
 language. Always pass the original user request in `prompt` and the inferred language in
-`language`.
+`language`. System-owned catalog/report/handoff labels and failure text are localized for
+`zh-CN`, `en`, `ja` and `ko`; stable IDs and JSON field names remain English.
 
 ## Stage 0 — Display, confirm and receipt-gate the master selection
 
@@ -101,6 +107,36 @@ time is a question with an obvious answer. Master selection is the one configura
 Do not ask about analysts: they default to the eight-seat fan-out. Use all eleven only if
 the user asked for breadth, and say so in the report rather than asking first.
 
+### Full v2 plugin-managed contract
+
+Use this contract when full runs through headless `analyze_symbol`:
+
+- Call `analyze_symbol` once with the full-mode receipt, `council_mode: "full"`,
+  `wait_for_completion: false`, and no task override unless the user explicitly requested
+  optional breadth. Poll the one durable `run_id`; never create a replacement.
+- The eight mandatory evidence roles start together. Each has one bounded parse-only repair;
+  repair converts malformed output and does not repeat web research.
+- After the evidence barrier, every selected physical v3 method executes its deterministic
+  policy and freezes its stance. Exactly one isolated voice worker is then launched for that
+  stable ID. It may explain the recorded policy result in the user's language, but cannot
+  change the stance, invent a typed fact or speak as the real named person. A missing voice
+  result remains visible and prevents a false complete bench.
+- Round 1 Bull/Bear run together; after both pass, Round 2 runs together; after both pass,
+  Round 3 runs together with exact saved-question bindings. The PM starts after both Round-3
+  sides pass.
+- The hard ceiling is 1800000 ms from durable queueing through terminal artifact persistence,
+  including queueing, retries, all workers and deterministic finalization. A caller or
+  environment may lower it, never raise it. At expiry persist `incomplete` and name every
+  timed-out/failed/skipped role. The deadline guarantees a terminal saved run, not successful
+  completion under provider/search/data degradation.
+- The concise handoff lists every selected stable master ID, frozen stance and voice-worker
+  explanation/status; all eight analyst task IDs, statuses and summaries; and a system-owned
+  price snapshot with currency/time/source or an explicit unavailable-data gap.
+
+`plan_visible_run` is not governed by this clock: the external host schedules and owns those
+subagents, so the plugin cannot force-stop them. Do not promise the 30-minute headless bound
+for visible-host execution.
+
 ### Quick v1 fixed contract
 
 Quick remains a council judgment and passes the same display/confirmation gate, but its
@@ -136,7 +172,7 @@ execution graph is deliberately smaller and immutable:
 This section applies to full council only. If the user explicitly chooses quick, use the
 plugin-managed Headless MCP path; never emulate quick with visible subagents.
 
-Use visible Codex subagents whenever the user asks to see subagents, asks for a chat-style analyst team, says child agents must be visible, or invokes `@alphacouncil-agent` for an investment decision without explicitly requesting headless/background mode.
+Use visible Codex subagents whenever the user asks to see subagents, asks for a chat-style analyst team, says child agents must be visible, or invokes `@alphacouncil-agent` for an investment decision without explicitly requesting headless/background mode. If the user requires a hard 30-minute terminal bound, explain that visible host tasks cannot be force-stopped by the plugin and use plugin-managed headless full after Stage 0.
 
 Default to the full workflow. Do not downgrade to a lite/smoke/visible-only summary unless the user explicitly asks for lite, smoke test, or debug output. Do not describe the final user-facing report as "visible version", "lite", "smoke", or "debug"; those are execution details, not investment-report content.
 
@@ -172,14 +208,14 @@ Default to the full workflow. Do not downgrade to a lite/smoke/visible-only summ
    - Failed verification **down-weights the seat that made the claim** in the PM synthesis; a seat is never silently erased.
    - `cannot_confirm` and `stands` are real results. Manufacturing a `weakened` verdict to look diligent lowers a seat's weight for no reason, and weight moves the final rating.
 6. Wait for the evidence agents, merge their outputs into a shared evidence set in the main thread, then run bull, bear, and portfolio-manager agents.
-   - Round 1: bull writes the long case; bear writes the short case.
+   - Round 1: bull writes the long case; bear writes the short case; launch both in parallel and wait for both.
    - Round 2: pass bull's packet to bear and bear's packet to bull for rebuttal; each side
      ends with exactly three questions for the opponent.
    - Round 3: cross-feed those six saved questions; each side preserves its own three in
      `questions` and answers the opponent's three as exact `{question, answer}` bindings in
      `questions_answered`.
    - Final: portfolio_manager reads evidence plus all debate rounds and decides whether bull, bear, or balanced won.
-7. Return a concise but evidence-rich user handoff in the selected or inferred language: rating, debate winner, key earnings/financial results, forward expectations or event thresholds, important news/industry signals, valuation range, position guidance, top invalidation conditions, and saved file locations. Do not paste an overlong report into chat unless the user asks for the full body inline. The saved `final_report.md` must still be complete enough to read without opening artifacts: include each evidence analyst's summary, key data/news/filing/quant findings, the bull case, bear case, rebuttals/questions where available, portfolio-manager verdict, data gaps, and source table. Include links/paths to saved artifacts in the handoff.
+7. Return a concise but evidence-rich user handoff in the selected or inferred language: rating, debate winner, key earnings/financial results, forward expectations or event thresholds, important news/industry signals, valuation range, position guidance, top invalidation conditions, and saved file locations. It must name every selected master and every mandatory evidence analyst, with each status/summary, plus the system price snapshot or an explicit quote-data gap. Do not paste an overlong report into chat unless the user asks for the full body inline. The saved `final_report.md` must still be complete enough to read without opening artifacts: include each evidence analyst's summary, key data/news/filing/quant findings, the bull case, bear case, rebuttals/questions where available, portfolio-manager verdict, data gaps, and source table. Include links/paths to saved artifacts in the handoff.
    - If the Data Analytics `datascienceWidgets` tools are available, also create a real dashboard/report artifact from the completed evidence and decision: call `validate_artifact` first, then `render_artifact`. Do not treat `output_mode=data_analytics` as only a prose style.
    - If Documents, PDF, Spreadsheets, or Presentations are requested as output formats, use their plugin/skill workflow as a delivery layer after the investment decision is complete; do not move investment judgment into those format plugins.
 8. If the user specifically wants left-sidebar Codex chat threads, use `codex_app.list_projects` and `codex_app.create_thread` instead of MCP headless execution. Create one thread per major role and report the created thread IDs.
@@ -229,7 +265,8 @@ Use MCP only when the user explicitly accepts background/headless execution, wan
    `wait_for_completion=false` when the user wants a long/short or portfolio decision saved
    under `~/.alphacouncil-agent/runs/`. This returns a small durable accepted response with
    `run_id`, `status_json`, and `events_jsonl`; acceptance does not mean the report is done.
-   For quick, do not pass task overrides and do not request `synthesis=false`.
+   For quick, do not pass task overrides and do not request `synthesis=false`. For full, the
+   1800000 ms global maximum and parallel/barrier topology in the full contract above apply.
 3. Poll `read_run(run_id)` at a bounded interval until `status.status` is terminal:
    `complete`, `degraded`, `incomplete`, `needs_verification`, `needs_revision`, or `failed`.
    Surface meaningful phase changes, not every unchanged poll. Poll the same `run_id`; never
@@ -248,7 +285,10 @@ Use MCP only when the user explicitly accepts background/headless execution, wan
    its seat count or agreement into `N_eff`; that remains `null` without the separately
    preregistered, signed, resolved-outcome ledger.
 6. Headless MCP defaults to real `codex exec` workers. Pass `dry_run=true` only for explicit planning/self-test requests, not for a user-requested stock analysis.
-7. Do not describe MCP `codex exec` workers as visible chat subagents. They are background workers with `status.json`, `events.jsonl`, and `all_agents.md`.
+7. Do not describe MCP `codex exec` workers as visible chat subagents. They are isolated
+   background processes with `status.json`, `events.jsonl`, and `all_agents.md`. Each selected
+   physical v3 method gets its own isolated voice worker after the deterministic stance is
+   frozen, but that worker is not a persistent sidebar agent and is not the named person.
 8. For full mode, any mandatory evidence failure closes the evidence barrier and terminates
    before masters, debate, and PM model calls. For quick, inspect the degraded ledger and the
    independent execution-status, evidence-coverage, and report-quality fields before handing
@@ -299,7 +339,7 @@ Compute per-claim survived-confidence: keep `high` only if source_fidelity != co
 
 ### Stage 2c - Selected master methods
 
-Run every `master_agent` returned by `plan_visible_run` after the evidence and verification barrier, and before the bull/bear debate. Record each result with `record_master_opinion`. A deterministic `masters_declined` entry is already recorded as `out_of_scope` and must not be spawned again. HARD GATE: `status.json.pending_masters` must be empty before Stage 3.
+Run every `master_agent` returned by `plan_visible_run` after the evidence and verification barrier, and before the bull/bear debate. Physical v3 agents are explanation workers over an already frozen stance, including `out_of_scope`; append the completed Evidence JSON, require `acknowledged_stance` to match `frozen_stance`, and record each result with `record_master_opinion`. `masters_declined` documents the deterministic result but does not waive a returned visible explanation worker. HARD GATE: `status.json.pending_masters` must be empty before Stage 3.
 
 ### Stage 3 — Debate pipeline (3 rounds, parallel per round)
 Run the documented rounds, each as a parallel fan-out of `bull_researcher` + `bear_researcher` fed the verified evidence:
@@ -313,7 +353,7 @@ Run the documented rounds, each as a parallel fan-out of `bull_researcher` + `be
 Persist each round via `record_visible_decision(run_id, role, packet)` so `all_agents.md` accumulates the full trace. DISPUTED/UNVERIFIABLE claims may appear in a thesis only with an explicit caveat.
 
 ### Stage 4 — Verdict + synthesize
-Run one `portfolio_manager` `Task` fed the verified evidence plus all three debate rounds. Record it via `record_visible_decision(run_id, 'portfolio_manager', packet)`, which writes `decision.json` + `final_report.md` and marks the run complete. Then return the complete report inline (SKILL step 5) in the user's language, including the Analyst Work Log, Bull/Bear Debate record, the verification ledger (per material claim: self-confidence, verifier tally, source-fidelity, survived-confidence), all mandated sections, data gaps, short/medium/long-term views, and the `<task>:<source_id>` source table. Link artifacts only in an appendix.
+Run one `portfolio_manager` `Task` fed the verified evidence plus all three debate rounds. Record it via `record_visible_decision(run_id, 'portfolio_manager', packet)`, which writes `decision.json` + `final_report.md` and marks the run complete. A successful PM response has `handoff_contract=inline_user_response_v1` and returns `user_response_markdown`; use that Markdown as the final user-facing response body instead of replacing it with a shorter recap. Its last section is the exact selected-seat count and one readable method statement per seat, including deterministic `out_of_scope` statements. Then link the complete report and audit artifacts in an appendix. The saved full report still contains the Analyst Work Log, Bull/Bear Debate record, verification ledger, all mandated sections, data gaps, horizons and `<task>:<source_id>` source table.
 
 Honest limits: Task fan-out is best-effort, not a guaranteed workflow engine; enforce the barrier by polling artifacts, not by assuming. WebSearch/WebFetch is the only evidence channel (no financial API), so some numeric claims stay "narratively corroborated, not vendor-verified". This is the same auditable contract as the other paths — a stronger runner, not a different audit story.
 
@@ -370,12 +410,23 @@ Debate agents return:
   playbooks run by subagents, not Python libraries.
 - Keep non-public information out of scope unless the user provides the document directly.
 - For exact index / index-futures (incl. night session) / FX / rates / vol / commodity / stock levels, call the **`get_quote`** MCP tool (keyless, ~15m delayed; accepts names like `KOSPI`/`纳指期货`/`VIX`/`美元指数` or raw tickers) and cite it. Web search is the interpretation layer and the fallback when `get_quote` errors — then record the gap in `open_questions`. `get_quote` is delayed market data, never a real-time feed.
+- Classify the instrument before choosing company-data routes. ETFs/funds use dated
+  holdings look-through; cash indices use aggregate-index methodology. Do not call or ask
+  for operating-company revenue, EPS, guidance, Form 4 or Company Facts as if they belonged
+  to a fund/index. Cover methodology, holdings/constituent date and weights, concentration,
+  fee or index rules, liquidity/tracking/flows, rebalances and same-date aggregate valuation
+  with disclosed coverage; every missing field is an explicit gap.
 - Every material claim should map back to an evidence packet with sources and confidence.
 - Evidence sources are globally scoped as `<task>:<local_source_id>` and mirrored in `source_manifest.json`; never cite bare `S1/S2` after packets are merged.
 - Full `full_v2` manager reports must include separate visible sections for market expectations / implied beat-miss thresholds, analyst rating or target-price revisions, earnings-call management signals, quant factor / technical risk view, news and management/industry voice signals, short interest / borrow / options where available, strategic transaction or banking-event terms where relevant, data gaps / unavailable data, and separate short-term 1-4 weeks / medium-term 3-6 months / long-term 12 months views. Do not hide these only in the source table. If a data source is unavailable, state that explicitly instead of omitting the section. If no key source is missing, include a data-gaps section saying no critical gaps were found.
 - Full `full_v2` reports must also include an "Analyst Work Log" / "分析师工作记录" section summarizing every evidence agent packet, plus a "Bull/Bear Debate" / "多空辩论记录" section summarizing the long case, short case, rebuttals, exact Round-3 Q&A, unanswered questions, and who won. Do not replace these with a one-paragraph execution summary.
 - Quick `quick_v1` reports use the fixed 13-section contract stated above. Do not fail a quick report merely because it lacks full-only quant, event-banking, three-horizon, three-round-Q&A, or adversarial-verifier sections; likewise, never present a passing quick report as full-equivalent.
 - Terminal runs must preserve the standard artifacts appropriate to the executed contract, including `final_report.md`, `user_response.md`, `artifact_index.md`, `report_quality.json`, evidence-role Markdown, selected-method output, and bull/bear/PM output or explicit failure records. If `report_quality.json` is not `passed`, report `needs_revision`, not complete. A passing report-quality gate checks structure only: it does not convert a quick `degraded` execution into `complete` or prove evidence coverage.
+- A full `user_response.md` lists all eight mandatory analyst statuses/summaries, every
+  selected stable master ID with frozen stance and readable explanation/status, and one
+  system-owned price snapshot with currency/time/source or an explicit unavailable gap. Its
+  final section contains the exact selected-seat count and one statement per selected ID.
+  Visible PM completion returns `user_response_markdown`; deliver it instead of an ACK recap.
 - The `management_industry_voices` agent only uses publicly verifiable commentary from executives, board members, official company channels, customers, suppliers, competitors, regulators, industry experts, and channel voices. It must separate direct quotes, paraphrases, and media interpretation, and must not imply non-public inside information.
 - Fail closed on visibility: if visible agent/thread tools are unavailable, say that visible subagents are unavailable in this runtime and use MCP only with that limitation stated.
 - Never let a subagent call `@alphacouncil-agent`, `collect_evidence`, `analyze_symbol`, or `read_run`; visible agents are leaf workers.

package/skills/public-equity-investing/SKILL.md

@@ -48,6 +48,23 @@ Contract). Keep JSON field names in English; write prose in the user's language.
   vs media interpretation; never imply non-public information.
 - `insider_sec` — Form 4 insider transactions, buybacks, dilution, debt, capital allocation.
 
+## ETF, fund and broad-index routing
+
+Classify the instrument before applying the company role list above.
+
+- **ETF/fund:** establish tracked index/methodology, dated holdings and weights, top-ten and
+  sector concentration, fee, AUM, liquidity/spread, premium-discount or tracking difference,
+  flows, lending/derivatives, rebalances and tax structure. Fundamentals are holdings-level
+  look-through with the covered weight stated.
+- **Cash index:** establish calculation methodology, dated constituents/weights, concentration,
+  sector/factor exposures, breadth, reconstitution/rebalances, aggregate earnings and
+  valuation methodology, macro sensitivity and any explicitly named derivative proxy.
+- **Aggregation discipline:** use one date and disclose the provider/method and coverage
+  weight. Never add a few constituents into ETF/index revenue, EPS, cash flow or guidance.
+- **Filings discipline:** a constituent Form 4 is issuer activity, not fund insider trading.
+  Operating-company Company Facts and issuer financial screens are `not_applicable` for the
+  fund/index itself, not failed evidence.
+
 ## Valuation frameworks (valuation_long_short)
 
 Use at least two, and state assumptions explicitly:

package/knowledge/solo-test/persona-v3-solo-test-formulas/master_ackman/provisional-derivations/change_value_bridge.derived-proxy-evidence.json

@@ -1,64 +0,0 @@
-{
-  "artifact_kind": "persona_v3_provisional_formula_derivation_evidence",
-  "assurance_class": "provisional_derived_proxy",
-  "derivation_spec": {
-    "artifact_kind": "persona_v3_provisional_formula_derivation_spec",
-    "assurance_class": "provisional_derived_proxy",
-    "authoring_candidate_hash": "sha256:1c2f2d860e3f6f05cfe6fc7e966142d3ac00ee0bdabc4a2b2e53a352fa80c4fb",
-    "derivation_policy": "first_declared_input_to_first_declared_output_identity_v1",
-    "derivation_spec_id": "master_ackman.change_value_bridge.prototype_v1.derived_proxy_v1",
-    "formula": {
-      "inputs": [
-        {
-          "on_missing": "fail",
-          "operand": {
-            "fact_id": "valuation.standalone_value"
-          },
-          "period": {
-            "alignment": "as_of",
-            "basis": "instant",
-            "window": null
-          },
-          "unit": "derived_proxy_scalar",
-          "value_kind": "scalar"
-        }
-      ],
-      "kind": "transform",
-      "on_missing": "fail",
-      "operation": "identity",
-      "output": {
-        "output_id": "valuation.standalone_value",
-        "period": {
-          "alignment": "as_of",
-          "basis": "instant",
-          "window": null
-        },
-        "unit": "derived_proxy_scalar",
-        "value_kind": "scalar"
-      },
-      "version": "0.1.0"
-    },
-    "input_contract_source": "unknown_fact_fail_closed_proxy_scalar_v1",
-    "persona_id": "master_ackman",
-    "prototype_content_hash": "sha256:df0cf21474731a972284625235ac06bc492dff331d82ca3fc504685dc3339d61",
-    "prototype_id": "master_ackman.change_value_bridge.prototype_v1",
-    "schema_version": 1,
-    "tool_id": "master_ackman.change_value_bridge"
-  },
-  "derivation_spec_hash": "sha256:5c14bdc63fe4980710f521bdcd091a3c9b40da37b67029fb191ed161480a0885",
-  "human_reviewer_ids": [],
-  "intended_use": "local_test_only",
-  "limitations": [
-    "mechanical_identity_proxy_not_the_named_investor_method",
-    "first_declared_input_and_output_are_test_contract_choices_not_human_adjudication",
-    "unknown_fact_proxy_scalar_unit_requires_a_local_test_adapter",
-    "no_human_formula_review_or_cryptographic_approval_exists",
-    "must_not_be_used_for_production_admission_release_or_method_model_claims"
-  ],
-  "method_model_eligible": false,
-  "production_effect": "none",
-  "production_eligible": false,
-  "review_status": "not_human_reviewed",
-  "schema_version": 1,
-  "signature_count": 0
-}

package/knowledge/solo-test/persona-v3-solo-test-formulas/master_ackman/provisional-derivations/power_map.derived-proxy-evidence.json

@@ -1,64 +0,0 @@
-{
-  "artifact_kind": "persona_v3_provisional_formula_derivation_evidence",
-  "assurance_class": "provisional_derived_proxy",
-  "derivation_spec": {
-    "artifact_kind": "persona_v3_provisional_formula_derivation_spec",
-    "assurance_class": "provisional_derived_proxy",
-    "authoring_candidate_hash": "sha256:48c3c6019cd80db56bed977e35cf8ee5627e219ddbad3d274e21eb8d0f996ec9",
-    "derivation_policy": "first_declared_input_to_first_declared_output_identity_v1",
-    "derivation_spec_id": "master_ackman.power_map.prototype_v1.derived_proxy_v1",
-    "formula": {
-      "inputs": [
-        {
-          "on_missing": "fail",
-          "operand": {
-            "fact_id": "governance.voting_control"
-          },
-          "period": {
-            "alignment": "as_of",
-            "basis": "instant",
-            "window": null
-          },
-          "unit": "derived_proxy_scalar",
-          "value_kind": "scalar"
-        }
-      ],
-      "kind": "transform",
-      "on_missing": "fail",
-      "operation": "identity",
-      "output": {
-        "output_id": "governance.voting_control",
-        "period": {
-          "alignment": "as_of",
-          "basis": "instant",
-          "window": null
-        },
-        "unit": "derived_proxy_scalar",
-        "value_kind": "scalar"
-      },
-      "version": "0.1.0"
-    },
-    "input_contract_source": "unknown_fact_fail_closed_proxy_scalar_v1",
-    "persona_id": "master_ackman",
-    "prototype_content_hash": "sha256:df0cf21474731a972284625235ac06bc492dff331d82ca3fc504685dc3339d61",
-    "prototype_id": "master_ackman.power_map.prototype_v1",
-    "schema_version": 1,
-    "tool_id": "master_ackman.power_map"
-  },
-  "derivation_spec_hash": "sha256:cbc66704abe50660a149b649d09b7897a5db8dac9b9c3d279be97908ae5e0620",
-  "human_reviewer_ids": [],
-  "intended_use": "local_test_only",
-  "limitations": [
-    "mechanical_identity_proxy_not_the_named_investor_method",
-    "first_declared_input_and_output_are_test_contract_choices_not_human_adjudication",
-    "unknown_fact_proxy_scalar_unit_requires_a_local_test_adapter",
-    "no_human_formula_review_or_cryptographic_approval_exists",
-    "must_not_be_used_for_production_admission_release_or_method_model_claims"
-  ],
-  "method_model_eligible": false,
-  "production_effect": "none",
-  "production_eligible": false,
-  "review_status": "not_human_reviewed",
-  "schema_version": 1,
-  "signature_count": 0
-}

package/knowledge/solo-test/persona-v3-solo-test-formulas/master_aschenbrenner/provisional-derivations/compute_power_bridge.derived-proxy-evidence.json

@@ -1,64 +0,0 @@
-{
-  "artifact_kind": "persona_v3_provisional_formula_derivation_evidence",
-  "assurance_class": "provisional_derived_proxy",
-  "derivation_spec": {
-    "artifact_kind": "persona_v3_provisional_formula_derivation_spec",
-    "assurance_class": "provisional_derived_proxy",
-    "authoring_candidate_hash": "sha256:b20b00db383ff9aeb0e480fcb537ea22cdf9298a1d4f0cc46eb139f3cc6bb178",
-    "derivation_policy": "first_declared_input_to_first_declared_output_identity_v1",
-    "derivation_spec_id": "master_aschenbrenner.compute_power_bridge.prototype_v1.derived_proxy_v1",
-    "formula": {
-      "inputs": [
-        {
-          "on_missing": "fail",
-          "operand": {
-            "fact_id": "ai.compute.installed_capacity"
-          },
-          "period": {
-            "alignment": "as_of",
-            "basis": "instant",
-            "window": null
-          },
-          "unit": "derived_proxy_scalar",
-          "value_kind": "scalar"
-        }
-      ],
-      "kind": "transform",
-      "on_missing": "fail",
-      "operation": "identity",
-      "output": {
-        "output_id": "ai.power.required_mw",
-        "period": {
-          "alignment": "as_of",
-          "basis": "instant",
-          "window": null
-        },
-        "unit": "derived_proxy_scalar",
-        "value_kind": "scalar"
-      },
-      "version": "0.1.0"
-    },
-    "input_contract_source": "unknown_fact_fail_closed_proxy_scalar_v1",
-    "persona_id": "master_aschenbrenner",
-    "prototype_content_hash": "sha256:a2c6ddf866e1bf6c25a75903178929a0c276fb427b114a84e99d1f9306efeec7",
-    "prototype_id": "master_aschenbrenner.compute_power_bridge.prototype_v1",
-    "schema_version": 1,
-    "tool_id": "master_aschenbrenner.compute_power_bridge"
-  },
-  "derivation_spec_hash": "sha256:e037f2b6a618de250e7cdd947f5fb2e54de76605fdfafc89edb9624040033fbe",
-  "human_reviewer_ids": [],
-  "intended_use": "local_test_only",
-  "limitations": [
-    "mechanical_identity_proxy_not_the_named_investor_method",
-    "first_declared_input_and_output_are_test_contract_choices_not_human_adjudication",
-    "unknown_fact_proxy_scalar_unit_requires_a_local_test_adapter",
-    "no_human_formula_review_or_cryptographic_approval_exists",
-    "must_not_be_used_for_production_admission_release_or_method_model_claims"
-  ],
-  "method_model_eligible": false,
-  "production_effect": "none",
-  "production_eligible": false,
-  "review_status": "not_human_reviewed",
-  "schema_version": 1,
-  "signature_count": 0
-}

package/knowledge/solo-test/persona-v3-solo-test-formulas/master_aschenbrenner/provisional-derivations/timeline_reverse_valuation.derived-proxy-evidence.json

@@ -1,64 +0,0 @@
-{
-  "artifact_kind": "persona_v3_provisional_formula_derivation_evidence",
-  "assurance_class": "provisional_derived_proxy",
-  "derivation_spec": {
-    "artifact_kind": "persona_v3_provisional_formula_derivation_spec",
-    "assurance_class": "provisional_derived_proxy",
-    "authoring_candidate_hash": "sha256:38504f2484be53d328aa33be1d712e7547fcad5d7ca5b947ac25afd066f4a854",
-    "derivation_policy": "first_declared_input_to_first_declared_output_identity_v1",
-    "derivation_spec_id": "master_aschenbrenner.timeline_reverse_valuation.prototype_v1.derived_proxy_v1",
-    "formula": {
-      "inputs": [
-        {
-          "on_missing": "fail",
-          "operand": {
-            "fact_id": "ai.compute.installed_capacity"
-          },
-          "period": {
-            "alignment": "as_of",
-            "basis": "instant",
-            "window": null
-          },
-          "unit": "derived_proxy_scalar",
-          "value_kind": "scalar"
-        }
-      ],
-      "kind": "transform",
-      "on_missing": "fail",
-      "operation": "identity",
-      "output": {
-        "output_id": "valuation.implied_growth",
-        "period": {
-          "alignment": "as_of",
-          "basis": "instant",
-          "window": null
-        },
-        "unit": "derived_proxy_scalar",
-        "value_kind": "scalar"
-      },
-      "version": "0.1.0"
-    },
-    "input_contract_source": "unknown_fact_fail_closed_proxy_scalar_v1",
-    "persona_id": "master_aschenbrenner",
-    "prototype_content_hash": "sha256:a2c6ddf866e1bf6c25a75903178929a0c276fb427b114a84e99d1f9306efeec7",
-    "prototype_id": "master_aschenbrenner.timeline_reverse_valuation.prototype_v1",
-    "schema_version": 1,
-    "tool_id": "master_aschenbrenner.timeline_reverse_valuation"
-  },
-  "derivation_spec_hash": "sha256:9d12ff44cb0683d18b0960029e0a4e4cc0e85f5f5130d9d8d2f812dce48351f9",
-  "human_reviewer_ids": [],
-  "intended_use": "local_test_only",
-  "limitations": [
-    "mechanical_identity_proxy_not_the_named_investor_method",
-    "first_declared_input_and_output_are_test_contract_choices_not_human_adjudication",
-    "unknown_fact_proxy_scalar_unit_requires_a_local_test_adapter",
-    "no_human_formula_review_or_cryptographic_approval_exists",
-    "must_not_be_used_for_production_admission_release_or_method_model_claims"
-  ],
-  "method_model_eligible": false,
-  "production_effect": "none",
-  "production_eligible": false,
-  "review_status": "not_human_reviewed",
-  "schema_version": 1,
-  "signature_count": 0
-}