agentic-web-developer 1.0.2 → 1.0.5

package/README.md

@@ -36,11 +36,11 @@ npx agentic-web-developer install --all
 npx agentic-web-developer detect
 ```
 
-Other flags: `--force` (overwrite), `--dry-run` (print targets only), `--dir=<path>` (custom destination), `--source=<url|path>` / `--token=<key>` (skill source).
+Other flags: `--license-key=<key>` (save your Pro key during install — see [License & unlocking](#license--unlocking-the-skill)), `--admin-email` / `--admin-secret` (staff), `--force` (overwrite), `--dry-run` (print targets only), `--dir=<path>` (custom destination), `--source=<url|path>` / `--token=<key>` (skill source).
 
 Then **restart your AI agent** so it loads the skill.
 
-> **On first run the skill asks for its Pro license key** (or admin credentials) and validates it once per session — see [License & unlocking](#license--unlocking-the-skill) before you start a project.
+> **On first run the skill asks for its Pro license key** (or admin credentials) and validates it once per session — or pass it up front with `--license-key=…` and skip the prompt. See [License & unlocking](#license--unlocking-the-skill).
 
 > **Where does the skill come from?** Not from npm — the package ships only the installer and docs. The installer fetches the skill from a source you configure (`--source`, `AWD_SOURCE`, or the author's `awd.source` in `package.json`). See [docs/INSTALL.md § Skill source](docs/INSTALL.md#skill-source).
 
@@ -70,24 +70,22 @@ The skill ships behind the **Animotion Pro plan — $7/month**. One validation p
 
 Pick one — the gate looks for environment variables first, then the installer's config file, then asks you once:
 
-**1. Install the AnimotionJS skill with your key (recommended — one command, everything wired)**
+**1. Install the skill with your key (recommended — one command, everything wired)**
 
 ```bash
-npx animotion-skills install --tier=agentic --agent=<your-agent> --license-key=YOUR_KEY
+npx agentic-web-developer install --agent=<your-agent> --license-key=YOUR_KEY
 
 # or install for every detected agent at once:
-npx animotion-skills install --tier=agentic --all --license-key=YOUR_KEY
+npx agentic-web-developer install --all --license-key=YOUR_KEY
 ```
 
 With **admin credentials instead of a license key** (Animotion staff / whitelisted emails only):
 
 ```bash
