@dshtrading/us 0.1.0

package/LICENSE

@@ -0,0 +1,75 @@
+Copyright (c) 2026 zhu1090093659 (dsh-trading)
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/assets/preset/us-trader/agent.cordis.yml

@@ -0,0 +1,125 @@
+# us-trader agent preset —— dsh-trading us 切片（实装形态抄 crypto-trader）。
+#
+# 本文件由 @dshtrading/us 的 dsh-trading-us-installer 插件（bundle host 面常驻行）在
+# apply() 时幂等自安装到市场自有 preset root（默认 ~/.dsh-trading-presets/us-trader；
+# agent-presets 行需把该 root 配进 roots，统一配置归 @dshtrading/base）。插件卸载不
+# 删除已安装目录；升级/重装后再次 apply 即恢复一致，行不可解析时只会得到带原因的
+# broken 行，无进程崩溃（S3 REPORT broken 语义）。
+#
+# 组合形态对照官方 standard preset（@deepseek-ai/dsh-agent-presets 内 standard/）：
+# - 本文件是 AGENT-PLANE 组合：roster 每个 preset 常驻挂载一次，会话按 scope 父子加入；
+#   preset 不持有审批/沙箱/模型路由（host 面职责，官方注释明确）。
+# - persona 行：@deepseek-ai/dsh-persona 的 config.text，{{model}}/{{cwd}} 由 agent 的
+#   路由与工作区解析（官方同款写法）。
+# - isolate realm：kit 行只向宿主 scope 分层注册表（ctx.skills）注册、不 provide 任何
+#   服务，与官方 standard 的 tool-fs/tool-bash 等同类，无需 realm。
+- id: persona
+  name: '@deepseek-ai/dsh-persona'
+  config:
+    text: >-
+      你是一名严谨的美股交易员，由 {{model}} 模型驱动，工作目录为 {{cwd}}。基于 Yahoo
+      Finance 公开行情（regular-market 快照；不反映盘前盘后价）做客观、量化的分析；下单类操作一律默认
+      dry-run 模拟，liveTrading 关闭时直接拒绝实盘，未经用户明确确认绝不触碰真实资金；
+      涉及盘前盘后、熔断、做空、T+1 与 PDT 日内限制时逐项核对 us-risk-checklist 风控
+      清单，并明确提示跳空与流动性风险；你给出的任何内容都不构成投资建议。每次会话开始时，
+      先检查工作目录下是否已有交易日志目录 .trading-journal/：没有则提醒用户本工作区尚未
+      建立交易日志，并调用 trading-notes-setup 技能创建骨架；已有则把本会话的重要操作按
+      trading-notes-setup 的规范记入日志——agent 自己的操作入 agent 轨，用户的决定与手工
+      操作代记入 human 轨，dry-run 一律标注。
+
+# connector 行 provide 服务（tradingUsMarketData），按官方 standard preset 的硬性规则
+# 必须包进 cordis:group + isolate（entry-local realm），且 isolate 键 = 服务名：否则
+# 服务发布进 root realm，与其他 preset 冲突，dsh-agent-presets 挂载时直接拒绝。
+# （实装同 crypto-trader：commit 8f75804 + acceptance「修复 1」）
+- id: dsh-trading-us-connector
+  name: cordis:group
+  group: true
+  isolate:
+    tradingUsMarketData: true
+  config:
+    - id: dsh-trading-us-connector-yahoo
+      name: '@dshtrading/connector-yahoo'
+      config:
+        enabled: true
+        dryRun: true
+        liveTrading: false
+
+- id: dsh-trading-us-connector-alpaca-group
+  name: cordis:group
+  group: true
+  isolate:
+    tradingUsMarketData: true
+    tradingUsTrade: true
+  config:
+    - id: dsh-trading-us-connector-alpaca
+      name: '@dshtrading/connector-alpaca'
+      config:
+        enabled: true
+        env: demo
+        dryRun: true
+        liveTrading: false
+
+- id: dsh-trading-us-connector-fmp-group
+  name: cordis:group
+  group: true
+  isolate:
+    tradingUsMarketData: true
+    tradingUsTrade: true
+  config:
+    - id: dsh-trading-us-connector-fmp
+      name: '@dshtrading/connector-fmp'
+      config:
+        enabled: true
+        dryRun: true
+        liveTrading: false
+
+- id: dsh-trading-us-connector-finnhub-group
+  name: cordis:group
+  group: true
+  isolate:
+    tradingUsMarketData: true
+    tradingUsTrade: true
+  config:
+    - id: dsh-trading-us-connector-finnhub
+      name: '@dshtrading/connector-finnhub'
+      config:
+        enabled: true
+        dryRun: true
+        liveTrading: false
+
+- id: dsh-trading-us-connector-polygon-group
+  name: cordis:group
+  group: true
+  isolate:
+    tradingUsMarketData: true
+    tradingUsTrade: true
+  config:
+    - id: dsh-trading-us-connector-polygon
+      name: '@dshtrading/connector-polygon'
+      config:
+        enabled: true
+        dryRun: true
+        liveTrading: false
+
+- id: dsh-trading-us-connector-ibkr-group
+  name: cordis:group
+  group: true
+  isolate:
+    tradingUsMarketData: true
+    tradingUsTrade: true
+  config:
+    - id: dsh-trading-us-connector-ibkr
+      name: '@dshtrading/connector-ibkr'
+      config:
+        enabled: true
+        dryRun: true
+        liveTrading: false
+
+
+
+
+- id: dsh-trading-us-kit
+  name: '@dshtrading/kit-us'
+  config:
+    dryRun: true
+    liveTrading: false

