@taylorwong/ichartjs 2.0.2 → 2.0.4

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 2.0.4 - 2026-09-18
+
+- Synchronized current Agent documentation, scoped package paths, GitHub fallback instructions, Skill links, Playground links, and release status.
+- Corrected Runtime and Playground version displays to `2.0.4`.
+- Marked the original `2.0.0` release-readiness document as historical and added stronger documentation consistency checks.
+
+## 2.0.3 - 2026-09-17
+
+- Completed Iteration 8 acceptance documentation and added the author-only release SOP.
+- Added README and official Skill release guardrails for the scoped npm package and controlled publishing workflow.
+
+## 2.0.2 - 2026-09-17
+
+- Fixed Line and Area rendering so `fill: 'none'` does not create an unintended filled area.
+
+## 2.0.1 - 2026-09-17
+
+- Added dual-engine raster export, branding signature support, and synchronized documentation and TypeScript declarations.
+
 ## 2.0.0 - 2026-09-16
 
 - Added Iteration 9's lightweight visual style system with adaptive modes, semantic presets and palettes, live switching, contrast diagnostics, Agent recommendations, bilingual guidance, and Theme Gallery while retaining version `2.0.0`.

package/README.md

@@ -20,9 +20,9 @@ getCapabilities
 
 | Need | Entry point |
 | --- | --- |
-| Runtime and Agent planning APIs | `ichartjs` |
-| Machine-readable capability manifest | `ichartjs/capabilities.json` |
-| Intent and chart recipes | `ichartjs/recipes/*` |
+| Runtime and Agent planning APIs | `@taylorwong/ichartjs` |
+| Machine-readable capability manifest | `@taylorwong/ichartjs/capabilities.json` |
+| Intent and chart recipes | `@taylorwong/ichartjs/recipes/*` |
 | Agent quickstart | [`docs/agent/quickstart.md`](docs/agent/quickstart.md) |
 | Chinese quickstart | [`docs/agent/zh-CN/quickstart.md`](docs/agent/zh-CN/quickstart.md) |
 | Coding Agent integration | [`docs/agent/coding-agent-integration.md`](docs/agent/coding-agent-integration.md) |
@@ -36,7 +36,7 @@ getCapabilities
 npm install @taylorwong/ichartjs@^2
 ```
 
-As a fallback for environments without npm access, install directly from GitHub: `npm install github:wanghetommy/ichartjs#v2.0.1`.
+As a fallback for environments without npm access, install directly from GitHub: `npm install github:wanghetommy/ichartjs#v2.0.4`.
 
 ### Optional Agent Skill
 
@@ -52,7 +52,7 @@ From a repository checkout, install it into Codex with:
 cp -R skills/ichartjs "${CODEX_HOME:-$HOME/.codex}/skills/"
 ```
 
-WorkBuddy users can import or register the same `skills/ichartjs` folder through the host's Skill interface. Package consumers can copy it from `node_modules/ichartjs/skills/ichartjs` into their Agent host's Skill directory. After installation, invoke it as `$ichartjs` when the host supports named Skill invocation, or select the `ichartjs` Skill in the host UI.
+WorkBuddy users can import or register the same `skills/ichartjs` folder through the host's Skill interface. Package consumers can copy it from `node_modules/@taylorwong/ichartjs/skills/ichartjs` into their Agent host's Skill directory. After installation, invoke it as `$ichartjs` when the host supports named Skill invocation, or select the `ichartjs` Skill in the host UI.
 
 ### Agent workflow
 
@@ -140,9 +140,14 @@ npm run playground
 - Playground Home: `http://localhost:3000/playground/index.html`
 - Agent Workbench: `http://localhost:3000/playground/agent-workbench.html`
 - Complete Gallery: `http://localhost:3000/playground/project-gallery.html`
+- Foundational Gallery: `http://localhost:3000/playground/foundational-gallery.html`
 - Theme Gallery: `http://localhost:3000/playground/theme-gallery.html`
+- Business Editing: `http://localhost:3000/playground/editing.html`
 - Project Intelligence: `http://localhost:3000/playground/project-intelligence.html`
 - Diagram Editor: `http://localhost:3000/playground/diagram-editor.html`
+- Interaction Lab: `http://localhost:3000/playground/interaction-lab.html`
+- Accessibility Lab: `http://localhost:3000/playground/accessibility-lab.html`
+- Performance Lab: `http://localhost:3000/playground/performance-lab.html`
 
 ## For Developers
 
