@haoxdong/marquee-cli 0.2.0

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@haoxdong/marquee-cli",
+  "version": "0.2.0",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "repository": "https://github.com/haoxdong/marquee-cli.git",
+  "type": "module",
+  "engines": {
+    "node": ">=20.16.0 <21 || >=22.3.0"
+  },
+  "bin": {
+    "marquee": "dist/cli.js"
+  },
+  "files": [
+    "dist/cli.js",
+    "skills",
+    "scripts",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "clean": "node -e \"const fs = require('node:fs'); for (const path of ['dist', 'tsconfig.tsbuildinfo']) fs.rmSync(path, { recursive: true, force: true })\"",
+    "build": "npm run clean && esbuild cli/main.ts --bundle --platform=node --format=esm --minify --external:agent-browser --banner:js=\"import{createRequire}from'node:module';const require=createRequire(import.meta.url);\" --outfile=dist/cli.js && node -e \"require('node:fs').chmodSync('dist/cli.js', 0o755)\"",
+    "build:coverage": "npm run clean && tsc -p tsconfig.json && node -e \"const fs = require('node:fs'); fs.writeFileSync('dist/cli.js', ['#!/usr/bin/env node', \\\"import './cli/main.js';\\\", ''].join('\\n')); fs.chmodSync('dist/cli.js', 0o755)\"",
+    "postinstall": "node scripts/install-skill.mjs",
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "agent-browser": "0.27.0",
+    "commander": "^14.0.0",
+    "proper-lockfile": "^4.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "@types/proper-lockfile": "^4.1.4",
+    "esbuild": "^0.27.4",
+    "typescript": "^5.8.2",
+    "vitest": "^3.2.4"
+  }
+}

package/scripts/install-skill.mjs

@@ -0,0 +1,94 @@
+import {
+  cpSync,
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  readFileSync,
+  readlinkSync,
+  realpathSync,
+  rmSync,
+  statSync,
+  writeFileSync,
+} from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const source = fileURLToPath(new URL('../skills/marquee', import.meta.url));
+const ownerMarker = '.marquee-cli-owner';
+const owner = '@haoxdong/marquee-cli';
+const packageSkillSuffix = '/node_modules/@haoxdong/marquee-cli/skills/marquee';
+const home = process.env.HOME ?? homedir();
+
+const agents = [
+  {
+    name: 'claude',
+    configDir: process.env.CLAUDE_CONFIG_DIR ?? resolve(home, '.claude'),
+    installWhenMissing: true,
+  },
+  {
+    name: 'codex',
+    configDir: resolve(home, '.agents'),
+  },
+];
+
+function selectedAgentNames() {
+  const configured = process.env.MARQUEE_SKILL_TARGETS;
+  if (configured === undefined) return undefined;
+  return new Set(configured.split(',').map((name) => name.trim()).filter(Boolean));
+}
+
+function packageOwns(target, installed) {
+  if (installed.isSymbolicLink()) {
+    try {
+      if (realpathSync(target) === realpathSync(source)) return true;
+    } catch {
+      // A package uninstall or npx cache cleanup can leave our old link broken.
+    }
+    try {
+      const linkedPath = resolve(dirname(target), readlinkSync(target)).replaceAll('\\', '/');
+      return linkedPath.endsWith(packageSkillSuffix);
+    } catch {
+      return false;
+    }
+  }
+  if (!installed.isDirectory()) return false;
+
+  try {
+    return readFileSync(resolve(target, ownerMarker), 'utf8').trim() === owner;
+  } catch (error) {
+    if (error?.code === 'ENOENT') return false;
+    throw error;
+  }
+}
+
+function install(agent) {
+  const configDirExists = existsSync(agent.configDir);
+  if (!configDirExists && !agent.installWhenMissing) return;
+  if (configDirExists && !statSync(agent.configDir).isDirectory()) return;
+
+  const target = resolve(agent.configDir, 'skills/marquee');
+  let installed;
+  try {
+    installed = lstatSync(target);
+  } catch (error) {
+    if (error?.code !== 'ENOENT') throw error;
+  }
+
+  if (installed && !packageOwns(target, installed)) {
+    console.warn(`Skipping marquee skill installation: ${target} already exists.`);
+    return;
+  }
+
+  if (installed) {
+    rmSync(target, { recursive: true, force: true });
+  }
+  mkdirSync(dirname(target), { recursive: true });
+  cpSync(source, target, { recursive: true, force: true });
+  writeFileSync(resolve(target, ownerMarker), `${owner}\n`);
+}
+
+const selected = selectedAgentNames();
+for (const agent of agents) {
+  if (!selected || selected.has(agent.name)) install(agent);
+}