package/assets/preset/us-trader/preset.yml

@@ -0,0 +1,3 @@
+name: US 交易员
+description: 美股市场会话：Stooq 行情工具与交易员人设（由 @dshtrading/us 自安装，普通会话不可见 us 工具）。
+order: 20

package/cordis.patch.yml

@@ -0,0 +1,48 @@
+# @dshtrading/us —— us 市场 bundle 的 patch 层（insert-only，README 设计铁律 #1）。
+#
+# 实装形态抄 @dshtrading/crypto（架构修订 2026-08-29 主 agent 决策）：connector/kit 的
+# 插件行在 preset 的 agent.cordis.yml（preset 级会话隔离——tools/skills 注册表按 scope
+# 分层，preset scope 内注册的工具不进入 standard 会话）。本 bundle 的职责：
+#   1. dsh-trading-us-installer —— host 面常驻安装器插件（src/index.ts）：boot 时幂等
+#      自安装 us-trader preset 到 ~/.dsh-trading-presets。自安装必须在 bundle 层而非
+#      kit 插件（kit 行在 preset 平面，preset 不存在则 kit.apply() 永不运行）；
+#   2. 依赖安装载体：preset 行按 bare 包名从 profile node_modules 解析（S3 坑 3），本包
+#      dependencies 实装 @dshtrading/connector-yahoo（2026-08-29 数据面切换：Stooq 本出口
+#      被反爬拒止，见其 README）与 @dshtrading/kit-us，保证
+#      preset 行可解析、不 broken；
+#   3. agent-presets root 行归 base 层所有（~/.dsh-trading-presets），本层不得重复配置。
+#
+# 注意：patch 文件必须保持「顶层 YAML 数组」形状（loadProfile → parsePatchList 对非数组
+# 直接抛错）；只允许 insert（按 id 打已存在行 = 整行替换，多市场并存会互相覆盖）。
+- insert:
+    - id: dsh-trading-us-installer
+      name: '@dshtrading/us'
+
+    # host 面数据行（2026-08-30 GUI 行情桥配套）：只 provide tradingUsMarketData。
+    - id: dsh-trading-us-dataplane-yahoo
+      name: '@dshtrading/connector-yahoo/dataplane'
+      config:
+        enabled: true
+    - id: dsh-trading-us-dataplane-alpaca
+      name: '@dshtrading/connector-alpaca/dataplane'
+      config:
+        enabled: true
+    - id: dsh-trading-us-dataplane-fmp
+      name: '@dshtrading/connector-fmp/dataplane'
+      config:
+        enabled: true
+    - id: dsh-trading-us-dataplane-finnhub
+      name: '@dshtrading/connector-finnhub/dataplane'
+      config:
+        enabled: true
+    - id: dsh-trading-us-dataplane-polygon
+      name: '@dshtrading/connector-polygon/dataplane'
+      config:
+        enabled: true
+    - id: dsh-trading-us-dataplane-ibkr
+      name: '@dshtrading/connector-ibkr/dataplane'
+      config:
+        enabled: true
+
+
+

package/lib/index.d.ts

