chore: automate npm release for v1.5.3

Author: Disdjj

.github/workflows/publish-npm.yml

@@ -0,0 +1,35 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Verify tag matches package version
+        run: |
+          package_version=$(node -p "require('./package.json').version")
+          if [ "v$package_version" != "$GITHUB_REF_NAME" ]; then
+            echo "Tag $GITHUB_REF_NAME does not match package.json version v$package_version" >&2
+            exit 1
+          fi
+
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+      - run: npm pack --dry-run
+      - run: npm publish

llmdoc/architecture/system.md

@@ -27,6 +27,8 @@
 - `src/utils/frontmatter.ts`: YAML frontmatter parse/stringify via gray-matter.
 - `src/utils/toml.ts`: TOML serialization via @iarna/toml.
 - `src/utils/fs.ts` (`writeFile`, `readFile`, `fileExists`): File system utilities with directory creation.
+- `.github/workflows/acplugin.yml`: Repository CI workflow that runs `TokenRollAI/acplugin-action@v1` on Claude source changes in `main`.
+- `.github/workflows/publish-npm.yml`: Release workflow. Triggers on `v*` tags, verifies the tag matches `package.json` version, runs install/build/test/package validation, then publishes to npm with GitHub Actions OIDC Trusted Publishing.
 
 ## 3. Execution Flow (LLM Retrieval Map)
 

llmdoc/guides/release.md

@@ -0,0 +1,15 @@
+# How to Publish `@disdjj/acplugin` to npm
+
+Release publishing is automated by GitHub Actions. The workflow lives at `.github/workflows/publish-npm.yml` and publishes only from Git tags that match the package version.
+
+1. Update the package version in `package.json` and `package-lock.json`.
+
+2. Commit the version bump to `main`.
+
+3. Create and push a Git tag in the form `vX.Y.Z`. The tag must exactly match `package.json` version. Example: package version `1.5.3` requires tag `v1.5.3`.
+
+4. GitHub Actions runs `.github/workflows/publish-npm.yml` on the tag push. The workflow validates the tag-version match, then runs `npm ci`, `npm run build`, `npm test`, `npm pack --dry-run`, and `npm publish`.
+
+5. npm authentication uses Trusted Publishing, not a long-lived token. The npm package `@disdjj/acplugin` must be configured to trust the GitHub repository `TokenRollAI/acplugin` and workflow `.github/workflows/publish-npm.yml`.
+
+6. Package metadata required for publishing is stored in `package.json`. `repository.url` must point to `https://github.com/TokenRollAI/acplugin.git`, and `publishConfig.access` must stay `public` because the package is scoped.

llmdoc/index.md

@@ -13,6 +13,7 @@ CLI tool that converts Claude Code plugins (skills, instructions, MCP configs, a
 ### Guides
 
 - [CLI Usage](guides/usage.md) - How to scan and convert resources from local paths or GitHub repos.
+- [npm Release](guides/release.md) - How tag-driven GitHub Actions publishing to npm works.
 
 ### Architecture
 

llmdoc/overview/project.md

@@ -9,7 +9,7 @@
 
 acplugin follows a scan-convert-write pipeline. It scans a local directory or a GitHub repository for Claude Code resources (skills, instructions, MCP server configs, agents, commands, and hooks), then converts each resource type into the target platform's native format, and writes the output files. Conversion is one-way (Claude Code to others, never bidirectional). Claude-specific fields that have no equivalent on a target platform are preserved as HTML comments or generate compatibility warnings. A model mapping module (`src/utils/model.ts`) translates Claude model names to platform equivalents (e.g., `gpt-5.4` for Codex, `gemini-3-pro`/`gemini-3-flash` for Antigravity).
 
-The tool supports three input formats: standard Claude Code project layout (`.claude/` directory), single plugin (`.claude-plugin/plugin.json`), and multi-plugin marketplace (`.claude-plugin/marketplace.json`). Sources can be local paths or GitHub repositories (auto-detected from `owner/repo` syntax). For marketplace repos, an interactive TUI allows selecting which plugins and target platforms to convert. Cursor output uses `.cursor-plugin/` format with `plugin.json` manifest and resources at plugin root (`skills/`, `agents/`, `commands/`, `rules/`, `mcp.json`), compatible with Cursor Marketplace (v2.5+). OpenCode generates `.opencode/agents/*.md` with `mode: subagent`, `steps`, `permission` fields; Antigravity generates `.gemini/agents/*.md` with tool-mapped `allowed-tools` lists. A GitHub Action workflow (`.github/workflows/acplugin.yml`) using `TokenRollAI/acplugin-action@v1` enables CI auto-conversion on push to main.
+The tool supports three input formats: standard Claude Code project layout (`.claude/` directory), single plugin (`.claude-plugin/plugin.json`), and multi-plugin marketplace (`.claude-plugin/marketplace.json`). Sources can be local paths or GitHub repositories (auto-detected from `owner/repo` syntax). For marketplace repos, an interactive TUI allows selecting which plugins and target platforms to convert. Cursor output uses `.cursor-plugin/` format with `plugin.json` manifest and resources at plugin root (`skills/`, `agents/`, `commands/`, `rules/`, `mcp.json`), compatible with Cursor Marketplace (v2.5+). OpenCode generates `.opencode/agents/*.md` with `mode: subagent`, `steps`, `permission` fields; Antigravity generates `.gemini/agents/*.md` with tool-mapped `allowed-tools` lists. GitHub Actions also handles automation around the project itself: `.github/workflows/acplugin.yml` runs conversion on push to main, and `.github/workflows/publish-npm.yml` publishes `@disdjj/acplugin` to npm from matching `v*` tags via npm Trusted Publishing.
 
 **Tech Stack:** TypeScript, Node.js, Commander.js, gray-matter, @iarna/toml, glob, @inquirer/prompts, chalk, ora.
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@disdjj/acplugin",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "Convert Claude Code plugins to Codex, OpenCode, and Cursor formats",
   "main": "dist/index.js",
   "bin": {
@@ -31,8 +31,15 @@
     "mcp"
   ],
   "author": "",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TokenRollAI/acplugin.git"
+  },
   "license": "MIT",
   "type": "commonjs",
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@iarna/toml": "^2.2.5",
     "@inquirer/prompts": "^8.3.2",