@botbotgo/kit-builtin 0.0.92 → 0.0.94

package/README.md

@@ -80,3 +80,19 @@ Explanation:
 - `fs.listDir.maxEntries` and `fs.listDir.maxDepth`: directory traversal limits.
 - `http.fetchJson.timeoutMs`: request timeout for HTTP JSON fetches.
 - `exec.runCommand.allowedCommands`: shell commands allowed by the built-in exec tool.
+
+## Configuration
+
+`@botbotgo/kit-builtin` publishes two different asset types:
+
+- `dist/`: compiled tool implementation and embedded `config/tool.yaml`
+- `skills/`: built-in skills, including `SKILL.md`, `scripts/`, `references/`, and templates
+
+Recommended layout when adding new built-ins:
+
+- Put TypeScript implementation that should be compiled, tested, and versioned as runtime code under `src/`
+- Put skill instructions and static skill-owned assets under `skills/<skill-name>/`
+- Keep `SKILL.md` focused on workflow and orchestration, not large inline code blocks
+- If a skill needs Node.js code, prefer a checked-in script file and call it from `SKILL.md`
+- Declare Node.js dependencies once in this package's top-level `dependencies`, not inside individual skill folders
+- If a skill grows heavy or needs isolated dependency/version management, promote it into its own package instead of expanding `@botbotgo/kit-builtin`

package/dist/core-tools-manifest.json

@@ -4720,6 +4720,111 @@
       "exportName": "yahooFinanceQuote",
       "sideEffect": "none"
     },