-npx animotion-skills install --tier=agentic --agent=<your-agent> --admin-email=you@example.com --admin-secret=YOUR_ADMIN_SECRET
+npx agentic-web-developer install --agent=<your-agent> --admin-email=you@example.com --admin-secret=YOUR_ADMIN_SECRET
 ```
 
-`<your-agent>` is one of the [15 supported agents](#supported-agents) — `opencode`, `claude`, `copilot`, `cursor`, … This installs the AnimotionJS animation skill (you need it at Stage 8 anyway) **and** writes `animotion-config.json` next to it — the agentic-web-developer gate reads that file automatically, so nothing else to configure.
-
-> Note: this installer's `agentic` tier requires the **Studio plan** ($15/month). If you're on **Pro only** ($7/month), use options 2–4 below instead — the gate itself accepts any active Pro key.
+`<your-agent>` is one of the [15 supported agents](#supported-agents) — `opencode`, `claude`, `copilot`, `cursor`, … The installer writes `animotion-config.json` into the installed skill folder with your key (or admin pair), and the gate reads that file automatically — nothing else to configure. The key must be on the **Pro plan** ($7/month) or higher.
 
 **2. Environment variable**
 

package/bin/install.js

@@ -3,6 +3,7 @@
  * agentic-web-developer installer
  *
  *   npx agentic-web-developer install [--agent=<key>|all] [--source=<url|path>] [--token=<key>]
+ *                                     [--license-key=<key> | --admin-email=<e> --admin-secret=<s>]
  *                                     [--force] [--dry-run] [--dir=<path>]
  *   npx agentic-web-developer detect
  *
@@ -56,8 +57,8 @@ const AGENTS = {
   opencode: {
     name: "OpenCode",
     format: "skill",
-    roots: [path.join(HOME, ".config", "opencode"), path.join(HOME, ".opencode")],
-    dirs: [path.join(HOME, ".config", "opencode", "skills"), path.join(HOME, ".opencode", "skills")]
+    roots: [path.join(HOME, ".opencode"), path.join(HOME, ".config", "opencode")],
+    dirs: [path.join(HOME, ".opencode", "skills"), path.join(HOME, ".config", "opencode", "skills")]
   },
   claude: {
     name: "Claude Code",
@@ -246,6 +247,39 @@ function installPayload(payloadDir, skillDir) {
   copyRecursive(path.join(skillDir, "templates"), path.join(payloadDir, "templates"));
 }
 
+/* ------------------------- license config (the gate) ----------------------- */
+
+function licenseFlagsPresent() {
+  return Boolean(flags["license-key"] || flags["admin-email"] || flags["admin-secret"]);
+}
+
+function validateLicenseFlags() {
+  const key = flags["license-key"];
+  const adminEmail = flags["admin-email"];
+  const adminSecret = flags["admin-secret"];
+  if (key && (adminEmail || adminSecret)) {
+    throw new Error("--license-key cannot be combined with --admin-email/--admin-secret");
+  }
+  if ((adminEmail && !adminSecret) || (!adminEmail && adminSecret)) {
+    throw new Error("--admin-email and --admin-secret must be provided together");
+  }
+}
+
+// Writes animotion-config.json into the installed skill folder — the file the
+// agentic-web-developer license gate reads (skill dir first, then its parent,
+// ~/.animotion-skills/, AGENTIC_LICENSE_CONFIG).
+function writeLicenseConfig(payloadDir) {
+  if (!licenseFlagsPresent()) return null;
+  const cfg = flags["admin-email"]
+    ? { tier: "pro", requiredPlan: "pro", authMethod: "admin", adminEmail: flags["admin-email"], adminSecret: flags["admin-secret"] }
+    : { tier: "pro", requiredPlan: "pro", authMethod: "license", licenseKey: flags["license-key"] };
+  const file = path.join(payloadDir, "animotion-config.json");
+  fs.mkdirSync(payloadDir, { recursive: true });
+  fs.writeFileSync(file, `${JSON.stringify(cfg, null, 2)}\n`);
+  try { fs.chmodSync(file, 0o600); } catch { /* best-effort; Windows ignores */ }
+  return file;
+}
+
 /* ---------------- skill source resolution (private fetch) ---------------- */
 
 function expandHome(p) {
@@ -409,6 +443,7 @@ function detect() {
 }
 
 async function install() {
+  validateLicenseFlags();
   const skillDir = await resolveSource();
   const { body, description } = readSource(skillDir);
 
@@ -439,6 +474,7 @@ async function install() {
       console.log(`[dry-run] ${agent.name} (${key})`);
       console.log(`          main: ${mainFile}`);
       console.log(`          refs: ${payloadDir}{/references, /templates}`);
+      if (licenseFlagsPresent()) console.log(`          lic:  ${path.join(payloadDir, "animotion-config.json")}`);
       done++;
       continue;
     }
@@ -452,6 +488,8 @@ async function install() {
         }
       }
       console.log(`skip ${agent.name}: already installed at ${mainFile} (use --force to overwrite)`);
+      const existingCfg = writeLicenseConfig(payloadDir);
+      if (existingCfg) console.log(`  license config: ${existingCfg}`);
       continue;
     }
 
@@ -471,15 +509,20 @@ async function install() {
     }
     fs.mkdirSync(path.dirname(mainFile), { recursive: true });
     fs.writeFileSync(mainFile, content);
+    const cfgFile = writeLicenseConfig(payloadDir);
     console.log(`installed ${agent.name} (${key})`);
     console.log(`  main: ${mainFile}`);
     console.log(`  refs: ${payloadDir}`);
+    if (cfgFile) console.log(`  license config: ${cfgFile}`);
     done++;
   }
 
   if (!done) {
     console.log("nothing installed — everything already present (use --force to overwrite)");
   } else if (!flags["dry-run"]) {
+    if (licenseFlagsPresent()) {
+      console.log("\nLicense saved — the skill's gate reads animotion-config.json automatically.");
+    }
     console.log(`\nDone. Restart your AI agent so it loads ${SKILL_NAME}.`);
     console.log("Animations for any site built with this skill are handled by the AnimotionJS agentic skill:");
     console.log("  npx animotion-skills install --tier=agentic --agent=<agent> --license-key=YOUR_KEY");
@@ -520,6 +563,12 @@ Options:
   --source=<s>    Skill source: a .tar.gz/.zip URL or a local folder/archive
                   (falls back to AWD_SOURCE, then skill/, then awd.source)
   --token=<key>   Auth token for a private source (or AWD_TOKEN=<key>)
+  --license-key=<key>
+                  Save your Pro license key to the installed skill
+                  (writes animotion-config.json the license gate reads)
+  --admin-email=<e> --admin-secret=<s>
+                  Admin credentials instead of a key (Animotion staff /
+                  whitelisted emails only — both flags required together)
   --force         Overwrite an existing install
   --dry-run       Print target paths without copying
   --dir=<path>    Install into <path>/${SKILL_NAME} (flat, SKILL.md layout)
@@ -540,6 +589,7 @@ Each agent gets its own file format:
 
 Examples:
   npx ${SKILL_NAME} install                                # auto-detect agent
+  npx ${SKILL_NAME} install --agent=opencode --license-key=sec_live_xxxxxxxx
   npx ${SKILL_NAME} install --agent=all --source=https://you/server/skill.tar.gz --token=KEY
   npx ${SKILL_NAME} detect
 `);

package/docs/INSTALL.md

@@ -10,8 +10,8 @@ The skill installs into **15 AI coding agents** — the same 15 the AnimotionJS
 # auto-detect your agent (opencode -> claude -> any detected agent)
 npx agentic-web-developer install
 
