@ekaone/json-cli 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eka Prasetia <ekaone3033@gmail.com> (https://prasetia.me)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# json-cli
+
+> Under active development - not released yet
+
+AI-powered CLI task runner. Describe your goal in plain English — AI generates a validated JSON command plan — runner executes it step by step.
+
+## Installation
+
+```bash
+npm install @ekaone/json-cli
+```
+
+```bash
+pnpm install @ekaone/json-cli
+```
+
+```bash
+yarn install @ekaone/json-cli
+```
+
+## Usage 
+
+```
+export ANTHROPIC_API_KEY=your_key_here
+```
+
+```bash
+json-cli "please run tests"
+```
+
+### For local development
+
+```bash
+pnpm install
+```
+
+### Usage
+
+```bash
+# Using Claude (default)
+pnpm dev "install deps and run tests"
+
+# Using OpenAI
+pnpm dev "run build and publish" --provider openai
+
+# Using Ollama (local)
+pnpm dev "start dev server" --provider ollama
+```
+
+## How it works
+
+```
+User Prompt
+    │
+    ▼
+AI Provider         ← Claude / OpenAI / Ollama
+    │
+    ▼
+JSON Plan           ← validated by Zod schema
+    │
+    ▼
+Catalog Check       ← whitelist prevents hallucinated commands
+    │
+    ▼
+Confirm (y/n)       ← user reviews before execution
+    │
+    ▼
+Runner              ← executes steps, streams output live
+```
+
+## Allowed commands
+
+| Type  | Commands |
+|-------|----------|
+| pnpm  | install, run, build, test, publish, add, remove |
+| npm   | install, run, build, test, publish, ci |
+| yarn  | install, run, build, test, publish, add, remove |
+| bun   | install, run, build, test, publish, add, remove |
+| git   | init, add, commit, push, pull, clone, status, log |
+| shell | any *(requires extra caution)* |
+
+## Environment variables
+
+```bash
+ANTHROPIC_API_KEY=sk-ant-...
+OPENAI_API_KEY=sk-...
+```
+
+## Run tests
+
+```bash
+pnpm test
+```
+
+## License
+
+MIT © [Eka Prasetia](https://prasetia.me/)
+
+## Links
+
+- [npm Package](https://www.npmjs.com/package/@ekaone/json-cli)
+- [GitHub Repository](https://github.com/ekaone/json-cli)
+- [Issue Tracker](https://github.com/ekaone/json-cli/issues)
+
+⭐ If this library helps you, please consider giving it a star on GitHub!

package/dist/cli.cjs

@@ -0,0 +1,317 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli.ts
+var p = __toESM(require("@clack/prompts"), 1);
+
+// src/providers/claude.ts
+var import_sdk = __toESM(require("@anthropic-ai/sdk"), 1);
+function createClaudeProvider(apiKey) {
+  const client = new import_sdk.default({ apiKey: apiKey ?? process.env.ANTHROPIC_API_KEY });
+  return {
+    name: "claude",
+    async generate(userPrompt, systemPrompt) {
+      const message = await client.messages.create({
+        model: "claude-opus-4-5",
+        max_tokens: 1024,
+        system: systemPrompt,
+        messages: [{ role: "user", content: userPrompt }]
+      });
+      const block = message.content[0];
+      if (block.type !== "text") throw new Error("Unexpected response type from Claude");
+      return block.text;
+    }
+  };
+}
+
+// src/providers/openai.ts
+var import_openai = __toESM(require("openai"), 1);
+function createOpenAIProvider(apiKey) {
+  const client = new import_openai.default({ apiKey: apiKey ?? process.env.OPENAI_API_KEY });
+  return {
+    name: "openai",
+    async generate(userPrompt, systemPrompt) {
+      const response = await client.chat.completions.create({
+        model: "gpt-4o",
+        messages: [
+          { role: "system", content: systemPrompt },
+          { role: "user", content: userPrompt }
+        ],
+        max_tokens: 1024,
+        response_format: { type: "json_object" }
+        // enforces JSON output
+      });
+      const content = response.choices[0]?.message.content;
+      if (!content) throw new Error("Empty response from OpenAI");
+      return content;
+    }
+  };
+}
+
+// src/providers/ollama.ts
+function createOllamaProvider(model = "llama3.2", baseUrl = "http://localhost:11434") {
+  return {
+    name: `ollama/${model}`,
+    async generate(userPrompt, systemPrompt) {
+      const response = await fetch(`${baseUrl}/api/chat`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          model,
+          stream: false,
+          messages: [
+            { role: "system", content: systemPrompt },
+            { role: "user", content: userPrompt }
+          ]
+        })
+      });
+      if (!response.ok) throw new Error(`Ollama error: ${response.statusText}`);
+      const data = await response.json();
+      const content = data?.message?.content;
+      if (!content) throw new Error("Empty response from Ollama");
+      return content;
+    }
+  };
+}
+
+// src/providers/index.ts
+function resolveProvider(name) {
+  switch (name) {
+    case "claude":
+      return createClaudeProvider();
+    case "openai":
+      return createOpenAIProvider();
+    case "ollama":
+      return createOllamaProvider();
+    default:
+      throw new Error(`Unknown provider: ${name}`);
+  }
+}
+
+// src/catalog.ts
+var import_zod = require("zod");
+var CATALOG = {
+  npm: ["install", "run", "build", "test", "publish", "ci"],
+  pnpm: ["install", "run", "build", "test", "publish", "add", "remove"],
+  yarn: ["install", "run", "build", "test", "publish", "add", "remove"],
+  bun: ["install", "run", "build", "test", "publish", "add", "remove"],
+  git: ["init", "add", "commit", "push", "pull", "clone", "status", "log"],
+  shell: ["any"]
+  // escape hatch — always requires extra confirmation
+};
+var StepSchema = import_zod.z.object({
+  id: import_zod.z.number(),
+  type: import_zod.z.enum(["npm", "pnpm", "yarn", "bun", "git", "shell"]),
+  command: import_zod.z.string(),
+  args: import_zod.z.array(import_zod.z.string()).default([]),
+  description: import_zod.z.string(),
+  cwd: import_zod.z.string().optional()
+  // optional working directory override
+});
+var PlanSchema = import_zod.z.object({
+  goal: import_zod.z.string(),
+  steps: import_zod.z.array(StepSchema).min(1).max(10)
+});
+function validateStep(step) {
+  const allowed = CATALOG[step.type];
+  if (step.type === "shell") {
+    return { valid: true };
+  }
+  if (!allowed.includes(step.command)) {
+    return {
+      valid: false,
+      reason: `"${step.command}" is not an allowed command for type "${step.type}". Allowed: ${allowed.join(", ")}`
+    };
+  }
+  return { valid: true };
+}
+function buildCatalogPrompt() {
+  const lines = Object.entries(CATALOG).map(([type, commands]) => {
+    const list = commands[0] === "any" ? "any shell command (use sparingly)" : commands.join(", ");
+    return `  - ${type}: [${list}]`;
+  });
+  return `Allowed command types and commands:
+${lines.join("\n")}`;
+}
+
+// src/planner.ts
+function buildSystemPrompt() {
+  return `You are a CLI task planner. Given a user's goal, generate a JSON execution plan.
+
+${buildCatalogPrompt()}
+
+Rules:
+- ONLY use command types and commands listed above
+- Prefer pnpm over npm unless the user specifies otherwise
+- Use "shell" type only when no other type fits
+- Keep steps minimal \u2014 don't add unnecessary steps
+- Each step must have a clear, short description
+
+Respond ONLY with valid JSON matching this exact shape, no markdown, no explanation:
+{
+  "goal": "string describing the overall goal",
+  "steps": [
+    {
+      "id": 1,
+      "type": "pnpm",
+      "command": "run",
+      "args": ["dev"],
+      "description": "Start dev server"
+    }
+  ]
+}`;
+}
+async function generatePlan(userPrompt, provider) {
+  const raw = await provider.generate(userPrompt, buildSystemPrompt());
+  const cleaned = raw.replace(/```json|```/g, "").trim();
+  let parsed;
+  try {
+    parsed = JSON.parse(cleaned);
+  } catch {
+    throw new Error(`AI returned invalid JSON:
+${cleaned}`);
+  }
+  const result = PlanSchema.safeParse(parsed);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+    throw new Error(`Plan failed schema validation:
+${issues}`);
+  }
+  for (const step of result.data.steps) {
+    const check = validateStep(step);
+    if (!check.valid) {
+      throw new Error(`Step ${step.id} failed catalog validation: ${check.reason}`);
+    }
+  }
+  return result.data;
+}
+
+// src/runner.ts
+var import_execa = require("execa");
+function resolveCommand(step) {
+  if (step.type === "shell") {
+    return { bin: step.command, args: step.args };
+  }
+  return { bin: step.type, args: [step.command, ...step.args] };
+}
+async function runStep(step) {
+  const { bin, args } = resolveCommand(step);
+  try {
+    await (0, import_execa.execa)(bin, args, {
+      cwd: step.cwd ?? process.cwd(),
+      stdout: "inherit",
+      // stream directly to terminal
+      stderr: "inherit"
+    });
+    return { success: true };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { success: false, error: message };
+  }
+}
+async function runPlan(plan, onStep) {
+  const total = plan.steps.length;
+  for (let i = 0; i < total; i++) {
+    const step = plan.steps[i];
+    onStep(step, i, total);
+    const result = await runStep(step);
+    if (!result.success) {
+      return { success: false, failedStep: step, error: result.error };
+    }
+  }
+  return { success: true };
+}
+
+// src/cli.ts
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const providerFlag = args.indexOf("--provider");
+  const provider = providerFlag !== -1 ? args[providerFlag + 1] : "claude";
+  const prompt = args.filter(
+    (a, i) => !a.startsWith("--") && (providerFlag === -1 || i !== providerFlag + 1)
+  ).join(" ");
+  if (!prompt) {
+    console.error(
+      'Usage: json-cli "<your goal>" [--provider claude|openai|ollama]'
+    );
+    process.exit(1);
+  }
+  return { prompt, provider };
+}
+function formatStep(step) {
+  const cmd = step.type === "shell" ? `${step.command} ${step.args.join(" ")}` : `${step.type} ${step.command} ${step.args.join(" ")}`.trim();
+  return `${cmd.padEnd(35)} \u2192 ${step.description}`;
+}
+async function main() {
+  const { prompt, provider: providerName } = parseArgs();
+  p.intro(`json-cli \u2014 powered by ${providerName}`);
+  const spinner2 = p.spinner();
+  spinner2.start("Thinking...");
+  let plan;
+  try {
+    const provider = resolveProvider(providerName);
+    plan = await generatePlan(prompt, provider);
+    spinner2.stop("Plan ready");
+  } catch (err) {
+    spinner2.stop("Failed to generate plan");
+    p.log.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+  p.log.info(`Goal: ${plan.goal}
+`);
+  plan.steps.forEach((step, i) => {
+    const isShell = step.type === "shell";
+    p.log.message(
+      `  ${i + 1}. ${formatStep(step)}${isShell ? "  \u26A0 shell" : ""}`
+    );
+  });
+  const hasShell = plan.steps.some((s) => s.type === "shell");
+  if (hasShell) {
+    p.log.warn(
+      "Plan contains shell commands \u2014 review carefully before proceeding."
+    );
+  }
+  const confirmed = await p.confirm({ message: "Proceed?" });
+  if (p.isCancel(confirmed) || !confirmed) {
+    p.cancel("Aborted.");
+    process.exit(0);
+  }
+  console.log("");
+  const result = await runPlan(plan, (step, i, total) => {
+    p.log.step(`Step ${i + 1}/${total}: ${formatStep(step)}`);
+  });
+  if (result.success) {
+    p.outro("\u2705 All steps completed successfully.");
+  } else {
+    p.log.error(
+      `\u274C Failed at step ${result.failedStep?.id}: ${result.failedStep?.description}
+${result.error ?? ""}`
+    );
+    process.exit(1);
+  }
+}
+main();
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/providers/claude.ts","../src/providers/openai.ts","../src/providers/ollama.ts","../src/providers/index.ts","../src/catalog.ts","../src/planner.ts","../src/runner.ts"],"sourcesContent":["#!/usr/bin/env node\nimport * as p from \"@clack/prompts\";\nimport { resolveProvider, type ProviderName } from \"./providers/index.js\";\nimport { generatePlan } from \"./planner.js\";\nimport { runPlan } from \"./runner.js\";\nimport type { Step } from \"./catalog.js\";\n\n// ---------------------------------------------------------------------------\n// Parse CLI args\n// e.g. json-cli \"run tests\" --provider claude\n// ---------------------------------------------------------------------------\nfunction parseArgs(): { prompt: string; provider: ProviderName } {\n  const args = process.argv.slice(2);\n  const providerFlag = args.indexOf(\"--provider\");\n  const provider: ProviderName =\n    providerFlag !== -1 ? (args[providerFlag + 1] as ProviderName) : \"claude\";\n\n  const prompt = args\n    .filter(\n      (a, i) =>\n        !a.startsWith(\"--\") && (providerFlag === -1 || i !== providerFlag + 1),\n    )\n    .join(\" \");\n\n  if (!prompt) {\n    console.error(\n      'Usage: json-cli \"<your goal>\" [--provider claude|openai|ollama]',\n    );\n    process.exit(1);\n  }\n\n  return { prompt, provider };\n}\n\n// ---------------------------------------------------------------------------\n// Format a step for display\n// ---------------------------------------------------------------------------\nfunction formatStep(step: Step): string {\n  const cmd =\n    step.type === \"shell\"\n      ? `${step.command} ${step.args.join(\" \")}`\n      : `${step.type} ${step.command} ${step.args.join(\" \")}`.trim();\n  return `${cmd.padEnd(35)} → ${step.description}`;\n}\n\n// ---------------------------------------------------------------------------\n// Main\n// ---------------------------------------------------------------------------\nasync function main() {\n  const { prompt, provider: providerName } = parseArgs();\n\n  p.intro(`json-cli — powered by ${providerName}`);\n\n  // Step 1: Generate plan\n  const spinner = p.spinner();\n  spinner.start(\"Thinking...\");\n\n  let plan;\n  try {\n    const provider = resolveProvider(providerName);\n    plan = await generatePlan(prompt, provider);\n    spinner.stop(\"Plan ready\");\n  } catch (err) {\n    spinner.stop(\"Failed to generate plan\");\n    p.log.error(err instanceof Error ? err.message : String(err));\n    process.exit(1);\n  }\n\n  // Step 2: Show plan\n  p.log.info(`Goal: ${plan.goal}\\n`);\n  plan.steps.forEach((step, i) => {\n    const isShell = step.type === \"shell\";\n    p.log.message(\n      `  ${i + 1}. ${formatStep(step)}${isShell ? \"  ⚠ shell\" : \"\"}`,\n    );\n  });\n\n  // Step 3: Extra warning if any shell steps\n  const hasShell = plan.steps.some((s) => s.type === \"shell\");\n  if (hasShell) {\n    p.log.warn(\n      \"Plan contains shell commands — review carefully before proceeding.\",\n    );\n  }\n\n  // Step 4: Confirm\n  const confirmed = await p.confirm({ message: \"Proceed?\" });\n  if (p.isCancel(confirmed) || !confirmed) {\n    p.cancel(\"Aborted.\");\n    process.exit(0);\n  }\n\n  // Step 5: Execute\n  console.log(\"\");\n  const result = await runPlan(plan, (step, i, total) => {\n    p.log.step(`Step ${i + 1}/${total}: ${formatStep(step)}`);\n  });\n\n  // Step 6: Result\n  if (result.success) {\n    p.outro(\"✅ All steps completed successfully.\");\n  } else {\n    p.log.error(\n      `❌ Failed at step ${result.failedStep?.id}: ${result.failedStep?.description}\\n${result.error ?? \"\"}`,\n    );\n    process.exit(1);\n  }\n}\n\nmain();\n","import Anthropic from \"@anthropic-ai/sdk\";\nimport type { AIProvider } from \"./types.js\";\n\nexport function createClaudeProvider(apiKey?: string): AIProvider {\n  const client = new Anthropic({ apiKey: apiKey ?? process.env.ANTHROPIC_API_KEY });\n\n  return {\n    name: \"claude\",\n    async generate(userPrompt, systemPrompt) {\n      const message = await client.messages.create({\n        model:      \"claude-opus-4-5\",\n        max_tokens: 1024,\n        system:     systemPrompt,\n        messages:   [{ role: \"user\", content: userPrompt }],\n      });\n\n      const block = message.content[0];\n      if (block.type !== \"text\") throw new Error(\"Unexpected response type from Claude\");\n      return block.text;\n    },\n  };\n}\n","import OpenAI from \"openai\";\nimport type { AIProvider } from \"./types.js\";\n\nexport function createOpenAIProvider(apiKey?: string): AIProvider {\n  const client = new OpenAI({ apiKey: apiKey ?? process.env.OPENAI_API_KEY });\n\n  return {\n    name: \"openai\",\n    async generate(userPrompt, systemPrompt) {\n      const response = await client.chat.completions.create({\n        model:    \"gpt-4o\",\n        messages: [\n          { role: \"system\", content: systemPrompt },\n          { role: \"user\",   content: userPrompt },\n        ],\n        max_tokens:      1024,\n        response_format: { type: \"json_object\" }, // enforces JSON output\n      });\n\n      const content = response.choices[0]?.message.content;\n      if (!content) throw new Error(\"Empty response from OpenAI\");\n      return content;\n    },\n  };\n}\n","import type { AIProvider } from \"./types.js\";\n\nexport function createOllamaProvider(model = \"llama3.2\", baseUrl = \"http://localhost:11434\"): AIProvider {\n  return {\n    name: `ollama/${model}`,\n    async generate(userPrompt, systemPrompt) {\n      const response = await fetch(`${baseUrl}/api/chat`, {\n        method:  \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          model,\n          stream: false,\n          messages: [\n            { role: \"system\", content: systemPrompt },\n            { role: \"user\",   content: userPrompt },\n          ],\n        }),\n      });\n\n      if (!response.ok) throw new Error(`Ollama error: ${response.statusText}`);\n\n      const data = await response.json() as { message?: { content?: string } };\n      const content = data?.message?.content;\n      if (!content) throw new Error(\"Empty response from Ollama\");\n      return content;\n    },\n  };\n}\n","export { createClaudeProvider } from \"./claude.js\";\nexport { createOpenAIProvider } from \"./openai.js\";\nexport { createOllamaProvider } from \"./ollama.js\";\nexport type { AIProvider } from \"./types.js\";\n\nimport type { AIProvider } from \"./types.js\";\nimport { createClaudeProvider } from \"./claude.js\";\nimport { createOpenAIProvider } from \"./openai.js\";\nimport { createOllamaProvider } from \"./ollama.js\";\n\nexport type ProviderName = \"claude\" | \"openai\" | \"ollama\";\n\nexport function resolveProvider(name: ProviderName): AIProvider {\n  switch (name) {\n    case \"claude\":  return createClaudeProvider();\n    case \"openai\":  return createOpenAIProvider();\n    case \"ollama\":  return createOllamaProvider();\n    default:        throw new Error(`Unknown provider: ${name}`);\n  }\n}\n","import { z } from \"zod\";\n\n// ---------------------------------------------------------------------------\n// Allowed commands per type — the whitelist that prevents hallucination\n// ---------------------------------------------------------------------------\nexport const CATALOG = {\n  npm:   [\"install\", \"run\", \"build\", \"test\", \"publish\", \"ci\"],\n  pnpm:  [\"install\", \"run\", \"build\", \"test\", \"publish\", \"add\", \"remove\"],\n  yarn:  [\"install\", \"run\", \"build\", \"test\", \"publish\", \"add\", \"remove\"],\n  bun:   [\"install\", \"run\", \"build\", \"test\", \"publish\", \"add\", \"remove\"],\n  git:   [\"init\", \"add\", \"commit\", \"push\", \"pull\", \"clone\", \"status\", \"log\"],\n  shell: [\"any\"], // escape hatch — always requires extra confirmation\n} as const;\n\nexport type CommandType = keyof typeof CATALOG;\n\n// ---------------------------------------------------------------------------\n// Zod schemas — Layer 2 defense against hallucinated output\n// ---------------------------------------------------------------------------\nexport const StepSchema = z.object({\n  id:          z.number(),\n  type:        z.enum([\"npm\", \"pnpm\", \"yarn\", \"bun\", \"git\", \"shell\"]),\n  command:     z.string(),\n  args:        z.array(z.string()).default([]),\n  description: z.string(),\n  cwd:         z.string().optional(), // optional working directory override\n});\n\nexport const PlanSchema = z.object({\n  goal:  z.string(),\n  steps: z.array(StepSchema).min(1).max(10),\n});\n\nexport type Step = z.infer<typeof StepSchema>;\nexport type Plan = z.infer<typeof PlanSchema>;\n\n// ---------------------------------------------------------------------------\n// Catalog validation — Layer 3: check command is in whitelist\n// ---------------------------------------------------------------------------\nexport function validateStep(step: Step): { valid: boolean; reason?: string } {\n  const allowed = CATALOG[step.type];\n\n  // shell type is always allowed but flagged for extra confirmation\n  if (step.type === \"shell\") {\n    return { valid: true };\n  }\n\n  if (!allowed.includes(step.command as never)) {\n    return {\n      valid: false,\n      reason: `\"${step.command}\" is not an allowed command for type \"${step.type}\". Allowed: ${allowed.join(\", \")}`,\n    };\n  }\n\n  return { valid: true };\n}\n\n// ---------------------------------------------------------------------------\n// Build the catalog string injected into AI system prompt\n// ---------------------------------------------------------------------------\nexport function buildCatalogPrompt(): string {\n  const lines = Object.entries(CATALOG).map(([type, commands]) => {\n    const list = commands[0] === \"any\" ? \"any shell command (use sparingly)\" : commands.join(\", \");\n    return `  - ${type}: [${list}]`;\n  });\n\n  return `Allowed command types and commands:\\n${lines.join(\"\\n\")}`;\n}\n","import { buildCatalogPrompt, PlanSchema, validateStep } from \"./catalog.js\";\nimport type { AIProvider } from \"./providers/types.js\";\nimport type { Plan } from \"./catalog.js\";\n\n// ---------------------------------------------------------------------------\n// System prompt — constrains AI to only produce catalog-valid JSON\n// ---------------------------------------------------------------------------\nfunction buildSystemPrompt(): string {\n  return `You are a CLI task planner. Given a user's goal, generate a JSON execution plan.\n\n${buildCatalogPrompt()}\n\nRules:\n- ONLY use command types and commands listed above\n- Prefer pnpm over npm unless the user specifies otherwise\n- Use \"shell\" type only when no other type fits\n- Keep steps minimal — don't add unnecessary steps\n- Each step must have a clear, short description\n\nRespond ONLY with valid JSON matching this exact shape, no markdown, no explanation:\n{\n  \"goal\": \"string describing the overall goal\",\n  \"steps\": [\n    {\n      \"id\": 1,\n      \"type\": \"pnpm\",\n      \"command\": \"run\",\n      \"args\": [\"dev\"],\n      \"description\": \"Start dev server\"\n    }\n  ]\n}`;\n}\n\n// ---------------------------------------------------------------------------\n// Main planner function\n// ---------------------------------------------------------------------------\nexport async function generatePlan(userPrompt: string, provider: AIProvider): Promise<Plan> {\n  const raw = await provider.generate(userPrompt, buildSystemPrompt());\n\n  // Strip markdown fences if any provider wraps output\n  const cleaned = raw.replace(/```json|```/g, \"\").trim();\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(cleaned);\n  } catch {\n    throw new Error(`AI returned invalid JSON:\\n${cleaned}`);\n  }\n\n  // Layer 2: Zod shape validation\n  const result = PlanSchema.safeParse(parsed);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `  - ${i.path.join(\".\")}: ${i.message}`).join(\"\\n\");\n    throw new Error(`Plan failed schema validation:\\n${issues}`);\n  }\n\n  // Layer 3: Catalog whitelist validation\n  for (const step of result.data.steps) {\n    const check = validateStep(step);\n    if (!check.valid) {\n      throw new Error(`Step ${step.id} failed catalog validation: ${check.reason}`);\n    }\n  }\n\n  return result.data;\n}\n","import { execa } from \"execa\";\nimport type { Plan, Step } from \"./catalog.js\";\n\n// ---------------------------------------------------------------------------\n// Build the actual shell command from a Step\n// ---------------------------------------------------------------------------\nfunction resolveCommand(step: Step): { bin: string; args: string[] } {\n  if (step.type === \"shell\") {\n    // shell: command is the binary, args are the args\n    return { bin: step.command, args: step.args };\n  }\n\n  // For npm/pnpm/yarn/bun/git: binary is the type, command + args follow\n  return { bin: step.type, args: [step.command, ...step.args] };\n}\n\n// ---------------------------------------------------------------------------\n// Run a single step, streaming stdout/stderr live\n// ---------------------------------------------------------------------------\nexport async function runStep(step: Step): Promise<{ success: boolean; error?: string }> {\n  const { bin, args } = resolveCommand(step);\n\n  try {\n    await execa(bin, args, {\n      cwd:    step.cwd ?? process.cwd(),\n      stdout: \"inherit\", // stream directly to terminal\n      stderr: \"inherit\",\n    });\n    return { success: true };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    return { success: false, error: message };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Run the full plan, stopping on first failure\n// ---------------------------------------------------------------------------\nexport async function runPlan(\n  plan: Plan,\n  onStep: (step: Step, index: number, total: number) => void\n): Promise<{ success: boolean; failedStep?: Step; error?: string }> {\n  const total = plan.steps.length;\n\n  for (let i = 0; i < total; i++) {\n    const step = plan.steps[i];\n    onStep(step, i, total);\n\n    const result = await runStep(step);\n\n    if (!result.success) {\n      return { success: false, failedStep: step, error: result.error };\n    }\n  }\n\n  return { success: true };\n}\n"],"mappings":"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","names":["Anthropic","OpenAI","spinner"]}

package/dist/index.cjs

@@ -0,0 +1,173 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  generatePlan: () => generatePlan,
+  runPlan: () => runPlan
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/catalog.ts
+var import_zod = require("zod");
+var CATALOG = {
+  npm: ["install", "run", "build", "test", "publish", "ci"],
+  pnpm: ["install", "run", "build", "test", "publish", "add", "remove"],
+  yarn: ["install", "run", "build", "test", "publish", "add", "remove"],
+  bun: ["install", "run", "build", "test", "publish", "add", "remove"],
+  git: ["init", "add", "commit", "push", "pull", "clone", "status", "log"],
+  shell: ["any"]
+  // escape hatch — always requires extra confirmation
+};
+var StepSchema = import_zod.z.object({
+  id: import_zod.z.number(),
+  type: import_zod.z.enum(["npm", "pnpm", "yarn", "bun", "git", "shell"]),
+  command: import_zod.z.string(),
+  args: import_zod.z.array(import_zod.z.string()).default([]),
+  description: import_zod.z.string(),
+  cwd: import_zod.z.string().optional()
+  // optional working directory override
+});
+var PlanSchema = import_zod.z.object({
+  goal: import_zod.z.string(),
+  steps: import_zod.z.array(StepSchema).min(1).max(10)
+});
+function validateStep(step) {
+  const allowed = CATALOG[step.type];
+  if (step.type === "shell") {
+    return { valid: true };
+  }
+  if (!allowed.includes(step.command)) {
+    return {
+      valid: false,
+      reason: `"${step.command}" is not an allowed command for type "${step.type}". Allowed: ${allowed.join(", ")}`
+    };
+  }
+  return { valid: true };
+}
+function buildCatalogPrompt() {
+  const lines = Object.entries(CATALOG).map(([type, commands]) => {
+    const list = commands[0] === "any" ? "any shell command (use sparingly)" : commands.join(", ");
+    return `  - ${type}: [${list}]`;
+  });
+  return `Allowed command types and commands:
+${lines.join("\n")}`;
+}
+
+// src/planner.ts
+function buildSystemPrompt() {
+  return `You are a CLI task planner. Given a user's goal, generate a JSON execution plan.
+
+${buildCatalogPrompt()}
+
+Rules:
+- ONLY use command types and commands listed above
+- Prefer pnpm over npm unless the user specifies otherwise
+- Use "shell" type only when no other type fits
+- Keep steps minimal \u2014 don't add unnecessary steps
+- Each step must have a clear, short description
+
+Respond ONLY with valid JSON matching this exact shape, no markdown, no explanation:
+{
+  "goal": "string describing the overall goal",
+  "steps": [
+    {
+      "id": 1,
+      "type": "pnpm",
+      "command": "run",
+      "args": ["dev"],
+      "description": "Start dev server"
+    }
+  ]
+}`;
+}
+async function generatePlan(userPrompt, provider) {
+  const raw = await provider.generate(userPrompt, buildSystemPrompt());
+  const cleaned = raw.replace(/```json|```/g, "").trim();
+  let parsed;
+  try {
+    parsed = JSON.parse(cleaned);
+  } catch {
+    throw new Error(`AI returned invalid JSON:
+${cleaned}`);
+  }
+  const result = PlanSchema.safeParse(parsed);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+    throw new Error(`Plan failed schema validation:
+${issues}`);
+  }
+  for (const step of result.data.steps) {
+    const check = validateStep(step);
+    if (!check.valid) {
+      throw new Error(`Step ${step.id} failed catalog validation: ${check.reason}`);
+    }
+  }
+  return result.data;
+}
+
+// src/runner.ts
+var import_execa = require("execa");
+function resolveCommand(step) {
+  if (step.type === "shell") {
+    return { bin: step.command, args: step.args };
+  }
+  return { bin: step.type, args: [step.command, ...step.args] };
+}
+async function runStep(step) {
+  const { bin, args } = resolveCommand(step);
+  try {
+    await (0, import_execa.execa)(bin, args, {
+      cwd: step.cwd ?? process.cwd(),
+      stdout: "inherit",
+      // stream directly to terminal
+      stderr: "inherit"
+    });
+    return { success: true };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { success: false, error: message };
+  }
+}
+async function runPlan(plan, onStep) {
+  const total = plan.steps.length;
+  for (let i = 0; i < total; i++) {
+    const step = plan.steps[i];
+    onStep(step, i, total);
+    const result = await runStep(step);
+    if (!result.success) {
+      return { success: false, failedStep: step, error: result.error };
+    }
+  }
+  return { success: true };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generatePlan,
+  runPlan
+});
+/**
+ * @file index.ts
+ * @description Core entry point for @ekaone/json-cli.
+ * @author Eka Prasetia
+ * @website https://prasetia.me
+ * @license MIT
+ */
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/catalog.ts","../src/planner.ts","../src/runner.ts"],"sourcesContent":["/**\r\n * @file index.ts\r\n * @description Core entry point for @ekaone/json-cli.\r\n * @author Eka Prasetia\r\n * @website https://prasetia.me\r\n * @license MIT\r\n */\r\n\r\nexport { generatePlan } from \"./planner.js\";\r\nexport { runPlan } from \"./runner.js\";\r\nexport type { Plan, Step } from \"./catalog.js\";\r\nexport type { AIProvider } from \"./providers/types.js\";\r\n","import { z } from \"zod\";\n\n// ---------------------------------------------------------------------------\n// Allowed commands per type — the whitelist that prevents hallucination\n// ---------------------------------------------------------------------------\nexport const CATALOG = {\n  npm:   [\"install\", \"run\", \"build\", \"test\", \"publish\", \"ci\"],\n  pnpm:  [\"install\", \"run\", \"build\", \"test\", \"publish\", \"add\", \"remove\"],\n  yarn:  [\"install\", \"run\", \"build\", \"test\", \"publish\", \"add\", \"remove\"],\n  bun:   [\"install\", \"run\", \"build\", \"test\", \"publish\", \"add\", \"remove\"],\n  git:   [\"init\", \"add\", \"commit\", \"push\", \"pull\", \"clone\", \"status\", \"log\"],\n  shell: [\"any\"], // escape hatch — always requires extra confirmation\n} as const;\n\nexport type CommandType = keyof typeof CATALOG;\n\n// ---------------------------------------------------------------------------\n// Zod schemas — Layer 2 defense against hallucinated output\n// ---------------------------------------------------------------------------\nexport const StepSchema = z.object({\n  id:          z.number(),\n  type:        z.enum([\"npm\", \"pnpm\", \"yarn\", \"bun\", \"git\", \"shell\"]),\n  command:     z.string(),\n  args:        z.array(z.string()).default([]),\n  description: z.string(),\n  cwd:         z.string().optional(), // optional working directory override\n});\n\nexport const PlanSchema = z.object({\n  goal:  z.string(),\n  steps: z.array(StepSchema).min(1).max(10),\n});\n\nexport type Step = z.infer<typeof StepSchema>;\nexport type Plan = z.infer<typeof PlanSchema>;\n\n// ---------------------------------------------------------------------------\n// Catalog validation — Layer 3: check command is in whitelist\n// ---------------------------------------------------------------------------\nexport function validateStep(step: Step): { valid: boolean; reason?: string } {\n  const allowed = CATALOG[step.type];\n\n  // shell type is always allowed but flagged for extra confirmation\n  if (step.type === \"shell\") {\n    return { valid: true };\n  }\n\n  if (!allowed.includes(step.command as never)) {\n    return {\n      valid: false,\n      reason: `\"${step.command}\" is not an allowed command for type \"${step.type}\". Allowed: ${allowed.join(\", \")}`,\n    };\n  }\n\n  return { valid: true };\n}\n\n// ---------------------------------------------------------------------------\n// Build the catalog string injected into AI system prompt\n// ---------------------------------------------------------------------------\nexport function buildCatalogPrompt(): string {\n  const lines = Object.entries(CATALOG).map(([type, commands]) => {\n    const list = commands[0] === \"any\" ? \"any shell command (use sparingly)\" : commands.join(\", \");\n    return `  - ${type}: [${list}]`;\n  });\n\n  return `Allowed command types and commands:\\n${lines.join(\"\\n\")}`;\n}\n","import { buildCatalogPrompt, PlanSchema, validateStep } from \"./catalog.js\";\nimport type { AIProvider } from \"./providers/types.js\";\nimport type { Plan } from \"./catalog.js\";\n\n// ---------------------------------------------------------------------------\n// System prompt — constrains AI to only produce catalog-valid JSON\n// ---------------------------------------------------------------------------\nfunction buildSystemPrompt(): string {\n  return `You are a CLI task planner. Given a user's goal, generate a JSON execution plan.\n\n${buildCatalogPrompt()}\n\nRules:\n- ONLY use command types and commands listed above\n- Prefer pnpm over npm unless the user specifies otherwise\n- Use \"shell\" type only when no other type fits\n- Keep steps minimal — don't add unnecessary steps\n- Each step must have a clear, short description\n\nRespond ONLY with valid JSON matching this exact shape, no markdown, no explanation:\n{\n  \"goal\": \"string describing the overall goal\",\n  \"steps\": [\n    {\n      \"id\": 1,\n      \"type\": \"pnpm\",\n      \"command\": \"run\",\n      \"args\": [\"dev\"],\n      \"description\": \"Start dev server\"\n    }\n  ]\n}`;\n}\n\n// ---------------------------------------------------------------------------\n// Main planner function\n// ---------------------------------------------------------------------------\nexport async function generatePlan(userPrompt: string, provider: AIProvider): Promise<Plan> {\n  const raw = await provider.generate(userPrompt, buildSystemPrompt());\n\n  // Strip markdown fences if any provider wraps output\n  const cleaned = raw.replace(/```json|```/g, \"\").trim();\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(cleaned);\n  } catch {\n    throw new Error(`AI returned invalid JSON:\\n${cleaned}`);\n  }\n\n  // Layer 2: Zod shape validation\n  const result = PlanSchema.safeParse(parsed);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `  - ${i.path.join(\".\")}: ${i.message}`).join(\"\\n\");\n    throw new Error(`Plan failed schema validation:\\n${issues}`);\n  }\n\n  // Layer 3: Catalog whitelist validation\n  for (const step of result.data.steps) {\n    const check = validateStep(step);\n    if (!check.valid) {\n      throw new Error(`Step ${step.id} failed catalog validation: ${check.reason}`);\n    }\n  }\n\n  return result.data;\n}\n","import { execa } from \"execa\";\nimport type { Plan, Step } from \"./catalog.js\";\n\n// ---------------------------------------------------------------------------\n// Build the actual shell command from a Step\n// ---------------------------------------------------------------------------\nfunction resolveCommand(step: Step): { bin: string; args: string[] } {\n  if (step.type === \"shell\") {\n    // shell: command is the binary, args are the args\n    return { bin: step.command, args: step.args };\n  }\n\n  // For npm/pnpm/yarn/bun/git: binary is the type, command + args follow\n  return { bin: step.type, args: [step.command, ...step.args] };\n}\n\n// ---------------------------------------------------------------------------\n// Run a single step, streaming stdout/stderr live\n// ---------------------------------------------------------------------------\nexport async function runStep(step: Step): Promise<{ success: boolean; error?: string }> {\n  const { bin, args } = resolveCommand(step);\n\n  try {\n    await execa(bin, args, {\n      cwd:    step.cwd ?? process.cwd(),\n      stdout: \"inherit\", // stream directly to terminal\n      stderr: \"inherit\",\n    });\n    return { success: true };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    return { success: false, error: message };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Run the full plan, stopping on first failure\n// ---------------------------------------------------------------------------\nexport async function runPlan(\n  plan: Plan,\n  onStep: (step: Step, index: number, total: number) => void\n): Promise<{ success: boolean; failedStep?: Step; error?: string }> {\n  const total = plan.steps.length;\n\n  for (let i = 0; i < total; i++) {\n    const step = plan.steps[i];\n    onStep(step, i, total);\n\n    const result = await runStep(step);\n\n    if (!result.success) {\n      return { success: false, failedStep: step, error: result.error };\n    }\n  }\n\n  return { success: true };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+
+interface AIProvider {
+    name: string;
+    generate(userPrompt: string, systemPrompt: string): Promise<string>;
+}
+
+declare const StepSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    type: z.ZodEnum<{
+        npm: "npm";
+        pnpm: "pnpm";
+        yarn: "yarn";
+        bun: "bun";
+        git: "git";
+        shell: "shell";
+    }>;
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    description: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const PlanSchema: z.ZodObject<{
+    goal: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        type: z.ZodEnum<{
+            npm: "npm";
+            pnpm: "pnpm";
+            yarn: "yarn";
+            bun: "bun";
+            git: "git";
+            shell: "shell";
+        }>;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        description: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type Step = z.infer<typeof StepSchema>;
+type Plan = z.infer<typeof PlanSchema>;
+
+declare function generatePlan(userPrompt: string, provider: AIProvider): Promise<Plan>;
+
+declare function runPlan(plan: Plan, onStep: (step: Step, index: number, total: number) => void): Promise<{
+    success: boolean;
+    failedStep?: Step;
+    error?: string;
+}>;
+
+export { type AIProvider, type Plan, type Step, generatePlan, runPlan };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+
+interface AIProvider {
+    name: string;
+    generate(userPrompt: string, systemPrompt: string): Promise<string>;
+}
+
+declare const StepSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    type: z.ZodEnum<{
+        npm: "npm";
+        pnpm: "pnpm";
+        yarn: "yarn";
+        bun: "bun";
+        git: "git";
+        shell: "shell";
+    }>;
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    description: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const PlanSchema: z.ZodObject<{
+    goal: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        type: z.ZodEnum<{
+            npm: "npm";
+            pnpm: "pnpm";
+            yarn: "yarn";
+            bun: "bun";
+            git: "git";
+            shell: "shell";
+        }>;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        description: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type Step = z.infer<typeof StepSchema>;
+type Plan = z.infer<typeof PlanSchema>;
+
+declare function generatePlan(userPrompt: string, provider: AIProvider): Promise<Plan>;
+
+declare function runPlan(plan: Plan, onStep: (step: Step, index: number, total: number) => void): Promise<{
+    success: boolean;
+    failedStep?: Step;
+    error?: string;
+}>;
+
+export { type AIProvider, type Plan, type Step, generatePlan, runPlan };

package/dist/index.js

@@ -0,0 +1,145 @@
+// src/catalog.ts
+import { z } from "zod";
+var CATALOG = {
+  npm: ["install", "run", "build", "test", "publish", "ci"],
+  pnpm: ["install", "run", "build", "test", "publish", "add", "remove"],
+  yarn: ["install", "run", "build", "test", "publish", "add", "remove"],
+  bun: ["install", "run", "build", "test", "publish", "add", "remove"],
+  git: ["init", "add", "commit", "push", "pull", "clone", "status", "log"],
+  shell: ["any"]
+  // escape hatch — always requires extra confirmation
+};
+var StepSchema = z.object({
+  id: z.number(),
+  type: z.enum(["npm", "pnpm", "yarn", "bun", "git", "shell"]),
+  command: z.string(),
+  args: z.array(z.string()).default([]),
+  description: z.string(),
+  cwd: z.string().optional()
+  // optional working directory override
+});
+var PlanSchema = z.object({
+  goal: z.string(),
+  steps: z.array(StepSchema).min(1).max(10)
+});
+function validateStep(step) {
+  const allowed = CATALOG[step.type];
+  if (step.type === "shell") {
+    return { valid: true };
+  }
+  if (!allowed.includes(step.command)) {
+    return {
+      valid: false,
+      reason: `"${step.command}" is not an allowed command for type "${step.type}". Allowed: ${allowed.join(", ")}`
+    };
+  }
+  return { valid: true };
+}
+function buildCatalogPrompt() {
+  const lines = Object.entries(CATALOG).map(([type, commands]) => {
+    const list = commands[0] === "any" ? "any shell command (use sparingly)" : commands.join(", ");
+    return `  - ${type}: [${list}]`;
+  });
+  return `Allowed command types and commands:
+${lines.join("\n")}`;
+}
+
+// src/planner.ts
+function buildSystemPrompt() {
+  return `You are a CLI task planner. Given a user's goal, generate a JSON execution plan.
+
+${buildCatalogPrompt()}
+
+Rules:
+- ONLY use command types and commands listed above
+- Prefer pnpm over npm unless the user specifies otherwise
+- Use "shell" type only when no other type fits
+- Keep steps minimal \u2014 don't add unnecessary steps
+- Each step must have a clear, short description
+
+Respond ONLY with valid JSON matching this exact shape, no markdown, no explanation:
+{
+  "goal": "string describing the overall goal",
+  "steps": [
+    {
+      "id": 1,
+      "type": "pnpm",
+      "command": "run",
+      "args": ["dev"],
+      "description": "Start dev server"
+    }
+  ]
+}`;
+}
+async function generatePlan(userPrompt, provider) {
+  const raw = await provider.generate(userPrompt, buildSystemPrompt());
+  const cleaned = raw.replace(/```json|```/g, "").trim();
+  let parsed;
+  try {
+    parsed = JSON.parse(cleaned);
+  } catch {
+    throw new Error(`AI returned invalid JSON:
+${cleaned}`);
+  }
+  const result = PlanSchema.safeParse(parsed);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+    throw new Error(`Plan failed schema validation:
+${issues}`);
+  }
+  for (const step of result.data.steps) {
+    const check = validateStep(step);
+    if (!check.valid) {
+      throw new Error(`Step ${step.id} failed catalog validation: ${check.reason}`);
+    }
+  }
+  return result.data;
+}
+
+// src/runner.ts
+import { execa } from "execa";
+function resolveCommand(step) {
+  if (step.type === "shell") {
+    return { bin: step.command, args: step.args };
+  }
+  return { bin: step.type, args: [step.command, ...step.args] };
+}
+async function runStep(step) {
+  const { bin, args } = resolveCommand(step);
+  try {
+    await execa(bin, args, {
+      cwd: step.cwd ?? process.cwd(),
+      stdout: "inherit",
+      // stream directly to terminal
+      stderr: "inherit"
+    });
+    return { success: true };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { success: false, error: message };
+  }
+}
+async function runPlan(plan, onStep) {
+  const total = plan.steps.length;
+  for (let i = 0; i < total; i++) {
+    const step = plan.steps[i];
+    onStep(step, i, total);
+    const result = await runStep(step);
+    if (!result.success) {
+      return { success: false, failedStep: step, error: result.error };
+    }
+  }
+  return { success: true };
+}
+export {
+  generatePlan,
+  runPlan
+};
+/**
+ * @file index.ts
+ * @description Core entry point for @ekaone/json-cli.
+ * @author Eka Prasetia
+ * @website https://prasetia.me
+ * @license MIT
+ */
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog.ts","../src/planner.ts","../src/runner.ts"],"sourcesContent":["import { z } from \"zod\";\n\n// ---------------------------------------------------------------------------\n// Allowed commands per type — the whitelist that prevents hallucination\n// ---------------------------------------------------------------------------\nexport const CATALOG = {\n  npm:   [\"install\", \"run\", \"build\", \"test\", \"publish\", \"ci\"],\n  pnpm:  [\"install\", \"run\", \"build\", \"test\", \"publish\", \"add\", \"remove\"],\n  yarn:  [\"install\", \"run\", \"build\", \"test\", \"publish\", \"add\", \"remove\"],\n  bun:   [\"install\", \"run\", \"build\", \"test\", \"publish\", \"add\", \"remove\"],\n  git:   [\"init\", \"add\", \"commit\", \"push\", \"pull\", \"clone\", \"status\", \"log\"],\n  shell: [\"any\"], // escape hatch — always requires extra confirmation\n} as const;\n\nexport type CommandType = keyof typeof CATALOG;\n\n// ---------------------------------------------------------------------------\n// Zod schemas — Layer 2 defense against hallucinated output\n// ---------------------------------------------------------------------------\nexport const StepSchema = z.object({\n  id:          z.number(),\n  type:        z.enum([\"npm\", \"pnpm\", \"yarn\", \"bun\", \"git\", \"shell\"]),\n  command:     z.string(),\n  args:        z.array(z.string()).default([]),\n  description: z.string(),\n  cwd:         z.string().optional(), // optional working directory override\n});\n\nexport const PlanSchema = z.object({\n  goal:  z.string(),\n  steps: z.array(StepSchema).min(1).max(10),\n});\n\nexport type Step = z.infer<typeof StepSchema>;\nexport type Plan = z.infer<typeof PlanSchema>;\n\n// ---------------------------------------------------------------------------\n// Catalog validation — Layer 3: check command is in whitelist\n// ---------------------------------------------------------------------------\nexport function validateStep(step: Step): { valid: boolean; reason?: string } {\n  const allowed = CATALOG[step.type];\n\n  // shell type is always allowed but flagged for extra confirmation\n  if (step.type === \"shell\") {\n    return { valid: true };\n  }\n\n  if (!allowed.includes(step.command as never)) {\n    return {\n      valid: false,\n      reason: `\"${step.command}\" is not an allowed command for type \"${step.type}\". Allowed: ${allowed.join(\", \")}`,\n    };\n  }\n\n  return { valid: true };\n}\n\n// ---------------------------------------------------------------------------\n// Build the catalog string injected into AI system prompt\n// ---------------------------------------------------------------------------\nexport function buildCatalogPrompt(): string {\n  const lines = Object.entries(CATALOG).map(([type, commands]) => {\n    const list = commands[0] === \"any\" ? \"any shell command (use sparingly)\" : commands.join(\", \");\n    return `  - ${type}: [${list}]`;\n  });\n\n  return `Allowed command types and commands:\\n${lines.join(\"\\n\")}`;\n}\n","import { buildCatalogPrompt, PlanSchema, validateStep } from \"./catalog.js\";\nimport type { AIProvider } from \"./providers/types.js\";\nimport type { Plan } from \"./catalog.js\";\n\n// ---------------------------------------------------------------------------\n// System prompt — constrains AI to only produce catalog-valid JSON\n// ---------------------------------------------------------------------------\nfunction buildSystemPrompt(): string {\n  return `You are a CLI task planner. Given a user's goal, generate a JSON execution plan.\n\n${buildCatalogPrompt()}\n\nRules:\n- ONLY use command types and commands listed above\n- Prefer pnpm over npm unless the user specifies otherwise\n- Use \"shell\" type only when no other type fits\n- Keep steps minimal — don't add unnecessary steps\n- Each step must have a clear, short description\n\nRespond ONLY with valid JSON matching this exact shape, no markdown, no explanation:\n{\n  \"goal\": \"string describing the overall goal\",\n  \"steps\": [\n    {\n      \"id\": 1,\n      \"type\": \"pnpm\",\n      \"command\": \"run\",\n      \"args\": [\"dev\"],\n      \"description\": \"Start dev server\"\n    }\n  ]\n}`;\n}\n\n// ---------------------------------------------------------------------------\n// Main planner function\n// ---------------------------------------------------------------------------\nexport async function generatePlan(userPrompt: string, provider: AIProvider): Promise<Plan> {\n  const raw = await provider.generate(userPrompt, buildSystemPrompt());\n\n  // Strip markdown fences if any provider wraps output\n  const cleaned = raw.replace(/```json|```/g, \"\").trim();\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(cleaned);\n  } catch {\n    throw new Error(`AI returned invalid JSON:\\n${cleaned}`);\n  }\n\n  // Layer 2: Zod shape validation\n  const result = PlanSchema.safeParse(parsed);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `  - ${i.path.join(\".\")}: ${i.message}`).join(\"\\n\");\n    throw new Error(`Plan failed schema validation:\\n${issues}`);\n  }\n\n  // Layer 3: Catalog whitelist validation\n  for (const step of result.data.steps) {\n    const check = validateStep(step);\n    if (!check.valid) {\n      throw new Error(`Step ${step.id} failed catalog validation: ${check.reason}`);\n    }\n  }\n\n  return result.data;\n}\n","import { execa } from \"execa\";\nimport type { Plan, Step } from \"./catalog.js\";\n\n// ---------------------------------------------------------------------------\n// Build the actual shell command from a Step\n// ---------------------------------------------------------------------------\nfunction resolveCommand(step: Step): { bin: string; args: string[] } {\n  if (step.type === \"shell\") {\n    // shell: command is the binary, args are the args\n    return { bin: step.command, args: step.args };\n  }\n\n  // For npm/pnpm/yarn/bun/git: binary is the type, command + args follow\n  return { bin: step.type, args: [step.command, ...step.args] };\n}\n\n// ---------------------------------------------------------------------------\n// Run a single step, streaming stdout/stderr live\n// ---------------------------------------------------------------------------\nexport async function runStep(step: Step): Promise<{ success: boolean; error?: string }> {\n  const { bin, args } = resolveCommand(step);\n\n  try {\n    await execa(bin, args, {\n      cwd:    step.cwd ?? process.cwd(),\n      stdout: \"inherit\", // stream directly to terminal\n      stderr: \"inherit\",\n    });\n    return { success: true };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    return { success: false, error: message };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Run the full plan, stopping on first failure\n// ---------------------------------------------------------------------------\nexport async function runPlan(\n  plan: Plan,\n  onStep: (step: Step, index: number, total: number) => void\n): Promise<{ success: boolean; failedStep?: Step; error?: string }> {\n  const total = plan.steps.length;\n\n  for (let i = 0; i < total; i++) {\n    const step = plan.steps[i];\n    onStep(step, i, total);\n\n    const result = await runStep(step);\n\n    if (!result.success) {\n      return { success: false, failedStep: step, error: result.error };\n    }\n  }\n\n  return { success: true };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@ekaone/json-cli",
+  "version": "0.0.1",
+  "description": "AI-powered CLI task runner with JSON command plans",
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "task-runner",
+    "llm"
+  ],
+  "author": {
+    "name": "Eka Prasetia",
+    "email": "ekaone3033@gmail.com",
+    "url": "https://prasetia.me"
+  },
+  "homepage": "https://github.com/ekaone/json-cli",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ekaone/json-cli"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "json-cli": "./dist/cli.cjs"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.80.0",
+    "@clack/prompts": "^1.1.0",
+    "execa": "^9.6.1",
+    "openai": "^6.32.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsup",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}