@mirage-cli/contentdynamite 0.0.0-stage → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @mirage-cli/contentdynamite
+
+## 1.0.0
+
+### Major Changes
+
+- The product's own `ve-dynamite` CLI against the Content Dynamite Workers API, replacing the 0.1.0 port of the Python CLI. First npm release.

package/README.md

@@ -1,3 +1,27 @@
-# Temporary Holding Version
+# @mirage-cli/contentdynamite
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Thin Mirage wrapper around [`@mirage-cli/contentdynamite-cli`](../contentdynamite-cli), exposing the global `ve-dynamite` command for mirage runtimes and Cloudflare Workers.
+
+## Use
+
+```ts
+import { contentdynamiteResource } from "@mirage-cli/contentdynamite";
+
+workspace.addMount("/dynamite/", await contentdynamiteResource());
+```
+
+- `buildProgram()` returns one cached Commander program, built in the CLI's mount mode with `@mirage-cli/core`'s `reportCost`, so paid work shows up in the host's cost telemetry.
+- `contentdynamiteCommand` is ready for a Mirage `command({ fn })` registration.
+- `contentdynamiteResource()` lazily imports Mirage core and returns a command-only remote resource.
+
+Auth comes from `VE_DYNAMITE_TOKEN` (a `ved_` API token), which the host should inject per call. `VE_DYNAMITE_API_URL` picks the API host; mount mode has no `--url` flag, so a host that pins this variable pins where the token goes. Mount mode also has no `login` and no `watch`: agents poll `get`.
+
+## Access boundary
+
+Reads, safe on every mount: `whoami`, `tokens list`, `profiles list|get`, `icp show|export`, `categories list`, `design-system show`, `articles get|list|parts|revisions|download|export|embed-audit|provenance-audit|research-prompt`, `revisions list|get`, `batches list|get`, `gbp list|get|image-options`, `landing-pages get|list|versions|research|deck|export|audit`, `images status`.
+
+Paid, real money per item, gate behind a write mode: `articles write|reject`, `articles clean-provenance --rewrite`, `batches create`, `gbp write|batch|regenerate`, `landing-pages write|reiterate|new-version|fix-images`, `profiles create`, `icp regenerate`, `design-system set|rescan`, `images edit`, `evals run --judge`.
+
+Changes stored content, gate behind a write mode: `profiles update`, `icp update`, `categories add`, `articles update|strip-embeds|clean-provenance`, `revisions verdict`, `gbp update`, `landing-pages update|criteria|fix-placeholders|rebrand`, `images commit`, `evals run` (it stores the score).
+
+Recommend blocking outright: every `delete`, `design-system clear` and `upload` (permanent, matching the product's own MCP server), `users` (account administration), and `tokens create|revoke` (a new secret in the transcript, or revoking the mount's own token). Also block `--token`, which swaps in another account's credential.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+import { MirageCommandFn } from '@mirage-cli/core';
+import { Resource } from '@struktoai/mirage-core';
+
+declare function buildProgram(): Command;
+declare const contentdynamiteCommand: MirageCommandFn;
+declare function contentdynamiteResource(): Promise<Resource>;
+
+export { buildProgram, contentdynamiteCommand, contentdynamiteResource };

package/dist/index.js

@@ -0,0 +1,53 @@
+// src/index.ts
+import { buildProgram as buildContentDynamiteProgram } from "@mirage-cli/contentdynamite-cli";
+import {
+  reportCost,
+  toMirageCommandFn
+} from "@mirage-cli/core";
+var cachedProgram = null;
+function buildProgram() {
+  if (cachedProgram === null) cachedProgram = buildContentDynamiteProgram({ mount: true, reportCost });
+  return cachedProgram;
+}
+var cachedFn = null;
+var contentdynamiteCommand = async (accessor, paths, texts, opts) => {
+  if (cachedFn === null) cachedFn = toMirageCommandFn(buildProgram());
+  return cachedFn(accessor, paths, texts, opts);
+};
+var cachedResource = null;
+async function contentdynamiteResource() {
+  if (cachedResource !== null) return cachedResource;
+  const mirage = await import("@struktoai/mirage-core");
+  const fn = toMirageCommandFn(buildProgram(), {
+    IOResult: mirage.IOResult
+  });
+  const commands = [
+    new mirage.RegisteredCommand({
+      name: "ve-dynamite",
+      resource: null,
+      spec: new mirage.CommandSpec({
+        rest: new mirage.Operand({ kind: mirage.OperandKind.TEXT }),
+        description: "Content Dynamite CLI (articles, GBP posts and landing pages spend real money)"
+      }),
+      fn
+    })
+  ];
+  cachedResource = {
+    kind: "contentdynamite",
+    isRemote: true,
+    prompt: "Content Dynamite CLI. Auth via VE_DYNAMITE_TOKEN (a ved_ API token); VE_DYNAMITE_API_URL picks the API. Reads cover profiles, ICP, categories, design systems, articles, revisions, batches, GBP posts, landing pages and image jobs. `articles write|reject`, `batches create`, `gbp write|batch|regenerate`, `landing-pages write|reiterate|new-version|fix-images`, `profiles create`, `icp regenerate`, `design-system set|rescan`, `images edit` and `evals run --judge` spend real money per item and should require a write-mode mount. Generation is asynchronous and there is no watch: poll `get` about every 10 seconds. Use `ve-dynamite --help` for usage.",
+    async open() {
+    },
+    async close() {
+    },
+    commands() {
+      return commands;
+    }
+  };
+  return cachedResource;
+}
+export {
+  buildProgram,
+  contentdynamiteCommand,
+  contentdynamiteResource
+};

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@mirage-cli/contentdynamite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "The Content Dynamite CLI (ve-dynamite) in its mount mode as an importable Mirage and Cloudflare Worker command.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --target node18 --dts --external @mirage-cli/core --external @mirage-cli/contentdynamite-cli --external commander --external @struktoai/mirage-core --clean --silent",
+    "test": "bun test --reporter=dots",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@mirage-cli/core": "^0.1.11"
+  },
+  "peerDependencies": {
+    "@struktoai/mirage-core": ">=0.0.1",
+    "@mirage-cli/contentdynamite-cli": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@struktoai/mirage-core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@mirage-cli/contentdynamite-cli": "^1.0.0",
+    "@struktoai/mirage-core": "^0.0.1",
+    "commander": "^14.0.3",
+    "tsup": "^8.5.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alexbruf/mirage-cli.git",
+    "directory": "packages/contentdynamite"
+  },
+  "keywords": [
+    "content-dynamite",
+    "ve-dynamite",
+    "seo",
+    "commander",
+    "mirage",
+    "cloudflare-workers"
+  ],
+  "license": "MIT"
+}