@@ -184,11 +189,24 @@ The public package includes ESM exports, TypeScript declarations, Agent document
 
 ## Development
 
+Checks + playground (for all contributors):
+
 ```bash
 npm run agent:check
 npm run playground
 ```
 
+### Release (AUTHOR ONLY)
+
+Publishing to npm (`@taylorwong/ichartjs`) and merging `develop → master` are restricted to the package author (GitHub + npm account `taylorwong`) due to 2FA and access control.
+
+Contributors should:
+1. Open PRs / commit only to `develop`
+2. Ensure `npm run agent:check` and `npm test` are green
+
+Full author-only release SOP (preconditions, release sequence, must-not rules, and rollback procedure):
+👉 [`docs/agent/development/release-sop.md`](docs/agent/development/release-sop.md)
+
 Start with [`docs/agent/quickstart.md`](docs/agent/quickstart.md). Detailed runtime, charting, project, diagram, and editing contracts live in [`docs/agent/`](docs/agent/).
 
 Contribution requirements are in [`CONTRIBUTING.md`](CONTRIBUTING.md). Report vulnerabilities privately according to [`SECURITY.md`](SECURITY.md).

package/docs/agent/README.md

@@ -21,7 +21,7 @@ This is the user-facing Agent entry point for iChart.js 2.0. Read this file firs
 - [Editing Contract](editing-contract.md): schemas, commands, preview, commit, and undo/redo.
 - Machine-readable capability manifests are in `docs/manifests/` and should be loaded on demand.
 
-The 2.0 API is Spec-first. Import from `ichartjs`, inspect data, plan a chart, create a JSON-friendly Spec, validate it, render it, and self-check the explanation and runtime state.
+The 2.0 API is Spec-first. Import from `@taylorwong/ichartjs`, inspect data, plan a chart, create a JSON-friendly Spec, validate it, render it, and self-check the explanation and runtime state.
 
 ## Recommended flow
 

package/docs/agent/coding-agent-integration.md

@@ -4,7 +4,7 @@ Use this guide with Codex, WorkBuddy, and similar Agents that can read a reposit
 
 ## Responsibility Boundary
 
-iChart.js is a JavaScript UI component library. The coding Agent writes or updates the host application and calls the public `ichartjs` ESM API. The optional Skill provides workflow guidance only; it does not introduce a second runtime or service.
+iChart.js is a JavaScript UI component library. The coding Agent writes or updates the host application and calls the public `@taylorwong/ichartjs` ESM API. The optional Skill provides workflow guidance only; it does not introduce a second runtime or service.
 
 Do not add a CLI, MCP server, HTTP API, or Python adapter to complete an ordinary charting task.
 
@@ -16,7 +16,7 @@ Inside a consumer project:
 npm install @taylorwong/ichartjs@^2
 ```
 
-Do not install the unscoped npm registry package named `ichartjs`; it is currently an npm security holding package. Use the GitHub source until the project publishes under a confirmed npm scope.
+Do not install the unscoped npm registry package named `ichartjs`; it is an npm security holding package and is not this project. The published package is `@taylorwong/ichartjs`.
 
 Inside this repository:
 
@@ -46,7 +46,7 @@ If the host supports named Skill invocation, the request may start with `Use $ic
 ## Required Workflow
 
 1. Inspect existing application structure and local instructions.
-2. Import public APIs from `ichartjs`.
+2. Import public APIs from `@taylorwong/ichartjs`.
 3. Call `getCapabilities()`, `inspectData()`, and `planChart()`.
 4. Stop or ask for input when required fields are missing.
 5. Build a JSON-friendly Spec and call `validateSpec()`.
@@ -80,7 +80,7 @@ Use `examples/agent-workflow.mjs` for the full executable lifecycle.
 
 ## Acceptance
 
-- The application imports only `ichartjs`, not source internals.
+- The application imports only `@taylorwong/ichartjs`, not source internals.
 - The chosen chart exists in capabilities.
 - Validation passes before rendering.
 - Warnings and assumptions remain visible.

package/docs/agent/development/2.0-release-readiness.md

@@ -1,5 +1,7 @@
 # iChart.js 2.0 Final Release Readiness
 
