@docsxai/plugin 0.2.0 → 0.2.1-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +33 -7
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -1,9 +1,33 @@
1
1
  # @docsxai/plugin — Claude Code plugin
2
2
 
3
- The first-class invocation surface for the docsxai engine. Install globally:
3
+ The first-class invocation surface for the docsxai engine.
4
+
5
+ ## Install
6
+
7
+ From inside Claude Code, add the marketplace this repo publishes (`.claude-plugin/marketplace.json` at the repo root, marketplace name `docsxai`) and install the plugin:
8
+
9
+ ```
10
+ /plugin marketplace add kalebteccom/docsxai
11
+ /plugin install docsxai@docsxai
12
+ ```
13
+
14
+ The same from a shell:
15
+
16
+ ```
17
+ claude plugin marketplace add kalebteccom/docsxai
18
+ claude plugin install docsxai@docsxai
19
+ ```
20
+
21
+ The marketplace entry points at `./packages/plugin`, which holds `.claude-plugin/plugin.json`. Both manifests pass `claude plugin validate`.
22
+
23
+ **Verified:** adding a local checkout as a marketplace (`claude plugin marketplace add /path/to/docsxai`) and installing `docsxai@docsxai` from it, in an isolated Claude Code config directory. **Unverified:** the `kalebteccom/docsxai` GitHub shorthand, which resolves only once the manifest is on the default branch.
24
+
25
+ ### Local development
26
+
27
+ Load the plugin straight from a checkout, with no marketplace:
4
28
 
5
29
  ```
6
- claude plugin install https://github.com/kalebteccom/docsxai # (the plugin lives under packages/plugin)
30
+ claude --plugin-dir /path/to/docsxai/packages/plugin
7
31
  ```
8
32
 
9
33
  ## Commands (deterministic — thin wrappers over the `docsxai` CLI)
@@ -14,8 +38,10 @@ claude plugin install https://github.com/kalebteccom/docsxai # (the plugin liv
14
38
  | `/docsxai:render <project-dir>` | Build the interactive viewer. |
15
39
  | `/docsxai:push <project-dir>` | Upload the doc pack to the configured backend. |
16
40
  | `/docsxai:pull <project-dir>` | Download the doc pack from the configured backend. |
17
- | `/docsxai:login` | OAuth login to the backend (CI uses `DOCSX_TOKEN`). |
41
+ | `/docsxai:login` | Backend login: `--oauth` runs OAuth 2.1 + PKCE; CI uses `DOCSX_TOKEN`. |
18
42
  | `/docsxai:doctor` | Environment + workspace health-check (✓/✗ + one-line fixes). |
43
+ | `/docsxai:plugins` | List, inspect, and lock the workspace's plugins. |
44
+ | `/docsxai:export` | Export the doc pack as a wiki-ready ADF projection. |
19
45
 
20
46
  ## Skills (calibration — agent-driven; the host supplies inference)
21
47
 
@@ -26,7 +52,7 @@ claude plugin install https://github.com/kalebteccom/docsxai # (the plugin liv
26
52
 
27
53
  ## MCP
28
54
 
29
- The skills shell out to the `docsxai` CLI and use the externally-provided **Claude in Chrome** MCP for
30
- the discovery stage's live-browser driving. An internal MCP server (engine operations the calibration
31
- skills call — parse-flow-file, run-flow, apply-ambiguity-resolution, …) is a possible future addition if
32
- shelling out becomes the bottleneck.
55
+ The plugin registers no MCP server. The skills shell out to the `docsxai` CLI and use the
56
+ externally-provided **browxai** MCP (any MCP browser bridge works) for the discovery stage's live-browser
57
+ driving. Hosts that prefer MCP tools over shell-outs can register the standalone `@docsxai/mcp` server
58
+ (engine operations as tools: `run_flows`, `lint_flows`, `diagnose_halt`, …; repo-only, see its README).
package/package.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@docsxai/plugin",
3
- "version": "0.2.0",
3
+ "version": "0.2.1-rc.1",
4
4
  "type": "module",
5
5
  "publishConfig": {
6
6
  "access": "public",
7
7
  "provenance": true
8
8
  },
9
- "description": "Claude Code plugin — the first-class invocation surface. Calibration skills + deterministic commands + internal MCP registration.",
9
+ "description": "Claude Code plugin — the first-class invocation surface. Calibration skills + deterministic commands. Registers no MCP server.",
10
10
  "license": "Apache-2.0",
11
11
  "repository": {
12
12
  "type": "git",
@@ -34,12 +34,12 @@
34
34
  "dist"
35
35
  ],
36
36
  "devDependencies": {
37
- "@types/node": "^20.14.0",
37
+ "@types/node": "^20.19.43",
38
38
  "vitest": "^2.0.0"
39
39
  },
40
40
  "author": "Kalebtec <security@kalebtec.com>",
41
41
  "engines": {
42
- "node": ">=20"
42
+ "node": ">=26"
43
43
  },
44
44
  "scripts": {
45
45
  "build": "node ../../scripts/clean-dist.mjs && tsc -b tsconfig.build.json",