data-vizard 0.1.0 → 0.1.1

package/.claude-plugin/marketplace.json

@@ -4,14 +4,14 @@
     "name": "Trine"
   },
   "description": "Data Vizard agent workflow plugins.",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "plugins": [
     {
       "name": "data-vizard",
       "source": "./plugins/data-vizard",
       "displayName": "Data Vizard",
       "description": "Guide data visualization projects from dataset intake to analysis, narrative, design, and HTML story output.",
-      "version": "0.1.0",
+      "version": "0.1.1",
       "author": {
         "name": "Trine"
       },

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to Data Vizard will be documented here.
+
+## 0.1.1 - 2026-06-30
+
+- Added Codex plugin-directory visual assets with a consistent wizard-and-chart logo.
+- Wired `composerIcon`, `logo`, `logoDark`, and screenshot metadata into the Codex plugin manifest.
+- Made the npm installer bin executable for cleaner package execution.
+- Expanded the root and plugin READMEs with compatibility, privacy, verification, update, and release guidance.
+- Added a reproducible script for regenerating plugin visual assets.
+
+## 0.1.0 - 2026-06-30
+
+- Published the first npm installer for the Data Vizard agent workflow plugin.
+- Bundled Codex and Claude Code marketplace manifests.
+- Included five workflow skills: orchestrator, curator, analyst, narrator, and designer.
+- Added release guidance for npm install testing, Codex marketplace testing, and Claude Code compatibility checks.

package/README.md

@@ -1,53 +1,110 @@
 # Data Vizard
 
-Data Vizard is a WIP agent plugin for building data visualization stories with a staged workflow. The workflow moves from data intake to analysis, narrative framing, visual design, and a final HTML artifact while keeping user decisions explicit.
+Data Vizard is an agent plugin for building data visualization stories with a staged workflow. It guides a project from data intake to curation, exploratory analysis, narrative framing, visual design, and a final HTML artifact while keeping user decisions explicit.
 
-## Workflow
+![Data Vizard workflow](plugins/data-vizard/assets/screenshot-workflow.png)
 
-Most projects follow this path:
+## Install
 
-1. `data-vizard` coordinates the project and decision gates.
-2. `data-curator` finds, evaluates, cleans, joins, and documents data.
-3. `data-analyst` explores the curated data and proposes evidence-backed story directions.
-4. `narrator` turns the selected analytical direction into a story brief, copy, caveats, and annotation plan.
-5. `designer` chooses the visual form with the user, then builds and verifies the HTML artifact.
+Install the published package with npm, pnpm, or Bun:
 
-Project folders use lowercase hyphen-case slugs, for example `nyc-taxi-weather-jan-2026`.
+```bash
+npx data-vizard install
+pnpm dlx data-vizard install
+bunx data-vizard install
+```
 
-## Skills
+The installer copies the bundled plugin into a stable local marketplace at `~/.data-vizard/marketplace`, writes Codex and Claude Code marketplace files, and attempts to install `data-vizard@data-vizard` when those CLIs are available.
 
-The local skills live in `skills/`.
+## Quickstart
 
-- `skills/data-vizard/` - Orchestrates the full visualization workflow, routes between role skills, and maintains decision gates.
-- `skills/data-curator/` - Handles dataset discovery, data fitness checks, cleaning, reshaping, joins, enrichment, and curator handoff notes.
-- `skills/data-analyst/` - Profiles curated datasets, finds patterns and caveats, and proposes possible story directions without choosing the final story silently.
-- `skills/narrator/` - Shapes the selected analysis into audience-facing structure: story spine, titles, section copy, annotations, and caveats.
-- `skills/designer/` - Designs and produces HTML-based visualization artifacts, including chart choice, layout, interaction, accessibility, visual style, and motion behavior.
+After installing, start a new Codex thread or Claude Code session so the plugin skills are loaded.
 
-Each skill has a `SKILL.md` file with its operating rules. Some skills also include `references/` for playbooks and reusable guidance, or `assets/` for starter files.
+```text
+Codex: Use $data-vizard:data-vizard to build a visualization from this CSV.
+Claude Code: /data-vizard:data-vizard Build a visualization from this CSV.
+```
 
-## Install
+You can also call a role skill directly:
 
-Install the published package with npm, pnpm, or Bun:
+```text
+$data-vizard:data-curator
+$data-vizard:data-analyst
+$data-vizard:narrator
+$data-vizard:designer
+```
+
+![Data Vizard output example](plugins/data-vizard/assets/screenshot-output.png)
+
+## Compatibility
+
+| Host | Status | Install path | Notes |
+| --- | --- | --- | --- |
+| Codex app and CLI | Supported | `.agents/plugins/marketplace.json` plus `.codex-plugin/plugin.json` | Local and workspace plugins can appear in the Codex plugin directory through marketplaces or workspace sharing. The public OpenAI-curated directory is not a self-serve npm publishing target. |
+| Claude Code | Supported | `.claude-plugin/marketplace.json` plus `.claude-plugin/plugin.json` | Validate with `claude plugin validate` and install with `claude plugin install data-vizard@data-vizard`. |
+| npm | Supported | `bin/data-vizard.js` installer | The package ships the plugin, marketplace files, README, and changelog. |
+
+## Verify
+
+Local package checks:
 
 ```bash
-npx data-vizard install
-pnpm dlx data-vizard install
-bunx data-vizard install
+NPM_CONFIG_CACHE=/tmp/data-vizard-npm-cache npm pack --dry-run --json
+node bin/data-vizard.js install --dry-run --root /tmp/data-vizard-local-smoke
+```
+
+Published-package smoke test:
+
+```bash
+cd /tmp
+NPM_CONFIG_CACHE=/tmp/data-vizard-npm-cache npx --yes data-vizard@0.1.1 --version
+NPM_CONFIG_CACHE=/tmp/data-vizard-npm-cache npx --yes data-vizard@0.1.1 install --dry-run --root /tmp/data-vizard-published-smoke
+NPM_CONFIG_CACHE=/tmp/data-vizard-npm-cache npx --yes data-vizard@0.1.1 install --root /tmp/data-vizard-published-stage --no-codex --no-claude
 ```
 
-The installer copies the bundled plugin into a stable local marketplace at `~/.data-vizard/marketplace`, then registers and installs it for Codex and Claude Code when their CLIs are available.
+Full install verification:
+
+```bash
+npx --yes data-vizard@0.1.1 install
+codex plugin list --available --json
+claude plugin list
+```
 
-After installing, start a new agent session and invoke the orchestrator:
+Claude Code compatibility check:
 
-```text
-Codex: $data-vizard:data-vizard
-Claude Code: /data-vizard:data-vizard
+```bash
+claude plugin validate plugins/data-vizard
+claude plugin marketplace add /tmp/data-vizard-published-stage
+claude plugin install data-vizard@data-vizard --scope local
+claude plugin list
 ```
 
-## Manual Plugin Install
+## Update Or Remove
+
+Update from npm:
+
+```bash
+npx data-vizard@latest install
+```
 
-The plugin source lives in `plugins/data-vizard/`, with repo-local marketplace files for Codex and Claude Code. From a fresh clone, install it manually with:
+Remove installed plugins:
+
+```bash
+codex plugin remove data-vizard@data-vizard
+claude plugin uninstall data-vizard@data-vizard
+```
+
+After updating or removing a plugin, start a new Codex thread or Claude Code session.
+
+## Privacy And Data
+
+Data Vizard works on files and datasets you provide in the active workspace. The plugin itself does not add a server, background sync, analytics, or external app connector. Host-level model, tool, network, approval, and file-access settings still apply in Codex and Claude Code.
+
+For sensitive datasets, review source rights before importing data, avoid committing private raw files, and keep project caveats close to any published visualization.
+
+## Development Install From Clone
+
+Normal installs should use npm. This clone-based path is only for development before a version is published:
 
 ```bash
 codex plugin marketplace add "$(pwd)"
@@ -57,27 +114,19 @@ claude plugin marketplace add "$(pwd)"
 claude plugin install data-vizard@data-vizard
 ```
 
-See `plugins/data-vizard/README.md` for full install, usage, update, and troubleshooting notes.
-
-## Folder Guide
-
-- `outcome/` - Final or in-progress public-facing visualization artifacts. Each project gets its own folder, usually with an `index.html` and supporting files such as story briefs, design notes, SVG favicons, or map assets.
-- `data/` - Curated data, raw source snapshots, transformation notes, and intermediate datasets used to build a visualization.
-- `scripts/` - Reproducible data preparation scripts. For example, `scripts/build_nyc_taxi_weather_hourly.py` builds the NYC taxi/weather dataset.
-- `skills/` - Local role skills used by the Data Vizard workflow.
-- `project-ledgers/` - Project ledgers that record stage progress, skill handoffs, decisions, caveats, and important files.
-- `outcome/<project-name>/PRODUCT.md` - Project-specific product context: audience, purpose, brand personality, anti-references, design principles, and accessibility goals.
-
+The plugin source lives in `plugins/data-vizard/`. See `plugins/data-vizard/README.md` for role details, usage notes, update flow, and troubleshooting.
 
-## Current Projects
+## Package Contents
 
-- `outcome/nyc-taxi-weather-jan-2026/` - A map-led scrollytelling story about how the January 25, 2026 snow day affected NYC yellow taxi pickups.
-- `outcome/india-state-choropleth/` - An India state choropleth visualization workspace.
+- `bin/data-vizard.js` - npm installer CLI.
+- `plugins/data-vizard/` - Packaged plugin source for Codex and Claude Code.
+- `plugins/data-vizard/assets/` - Plugin icon, logo, and screenshots.
+- `CHANGELOG.md` - Release history.
 
-## Working Notes
+## Release Checklist
 
-- Keep user-facing visualization outputs under `outcome/<project-name>/`.
-- Keep curated data and transformation artifacts under `data/<project-name>/`.
-- Keep project progress notes in `project-ledgers/<project-name>.md`.
-- When adding new skills, include a clear `SKILL.md` and keep supporting guidance in that skill's `references/` folder.
-- For chart and map animations, prefer semantic data transitions: animate heights, bases, segment boundaries, filters, and scales rather than relying on opacity-only color swaps.
+- Keep `package.json`, `plugins/data-vizard/.codex-plugin/plugin.json`, `.claude-plugin/marketplace.json`, and `plugins/data-vizard/.claude-plugin/plugin.json` versions aligned.
+- Regenerate plugin assets with `python3 scripts/generate_plugin_assets.py`; pass `--source /path/to/logo.png` when replacing the canonical logo.
+- Run npm pack and installer dry-run checks before publishing.
+- Run Codex and Claude Code install checks in a fresh terminal or CI job.
+- Update `CHANGELOG.md` for every release.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-vizard",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Installer for the Data Vizard agent workflow plugin.",
   "license": "MIT",
   "author": {
@@ -29,6 +29,7 @@
     "plugins/data-vizard/",
     ".agents/plugins/marketplace.json",
     ".claude-plugin/marketplace.json",
+    "CHANGELOG.md",
     "README.md"
   ],
   "engines": {

package/plugins/data-vizard/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "data-vizard",
   "displayName": "Data Vizard",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Guide data visualization projects from dataset intake to analysis, narrative, design, and HTML story output.",
   "author": {
     "name": "Trine",

package/plugins/data-vizard/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "data-vizard",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A staged data visualization workshop for moving from dataset intake to analysis, narrative, design, and an HTML artifact.",
   "author": {
     "name": "Trine"
@@ -26,7 +26,14 @@
       "Data Analysis",
       "Visualization"
     ],
-    "brandColor": "#2563EB",
+    "brandColor": "#5B35D5",
+    "composerIcon": "./assets/icon.png",
+    "logo": "./assets/logo.png",
+    "logoDark": "./assets/logo-dark.png",
+    "screenshots": [
+      "./assets/screenshot-workflow.png",
+      "./assets/screenshot-output.png"
+    ],
     "defaultPrompt": [
       "Use Data Vizard to build a visualization from this CSV.",
       "Guide me from dataset intake to an HTML data story.",

package/plugins/data-vizard/README.md

@@ -2,11 +2,13 @@
 
 Data Vizard is an agent plugin for staged data visualization work. It bundles skills for dataset intake, curation, exploratory analysis, narrative framing, and HTML visualization design.
 
+![Data Vizard workflow](assets/screenshot-workflow.png)
+
 ## What This Plugin Provides
 
 - `data-vizard:data-vizard` - Orchestrates the full workflow and keeps user decision gates explicit.
-- `data-vizard:data-curator` - Profiles, cleans, reshapes, joins, and documents datasets.
-- `data-vizard:data-analyst` - Finds patterns, caveats, and evidence-backed story directions.
+- `data-vizard:data-curator` - Profiles, cleans, reshapes, joins, enriches, and documents datasets.
+- `data-vizard:data-analyst` - Finds patterns, caveats, comparisons, anomalies, and evidence-backed story directions.
 - `data-vizard:narrator` - Turns analysis into audience-facing structure, copy, titles, annotations, and caveats.
 - `data-vizard:designer` - Designs and builds HTML visualization artifacts with chart, layout, accessibility, interaction, and motion guidance.
 
@@ -27,7 +29,17 @@ bunx data-vizard install
 
 The installer copies this plugin into `~/.data-vizard/marketplace`, writes Codex and Claude Code marketplace files, and attempts to install `data-vizard@data-vizard` with both CLIs when available.
 
-## Install From A Fresh Clone
+## Compatibility
+
+| Host | Status | Manifest | Notes |
+| --- | --- | --- | --- |
+| Codex app and CLI | Supported | `.codex-plugin/plugin.json` | Visual plugin metadata, skills, and local marketplace install are supported. Local/workspace plugins can appear through marketplaces or workspace sharing. |
+| Claude Code | Supported | `.claude-plugin/plugin.json` | Uses a separate Claude manifest and marketplace file. Validate with `claude plugin validate`. |
+| npm | Supported | `bin/data-vizard.js` | Ships the plugin, assets, marketplace files, root README, and changelog. |
+
+## Development Install From A Fresh Clone
+
+Normal installs should use npm. This clone-based path is only for development before a version is published.
 
 Prerequisites:
 
@@ -53,21 +65,19 @@ claude plugin install data-vizard@data-vizard
 
 Why this works:
 
-- The marketplace definition lives at `.agents/plugins/marketplace.json`.
+- The Codex marketplace definition lives at `.agents/plugins/marketplace.json`.
 - The Claude Code marketplace definition lives at `.claude-plugin/marketplace.json`.
 - Both marketplaces are named `data-vizard`.
-- It points Codex to the plugin source at `./plugins/data-vizard`.
+- Both point to the plugin source at `./plugins/data-vizard`.
 
 Verify the install:
 
 ```bash
 codex plugin marketplace list
-codex plugin list
+codex plugin list --available --json
 claude plugin list
 ```
 
-You should see a `data-vizard` marketplace pointing at this repo and `data-vizard@data-vizard` listed as installed and enabled.
-
 After installing or reinstalling a plugin, start a new Codex thread or Claude Code session so the updated skills are loaded.
 
 ## Basic Usage
@@ -93,11 +103,15 @@ Use $data-vizard:narrator to turn this analysis into a story brief.
 Use $data-vizard:designer to build the HTML visualization.
 ```
 
-The default workflow stores project artifacts in the repo:
+The orchestrator confirms where project artifacts should live in the active workspace before creating or changing files.
+
+![Data Vizard output example](assets/screenshot-output.png)
 
-- `data/<project-name>/` - Raw snapshots, curated data, data dictionaries, and analysis files.
-- `outcome/<project-name>/` - Final or in-progress visualization artifacts, usually including `index.html`.
-- `project-ledgers/<project-name>.md` - Stage progress, user decisions, caveats, and handoffs.
+## Privacy And Data
+
+Data Vizard works on files and datasets you provide in the active workspace. The plugin does not add a server, background sync, analytics, or external app connector. Codex and Claude Code host settings still control model access, file permissions, network access, and command approvals.
+
+For sensitive datasets, review source rights before importing data, keep private raw files out of commits, and document caveats close to any public-facing claims.
 
 ## Updating After Pulling Changes
 
@@ -111,6 +125,33 @@ claude plugin install data-vizard@data-vizard
 
 Then start a new Codex thread or Claude Code session. If Codex or Claude Code still shows an older version, confirm that the plugin manifests under `plugins/data-vizard/` have a new version, then reinstall again.
 
+## Release Checks
+
+Local package checks:
+
+```bash
+NPM_CONFIG_CACHE=/tmp/data-vizard-npm-cache npm pack --dry-run --json
+node bin/data-vizard.js install --dry-run --root /tmp/data-vizard-local-smoke
+```
+
+Published-package smoke test:
+
+```bash
+cd /tmp
+NPM_CONFIG_CACHE=/tmp/data-vizard-npm-cache npx --yes data-vizard@0.1.1 --version
+NPM_CONFIG_CACHE=/tmp/data-vizard-npm-cache npx --yes data-vizard@0.1.1 install --dry-run --root /tmp/data-vizard-published-smoke
+NPM_CONFIG_CACHE=/tmp/data-vizard-npm-cache npx --yes data-vizard@0.1.1 install --root /tmp/data-vizard-published-stage --no-codex --no-claude
+```
+
+Claude Code compatibility check:
+
+```bash
+claude plugin validate plugins/data-vizard
+claude plugin marketplace add /tmp/data-vizard-published-stage
+claude plugin install data-vizard@data-vizard --scope local
+claude plugin list
+```
+
 ## Troubleshooting
 
 If Codex says: