@orchid-labs/pluxx 0.1.4 → 0.1.6

package/README.md

@@ -1,14 +1,46 @@
 # pluxx
 
-**The cross-host compiler for MCP-backed plugins.**
+**Turn a raw MCP into a native plugin across Claude Code, Cursor, Codex, and OpenCode.**
 
-Import a raw MCP or an existing host-native plugin, keep one maintained source project, and compile native outputs for **Claude Code, Cursor, Codex, and OpenCode**.
+Import a raw MCP or an existing host-native plugin, keep one maintained source project, and compile native outputs for **Claude Code, Cursor, Codex, and OpenCode** instead of maintaining four separate plugin codebases.
 
-Pluxx is the authoring, maintenance, and compilation layer for MCP teams that want one source of truth instead of separate per-host plugin repos.
+Pluxx is the authoring, maintenance, and compilation layer for teams that want one source of truth instead of four drifting per-host plugin repos. Start with `init`, or use `pluxx autopilot` when you want the one-shot path.
 
+Raw MCP access is usually not enough. Most products still need workflow grouping, stronger instructions, hooks, commands, auth/setup guidance, and honest host-native packaging. Pluxx is the layer that makes that repeatable.
+
+- Start here: [docs/start-here.md](./docs/start-here.md)
 - Docs: [docs.pluxx.dev](https://docs.pluxx.dev/)
 - Website: [pluxx.dev](https://pluxx.dev/)
 
+## Current Proof
+
+If you want the fastest way to see what is already real, start with these:
+
+- [Proof and install guide](./docs/proof-and-install.md)
+  - the shortest public path to the current demos plus one-command install paths for the released self-hosted plugin
+- [Self-hosted core-four proof](./docs/pluxx-self-hosted-core-four-proof.md)
+  - `example/pluxx` rebuilt, installed, and `verify-install` checked across Claude Code, Cursor, Codex, and OpenCode
+- [Docs Ops core-four proof](./docs/docs-ops-core-four-proof.md)
+  - the flagship `example/docs-ops` source project rebuilt, installed, `verify-install` checked, and exercised through read-only inspect/rewrite workflows across the official Claude Code, Cursor, Codex, and OpenCode CLIs
+- [Docs Ops live Codex walkthrough](./docs/orchid-docs-ops-codex-walkthrough.md)
+  - one maintained `docs-ops` source project compiled into a real Codex plugin and used against Orchid's live Docsalot MCP
+- [Docs Ops authenticated publish path](./docs/docs-ops-authenticated-publish-path.md)
+  - the flagship example now separates Orchid's public read-only MCP proof from the private write/publish contract, and the install/runtime gate is mechanically proven
+- [Exa Research Example](./docs/exa-research-example.md)
+  - a clean-room Exa-style research operator pack built from one maintained source project, with specialist agents, rich brand metadata, real build/install/verify proof across the core four, and live workflow proof in Claude Code, Codex Desktop, Cursor CLI, and OpenCode CLI
+- [Orchid Accordion before/after rewrite](./example/docs-ops/demo-rewrites/orchid-components-accordion.after.md)
+  - concrete output from the flagship docs workflow example
+- [Core-four provider docs audit](./docs/core-four-provider-docs-audit.md)
+  - first-party host capability and lifecycle truth for Claude Code, Cursor, Codex, and OpenCode
+- [Firecrawl connector docs-ingestion proof](./docs/strategy/firecrawl-connector-docs-ingestion-proof.md)
+  - the first real Firecrawl-backed extraction proof on the fixture set
+- [Docs-ingestion fixture snapshot](./docs/strategy/docs-ingestion-fixture-eval.md)
+  - keyed local harness rerun with `baseline`, `local`, and `firecrawl` results recorded side by side
+- [Docs-ingestion scaffold before/after demo](./docs/strategy/docs-ingestion-scaffold-before-after.md)
+  - a committed Sumble scaffold delta showing what sourced Firecrawl context changes in real generated files
+
+The biggest remaining flagship gap is now a real private publish and rollback run against a safe sandbox authoring target, not basic cross-host workflow proof.
+
 ## Why Pluxx
 
 Every host has different plugin contracts and different places to express the same intent:
@@ -23,6 +55,21 @@ Every host has different plugin contracts and different places to express the sa
 
 Without Pluxx, those details drift across multiple repos. With Pluxx, you keep one source project and compile honest host-native outputs.
 
+For teams that want the shortest path from raw MCP to something usable, `pluxx autopilot` wraps import, refinement, and build/test flow into one command.
+
+The current product focus is the OSS authoring substrate:
+
+- import
+- scaffold
+- refine
+- lint
+- doctor
+- eval
+- build
+- test
+- install
+- sync
+
 Pluxx is built around an explicit compiler model:
 
 - `preserve` when a primitive maps cleanly to a host-native surface
@@ -57,6 +104,16 @@ npx @orchid-labs/pluxx build
 npx @orchid-labs/pluxx test
 ```
 
+One-shot path:
+
+```bash
+npx @orchid-labs/pluxx autopilot \
+  --from-mcp https://example.com/mcp \
+  --runner codex \
+  --name my-plugin \
+  --yes
+```
+
 Common output shape:
 
 ```text
@@ -149,6 +206,8 @@ Pluxx owns the deterministic scaffold, validation, and host compilation layer. Y
 - npm package: `@orchid-labs/pluxx`
 - preferred invocation: `npx @orchid-labs/pluxx ...`
 - global install also works: `npm install -g @orchid-labs/pluxx`
+- check the active global CLI version with: `pluxx --version`
+- upgrade the active global CLI with: `pluxx upgrade`
 - published CLI runtime: Node `>=18`
 - source builds and maintainer workflows also run on Node `>=18`
 
@@ -157,6 +216,10 @@ Pluxx owns the deterministic scaffold, validation, and host compilation layer. Y
 - [Getting started](./docs/getting-started.md)
 - [Create a Pluxx plugin](./docs/create-a-pluxx-plugin.md)
 - [How it works](./docs/how-it-works.md)
+- [Self-hosted core-four proof](./docs/pluxx-self-hosted-core-four-proof.md)
+- [Docs Ops core-four proof](./docs/docs-ops-core-four-proof.md)
+- [Proof and install guide](./docs/proof-and-install.md)
+- [Docs Ops Codex walkthrough](./docs/orchid-docs-ops-codex-walkthrough.md)
 - [Use Pluxx in host agents](./docs/use-pluxx-in-host-agents.md)
 - [Core primitives](./docs/core-primitives.md)
 - [OSS wedge and trust layer](./docs/oss-wedge-and-trust-layer.md)

package/dist/cli/behavioral.d.ts

@@ -0,0 +1,27 @@
+import type { PluginConfig, TargetPlatform } from '../schema';
+declare const SUPPORTED_PLATFORMS: readonly ["claude-code", "cursor", "codex", "opencode"];
+type BehavioralPlatform = typeof SUPPORTED_PLATFORMS[number];
+export interface BehavioralSuiteOptions {
+    promptOverride?: string;
+}
+export interface BehavioralCheckResult {
+    caseName: string;
+    platform: BehavioralPlatform;
+    prompt: string;
+    command: string[];
+    ok: boolean;
+    exitCode: number;
+    responseBytes: number;
+    responsePreview: string;
+    require?: string[];
+    forbid?: string[];
+    failures: string[];
+}
+export interface BehavioralSuiteResult {
+    ok: boolean;
+    source: string;
+    checks: BehavioralCheckResult[];
+}
+export declare function runBehavioralSuite(rootDir: string, config: PluginConfig, targets: TargetPlatform[], options?: BehavioralSuiteOptions): Promise<BehavioralSuiteResult>;
+export {};
+//# sourceMappingURL=behavioral.d.ts.map

package/dist/cli/behavioral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavioral.d.ts","sourceRoot":"","sources":["../../src/cli/behavioral.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAI7D,QAAA,MAAM,mBAAmB,yDAA8F,CAAA;AAEvH,KAAK,kBAAkB,GAAG,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAA;AAiB5D,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,qBAAqB,EAAE,CAAA;CAChC;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAqBhC"}

package/dist/cli/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAuE,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAE3I,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAA;AAElE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,gBAAgB,CAAC,EAAE,2BAA2B,CAAA;CAC/C;AA6+BD,wBAAsB,cAAc,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CA2D3F;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CA+E1F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAyB5D"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAQA,OAAO,EAAuE,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAE3I,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAA;AAElE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,gBAAgB,CAAC,EAAE,2BAA2B,CAAA;CAC/C;AAshCD,wBAAsB,cAAc,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CA2D3F;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAgF1F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAyB5D"}

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAeL,KAAK,mBAAmB,EAIzB,MAAM,SAAS,CAAA;AAkChB,OAAO,EACL,wBAAwB,EAIzB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAA;AAiCnE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,mBAAmB,CAAA;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;CACpB;AAiGD,wBAAsB,IAAI,kBAgEzB;AA0cD,UAAU,mBAAmB;IAC3B,EAAE,EAAE,QAAQ,GAAG,eAAe,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAyBD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAOhF;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,GAAG,IAAI,GAClE,mBAAmB,GAAG,IAAI,CA4B5B;AA+BD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAUpI;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,CAAC,GAAG,OAAO,GAAG,SAAS,CAwCpJ;AAiSD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAwB3H"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAeL,KAAK,mBAAmB,EAIzB,MAAM,SAAS,CAAA;AAkChB,OAAO,EACL,wBAAwB,EAIzB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAA;AAoCnE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,mBAAmB,CAAA;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;CACpB;AA2GD,wBAAsB,IAAI,kBAsEzB;AAsjBD,UAAU,mBAAmB;IAC3B,EAAE,EAAE,QAAQ,GAAG,eAAe,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAyBD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAOhF;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,GAAG,IAAI,GAClE,mBAAmB,GAAG,IAAI,CA4B5B;AA+BD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAUpI;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,CAAC,GAAG,OAAO,GAAG,SAAS,CAwCpJ;AAiSD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAwB3H"}