@jawkit.cc/cli 0.1.0

package/LICENSE

@@ -0,0 +1,31 @@
+JawKit CLI - Proprietary Software License
+
+Copyright (c) 2024 JawKit. All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential. The Software is licensed, not sold.
+
+PERMITTED:
+- Install and use the Software for personal or commercial purposes
+- Use the Software with a valid license key
+
+PROHIBITED:
+- Copy, modify, merge, or create derivative works of the Software
+- Distribute, sublicense, sell, or transfer the Software to third parties
+- Reverse engineer, decompile, or disassemble the Software
+- Remove or alter any proprietary notices or labels on the Software
+- Share, redistribute, or publish any content, prompts, skills, or configurations
+  downloaded or installed by the Software ("Content") with any third party
+- Upload Content to public repositories, websites, or file sharing services
+- Include Content in open source projects or public codebases
+
+CONTENT RESTRICTIONS:
+The Content provided through JawKit (including but not limited to prompts, skills,
+commands, configurations, and documentation) is licensed for your personal or
+internal business use only. Sharing Content with others who have not purchased
+their own license is strictly prohibited and may result in license termination.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY.
+
+For licensing inquiries: support@jawkit.cc

package/README.md

@@ -0,0 +1,363 @@
+# JawKit CLI
+
+CLI toolkit for installing AI coding assistant configurations (Claude Code, GitHub Copilot).
+
+## Features
+
+- **Multi-agent support**: Claude Code, GitHub Copilot
+- **Tiered content**: Free and Professional ($99)
+- **Secure delivery**: Signed URLs for premium content
+- **Offline support**: Free tier bundled in npm package
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g @jawkit/cli
+
+# Initialize in your project (free tier - no auth needed)
+jawkit init
+
+# For premium content, purchase at jawkit.dev and activate:
+jawkit auth activate JAWKIT_YOUR_LICENSE_KEY
+
+# Check license status
+jawkit auth status
+```
+
+---
+
+## Technical Stack
+
+### CLI (Node.js)
+
+| Component | Technology | Purpose |
+|-----------|------------|---------|
+| **Runtime** | Node.js 18+ | ES Modules |
+| **CLI Framework** | Commander.js | Command parsing |
+| **Build** | tsup | ES Module bundling |
+| **HTTP Client** | ofetch | API requests |
+| **Prompts** | @inquirer/prompts | Interactive CLI |
+| **Archive** | tar (+ built-in zlib) | tar.gz extraction |
+| **Logging** | chalk + ora | Colors, spinners |
+| **Secure Storage** | keytar | OS keychain for tokens |
+
+### Backend Services
+
+| Service | Technology | Purpose |
+|---------|------------|---------|
+| **Payments** | Paddle | Checkout, subscriptions |
+| **License Data** | Cloudflare D1 | License keys, payments, invitations |
+| **Content Storage** | Cloudflare R2 | Content bundles (tar.gz) |
+| **API Gateway** | Cloudflare Workers | License validation, signed URLs, webhooks |
+| **Email** | Resend | License delivery emails |
+
+### Architecture Overview
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                              JawKit CLI System                               │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  User's Machine                              Cloud Infrastructure            │
+│  ┌─────────────────┐                        ┌─────────────────────────────┐ │
+│  │   jawkit CLI    │                        │          Paddle             │ │
+│  │   (@jawkit/cli) │                        │  ┌───────────────────────┐  │ │
+│  │                 │                        │  │ • Checkout            │  │ │
+│  │  • init         │                        │  │ • Payment processing  │  │ │
+│  │  • auth activate│                        │  └───────────┬───────────┘  │ │
+│  │  • upgrade      │                        │              │ Webhook      │ │
+│  │  • version      │                        └──────────────┼──────────────┘ │
+│  └────────┬────────┘                                       ▼                │
+│           │                                 ┌─────────────────────────────┐ │
+│           │  Validate license               │    Cloudflare Workers       │ │
+│           │◄────────────────────────────────┤  ┌───────────────────────┐  │ │
+│           │  Download content               │  │ • Paddle webhook      │  │ │
+│           │  (signed URLs for premium)      │  │ • License validation  │  │ │
+│           │                                 │  │ • Signed URL gen      │  │ │
+│           │                                 │  │ • D1 Database         │  │ │
+│           │                                 │  └───────────────────────┘  │ │
+│           │                                 └──────────────┬──────────────┘ │
+│           │                                        │       │                │
+│           │                                        ▼       ▼                │
+│           │                                 ┌─────────┐ ┌─────────────────┐ │
+│           └─────────────────────────────────┤   R2    │ │       D1        │ │
+│               Direct download (free tier)   │ Content │ │  license_keys   │ │
+│                                             └─────────┘ │  payments       │ │
+│  ┌─────────────────┐                                    │  invitations    │ │
+│  │  Local Storage  │                                    └─────────────────┘ │
+│  │  ~/.jawkit/     │                        ┌─────────────────────────────┐ │
+│  │  • license      │◄───────────────────────│         Resend              │ │
+│  │  • config.json  │                        │  License delivery email     │ │
+│  │  • cache/       │                        └─────────────────────────────┘ │
+│  └─────────────────┘                                                        │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Project Structure
+
+```
+jawkit-cli/
+├── src/                        # CLI source code
+│   ├── cli.ts                  # Entry point (Commander setup)
+│   ├── index.ts                # Library exports
+│   ├── commands/               # CLI commands
+│   │   ├── auth.ts             # auth activate/redeem/deactivate/status
+│   │   ├── init.ts             # Initialize content
+│   │   ├── upgrade.ts          # Upgrade content
+│   │   └── version.ts          # Show versions
+│   ├── auth/                   # Authentication module
+│   │   ├── auth.service.ts     # License activation, validation
+│   │   ├── license-storage.ts  # Keytar + file fallback for license
+│   │   └── types.ts            # TierLevel, StoredLicense, etc.
+│   ├── content/                # Content management module
+│   │   ├── content.service.ts  # Download orchestration
+│   │   ├── remote-provider.ts  # R2 + Worker API client
+│   │   ├── cache-manager.ts    # Local disk cache
+│   │   ├── bundled-content.ts  # Offline fallback
+│   │   └── extractor.ts        # tar.gz extraction
+│   ├── agents/                 # Agent adapters
+│   │   ├── base-agent.ts       # Abstract base class
+│   │   ├── registry.ts         # Agent registry
+│   │   ├── claude-code/        # Claude Code adapter
+│   │   └── github-copilot/     # GitHub Copilot adapter
+│   └── lib/                    # Utilities
+│       ├── config.ts           # Configuration persistence
+│       ├── errors.ts           # Error classes
+│       ├── promo.ts            # Promotional messages
+│       └── logger.ts           # Console output
+├── cloudflare/
+│   └── workers/
+│       └── jawkit-api/         # Cloudflare Worker
+│           ├── src/
+│           │   ├── index.ts    # Router
+│           │   ├── db/         # D1 repositories
+│           │   │   ├── license-repository.ts
+│           │   │   ├── payment-repository.ts
+│           │   │   └── invitation-repository.ts
+│           │   └── routes/
+│           │       ├── license.ts       # License validation
+│           │       ├── invitation.ts    # Invitation management
+│           │       ├── paddle-webhook.ts # Paddle webhooks
+│           │       └── download.ts      # Signed URL generation
+│           ├── migrations/     # D1 schema migrations
+│           └── public/         # Pricing page static files
+├── content-source/             # Source content by tier
+├── content/                    # Built bundles (generated)
+├── scripts/
+│   ├── bundle-content.ts       # Build content bundles
+│   ├── migrate-to-d1.ts        # Data migration helper
+│   └── local-r2-server.ts      # Local development server
+└── docs/
+    ├── PRD.md                  # Product Requirements
+    ├── PRP-*.md                # Technical specifications
+    └── setup/                  # Setup guides
+```
+
+---
+
+## Development Setup
+
+### Prerequisites
+
+- Node.js 18+
+- Cloudflare account (Workers paid plan for D1)
+- npm or pnpm
+
+### Step 1: Clone and Install
+
+```bash
+git clone https://github.com/jawkit/cli.git
+cd jawkit-cli
+npm install
+```
+
+### Step 2: Set Up Cloudflare D1 Database
+
+```bash
+cd cloudflare/workers/jawkit-api
+
+# Create D1 database
+npx wrangler d1 create jawkit-licenses
+# Copy the database_id to wrangler.toml
+
+# Apply migrations
+npx wrangler d1 migrations apply jawkit-licenses --local
+```
+
+### Step 3: Configure Cloudflare Worker
+
+Create `.dev.vars` in `cloudflare/workers/jawkit-api/`:
+
+```bash
+URL_SIGNING_SECRET=local-dev-secret-change-in-prod
+PADDLE_WEBHOOK_SECRET=pdl_xxx
+PADDLE_API_KEY=your-paddle-api-key
+RESEND_API_KEY=re_xxx
+ADMIN_KEY=local-admin-key
+```
+
+### Step 4: Build and Test
+
+```bash
+# Build CLI
+npm run build
+
+# Test CLI commands
+node dist/cli.js version
+node dist/cli.js init --dry-run
+```
+
+### Step 5: Start Worker for Local Testing
+
+```bash
+cd cloudflare/workers/jawkit-api
+npx wrangler dev
+# Worker runs at http://localhost:8787
+```
+
+---
+
+## Available Scripts
+
+### Root Project
+
+```bash
+npm run dev           # Watch mode build
+npm run build         # Production build
+npm run bundle-content # Build content bundles
+npm run serve:local   # Start local R2 simulation server
+npm run test          # Run tests (watch)
+npm run test:run      # Run tests (single)
+npm run typecheck     # Type checking only
+npm run lint          # ESLint
+```
+
+### Cloudflare Worker
+
+```bash
+cd cloudflare/workers/jawkit-api
+npx wrangler dev           # Start dev server (localhost:8787)
+npx wrangler deploy        # Deploy to Cloudflare
+npx wrangler d1 migrations apply jawkit-licenses --local   # Apply migrations locally
+npx wrangler d1 migrations apply jawkit-licenses --remote  # Apply to production
+```
+
+---
+
+## Environment Variables
+
+### CLI (built-in defaults for production)
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `JAWKIT_API_URL` | API URL for license validation | `https://jawkit-api.xxx.workers.dev` |
+| `R2_PUBLIC_URL` | Content CDN URL | `https://content.jawkit.dev` |
+
+### Cloudflare Worker Secrets
+
+| Variable | Type | Description |
+|----------|------|-------------|
+| `URL_SIGNING_SECRET` | secret | HMAC secret for signed URLs |
+| `PADDLE_WEBHOOK_SECRET` | secret | Paddle webhook signature verification |
+| `PADDLE_API_KEY` | secret | Paddle API for customer lookup |
+| `RESEND_API_KEY` | secret | Resend API for license emails |
+| `ADMIN_KEY` | secret | Admin endpoint authentication |
+
+---
+
+## Tier System
+
+| Tier | Level | Price | Content |
+|------|-------|-------|---------|
+| `free` | 0 | $0 | Basic commands and skills (no auth required) |
+| `professional` | 1 | $99 one-time | All content including agents, advanced commands, skills |
+
+Professional tier includes all free tier content. Purchased via Paddle checkout.
+
+---
+
+## API Endpoints
+
+### Cloudflare Worker
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/health` | Health check |
+| POST | `/license/validate` | Validate license key, returns tier info |
+| POST | `/invitation/create` | Create invitation (admin) |
+| POST | `/invitation/redeem` | Redeem invitation code |
+| GET | `/invitation/check/:code` | Check invitation validity |
+| GET | `/invitation/list` | List invitations (admin) |
+| POST | `/webhook/paddle` | Paddle payment webhook handler |
+| GET | `/manifests/latest.json` | Get content manifest |
+| GET | `/bundles/:agent/:version/free.tar.gz` | Download free bundle |
+| POST | `/get-download-url` | Get signed URL for premium bundle |
+| GET | `/download/:path` | Download with signature verification |
+| GET | `/` | Pricing page (static) |
+| GET | `/success.html` | Post-purchase success page |
+
+---
+
+## Documentation
+
+### Setup Guides
+
+| Guide | Description |
+|-------|-------------|
+| [Cloudflare Setup](docs/setup/01-cloudflare-setup.md) | D1, Worker, and R2 deployment |
+| [Development Workflow](docs/setup/02-development-workflow.md) | Day-to-day development |
+| [Content Authoring](docs/setup/03-content-authoring.md) | Creating content bundles |
+| [Content Pipeline](docs/setup/04-content-pipeline.md) | End-to-end content flow |
+| [Init Command Flow](docs/setup/05-init-command-flow.md) | Detailed init flow |
+| [Tier Management](docs/setup/06-tier-management.md) | Adding/modifying tiers |
+| [CLI Reference](docs/setup/07-cli-reference.md) | Complete workflow reference |
+| [Local Testing](docs/setup/08-local-testing.md) | Testing without cloud |
+
+### Technical Specifications
+
+| Document | Description |
+|----------|-------------|
+| [PRD.md](docs/PRD.md) | Product Requirements Document |
+| [PRP-001](docs/PRP-001-CLI-Core.md) | CLI Core Architecture |
+| [PRP-002](docs/PRP-002-Authentication.md) | Authentication System |
+| [PRP-003](docs/PRP-003-Agent-Adapters.md) | Agent Adapter System |
+| [PRP-004](docs/PRP-004-Content-Management.md) | Content Management |
+| [PRP-005](docs/PRP-005-Version-Management.md) | Version Management |
+
+---
+
+## Maintainer Guide
+
+### Key Files for Common Changes
+
+| Task | Files to Modify |
+|------|-----------------|
+| Add CLI command | `src/commands/`, `src/cli.ts` |
+| Add agent adapter | `src/agents/`, `src/agents/registry.ts` |
+| Modify auth flow | `src/auth/auth.service.ts`, Worker `/routes/license.ts` |
+| Change tier system | `src/auth/types.ts`, Worker, D1 migrations |
+| Update content schema | `src/content/types.ts`, `scripts/bundle-content.ts` |
+
+### Security Notes
+
+1. **License Keys**: Stored in OS keychain (keytar) with file fallback (0600 permissions)
+2. **Signed URLs**: HMAC-SHA256, 1-hour expiry, served through Worker
+3. **Webhook Security**: Paddle signature verification (HMAC-SHA256)
+4. **Tier Access**: Server-side license validation in Cloudflare Worker
+
+### Testing Checklist
+
+- [ ] `npm run typecheck` - No type errors
+- [ ] `npm run lint` - No lint errors
+- [ ] `npm run test:run` - All tests pass
+- [ ] `npm run build` - Builds successfully
+- [ ] Manual test: `jawkit init --dry-run` works
+
+---
+
+## License
+
+Proprietary - All rights reserved. This software is confidential and proprietary to JawKit.

package/content/manifest.json

@@ -0,0 +1,50 @@
+{
+  "schemaVersion": "2.0",
+  "version": "1.0.0",
+  "publishedAt": "2026-01-28T08:40:15.068Z",
+  "minCliVersion": "1.0.0",
+  "agents": {
+    "claude-code": {
+      "version": "1.0.0",
+      "bundles": {
+        "free": {
+          "filename": "free.tar.gz",
+          "checksum": "sha256:4c65511fc6de980913c3d0bc01bb5e0e187f2a7d5e0d3123a1cfdd39cf152372",
+          "size": 2774,
+          "fileCount": 6,
+          "contentTypes": [
+            "commands",
+            "skills"
+          ]
+        },
+        "professional": {
+          "filename": "professional.tar.gz",
+          "checksum": "sha256:6c73c3e24b0e4f300be69e7aa103b232a01081d2c2e1ba0f23dffc85759e74da",
+          "size": 4443,
+          "fileCount": 8,
+          "contentTypes": [
+            "agents",
+            "commands",
+            "skills"
+          ]
+        }
+      }
+    },
+    "github-copilot": {
+      "version": "1.0.0",
+      "bundles": {
+        "free": {
+          "filename": "free.tar.gz",
+          "checksum": "sha256:8ec1f6999b1a1ccf067d2b1b0a93906d9950ccf48bf42465082f0712678867ca",
+          "size": 1052,
+          "fileCount": 2,
+          "contentTypes": [
+            "commands",
+            "skills"
+          ]
+        }
+      }
+    }
+  },
+  "changelog": "## v1.0.0\n\n- Initial release"
+}