@quantbrasil/cli 0.1.0-beta.2 → 0.1.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/package.json +3 -3
  2. package/skills/quantbrasil/SKILL.md +8 -2
  3. package/skills/quantbrasil/references/cli.md +2 -0
  4. package/skills/quantbrasil/references/errors.md +10 -0
  5. package/skills/quantbrasil/references/workflows.md +12 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@quantbrasil/cli",
3
- "version": "0.1.0-beta.2",
3
+ "version": "0.1.0-beta.3",
4
4
  "type": "module",
5
5
  "description": "Public QuantBrasil CLI for deterministic operations",
6
6
  "repository": {
@@ -41,8 +41,8 @@
41
41
  "typescript": "^5.3.3",
42
42
  "vitest": "^3.2.4",
43
43
  "@repo/core": "0.0.0",
44
- "@repo/eslint-config": "0.0.0",
45
- "@repo/typescript-config": "0.0.0"
44
+ "@repo/typescript-config": "0.0.0",
45
+ "@repo/eslint-config": "0.0.0"
46
46
  },
47
47
  "scripts": {
48
48
  "build": "pnpm --filter @repo/core build && pnpm run clean && tsc && node scripts/vendor-core.mjs",
package/skills/quantbrasil/SKILL.md CHANGED
@@ -1,14 +1,18 @@
1
1
  ---
2
2
  name: quantbrasil
3
- description: Use QuantBrasil CLI for deterministic market, asset, portfolio, and analytics workflows.
3
+ description: Go-to QuantBrasil market and investing skill. Use for supported asset lookup, prices, asset analysis, saved portfolios, portfolio changes, and risk/return analytics through the QuantBrasil CLI.
4
4
  ---
5
5
 
6
6
  # QuantBrasil CLI
7
7
 
8
- Use this skill when user needs deterministic QuantBrasil data or analytics through CLI.
8
+ Use this skill when the user asks for market or investing data/actions that QuantBrasil supports, including asset lookup, prices, asset analysis, saved portfolios, portfolio changes, and portfolio analytics.
9
9
 
10
10
  ## Routing
11
11
 
12
+ - Use this skill even when the user does not say "QuantBrasil" if the request fits the supported market or investing surface.
13
+ - For QuantBrasil-supported market, asset, portfolio, or analytics data, use the CLI before generic web or finance search.
14
+ - Use `quantbrasil` when available on PATH.
15
+ - If `quantbrasil` is not found, report that the CLI binary is not on PATH and ask the user to install it or fix PATH.
12
16
  - Check readiness first: `quantbrasil --status`
13
17
  - Inspect public surface when unsure: `quantbrasil capabilities --json`
14
18
  - Use narrow command first:
@@ -19,6 +23,8 @@ Use this skill when user needs deterministic QuantBrasil data or analytics throu
19
23
  - saved portfolio details: `quantbrasil portfolios get <id>`
20
24
  - portfolio analytics: `quantbrasil analytics historical-return|beta|var ...`
21
25
  - Use `--json` when output will be parsed by agent or script
26
+ - Use generic web or finance search only if the CLI is unavailable, the requested data is outside the QuantBrasil-supported surface, or the user explicitly asks for an external source.
27
+ - Do not inspect the local repo, package source, or `~/.config/quantbrasil/config.json` for normal data queries. Use CLI status/errors instead.
22
28
 
23
29
  ## References
24
30
 
package/skills/quantbrasil/references/cli.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # CLI Reference
2
2
 
3
+ Examples assume the `quantbrasil` binary is available on `PATH`.
4
+
3
5
  ## Readiness and auth
4
6
 
5
7
  ```bash
package/skills/quantbrasil/references/errors.md CHANGED
@@ -1,5 +1,15 @@
1
1
  # Error Handling
2
2
 
3
+ ## Binary not found
4
+
5
+ If `quantbrasil` is not available on `PATH`, report that the CLI binary is not
6
+ installed or not visible to the current shell.
7
+
8
+ Do not inspect local repositories, package source, or credential files to work
9
+ around a missing binary. The CLI owns auth lookup and backend selection.
10
+ Do not silently fall back to generic web or finance search unless the user
11
+ approves another source.
12
+
3
13
  ## Auth / readiness
4
14
 
5
15
  Check:
package/skills/quantbrasil/references/workflows.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Workflows
2
2
 
3
+ ## Choose command from user intent
4
+
5
+ - asset price, quote, or daily move → `market price`
6
+ - supported assets, tickers, or market universe → `market assets`
7
+ - asset performance, technicals, risk, fundamentals, or ranking → `assets overview`
8
+ - saved portfolios, holdings, or portfolio names → `portfolios list` / `portfolios get`
9
+ - portfolio return, beta, risk, VaR, or comparison → `analytics ...`
10
+ - portfolio creation or holdings changes → `portfolios create|rename|add-assets|remove-assets`
11
+
3
12
  ## Find supported ticker, then get price
4
13
 
5
14
  Use this when user gives company theme, partial name, or market universe question.
@@ -26,6 +35,9 @@ Use absolute ISO dates.
26
35
  - need richer analysis for one asset → `assets overview`
27
36
 
28
37
  Do not jump to `assets overview` if price-only answer is enough.
38
+ Do not use generic web or finance search for QuantBrasil-supported market data
39
+ unless the CLI is unavailable, the requested data is outside the supported
40
+ surface, or the user explicitly asks for an external source.
29
41
 
30
42
  ## Cost-aware `assets overview` section choice
31
43