@lebtiga/sonic-agent 1.0.0

package/LICENSE.txt

@@ -0,0 +1,223 @@
+SONIC AGENT — COMMERCIAL LICENSE & USE AGREEMENT
+Copyright (c) 2026 Rob Rizk / Rizk Advertising
+All rights reserved.
+
+This is a binding agreement between you ("Licensee") and Rizk Advertising
+("Licensor"). By installing or using the Sonic Agent software, materials,
+or related content (collectively, the "Software"), you agree to all terms
+below. If you do not agree, do not install or use the Software.
+
+═══════════════════════════════════════════════════════════════════════════
+1. DEFINITIONS
+═══════════════════════════════════════════════════════════════════════════
+
+   "Software" means the Sonic Agent CLI, the Claude Code plugin, all
+   bundled agent definitions, skills, commands, prompts, scripts, and
+   source code distributed in this package.
+
+   "Confidential Materials" means the Standard Operating Procedures (SOPs),
+   the 6-stage build methodology, the skill prompts, the workshop curriculum,
+   the cohort training materials, and any non-public technical or strategic
+   information disclosed to Licensee through the Software, the workshop,
+   the Discord community, or any direct communication from Licensor.
+
+   "Methodology" means the systematic approach, processes, prompts, prompt
+   chains, decision trees, quality gates, and operational patterns embodied
+   in the Software and Confidential Materials, regardless of the specific
+   form in which they are expressed.
+
+   "Output" means websites, content, graphics, code, configurations, and
+   other deliverables that Licensee produces for Licensee's own clients
+   using the Software.
+
+═══════════════════════════════════════════════════════════════════════════
+2. GRANT OF LICENSE
+═══════════════════════════════════════════════════════════════════════════
+
+   Subject to payment in full and ongoing compliance with these terms,
+   Licensor grants Licensee a non-exclusive, non-transferable, revocable,
+   single-seat license to install and operate the Software on machines
+   personally operated by Licensee, solely for the internal benefit of
+   Licensee's own agency, business, or client engagements.
+
+═══════════════════════════════════════════════════════════════════════════
+3. SINGLE SEAT
+═══════════════════════════════════════════════════════════════════════════
+
+   One license key authorizes one (1) individual user. Sharing the license
+   key, account, installation, or installed files with any other person —
+   inside or outside Licensee's organization — is strictly prohibited.
+   Agencies requiring multiple users must purchase additional licenses.
+
+═══════════════════════════════════════════════════════════════════════════
+4. INTELLECTUAL PROPERTY OWNERSHIP
+═══════════════════════════════════════════════════════════════════════════
+
+   The Software, the Confidential Materials, and the Methodology are the
+   exclusive intellectual property of Licensor. Nothing in this agreement
+   transfers ownership of any portion thereof to Licensee.
+
+   Licensee acknowledges that:
+
+   (a) The Methodology was developed by Licensor at significant expense
+       and constitutes valuable trade secrets and proprietary know-how;
+
+   (b) Licensee's exposure to the Software, the Methodology, and the
+       Confidential Materials is granted only as a use-license and creates
+       no ownership, residual rights, or implied rights of any kind;
+
+   (c) Output produced by Licensee for Licensee's own clients belongs to
+       Licensee and Licensee's clients; the underlying Methodology, prompts,
+       skills, and SOPs that produced that Output remain the exclusive
+       property of Licensor.
+
+═══════════════════════════════════════════════════════════════════════════
+5. PROHIBITED USES
+═══════════════════════════════════════════════════════════════════════════
+
+   Licensee shall NOT, directly or indirectly, do any of the following,
+   whether for compensation or not:
+
+   (a) Republish, resell, sublicense, mirror, distribute, fork publicly,
+       or otherwise redistribute the Software, the SOPs, the skills, the
+       prompts, or any substantial portion of the Confidential Materials;
+
+   (b) Repackage the Software (in whole or in modified form) for sale,
+       trade, or distribution as a product, agent, plugin, template,
+       course, or service;
+
+   (c) Build, develop, market, or operate any competing product, AI
+       agent, SaaS, automated tool, plugin, or course that incorporates
+       the Methodology, the prompts, the skills, the SOPs, or any
+       substantial derivative thereof;
+
+   (d) Use the Software, the Methodology, or the Confidential Materials
+       to train, fine-tune, prompt, or otherwise develop any artificial
+       intelligence model, agent, or system;
+
+   (e) Reverse engineer, decompile, disassemble, or attempt to extract
+       the Methodology from the Software for the purpose of recreating it
+       outside the licensed context;
+
+   (f) Bypass, disable, or circumvent the license validation, machine
+       fingerprinting, or watermarking systems;
+
+   (g) Disclose the Confidential Materials to any third party not
+       independently licensed by Licensor.
+
+═══════════════════════════════════════════════════════════════════════════
+6. CONFIDENTIALITY
+═══════════════════════════════════════════════════════════════════════════
+
+   Licensee shall treat all Confidential Materials with the same degree
+   of care used to protect Licensee's own trade secrets, and in no case
+   less than reasonable care. The confidentiality obligation survives
+   termination of this agreement and continues indefinitely with respect
+   to information that retains commercial value as a trade secret.
+
+   Licensee may not screenshot, transcribe, paraphrase, or summarize
+   substantial portions of the Confidential Materials for public
+   distribution, social media content, blog posts, conference talks, or
+   competing training programs without prior written permission from
+   Licensor.
+
+═══════════════════════════════════════════════════════════════════════════
+7. WATERMARKING & LEAK DETECTION
+═══════════════════════════════════════════════════════════════════════════
+
+   Licensee acknowledges that the SOPs and certain other Confidential
+   Materials are watermarked with Licensee's identifying information.
+   Licensee agrees that any unauthorized distribution traceable to
+   Licensee's watermark constitutes prima facie evidence of breach.
+
+═══════════════════════════════════════════════════════════════════════════
+8. FOUNDERS COHORT TERMS
+═══════════════════════════════════════════════════════════════════════════
+
+   If Licensee purchased a Founders Cohort seat, Licensee's seat is
+   grandfathered at the founders price for all future versions of the
+   Software, conditional on continuous compliance with this agreement.
+   Founders status is non-transferable and is forfeited upon any material
+   breach.
+
+═══════════════════════════════════════════════════════════════════════════
+9. TERMINATION
+═══════════════════════════════════════════════════════════════════════════
+
+   Licensor may revoke this license, with or without notice, upon any
+   material breach by Licensee — including but not limited to
+   redistribution, license sharing, derivative product development,
+   chargebacks, or breach of confidentiality. Upon termination, Licensee
+   must immediately cease all use of the Software, uninstall all copies,
+   and destroy any retained Confidential Materials.
+
+   Sections 4 (IP), 5 (Prohibited Uses), 6 (Confidentiality), 7
+   (Watermarking), 10 (Remedies), 11 (Liability), and 12 (Governing Law)
+   survive termination indefinitely.
+
+═══════════════════════════════════════════════════════════════════════════
+10. REMEDIES
+═══════════════════════════════════════════════════════════════════════════
+
+   Licensee acknowledges that breach of Sections 4, 5, or 6 would cause
+   irreparable harm to Licensor that cannot be adequately compensated by
+   monetary damages alone. In the event of such breach, Licensor is
+   entitled to seek immediate injunctive relief, in addition to monetary
+   damages, attorneys' fees, and any other remedies available at law or
+   in equity.
+
+═══════════════════════════════════════════════════════════════════════════
+11. NO WARRANTY / LIMITATION OF LIABILITY
+═══════════════════════════════════════════════════════════════════════════
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES
+   OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT
+   SHALL LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY
+   ARISING FROM USE OF THE SOFTWARE, EXCEEDING THE FEES PAID BY LICENSEE
+   IN THE PRECEDING TWELVE (12) MONTHS.
+
+═══════════════════════════════════════════════════════════════════════════
+12. GOVERNING LAW & VENUE
+═══════════════════════════════════════════════════════════════════════════
+
+   This agreement is governed by the laws of the jurisdiction where
+   Licensor is principally located, without regard to conflict-of-law
+   provisions. Any dispute arising from this agreement shall be resolved
+   exclusively in the courts of that jurisdiction.
+
+═══════════════════════════════════════════════════════════════════════════
+13. SEVERABILITY
+═══════════════════════════════════════════════════════════════════════════
+
+   If any provision of this agreement is held to be unenforceable, the
+   remaining provisions remain in full force and effect, and the
+   unenforceable provision shall be reformed to the minimum extent
+   necessary to make it enforceable while preserving its intent.
+
+═══════════════════════════════════════════════════════════════════════════
+14. ENTIRE AGREEMENT
+═══════════════════════════════════════════════════════════════════════════
+
+   This agreement, together with any signed Founders Agreement or
+   companion NDA executed between the parties, constitutes the entire
+   agreement regarding the Software and supersedes all prior
+   communications, representations, or understandings.
+
+═══════════════════════════════════════════════════════════════════════════
+15. CONTACT
+═══════════════════════════════════════════════════════════════════════════
+
+   Questions, license transfers, alleged violations, or inquiries:
+
+   Rob Rizk
+   Rizk Advertising
+   rob@rizkadvertising.com
+
+═══════════════════════════════════════════════════════════════════════════
+
+NOTICE: By installing the Software, Licensee accepts this agreement in
+full. The Software watermarks identifying information into Confidential
+Materials at install time. This is not negotiable on a per-installation
+basis. Volume licensing, agency tier, and special arrangements available
+on request.

