alphacouncil-agent 1.0.4 → 1.0.13

package/.claude/agents/alphacouncil-insider_sec.md

@@ -28,6 +28,25 @@ Key items: 1.01 material agreement, 2.02 results, 4.01 auditor change, 4.02 prio
 4. **Dilution**
 Shares outstanding across several years. Persistent dilution discounts every per-share growth figure, and that is routinely ignored in growth discussions.
 
+## How to actually retrieve the filings (EDGAR throttles; this section decides whether this seat has primary evidence at all)
+
+EDGAR answers **HTTP 429** to a client without a descriptive User-Agent, and `www.sec.gov` is throttled harder than `data.sec.gov`. **Rapidly trying different URLs makes the throttling worse, not better** -- on one real run eight different URLs were tried in a row, all returned 429, and not a single filing was read.
+
+Retrieve in this order and stop as soon as you have what you need:
+
+1. `https://data.sec.gov/submissions/CIK##########.json` (CIK zero-padded to ten digits) -- the filing index. The most tolerant endpoint, and one call returns every form type, accession number and filed date.
+2. `https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json` -- XBRL numbers such as share count and stockholders' equity.
+3. `https://www.sec.gov/Archives/edgar/data/<CIK without leading zeros>/<accession without dashes>/<primary document>` -- the specific Form 4 or 8-K text.
+4. EDGAR full-text search and `cgi-bin/browse-edgar` **last**: they are throttled the hardest and tell you nothing the first three cannot.
+
+On a 429: **wait a few seconds and retry the same URL** rather than immediately switching to a different one. Retry one document at most three times; if all three are limited, record the retrieval as failed and follow the degradation rule below.
+
+**Degradation rule (mandatory, and not to be softened)** -- when no filing was read directly:
+- the first sentence of `summary` must state that no EDGAR original was read and that everything was cross-checked through secondary sources instead;
+- `confidence` is capped at `low`;
+- `open_questions` lists each failed URL with its status code;
+- every item taken from a mirror or aggregator is labelled second-hand. **Never write mirror content as "verified against the filing".**
+
 ## Hard rules
 
 - **Every item carries the filing link and the filed date** -- the filed date, not the period end.

package/.claude/commands/alpha.md

@@ -1,6 +1,6 @@
 ---
 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
+argument-hint: [ticker] [fast|slow|quick|screen|market|options|news] · or just a question
 ---
 
 # /alpha
@@ -12,7 +12,8 @@ Request: **$ARGUMENTS**
 | `$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. Plugin-managed headless has a hard 30-minute queue-to-terminal bound; visible-host execution does not. |
+| a ticker alone, or a question | **Full council** at the `normal` pace. Go to "Full council" below. Plugin-managed headless is bound by the selected pace; visible-host execution has no bound at all. |
+| ticker + `fast` / `slow` / `deep` | Full council with that tier **prefilled**. Still show the pace menu and take the answer, exactly as with a named master. |
 | ticker + `quick` | The plugin-managed headless `quick_v1` council: 4 fixed analysts, 1-4 selected methods, one parallel bull/bear round and a short PM inside a hard 10-minute ceiling. |
 | ticker + `screen` | `screen_ticker` only. No language-model judgment, no subagents. |
 | ticker + `options` | `get_options_chain` only. |
@@ -22,15 +23,22 @@ Request: **$ARGUMENTS**
 When `$ARGUMENTS` is empty, print exactly this and stop:
 
 ```
-/alpha <TICKER>          full council — shows every master; headless run is bounded <=30m
+/alpha <TICKER>          full council — asks how deep to go, then shows every master
+/alpha <TICKER> fast     same, with the 15-minute tier prefilled
+/alpha <TICKER> slow     same, with the 60-minute tier prefilled
 /alpha <TICKER> quick    quick_v1: 4 analysts incl. news + 1-4 masters + 1 parallel debate round (<=10m)
 /alpha <TICKER> screen   mechanical filings screen only        (no model spend)
 /alpha <TICKER> options  IV term structure, skew, positioning  (no model spend)
 /alpha <TICKER> news     dated filings and headlines           (no model spend)
 /alpha market <theme>    what the market is talking about      (no model spend)
 
