dynamitecircle 2.0.1__tar.gz → 2.3.1__tar.gz

{dynamitecircle-2.0.1 → dynamitecircle-2.3.1}/.gitignore

@@ -13,10 +13,14 @@ __pycache__/
 .venv*
 *.egg-info/
 dist/
+
+# MCPB bundle — built in CI (publish.yml) + attached to releases; never commit
+*.mcpb
 build/
 
 # Node (in case any tool ships a sub-app)
 node_modules/
+.npm-cache/
 
 # OS
 .DS_Store

{dynamitecircle-2.0.1 → dynamitecircle-2.3.1}/CHANGELOG.md

@@ -3,9 +3,10 @@
 All notable changes to the **`dc` client repo** (formerly `dc-official` /
 `dc-py`) are listed here. The version
 numbers below track `DC_API_VERSION` in [`py/dc.py`](py/dc.py), which is
-deliberately aligned with the DC Member API server version it was last
-verified against. Patch bumps from the server are silent; minor or major
-bumps surface a one-shot stderr warning when this client falls behind.
+deliberately aligned with the DC Member API contract version it was last
+verified against. Python, TypeScript, and the API contract are released
+together on purpose. Patch bumps from the API are silent; minor or major bumps
+surface a one-shot stderr warning when an installed client falls behind.
 
 The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and the project follows [Semantic Versioning](https://semver.org/) for
@@ -14,6 +15,286 @@ the public Python API surface (`dc.DC`, `dc.DCError`, `dc.Result`,
 
 ---
 
+## [v2.3.1] - 2026-07-14
+
+### Added
+- **`virtual-event-attendees`** — list the attendees (RSVP `yes`/`maybe`) of a Live Call: `dc virtual-event-attendees <sessionID> [--limit N] [--cursor TOKEN]`. Mirrors `event-attendees` — same paginated envelope, surfaces the true `total` (under `extra`) + `cursor`. TS: `client.virtualEvents.attendees(sessionID, { limit, cursor })`.
+
+### Changed
+- Realigned `DC_API_VERSION` to the deployed Member API contract **2.3.1**. The server added the Live Call attendees endpoint plus cursor pagination and a true aggregate `total` on `GET /events/:eventID/attendees`; the pinned OpenAPI snapshot + operation-map were updated to match (no other client command changes since 2.0.4).
+
+## [v2.0.4] - 2026-06-16
+
+### Added
+
+- list in the Official MCP Registry (b2f1d26)
+- one-click install badges, VS Code docs, and .mcpb bundle (6108d51)
+- MCP tool annotations and structured output (9b62eb0)
+- snake_case MCP tool names and fields (f4573f8)
+
+
+## [v2.0.1] - 2026-06-16
+
+### Added
+
+- v2.0.1 — formal field names (breaking) to match Member API rename (2bb90f2)
+
+
+## [v1.23.3] - 2026-06-13
+
+### Fixed
+
+- dc.py help — sponsors/attendee-agenda/agendas are public (not ticket-gated) (9181cc8)
+
+
+## [v1.22.6] - 2026-06-05
+
+### Fixed
+
+- explicit profile-update/calendar parsers + offline test suite (aecaca1)
+- accept top-level --note on trip-create and trip-update (26a9c61)
+
+
+## [v1.22.5] - 2026-06-03
+
+### Fixed
+
+- accept declared args= flags on parser-less commands (MCP bridge) (267fad2)
+
+
+## [v1.22.4] - 2026-05-27
+
+### Fixed
+
+- align client with api 1.22.4 (3fe5f91)
+
+
+## [v1.22.3] - 2026-05-24
+
+### Added
+
+- 6 follow commands + Follows SKILL.md section (no version bump — pending server deploy) (5f19db6)
+
+
+## [v1.20.1] - 2026-05-22
+
+_No customer-facing changes in this release._
+
+
+## [v1.19.3] - 2026-05-21
+
+_No customer-facing changes in this release._
+
+
+## [v1.19.2] - 2026-05-21
+
+_No customer-facing changes in this release._
+
+
+## [v1.17.3] - 2026-05-20
+
+_No customer-facing changes in this release._
+
+
+## [v1.17.2] - 2026-05-20
+
+_No customer-facing changes in this release._
+
+
+## [v1.17.1] - 2026-05-20
+
+_No customer-facing changes in this release._
+
+
+## [v1.17.0] - 2026-05-20
+
+_No customer-facing changes in this release._
+
+
+## [v1.16.2] - 2026-05-20
+
+_No customer-facing changes in this release._
+
+
+## [v1.14.1] - 2026-05-19
+
+### Added
+
+- dc-py rooms — path-segment URLs + trim type enum (be09d76)
+- dc 1.14.0 — room + room-messages; rooms enum adds direct/group (a7b8ea9)
+
+
+## [v1.13.1] - 2026-05-19
+
+### Fixed
+
+- stabilize MCP stdio transport (21c8022)
+
+
+## [v1.12.5] - 2026-05-14
+
+_No customer-facing changes in this release._
+
+
+## [v1.12.1] - 2026-05-08
+
+_No customer-facing changes in this release._
+
+
+## [v1.11.1] - 2026-05-07
+
+_No customer-facing changes in this release._
+
+
+## [v1.10.5] - 2026-05-07
+
+_No customer-facing changes in this release._
+
+
+## [v1.10.4] - 2026-05-04
+
+_No customer-facing changes in this release._
+
+
+## [v1.10.2] - 2026-05-04
+
+_No customer-facing changes in this release._
+
+
+## [v1.9.1] - 2026-05-04
+
+_No customer-facing changes in this release._
+
+
+## [v1.8.1] - 2026-05-04
+
+_No customer-facing changes in this release._
+
+
+## [v1.7.1] - 2026-05-03
+
+_No customer-facing changes in this release._
+
+
+## [v1.6.3] - 2026-05-02
+
+### Fixed
+
+- rewrite CLI smoke step + bump to 1.6.3 (b098dfe)
+
+
+## [v1.6.2] - 2026-05-02
+
+### Added
+
+- PyPI packaging (`dynamitecircle`) + publish workflow (77aefa4)
+- add Gemini CLI pre-approval (.gemini/settings.json) (fd09acb)
+- pre-approve dc MCP server + skill + CLI for Claude Code & Codex (4d234ec)
+- flip canonical paths to /dc/ and /docs/, rename dc_skill.py → dc.py (42aa541)
+
+### Changed
+
+- monorepo restructure — repo renamed to dc, Python client moved to /py/ (80d7166)
+- SKILL_VERSION → DC_API_VERSION; deduplicate Quick start sections in README (a1e99c6)
+- User-Agent → 'dc-py/<version>' (e1b5a6a)
+- rename Skill base class → Runtime; SkillError → DCError; SkillResult → Result (06a2c44)
+- rename public class DCSkill → DC, rename doc files (bc9d04f)
+
+### Fixed
+
+- use only-include + bypass-selection so sdist ships py/ (c42abed)
+
+
+## [v1.6.1] - 2026-05-02
+
+### Added
+
+- add manifest.json + LICENSE; bump to 1.6.1 (8e949d6)
+- add dc/ symlink shortcut + drop hardcoded command counts (96bc6a3)
+
+
+## [v1.6.0] - 2026-04-30
+
+_No customer-facing changes in this release._
+
+
+## [v1.5.0] - 2026-04-30
+
+### Added
+
+- add announcements + event-extras commands (10 new) (f4f901f)
+
+
+## [v1.3.0] - 2026-04-30
+
+### Added
+
+- add 429 retry handling and `limits` command (02bf994)
+
+
+## [v1.0.0] - 2026-04-30
+
+_No customer-facing changes in this release._
+
+
+## [Unreleased]
+
+### Added
+
+- TypeScript npm library scaffold under `ts/`, published as
+  `@dynamitecircle/dc`, with a hand-written SDK surface for every pinned
+  Member API operation. It is a library only: no CLI and no MCP server.
+- Pinned OpenAPI contract under `contracts/` plus an explicit operation map
+  that validates API operation → Python command → TypeScript method parity.
+
+## [2.0.4] – 2026-06-16
+
+### Added
+
+- **MCP tool annotations** — every tool now advertises `readOnlyHint` /
+  `destructiveHint` / `openWorldHint`, so clients can auto-approve reads and
+  flag writes. The read/write split is derived from each command's actual HTTP
+  verb and guarded by a test that re-derives it from source (no silent drift).
+  Write tools also carry a "⚠️ Write operation" note in their description,
+  mirroring the hosted MCP server.
+- **Structured tool output** — object results (the list envelope
+  `{items, count, cursor, has_more}` and single records) are also returned as
+  MCP `structuredContent`, so structure-aware clients don't have to re-parse
+  the text. No `outputSchema` is declared (it would strictly validate every
+  response shape); lists/scalars remain text-only.
+
+### Changed
+
+- **BREAKING (MCP interface) — tool names and fields are now snake_case.**
+  MCP tool names switched from kebab-case to snake_case
+  (`mcp__dc__trip-create` → `mcp__dc__trip_create`), and tool argument fields
+  likewise (`event-id` → `event_id`, `start-date` → `start_date`). This aligns
+  the agent-facing MCP surface with the snake_case Python library
+  (`dc.trip_create()`) and the prevailing MCP tool-naming convention. The
+  **CLI is unchanged** (`dc trip-create`, `--start-date`). Wildcard allow-rules
+  like `mcp__dc__*` are unaffected; any config pinning a specific kebab tool
+  name must update it. `_call_tool` still accepts the legacy kebab form as a
+  transitional fallback.
+
+### Docs / packaging
+
+- Document the hosted MCP (`https://api.dynamitecircle.com/mcp`) and an
+  auto-updating `uvx` PyPI config; fix the `.venv/bin/python3` configs to bare
+  `python3`; unify `py/SKILL.md` (local client + hosted MCP) and add
+  `DC/SKILL.md`; add `tests/test_version_sync.py` guarding manifest/config
+  drift from `DC_API_VERSION`.
+- **One-click install** — "Add to Cursor" and "Install in VS Code" badges for
+  the hosted MCP, a native VS Code section (`.vscode/mcp.json` + `code --add-mcp`),
+  and a `workflows`-first note for the ~80-tool surface.
+- **`.mcpb` bundle** — the release workflow now builds a `dc.mcpb` (one-click
+  Claude Desktop install) via `mcpb pack` and attaches it to the GitHub release;
+  `.mcpbignore` keeps the bundle lean.
+- **Official MCP Registry** — add `server.json` (`io.github.dynamitecircle/dc`,
+  listing the hosted streamable-HTTP endpoint) and a separate, isolated
+  `publish-mcp.yml` workflow that publishes it via GitHub OIDC on `v*` tags.
+  The registry feeds VS Code, Smithery, PulseMCP, and others. `server.json`
+  version is guarded by `tests/test_version_sync.py`.
+
 ## [2.0.1] – 2026-06-16
 
 ### Changed
@@ -227,7 +508,7 @@ cutover — were server-only with no client surface change, so no client release
 
   No client-side change required — the `hint` field on 404 payloads
   is already surfaced by `DCError`. Bump kept in lockstep with the
-  deployed server version per the triple-lock rule.
+  deployed API contract version per the triple-lock rule.
 
 ---
 
@@ -1071,7 +1352,9 @@ Tag exists but no PyPI release. Replaced by 1.6.3.
 
 ---
 
-[Unreleased]: https://github.com/dynamitecircle/dc/compare/v2.0.1...HEAD
+[Unreleased]: https://github.com/dynamitecircle/dc/compare/v2.3.1...HEAD
+[2.3.1]: https://github.com/dynamitecircle/dc/compare/v2.0.4...v2.3.1
+[2.0.4]: https://github.com/dynamitecircle/dc/compare/v2.0.1...v2.0.4
 [2.0.1]: https://github.com/dynamitecircle/dc/releases/tag/v2.0.1
 [1.23.3]: https://github.com/dynamitecircle/dc/releases/tag/v1.23.3
 [1.22.6]: https://github.com/dynamitecircle/dc/releases/tag/v1.22.6

{dynamitecircle-2.0.1 → dynamitecircle-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dynamitecircle
-Version: 2.0.1
+Version: 2.3.1
 Summary: Official Python client for the public Dynamite Circle Member API. CLI, library, Agent Skill, and MCP server in one file.
 Project-URL: Homepage, https://github.com/dynamitecircle/dc
 Project-URL: Repository, https://github.com/dynamitecircle/dc
@@ -51,14 +51,18 @@ Provides-Extra: test
 Requires-Dist: pytest>=7.0; extra == 'test'
 Description-Content-Type: text/markdown
 
-# DC Official Client
+# DC Official Clients
 
-The official Python client for the [Dynamite Circle Member API](https://www.dynamitecircle.com/developers/) — your own profile, trips, events, virtual events, tickets, invites, inbox, rooms, chapters, places lookup, and the weekly locator digest.
+Official clients for the [Dynamite Circle Member API](https://www.dynamitecircle.com/developers/) — your own profile, trips, events, virtual events, tickets, invites, inbox, rooms, chapters, places lookup, and the weekly locator digest.
 
-A single self-contained file. Zero dependencies (stdlib only). Works as a CLI, a Python library, **and** a [Model Context Protocol](https://modelcontextprotocol.io) server. Compatible with Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, and every other Agent Skills / MCP-compatible tool.
+The Python client is a single self-contained file. Zero dependencies (stdlib only). Works as a CLI, a Python library, **and** a [Model Context Protocol](https://modelcontextprotocol.io) server. Compatible with Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, and every other Agent Skills / MCP-compatible tool.
+
+The TypeScript client is an npm library for trusted server-side TypeScript projects. It is not a CLI and not an MCP server.
 
 ```
-py/dc.py    ← one file, three integration modes
+py/dc.py       ← Python: CLI + library + MCP server
+ts/src/        ← TypeScript: npm library
+contracts/     ← pinned OpenAPI contract shared by both clients
 ```
 
 ## About the Dynamite Circle
@@ -153,6 +157,52 @@ The same `dc.py` file is shipped as **four** integrations — pick whichever fit
 
 The `mcp` package is **lazy-imported** — Agent Skill / CLI / Python-library users never need it.
 
+### TypeScript npm library
+
+For TypeScript projects, use the package under [`ts/`](ts/):
+
+```ts
+import { DC } from "@dynamitecircle/dc";
+
+const dc = new DC({ apiKey: process.env.DC_API_KEY! });
+
+const profile = await dc.profile.get();
+const trips = await dc.trips.list({ limit: 10 });
+```
+
+Keep `dk_...` API keys server-side. Do not ship a member API key in browser JavaScript.
+
+### Don't want to install anything? Use the hosted MCP
+
+The DC Member API is **also a hosted MCP server** — a remote endpoint you point your AI app at, with nothing to clone, install, or update:
+
+```
+https://api.dynamitecircle.com/mcp        (Streamable HTTP)
+```
+
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=dc&config=eyJ1cmwiOiJodHRwczovL2FwaS5keW5hbWl0ZWNpcmNsZS5jb20vbWNwIn0=)
+ 
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_DC-007ACC?logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=dc&config=%7B%22url%22%3A%22https%3A%2F%2Fapi.dynamitecircle.com%2Fmcp%22%7D)
+
+- **Claude Code:** `claude mcp add --transport http dc https://api.dynamitecircle.com/mcp`
+- **Claude (web / Desktop / mobile):** Settings → Connectors → **Add custom connector** → paste the URL → **Connect**
+- **VS Code:** click the badge above, or `code --add-mcp '{"name":"dc","url":"https://api.dynamitecircle.com/mcp"}'`
+- **Cursor:** click the badge above, or add a custom MCP connector pointing at the URL
+- **ChatGPT / any other MCP app:** add a custom / remote MCP connector pointing at the URL above
+
+When prompted, **sign in with your DC account** (one-click OAuth) — or send a `dk_` key as `Authorization: Bearer`. The server is always on the current API version, so there's nothing to keep up to date.
+
+**Hosted MCP vs. this client — which do I want?**
+
+| You want… | Use |
+|---|---|
+| Zero install, always-current, just MCP tools in a chat app | **Hosted MCP** (URL above) |
+| To call DC from your own Python code (`from dynamitecircle import DC`) | **This client** (library) |
+| A local CLI (`dc profile`) or shell scripting | **This client** (CLI) |
+| A local stdio MCP server (offline-capable, pin a version, dev against localhost) | **This client** (`dc --mcp`) |
+
+The rest of this README is about **this client**. For the hosted MCP, the URL above is all you need.
+
 ## Features
 
 - **Full Member API coverage** — read + write across every public endpoint (run `python3 py/dc.py help` for the live list)
@@ -214,7 +264,18 @@ Run `python3 py/dc.py help` for the full command list.
 
 ## Setup per AI tool
 
-### Claude Code
+### Hosted MCP (no install, always current)
+
+Nothing to clone or update — point your tool at the remote endpoint:
+
+```bash
+# Claude Code
+claude mcp add --transport http dc https://api.dynamitecircle.com/mcp
+```
+
+For Claude web / Desktop, Cursor, ChatGPT, and other MCP apps, add a **custom / remote connector** pointing at `https://api.dynamitecircle.com/mcp` (Streamable HTTP). Sign in with your DC account (OAuth) or send a `dk_` key as a Bearer header. Discovery is published at [`/.well-known/mcp.json`](https://api.dynamitecircle.com/.well-known/mcp.json). This is the lowest-effort path; everything below runs the client **locally** instead.
+
+### Claude Code (local client)
 
 `.mcp.json` is already shipped with this repo. Open the repo with `claude`:
 
@@ -231,9 +292,30 @@ pip install -r py/requirements.txt
 
 Skill discovery (CLI + import) works automatically via `py/SKILL.md`.
 
+#### Auto-updating local MCP via `uvx` (PyPI)
+
+Prefer a local stdio server that **pulls the latest published client on every launch** with no clone to maintain? Use [`uv`](https://docs.astral.sh/uv/)'s `uvx` and pass your key in the `env` block:
+
+```json
+{
+  "mcpServers": {
+    "dc": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["--refresh", "--from", "dynamitecircle[mcp]", "dc", "--mcp"],
+      "env": { "DC_API_KEY": "dk_<api-key>" }
+    }
+  }
+}
+```
+
+Notes: the console script is `dc` (not `dynamitecircle`), so `--from dynamitecircle[mcp]` is required — it both names the package and pulls the optional `mcp` extra. `--refresh` is what makes it auto-update; drop it to let `uvx` cache. The `DC_API_KEY` in `env` wins over any `.env.dc` (an ephemeral `uvx` install has none).
+
 ### Claude Desktop
 
-Edit your config file:
+**Easiest — one-click `.mcpb`:** download `dc.mcpb` from the [latest GitHub release](https://github.com/dynamitecircle/dc/releases/latest) and double-click it. Claude Desktop installs the `dc` server and prompts for your `DC_API_KEY` (no JSON editing). Requires Python 3.9+ with the `mcp` package available on your machine (`pip install 'dynamitecircle[mcp]'`). *(Or skip local install entirely and use the [hosted MCP connector](#hosted-mcp-no-install-always-current) above.)*
+
+**Manual** — edit your config file:
 
 - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - Linux: `~/.config/Claude/claude_desktop_config.json`
@@ -330,9 +412,19 @@ Non-paginated extras (e.g. `totalUnread` on `inbox`) are passed through under an
 
 ## Use as a Python library
 
+Installed from PyPI (`pip install dynamitecircle`) — import by the package name:
+
+```python
+from dynamitecircle import DC
+
+dc = DC()
+```
+
+Working from a clone instead? Point `sys.path` at the `py/` folder and import as `dc`:
+
 ```python
 import sys
-sys.path.insert(0, "dc")
+sys.path.insert(0, "py")
 from dc import DC
 
 dc = DC()
@@ -364,10 +456,23 @@ The full live reference for the DC Member API — every endpoint, parameter, and
 
 ## Staying up to date
 
-The DC Member API ships new endpoints and refinements regularly. This skill is the official client and we update it whenever the API changes. **Plan for updates** — the skill will warn you on stderr the first time a request returns a server `X-API-Version` newer than `DC_API_VERSION`, and major-version bumps may break older clients.
+The DC Member API ships new endpoints and refinements regularly. This skill is the official client and we update it whenever the API changes. **Plan for updates** — the skill will warn you on stderr the first time a request returns an `X-API-Version` newer than `DC_API_VERSION`, and major-version bumps may break older clients.
+
+**The no-maintenance option:** if you use the [hosted MCP](#hosted-mcp-no-install-always-current) (`https://api.dynamitecircle.com/mcp`), there's nothing to update — the server always runs the current API version. The strategies below apply only to the **local client**.
 
 Pick whichever integration style fits your project. From simplest to most isolated:
 
+### 0. PyPI — `pip` / `uvx`
+
+```bash
+pip install dynamitecircle              # CLI + library
+pip install 'dynamitecircle[mcp]'       # + local MCP server (dc --mcp)
+```
+
+Then `dc setup --api-key dk_<api-key>` and `dc self-test`. Update with `pip install --upgrade dynamitecircle`. For a local MCP that auto-updates on every launch, use the [`uvx` config above](#auto-updating-local-mcp-via-uvx-pypi).
+
+Best for: the quickest local install, and the auto-updating `uvx` MCP setup.
+
 ### 1. Plain git clone — quick local use
 
 ```bash
@@ -458,7 +563,7 @@ Best for: CI environments, ephemeral containers, scripted setups.
 
 - **Stay current.** The DC Member API ships new endpoints regularly and the client mirrors them; running stale means missing features and (eventually) compatibility warnings on stderr.
 - **Run `self-test` after every update.** Five seconds, catches breakage.
-- **Watch stderr the first time you call any command after updating.** The version-mismatch warning prints once per process when the server is on a newer minor/major.
+- **Watch stderr the first time you call any command after updating.** The version-mismatch warning prints once per process when the API is on a newer minor/major.
 - **Major version bumps may be backwards-incompatible.** Read the release notes on the GitHub repo before pulling across a major boundary.
 
 ## Rate limits
@@ -504,7 +609,19 @@ dc/
 │   ├── .env.dc.example                # template
 │   └── .env.dc                        # gitignored (created by `setup`)
 │
-│   (Future: go/, node/, rs/ folders for sister clients in other languages)
+├── ts/                                # ← TypeScript npm library (@dynamitecircle/dc)
+│   ├── src/                           # hand-written SDK surface
+│   ├── tests/                         # contract + request behavior tests
+│   ├── examples/                      # TypeScript usage examples
+│   ├── package.json
+│   └── tsconfig.json
+│
+├── contracts/                         # pinned API contract shared by clients
+│   ├── openapi.json                   # committed snapshot of /openapi.json
+│   └── operation-map.json             # OpenAPI op → Python command → TS method
+│
+├── DC/
+│   └── SKILL.md     → ../py/SKILL.md  # human-friendly skill path (symlink)
 │
 ├── docs/                              # ← REAL design docs (canonical)
 │   ├── skill-info.md                # design rules / architecture
@@ -527,9 +644,9 @@ dc/
 
 ### About the layout
 
-This is a **monorepo**. The Python client lives at `/py/` so we can add future sister clients (`go/`, `node/`, `rs/`) at the same level — they all wrap the same DC Member API. `/docs/` is shared. The dotfile-prefixed directories (`.claude/`, `.agents/`, `.gemini/`) exist because AI tools auto-discover skills from those specific paths — they're kept hidden but each one **symlinks (or points) straight to the canonical folder**, so you only edit files in one place. Edit `py/dc.py` and Claude Code, Codex, and Gemini CLI all see the same file via their respective discovery directories. Gemini CLI also reads `.agents/skills/` as an alias, so we don't need a redundant `.gemini/skills/` symlink.
+This is a **monorepo**. The Python client lives at `/py/`; the TypeScript client lives at `/ts/`. Both wrap the same DC Member API and are validated against the pinned contract in `/contracts/`. `/docs/` is shared. The dotfile-prefixed directories (`.claude/`, `.agents/`, `.gemini/`) exist because AI tools auto-discover skills from those specific paths — they're kept hidden but each one **symlinks (or points) straight to the canonical folder**, so you only edit files in one place. Edit `py/dc.py` and Claude Code, Codex, and Gemini CLI all see the same file via their respective discovery directories. Gemini CLI also reads `.agents/skills/` as an alias, so we don't need a redundant `.gemini/skills/` symlink.
 
-If you're adding new code or docs, edit `py/` (or `docs/`) directly. The discovery folders take care of themselves.
+If you're adding Python code or skill docs, edit `py/` (or `docs/`) directly. If you're adding TypeScript library code, edit `ts/`. The discovery folders take care of themselves.
 
 ### Pre-approval out of the box
 
@@ -542,4 +659,3 @@ This repo is maintained by the Dynamite Circle team. It's read-only for the publ
 ## License
 
 [MIT](LICENSE) — see the LICENSE file for the full text.
-