@@ -0,0 +1,47 @@
+import Schema from "@deepseek-ai/schemastery";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/index.d.ts
+/**
+ * Cordis 插件名 = patch 行 id（TEMPLATES §8）：`dsh-trading-us-*` 市场命名空间，
+ * 全仓唯一（insert-only 铁律 #1）。
+ */
+declare const name = "dsh-trading-us-installer";
+interface Config {
+  /** preset 自安装 root 覆盖；默认 ~/.dsh-trading-presets（须与 base 层 agent-presets 行的 roots 一致）。 */
+  presetRoot?: string;
+}
+declare const Config: Schema<Config>;
+declare const PRESET_ID = "us-trader";
+/** 默认安装 root：市场自有目录（S3 建议——绝不写进 ~/.dsh/.agent-presets 用户创作区）。 */
+declare const DEFAULT_PRESET_ROOT: string;
+interface SelfInstallResult {
+  /** 安装目录（preset 目录名即 roster id）。 */
+  dir: string;
+  /** 本次实际写入的文件名；空数组 = 内容已是当前代际。 */
+  wrote: string[];
+  /** 被跳过的文件与原因（用户改过/无管理戳）。 */
+  skipped: string[];
+}
+/**
+ * 幂等自安装 preset（S3 机制 + 2026-08-29 代际管理戳升级）：mkdir -p + 逐文件按管理戳
+ * 三代裁决——
+ *
+ *   1. 目标不存在 → 写入（头行 = `# dsh-trading-managed: <内容sha前8>` + shipped 内容）；
+ *   2. 目标存在且带本包可识别的管理戳（托管文件）→ 正文与 shipped 内容不同则整文件更新
+ *      （以新代际覆盖——戳即「本文件归安装器托管」的约定）；
+ *   3. 目标存在但无管理戳（用户改过/前代安装器所装）→ 跳过并记录提示（删除该文件即可
+ *      让安装器重新提供）。
+ *
+ * 迁移注意：代际升级前由旧安装器写入的已装文件没有管理戳，按第 3 条处理（跳过 + log
+ * 提示）——宁可不更新，绝不覆盖用户改动。
+ *
+ * 卸载本 bundle 不删除已安装目录（有意为之）：升级/重装后再次 apply 即恢复一致；本包
+ * 被移除后 preset 行不可解析只会得到带原因的 broken 行，无进程崩溃（S3 REPORT broken 语义）。
+ * preset 引用的插件包必须进本 bundle 的 dependencies（S3 坑 3），见 package.json。
+ */
+declare function installPreset(options?: {
+  presetRoot?: string;
+}): Promise<SelfInstallResult>;
+declare function apply(ctx: Context, config: Config): void;
+//#endregion
+export { Config, DEFAULT_PRESET_ROOT, PRESET_ID, SelfInstallResult, apply, installPreset, name };

package/lib/index.js

