data-vizard 0.0.1 → 0.1.1

package/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "data-vizard",
+  "interface": {
+    "displayName": "Data Vizard"
+  },
+  "plugins": [
+    {
+      "name": "data-vizard",
+      "source": {
+        "source": "local",
+        "path": "./plugins/data-vizard"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

package/.claude-plugin/marketplace.json

@@ -0,0 +1,30 @@
+{
+  "name": "data-vizard",
+  "owner": {
+    "name": "Trine"
+  },
+  "description": "Data Vizard agent workflow plugins.",
+  "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.1",
+      "author": {
+        "name": "Trine"
+      },
+      "repository": "https://github.com/inosaint/data-vizard",
+      "license": "MIT",
+      "keywords": [
+        "data-visualization",
+        "storytelling",
+        "csv",
+        "analysis",
+        "html"
+      ],
+      "category": "Productivity"
+    }
+  ]
+}

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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Trine
+
+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

@@ -0,0 +1,132 @@
+# Data Vizard
+
+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.
+
+![Data Vizard workflow](plugins/data-vizard/assets/screenshot-workflow.png)
+
+## Install
+
+Install the published package with npm, pnpm, or Bun:
+
+```bash
+npx data-vizard install
+pnpm dlx data-vizard install
+bunx data-vizard install
+```
+
+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.
+
+## Quickstart
+
+After installing, start a new Codex thread or Claude Code session so the plugin skills are loaded.
+
+```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.
+```
+
+You can also call a role skill directly:
+
+```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
+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
+```
+
+Full install verification:
+
+```bash
+npx --yes data-vizard@0.1.1 install
+codex plugin list --available --json
+claude plugin list
+```
+
+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
+```
+
+## Update Or Remove
+
+Update from npm:
+
+```bash
+npx data-vizard@latest install
+```
+
+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)"
+codex plugin add data-vizard@data-vizard
+
+claude plugin marketplace add "$(pwd)"
+claude plugin install data-vizard@data-vizard
+```
+
+The plugin source lives in `plugins/data-vizard/`. See `plugins/data-vizard/README.md` for role details, usage notes, update flow, and troubleshooting.
+
+## Package Contents
+
+- `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.
+
+## Release Checklist
+
+- 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/bin/data-vizard.js

@@ -1,2 +1,362 @@
 #!/usr/bin/env node
-console.log("Data Vizard installer coming soon.");
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const PACKAGE_ROOT = path.resolve(__dirname, "..");
+const PLUGIN_NAME = "data-vizard";
+const MARKETPLACE_NAME = "data-vizard";
+const DISPLAY_NAME = "Data Vizard";
+
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  if (!command || command === "--help" || command === "-h") {
+    printHelp();
+    return;
+  }
+
+  if (command === "--version" || command === "-v") {
+    console.log(readPackageJson().version);
+    return;
+  }
+
+  if (command === "install") {
+    install(args.slice(1));
+    return;
+  }
+
+  console.error(`Unknown command: ${command}`);
+  printHelp();
+  process.exitCode = 1;
+}
+
+function printHelp() {
+  console.log(`Data Vizard
+
+Usage:
+  data-vizard install [options]
+
+Options:
+  --root <path>      Stable marketplace root to write. Default: ~/.data-vizard/marketplace
+  --no-codex        Stage files but skip Codex CLI registration/install.
+  --no-claude       Stage files but skip Claude Code CLI registration/install.
+  --dry-run         Print planned actions without writing files or running CLIs.
+  -h, --help        Show this help.
+  -v, --version     Show package version.
+`);
+}
+
+function install(args) {
+  const options = parseInstallOptions(args);
+  const packageJson = readPackageJson();
+  const marketplaceRoot = path.resolve(
+    expandHome(options.root || path.join(os.homedir(), ".data-vizard", "marketplace")),
+  );
+  const sourcePluginDir = path.join(PACKAGE_ROOT, "plugins", PLUGIN_NAME);
+  const targetPluginDir = path.join(marketplaceRoot, "plugins", PLUGIN_NAME);
+
+  if (!fs.existsSync(sourcePluginDir)) {
+    throw new Error(`Bundled plugin not found at ${sourcePluginDir}`);
+  }
+
+  const codexMarketplacePath = path.join(marketplaceRoot, ".agents", "plugins", "marketplace.json");
+  const claudeMarketplacePath = path.join(marketplaceRoot, ".claude-plugin", "marketplace.json");
+
+  console.log(`${DISPLAY_NAME} installer ${packageJson.version}`);
+  console.log(`Marketplace root: ${marketplaceRoot}`);
+
+  if (options.dryRun) {
+    console.log(`Would copy ${sourcePluginDir} -> ${targetPluginDir}`);
+    console.log(`Would write ${codexMarketplacePath}`);
+    console.log(`Would write ${claudeMarketplacePath}`);
+  } else {
+    copyPlugin(sourcePluginDir, targetPluginDir);
+    writeJson(codexMarketplacePath, createCodexMarketplace());
+    writeJson(claudeMarketplacePath, createClaudeMarketplace(packageJson.version));
+    console.log("Staged Data Vizard marketplace files.");
+  }
+
+  const stagedOnly = options.noCodex && options.noClaude;
+  if (!options.noCodex) {
+    installCodex(marketplaceRoot, options.dryRun);
+  }
+
+  if (!options.noClaude) {
+    installClaude(marketplaceRoot, options.dryRun);
+  }
+
+  if (stagedOnly) {
+    printManualCommands(marketplaceRoot);
+  }
+
+  console.log("");
+  console.log("Start a new Codex thread and use $data-vizard:data-vizard.");
+  console.log("Start a new Claude Code session and use /data-vizard:data-vizard.");
+}
+
+function parseInstallOptions(args) {
+  const options = {
+    root: null,
+    noCodex: false,
+    noClaude: false,
+    dryRun: false,
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+
+    if (arg === "--root") {
+      const value = args[index + 1];
+      if (!value) {
+        throw new Error("--root requires a path");
+      }
+      options.root = value;
+      index += 1;
+    } else if (arg === "--no-codex") {
+      options.noCodex = true;
+    } else if (arg === "--no-claude") {
+      options.noClaude = true;
+    } else if (arg === "--dry-run") {
+      options.dryRun = true;
+    } else if (arg === "--help" || arg === "-h") {
+      printHelp();
+      process.exit(0);
+    } else {
+      throw new Error(`Unknown install option: ${arg}`);
+    }
+  }
+
+  return options;
+}
+
+function copyPlugin(sourcePluginDir, targetPluginDir) {
+  fs.rmSync(targetPluginDir, { recursive: true, force: true });
+  fs.mkdirSync(path.dirname(targetPluginDir), { recursive: true });
+  fs.cpSync(sourcePluginDir, targetPluginDir, {
+    recursive: true,
+    dereference: true,
+    filter: (source) => !source.includes(`${path.sep}.DS_Store`),
+  });
+}
+
+function createCodexMarketplace() {
+  return {
+    name: MARKETPLACE_NAME,
+    interface: {
+      displayName: DISPLAY_NAME,
+    },
+    plugins: [
+      {
+        name: PLUGIN_NAME,
+        source: {
+          source: "local",
+          path: `./plugins/${PLUGIN_NAME}`,
+        },
+        policy: {
+          installation: "AVAILABLE",
+          authentication: "ON_INSTALL",
+        },
+        category: "Productivity",
+      },
+    ],
+  };
+}
+
+function createClaudeMarketplace(version) {
+  return {
+    name: MARKETPLACE_NAME,
+    owner: {
+      name: "Trine",
+    },
+    description: "Data Vizard agent workflow plugins.",
+    version,
+    plugins: [
+      {
+        name: PLUGIN_NAME,
+        source: `./plugins/${PLUGIN_NAME}`,
+        displayName: DISPLAY_NAME,
+        description:
+          "Guide data visualization projects from dataset intake to analysis, narrative, design, and HTML story output.",
+        version,
+        author: {
+          name: "Trine",
+        },
+        repository: "https://github.com/inosaint/data-vizard",
+        license: "MIT",
+        keywords: ["data-visualization", "storytelling", "csv", "analysis", "html"],
+        category: "Productivity",
+      },
+    ],
+  };
+}
+
+function installCodex(marketplaceRoot, dryRun) {
+  console.log("");
+  console.log("Codex");
+
+  const addArgs = ["plugin", "marketplace", "add", marketplaceRoot];
+  const installArgs = ["plugin", "add", `${PLUGIN_NAME}@${MARKETPLACE_NAME}`];
+
+  if (dryRun) {
+    console.log(`Would run: codex ${addArgs.map(shellQuote).join(" ")}`);
+    console.log(`Would run: codex ${installArgs.join(" ")}`);
+    return;
+  }
+
+  if (!commandExists("codex")) {
+    console.log("Codex CLI was not found on PATH.");
+    printCodexCommands(marketplaceRoot);
+    return;
+  }
+
+  const add = run("codex", addArgs);
+  if (!add.ok) {
+    console.warn("Could not register the Codex marketplace automatically.");
+    printCommandOutput(add);
+    console.warn("Continuing in case the marketplace was already registered.");
+  }
+
+  const pluginInstall = run("codex", installArgs);
+  if (pluginInstall.ok) {
+    console.log("Installed data-vizard@data-vizard in Codex.");
+  } else {
+    console.warn("Could not install the Codex plugin automatically.");
+    printCommandOutput(pluginInstall);
+    printCodexCommands(marketplaceRoot);
+  }
+}
+
+function installClaude(marketplaceRoot, dryRun) {
+  console.log("");
+  console.log("Claude Code");
+
+  const marketplaceArgs = ["plugin", "marketplace", "add", marketplaceRoot];
+  const installArgs = ["plugin", "install", `${PLUGIN_NAME}@${MARKETPLACE_NAME}`];
+
+  if (dryRun) {
+    console.log(`Would run: claude ${marketplaceArgs.map(shellQuote).join(" ")}`);
+    console.log(`Would run: claude ${installArgs.join(" ")}`);
+    return;
+  }
+
+  if (!commandExists("claude")) {
+    console.log("Claude Code CLI was not found on PATH.");
+    printClaudeCommands(marketplaceRoot);
+    return;
+  }
+
+  const add = run("claude", marketplaceArgs);
+  if (!add.ok) {
+    console.warn("Could not register the Claude Code marketplace automatically.");
+    printCommandOutput(add);
+    console.warn("Continuing in case the marketplace was already registered.");
+  }
+
+  const pluginInstall = run("claude", installArgs);
+  if (pluginInstall.ok) {
+    console.log("Installed data-vizard@data-vizard in Claude Code.");
+  } else {
+    console.warn("Could not install the Claude Code plugin automatically.");
+    printCommandOutput(pluginInstall);
+    printClaudeCommands(marketplaceRoot);
+  }
+}
+
+function printManualCommands(marketplaceRoot) {
+  printCodexCommands(marketplaceRoot);
+  printClaudeCommands(marketplaceRoot);
+}
+
+function printCodexCommands(marketplaceRoot) {
+  console.log("");
+  console.log("To finish Codex installation manually:");
+  console.log(`  codex plugin marketplace add ${shellQuote(marketplaceRoot)}`);
+  console.log(`  codex plugin add ${PLUGIN_NAME}@${MARKETPLACE_NAME}`);
+}
+
+function printClaudeCommands(marketplaceRoot) {
+  console.log("");
+  console.log("To finish Claude Code installation manually:");
+  console.log(`  claude plugin marketplace add ${shellQuote(marketplaceRoot)}`);
+  console.log(`  claude plugin install ${PLUGIN_NAME}@${MARKETPLACE_NAME}`);
+  console.log("");
+  console.log("Or inside an interactive Claude Code session:");
+  console.log(`  /plugin marketplace add ${marketplaceRoot}`);
+  console.log(`  /plugin install ${PLUGIN_NAME}@${MARKETPLACE_NAME}`);
+  console.log("  /reload-plugins");
+}
+
+function commandExists(command) {
+  const result = spawnSync(command, ["--version"], { encoding: "utf8" });
+  return !(result.error && result.error.code === "ENOENT");
+}
+
+function run(command, args) {
+  const result = spawnSync(command, args, { encoding: "utf8" });
+  return {
+    ok: !result.error && result.status === 0,
+    status: result.status,
+    error: result.error,
+    stdout: result.stdout,
+    stderr: result.stderr,
+  };
+}
+
+function printCommandOutput(result) {
+  if (result.error) {
+    console.warn(`  ${result.error.message}`);
+  }
+  if (result.stderr && result.stderr.trim()) {
+    console.warn(indent(result.stderr.trim()));
+  }
+  if (result.stdout && result.stdout.trim()) {
+    console.warn(indent(result.stdout.trim()));
+  }
+}
+
+function writeJson(filePath, value) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+
+function readPackageJson() {
+  return JSON.parse(fs.readFileSync(path.join(PACKAGE_ROOT, "package.json"), "utf8"));
+}
+
+function expandHome(inputPath) {
+  if (inputPath === "~") {
+    return os.homedir();
+  }
+
+  if (inputPath.startsWith(`~${path.sep}`)) {
+    return path.join(os.homedir(), inputPath.slice(2));
+  }
+
+  return inputPath;
+}
+
+function shellQuote(value) {
+  if (/^[A-Za-z0-9_./:@%+=,-]+$/.test(value)) {
+    return value;
+  }
+
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}
+
+function indent(value) {
+  return value
+    .split("\n")
+    .map((line) => `  ${line}`)
+    .join("\n");
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+}

package/package.json

@@ -1,16 +1,38 @@
 {
   "name": "data-vizard",
-  "version": "0.0.1",
-  "description": "Data Vizard installer",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "0.1.1",
+  "description": "Installer for the Data Vizard agent workflow plugin.",
+  "license": "MIT",
+  "author": {
+    "name": "Trine"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "type": "commonjs",
+  "homepage": "https://github.com/inosaint/data-vizard#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/inosaint/data-vizard.git"
+  },
+  "bugs": {
+    "url": "https://github.com/inosaint/data-vizard/issues"
+  },
+  "keywords": [
+    "agent-skills",
+    "claude-code",
+    "codex",
+    "data-visualization",
+    "plugin"
+  ],
   "bin": {
-    "data-vizard": "./bin/data-vizard.js"
+    "data-vizard": "bin/data-vizard.js"
+  },
+  "files": [
+    "bin/",
+    "plugins/data-vizard/",
+    ".agents/plugins/marketplace.json",
+    ".claude-plugin/marketplace.json",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
   }
 }

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

@@ -0,0 +1,20 @@
+{
+  "name": "data-vizard",
+  "displayName": "Data Vizard",
+  "version": "0.1.1",
+  "description": "Guide data visualization projects from dataset intake to analysis, narrative, design, and HTML story output.",
+  "author": {
+    "name": "Trine",
+    "url": "https://github.com/inosaint"
+  },
+  "repository": "https://github.com/inosaint/data-vizard",
+  "license": "MIT",
+  "keywords": [
+    "data-visualization",
+    "storytelling",
+    "csv",
+    "analysis",
+    "html"
+  ],
+  "skills": "./skills/"
+}