+you do not have to type a speed: the run asks, and shows the predicted time for each
+tier. all three tiers are the same full_v2 contract at three depths; quick is a SMALLER
+contract (4 analysts, 1 debate round) and is never full-equivalent
+
 examples
   /alpha AAPL            /alpha 0700.HK quick     /alpha 7203.T news
+  /alpha NVDA slow       /alpha MSFT fast
   /alpha NVDA screen     /alpha market rates      /alpha "is TSM cheap?"
 ```
 
@@ -51,24 +59,40 @@ the same in Claude Code, Codex, OpenCode and Grok Build.
 1. Call `begin_council_selection` with the symbol, original request, language, host and the
    intended `council_mode` (`full` by default; exactly `quick` for quick mode). If
    the request explicitly names masters, also pass those stable IDs as
-   `preselected_master_ids`; this highlights them but does not confirm them.
-2. Show **every returned master individually, in the returned order and with its stable
+   `preselected_master_ids`; if it named a speed, pass `council_pace`. Both highlight a choice
+   without confirming it.
+2. **Ask how deep to go first**, from the returned `pace_options`. It is a three-option
+   question and the catalog is long, so it goes above the catalog. Show BOTH numbers per tier
+   — the expected time and the hard ceiling — because a ceiling alone reads as the estimate:
+
+   ```
+   本次分析要跑多深？（默认 2）
+     1. 快速   预计 ~12 分钟（上限 15）  每证据席 3.5 分钟，每轮辩论每侧 90 秒
+     2. 标准   预计 ~20 分钟（上限 30）  每证据席 6 分钟，每轮辩论每侧 150 秒   ← 默认
+     3. 深入   预计 ~44 分钟（上限 60）  每证据席 12 分钟，每轮辩论每侧 360 秒
+   三档都是完整评议：同样 8 个证据席、同样三轮辩论、同样 PM，只是每席能想多久不同。
+   ```
+
+   Quick returns an empty menu and rejects the field; say so rather than offering a tier.
+3. Show **every returned master individually, in the returned order and with its stable
    number**. Each row must include `identity`, `method`, `best_for` and `maturity`; a school
    name or a count is not a substitute for the individual catalog.
-3. Ask for one submission. In full mode accept one number from `1..N`, combinations,
+4. Ask for one submission covering both the tier and the seats. In full mode accept one number from `1..N`, combinations,
    ranges, stable IDs/names, or `all`. In quick mode the same complete 26-seat catalog is
    displayed, but the submission must contain **1..4 seats** and `all` / `select_all` is
    forbidden. A host-native multi-select is a convenience only. If it is unavailable or
    cannot show the full catalog, use the numbered text table and plain reply on every host.
-4. If the original full-mode request already named masters or said `all`, prefill that choice but
+5. If the original full-mode request already named masters or said `all`, prefill that choice but
    **still show the full catalog and require this run's submission**. Do not silently reuse a
    prior choice. For quick, prefill at most four named methods and ask the user to reduce an
    oversized/`all` request to 1-4. The submitted choice is the confirmation; do not ask a
    second confirmation.
-5. Call `confirm_master_selection` with the returned `selection_id`, `catalog_hash`,
-   `display_ack: true`, and exactly one of `selected_master_ids`, `select_all: true`, or
-   `selection`. Retain the returned one-use `selection_receipt`.
-6. Only now call `plan_visible_run` (full only), `collect_evidence` (full only), or
+6. Call `confirm_master_selection` with the returned `selection_id`, `catalog_hash`,
+   `display_ack: true`, the answered `council_pace` (omit to accept `normal`), and exactly one
+   of `selected_master_ids`, `select_all: true`, or `selection`. Retain the returned
+   one-use `selection_receipt`. The pace binds into it: an execution call may repeat the confirmed tier
+   but never change it, so a user who approved 15 minutes cannot end up running an hour.
+7. Only now call `plan_visible_run` (full only), `collect_evidence` (full only), or
    `analyze_symbol`, passing that `selection_receipt` and the same symbol, prompt, language
    and `council_mode`. Quick must use `analyze_symbol`. Do not also pass `masters` or
    `masters_roster`; the receipt is authoritative and mode-bound. A full receipt cannot start
@@ -97,14 +121,19 @@ master-selection contract.
    fails after its bounded parse repair, do not spend more model calls on masters, bull/bear
    or PM. Persist an `incomplete` run naming the failed evidence and skipped downstream roles.
 7. For the hard runtime contract, call plugin-managed headless `analyze_symbol` once with
-   `council_mode:"full"`, `wait_for_completion:false`, the full-mode receipt and optionally
-   `total_timeout_ms` no greater than `1800000`. Poll the same durable `run_id` to terminal.
-   All eight mandatory evidence roles start in one wave; every selected v3 method gets a
-   frozen deterministic stance plus its own isolated voice worker; Bull/Bear run in parallel
-   within each of three rounds with a barrier between rounds; then the PM runs. Queueing,
-   retries and final persistence share the 30-minute clock. At expiry the saved run is
-   `incomplete`, never silently shortened or relabeled complete. This guarantees terminal
-   persistence, not all-seat success during search/model/data-provider degradation.
+   `council_mode:"full"`, `wait_for_completion:false`, the full-mode receipt, and
+   `council_pace` when the arguments asked for a speed: `fast` for 15 minutes, `slow` (or
+   `deep`) for 60, omitted for the 30-minute default. Poll the same durable `run_id` to
+   terminal. All eight mandatory evidence roles start in one wave; every selected v3 method
+   gets a frozen deterministic stance plus its own isolated voice worker; Bull/Bear run in
+   parallel within each of three rounds with a barrier between rounds; then the PM runs.
+   Queueing, retries and final persistence share the selected tier's clock. At expiry the
+   saved run is `incomplete`, never silently shortened or relabeled complete. This guarantees
+   terminal persistence, not all-seat success during search/model/data-provider degradation.
+   Pass `total_timeout_ms` only to LOWER the tier's budget; above it the call is rejected.
+   Tell the user which pace ran and what it bought: the tier raises every per-stage cap, so
+   `slow` gives each evidence seat 12 minutes instead of 6 and each debate round 6 minutes per
+   side instead of 150 seconds. All three paces are the same `full_v2` contract.
 8. `plan_visible_run` is owned by the external host. The plugin cannot force-stop its Task
    agents, so visible-host full must not be advertised as meeting the 30-minute deadline.
 9. The terminal full handoff must include the system price snapshot (or explicit unavailable

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "AlphaCouncil plugins for public-equity research.",
-    "version": "1.0.4"
+    "version": "1.0.13"
   },
   "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.4",
+      "version": "1.0.13",
       "author": {
         "name": "Zhao73"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "alphacouncil-agent",
-  "version": "1.0.4",
+  "version": "1.0.13",
   "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.4",
+  "version": "1.0.13",
   "description": "Host-visible or background company, ETF and index research with shared evidence packets.",
   "author": {
     "name": "Zhao73"

package/.grok/agents/alphacouncil-insider_sec.md

@@ -29,6 +29,25 @@ Key items: 1.01 material agreement, 2.02 results, 4.01 auditor change, 4.02 prio
 4. **Dilution**
 Shares outstanding across several years. Persistent dilution discounts every per-share growth figure, and that is routinely ignored in growth discussions.
 
+## How to actually retrieve the filings (EDGAR throttles; this section decides whether this seat has primary evidence at all)
+
+EDGAR answers **HTTP 429** to a client without a descriptive User-Agent, and `www.sec.gov` is throttled harder than `data.sec.gov`. **Rapidly trying different URLs makes the throttling worse, not better** -- on one real run eight different URLs were tried in a row, all returned 429, and not a single filing was read.
+
+Retrieve in this order and stop as soon as you have what you need:
+
+1. `https://data.sec.gov/submissions/CIK##########.json` (CIK zero-padded to ten digits) -- the filing index. The most tolerant endpoint, and one call returns every form type, accession number and filed date.
+2. `https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json` -- XBRL numbers such as share count and stockholders' equity.
+3. `https://www.sec.gov/Archives/edgar/data/<CIK without leading zeros>/<accession without dashes>/<primary document>` -- the specific Form 4 or 8-K text.
+4. EDGAR full-text search and `cgi-bin/browse-edgar` **last**: they are throttled the hardest and tell you nothing the first three cannot.
+
+On a 429: **wait a few seconds and retry the same URL** rather than immediately switching to a different one. Retry one document at most three times; if all three are limited, record the retrieval as failed and follow the degradation rule below.
+
+**Degradation rule (mandatory, and not to be softened)** -- when no filing was read directly:
+- the first sentence of `summary` must state that no EDGAR original was read and that everything was cross-checked through secondary sources instead;
+- `confidence` is capped at `low`;
+- `open_questions` lists each failed URL with its status code;
+- every item taken from a mirror or aggregator is labelled second-hand. **Never write mirror content as "verified against the filing".**
+
 ## Hard rules
 
 - **Every item carries the filing link and the filed date** -- the filed date, not the period end.