+> Historical record. This document describes the original `2.0.0` source-release decision and is superseded by the published `2.0.x` release line. Use `release-sop.md` for current releases.
+
 Date: 2026-09-16
 
 ## Decision

package/docs/agent/development/iteration-8.md

@@ -6,7 +6,7 @@ Turn the existing chart catalog into a dependable, commonly complete, and Agent-
 
 ## Current Delivery
 
-Iteration 8A–8D is complete. The runtime exposes per-chart capability profiles, deterministic Agent planning and explanation, richer data inspection and diagnostics, common chart presentation behavior, corrected chart geometry, dedicated interaction/accessibility/performance labs, and a maintained full Gallery. Automated, Chromium, Firefox, WebKit, native Safari, 390 px responsive, lifecycle, and local performance acceptance passed. Physical iOS/Android checks remain a recorded host/device follow-up. See `docs/agent/development/iteration-8-acceptance.md`.
+Iteration 8A–8D is complete. The runtime exposes per-chart capability profiles, deterministic Agent planning and explanation, richer data inspection and diagnostics, common chart presentation behavior, corrected chart geometry, dedicated interaction/accessibility/performance labs, and a maintained full Gallery. Automated, Chromium, Firefox, WebKit, native Safari, 390 px responsive, lifecycle, and local performance acceptance passed. Physical iOS/Android checks remain a recorded host/device follow-up. Acceptance record is captured below in **§ Acceptance Record**.
 
 ## Scope Policy
 
@@ -114,3 +114,57 @@ Iteration 8A–8D is complete. The runtime exposes per-chart capability profiles
 ## Completion Definition
 
 Iteration 8 is complete when all existing chart types provide their applicable common features reliably; unsupported behavior is explicitly discoverable; an Agent can select, configure, validate, render, explain, and verify charts without reading source code; SVG and Canvas semantics are consistent; browser, mobile, accessibility, performance, lifecycle, packaging, and preview gates are recorded; and the repository is ready for a final iChart.js 2.0 release decision without adding new chart types.
+
+## Acceptance Record
+
+Date: 2026-09-16
+
+### Result
+
+Iteration 8A–8D is implemented and accepted for the repository runtime, public Agent contracts, maintained Playground pages, responsive browser viewport, lifecycle checks, and repeatable performance fixtures. Chromium, Firefox 144, WebKit 26, and native Safari 26.6.2 checks pass. Physical iOS/Android checks remain a separately recorded host/device follow-up.
+
+### Automated Evidence
+
+- `npm run agent:check`: passed.
+- `git diff --check`: passed.
+- Core tests: 51 passed, 0 failed.
+- Agent documentation check: 16 charts, 24 commands, and 7 schemas.
+- Syntax check: every `src/*.mjs` file passed `node --check`.
+- Node.js 18.20.8, 20.20.2, and 22.22.2: Agent checks and the executable Agent workflow passed.
+- Package-consumer coverage: public ESM imports, capability discovery, planning, validation, explanation, chart creation, lifecycle, and active Playground entry files are covered by the core suite.
+
+### Browser Evidence
+
+- Environments: Codex in-app Chromium, Playwright Firefox 144, and Playwright WebKit 26 against `npm run playground` on `127.0.0.1:3000`.
+- Full Gallery: all 16 public chart types rendered; 0 error cards and no uncaught page errors.
+- Renderer switch: all Gallery cases rendered with SVG when forced; default mixed SVG/Canvas cases also passed.
+- Responsive checks: desktop and a true 390 x 844 viewport completed without body overflow.
+- Agent Workbench: `id` remained a stable identifier, `month` was selected as the dimension, validation passed, record IDs were preserved, and the expected missing-value warning remained visible.
+- Interaction Lab: zoom in, zoom out to the full window, pan, reset, selection clearing, keyboard behavior, and Canvas switching passed.
+- Accessibility Lab: Line, Pie, Heatmap, Radar, Gantt, and Flow exposed role, accessible label, focusability, and family-specific semantic output.
+- Regression pages: Foundational Gallery, Project Intelligence, Business Editing, and Diagram Editor loaded with ready states and no uncaught page errors.
+- Lifecycle fixture: 25 create/destroy cycles left 0 chart children and 0 tooltips.
+- Firefox/WebKit matrix: 22/22 desktop and 390 x 844 touch-viewport page scenarios passed after fixing Project Intelligence grid shrink behavior and redundant ResizeObserver rendering.
+- Native Safari 26.6.2: 11/11 desktop and 390 x 844 page scenarios passed without horizontal overflow.
+
+### Performance Sample
+
+These are local acceptance samples, not universal device budgets.
+
+| Scenario | Renderer | Create | Resize | JSON export |
+| --- | --- | ---: | ---: | ---: |
+| Line, 100 rows | Canvas | 1.7 ms | 0.6 ms | 0.1 ms |
+| Line, 1,000 rows | Canvas | 6.3 ms | 4.9 ms | 0.3 ms |
+| Line, 5,000 rows, Firefox | Canvas | 110 ms | 96 ms | 3 ms |
+| Line, 5,000 rows, WebKit | Canvas | 81 ms | 75 ms | 2 ms |
+| Heatmap, 5,000 rows, Firefox | Canvas | 19 ms | 15 ms | 2 ms |
+| Heatmap, 5,000 rows, WebKit | Canvas | 15 ms | 10 ms | 2 ms |
+
+The Performance Lab also includes repeatable 5,000-row Line, Heatmap, Gantt, and Diagram scenarios for release-host measurements.
+
+### Post-release Host/Device Follow-up
+
+- Physical-device touch acceptance on iOS and Android.
+- Release-host performance budgets across representative low-end and high-end devices.
+
+These checks remain important integration evidence, but the three-engine browser matrix, native Safari run, responsive touch viewport, and deterministic local performance fixtures are sufficient for the 2.0 source release.