@@ -0,0 +1,106 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import Schema from "@deepseek-ai/schemastery";
+//#region src/index.ts
+/**
+* @dshtrading/us — us 市场 bundle。包承载两块实质内容（实装形态抄 @dshtrading/crypto）：
+*
+*   1. `cordis.patch.yml`（由 package.json 的 `dsh.bundle.patch` 声明）：insert-only
+*      聚合本 bundle 的 host 面常驻行（铁律 #1）。connector/kit 两行在 preset 的
+*      agent.cordis.yml（preset 级会话隔离，见 assets/preset/us-trader/）。
+*   2. `dsh-trading-us-installer` 插件（本模块）：us-trader preset 幂等自安装（S3 机制）。
+*      **自安装职责必须在 bundle（host 面常驻）而非 kit 插件**——kit 行在 preset 平面，
+*      preset 不存在时 kit.apply() 永不运行，鸡生蛋（2026-08-29 主 agent 结构性修复）；
+*      bundle 行常驻，boot 即自安装，与会话无关。
+*
+* @module @dshtrading/us
+*/
+/**
+* Cordis 插件名 = patch 行 id（TEMPLATES §8）：`dsh-trading-us-*` 市场命名空间，
+* 全仓唯一（insert-only 铁律 #1）。
+*/
+const name = "dsh-trading-us-installer";
+const Config = Schema.object({ presetRoot: Schema.string() });
+const PRESET_ID = "us-trader";
+/** 默认安装 root：市场自有目录（S3 建议——绝不写进 ~/.dsh/.agent-presets 用户创作区）。 */
+const DEFAULT_PRESET_ROOT = join(homedir(), ".dsh-trading-presets");
+/** 预置资产随本包分发（bundle 是市场组装点，preset 资产归 bundle 所有）。 */
+const PRESET_ASSET_DIR = fileURLToPath(new URL("../assets/preset/", import.meta.url));
+const PRESET_FILES = ["agent.cordis.yml", "preset.yml"];
+/** 管理戳注释行前缀：托管安装文件的头行，值 = shipped 内容（不含戳行）的 SHA-256 前 8 位。 */
+const MANAGED_STAMP_PREFIX = "# dsh-trading-managed: ";
+function contentSha8(content) {
+	return createHash("sha256").update(content, "utf8").digest("hex").slice(0, 8);
+}
+/** 提取已安装文件头行的管理戳；null = 无戳（文件视为用户所有）。 */
+function readManagedStamp(current) {
+	if (!current.startsWith(MANAGED_STAMP_PREFIX)) return null;
+	const stamp = (current.includes("\n") ? current.slice(0, current.indexOf("\n")) : current).slice(23).trim();
+	return /^[0-9a-f]{8}$/.test(stamp) ? stamp : null;
+}
+/** 已安装文件去掉管理戳头行后的正文。 */
+function bodyAfterStamp(current) {
+	return current.includes("\n") ? current.slice(current.indexOf("\n") + 1) : "";
+}
+/**
+* 幂等自安装 preset（S3 机制 + 2026-08-29 代际管理戳升级）：mkdir -p + 逐文件按管理戳
+* 三代裁决——
+*
+*   1. 目标不存在 → 写入（头行 = `# dsh-trading-managed: <内容sha前8>` + shipped 内容）；
+*   2. 目标存在且带本包可识别的管理戳（托管文件）→ 正文与 shipped 内容不同则整文件更新
+*      （以新代际覆盖——戳即「本文件归安装器托管」的约定）；
+*   3. 目标存在但无管理戳（用户改过/前代安装器所装）→ 跳过并记录提示（删除该文件即可
+*      让安装器重新提供）。
+*
+* 迁移注意：代际升级前由旧安装器写入的已装文件没有管理戳，按第 3 条处理（跳过 + log
+* 提示）——宁可不更新，绝不覆盖用户改动。
+*
+* 卸载本 bundle 不删除已安装目录（有意为之）：升级/重装后再次 apply 即恢复一致；本包
+* 被移除后 preset 行不可解析只会得到带原因的 broken 行，无进程崩溃（S3 REPORT broken 语义）。
+* preset 引用的插件包必须进本 bundle 的 dependencies（S3 坑 3），见 package.json。
+*/
+async function installPreset(options = {}) {
+	const dir = join(options.presetRoot ?? DEFAULT_PRESET_ROOT, PRESET_ID);
+	await mkdir(dir, { recursive: true });
+	const wrote = [];
+	const skipped = [];
+	for (const file of PRESET_FILES) {
+		const content = await readFile(join(PRESET_ASSET_DIR, PRESET_ID, file), "utf8");
+		const stamped = `${MANAGED_STAMP_PREFIX}${contentSha8(content)}\n${content}`;
+		const target = join(dir, file);
+		let current = null;
+		try {
+			current = await readFile(target, "utf8");
+		} catch {}
+		if (current === null) {
+			await writeFile(target, stamped);
+			wrote.push(file);
+			continue;
+		}
+		if (readManagedStamp(current) === null) {
+			skipped.push(`${file} (no management stamp — user-modified file left untouched; delete it to let the installer re-provision it)`);
+			continue;
+		}
+		if (bodyAfterStamp(current) !== content) {
+			await writeFile(target, stamped);
+			wrote.push(file);
+		}
+	}
+	return {
+		dir,
+		wrote,
+		skipped
+	};
+}
+function logger(ctx) {
+	const service = ctx.logger;
+	return typeof service === "function" ? service(name) : console;
+}
+function apply(ctx, config) {
+	installPreset({ presetRoot: config?.presetRoot }).then((result) => logger(ctx).info("[dsh-trading-us-installer] self-install %s preset at %s wrote=[%s] skipped=[%s]", PRESET_ID, result.dir, result.wrote.join(",") || "nothing — already current", result.skipped.join("; ") || "none"), (error) => logger(ctx).warn("[dsh-trading-us-installer] us-trader preset self-install failed: %s", error));
+}
+//#endregion
+export { Config, DEFAULT_PRESET_ROOT, PRESET_ID, apply, installPreset, name };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@dshtrading/us",
+  "description": "US market bundle for dsh-trading: host-plane us-trader preset installer + insert-only aggregation of the yahoo connector and us kit rows (design rule #1)",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "assets",
+    "cordis.patch.yml"
+  ],
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@dshtrading/connector-alpaca": "0.1.0",
+    "@dshtrading/connector-finnhub": "0.1.0",
+    "@dshtrading/connector-fmp": "0.1.0",
+    "@dshtrading/connector-ibkr": "0.1.0",
+    "@dshtrading/connector-polygon": "0.1.0",
+    "@dshtrading/connector-yahoo": "0.1.0",
+    "@dshtrading/kit-us": "0.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0",
+    "@deepseek-ai/schemastery": ">=3.18.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.0"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
+}