-# target one agent by key
-npx agentic-web-developer install --agent=claude
+# target one agent by key, with your Pro license key saved during install
+npx agentic-web-developer install --agent=claude --license-key=YOUR_KEY
 
 # install for every supported agent at once
 npx agentic-web-developer install --all
@@ -22,7 +22,7 @@ npx agentic-web-developer detect
 
 Then **restart your AI agent** so it loads the skill.
 
-> **License:** the skill is gated by the Animotion **Pro plan ($7/month)** — on first run it validates your key (or admin credentials) once per session before any work. Paying, downloading the files directly with a key, and wiring credentials up: **[LICENSING.md](LICENSING.md)**.
+> **License:** the skill is gated by the Animotion **Pro plan ($7/month)** — on first run it validates your key (or admin credentials) once per session before any work. Pass `--license-key=…` (or `--admin-email` / `--admin-secret`) at install time to wire the credential up front. Paying and full credential setup: **[LICENSING.md](LICENSING.md)**.
 
 ### All flags
 
@@ -32,6 +32,8 @@ Then **restart your AI agent** so it loads the skill.
 | `--agent=all` / `--all` | Install for all 15 agents |
 | `--source=<url\|path>` | Skill source: a `.tar.gz`/`.zip` URL, or a local skill folder/archive |
 | `--token=<key>` | Auth token for a private source (else `AWD_TOKEN`) |
+| `--license-key=<key>` | Save your Pro license key to the installed skill (`animotion-config.json` the gate reads) |
+| `--admin-email=<e>` `--admin-secret=<s>` | Admin credentials instead of a key (staff/whitelisted — both required) |
 | `--force` | Overwrite an existing install |
 | `--dry-run` | Print the target paths without writing anything |
 | `--dir=<path>` | Install flat into `<path>/agentic-web-developer/` (SKILL.md layout) |

package/docs/LICENSING.md

@@ -57,24 +57,22 @@ Other agents: change `DEST` (e.g. `~/.config/claude/skills/…` for Claude Code,
 
 Pick one — the skill's gate looks for environment variables first, then the installer's config file, then asks you once.
 
-**1. Install the AnimotionJS skill with your key (recommended — one command, everything wired)**
+**1. Install the skill with your key (recommended — one command, everything wired)**
 
 ```bash
-npx animotion-skills install --tier=agentic --agent=<your-agent> --license-key=YOUR_KEY
+npx agentic-web-developer install --agent=<your-agent> --license-key=YOUR_KEY
 
 # or install for every detected agent at once:
-npx animotion-skills install --tier=agentic --all --license-key=YOUR_KEY
+npx agentic-web-developer install --all --license-key=YOUR_KEY
 ```
 
 With **admin credentials instead of a license key** (Animotion staff / whitelisted emails only):
 
 ```bash
-npx animotion-skills install --tier=agentic --agent=<your-agent> --admin-email=you@example.com --admin-secret=YOUR_ADMIN_SECRET
+npx agentic-web-developer install --agent=<your-agent> --admin-email=you@example.com --admin-secret=YOUR_ADMIN_SECRET
 ```
 
-`<your-agent>` is one of the 15 supported agents (`opencode`, `claude`, `copilot`, `cursor`, … — full list in [INSTALL.md](INSTALL.md)). This installs the AnimotionJS animation skill (you need it at Stage 8 anyway) **and** writes `animotion-config.json` next to it — the agentic-web-developer gate reads that file automatically, so nothing else to configure.
-
-> Note: this installer's `agentic` tier requires the **Studio plan** ($15/month). On the **Pro plan** only ($7/month), use options 2–4 instead — the gate itself accepts any active Pro key.
+`<your-agent>` is one of the 15 supported agents (`opencode`, `claude`, `copilot`, `cursor`, … — full list in [INSTALL.md](INSTALL.md)). The installer writes `animotion-config.json` into the installed skill folder with your key (or admin pair), and the gate reads that file automatically — nothing else to configure. The key must be on the **Pro plan** ($7/month) or higher.
 
 **2. Environment variable**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-web-developer",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "description": "Agentic skill for building high-converting websites that sell — design DNA extraction, outlier competitor research, conversion blueprints, the M.O.N.E.Y sales framework, lead generation, cloning, outreach and deployment, with a novel-idea/product-launch mode. All animation work is delegated to the AnimotionJS agentic skill.",
   "keywords": [
     "opencode",
@@ -35,7 +35,7 @@
   },
   "license": "UNLICENSED",
   "awd": {
-    "source": "https://4e2zaktqel.ucarecd.net/8bbedf86-8578-49c4-9477-0a5a685094af/skilltar.gz"
+    "source": "https://4e2zaktqel.ucarecd.net/f1600612-35fa-41cc-8fdc-d6997ef71ea4/skilltar.gz"
   },
   "publishConfig": {
     "access": "public"