+    {
+      "name": "yahooFinanceNews",
+      "description": "Fetch Yahoo Finance news items by symbol or query.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string"
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "newsCount": {
+            "type": "number"
+          },
+          "timeoutMs": {
+            "type": "number"
+          },
+          "maxBytes": {
+            "type": "number"
+          }
+        }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "result": {
+            "type": "object",
+            "properties": {
+              "query": {
+                "type": "string"
+              },
+              "count": {
+                "type": "number"
+              },
+              "news": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "title": {
+                      "type": "string"
+                    },
+                    "link": {
+                      "type": "string"
+                    },
+                    "publisher": {
+                      "type": "string"
+                    },
+                    "publishedAt": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "title",
+                    "link"
+                  ]
+                }
+              }
+            },
+            "required": [
+              "query",
+              "count",
+              "news"
+            ]
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string"
+                },
+                "ref": {
+                  "type": "string"
+                },
+                "summary": {
+                  "type": "string"
+                },
+                "createdAt": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "ref",
+                "summary",
+                "createdAt"
+              ]
+            }
+          }
+        },
+        "required": [
+          "result",
+          "evidence"
+        ]
+      },
+      "sourcePath": "src/http/yahooFinanceNews",
+      "exportName": "yahooFinanceNews",
+      "sideEffect": "none"
+    },
     {
       "name": "messagesFindChatsByParticipant",
       "description": "Find Messages chats by participant handle or chat name.",

package/dist/src/http/yahooFinance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yahooFinance.d.ts","sourceRoot":"","sources":["../../../src/http/yahooFinance.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2ID;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;GAoCA"}
+{"version":3,"file":"yahooFinance.d.ts","sourceRoot":"","sources":["../../../src/http/yahooFinance.ts"],"names":[],"mappings":"AAyCA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA4ID;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;GAoCA"}

package/dist/src/http/yahooFinance.js.map

@@ -1 +1 @@
-{"version":3,"file":"yahooFinance.js","sourceRoot":"","sources":["../../../src/http/yahooFinance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"yahooFinance.js","sourceRoot":"","sources":["../../../src/http/yahooFinance.ts"],"names":[],"mappings":"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"}

package/dist/src/http/yahooFinanceNews.d.ts

@@ -0,0 +1,32 @@
+export interface YahooNewsItem {
+    title: string;
+    link: string;
+    publisher?: string;
+    publishedAt?: string;
+    type?: string;
+}
+/**
+ * Fetch Yahoo Finance news items by symbol or query.
+ * @tool
+ * @effect none
+ */
+export declare function yahooFinanceNews(args: {
+    query?: string;
+    symbol?: string;
+    newsCount?: number;
+    timeoutMs?: number;
+    maxBytes?: number;
+}): Promise<{
+    result: {
+        query: string;
+        count: number;
+        news: YahooNewsItem[];
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=yahooFinanceNews.d.ts.map

package/dist/src/http/yahooFinanceNews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yahooFinanceNews.d.ts","sourceRoot":"","sources":["../../../src/http/yahooFinanceNews.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA2HD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;GA8BA"}

package/dist/src/http/yahooFinanceNews.js

@@ -0,0 +1,137 @@
+import { getExtensionContext } from "../../index.js";
+import { DEFAULT_TIMEOUT_MS, DEFAULT_MAX_HTTP_BYTES, DEFAULT_HTTP_USER_AGENT, DEFAULT_BLOCKED_CIDRS, } from "./defaults.js";
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { validateUrl } from "../platform/securityCompat.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+const YAHOO_SEARCH_BASE = "https://query2.finance.yahoo.com/v1/finance/search";
+function getYahooConfig() {
+    const defaults = {
+        timeoutMs: DEFAULT_TIMEOUT_MS,
+        maxBytes: DEFAULT_MAX_HTTP_BYTES,
+        userAgent: DEFAULT_HTTP_USER_AGENT,
+        blockedCidrs: DEFAULT_BLOCKED_CIDRS,
+        allowedHosts: [],
+        blockedHosts: [],
+    };
+    const cfg = overrideWithConfig(defaults, getExtensionContext().config);
+    return {
+        timeoutMs: cfg.timeoutMs ?? defaults.timeoutMs,
+        maxBytes: cfg.maxBytes ?? defaults.maxBytes,
+        userAgent: cfg.userAgent ?? defaults.userAgent,
+        blockedCidrs: Array.isArray(cfg.blockedCidrs) ? cfg.blockedCidrs : defaults.blockedCidrs,
+        allowedHosts: Array.isArray(cfg.allowedHosts) ? cfg.allowedHosts : defaults.allowedHosts,
+        blockedHosts: Array.isArray(cfg.blockedHosts) ? cfg.blockedHosts : defaults.blockedHosts,
+    };
+}
+function normalizeYahooNewsInput(args) {
+    const query = (args.query ?? args.symbol ?? "").trim();
+    if (!query) {
+        throw createTaggedError("YAHOO_INVALID", "query or symbol is required", {});
+    }
+    const rawCount = typeof args.newsCount === "number" ? args.newsCount : 10;
+    const newsCount = Math.max(1, Math.min(50, Math.floor(rawCount)));
+    return { query, newsCount };
+}
+async function fetchYahooSearchJson(args) {
+    const url = `${YAHOO_SEARCH_BASE}?q=${encodeURIComponent(args.query)}&quotesCount=0&newsCount=${args.newsCount}`;
+    await validateUrl(url, {
+        allowedHosts: args.allowedHosts,
+        blockedHosts: args.blockedHosts,
+        blockedCidrs: args.blockedCidrs,
+    });
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), args.timeoutMs);
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "GET",
+            headers: { "User-Agent": args.userAgent, Accept: "application/json" },
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        clearTimeout(timer);
+        if (err instanceof Error && err.name === "AbortError") {
+            throw createTaggedError("HTTP_TIMEOUT", `Yahoo Finance search for ${args.query} timed out after ${args.timeoutMs}ms`, {
+                query: args.query,
+                timeoutMs: args.timeoutMs,
+            });
+        }
+        throw createTaggedError("UPSTREAM_ERROR", `Yahoo Finance search failed: ${err instanceof Error ? err.message : String(err)}`, {
+            query: args.query,
+        });
+    }
+    clearTimeout(timer);
+    const text = await response.text();
+    const bytes = Buffer.byteLength(text, "utf-8");
+    if (bytes > args.maxBytes) {
+        throw createTaggedError("HTTP_TOO_LARGE", `Yahoo Finance search response ${bytes} bytes exceeds limit of ${args.maxBytes} bytes`, {
+            query: args.query,
+            bytes,
+            limit: args.maxBytes,
+        });
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw createTaggedError("UPSTREAM_ERROR", "Yahoo Finance search returned invalid JSON", {
+            query: args.query,
+            textPreview: text.slice(0, 200),
+        });
+    }
+}
+function toYahooNewsItems(response) {
+    const items = Array.isArray(response.news) ? response.news : [];
+    return items
+        .filter((item) => typeof item?.title === "string" && typeof item?.link === "string")
+        .map((item) => {
+        const publishedAt = typeof item.providerPublishTime === "number"
+            ? new Date(item.providerPublishTime * 1000).toISOString()
+            : undefined;
+        return {
+            title: String(item.title),
+            link: String(item.link),
+            publisher: typeof item.publisher === "string" ? item.publisher : undefined,
+            publishedAt,
+            type: typeof item.type === "string" ? item.type : undefined,
+        };
+    });
+}
+/**
+ * Fetch Yahoo Finance news items by symbol or query.
+ * @tool
+ * @effect none
+ */
+export async function yahooFinanceNews(args) {
+    const cfg = getYahooConfig();
+    const { query, newsCount } = normalizeYahooNewsInput(args);
+    const timeoutMs = args.timeoutMs ?? cfg.timeoutMs;
+    const maxBytes = args.maxBytes ?? cfg.maxBytes;
+    const data = await fetchYahooSearchJson({
+        query,
+        newsCount,
+        timeoutMs,
+        maxBytes,
+        userAgent: cfg.userAgent,
+        allowedHosts: cfg.allowedHosts,
+        blockedHosts: cfg.blockedHosts,
+        blockedCidrs: cfg.blockedCidrs,
+    });
+    const news = toYahooNewsItems(data);
+    const ref = `${YAHOO_SEARCH_BASE}?q=${encodeURIComponent(query)}&quotesCount=0&newsCount=${newsCount}`;
+    return {
+        result: {
+            query,
+            count: news.length,
+            news,
+        },
+        evidence: [{
+                type: "url",
+                ref,
+                summary: `Yahoo Finance news: ${query} (${news.length} item(s))`,
+                createdAt: new Date().toISOString(),
+            }],
+    };
+}
+//# sourceMappingURL=yahooFinanceNews.js.map

package/dist/src/http/yahooFinanceNews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yahooFinanceNews.js","sourceRoot":"","sources":["../../../src/http/yahooFinanceNews.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/kit-builtin",
-  "version": "0.0.92",
+  "version": "0.0.94",
   "description": "Tools extension for @botbotgo/kit: FS, HTTP, util, security (sandbox, SSRF). Same contract as any other extension.",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,13 +18,15 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "scripts": {
     "preinstall": "node -e \"const fs=require('fs'); const {execSync}=require('child_process'); if (fs.existsSync('scripts/resolve-deps.js')) { execSync('node scripts/resolve-deps.js', { stdio: 'inherit' }); } else { console.log('Skipping resolve-deps for published package'); }\"",
     "prebuild": "npm run build --prefix ../kit 2>/dev/null || true",
-    "build": "npm run check:tool-files && tsx generate-manifest.ts && tsc -p tsconfig.build.json && (mkdir -p dist/config && cp config/tool.yaml dist/config/tool.yaml)",
+    "build": "npm run check:tool-files && npm run check:skill-assets && tsx generate-manifest.ts && tsc -p tsconfig.build.json && (mkdir -p dist/config && cp config/tool.yaml dist/config/tool.yaml)",
     "check:tool-files": "tsx scripts/check-tool-files.ts",
+    "check:skill-assets": "tsx scripts/check-skill-assets.ts",
     "clean": "rm -rf dist",
     "pretest": "npm run build",
     "test": "vitest run",

package/skills/company-report/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: company-report
+description: Generate structured JSON company report data for a target company/ticker.
+---
+
+# Company Report Workflow (JSON + HTML)
+
+Write these files:
+
+- `output/company-report.json` (generated by model)
+- `output/company-report.html` (generated by script call)
+
+## Inputs
+
+- `COMPANY` (required)
+- `SYMBOL` (preferred)
+
+If `COMPANY` is missing, ask one clarifying question.
+
+## Workflow (in order)
+
+1. Resolve `COMPANY` and `SYMBOL`.
+2. Fetch quote with exact args:
+   `yahooFinanceQuote({"symbol":"<SYMBOL>"})`
+3. Fetch news with exact args:
+   `yahooFinanceNews({"symbol":"<SYMBOL>","newsCount":5})`
+4. If news is empty/failed, retry `yahooFinanceNews` once with `query=COMPANY`.
+5. Write `output/company-report.json` after quote+news steps have been attempted.
+6. Call execute tool to run:
+   `node scripts/merge-report.mjs output/company-report.json output/company-report.html references/company-report.template.html`
+
+Notes:
+
+- Quote/news calls are independent and can run in parallel.
+- Do not perform unrelated exploration.
+- Do not handwrite HTML content directly.
+- Do not call `glob` or `inspect files`.
+- Do not re-read output files after writing.
+- Write `output/company-report.json` exactly once.
+- Run merge script exactly once.
+- After merge succeeds, stop.
+
+## Output Schema
+
+```json
+{
+  "company": {
+    "name": "string",
+    "symbol": "string",
+    "generatedAt": "YYYY-MM-DD"
+  },
+  "overview": ["paragraph1", "paragraph2"],
+  "stock": {
+    "available": true,
+    "summary": "string",
+    "metrics": {
+      "symbol": "string",
+      "price": 0,
+      "change": 0,
+      "changePercent": 0,
+      "dayLow": 0,
+      "dayHigh": 0,
+      "volume": 0,
+      "currency": "USD"
+    }
+  },
+  "news": [
+    {
+      "headline": "string",
+      "url": "https://...",
+      "source": "string",
+      "date": "YYYY-MM-DD",
+      "summary": "string"
+    }
+  ],
+  "sources": [
+    {
+      "name": "string",
+      "url": "https://..."
+    }
+  ]
+}
+```
+
+## Failure Policy
+
+- If quote fetch fails: set `stock.available=false` and provide placeholders.
+- If all news fetches fail/empty: set `news=[]`.
+- Never skip JSON generation because of partial data failure.
+- Always run merge script after JSON is written.

package/skills/company-report/references/company-report.template.html

@@ -0,0 +1,151 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Company Report Viewer</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com" />
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+  <link href="https://fonts.googleapis.com/css2?family=Manrope:wght@400;600;700;800&display=swap" rel="stylesheet" />
+  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/css/bootstrap.min.css" rel="stylesheet" />
+  <style>
+    :root {
+      --bg: #f4f7fb;
+      --ink: #13253a;
+      --muted: #5f738c;
+      --brand: #0f4c81;
+      --brand-soft: #e6eef7;
+      --card-border: #d7e2ef;
+    }
+    body { font-family: "Manrope", "Segoe UI", sans-serif; color: var(--ink); background: var(--bg); }
+    .report-wrap { max-width: 1080px; margin: 0 auto; padding: 2rem 1rem 3rem; }
+    .hero { background: linear-gradient(135deg, #0f4c81 0%, #1a6aa8 100%); color: #fff; border-radius: 1rem; padding: 1.25rem; margin-bottom: 1.25rem; }
+    .section-card { background: #fff; border: 1px solid var(--card-border); border-radius: .9rem; margin-bottom: 1rem; overflow: hidden; }
+    .section-head { background: var(--brand-soft); color: var(--brand); font-weight: 800; text-transform: uppercase; letter-spacing: .04em; font-size: .78rem; padding: .7rem 1rem; }
+    .section-body { padding: 1rem; }
+    .news-item + .news-item { margin-top: .75rem; }
+    .news-link { font-weight: 700; color: #15395f; text-decoration: none; }
+    .news-link:hover { text-decoration: underline; }
+    .news-meta { color: var(--muted); font-size: .85rem; }
+    .error-box { border: 1px solid #f0b4b4; background: #fff2f2; color: #862b2b; border-radius: .75rem; padding: .75rem 1rem; }
+  </style>
+</head>
+<body>
+  <main class="report-wrap">
+    <header class="hero">
+      <h1 id="hero-title" class="h2 m-0">Company Report</h1>
+      <p id="hero-date" class="m-0" style="opacity:.9;">Generated: -</p>
+    </header>
+
+    <section id="company-overview" class="section-card">
+      <div class="section-head">1. Company Overview</div>
+      <div id="overview-body" class="section-body"></div>
+    </section>
+
+    <section id="stock-data" class="section-card">
+      <div class="section-head">2. Stock Data</div>
+      <div class="section-body">
+        <p id="stock-summary" class="news-meta"></p>
+        <div class="table-responsive">
+          <table class="table table-striped table-hover align-middle mb-0">
+            <thead><tr><th>Metric</th><th>Value</th></tr></thead>
+            <tbody id="stock-table-body"></tbody>
+          </table>
+        </div>
+      </div>
+    </section>
+
+    <section id="news" class="section-card">
+      <div class="section-head">3. Recent News</div>
+      <div id="news-body" class="section-body"></div>
+    </section>
+
+    <section id="sources" class="section-card">
+      <div class="section-head">4. Sources</div>
+      <div class="section-body"><ul id="sources-list" class="list-unstyled mb-0"></ul></div>
+    </section>
+
+    <div id="error" class="error-box d-none"></div>
+  </main>
+
+  <script>
+    const REPORT_DATA = __REPORT_JSON__;
+
+    function esc(v) {
+      return String(v ?? "")
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+    }
+
+    function num(v, digits = 2) {
+      return typeof v === "number" && Number.isFinite(v)
+        ? v.toLocaleString("en-US", { minimumFractionDigits: digits, maximumFractionDigits: digits })
+        : "Not available";
+    }
+
+    function int(v) {
+      return typeof v === "number" && Number.isFinite(v)
+        ? v.toLocaleString("en-US")
+        : "Not available";
+    }
+
+    function renderReport(data) {
+      const errorEl = document.getElementById("error");
+      try {
+        const company = data.company ?? {};
+        const stock = data.stock ?? {};
+        const metrics = stock.metrics ?? {};
+        const stockAvailable = stock.available === true;
+
+        document.getElementById("hero-title").textContent = `Company Report: ${company.name ?? "Unknown"}`;
+        document.getElementById("hero-date").textContent = `Generated: ${company.generatedAt ?? "-"}`;
+
+        const overview = Array.isArray(data.overview) ? data.overview : [];
+        const overviewBody = document.getElementById("overview-body");
+        overviewBody.innerHTML = overview.length
+          ? overview.map((p) => `<p>${esc(p)}</p>`).join("")
+          : `<p class="news-meta">Overview not available.</p>`;
+
+        document.getElementById("stock-summary").textContent = stock.summary ?? "Stock summary not available.";
+        const stockRows = [
+          ["Symbol", metrics.symbol ?? company.symbol ?? "N/A"],
+          ["Price", stockAvailable ? num(metrics.price) : "Not available"],
+          ["Change", (stockAvailable && typeof metrics.change === "number" && typeof metrics.changePercent === "number")
+            ? `${metrics.change >= 0 ? "+" : ""}${num(metrics.change)} (${metrics.changePercent >= 0 ? "+" : ""}${num(metrics.changePercent)}%)`
+            : "Not available"],
+          ["Day Range", stockAvailable ? `${num(metrics.dayLow)} - ${num(metrics.dayHigh)}` : "Not available"],
+          ["Volume", stockAvailable ? int(metrics.volume) : "Not available"],
+        ];
+        document.getElementById("stock-table-body").innerHTML = stockRows
+          .map(([k, v]) => `<tr><td>${esc(k)}</td><td>${esc(v)}</td></tr>`)
+          .join("");
+
+        const news = Array.isArray(data.news) ? data.news : [];
+        const newsBody = document.getElementById("news-body");
+        newsBody.innerHTML = news.length
+          ? news.map((n) => `
+            <div class="news-item">
+              <a class="news-link" href="${esc(n.url ?? "#")}">${esc(n.headline ?? "Untitled")}</a>
+              <div class="news-meta">${esc(n.source ?? "Unknown")}${n.date ? ` • ${esc(n.date)}` : ""}</div>
+              ${n.summary ? `<div class="news-meta mt-1">${esc(n.summary)}</div>` : ""}
+            </div>
+          `).join("")
+          : `<div class="news-meta">No recent news found.</div>`;
+
+        const sources = Array.isArray(data.sources) ? data.sources : [];
+        document.getElementById("sources-list").innerHTML = sources.length
+          ? sources.map((s) => `<li><a href="${esc(s.url ?? "#")}">${esc(s.name ?? "Source")}</a></li>`).join("")
+          : `<li>No sources available.</li>`;
+      } catch (err) {
+        errorEl.classList.remove("d-none");
+        errorEl.textContent = err instanceof Error ? err.message : String(err);
+      }
+    }
+
+    renderReport(REPORT_DATA);
+  </script>
+</body>
+</html>

package/skills/company-report/scripts/merge-report.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { existsSync, realpathSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+
+export async function mergeReportHtml(jsonPath, htmlPath, templatePath) {
+  if (!existsSync(jsonPath)) {
+    throw new Error(`Missing JSON report: ${jsonPath}`);
+  }
+  if (!existsSync(templatePath)) {
+    throw new Error(`Missing HTML template: ${templatePath}`);
+  }
+
+  const report = JSON.parse(await readFile(jsonPath, "utf8"));
+  const template = await readFile(templatePath, "utf8");
+  const html = template.replace(/__REPORT_JSON__/g, JSON.stringify(report));
+  await writeFile(htmlPath, html, "utf8");
+}
+
+async function main() {
+  const root = process.cwd();
+  const jsonPath = resolve(root, process.argv[2] || "output/company-report.json");
+  const htmlPath = resolve(root, process.argv[3] || "output/company-report.html");
+  const templatePath = resolve(
+    root,
+    process.argv[4] || "skills/company-report/references/company-report.template.html",
+  );
+
+  await mergeReportHtml(jsonPath, htmlPath, templatePath);
+  process.stdout.write(`Merged report written to: ${htmlPath}\n`);
+}
+
+const entrypointUrl = process.argv[1] ? pathToFileURL(realpathSync(resolve(process.argv[1]))).href : "";
+
+if (import.meta.url === entrypointUrl) {
+  main().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+  });
+}

package/skills/project-prompt-ops/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: project-prompt-ops
+description: Execute project-scoped instructions by calling Codex, Claude, or Cursor shell CLI in prompt mode. Use when the user asks to create, update, query, or question a specific project through codex/claude/cursor command-line workflows.
+---
+
+# Project Prompt Ops
+
+Use shell prompt mode with exactly one provider and one mode per request.
+Allowed providers: `codex`, `claude`, `cursor`.
+Allowed modes: `create`, `update`, `query`, `question`.
+
+## Inputs
+
+- `PROJECT`: required project path
+- `INSTRUCTION`: required task instruction
+- `MODE`: optional explicit mode; infer if omitted
+- `PROVIDER`: optional explicit provider; infer if omitted
+
+If `PROJECT` is missing, ask one concise question and stop.
+
+## Required Reads
+
+1. `references/REQUEST_PATTERNS.md`
+
+## Selection Rules
+
+### Mode
+
+- `create`: add new files or new behavior
+- `update`: change existing behavior
+- `query`: inspect codebase without edits
+- `question`: answer technical question without edits
+
+When ambiguous, prefer lower-risk mode in this order:
+
+1. `query`
+2. `question`
+3. `update`
+4. `create`
+
+### Provider
+
+- If user explicitly names provider, use it.
+- Else default to `codex`.
+
+## Mandatory Execution Path
+
+Always invoke the script below. Do not directly call `codex`, `claude`, or `cursor-agent` in free-form.
+
+```bash
+skills/project-prompt-ops/scripts/run_prompt_mode.sh \
+  --provider <codex|claude|cursor> \
+  --mode <create|update|query|question> \
+  --project <project-path> \
+  --instruction "<user-instruction>"
+```
+
+Optional:
+
+- `--model <model-name>`
+- `--output <path>`
+- `--dry-run` (preview assembled command and prompt only)
+
+The script internally:
+
+1. Builds normalized prompt text with mode-specific constraints.
+2. Calls provider shell CLI in prompt mode:
+- `codex exec`
+- `claude -p`
+- `cursor-agent -p`
+3. Returns provider output.
+
+## Post-Run Requirements
+
+- For `create` and `update`, run a relevant local validation command in `PROJECT` when possible.
+- For `query` and `question`, do not edit project files.
+
+## Response Structure
+
+- `Mode`
+- `Provider`
+- `Project`
+- `Changes` or `Findings`
+- `Validation`
+- `Open Risks` (only when non-empty)
+
+## Constraints
+
+- Do not perform destructive operations unless explicitly requested.
+- Do not expand scope outside `PROJECT` unless asked.
+- Do not skip the wrapper script.
+- Keep output concise and implementation-focused.

package/skills/project-prompt-ops/references/REQUEST_PATTERNS.md

@@ -0,0 +1,56 @@
+# Request Patterns
+
+Use this file only when the user instruction is broad, mixed, or does not provide explicit mode labels.
+
+## Canonical Instruction Shape
+
+Normalize incoming instruction into:
+
+- `project`: absolute or repo-relative path
+- `mode`: create | update | query | question
+- `provider`: codex | claude | cursor
+- `goal`: one-sentence expected outcome
+- `constraints`: tests, style, compatibility, forbidden operations
+- `deliverable`: patch, answer, or findings format
+
+## Mode Heuristics
+
+- Mentions "add/new/build/implement" -> `create`
+- Mentions "fix/change/modify/refactor/adjust" -> `update`
+- Mentions "where/what/find/list/show" -> `query`
+- Mentions "why/how/should/explain/compare" -> `question`
+
+When multiple verbs appear, prioritize the user's final explicit ask.
+
+## Provider Heuristics
+
+- User explicitly says `codex` -> provider `codex`
+- User explicitly says `claude` -> provider `claude`
+- User explicitly says `cursor` -> provider `cursor`
+- If omitted -> default provider `codex`
+
+## Execution Command Template
+
+```bash
+skills/project-prompt-ops/scripts/run_prompt_mode.sh \
+  --provider "<provider>" \
+  --mode "<mode>" \
+  --project "<project>" \
+  --instruction "<goal>"
+```
+
+## Output Template
+
+Use this response shape:
+
+```text
+Mode: <mode>
+Project: <project>
+Changes|Findings:
+- ...
+Validation:
+- command: <cmd or N/A>
+- result: <pass/fail/not run>
+Open Risks:
+- ... (omit section when empty)
+```

package/skills/project-prompt-ops/scripts/build_prompt.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+MODE=""
+PROJECT=""
+INSTRUCTION=""
+
+usage() {
+  cat <<'EOF'
+Usage: build_prompt.sh --mode <create|update|query|question> --project <path> --instruction <text>
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --mode)
+      MODE="${2:-}"
+      shift 2
+      ;;
+    --project)
+      PROJECT="${2:-}"
+      shift 2
+      ;;
+    --instruction)
+      INSTRUCTION="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+done
+
+if [[ -z "$MODE" || -z "$PROJECT" || -z "$INSTRUCTION" ]]; then
+  usage >&2
+  exit 2
+fi
+
+case "$MODE" in
+  create)
+    MODE_RULE="Create new code/files as requested. Keep scope strictly inside project and wire minimal required integration points."
+    ;;
+  update)
+    MODE_RULE="Update existing code with minimal safe diffs. Preserve unrelated behavior and avoid broad refactors."
+    ;;
+  query)
+    MODE_RULE="Read and analyze only. Do not modify files. Return concrete findings with file path references."
+    ;;
+  question)
+    MODE_RULE="Answer the technical question directly. Do not modify files unless explicitly requested."
+    ;;
+  *)
+    echo "Invalid mode: $MODE" >&2
+    exit 2
+    ;;
+esac
+
+cat <<EOF
+You are running in ${MODE} mode for a single project.
+
+Project path:
+${PROJECT}
+
+User instruction:
+${INSTRUCTION}
+
+Rules:
+- ${MODE_RULE}
+- Stay within the specified project path.
+- Avoid destructive operations unless explicitly requested.
+- Keep response concise and implementation-focused.
+- If editing is performed (create/update), include a short validation result.
+
+Output format:
+- Mode: ${MODE}
+- Summary:
+- Details:
+- Validation:
+- Risks: (omit if none)
+EOF