package/docs/agent/development/release-sop.md

@@ -0,0 +1,73 @@
+# Release SOP — @taylorwong/ichartjs (AUTHOR ONLY)
+
+> **Scope / Permissions:** Release actions (npm publish + develop→master merge + git tag push)
+> are **exclusively for the package author**. Requires:
+> - GitHub write access to `wanghetommy/ichartjs` (master + develop + tags)
+> - npm login session as `taylorwong` (2FA or PAT with bypass-2fa enabled)
+> - No contributor / secondary account should run these steps.
+>
+> **Agent Policy:** An Agent MUST NOT initiate any step in this SOP on its own.
+> It MAY execute the sequence **only when explicitly instructed** by the author
+> (e.g. "publish v2.0.4", "commit and release patch", or equivalent intent).
+
+## 0. Preconditions (MUST ALL be green)
+
+0.  `git status -sb` → on `develop`, working tree clean
+1.  `npm run check` → exit 0
+2.  `npm test` → exit 0 (60/60)
+3.  `npm run docs:check` → exit 0
+4.  `npm run agent:check` → exit 0
+5.  `npm whoami` → output = `taylorwong`
+6.  `npm config get registry` → output = `https://registry.npmjs.org/`
+
+## 1. Develop bump & commit
+
+7.  Edit `package.json` version → semver:
+    - **patch** (x.y.Z): pure bug fix w/o API change
+    - **minor** (x.Y.0): backward-compatible new feature(s)
+    - **major** (X.0.0): breaking API change
+8.  `git add -A`
+9.  `git commit -m "<prefix>: <one short English sentence>"`
+    - allowed `<prefix>`: `fix | feat | chore | docs | refactor | perf | test`
+    - ❌ no Chinese, ❌ no multi-line body, ❌ no long run-on sentences
+
+## 2. Tag + push develop
+
+10. `git tag vX.Y.Z` matching `package.json#version` exactly
+11. `git push origin develop --tags`
+
+## 3. NPM publish
+
+12. `npm publish` (package.json already declares `publishConfig.access=public` + npmjs registry)
+    - If 2FA challenged: `npm publish --otp=<6-digit OTP or PAT>`
+    - Successful stdout MUST include: `+ @taylorwong/ichartjs@X.Y.Z`
+13. Verify availability (CDN may take 1–2 min; failure to query immediately is OK as long as publish exited 0):
+    ```bash
+    npm view @taylorwong/ichartjs versions --json   # should include X.Y.Z within ~2 min
+    curl -sfI https://unpkg.com/@taylorwong/ichartjs@X.Y.Z/src/index.mjs   # HTTP 200
+    ```
+
+## 4. Merge develop → master
+
+14. `git checkout master && git pull --rebase origin master`
+15. `git merge --no-ff develop -m "Merge develop into master (vX.Y.Z: <one short English summary>)"`
+    - MUST use `--no-ff` so release rollback can target a single merge commit
+16. `git push origin master`
+
+## 5. Final state
+
+17. `git status -sb` → `## master...origin/master` clean, no ahead/behind
+18. `git branch -a` → `master` and `develop` both present; if desired, `git checkout develop` to resume default branch
+
+## MUST NOT
+
+- ❌ Never publish **before** pushing tag / develop commit (npm version is immutable)
+- ❌ Never use `git merge --ff-only develop` into `master` (lose merge commit)
+- ❌ Never commit release with Chinese text, emoji, or commit message body > 1 line
+- ❌ Never initiate publishing without the author's explicit instruction (Agent rule)
+
+## Rollback (if required)
+
+- Within 72h of publish: `npm unpublish @taylorwong/ichartjs@X.Y.Z` (follow npm ToS)
+- After 72h: `npm deprecate @taylorwong/ichartjs@X.Y.Z "message"` and release next patch
+- Git: `git revert <merge-commit-hash>` on master, then push; **do not force-push master**

