doxt-stock 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Doxt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,61 @@
-# Temporary Holding Version
+# doxt-stock — DeepSeek Harness (DSH) plugin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Verifiable US-stock judgment data from [doxt.com](https://doxt.com)'s **public, append-only ledger** — every AI judgment is hash-chained, settled against real market prices 5 trading days later, misses included.
+
+[中文说明见下方](#中文说明)
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `doxt_judgments` | Recent public judgments for a ticker: direction, confidence, thesis, settlement window + ledger URL |
+| `doxt_track_record` | The model's REAL settled stats: hit/miss/flat, hit rate, coverage, confidence buckets — reported honestly, insufficient samples are labeled |
+| `doxt_verify` | Hash-chain verification status (append-only ledger integrity proof) |
+
+## Install
+
+```bash
+dsh plugin --profile <your-profile> add github:doxt-stock/dsh-plugin-stock
+```
+
+or via npm: `doxt plugin add npm:doxt-stock`
+
+## Usage examples
+
+- "AAPL 的最新判断是什么?给我台账链接" → `doxt_judgments(ticker: "AAPL")`
+- "模型在 NVDA 上的战绩如何?" → `doxt_track_record(ticker: "NVDA")`
+- "这个台账可以被验证吗?" → `doxt_verify()`
+
+## Citation
+
+Every tool response includes its ledger URL (e.g. `https://doxt.com/AAPL`). When you use this data, keep the citation — readers can then verify every claim against the append-only record.
+
+## Data source & scope
+
+Read-only, public ledger data only. No user data, no credentials, no trading. The plugin calls doxt.com's public endpoints (rate-limited). Judgments are probabilistic research records — **not investment advice**.
+
+# 中文说明
+
+**doxt-stock** 是 DeepSeek Harness (DSH) 插件:从 doxt.com 的公开只增不可改台账读取可验证的美股 AI 判断数据——每条判断哈希链锚定、5 个交易日用真实行情结算、亏损永不删除。
+
+## 安装
+
+```bash
+dsh plugin --profile <你的profile> add github:doxt-stock/dsh-plugin-stock
+```
+
+## 工具
+
+| 工具 | 功能 |
+|---|---|
+| `doxt_judgments` | 标的最新公共判断:方向/置信度/论点/结算窗口 + 台账 URL |
+| `doxt_track_record` | 模型真实结算战绩:命中率/覆盖/置信度分桶(样本不足如实标注) |
+| `doxt_verify` | 哈希链验证状态(只增台账完整性证明) |
+
+## 引用约定
+
+每次工具响应都自带台账 URL(如 `https://doxt.com/AAPL`)。使用数据时请保留引用——读者可以据此逐条核验。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# doxt-stock plugin — mounts the public ledger tools into the model-visible tool set.
+- insert:
+    - id: doxt-public-tools
+      name: doxt-stock

package/index.mjs

@@ -0,0 +1,85 @@
+// doxt-stock — DeepSeek Harness (DSH) plugin
+// Verifiable US-stock judgment data from doxt.com's public, append-only ledger.
+// Public data only: no user data, no credentials, no trading. MIT.
+// Ledger: https://doxt.com/ledger — every response carries its verify URL.
+import { defineTool } from '@deepseek-ai/dsh-tools';
+
+const BASE = process.env.DOXT_STOCK_API || 'https://doxt.com';
+
+async function getJson(exec, urlPath) {
+  const r = await fetch(BASE + urlPath, { signal: exec.signal });
+  const j = await r.json().catch(() => null);
+  return j && j.ok === true ? j.data : null;
+}
+
+const DISCLAIMER =
+  '\nProbabilistic research record — not investment advice. Verify every claim: doxt.com/ledger';
+
+export const name = 'doxt-stock-tools';
+export const inject = ['tools'];
+
+export function apply(ctx) {
+  ctx.tools.register(defineTool({
+    name: 'doxt_judgments',
+    description:
+      'Recent public AI judgments for a covered US ticker from the doxt.com append-only ledger: ' +
+      'direction (bullish/bearish/neutral), confidence, thesis head, entry/exit dates and settlement status. ' +
+      'Use whenever the user asks what the model says about a stock or wants the ledger citation. ' +
+      'Always keep the ledger URL from the response in your answer so readers can verify.',
+    parameters: {
+      ticker: { type: 'string', required: true, description: 'US ticker, e.g. AAPL' },
+      limit: { type: 'number', description: '1-10 judgments (default 3)' },
+    },
+    output: { schema: { type: 'string' }, render: (_a, v) => [{ type: 'text', text: v }] },
+    async execute(args, exec) {
+      const t = String(args.ticker || '').trim().toUpperCase().replace(/[^A-Z.]/g, '');
+      if (!/^[A-Z.]{1,6}$/.test(t)) return 'Invalid ticker';
+      const limit = Math.min(Math.max(Number(args.limit) || 3, 1), 10);
+      const d = await getJson(exec, `/api/predictions?instrument=us_${t.toLowerCase()}&model_version=llm-v1&limit=${limit}`);
+      if (!d) return `No public ledger data for ${t} yet.`;
+      const rows = Array.isArray(d) ? d : [];
+      if (!rows.length) return `No public judgments for ${t} yet. Ledger: https://doxt.com/${t}`;
+      return 'Ledger URL: https://doxt.com/' + t + '\n' +
+        rows.map((p) => `${(p.decided_date || '').slice(0, 10)} ${String(p.direction).toUpperCase()} ${p.confidence}% ` +
+          `[${p.entry_date} → ${p.exit_date}] ${String(p.thesis || '').slice(0, 200)}`).join('\n');
+    },
+  }));
+
+  ctx.tools.register(defineTool({
+    name: 'doxt_track_record',
+    description:
+      'The model\'s REAL settled track record for one ticker (or whole ledger): hit rate, coverage, ' +
+      'confidence buckets — insufficient samples are labeled honestly instead of showing fake percentages. ' +
+      'Use for "how accurate is the model on AAPL" / 模型战绩 questions.',
+    parameters: { ticker: { type: 'string', description: 'Optional US ticker; omit for whole-ledger stats' } },
+    output: { schema: { type: 'string' }, render: (_a, v) => [{ type: 'text', text: v }] },
+    async execute(args, exec) {
+      const q = args.ticker ? '&ticker=' + encodeURIComponent(String(args.ticker).toUpperCase()) : '';
+      const d = await getJson(exec, '/api/track-record?scope=public' + q);
+      if (!d) return 'Track record lookup failed.';
+      const s = d.sample || {};
+      const hr = d.hitRate || {};
+      return [
+        d.disclaimer || 'Simulated results. Past performance does not guarantee future results.',
+        `sample: settled ${s.settled} (hit ${s.hit} / miss ${s.miss} / flat ${s.flat} / voided ${s.voided ?? 0} / invalidated ${s.invalidated ?? 0}) · pending ${s.pending ?? 'n/a'}`,
+        `hit rate: ${hr.value == null ? hr.label || 'insufficient sample' : (hr.value * 100).toFixed(1) + '%'} · coverage: ${d.coverage == null ? '—' : (d.coverage * 100).toFixed(1) + '%'}`,
+        'Ledger: https://doxt.com/ledger',
+      ].join('\n');
+    },
+  }));
+
+  ctx.tools.register(defineTool({
+    name: 'doxt_verify',
+    description:
+      'Verify the integrity of the doxt.com public judgment ledger: hash-chain verification proving ' +
+      'no published judgment was ever edited or deleted. Use when the user asks whether the record can be trusted, ' +
+      'or wants to cite the ledger as evidence.',
+    parameters: {},
+    output: { schema: { type: 'string' }, render: (_a, v) => [{ type: 'text', text: v }] },
+    async execute(args, exec) {
+      const d = await getJson(exec, '/api/ledger/public-verify');
+      if (!d) return 'Verification lookup failed.';
+      return JSON.stringify(d).slice(0, 400) + '\nVerify yourself: https://doxt.com/api/ledger/public-verify';
+    },
+  }));
+}

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "doxt-stock",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "DeepSeek Harness (DSH) plugin — verifiable US-stock judgment data from doxt.com's public append-only ledger: judgments, real settled track record, hash-chain verification. Every citation carries its doxt.com ledger URL.",
+  "type": "module",
+  "main": "index.mjs",
+  "files": [
+    "index.mjs",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "stocks",
+    "finance",
+    "ai-judgments",
+    "verifiable",
+    "public-ledger"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/doxt-stock/dsh-plugin-stock.git"
+  },
+  "homepage": "https://doxt.com",
+  "author": "Doxt <contact@doxt.com> (https://doxt.com)"
+}