package/skills/project-prompt-ops/scripts/run_prompt_mode.sh

@@ -0,0 +1,153 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+PROVIDER=""
+MODE=""
+PROJECT=""
+INSTRUCTION=""
+MODEL=""
+OUTPUT=""
+DRY_RUN="false"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  run_prompt_mode.sh \
+    --provider <codex|claude|cursor> \
+    --mode <create|update|query|question> \
+    --project <path> \
+    --instruction <text> \
+    [--model <model>] \
+    [--output <file>] \
+    [--dry-run]
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --provider)
+      PROVIDER="${2:-}"
+      shift 2
+      ;;
+    --mode)
+      MODE="${2:-}"
+      shift 2
+      ;;
+    --project)
+      PROJECT="${2:-}"
+      shift 2
+      ;;
+    --instruction)
+      INSTRUCTION="${2:-}"
+      shift 2
+      ;;
+    --model)
+      MODEL="${2:-}"
+      shift 2
+      ;;
+    --output)
+      OUTPUT="${2:-}"
+      shift 2
+      ;;
+    --dry-run)
+      DRY_RUN="true"
+      shift
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+done
+
+if [[ -z "$PROVIDER" || -z "$MODE" || -z "$PROJECT" || -z "$INSTRUCTION" ]]; then
+  usage >&2
+  exit 2
+fi
+
+if [[ ! -d "$PROJECT" ]]; then
+  echo "Project path not found: $PROJECT" >&2
+  exit 2
+fi
+
+PROJECT_ABS="$(cd "$PROJECT" && pwd)"
+
+PROMPT="$("$SCRIPT_DIR/build_prompt.sh" \
+  --mode "$MODE" \
+  --project "$PROJECT_ABS" \
+  --instruction "$INSTRUCTION")"
+
+if [[ "$DRY_RUN" == "true" ]]; then
+  echo "provider: $PROVIDER"
+  echo "mode: $MODE"
+  echo "project: $PROJECT_ABS"
+  if [[ -n "$MODEL" ]]; then
+    echo "model: $MODEL"
+  fi
+  echo "----- prompt begin -----"
+  echo "$PROMPT"
+  echo "----- prompt end -----"
+  exit 0
+fi
+
+run_and_capture() {
+  if [[ -n "$OUTPUT" ]]; then
+    mkdir -p "$(dirname "$OUTPUT")"
+    "$@" | tee "$OUTPUT"
+  else
+    "$@"
+  fi
+}
+
+case "$PROVIDER" in
+  codex)
+    if ! command -v codex >/dev/null 2>&1; then
+      echo "codex command not found" >&2
+      exit 127
+    fi
+    CMD=(codex exec --cd "$PROJECT_ABS")
+    if [[ -n "$MODEL" ]]; then
+      CMD+=(--model "$MODEL")
+    fi
+    CMD+=("$PROMPT")
+    run_and_capture "${CMD[@]}"
+    ;;
+  claude)
+    if ! command -v claude >/dev/null 2>&1; then
+      echo "claude command not found" >&2
+      exit 127
+    fi
+    CMD=(claude -p)
+    if [[ -n "$MODEL" ]]; then
+      CMD+=(--model "$MODEL")
+    fi
+    CMD+=("$PROMPT")
+    (
+      cd "$PROJECT_ABS"
+      run_and_capture "${CMD[@]}"
+    )
+    ;;
+  cursor)
+    if ! command -v cursor-agent >/dev/null 2>&1; then
+      echo "cursor-agent command not found" >&2
+      exit 127
+    fi
+    CMD=(cursor-agent -p --workspace "$PROJECT_ABS" --output-format text)
+    if [[ -n "$MODEL" ]]; then
+      CMD+=(--model "$MODEL")
+    fi
+    CMD+=("$PROMPT")
+    run_and_capture "${CMD[@]}"
+    ;;
+  *)
+    echo "Unsupported provider: $PROVIDER" >&2
+    exit 2
+    ;;
+esac