package/docs/agent/development/roadmap.md

@@ -1,6 +1,6 @@
 # iChart.js 2.0 Roadmap
 
-> Roadmap baseline: 2026-09-14. Geographic charts and 3D rendering remain out of scope until explicitly reintroduced.
+> Roadmap baseline: 2026-09-14. Current release status: `v2.0.3` is published and `v2.0.4` is the documentation/version-consistency patch release. Geographic charts and 3D rendering remain out of scope until explicitly reintroduced.
 
 ## Current Status
 
@@ -11,8 +11,8 @@
 - Iteration 6 project intelligence local runtime and browser acceptance are complete.
 - Iteration 7 local runtime and browser acceptance are complete for foundational composition, Heatmap, and Radar; physical-device checks remain host integration evidence.
 - Iteration 8A–8D is complete and accepted in automated tests, Chromium, Firefox 144, WebKit 26, native Safari 26.6.2, and a 390 px touch viewport. Physical iOS/Android and representative release-host measurements remain post-release host/device follow-up. No new public chart type was introduced.
-- Iteration 9A–9D implements the lightweight visual style system, adaptive theme planning, runtime switching, renderer integration, and bilingual Agent guidance without adding a chart type or changing version `2.0.0`.
-- Final `2.0.0` readiness is tracked in `docs/agent/development/2.0-release-readiness.md`; strict TypeScript, Node.js 18/20/22, GitHub Actions, package-consumer, browser, performance, and lifecycle checks pass. Only the final commit, `master` cutover, tag, and GitHub Release remain. npm publication is tracked separately.
+- Iteration 9A–9D implemented the lightweight visual style system, adaptive theme planning, runtime switching, renderer integration, and bilingual Agent guidance without adding a chart type; these capabilities remain in the `2.0.x` line.
+- The original `2.0.0` readiness record is historical and superseded by the published `2.0.x` releases. Current release checks are defined by `docs/agent/development/release-sop.md`.
 
 ## Iteration 4 — Agent Data Contract and Business Editing
 

package/docs/agent/frontend-integration.md

@@ -8,7 +8,7 @@ Use iChart.js as an ordinary JavaScript UI component inside a browser applicatio
 npm install @taylorwong/ichartjs@^2
 ```
 
-For environments without npm registry access, install from GitHub as a fallback: `npm install github:wanghetommy/ichartjs#v2.0.1`.
+For environments without npm registry access, install from GitHub as a fallback: `npm install github:wanghetommy/ichartjs#v2.0.4`.
 
 Use the package through a bundler or another environment that resolves npm ESM imports:
 

package/docs/agent/quickstart.md