package/skills/marquee/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: marquee
+description: Use when querying Marquee for market data, research content, or page interaction via the CLI.
+---
+
+## Response format
+
+**Authoritative.** State conclusions as facts. No hedging ("it seems", "appears to"). No emoji.
+
+**Direct.** Answer the question asked, nothing adjacent. Tables over paragraphs for structured data.
+
+**Concise.** Numbers over narrative. One sentence where one suffices; a table cell where a sentence would pad. Never restate the question. Most answers fit in 1-3 flat sentences — stop there. Only when genuinely multi-part:
+
+```
+### Summary
+Bottom line in 1-2 sentences.
+
+### More Details
+Supporting data, tables, and analysis.
+```
+
+Use exactly these two headers — no other sections, no renaming.
+
+**Counterweight.** Close with what could break the thesis — the key risk or the condition under which the narrative flips.
+
+**Citations.** Every factual claim gets a source URL — no exceptions, including bullets and table cells: `…widened 12bp [[1]](https://marquee.gs.com/s/markets/…)`. Never surface refs (`@s1`, `@wN`, `@wN.data`) — internal plumbing.
+
+## Core loop
+
+**Chain** refs — every command emits refs, the next consumes them.
+
+```
+marquee marketview search "query"        # → @s1 with widget refs
+marquee load @s1.w1                      # → @wN, @wN.data
+marquee eval @wN.data "data.filter(…)"   # extract from flat rows
+marquee expand @wN.data --tail 5         # peek at rows without code
+```
+
+Asset-level: `marquee marketview dashboard TICKER` → `@dN`, then `load @dN.w1`.
+
+Go straight to the best command; search only when genuinely ambiguous.
+
+## Refs
+
+Use the exact ref from the latest output — never hardcode. The global registry accumulates across commands.
+
+| Target | Shape | When |
+|--------|-------|------|
+| `@wN.data` | flat rows | row values — the data itself |
+| `@wN` | full payload | widget config, axis labels, param metadata |
+| `@s1` | search payload | filter/rank results before loading |
+
+### Changing parameters
+
+Load output shows each param's ref and verb (`[@name, select|fill|check]`):
+
+```
+marquee select @wN.universe Latam          # enum
+marquee fill @wN.pricingDate "2026-01-15"  # date/string
+marquee check @wN.includeInternal          # boolean toggle
+```
+
+## Content
+
+Research articles and market commentary:
+
+```
+marquee content search "query"                        # → @s1 with @s1.cmN / @s1.crN
+marquee content markets <uuid|url>                    # TFC → @cmN
+marquee content research <uuid|url>                   # GIR → @crN
+marquee content research <uuid> --date YYYY-MM-DD     # GIR by UUID + date
+marquee load @s1.cm1                                  # load from search ref
+```
+
+Paging: `next @cmN` / `prev @cmN`; full body: `expand @cmN`.
+
+## Execution
+
+Separate Bash tool calls run **sequentially**. All independent commands — searches, loads, evals — go in one Bash call with `&` + `wait`.
+
+**Hedge searches**: the search engine is noisy — run 2-3 query variations in parallel (`&` + `wait`) to increase hit rate.
+
+Search queries: precise, API-ready — include asset class (`EURUSD vol FX`), expand shorthand (`JPY` not `yen`), canonical terms (`risk reversal skew`).
+
+## Browser fallback
+
+When structured commands can't get the data:
+
+```
+marquee browser open <url>                           # navigate
+marquee browser snapshot                             # → @e1, @e2, …
+marquee browser click @e1                            # click
+marquee browser fill @e2 "value"                     # clear + type
+marquee browser get text @e1                         # read text
+marquee browser wait --load networkidle              # wait for page
+marquee browser network requests --type xhr,fetch    # list API calls
+marquee browser network request <id>                 # request detail
+```
+
+Snapshot → interact → re-snapshot. Use `network requests` for API debugging.