package/.grok/commands/alpha.md

@@ -1,6 +1,6 @@
 ---
 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
+argument-hint: [ticker] [fast|slow|quick|screen|market|options|news] · or just a question
 ---
 
 # /alpha
@@ -12,7 +12,8 @@ Request: **$ARGUMENTS**
 | `$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. Plugin-managed headless has a hard 30-minute queue-to-terminal bound; visible-host execution does not. |
+| a ticker alone, or a question | **Full council** at the `normal` pace. Go to "Full council" below. Plugin-managed headless is bound by the selected pace; visible-host execution has no bound at all. |
+| ticker + `fast` / `slow` / `deep` | Full council with that tier **prefilled**. Still show the pace menu and take the answer, exactly as with a named master. |
 | ticker + `quick` | The plugin-managed headless `quick_v1` council: 4 fixed analysts, 1-4 selected methods, one parallel bull/bear round and a short PM inside a hard 10-minute ceiling. |
 | ticker + `screen` | `screen_ticker` only. No language-model judgment, no subagents. |
 | ticker + `options` | `get_options_chain` only. |
@@ -22,15 +23,22 @@ Request: **$ARGUMENTS**
 When `$ARGUMENTS` is empty, print exactly this and stop:
 
 ```
-/alpha <TICKER>          full council — shows every master; headless run is bounded <=30m
+/alpha <TICKER>          full council — asks how deep to go, then shows every master
+/alpha <TICKER> fast     same, with the 15-minute tier prefilled
+/alpha <TICKER> slow     same, with the 60-minute tier prefilled
 /alpha <TICKER> quick    quick_v1: 4 analysts incl. news + 1-4 masters + 1 parallel debate round (<=10m)
 /alpha <TICKER> screen   mechanical filings screen only        (no model spend)
 /alpha <TICKER> options  IV term structure, skew, positioning  (no model spend)
 /alpha <TICKER> news     dated filings and headlines           (no model spend)
 /alpha market <theme>    what the market is talking about      (no model spend)
 