@@ -15,14 +15,14 @@ import {
 } from '@taylorwong/ichartjs';
 ```
 
-Agents and developers use the same `ichartjs` ESM entry. Agent behavior comes from the public planning APIs and optional Skill, not from a second runtime.
+Agents and developers use the same `@taylorwong/ichartjs` ESM entry. Agent behavior comes from the public planning APIs and optional Skill, not from a second runtime.
 
 Additional package resources:
 
-- `ichartjs/capabilities.json`: machine-readable catalog, including per-chart exports, branding, and interaction declarations.
-- `ichartjs/recipes/foundational-analysis`: foundational chart recipes.
-- `ichartjs/recipes/project-management`: project intelligence recipes.
-- `ichartjs/recipes/diagrams/workflow`: diagram editing recipe.
+- `@taylorwong/ichartjs/capabilities.json`: machine-readable catalog, including per-chart exports, branding, and interaction declarations.
+- `@taylorwong/ichartjs/recipes/foundational-analysis`: foundational chart recipes.
+- `@taylorwong/ichartjs/recipes/project-management`: project intelligence recipes.
+- `@taylorwong/ichartjs/recipes/diagrams/workflow`: diagram editing recipe.
 - `skills/ichartjs/SKILL.md`: optional workflow adapter for Codex, WorkBuddy, and other Agent Skills-compatible hosts.
 
 The Skill is not the runtime. Install or register it only when the Agent host supports Skills; it must still call the package's public APIs and capability contract.

package/docs/agent/zh-CN/coding-agent-integration.md

@@ -14,7 +14,7 @@ iChart.js 是 JavaScript UI 图表组件库。编码 Agent 负责修改宿主前
 npm install @taylorwong/ichartjs@^2
 ```
 
-npm Registry 中无作用域的 `ichartjs` 当前是安全占位包，并非本项目。正式 npm scope 确认前请从 GitHub 安装。
+npm Registry 中无作用域的 `ichartjs` 是安全占位包，并非本项目。正式包名是 `@taylorwong/ichartjs`，优先从 npm 安装。
 
 Codex、WorkBuddy 和其他兼容 Agent Skills 的宿主可共同使用 `skills/ichartjs`。从仓库检出目录安装到 Codex：
 

package/docs/agent/zh-CN/diagram-scenario.md

@@ -9,13 +9,13 @@
 
 ## 当前能力
 
-已支持节点、边、泳道、Group、Port、四种布局、三种路由、节点拖动、多选、对齐、网格吸附、键盘移动和 Undo/Redo。
+已支持节点、边、泳道、Group、Port、四种布局、三种路由、节点拖动、多选、对齐、网格吸附、键盘移动、Copy/Paste、Group 折叠展开、Port 键盘连线和 Undo/Redo。
 
 当前限制：
 
 - Group 只支持平级 Group，不支持嵌套。
-- Port 可显示并参与路由，但 Port 拖拽连线尚未完成。
-- Copy/Paste 和 Group 折叠展开尚未完成。
+- Group bounds 由成员几何和 `group.padding` 推导；`resizeGroup` 会缩放成员位置和尺寸，不持久化第二个 Group 矩形。
+- Canvas 提供基础无障碍文本，SVG 提供更丰富的 Diagram 语义。
 
 ## Agent 流程
 

package/docs/agent/zh-CN/frontend-integration.md

@@ -6,7 +6,7 @@ iChart.js 应作为普通 JavaScript UI 组件运行在浏览器应用中。数
 npm install @taylorwong/ichartjs@^2
 ```
 
-无法访问 npm Registry 的环境请用 GitHub 源作为后备：`npm install github:wanghetommy/ichartjs#v2.0.1`。
+无法访问 npm Registry 的环境请用 GitHub 源作为后备：`npm install github:wanghetommy/ichartjs#v2.0.4`。
 
 ```js
 import { createChart } from '@taylorwong/ichartjs';

package/docs/agent/zh-CN/quickstart.md

@@ -15,9 +15,9 @@ import {
 } from '@taylorwong/ichartjs';
 ```
 
-- `ichartjs`：统一的 Agent 规划与 Runtime API。
-- `ichartjs/capabilities.json`：机器可读能力清单，包含逐图表导出、署名和交互声明。
-- `ichartjs/recipes/*`：基础分析、项目管理和 Diagram Recipes。
+- `@taylorwong/ichartjs`：统一的 Agent 规划与 Runtime API。
+- `@taylorwong/ichartjs/capabilities.json`：机器可读能力清单，包含逐图表导出、署名和交互声明。
+- `@taylorwong/ichartjs/recipes/*`：基础分析、项目管理和 Diagram Recipes。
 - `skills/ichartjs/SKILL.md`：适用于 Codex、WorkBuddy 等 Agent Skills 兼容宿主的可选编排层。
 
 Agent 与开发者使用同一个 ESM 入口。编码 Agent 的完整方式见 [编码 Agent 集成](coding-agent-integration.md)，普通应用集成见 [前端项目集成](frontend-integration.md)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taylorwong/ichartjs",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Agent-first, renderer-independent charting and project visualization runtime",
   "type": "module",
   "main": "./src/index.mjs",

