@dk/jolly 0.1.0

package/README.md

@@ -0,0 +1,121 @@
+# Jolly - Saleor CLI for AI Agents
+
+Bootstraps Saleor projects and configures AI agents with Saleor skills.
+
+## Installation
+
+```bash
+npm install -g @saleor/jolly
+```
+
+## Commands
+
+### Store Management
+
+```bash
+# Create a new Saleor Cloud store
+jolly store create --name my-store
+
+# Create with specific region
+jolly store create --name my-store --region eu-west-1
+
+# List your stores
+jolly store list
+
+# Create environment
+jolly store env create --store <store-id> --name production
+```
+
+### App Scaffolding
+
+```bash
+# Create a dashboard extension
+jolly app create --name my-dashboard --type dashboard-extension
+
+# Create a payment app (hosted)
+jolly app create --name my-payment --type payment --provider stripe
+
+# Create a webhook handler
+jolly app create --name my-webhook --type webhook
+```
+
+### Agent Setup
+
+```bash
+# Setup AI agent with Saleor skills and MCP
+jolly agent setup
+
+# Install skills only
+jolly agent skills install
+
+# Setup in specific directory
+jolly agent setup --path /my/project
+```
+
+### Configuration
+
+```bash
+# Deploy configuration to store
+jolly config deploy --store <store-id>
+
+# Introspect current configuration
+jolly config introspect --store <store-id>
+```
+
+## npm Entry Points
+
+```bash
+# Bootstrap new Saleor project
+npm create @saleor/jolly my-project
+
+# Configure AI agent for Saleor
+npm init @saleor/jolly
+```
+
+## Environment Variables
+
+You can set environment variables via a `.env` file:
+
+```bash
+# Copy the example file
+cp .env.example .env
+
+# Edit with your token
+SALEOR_CLOUD_TOKEN=your-token-here
+```
+
+Or export directly:
+
+```bash
+export SALEOR_CLOUD_TOKEN=your-token-here
+```
+
+Get your token at: https://cloud.saleor.io/settings/api-tokens
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Build
+bun run build
+
+# Run tests
+bun test
+
+# Type check
+bun run typecheck
+```
+
+## Architecture
+
+- **CLI Framework**: yargs for argument parsing
+- **Runtime**: Bun
+- **API Client**: Direct Saleor Cloud API integration
+- **Agent Skills**: saleor/agent-skills from GitHub
+- **MCP**: Official saleor-mcp at mcp.saleor.app
+
+## License
+
+MIT

package/bun.lock

@@ -0,0 +1,65 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "@saleor/jolly",
+      "dependencies": {
+        "dotenv": "^17.4.0",
+        "yargs": "^17.7.2",
+      },
+      "devDependencies": {
+        "@types/yargs": "^17.0.32",
+        "bun-types": "^1.3.11",
+        "typescript": "^5.4.0",
+      },
+    },
+  },
+  "packages": {
+    "@types/node": ["@types/node@25.5.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw=="],
+
+    "@types/yargs": ["@types/yargs@17.0.35", "", { "dependencies": { "@types/yargs-parser": "*" } }, "sha512-qUHkeCyQFxMXg79wQfTtfndEC+N9ZZg76HJftDJp+qH2tV7Gj4OJi7l+PiWwJ+pWtW8GwSmqsDj/oymhrTWXjg=="],
+
+    "@types/yargs-parser": ["@types/yargs-parser@21.0.3", "", {}, "sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ=="],
+
+    "ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
+
+    "ansi-styles": ["ansi-styles@4.3.0", "", { "dependencies": { "color-convert": "^2.0.1" } }, "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg=="],
+
+    "bun-types": ["bun-types@1.3.11", "", { "dependencies": { "@types/node": "*" } }, "sha512-1KGPpoxQWl9f6wcZh57LvrPIInQMn2TQ7jsgxqpRzg+l0QPOFvJVH7HmvHo/AiPgwXy+/Thf6Ov3EdVn1vOabg=="],
+
+    "cliui": ["cliui@8.0.1", "", { "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.1", "wrap-ansi": "^7.0.0" } }, "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ=="],
+
+    "color-convert": ["color-convert@2.0.1", "", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="],
+
+    "color-name": ["color-name@1.1.4", "", {}, "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="],
+
+    "dotenv": ["dotenv@17.4.0", "", {}, "sha512-kCKF62fwtzwYm0IGBNjRUjtJgMfGapII+FslMHIjMR5KTnwEmBmWLDRSnc3XSNP8bNy34tekgQyDT0hr7pERRQ=="],
+
+    "emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+
+    "escalade": ["escalade@3.2.0", "", {}, "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA=="],
+
+    "get-caller-file": ["get-caller-file@2.0.5", "", {}, "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg=="],
+
+    "is-fullwidth-code-point": ["is-fullwidth-code-point@3.0.0", "", {}, "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg=="],
+
+    "require-directory": ["require-directory@2.1.1", "", {}, "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q=="],
+
+    "string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
+
+    "strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
+
+    "wrap-ansi": ["wrap-ansi@7.0.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q=="],
+
+    "y18n": ["y18n@5.0.8", "", {}, "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA=="],
+
+    "yargs": ["yargs@17.7.2", "", { "dependencies": { "cliui": "^8.0.1", "escalade": "^3.1.1", "get-caller-file": "^2.0.5", "require-directory": "^2.1.1", "string-width": "^4.2.3", "y18n": "^5.0.5", "yargs-parser": "^21.1.1" } }, "sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w=="],
+
+    "yargs-parser": ["yargs-parser@21.1.1", "", {}, "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw=="],
+  }
+}

package/bunfig.toml

@@ -0,0 +1,8 @@
+[build]
+target = "bun"
+
+[install]
+peer = true
+
+[test]
+root = "src/test"

package/dist/agent.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env bun
+// @bun
+
+// src/agents/setup.ts
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { spawnSync } from "child_process";
+import { join } from "path";
+
+// src/tui/theme.ts
+var theme = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  italic: "\x1B[3m",
+  underline: "\x1B[4m",
+  fg: {
+    black: "\x1B[30m",
+    red: "\x1B[31m",
+    green: "\x1B[32m",
+    yellow: "\x1B[33m",
+    blue: "\x1B[34m",
+    magenta: "\x1B[35m",
+    cyan: "\x1B[36m",
+    white: "\x1B[37m",
+    gray: "\x1B[90m",
+    brightBlack: "\x1B[30;1m",
+    brightRed: "\x1B[31;1m",
+    brightGreen: "\x1B[32;1m",
+    brightYellow: "\x1B[33;1m",
+    brightBlue: "\x1B[34;1m",
+    brightMagenta: "\x1B[35;1m",
+    brightCyan: "\x1B[36;1m",
+    brightWhite: "\x1B[37;1m"
+  },
+  bg: {
+    black: "\x1B[40m",
+    red: "\x1B[41m",
+    green: "\x1B[42m",
+    yellow: "\x1B[43m",
+    blue: "\x1B[44m",
+    magenta: "\x1B[45m",
+    cyan: "\x1B[46m",
+    white: "\x1B[47m"
+  }
+};
+
+// src/tui/components.ts
+function text(content, color) {
+  return `${color || theme.fg.white}${content}${theme.reset}`;
+}
+function success(msg) {
+  return text(msg, theme.fg.green);
+}
+function info(msg) {
+  return text(msg, theme.fg.cyan);
+}
+
+// src/agents/setup.ts
+var AGENT_PATHS = {
+  opencode: {
+    skills: ".agents/skills",
+    agentsMd: "AGENTS.md",
+    mcpJson: ".mcp.json"
+  },
+  claude: {
+    skills: ".claude/skills",
+    agentsMd: "CLAUDE.md",
+    mcpJson: ".mcp.json"
+  },
+  openclaw: {
+    skills: ".openclaw/skills",
+    agentsMd: "AGENTS.md",
+    mcpJson: ".mcp.json"
+  },
+  nanobot: {
+    skills: ".nanobot/skills",
+    agentsMd: "AGENTS.md",
+    mcpJson: ".mcp.json"
+  }
+};
+var SKILLS = [
+  "saleor-app",
+  "saleor-configurator",
+  "saleor-core",
+  "saleor-storefront"
+];
+async function setupAgent(projectPath = ".") {
+  info("Detecting AI agents...");
+  const detectedAgents = detectAgents(projectPath);
+  if (detectedAgents.length === 0) {
+    info("No AI agents detected. Installing skills anyway...");
+    installSkills(projectPath, "opencode");
+    createAgentsMd(projectPath);
+    createMcpConfig(projectPath);
+    return;
+  }
+  info(`Detected agents: ${detectedAgents.map((a) => a.name).join(", ")}
+`);
+  for (const agent of detectedAgents) {
+    info(`Configuring ${agent.name}...`);
+    installSkills(projectPath, agent.name);
+    createAgentsMd(projectPath, agent.name);
+    createMcpConfig(projectPath);
+    success(`  ${agent.name} configured!`);
+  }
+  success(`
+Agent setup complete!`);
+  info(`
+Skills installed: ` + SKILLS.join(", "));
+  info("AGENTS.md created with Saleor conventions");
+  info(".mcp.json configured for saleor-mcp");
+}
+async function installSkillsCommand(projectPath = ".") {
+  info("Installing Saleor agent skills...");
+  info("Skills: " + SKILLS.join(", "));
+  const detectedAgents = detectAgents(projectPath);
+  if (detectedAgents.length === 0) {
+    installSkills(projectPath, "opencode");
+  } else {
+    for (const agent of detectedAgents) {
+      installSkills(projectPath, agent.name);
+    }
+  }
+  success(`
+Skills installed successfully!`);
+}
+function detectAgents(projectPath) {
+  const detected = [];
+  const filesToCheck = [
+    { name: "opencode", file: ".agents/skills" },
+    { name: "claude", file: ".claude" },
+    { name: "openclaw", file: ".openclaw" },
+    { name: "nanobot", file: ".nanobot" }
+  ];
+  for (const { name, file } of filesToCheck) {
+    const fullPath = join(projectPath, file);
+    if (existsSync(fullPath)) {
+      detected.push({
+        name,
+        path: fullPath,
+        skillsPath: join(fullPath, "skills")
+      });
+    }
+  }
+  return detected;
+}
+function installSkills(projectPath, agentName) {
+  const agentPaths = AGENT_PATHS[agentName];
+  const skillsDir = join(projectPath, agentPaths.skills);
+  mkdirSync(skillsDir, { recursive: true });
+  info(`  Installing skills to ${skillsDir}...`);
+  const skillUrl = "https://github.com/saleor/agent-skills";
+  const baseDir = join(skillsDir, "..");
+  try {
+    const result = spawnSync("git", ["clone", "--depth", "1", skillUrl, "skills"], {
+      cwd: baseDir,
+      stdio: "pipe"
+    });
+    if (result.status === 0) {
+      for (const skill of SKILLS) {
+        info(`  Installed ${skill}`);
+      }
+      success(`  Skills installed to ${skillsDir}`);
+    } else {
+      info(`  Could not clone skills, skipping...`);
+    }
+  } catch {
+    info(`  Could not clone skills, skipping...`);
+  }
+}
+function createAgentsMd(projectPath, agentName = "opencode") {
+  const agentsMdContent = `# Saleor Development Guide
+
+This project uses Saleor e-commerce platform.
+
+## Commands
+
+\`\`\`bash
+# Development
+npm run dev
+
+# Build
+npm run build
+
+# Test
+npm run test
+
+# Lint
+npm run lint
+\`\`\`
+
+## Saleor Cloud
+
+- Dashboard: https://cloud.saleor.io
+- Documentation: https://docs.saleor.io
+- API Reference: https://docs.saleor.io/api
+
+## Saleor Skills
+
+This project includes Saleor agent skills:
+- saleor-app: App development patterns
+- saleor-configurator: Config as code
+- saleor-core: Backend internals
+- saleor-storefront: Storefront patterns
+
+## MCP Server
+
+Configure saleor-mcp for AI agent capabilities:
+\`\`\`json
+{
+  "mcpServers": {
+    "saleor": {
+      "url": "https://mcp.saleor.app"
+    }
+  }
+}
+\`\`\`
+`;
+  const agentsMdPath = join(projectPath, "AGENTS.md");
+  writeFileSync(agentsMdPath, agentsMdContent);
+  info(`  Created AGENTS.md`);
+}
+function createMcpConfig(projectPath) {
+  const mcpConfig = {
+    mcpServers: {
+      saleor: {
+        url: "https://mcp.saleor.app"
+      }
+    }
+  };
+  const mcpPath = join(projectPath, ".mcp.json");
+  writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2));
+  info(`  Created .mcp.json`);
+}
+
+// src/cli/agent.ts
+async function main() {
+  const args = process.argv.slice(2);
+  const action = args[0] || "setup";
+  if (action === "setup" || action === "install") {
+    console.log("Saleor Agent Setup");
+    console.log(`-------------------
+`);
+    await setupAgent(".");
+    console.log(`
+Agent configured successfully!`);
+    console.log("Restart your AI agent to enable Saleor capabilities.");
+  } else if (action === "skills") {
+    await installSkillsCommand(".");
+  } else {
+    console.error(`Unknown action: ${action}`);
+    console.log("Usage: jolly-agent [setup|skills]");
+    process.exit(1);
+  }
+}
+main().catch((err) => {
+  console.error(`Agent setup failed: ${err}`);
+  process.exit(1);
+});