+you do not have to type a speed: the run asks, and shows the predicted time for each
+tier. all three tiers are the same full_v2 contract at three depths; quick is a SMALLER
+contract (4 analysts, 1 debate round) and is never full-equivalent
+
 examples
   /alpha AAPL            /alpha 0700.HK quick     /alpha 7203.T news
+  /alpha NVDA slow       /alpha MSFT fast
   /alpha NVDA screen     /alpha market rates      /alpha "is TSM cheap?"
 ```
 
@@ -51,24 +59,40 @@ the same in Claude Code, Codex, OpenCode and Grok Build.
 1. Call `begin_council_selection` with the symbol, original request, language, host and the
    intended `council_mode` (`full` by default; exactly `quick` for quick mode). If
    the request explicitly names masters, also pass those stable IDs as
-   `preselected_master_ids`; this highlights them but does not confirm them.
-2. Show **every returned master individually, in the returned order and with its stable
+   `preselected_master_ids`; if it named a speed, pass `council_pace`. Both highlight a choice
+   without confirming it.
+2. **Ask how deep to go first**, from the returned `pace_options`. It is a three-option
+   question and the catalog is long, so it goes above the catalog. Show BOTH numbers per tier
+   — the expected time and the hard ceiling — because a ceiling alone reads as the estimate:
+
+   ```
+   本次分析要跑多深？（默认 2）
+     1. 快速   预计 ~12 分钟（上限 15）  每证据席 3.5 分钟，每轮辩论每侧 90 秒
+     2. 标准   预计 ~20 分钟（上限 30）  每证据席 6 分钟，每轮辩论每侧 150 秒   ← 默认
+     3. 深入   预计 ~44 分钟（上限 60）  每证据席 12 分钟，每轮辩论每侧 360 秒
+   三档都是完整评议：同样 8 个证据席、同样三轮辩论、同样 PM，只是每席能想多久不同。
+   ```
+
+   Quick returns an empty menu and rejects the field; say so rather than offering a tier.
+3. Show **every returned master individually, in the returned order and with its stable
    number**. Each row must include `identity`, `method`, `best_for` and `maturity`; a school
    name or a count is not a substitute for the individual catalog.
-3. Ask for one submission. In full mode accept one number from `1..N`, combinations,
+4. Ask for one submission covering both the tier and the seats. In full mode accept one number from `1..N`, combinations,
    ranges, stable IDs/names, or `all`. In quick mode the same complete 26-seat catalog is
    displayed, but the submission must contain **1..4 seats** and `all` / `select_all` is
    forbidden. A host-native multi-select is a convenience only. If it is unavailable or
    cannot show the full catalog, use the numbered text table and plain reply on every host.
-4. If the original full-mode request already named masters or said `all`, prefill that choice but
+5. If the original full-mode request already named masters or said `all`, prefill that choice but
    **still show the full catalog and require this run's submission**. Do not silently reuse a
    prior choice. For quick, prefill at most four named methods and ask the user to reduce an
    oversized/`all` request to 1-4. The submitted choice is the confirmation; do not ask a
    second confirmation.
-5. Call `confirm_master_selection` with the returned `selection_id`, `catalog_hash`,
-   `display_ack: true`, and exactly one of `selected_master_ids`, `select_all: true`, or
-   `selection`. Retain the returned one-use `selection_receipt`.
-6. Only now call `plan_visible_run` (full only), `collect_evidence` (full only), or
+6. Call `confirm_master_selection` with the returned `selection_id`, `catalog_hash`,
+   `display_ack: true`, the answered `council_pace` (omit to accept `normal`), and exactly one
+   of `selected_master_ids`, `select_all: true`, or `selection`. Retain the returned
+   one-use `selection_receipt`. The pace binds into it: an execution call may repeat the confirmed tier
+   but never change it, so a user who approved 15 minutes cannot end up running an hour.
+7. Only now call `plan_visible_run` (full only), `collect_evidence` (full only), or
    `analyze_symbol`, passing that `selection_receipt` and the same symbol, prompt, language
    and `council_mode`. Quick must use `analyze_symbol`. Do not also pass `masters` or
    `masters_roster`; the receipt is authoritative and mode-bound. A full receipt cannot start
@@ -97,14 +121,19 @@ master-selection contract.
    fails after its bounded parse repair, do not spend more model calls on masters, bull/bear
    or PM. Persist an `incomplete` run naming the failed evidence and skipped downstream roles.
 7. For the hard runtime contract, call plugin-managed headless `analyze_symbol` once with
-   `council_mode:"full"`, `wait_for_completion:false`, the full-mode receipt and optionally
-   `total_timeout_ms` no greater than `1800000`. Poll the same durable `run_id` to terminal.
-   All eight mandatory evidence roles start in one wave; every selected v3 method gets a
-   frozen deterministic stance plus its own isolated voice worker; Bull/Bear run in parallel
-   within each of three rounds with a barrier between rounds; then the PM runs. Queueing,
-   retries and final persistence share the 30-minute clock. At expiry the saved run is
-   `incomplete`, never silently shortened or relabeled complete. This guarantees terminal
-   persistence, not all-seat success during search/model/data-provider degradation.
+   `council_mode:"full"`, `wait_for_completion:false`, the full-mode receipt, and
+   `council_pace` when the arguments asked for a speed: `fast` for 15 minutes, `slow` (or
+   `deep`) for 60, omitted for the 30-minute default. Poll the same durable `run_id` to
+   terminal. All eight mandatory evidence roles start in one wave; every selected v3 method
+   gets a frozen deterministic stance plus its own isolated voice worker; Bull/Bear run in
+   parallel within each of three rounds with a barrier between rounds; then the PM runs.
+   Queueing, retries and final persistence share the selected tier's clock. At expiry the
+   saved run is `incomplete`, never silently shortened or relabeled complete. This guarantees
+   terminal persistence, not all-seat success during search/model/data-provider degradation.
+   Pass `total_timeout_ms` only to LOWER the tier's budget; above it the call is rejected.
+   Tell the user which pace ran and what it bought: the tier raises every per-stage cap, so
+   `slow` gives each evidence seat 12 minutes instead of 6 and each debate round 6 minutes per
+   side instead of 150 seconds. All three paces are the same `full_v2` contract.
 8. `plan_visible_run` is owned by the external host. The plugin cannot force-stop its Task
    agents, so visible-host full must not be advertised as meeting the 30-minute deadline.
 9. The terminal full handoff must include the system price snapshot (or explicit unavailable

package/.opencode/agent/alphacouncil-insider_sec.md

@@ -33,6 +33,25 @@ Key items: 1.01 material agreement, 2.02 results, 4.01 auditor change, 4.02 prio
 4. **Dilution**
 Shares outstanding across several years. Persistent dilution discounts every per-share growth figure, and that is routinely ignored in growth discussions.
 
+## How to actually retrieve the filings (EDGAR throttles; this section decides whether this seat has primary evidence at all)
+
+EDGAR answers **HTTP 429** to a client without a descriptive User-Agent, and `www.sec.gov` is throttled harder than `data.sec.gov`. **Rapidly trying different URLs makes the throttling worse, not better** -- on one real run eight different URLs were tried in a row, all returned 429, and not a single filing was read.
+
+Retrieve in this order and stop as soon as you have what you need:
+
+1. `https://data.sec.gov/submissions/CIK##########.json` (CIK zero-padded to ten digits) -- the filing index. The most tolerant endpoint, and one call returns every form type, accession number and filed date.
+2. `https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json` -- XBRL numbers such as share count and stockholders' equity.
+3. `https://www.sec.gov/Archives/edgar/data/<CIK without leading zeros>/<accession without dashes>/<primary document>` -- the specific Form 4 or 8-K text.
+4. EDGAR full-text search and `cgi-bin/browse-edgar` **last**: they are throttled the hardest and tell you nothing the first three cannot.
+
+On a 429: **wait a few seconds and retry the same URL** rather than immediately switching to a different one. Retry one document at most three times; if all three are limited, record the retrieval as failed and follow the degradation rule below.
+
+**Degradation rule (mandatory, and not to be softened)** -- when no filing was read directly:
+- the first sentence of `summary` must state that no EDGAR original was read and that everything was cross-checked through secondary sources instead;
+- `confidence` is capped at `low`;
+- `open_questions` lists each failed URL with its status code;
+- every item taken from a mirror or aggregator is labelled second-hand. **Never write mirror content as "verified against the filing".**
+
 ## Hard rules
 
 - **Every item carries the filing link and the filed date** -- the filed date, not the period end.

