alphacouncil-agent 0.5.1 → 0.5.3

package/.claude/commands/alpha.md

@@ -0,0 +1,79 @@
+---
+description: Equity research council — full run, quick read, mechanical screen, or market narrative
+argument-hint: [ticker] [quick|screen|market|options|news] · or just a question
+---
+
+# /alpha
+
+Request: **$ARGUMENTS**
+
+## Route on the arguments — do not ask what they meant
+
+| `$ARGUMENTS` looks like | Do this |
+|---|---|
+| *(empty)* | Print the mode table below and stop. Do not start a run. |
+| a ticker alone, or a question | **Full council.** Go to "Full council" below. |
+| ticker + `quick` | The `quick` preset: 4 analysts and the debate. No bench, no verification. |
+| ticker + `screen` | `screen_ticker` only. No language-model judgment, no subagents. |
+| ticker + `options` | `get_options_chain` only. |
+| ticker + `news` | `get_news` on the symbol, and on its CIK when it is a US filer. |
+| `market` (with or without a theme) | `get_market_narrative`. Add the theme as `extra_queries`. |
+
+When `$ARGUMENTS` is empty, print exactly this and stop:
+
+```
+/alpha MU              full council — asks which preset first
+/alpha MU quick        4 analysts + debate, no bench, no verification
+/alpha MU screen       mechanical filings screen only        (no model spend)
+/alpha MU options      IV term structure, skew, positioning  (no model spend)
+/alpha MU news         dated filings and headlines           (no model spend)
+/alpha market AI       what the market is talking about      (no model spend)
+```
+
+Say plainly that the four marked modes call keyless data tools and spawn no subagents, so
+they cost nothing beyond this turn. The council modes spawn one subagent per seat, and that
+is where the spend is.
+
+## Full council
+
+1. **Ask which preset first.** Call `list_council_options` and present the three with their
+   seat counts. A council is 7 to 44 seats and that range is the user's time and money.
+   **Skip the question when the request already answered it** — a named roster, "everything",
+   "be quick". A confirmation nobody needed is an interruption.
+2. Follow `skills/alphacouncil-agent/SKILL.md` from Stage 0. Do not improvise a shorter
+   workflow: a report that looks finished and skipped the bench is worse than an obviously
+   partial one.
+3. **Call the tools rather than searching for numbers they can supply.** `screen_ticker`,
+   `get_quote`, `get_options_chain`, `get_macro_snapshot`, `get_news`. Search is for
+   explanation and for what is not yet filed.
+4. Every selected master must report before the run is complete. `out_of_scope` is a
+   conclusion, not an abstention.
+5. Give price bands with the condition attached to each. "The cycle position is undetermined"
+   changes what the bands depend on; it does not excuse leaving them out.
+
+## Quick mode owes the reader one sentence
+
+State in the output that no master lenses ran and nothing was cross-verified, so the
+confidence is lower than a standard run. Without it, a four-seat run reads like a full
+council result.
+
+## Screen mode
+
+A rule whose inputs are missing is `skipped`, **never a pass** — reporting "6/7 passed"
+without naming the seventh misrepresents the screen. Surviving is not a recommendation; it
+means the name is worth research time. For a non-US ticker, say which market it is and use
+`market_coverage` rather than returning nothing.
+
+## Market mode
+
+Read it by the gap, not the ranking. A theme leading coverage while its series has not moved
+means the story is ahead of the data, or the market stopped listening — say which. A series
+that moved sharply while its theme is barely covered is the more valuable finding. Headline
+counts measure attention, never truth.
+
+## Never
+
+- Never fill a number from memory when a tool could have supplied it.
+- Never let social or narrative evidence enter the conclusion on its own.
+
+Educational software. The report says so.

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "AlphaCouncil plugins for public-equity research.",
-    "version": "0.5.1"
+    "version": "0.5.3"
   },
   "plugins": [
     {
       "name": "alphacouncil-agent",
       "source": "./",
       "description": "Multi-agent equity research: evidence packets, bull/bear debate, portfolio-manager decision.",
-      "version": "0.5.1",
+      "version": "0.5.3",
       "author": {
         "name": "Zhao73"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "alphacouncil-agent",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "Multi-agent public-equity research workflow for Claude Code: spawns analyst workers, gathers sourced JSON evidence packets, runs bull/bear debate, and produces a portfolio-manager Buy/Overweight/Hold/Underweight/Sell decision with a full report.",
   "author": {
     "name": "Zhao73"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "alphacouncil-agent",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "Host-visible or background public-equity research workflow with shared evidence packets.",
   "author": {
     "name": "Zhao73"

package/.grok/commands/alpha.md

@@ -0,0 +1,79 @@
+---
+description: Equity research council — full run, quick read, mechanical screen, or market narrative
+argument-hint: [ticker] [quick|screen|market|options|news] · or just a question
+---
+
+# /alpha
+
+Request: **$ARGUMENTS**
+
+## Route on the arguments — do not ask what they meant
+
+| `$ARGUMENTS` looks like | Do this |
+|---|---|
+| *(empty)* | Print the mode table below and stop. Do not start a run. |
+| a ticker alone, or a question | **Full council.** Go to "Full council" below. |
+| ticker + `quick` | The `quick` preset: 4 analysts and the debate. No bench, no verification. |
+| ticker + `screen` | `screen_ticker` only. No language-model judgment, no subagents. |
+| ticker + `options` | `get_options_chain` only. |
+| ticker + `news` | `get_news` on the symbol, and on its CIK when it is a US filer. |
+| `market` (with or without a theme) | `get_market_narrative`. Add the theme as `extra_queries`. |
+
+When `$ARGUMENTS` is empty, print exactly this and stop:
+
+```
+/alpha MU              full council — asks which preset first
+/alpha MU quick        4 analysts + debate, no bench, no verification
+/alpha MU screen       mechanical filings screen only        (no model spend)
+/alpha MU options      IV term structure, skew, positioning  (no model spend)
+/alpha MU news         dated filings and headlines           (no model spend)
+/alpha market AI       what the market is talking about      (no model spend)
+```
+
+Say plainly that the four marked modes call keyless data tools and spawn no subagents, so
+they cost nothing beyond this turn. The council modes spawn one subagent per seat, and that
+is where the spend is.
+
+## Full council
+
+1. **Ask which preset first.** Call `list_council_options` and present the three with their
+   seat counts. A council is 7 to 44 seats and that range is the user's time and money.
+   **Skip the question when the request already answered it** — a named roster, "everything",
+   "be quick". A confirmation nobody needed is an interruption.
+2. Follow `skills/alphacouncil-agent/SKILL.md` from Stage 0. Do not improvise a shorter
+   workflow: a report that looks finished and skipped the bench is worse than an obviously
+   partial one.
+3. **Call the tools rather than searching for numbers they can supply.** `screen_ticker`,
+   `get_quote`, `get_options_chain`, `get_macro_snapshot`, `get_news`. Search is for
+   explanation and for what is not yet filed.
+4. Every selected master must report before the run is complete. `out_of_scope` is a
+   conclusion, not an abstention.
+5. Give price bands with the condition attached to each. "The cycle position is undetermined"
+   changes what the bands depend on; it does not excuse leaving them out.
+
+## Quick mode owes the reader one sentence
+
+State in the output that no master lenses ran and nothing was cross-verified, so the
+confidence is lower than a standard run. Without it, a four-seat run reads like a full
+council result.
+
+## Screen mode
+
+A rule whose inputs are missing is `skipped`, **never a pass** — reporting "6/7 passed"
+without naming the seventh misrepresents the screen. Surviving is not a recommendation; it
+means the name is worth research time. For a non-US ticker, say which market it is and use
+`market_coverage` rather than returning nothing.
+
+## Market mode
+
+Read it by the gap, not the ranking. A theme leading coverage while its series has not moved
+means the story is ahead of the data, or the market stopped listening — say which. A series
+that moved sharply while its theme is barely covered is the more valuable finding. Headline
+counts measure attention, never truth.
+
+## Never
+
+- Never fill a number from memory when a tool could have supplied it.
+- Never let social or narrative evidence enter the conclusion on its own.
+
+Educational software. The report says so.

package/.opencode/command/alpha.md

@@ -0,0 +1,79 @@
+---
+description: Equity research council — full run, quick read, mechanical screen, or market narrative
+argument-hint: [ticker] [quick|screen|market|options|news] · or just a question
+---
+
+# /alpha
+
+Request: **$ARGUMENTS**
+
+## Route on the arguments — do not ask what they meant
+
+| `$ARGUMENTS` looks like | Do this |
+|---|---|
+| *(empty)* | Print the mode table below and stop. Do not start a run. |
+| a ticker alone, or a question | **Full council.** Go to "Full council" below. |
+| ticker + `quick` | The `quick` preset: 4 analysts and the debate. No bench, no verification. |
+| ticker + `screen` | `screen_ticker` only. No language-model judgment, no subagents. |
+| ticker + `options` | `get_options_chain` only. |
+| ticker + `news` | `get_news` on the symbol, and on its CIK when it is a US filer. |
+| `market` (with or without a theme) | `get_market_narrative`. Add the theme as `extra_queries`. |
+
+When `$ARGUMENTS` is empty, print exactly this and stop:
+
+```
+/alpha MU              full council — asks which preset first
+/alpha MU quick        4 analysts + debate, no bench, no verification
+/alpha MU screen       mechanical filings screen only        (no model spend)
+/alpha MU options      IV term structure, skew, positioning  (no model spend)
+/alpha MU news         dated filings and headlines           (no model spend)
+/alpha market AI       what the market is talking about      (no model spend)
+```
+
+Say plainly that the four marked modes call keyless data tools and spawn no subagents, so
+they cost nothing beyond this turn. The council modes spawn one subagent per seat, and that
+is where the spend is.
+
+## Full council
+
+1. **Ask which preset first.** Call `list_council_options` and present the three with their
+   seat counts. A council is 7 to 44 seats and that range is the user's time and money.
+   **Skip the question when the request already answered it** — a named roster, "everything",
+   "be quick". A confirmation nobody needed is an interruption.
+2. Follow `skills/alphacouncil-agent/SKILL.md` from Stage 0. Do not improvise a shorter
+   workflow: a report that looks finished and skipped the bench is worse than an obviously
+   partial one.
+3. **Call the tools rather than searching for numbers they can supply.** `screen_ticker`,
+   `get_quote`, `get_options_chain`, `get_macro_snapshot`, `get_news`. Search is for
+   explanation and for what is not yet filed.
+4. Every selected master must report before the run is complete. `out_of_scope` is a
+   conclusion, not an abstention.
+5. Give price bands with the condition attached to each. "The cycle position is undetermined"
+   changes what the bands depend on; it does not excuse leaving them out.
+
+## Quick mode owes the reader one sentence
+
+State in the output that no master lenses ran and nothing was cross-verified, so the
+confidence is lower than a standard run. Without it, a four-seat run reads like a full
+council result.
+
+## Screen mode
+
+A rule whose inputs are missing is `skipped`, **never a pass** — reporting "6/7 passed"
+without naming the seventh misrepresents the screen. Surviving is not a recommendation; it
+means the name is worth research time. For a non-US ticker, say which market it is and use
+`market_coverage` rather than returning nothing.
+
+## Market mode
+
+Read it by the gap, not the ranking. A theme leading coverage while its series has not moved
+means the story is ahead of the data, or the market stopped listening — say which. A series
+that moved sharply while its theme is barely covered is the more valuable finding. Headline
+counts measure attention, never truth.
+
+## Never
+
+- Never fill a number from memory when a tool could have supplied it.
+- Never let social or narrative evidence enter the conclusion on its own.
+
+Educational software. The report says so.

package/AGENTS.md

@@ -71,22 +71,29 @@ Verified against a real install (grok 0.2.101) rather than from documentation:
 
 ## Slash commands
 
-Authored once in `commands/` and generated into each host's directory by
-`scripts/sync-personas.mjs`, so `/alphacouncil` means the same thing everywhere.
-
-| Command | What it does |
-|---|---|
-| `/alphacouncil <ticker or question>` | Full council. Asks which preset first, unless the request already says. |
-| `/alphacouncil-quick <ticker>` | Four analysts, no bench, no verification — and says in the output what was skipped. |
-| `/alphacouncil-screen <ticker>` | Mechanical filings screen only. No language-model judgment. |
-| `/alphacouncil-market [theme]` | What the market is talking about, checked against the tape. |
+**One command, `/alpha`.** Modes are arguments, so there is one name to remember
+rather than four in a menu of a hundred.
+
+| Invocation | What runs | Model spend |
+|---|---|---|
+| `/alpha MU` | Full council — asks which preset first | one subagent per seat |
+| `/alpha MU quick` | 4 analysts + debate, no bench, no verification | 7 seats |
+| `/alpha MU screen` | Mechanical filings screen only | **none** |
+| `/alpha MU options` | IV term structure, skew, positioning | **none** |
+| `/alpha MU news` | Dated filings and headlines | **none** |
+| `/alpha market AI` | What the market is talking about | **none** |
+| `/alpha` | Lists the modes and stops | **none** |
+
+The four marked **none** call keyless data tools and spawn no subagents, so they cost
+nothing beyond the turn you type them in. The council modes spawn one subagent per seat, and
+that is the entire cost of running this.
 
 | Host | Where it reads them |
 |---|---|
 | Claude Code | `commands/` via `.claude-plugin/plugin.json`, plus `.claude/commands/` for a checkout |
 | OpenCode | `.opencode/command/` |
 | Grok Build | `.grok/commands/`, and `.claude/commands/` as a high-priority compatibility source |
-| Codex | `~/.codex/prompts/` is **user-scoped**, so it is installed rather than shipped: `mkdir -p ~/.codex/prompts && cp commands/*.md ~/.codex/prompts/` |
+| Codex | `~/.codex/prompts/` is **user-scoped**: `mkdir -p ~/.codex/prompts && cp commands/alpha.md ~/.codex/prompts/` |
 
 ## Market data coverage
 

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 Notable changes per release. Dates are UTC.
 
+## [0.5.3] — 2026-07-26
+
+### Fixed
+
+- The 0.5.2 tarball was cut before the translated READMEs and `docs/INSTALL.md` learned that
+  `/alpha` exists, so an installed copy carried stale Chinese and Japanese documentation
+  while the repository did not. Docs-only; no code changed.
+
+## [0.5.2] — 2026-07-26
+
+### Changed
+
+- **Four slash commands collapse into one: `/alpha`**, with the modes as arguments.
+  `/alphacouncil-quick` and friends were long to type and, in a menu of a hundred commands,
+  four near-identical entries are harder to navigate than one. Modes: bare ticker for the
+  full council, plus `quick`, `screen`, `options`, `news`, and `market`. Invoked with no
+  arguments it lists the modes and stops rather than guessing.
+- The modes that spawn no subagents are marked as such, because that is the actual choice a
+  user is making — `screen`, `options`, `news` and `market` call keyless data tools and cost
+  nothing beyond the turn.
+
 ## [0.5.1] — 2026-07-26
 
 ### Added

package/CLAUDE.md

@@ -19,6 +19,12 @@ Default behavior is full workflow. Do not downgrade to lite, smoke-test, or debu
 
 Also follow `skills/agent-skills-governance/SKILL.md`. It is bundled with this plugin and applies the `addyosmani/agent-skills` style of explicit gates, anti-rationalizations, and exit criteria to AlphaCouncil runs. Do not treat it as an optional local setup step.
 
+## Invocation
+
+`/alpha <ticker>` runs the council; `/alpha` with no arguments lists its modes and stops.
+`quick`, `screen`, `options`, `news` and `market` select narrower modes, and the last four
+spawn no subagents at all.
+
 ## Analyst Roles
 
 Default evidence roles (the eight-seat default fan-out):

package/README.ja.md

@@ -107,6 +107,25 @@ codex plugin marketplace add Zhao73/alphacouncil-agent
 完全なレポートは `~/.alphacouncil-agent/runs/<run_id>/final_report.md` に書き出され、
 同じディレクトリに各アナリストの Markdown ファイルと `artifact_index.md` も保存されます。
 
+### スラッシュコマンド
+
+**コマンドは `/alpha` ひとつ。** モードは引数です —— 100 を超えるコマンド一覧の中から 4 つを探すのではなく、覚える名前はひとつだけです。
+
+| 入力 | 実行内容 | モデル消費 |
+|---|---|---|
+| `/alpha MU` | フル委員会 —— 先にどのプリセットか確認します | 席ごとに 1 サブエージェント |
+| `/alpha MU quick` | アナリスト 4 名＋討論。マスター陣なし、検証なし | 7 席 |
+| `/alpha MU screen` | 機械的スクリーニングのみ | **なし** |
+| `/alpha MU options` | IV ターム構造、スキュー、建玉分布 | **なし** |
+| `/alpha MU news` | 日付付きの提出書類とニュース | **なし** |
+| `/alpha market AI` | 市場が語っている物語 | **なし** |
+| `/alpha` | モード一覧を出して停止 | **なし** |
+
+**なし** と記した 4 つはキー不要のデータツールを呼ぶだけで、サブエージェントを一切起動しません。入力したそのターン以外に消費はありません。委員会モードは席ごとにサブエージェントを起動し、それがこのプラグインのコストのすべてです。
+
+Claude Code、OpenCode、Grok Build ではインストール後すぐ使えます。Codex の prompts はユーザースコープなので一度コピーしてください：
+`mkdir -p ~/.codex/prompts && cp commands/alpha.md ~/.codex/prompts/`
+
 ## 何ができるか
 
 既定はフル実行であり、簡易サマリーではありません：

package/README.md

@@ -125,16 +125,25 @@ with analyst Markdown files and `artifact_index.md` in the same run directory.
 
 ### Slash commands
 
-| Command | What it does |
-|---|---|
-| `/alphacouncil <ticker or question>` | The full council. Asks which preset first, unless your request already says. |
-| `/alphacouncil-quick <ticker>` | A fast directional read — four analysts, no bench, no verification, and it tells you so. |
-| `/alphacouncil-screen <ticker>` | The mechanical filings screen alone. No language-model judgment in it. |
-| `/alphacouncil-market [theme]` | What the market is talking about, checked against what the tape actually did. |
-
-Available in Claude Code, OpenCode and Grok Build as soon as the plugin is installed. Codex
-keeps its prompts user-scoped, so copy them once:
-`mkdir -p ~/.codex/prompts && cp commands/*.md ~/.codex/prompts/`
+**One command, `/alpha`.** Modes are arguments, so there is one name to remember
+rather than four in a menu of a hundred.
+
+| Invocation | What runs | Model spend |
+|---|---|---|
+| `/alpha MU` | Full council — asks which preset first | one subagent per seat |
+| `/alpha MU quick` | 4 analysts + debate, no bench, no verification | 7 seats |
+| `/alpha MU screen` | Mechanical filings screen only | **none** |
+| `/alpha MU options` | IV term structure, skew, positioning | **none** |
+| `/alpha MU news` | Dated filings and headlines | **none** |
+| `/alpha market AI` | What the market is talking about | **none** |
+| `/alpha` | Lists the modes and stops | **none** |
+
+The four marked **none** call keyless data tools and spawn no subagents, so they cost
+nothing beyond the turn you type them in. The council modes spawn one subagent per seat, and
+that is the entire cost of running this.
+
+Available in Claude Code, OpenCode and Grok Build as soon as the plugin is installed. Codex keeps
+its prompts user-scoped, so copy it once: `mkdir -p ~/.codex/prompts && cp commands/alpha.md ~/.codex/prompts/`
 
 ## What It Does
 

package/README.zh-CN.md

@@ -107,6 +107,25 @@ codex plugin marketplace add Zhao73/alphacouncil-agent
 完整报告写入 `~/.alphacouncil-agent/runs/<run_id>/final_report.md`。
 同一目录还会写入每个分析师的 Markdown 文件和 `artifact_index.md` 文件索引。
 
+### 斜杠命令
+
+**一个命令，`/alpha`。** 模式当参数 —— 只用记一个名字，而不是在上百条命令的菜单里找四个。
+
+| 输入 | 跑什么 | 额度消耗 |
+|---|---|---|
+| `/alpha MU` | 完整议会 —— 先问你跑哪个预设 | 每席一个子代理 |
+| `/alpha MU quick` | 4 分析师 + 辩论，无大师、无验证 | 7 席 |
+| `/alpha MU screen` | 只跑机械筛选 | **零** |
+| `/alpha MU options` | 隐含波动率期限结构、偏斜、持仓分布 | **零** |
+| `/alpha MU news` | 带日期的申报与新闻 | **零** |
+| `/alpha market AI` | 市场在讲什么故事 | **零** |
+| `/alpha` | 列出模式后停下 | **零** |
+
+标「零」的四个只调免 key 数据工具、**不启动任何子代理**，除了你敲的这一轮之外不消耗额度。议会模式每个席位起一个子代理，那是这个插件的全部成本所在。
+
+Claude Code、OpenCode、Grok Build 装完即可用。Codex 的 prompts 是用户级的，拷贝一次：
+`mkdir -p ~/.codex/prompts && cp commands/alpha.md ~/.codex/prompts/`
+
 ## 它能做什么
 
 默认是完整运行，不是精简摘要：

package/commands/alpha.md

@@ -0,0 +1,79 @@
+---
+description: Equity research council — full run, quick read, mechanical screen, or market narrative
+argument-hint: [ticker] [quick|screen|market|options|news] · or just a question
+---
+
+# /alpha
+
+Request: **$ARGUMENTS**
+
+## Route on the arguments — do not ask what they meant
+
+| `$ARGUMENTS` looks like | Do this |
+|---|---|
+| *(empty)* | Print the mode table below and stop. Do not start a run. |
+| a ticker alone, or a question | **Full council.** Go to "Full council" below. |
+| ticker + `quick` | The `quick` preset: 4 analysts and the debate. No bench, no verification. |
+| ticker + `screen` | `screen_ticker` only. No language-model judgment, no subagents. |
+| ticker + `options` | `get_options_chain` only. |
+| ticker + `news` | `get_news` on the symbol, and on its CIK when it is a US filer. |
+| `market` (with or without a theme) | `get_market_narrative`. Add the theme as `extra_queries`. |
+
+When `$ARGUMENTS` is empty, print exactly this and stop:
+
+```
+/alpha MU              full council — asks which preset first
+/alpha MU quick        4 analysts + debate, no bench, no verification
+/alpha MU screen       mechanical filings screen only        (no model spend)
+/alpha MU options      IV term structure, skew, positioning  (no model spend)
+/alpha MU news         dated filings and headlines           (no model spend)
+/alpha market AI       what the market is talking about      (no model spend)
+```
+
+Say plainly that the four marked modes call keyless data tools and spawn no subagents, so
+they cost nothing beyond this turn. The council modes spawn one subagent per seat, and that
+is where the spend is.
+
+## Full council
+
+1. **Ask which preset first.** Call `list_council_options` and present the three with their
+   seat counts. A council is 7 to 44 seats and that range is the user's time and money.
+   **Skip the question when the request already answered it** — a named roster, "everything",
+   "be quick". A confirmation nobody needed is an interruption.
+2. Follow `skills/alphacouncil-agent/SKILL.md` from Stage 0. Do not improvise a shorter
+   workflow: a report that looks finished and skipped the bench is worse than an obviously
+   partial one.
+3. **Call the tools rather than searching for numbers they can supply.** `screen_ticker`,
+   `get_quote`, `get_options_chain`, `get_macro_snapshot`, `get_news`. Search is for
+   explanation and for what is not yet filed.
+4. Every selected master must report before the run is complete. `out_of_scope` is a
+   conclusion, not an abstention.
+5. Give price bands with the condition attached to each. "The cycle position is undetermined"
+   changes what the bands depend on; it does not excuse leaving them out.
+
+## Quick mode owes the reader one sentence
+
+State in the output that no master lenses ran and nothing was cross-verified, so the
+confidence is lower than a standard run. Without it, a four-seat run reads like a full
+council result.
+
+## Screen mode
+
+A rule whose inputs are missing is `skipped`, **never a pass** — reporting "6/7 passed"
+without naming the seventh misrepresents the screen. Surviving is not a recommendation; it
+means the name is worth research time. For a non-US ticker, say which market it is and use
+`market_coverage` rather than returning nothing.
+
+## Market mode
+
+Read it by the gap, not the ranking. A theme leading coverage while its series has not moved
+means the story is ahead of the data, or the market stopped listening — say which. A series
+that moved sharply while its theme is barely covered is the more valuable finding. Headline
+counts measure attention, never truth.
+
+## Never
+
+- Never fill a number from memory when a tool could have supplied it.
+- Never let social or narrative evidence enter the conclusion on its own.
+
+Educational software. The report says so.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alphacouncil-agent",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "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.",
   "type": "module",
   "license": "MIT",

package/.claude/commands/alphacouncil-market.md

@@ -1,23 +0,0 @@
----
-description: What story the market is telling itself, checked against the tape
-argument-hint: [optional theme or sector]
----
-
-# AlphaCouncil — market narrative
-
-Focus, if given: **$ARGUMENTS**
-
-Call `get_market_narrative`, adding `extra_queries` when a sector or theme is named.
-
-Read it by the gap, not by the ranking:
-
-- **A theme leading coverage while its series has not moved** — the story is ahead of the
-  data, or the market has stopped listening. Say which you think it is, and why.
-- **A series that moved sharply while its theme is barely covered** — something is happening
-  that has not been narrated yet. This is the most valuable thing on the page.
-
-Headline counts measure attention, never truth. Every claim about a theme must be followed
-by what its market series actually did.
-
-The lexicon is fixed, so a genuinely new narrative lands in `unclassified_headlines`
-instead of being discovered. Read those titles and name the theme by hand if one is there.

package/.claude/commands/alphacouncil-quick.md

@@ -1,19 +0,0 @@
----
-description: A fast directional read: four analysts, no master bench, no verification
-argument-hint: [ticker]
----
-
-# AlphaCouncil — quick read
-
-Ticker or question: **$ARGUMENTS**
-
-Run the `quick` preset from `list_council_options`: four analysts and the debate, with no
-master bench and no verification pass. Do not ask which preset to use — the user chose this
-command, which is the answer.
-
-**Say once, in the output, what was skipped:** no master lenses and no cross-verification,
-so the confidence is lower than a standard run and the report should say so rather than
-reading like a full council result.
-
-Start with `screen_ticker`, `get_quote` and `get_options_chain` — they are three calls and
-they establish more than any amount of searching will.

package/.claude/commands/alphacouncil-screen.md

@@ -1,21 +0,0 @@
----
-description: Mechanical filings screen only — no language model judgment
-argument-hint: [ticker]
----
-
-# AlphaCouncil — mechanical screen
-
-Ticker: **$ARGUMENTS**
-
-Call `screen_ticker` with `ticker`. The CIK resolves itself.
-
-Report the table exactly as returned, and state plainly:
-
-- **A rule whose inputs are missing is `skipped`, never a pass.** Reporting "6/7 passed"
-  without naming the seventh misrepresents the screen.
-- **Surviving is not a recommendation.** It means the name is worth research time.
-- No language model judgment is involved in this screen. Every elimination names the
-  metric, the measured value and the threshold.
-
-For a non-US ticker the SEC universe has no entry; say which market it is and use
-`market_coverage` to say what that market supports instead of returning nothing.

package/.claude/commands/alphacouncil.md

@@ -1,39 +0,0 @@
----
-description: Run the full investment council on a ticker or a question
-argument-hint: [ticker or question]
----
-
-# AlphaCouncil — full council
-
-The user asked for: **$ARGUMENTS**
-
-## Do this in order
-
-1. **Ask which council to run first.** Call `list_council_options` and present the three
-   presets with their seat counts and relative cost. A council is 7 to 44 seats and that
-   range is the user's time and money.
-   **Skip the question if they already answered** — if `$ARGUMENTS` names a roster, says
-   "everything", or says "quick", act on it. A confirmation nobody needed is an interruption.
-
-2. Follow `skills/alphacouncil-agent/SKILL.md` from Stage 0. Do not improvise a shorter
-   workflow: the gates exist because a report that looks finished and skipped the bench is
-   worse than an obviously partial one.
-
-3. **Call the tools instead of searching for numbers they can supply.** `screen_ticker` for
-   filings, `get_quote` for price, `get_options_chain` for positioning, `get_macro_snapshot`
-   for context, `get_news` for dated items. Search is for explanation and for what is not
-   yet filed.
-
-4. Every selected master must report before the run can be complete. `out_of_scope` is a
-   conclusion, not an abstention.
-
-5. Give price bands with the condition attached to each. "The cycle position is undetermined"
-   changes what the bands depend on; it does not excuse leaving them out.
-
-## Never
-
-- Never fill a number from memory when a tool could have supplied it.
-- Never present a rule with missing inputs as a pass — it is `skipped`.
-- Never let social or narrative evidence enter the conclusion on its own.
-
-This is educational software. The final report says so.

package/.grok/commands/alphacouncil-market.md

@@ -1,23 +0,0 @@
----
-description: What story the market is telling itself, checked against the tape
-argument-hint: [optional theme or sector]
----
-
-# AlphaCouncil — market narrative
-
-Focus, if given: **$ARGUMENTS**
-
-Call `get_market_narrative`, adding `extra_queries` when a sector or theme is named.
-
-Read it by the gap, not by the ranking:
-
-- **A theme leading coverage while its series has not moved** — the story is ahead of the
-  data, or the market has stopped listening. Say which you think it is, and why.
-- **A series that moved sharply while its theme is barely covered** — something is happening
-  that has not been narrated yet. This is the most valuable thing on the page.
-
-Headline counts measure attention, never truth. Every claim about a theme must be followed
-by what its market series actually did.
-
-The lexicon is fixed, so a genuinely new narrative lands in `unclassified_headlines`
-instead of being discovered. Read those titles and name the theme by hand if one is there.

package/.grok/commands/alphacouncil-quick.md

@@ -1,19 +0,0 @@
----
-description: A fast directional read: four analysts, no master bench, no verification
-argument-hint: [ticker]
----
-
-# AlphaCouncil — quick read
-
-Ticker or question: **$ARGUMENTS**
-
-Run the `quick` preset from `list_council_options`: four analysts and the debate, with no
-master bench and no verification pass. Do not ask which preset to use — the user chose this
-command, which is the answer.
-
-**Say once, in the output, what was skipped:** no master lenses and no cross-verification,
-so the confidence is lower than a standard run and the report should say so rather than
-reading like a full council result.
-
-Start with `screen_ticker`, `get_quote` and `get_options_chain` — they are three calls and
-they establish more than any amount of searching will.

package/.grok/commands/alphacouncil-screen.md

@@ -1,21 +0,0 @@
----
-description: Mechanical filings screen only — no language model judgment
-argument-hint: [ticker]
----
-
-# AlphaCouncil — mechanical screen
-
-Ticker: **$ARGUMENTS**
-
-Call `screen_ticker` with `ticker`. The CIK resolves itself.
-
-Report the table exactly as returned, and state plainly:
-
-- **A rule whose inputs are missing is `skipped`, never a pass.** Reporting "6/7 passed"
-  without naming the seventh misrepresents the screen.
-- **Surviving is not a recommendation.** It means the name is worth research time.
-- No language model judgment is involved in this screen. Every elimination names the
-  metric, the measured value and the threshold.
-
-For a non-US ticker the SEC universe has no entry; say which market it is and use
-`market_coverage` to say what that market supports instead of returning nothing.

package/.grok/commands/alphacouncil.md

@@ -1,39 +0,0 @@
----
-description: Run the full investment council on a ticker or a question
-argument-hint: [ticker or question]
----
-
-# AlphaCouncil — full council
-
-The user asked for: **$ARGUMENTS**
-
-## Do this in order
-
-1. **Ask which council to run first.** Call `list_council_options` and present the three
-   presets with their seat counts and relative cost. A council is 7 to 44 seats and that
-   range is the user's time and money.
-   **Skip the question if they already answered** — if `$ARGUMENTS` names a roster, says
-   "everything", or says "quick", act on it. A confirmation nobody needed is an interruption.
-
-2. Follow `skills/alphacouncil-agent/SKILL.md` from Stage 0. Do not improvise a shorter
-   workflow: the gates exist because a report that looks finished and skipped the bench is
-   worse than an obviously partial one.
-
-3. **Call the tools instead of searching for numbers they can supply.** `screen_ticker` for
-   filings, `get_quote` for price, `get_options_chain` for positioning, `get_macro_snapshot`
-   for context, `get_news` for dated items. Search is for explanation and for what is not
-   yet filed.
-
-4. Every selected master must report before the run can be complete. `out_of_scope` is a
-   conclusion, not an abstention.
-
-5. Give price bands with the condition attached to each. "The cycle position is undetermined"
-   changes what the bands depend on; it does not excuse leaving them out.
-
-## Never
-
-- Never fill a number from memory when a tool could have supplied it.
-- Never present a rule with missing inputs as a pass — it is `skipped`.
-- Never let social or narrative evidence enter the conclusion on its own.
-
-This is educational software. The final report says so.

package/.opencode/command/alphacouncil-market.md

@@ -1,23 +0,0 @@
----
-description: What story the market is telling itself, checked against the tape
-argument-hint: [optional theme or sector]
----
-
-# AlphaCouncil — market narrative
-
-Focus, if given: **$ARGUMENTS**
-
-Call `get_market_narrative`, adding `extra_queries` when a sector or theme is named.
-
-Read it by the gap, not by the ranking:
-
-- **A theme leading coverage while its series has not moved** — the story is ahead of the
-  data, or the market has stopped listening. Say which you think it is, and why.
-- **A series that moved sharply while its theme is barely covered** — something is happening
-  that has not been narrated yet. This is the most valuable thing on the page.
-
-Headline counts measure attention, never truth. Every claim about a theme must be followed
-by what its market series actually did.
-
-The lexicon is fixed, so a genuinely new narrative lands in `unclassified_headlines`
-instead of being discovered. Read those titles and name the theme by hand if one is there.

package/.opencode/command/alphacouncil-quick.md

@@ -1,19 +0,0 @@
----
-description: A fast directional read: four analysts, no master bench, no verification
-argument-hint: [ticker]
----
-
-# AlphaCouncil — quick read
-
-Ticker or question: **$ARGUMENTS**
-
-Run the `quick` preset from `list_council_options`: four analysts and the debate, with no
-master bench and no verification pass. Do not ask which preset to use — the user chose this
-command, which is the answer.
-
-**Say once, in the output, what was skipped:** no master lenses and no cross-verification,
-so the confidence is lower than a standard run and the report should say so rather than
-reading like a full council result.
-
-Start with `screen_ticker`, `get_quote` and `get_options_chain` — they are three calls and
-they establish more than any amount of searching will.

package/.opencode/command/alphacouncil-screen.md

@@ -1,21 +0,0 @@
----
-description: Mechanical filings screen only — no language model judgment
-argument-hint: [ticker]
----
-
-# AlphaCouncil — mechanical screen
-
-Ticker: **$ARGUMENTS**
-
-Call `screen_ticker` with `ticker`. The CIK resolves itself.
-
-Report the table exactly as returned, and state plainly:
-
-- **A rule whose inputs are missing is `skipped`, never a pass.** Reporting "6/7 passed"
-  without naming the seventh misrepresents the screen.
-- **Surviving is not a recommendation.** It means the name is worth research time.
-- No language model judgment is involved in this screen. Every elimination names the
-  metric, the measured value and the threshold.
-
-For a non-US ticker the SEC universe has no entry; say which market it is and use
-`market_coverage` to say what that market supports instead of returning nothing.

package/.opencode/command/alphacouncil.md

@@ -1,39 +0,0 @@
----
-description: Run the full investment council on a ticker or a question
-argument-hint: [ticker or question]
----
-
-# AlphaCouncil — full council
-
-The user asked for: **$ARGUMENTS**
-
-## Do this in order
-
-1. **Ask which council to run first.** Call `list_council_options` and present the three
-   presets with their seat counts and relative cost. A council is 7 to 44 seats and that
-   range is the user's time and money.
-   **Skip the question if they already answered** — if `$ARGUMENTS` names a roster, says
-   "everything", or says "quick", act on it. A confirmation nobody needed is an interruption.
-
-2. Follow `skills/alphacouncil-agent/SKILL.md` from Stage 0. Do not improvise a shorter
-   workflow: the gates exist because a report that looks finished and skipped the bench is
-   worse than an obviously partial one.
-
-3. **Call the tools instead of searching for numbers they can supply.** `screen_ticker` for
-   filings, `get_quote` for price, `get_options_chain` for positioning, `get_macro_snapshot`
-   for context, `get_news` for dated items. Search is for explanation and for what is not
-   yet filed.
-
-4. Every selected master must report before the run can be complete. `out_of_scope` is a
-   conclusion, not an abstention.
-
-5. Give price bands with the condition attached to each. "The cycle position is undetermined"
-   changes what the bands depend on; it does not excuse leaving them out.
-
-## Never
-
-- Never fill a number from memory when a tool could have supplied it.
-- Never present a rule with missing inputs as a pass — it is `skipped`.
-- Never let social or narrative evidence enter the conclusion on its own.
-
-This is educational software. The final report says so.

package/commands/alphacouncil-market.md

@@ -1,23 +0,0 @@
----
-description: What story the market is telling itself, checked against the tape
-argument-hint: [optional theme or sector]
----
-
-# AlphaCouncil — market narrative
-
-Focus, if given: **$ARGUMENTS**
-
-Call `get_market_narrative`, adding `extra_queries` when a sector or theme is named.
-
-Read it by the gap, not by the ranking:
-
-- **A theme leading coverage while its series has not moved** — the story is ahead of the
-  data, or the market has stopped listening. Say which you think it is, and why.
-- **A series that moved sharply while its theme is barely covered** — something is happening
-  that has not been narrated yet. This is the most valuable thing on the page.
-
-Headline counts measure attention, never truth. Every claim about a theme must be followed
-by what its market series actually did.
-
-The lexicon is fixed, so a genuinely new narrative lands in `unclassified_headlines`
-instead of being discovered. Read those titles and name the theme by hand if one is there.

package/commands/alphacouncil-quick.md

@@ -1,19 +0,0 @@
----
-description: A fast directional read: four analysts, no master bench, no verification
-argument-hint: [ticker]
----
-
-# AlphaCouncil — quick read
-
-Ticker or question: **$ARGUMENTS**
-
-Run the `quick` preset from `list_council_options`: four analysts and the debate, with no
-master bench and no verification pass. Do not ask which preset to use — the user chose this
-command, which is the answer.
-
-**Say once, in the output, what was skipped:** no master lenses and no cross-verification,
-so the confidence is lower than a standard run and the report should say so rather than
-reading like a full council result.
-
-Start with `screen_ticker`, `get_quote` and `get_options_chain` — they are three calls and
-they establish more than any amount of searching will.

package/commands/alphacouncil-screen.md

@@ -1,21 +0,0 @@
----
-description: Mechanical filings screen only — no language model judgment
-argument-hint: [ticker]
----
-
-# AlphaCouncil — mechanical screen
-
-Ticker: **$ARGUMENTS**
-
-Call `screen_ticker` with `ticker`. The CIK resolves itself.
-
-Report the table exactly as returned, and state plainly:
-
-- **A rule whose inputs are missing is `skipped`, never a pass.** Reporting "6/7 passed"
-  without naming the seventh misrepresents the screen.
-- **Surviving is not a recommendation.** It means the name is worth research time.
-- No language model judgment is involved in this screen. Every elimination names the
-  metric, the measured value and the threshold.
-
-For a non-US ticker the SEC universe has no entry; say which market it is and use
-`market_coverage` to say what that market supports instead of returning nothing.

package/commands/alphacouncil.md

@@ -1,39 +0,0 @@
----
-description: Run the full investment council on a ticker or a question
-argument-hint: [ticker or question]
----
-
-# AlphaCouncil — full council
-
-The user asked for: **$ARGUMENTS**
-
-## Do this in order
-
-1. **Ask which council to run first.** Call `list_council_options` and present the three
-   presets with their seat counts and relative cost. A council is 7 to 44 seats and that
-   range is the user's time and money.
-   **Skip the question if they already answered** — if `$ARGUMENTS` names a roster, says
-   "everything", or says "quick", act on it. A confirmation nobody needed is an interruption.
-
-2. Follow `skills/alphacouncil-agent/SKILL.md` from Stage 0. Do not improvise a shorter
-   workflow: the gates exist because a report that looks finished and skipped the bench is
-   worse than an obviously partial one.
-
-3. **Call the tools instead of searching for numbers they can supply.** `screen_ticker` for
-   filings, `get_quote` for price, `get_options_chain` for positioning, `get_macro_snapshot`
-   for context, `get_news` for dated items. Search is for explanation and for what is not
-   yet filed.
-
-4. Every selected master must report before the run can be complete. `out_of_scope` is a
-   conclusion, not an abstention.
-
-5. Give price bands with the condition attached to each. "The cycle position is undetermined"
-   changes what the bands depend on; it does not excuse leaving them out.
-
-## Never
-
-- Never fill a number from memory when a tool could have supplied it.
-- Never present a rule with missing inputs as a pass — it is `skipped`.
-- Never let social or narrative evidence enter the conclusion on its own.
-
-This is educational software. The final report says so.