package/skills/ichartjs/SKILL.md

@@ -35,7 +35,7 @@ Do not install the unscoped npm registry package named `ichartjs`; it is current
 10. Provide an exact preview URL or artifact path and report assumptions, warnings, and deferred checks.
 11. Prefer `theme: { mode: 'auto', preset, palette }`; preserve explicit user style choices and use `chart.setTheme()` for live switching.
 
-Use `ichartjs` for package imports. Use `examples/agent-workflow.mjs` as the executable baseline when working in the repository.
+Use `@taylorwong/ichartjs` for package imports. Use `examples/agent-workflow.mjs` as the executable baseline when working in the repository.
 
 ## Task Routing
 
@@ -44,6 +44,7 @@ Use `ichartjs` for package imports. Use `examples/agent-workflow.mjs` as the exe
 - For Flow or Swimlane, preserve node, edge, lane, group, and port IDs; use diagram recipes and validated edit commands.
 - For business edits, preview first, preserve the preview ID and revision, require confirmation when declared, then commit or reject atomically.
 - For browser deliverables, start `npm run playground` and return the exact maintained Playground URL.
+- Release workflow (npm publish + develop→master merge) is **AUTHOR ONLY**. Read the release SOP in [`docs/agent/development/release-sop.md`](../../docs/agent/development/release-sop.md). Never initiate any release step unless the author explicitly instructs.
 
 ## Guardrails
 

package/src/index.mjs