package/.opencode/command/alpha.md

@@ -1,6 +1,6 @@
 ---
 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
+argument-hint: [ticker] [fast|slow|quick|screen|market|options|news] · or just a question
 ---
 
 # /alpha
@@ -12,7 +12,8 @@ Request: **$ARGUMENTS**
 | `$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. Plugin-managed headless has a hard 30-minute queue-to-terminal bound; visible-host execution does not. |
+| a ticker alone, or a question | **Full council** at the `normal` pace. Go to "Full council" below. Plugin-managed headless is bound by the selected pace; visible-host execution has no bound at all. |
+| ticker + `fast` / `slow` / `deep` | Full council with that tier **prefilled**. Still show the pace menu and take the answer, exactly as with a named master. |
 | ticker + `quick` | The plugin-managed headless `quick_v1` council: 4 fixed analysts, 1-4 selected methods, one parallel bull/bear round and a short PM inside a hard 10-minute ceiling. |
 | ticker + `screen` | `screen_ticker` only. No language-model judgment, no subagents. |
 | ticker + `options` | `get_options_chain` only. |
@@ -22,15 +23,22 @@ Request: **$ARGUMENTS**
 When `$ARGUMENTS` is empty, print exactly this and stop:
 
 ```
-/alpha <TICKER>          full council — shows every master; headless run is bounded <=30m
+/alpha <TICKER>          full council — asks how deep to go, then shows every master
+/alpha <TICKER> fast     same, with the 15-minute tier prefilled
+/alpha <TICKER> slow     same, with the 60-minute tier prefilled
 /alpha <TICKER> quick    quick_v1: 4 analysts incl. news + 1-4 masters + 1 parallel debate round (<=10m)
 /alpha <TICKER> screen   mechanical filings screen only        (no model spend)
 /alpha <TICKER> options  IV term structure, skew, positioning  (no model spend)
 /alpha <TICKER> news     dated filings and headlines           (no model spend)
 /alpha market <theme>    what the market is talking about      (no model spend)
 