package/README.md

@@ -0,0 +1,61 @@
+# ⚡ Sonic Agent
+
+A specialized AI agent for building WordPress authority websites at scale.
+
+> **Founders cohort license required.** This is a private package — install only works with a valid license key.
+
+---
+
+## Install
+
+```bash
+npm install -g @lebtiga/sonic-agent
+```
+
+You'll be prompted for your license key during install. Format: `SONIC-XXXX-XXXX-XXXX-XXXX`.
+
+If the prompt is skipped (CI, non-interactive shell), run:
+
+```bash
+sonic activate
+```
+
+## Quick start
+
+```bash
+sonic              # start the agent in your project directory
+sonic init         # scaffold a new project workspace
+sonic status       # check install state + license
+sonic update       # pull latest core (your skills + user data are preserved)
+sonic --help       # all commands
+```
+
+## What you get
+
+Sonic installs to `~/.sonic/` with a 3-layer structure:
+
+```
+~/.sonic/
+├── sonic-agent/      ← Core agent (refreshed on `sonic update`)
+├── sonic-skills/     ← Your installed skills (never touched on update)
+└── sonic-user/       ← Your custom skills, client configs, workspace
+    ├── custom-skills/
+    ├── client-configs/
+    └── workspace/
+```
+
+Anything you put in `sonic-skills/` or `sonic-user/` is **yours forever** — `sonic update` will never overwrite it.
+
+## Requires
+
+- Node.js >= 18
+- [Claude Code](https://claude.com/claude-code) installed (the CLI Sonic plugs into)
+
+## Support
+
+- Email: rob@rizkadvertising.com
+- Docs: https://sonic.saasperity.com
+
+## License
+
+Commercial — single seat per license key. Do not redistribute. SOPs and skills are watermarked with the buyer's email for leak detection.

package/bin/sonic.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+// Sonic CLI — main entry point
+// Usage:
+//   sonic                start the Sonic agent (launches Claude Code with the plugin)
+//   sonic init           scaffold a new project workspace in the current directory
+//   sonic activate       enter/re-enter your license key (if postinstall was skipped)
+//   sonic update         pull the latest sonic-agent core (preserves user/skills folders)
+//   sonic status         show install state, license info, version
+//   sonic --version      print version
+//   sonic --help         show this help
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+
+const { isValidFormat } = require('../lib/license');
+const {
+  installPlugin,
+  isInstalled,
+  getLicenseInfo,
+  getSonicHome,
+} = require('../lib/installer');
+
+let c;
+try {
+  c = require('kleur');
+} catch (e) {
+  c = { yellow: (s) => s, red: (s) => s, green: (s) => s, bold: (s) => s, dim: (s) => s, cyan: (s) => s };
+}
+
+let prompts;
+try {
+  prompts = require('prompts');
+} catch (e) {
+  prompts = null;
+}
+
+const pkg = require('../package.json');
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+async function main() {
+  if (!command || command === 'start') {
+    return cmdStart();
+  }
+
+  switch (command) {
+    case 'init':
+      return cmdInit();
+    case 'activate':
+      return cmdActivate();
+    case 'update':
+      return cmdUpdate();
+    case 'status':
+      return cmdStatus();
+    case '-v':
+    case '--version':
+    case 'version':
+      console.log(`sonic v${pkg.version}`);
+      return;
+    case '-h':
+    case '--help':
+    case 'help':
+      return printHelp();
+    default:
+      // Unrecognized — assume the user is passing claude flags or a prompt.
+      // Launch sonic with all args forwarded to claude.
+      return cmdStart();
+  }
+}
+
+function printHelp() {
+  console.log('');
+  console.log(c.cyan('⚡ Sonic Agent') + c.dim(` v${pkg.version}`));
+  console.log(c.dim('────────────────────────────────────────'));
+  console.log('');
+  console.log(c.bold('Commands'));
+  console.log('  ' + c.cyan('sonic') + c.dim('              start the Sonic agent in this directory'));
+  console.log('  ' + c.cyan('sonic init') + c.dim('         scaffold a new project workspace here'));
+  console.log('  ' + c.cyan('sonic activate') + c.dim('     enter your license key'));
+  console.log('  ' + c.cyan('sonic update') + c.dim('       pull the latest core (preserves your skills + user data)'));
+  console.log('  ' + c.cyan('sonic status') + c.dim('       show install state, license, version'));
+  console.log('  ' + c.cyan('sonic --version') + c.dim('    print version'));
+  console.log('  ' + c.cyan('sonic --help') + c.dim('       show this help'));
+  console.log('');
+  console.log(c.dim('Docs: https://sonic.saasperity.com'));
+  console.log(c.dim('Support: rob@rizkadvertising.com'));
+  console.log('');
+}
+
+async function cmdStart() {
+  if (!isInstalled()) {
+    console.log(c.yellow('⚠️  Sonic is not installed yet.'));
+    console.log(c.dim('   Run: ') + c.cyan('sonic activate'));
+    process.exit(1);
+  }
+
+  const sonicAgent = path.join(getSonicHome(), 'sonic-agent');
+
+  // Try to launch Claude Code with the plugin path.
+  // We use `claude` CLI if available, otherwise print instructions.
+  const claudeBin = findClaudeBin();
+  if (!claudeBin) {
+    console.log('');
+    console.log(c.yellow('Claude Code CLI not found on your PATH.'));
+    console.log('');
+    console.log(c.dim('Install it from: https://claude.com/claude-code'));
+    console.log('');
+    console.log(c.dim('Once installed, Sonic lives at:'));
+    console.log('  ' + c.cyan(sonicAgent));
+    console.log('');
+    console.log(c.dim('Add it as a Claude Code plugin and you are ready to go.'));
+    process.exit(1);
+  }
+
+  console.log(c.cyan('⚡ Launching Sonic...'));
+  console.log(c.dim(`   Plugin: ${sonicAgent}`));
+  console.log('');
+
+  // Pass any extra args after `sonic` straight through to claude.
+  const passthrough = process.argv.slice(2).filter((a) => a !== 'start');
+
+  const child = spawn(
+    claudeBin,
+    ['--plugin-dir', sonicAgent, ...passthrough],
+    {
+      stdio: 'inherit',
+      env: {
+        ...process.env,
+        SONIC_HOME: getSonicHome(),
+      },
+    }
+  );
+
+  child.on('exit', (code) => process.exit(code || 0));
+}
+
+async function cmdInit() {
+  const cwd = process.cwd();
+  console.log('');
+  console.log(c.cyan('⚡ Sonic — init project workspace'));
+  console.log(c.dim(`   ${cwd}`));
+  console.log('');
+
+  const dirs = ['.sonic', '.sonic/state', '.sonic/output', 'content', 'images'];
+  for (const d of dirs) {
+    const full = path.join(cwd, d);
+    if (!fs.existsSync(full)) {
+      fs.mkdirSync(full, { recursive: true });
+      console.log(c.green('  + ') + c.dim(d + '/'));
+    } else {
+      console.log(c.dim('  · ' + d + '/ (exists)'));
+    }
+  }
+
+  const configFile = path.join(cwd, '.sonic', 'project.json');
+  if (!fs.existsSync(configFile)) {
+    fs.writeFileSync(
+      configFile,
+      JSON.stringify(
+        {
+          createdAt: new Date().toISOString(),
+          sonicVersion: pkg.version,
+          stage: 'brand',
+        },
+        null,
+        2
+      )
+    );
+    console.log(c.green('  + ') + c.dim('.sonic/project.json'));
+  }
+
+  console.log('');
+  console.log(c.green('✓ Workspace ready.'));
+  console.log(c.dim('  Run ') + c.cyan('sonic') + c.dim(' to start.'));
+  console.log('');
+}
+
+async function cmdActivate() {
+  console.log('');
+  console.log(c.cyan('⚡ Sonic — activate license'));
+  console.log(c.dim('────────────────────────────────────────'));
+  console.log('');
+
+  if (!prompts) {
+    console.log(c.red('Interactive prompts unavailable.'));
+    process.exit(1);
+  }
+
+  const response = await prompts([
+    {
+      type: 'text',
+      name: 'licenseKey',
+      message: 'Enter your Sonic license key:',
+      validate: (value) =>
+        isValidFormat(value) ? true : 'Invalid format. Expected: SONIC-XXXX-XXXX-XXXX-XXXX',
+    },
+    {
+      type: (prev) => (prev ? 'text' : null),
+      name: 'email',
+      message: 'Email address on your Sonic license:',
+      validate: (value) =>
+        value && value.includes('@') && value.includes('.')
+          ? true
+          : 'Please enter a valid email address.',
+    },
+  ]);
+
+  if (!response.licenseKey || !response.email) {
+    console.log(c.yellow('Cancelled.'));
+    process.exit(0);
+  }
+
+  const licenseKey = response.licenseKey.trim().toUpperCase();
+  const email = response.email.trim().toLowerCase();
+
+  console.log('');
+  console.log(c.dim('  Installing Sonic to ~/.sonic ...'));
+  try {
+    const result = installPlugin(licenseKey, email);
+    console.log(c.green('  ✓ Installed'));
+    console.log(c.dim(`    Licensed to: ${email}`));
+    console.log(c.dim(`    ${result.sonicAgent}`));
+  } catch (err) {
+    console.log(c.red(`  ✗ Install failed: ${err.message}`));
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log(c.bold(c.green('⚡ Sonic is ready. Run "sonic" to start.')));
+  console.log('');
+}
+
+async function cmdUpdate() {
+  console.log('');
+  console.log(c.cyan('⚡ Sonic — update'));
+  console.log('');
+
+  const license = getLicenseInfo();
+  if (!license || !license.licenseKey) {
+    console.log(c.yellow('No license on file. Run ') + c.cyan('sonic activate') + c.yellow(' first.'));
+    process.exit(1);
+  }
+
+  console.log(c.dim('  To get the latest version, run:'));
+  console.log('');
+  console.log('    ' + c.cyan('npm install -g @lebtiga/sonic-agent@latest'));
+  console.log('');
+  console.log(c.dim('  This will refresh ~/.sonic/sonic-agent. Your custom skills'));
+  console.log(c.dim('  and user data in ~/.sonic/sonic-skills and ~/.sonic/sonic-user'));
+  console.log(c.dim('  are never touched.'));
+  console.log('');
+}
+
+function cmdStatus() {
+  console.log('');
+  console.log(c.cyan('⚡ Sonic — status'));
+  console.log(c.dim('────────────────────────────────────────'));
+  console.log('');
+  console.log(c.dim('  Version:      ') + pkg.version);
+  console.log(c.dim('  Sonic home:   ') + getSonicHome());
+  console.log(c.dim('  Installed:    ') + (isInstalled() ? c.green('yes') : c.red('no')));
+
+  const license = getLicenseInfo();
+  if (license) {
+    console.log(c.dim('  License key:  ') + maskLicense(license.licenseKey));
+    console.log(c.dim('  Licensed to:  ') + (license.buyerEmail || 'unknown'));
+    console.log(c.dim('  Installed at: ') + (license.installedAt || 'unknown'));
+  } else {
+    console.log(c.dim('  License:      ') + c.yellow('not activated'));
+  }
+  console.log('');
+}
+
+function maskLicense(key) {
+  if (!key) return '';
+  // SONIC-ABCD-EFGH-IJKL-MNOP -> SONIC-ABCD-****-****-MNOP
+  return key.replace(/^(SONIC-[A-Z0-9]{4})-[A-Z0-9]{4}-[A-Z0-9]{4}-([A-Z0-9]{4})$/i, '$1-****-****-$2');
+}
+
+function findClaudeBin() {
+  const candidates = ['claude', 'claude-code'];
+  const PATH = process.env.PATH || '';
+  const sep = process.platform === 'win32' ? ';' : ':';
+  const ext = process.platform === 'win32' ? ['.exe', '.cmd', ''] : [''];
+  for (const dir of PATH.split(sep)) {
+    for (const name of candidates) {
+      for (const e of ext) {
+        const full = path.join(dir, name + e);
+        try {
+          if (fs.existsSync(full) && fs.statSync(full).isFile()) return full;
+        } catch (e) { /* skip */ }
+      }
+    }
+  }
+  return null;
+}
+
+main().catch((err) => {
+  console.error(c.red('Error: ') + err.message);
+  process.exit(1);
+});

package/lib/index.js

@@ -0,0 +1,20 @@
+// @lebtiga/sonic-agent — main module exports.
+// Most users will use the `sonic` CLI; this is for programmatic access.
+
+const license = require('./license');
+const installer = require('./installer');
+
+module.exports = {
+  // license validation
+  validateLicense: license.validateLicense,
+  isValidFormat: license.isValidFormat,
+  getMachineFingerprint: license.getMachineFingerprint,
+
+  // installer
+  installPlugin: installer.installPlugin,
+  isInstalled: installer.isInstalled,
+  getSonicHome: installer.getSonicHome,
+  getLicenseInfo: installer.getLicenseInfo,
+
+  version: require('../package.json').version,
+};