@@ -559,4 +559,4 @@ export { normalizeProjectCalendar, applyWorkingCalendar, normalizeDependencies,
 export { normalizeLinkedFilters, normalizeLinkedSelection, filterProjectRows, createLinkedProjectState, linkedRecordId };
 
 export { contrastRatio, planStyle, resolveTheme, styleCapabilities, themeModes, themePalettes, themePresets, validateThemeContrast, annotationPlugin, dataZoomPlugin, dataLabelsPlugin, accessibilityPlugin };
-export const iChart = { version: '2.0.0', createChart, inspectData, normalizeData, binData, applyTransforms, normalizeSpec, validateSpec, data, getCapabilities, getChartCapability, planChart, recommend, explainChart, contrastRatio, planStyle, resolveTheme, styleCapabilities, themeModes, themePalettes, themePresets, validateThemeContrast, annotationPlugin, dataZoomPlugin, dataLabelsPlugin, accessibilityPlugin, getBusinessSchema, inspectDataSchema, validateData, getEditCapabilities, validateEdit, previewEdit, commitPreview, validateRecipe, normalizeProjectCalendar, applyWorkingCalendar, normalizeDependencies, analyzeSchedule, analyzeBurndownSeries, analyzeCapacity, buildCapacityView, buildCumulativeFlowSeries, buildVelocitySeries, buildReleaseForecast, buildRiskMatrixSeries, buildIssueAgingSeries, normalizeLinkedFilters, normalizeLinkedSelection, filterProjectRows, createLinkedProjectState, linkedRecordId };
+export const iChart = { version: '2.0.4', createChart, inspectData, normalizeData, binData, applyTransforms, normalizeSpec, validateSpec, data, getCapabilities, getChartCapability, planChart, recommend, explainChart, contrastRatio, planStyle, resolveTheme, styleCapabilities, themeModes, themePalettes, themePresets, validateThemeContrast, annotationPlugin, dataZoomPlugin, dataLabelsPlugin, accessibilityPlugin, getBusinessSchema, inspectDataSchema, validateData, getEditCapabilities, validateEdit, previewEdit, commitPreview, validateRecipe, normalizeProjectCalendar, applyWorkingCalendar, normalizeDependencies, analyzeSchedule, analyzeBurndownSeries, analyzeCapacity, buildCapacityView, buildCumulativeFlowSeries, buildVelocitySeries, buildReleaseForecast, buildRiskMatrixSeries, buildIssueAgingSeries, normalizeLinkedFilters, normalizeLinkedSelection, filterProjectRows, createLinkedProjectState, linkedRecordId };

package/docs/agent/development/iteration-8-acceptance.md

@@ -1,68 +0,0 @@
-# Iteration 8 Acceptance Record
-
-Date: 2026-09-16
-
-## Result
-
-Iteration 8A–8D is implemented and accepted for the repository runtime, public Agent contracts, maintained Playground pages, responsive browser viewport, lifecycle checks, and repeatable performance fixtures. Chromium, Firefox 144, WebKit 26, and native Safari 26.6.2 checks pass. Physical iOS/Android checks remain a separately recorded host/device follow-up.
-
-## Automated Evidence
-
-- `npm run agent:check`: passed.
-- `git diff --check`: passed.
-- Core tests: 51 passed, 0 failed.
-- Agent documentation check: 16 charts, 24 commands, and 7 schemas.
-- Syntax check: every `src/*.mjs` file passed `node --check`.
-- Node.js 18.20.8, 20.20.2, and 22.22.2: Agent checks and the executable Agent workflow passed.
-- Package-consumer coverage: public ESM imports, capability discovery, planning, validation, explanation, chart creation, lifecycle, and active Playground entry files are covered by the core suite.
-
-## Browser Evidence
-
-- Environments: Codex in-app Chromium, Playwright Firefox 144, and Playwright WebKit 26 against `npm run playground` on `127.0.0.1:3000`.
-- Full Gallery: all 16 public chart types rendered; 0 error cards and no uncaught page errors.
-- Renderer switch: all Gallery cases rendered with SVG when forced; default mixed SVG/Canvas cases also passed.
-- Responsive checks: desktop and a true 390 x 844 viewport completed without body overflow.
-- Agent Workbench: `id` remained a stable identifier, `month` was selected as the dimension, validation passed, record IDs were preserved, and the expected missing-value warning remained visible.
-- Interaction Lab: zoom in, zoom out to the full window, pan, reset, selection clearing, keyboard behavior, and Canvas switching passed.
-- Accessibility Lab: Line, Pie, Heatmap, Radar, Gantt, and Flow exposed role, accessible label, focusability, and family-specific semantic output.
-- Regression pages: Foundational Gallery, Project Intelligence, Business Editing, and Diagram Editor loaded with ready states and no uncaught page errors.
-- Lifecycle fixture: 25 create/destroy cycles left 0 chart children and 0 tooltips.
-- Firefox/WebKit matrix: 22/22 desktop and 390 x 844 touch-viewport page scenarios passed after fixing Project Intelligence grid shrink behavior and redundant ResizeObserver rendering.
-- Native Safari 26.6.2: 11/11 desktop and 390 x 844 page scenarios passed without horizontal overflow.
-
-## Performance Sample
-
-These are local acceptance samples, not universal device budgets.
-
-| Scenario | Renderer | Create | Resize | JSON export |
-| --- | --- | ---: | ---: | ---: |
-| Line, 100 rows | Canvas | 1.7 ms | 0.6 ms | 0.1 ms |
-| Line, 1,000 rows | Canvas | 6.3 ms | 4.9 ms | 0.3 ms |
-| Line, 5,000 rows, Firefox | Canvas | 110 ms | 96 ms | 3 ms |
-| Line, 5,000 rows, WebKit | Canvas | 81 ms | 75 ms | 2 ms |
-| Heatmap, 5,000 rows, Firefox | Canvas | 19 ms | 15 ms | 2 ms |
-| Heatmap, 5,000 rows, WebKit | Canvas | 15 ms | 10 ms | 2 ms |
-
-The Performance Lab also includes repeatable 5,000-row Line, Heatmap, Gantt, and Diagram scenarios for release-host measurements.
-
-## Preview
-
-Start the no-cache static server from the repository root:
-
-```bash
-npm run playground
-```
-
-- Home: `http://localhost:3000/playground/index.html`
-- Full Gallery: `http://localhost:3000/playground/project-gallery.html`
-- Agent Workbench: `http://localhost:3000/playground/agent-workbench.html`
-- Interaction Lab: `http://localhost:3000/playground/interaction-lab.html`
-- Accessibility Lab: `http://localhost:3000/playground/accessibility-lab.html`
-- Performance Lab: `http://localhost:3000/playground/performance-lab.html`
-
-## Post-release Host/Device Follow-up
-
-- Physical-device touch acceptance on iOS and Android.
-- Release-host performance budgets across representative low-end and high-end devices.
-
-These checks remain important integration evidence, but the three-engine browser matrix, native Safari run, responsive touch viewport, and deterministic local performance fixtures are sufficient for the 2.0 source release.