+you do not have to type a speed: the run asks, and shows the predicted time for each
+tier. all three tiers are the same full_v2 contract at three depths; quick is a SMALLER
+contract (4 analysts, 1 debate round) and is never full-equivalent
+
 examples
   /alpha AAPL            /alpha 0700.HK quick     /alpha 7203.T news
+  /alpha NVDA slow       /alpha MSFT fast
   /alpha NVDA screen     /alpha market rates      /alpha "is TSM cheap?"
 ```
 
@@ -51,24 +59,40 @@ the same in Claude Code, Codex, OpenCode and Grok Build.
 1. Call `begin_council_selection` with the symbol, original request, language, host and the
    intended `council_mode` (`full` by default; exactly `quick` for quick mode). If
    the request explicitly names masters, also pass those stable IDs as
-   `preselected_master_ids`; this highlights them but does not confirm them.
-2. Show **every returned master individually, in the returned order and with its stable
+   `preselected_master_ids`; if it named a speed, pass `council_pace`. Both highlight a choice
+   without confirming it.
+2. **Ask how deep to go first**, from the returned `pace_options`. It is a three-option
+   question and the catalog is long, so it goes above the catalog. Show BOTH numbers per tier
+   — the expected time and the hard ceiling — because a ceiling alone reads as the estimate:
+
+   ```
+   本次分析要跑多深？（默认 2）
+     1. 快速   预计 ~12 分钟（上限 15）  每证据席 3.5 分钟，每轮辩论每侧 90 秒
+     2. 标准   预计 ~20 分钟（上限 30）  每证据席 6 分钟，每轮辩论每侧 150 秒   ← 默认
+     3. 深入   预计 ~44 分钟（上限 60）  每证据席 12 分钟，每轮辩论每侧 360 秒
+   三档都是完整评议：同样 8 个证据席、同样三轮辩论、同样 PM，只是每席能想多久不同。
+   ```
+
+   Quick returns an empty menu and rejects the field; say so rather than offering a tier.
+3. Show **every returned master individually, in the returned order and with its stable
    number**. Each row must include `identity`, `method`, `best_for` and `maturity`; a school
    name or a count is not a substitute for the individual catalog.
-3. Ask for one submission. In full mode accept one number from `1..N`, combinations,
+4. Ask for one submission covering both the tier and the seats. In full mode accept one number from `1..N`, combinations,
    ranges, stable IDs/names, or `all`. In quick mode the same complete 26-seat catalog is
    displayed, but the submission must contain **1..4 seats** and `all` / `select_all` is
    forbidden. A host-native multi-select is a convenience only. If it is unavailable or
    cannot show the full catalog, use the numbered text table and plain reply on every host.
-4. If the original full-mode request already named masters or said `all`, prefill that choice but
+5. If the original full-mode request already named masters or said `all`, prefill that choice but
    **still show the full catalog and require this run's submission**. Do not silently reuse a
    prior choice. For quick, prefill at most four named methods and ask the user to reduce an
    oversized/`all` request to 1-4. The submitted choice is the confirmation; do not ask a
    second confirmation.
-5. Call `confirm_master_selection` with the returned `selection_id`, `catalog_hash`,
-   `display_ack: true`, and exactly one of `selected_master_ids`, `select_all: true`, or
-   `selection`. Retain the returned one-use `selection_receipt`.
-6. Only now call `plan_visible_run` (full only), `collect_evidence` (full only), or
+6. Call `confirm_master_selection` with the returned `selection_id`, `catalog_hash`,
+   `display_ack: true`, the answered `council_pace` (omit to accept `normal`), and exactly one
+   of `selected_master_ids`, `select_all: true`, or `selection`. Retain the returned
+   one-use `selection_receipt`. The pace binds into it: an execution call may repeat the confirmed tier
+   but never change it, so a user who approved 15 minutes cannot end up running an hour.
+7. Only now call `plan_visible_run` (full only), `collect_evidence` (full only), or
    `analyze_symbol`, passing that `selection_receipt` and the same symbol, prompt, language
    and `council_mode`. Quick must use `analyze_symbol`. Do not also pass `masters` or
    `masters_roster`; the receipt is authoritative and mode-bound. A full receipt cannot start
@@ -97,14 +121,19 @@ master-selection contract.
    fails after its bounded parse repair, do not spend more model calls on masters, bull/bear
    or PM. Persist an `incomplete` run naming the failed evidence and skipped downstream roles.
 7. For the hard runtime contract, call plugin-managed headless `analyze_symbol` once with
-   `council_mode:"full"`, `wait_for_completion:false`, the full-mode receipt and optionally
-   `total_timeout_ms` no greater than `1800000`. Poll the same durable `run_id` to terminal.
-   All eight mandatory evidence roles start in one wave; every selected v3 method gets a
-   frozen deterministic stance plus its own isolated voice worker; Bull/Bear run in parallel
-   within each of three rounds with a barrier between rounds; then the PM runs. Queueing,
-   retries and final persistence share the 30-minute clock. At expiry the saved run is
-   `incomplete`, never silently shortened or relabeled complete. This guarantees terminal
-   persistence, not all-seat success during search/model/data-provider degradation.
+   `council_mode:"full"`, `wait_for_completion:false`, the full-mode receipt, and
+   `council_pace` when the arguments asked for a speed: `fast` for 15 minutes, `slow` (or
+   `deep`) for 60, omitted for the 30-minute default. Poll the same durable `run_id` to
+   terminal. All eight mandatory evidence roles start in one wave; every selected v3 method
+   gets a frozen deterministic stance plus its own isolated voice worker; Bull/Bear run in
+   parallel within each of three rounds with a barrier between rounds; then the PM runs.
+   Queueing, retries and final persistence share the selected tier's clock. At expiry the
+   saved run is `incomplete`, never silently shortened or relabeled complete. This guarantees
+   terminal persistence, not all-seat success during search/model/data-provider degradation.
+   Pass `total_timeout_ms` only to LOWER the tier's budget; above it the call is rejected.
+   Tell the user which pace ran and what it bought: the tier raises every per-stage cap, so
+   `slow` gives each evidence seat 12 minutes instead of 6 and each debate round 6 minutes per
+   side instead of 150 seconds. All three paces are the same `full_v2` contract.
 8. `plan_visible_run` is owned by the external host. The plugin cannot force-stop its Task
    agents, so visible-host full must not be advertised as meeting the 30-minute deadline.
 9. The terminal full handoff must include the system price snapshot (or explicit unavailable