mokout-cli 0.1.6 → 0.1.7

package/README.md

@@ -80,6 +80,71 @@ mokout code-fast init --dry-run  # preview
 Idempotent: re-running refreshes the doctrine's managed block in `CLAUDE.md`
 and leaves everything else (including your own notes) untouched.
 
+### Advanced Agent Workflows (via google/agents-cli)
+
+`mokout-cli` installs and seamlessly wraps the [`google/agents-cli`](https://github.com/google/agents-cli) toolkit, providing deep capabilities for evaluating, testing, and deploying coding agents. All `agents-cli` commands are proxied through `mokout agents`.
+
+**CLI Commands**
+| Command | What it does |
+|---------|--------------|
+| `mokout agents setup` | Install CLI + skills to coding agents (runs automatically on install) |
+| `mokout agents scaffold <name>` | Create a new agent project |
+| `mokout agents eval generate` | Run agent on eval dataset, produce traces |
+| `mokout agents eval grade` | Run agent evaluations on the traces |
+| `mokout agents deploy` | Deploy to Google Cloud |
+| `mokout agents publish gemini-enterprise` | Register with Gemini Enterprise |
+
+**See all commands**
+| Command | Description |
+|---------|-------------|
+| `mokout agents login` | Authenticate with Google Cloud or AI Studio |
+| `mokout agents login --status` | Show authentication status |
+
+**Scaffold**
+| Command | Description |
+|---------|-------------|
+| `mokout agents scaffold <name>` | Create a new agent project |
+| `mokout agents scaffold enhance` | Add deployment, CI/CD, or RAG to an existing project |
+| `mokout agents scaffold upgrade` | Upgrade project to a newer agents-cli version |
+
+**Develop**
+| Command | Description |
+|---------|-------------|
+| `mokout agents run "prompt"` | Run agent with a single prompt |
+| `mokout agents install` | Install project dependencies |
+| `mokout agents lint` | Run code quality checks (Ruff) |
+
+**Evaluate**
+| Command | Description |
+|---------|-------------|
+| `mokout agents eval generate` | Run agent inference over eval cases |
+| `mokout agents eval grade` | Grade generated traces against metrics |
+| `mokout agents eval dataset synthesize` | Synthesize multi-turn eval scenarios for your local agent |
+| `mokout agents eval compare` | Compare two eval result files |
+| `mokout agents eval analyze` | Cluster failure modes from grade results |
+| `mokout agents eval metric list` | List available metrics |
+| `mokout agents eval optimize` | Auto-tune agent prompts using eval data |
+
+**Deploy & Publish**
+| Command | Description |
+|---------|-------------|
+| `mokout agents deploy` | Deploy to Google Cloud |
+| `mokout agents publish gemini-enterprise` | Register with Gemini Enterprise |
+| `mokout agents infra single-project` | Provision single-project infrastructure |
+| `mokout agents infra cicd` | Set up CI/CD pipeline + staging/prod infrastructure |
+
+**Data**
+| Command | Description |
+|---------|-------------|
+| `mokout agents infra datastore` | Provision datastore infrastructure for RAG |
+| `mokout agents data-ingestion` | Run data ingestion pipeline |
+
+**Other**
+| Command | Description |
+|---------|-------------|
+| `mokout agents info` | Show project config and CLI version |
+| `mokout agents update` | Force reinstall skills to all IDEs |
+
 ## Install
 
 No install needed — `npx mokout project init` runs the latest version. To install globally:

package/dist/cli.js

@@ -3,9 +3,75 @@
 // src/cli.ts
 import { Builtins, Cli } from "clipanion";
 
-// src/commands/code-fast-init.ts
+// src/commands/agent-init.ts
+import { spawnSync } from "child_process";
 import * as p from "@clack/prompts";
-import { Command, Option } from "clipanion";
+import { Command } from "clipanion";
+var AgentInitCommand = class extends Command {
+  static paths = [["agent", "init"]];
+  static usage = Command.Usage({
+    description: "Initialize and install google-agents-cli skills locally in the project folder.",
+    examples: [["Install skills to workspace", "mokout agent init"]]
+  });
+  async execute() {
+    p.intro("mokout agent init");
+    const s = p.spinner();
+    s.start("Installing google-agents-cli and workspace skills...");
+    const cwd = process.cwd();
+    const installResult = spawnSync("uv", ["tool", "install", "google-agents-cli"], {
+      cwd,
+      stdio: "inherit"
+    });
+    if (installResult.error || installResult.status !== null && installResult.status !== 0) {
+      p.cancel("Failed to install google-agents-cli via uv tool.");
+      return installResult.status ?? 1;
+    }
+    const setupResult = spawnSync(
+      "uv",
+      ["tool", "run", "google-agents-cli", "setup", "--workspace"],
+      {
+        cwd,
+        stdio: "inherit"
+      }
+    );
+    if (setupResult.error || setupResult.status !== null && setupResult.status !== 0) {
+      p.cancel("Failed to setup google-agents-cli skills.");
+      return setupResult.status ?? 1;
+    }
+    s.stop("Skills installed locally in the workspace!");
+    p.outro("Done.");
+    return 0;
+  }
+};
+
+// src/commands/agents.ts
+import { spawnSync as spawnSync2 } from "child_process";
+import { Command as Command2, Option } from "clipanion";
+var AgentsCommand = class extends Command2 {
+  static paths = [["agents"]];
+  static usage = Command2.Usage({
+    category: "agents",
+    description: "Proxy command for google/agents-cli (scaffold, eval, deploy, etc.)",
+    examples: [
+      ["Scaffold an agent project", "mokout agents scaffold my-agent"],
+      ["Evaluate the agent", "mokout agents eval generate"],
+      ["Deploy the agent", "mokout agents deploy"]
+    ]
+  });
+  args = Option.Proxy();
+  async execute() {
+    const cwd = process.cwd();
+    const result = spawnSync2("uv", ["tool", "run", "google-agents-cli", ...this.args], {
+      cwd,
+      stdio: "inherit"
+    });
+    return result.status ?? (result.error ? 1 : 0);
+  }
+};
+
+// src/commands/code-fast-init.ts
+import * as p2 from "@clack/prompts";
+import { Command as Command3, Option as Option2 } from "clipanion";
 import nodePlop from "node-plop";
 
 // src/generators/engine.ts
@@ -334,9 +400,9 @@ function filesFor(stack) {
 }
 
 // src/commands/code-fast-init.ts
-var CodeFastInitCommand = class extends Command {
+var CodeFastInitCommand = class extends Command3 {
   static paths = [["code-fast", "init"]];
-  static usage = Command.Usage({
+  static usage = Command3.Usage({
     category: "code-fast",
     description: "Add agent files (CLAUDE.md, AGENTS.md, tasks/) to the current project.",
     examples: [
@@ -344,21 +410,21 @@ var CodeFastInitCommand = class extends Command {
       ["Preview without writing", "mokout code-fast init --dry-run"]
     ]
   });
-  dryRun = Option.Boolean("--dry-run", false, {
+  dryRun = Option2.Boolean("--dry-run", false, {
     description: "Print what would be created without writing anything"
   });
   async execute() {
     const cwd = process.cwd();
-    p.intro("mokout code-fast init");
+    p2.intro("mokout code-fast init");
     const files = agentFiles();
     const paths = [...new Set(files.map((f) => f.path))];
     const links = SYMLINKS.map((l) => `${l.path} -> ${l.target}`);
     if (this.dryRun) {
-      p.note([...paths, ...links].join("\n"), "Would create");
-      p.outro("Dry run \u2014 nothing written.");
+      p2.note([...paths, ...links].join("\n"), "Would create");
+      p2.outro("Dry run \u2014 nothing written.");
       return 0;
     }
-    const s = p.spinner();
+    const s = p2.spinner();
     s.start("Adding agent files");
     const plop = await nodePlop(void 0, { destBasePath: cwd, force: false });
     registerGenerator(plop, {
@@ -369,22 +435,22 @@ var CodeFastInitCommand = class extends Command {
     });
     await plop.getGenerator("code-fast-init").runActions({});
     s.stop("Agent files added");
-    p.note([...paths.map((f) => `\u2022 ${f}`), ...links.map((l) => `\u2022 ${l}`)].join("\n"), "Added");
-    p.outro("Done. CLAUDE.md holds the doctrine; AGENTS.md mirrors it for other agents.");
+    p2.note([...paths.map((f) => `\u2022 ${f}`), ...links.map((l) => `\u2022 ${l}`)].join("\n"), "Added");
+    p2.outro("Done. CLAUDE.md holds the doctrine; AGENTS.md mirrors it for other agents.");
     return 0;
   }
 };
 
 // src/commands/init.ts
-import * as p2 from "@clack/prompts";
-import { Command as Command2, Option as Option2 } from "clipanion";
+import * as p3 from "@clack/prompts";
+import { Command as Command4, Option as Option3 } from "clipanion";
 import nodePlop2 from "node-plop";
 var UV_BOILERPLATE = ["hello.py", "main.py", "README.md"];
 var PY_DEV_DEPS = ["pytest", "ruff", "pyrefly"];
 var JS_DEV_DEPS = ["@biomejs/biome"];
-var InitCommand = class extends Command2 {
+var InitCommand = class extends Command4 {
   static paths = [["project", "init"]];
-  static usage = Command2.Usage({
+  static usage = Command4.Usage({
     description: "Scaffold an agentic AI project: uv/npm, CLAUDE.md, and modern tooling.",
     examples: [
       ["Interactive (asks for stack)", "mokout project init"],
@@ -393,19 +459,19 @@ var InitCommand = class extends Command2 {
       ["Preview without writing", "mokout project init --dry-run"]
     ]
   });
-  js = Option2.Boolean("--js", false, { description: "Scaffold a Node/JS project" });
-  python = Option2.Boolean("--python", false, {
+  js = Option3.Boolean("--js", false, { description: "Scaffold a Node/JS project" });
+  python = Option3.Boolean("--python", false, {
     description: "Scaffold a Python project (default)"
   });
-  dryRun = Option2.Boolean("--dry-run", false, {
+  dryRun = Option3.Boolean("--dry-run", false, {
     description: "Print what would be created without writing anything"
   });
   async execute() {
     const cwd = process.cwd();
-    p2.intro("mokout project init");
+    p3.intro("mokout project init");
     const stack = await this.resolveStack();
     if (stack === null) {
-      p2.cancel("Cancelled.");
+      p3.cancel("Cancelled.");
       return 1;
     }
     const files = filesFor(stack);
@@ -413,19 +479,19 @@ var InitCommand = class extends Command2 {
     const links = SYMLINKS.map((l) => `${l.path} -> ${l.target}`);
     const steps = stack === "javascript" ? ["npm init -y", `npm install --save-dev ${JS_DEV_DEPS.join(" ")}`] : ["uv init", `uv add --dev ${PY_DEV_DEPS.join(" ")}`];
     if (this.dryRun) {
-      p2.note(["git init", ...steps, ...paths, ...links].join("\n"), "Would create");
-      p2.outro("Dry run \u2014 nothing written.");
+      p3.note(["git init", ...steps, ...paths, ...links].join("\n"), "Would create");
+      p3.outro("Dry run \u2014 nothing written.");
       return 0;
     }
     if (!exists(cwd, ".git")) run("git", ["init", "-q"], cwd);
     if (stack === "javascript") {
       if (!exists(cwd, "package.json")) {
         if (!hasCommand("npm")) {
-          p2.cancel("npm not found on PATH.");
+          p3.cancel("npm not found on PATH.");
           return 1;
         }
         run("npm", ["init", "-y"], cwd);
-        const dep = p2.spinner();
+        const dep = p3.spinner();
         dep.start(`Adding dev dependencies (${JS_DEV_DEPS.join(", ")})`);
         try {
           run("npm", ["install", "--save-dev", ...JS_DEV_DEPS], cwd);
@@ -438,7 +504,7 @@ var InitCommand = class extends Command2 {
       }
     } else if (!exists(cwd, "pyproject.toml")) {
       if (!hasCommand("uv")) {
-        p2.cancel("uv not found on PATH \u2014 install from https://docs.astral.sh/uv/");
+        p3.cancel("uv not found on PATH \u2014 install from https://docs.astral.sh/uv/");
         return 1;
       }
       const preexisting = UV_BOILERPLATE.filter((f) => exists(cwd, f));
@@ -446,7 +512,7 @@ var InitCommand = class extends Command2 {
       for (const f of UV_BOILERPLATE) {
         if (!preexisting.includes(f)) remove(cwd, f);
       }
-      const dep = p2.spinner();
+      const dep = p3.spinner();
       dep.start(`Adding dev dependencies (${PY_DEV_DEPS.join(", ")})`);
       try {
         run("uv", ["add", "--dev", ...PY_DEV_DEPS], cwd);
@@ -460,7 +526,7 @@ var InitCommand = class extends Command2 {
 ${RUFF_PYPROJECT}`);
       }
     }
-    const s = p2.spinner();
+    const s = p3.spinner();
     s.start("Writing project files");
     const plop = await nodePlop2(void 0, { destBasePath: cwd, force: false });
     registerGenerator(plop, {
@@ -471,11 +537,11 @@ ${RUFF_PYPROJECT}`);
     });
     await plop.getGenerator("init").runActions({});
     s.stop("Files written");
-    p2.note(
+    p3.note(
       [...paths.map((f) => `\u2022 ${f}`), ...links.map((l) => `\u2022 ${l}`)].join("\n"),
       `Scaffolded (${stack})`
     );
-    p2.outro("Done. CLAUDE.md lists the project commands; AGENTS.md mirrors it.");
+    p3.outro("Done. CLAUDE.md lists the project commands; AGENTS.md mirrors it.");
     return 0;
   }
   /** Resolve the stack from flags, else prompt. Returns null if the user cancels. */
@@ -483,7 +549,7 @@ ${RUFF_PYPROJECT}`);
     if (this.js) return "javascript";
     if (this.python) return "python";
     if (!process.stdin.isTTY) return "python";
-    const choice = await p2.select({
+    const choice = await p3.select({
       message: "Project stack?",
       initialValue: "python",
       options: [
@@ -491,7 +557,7 @@ ${RUFF_PYPROJECT}`);
         { value: "javascript", label: "JavaScript", hint: "npm + biome" }
       ]
     });
-    return p2.isCancel(choice) ? null : choice;
+    return p3.isCancel(choice) ? null : choice;
   }
 };
 
@@ -503,6 +569,8 @@ var cli = new Cli({
 });
 cli.register(InitCommand);
 cli.register(CodeFastInitCommand);
+cli.register(AgentInitCommand);
+cli.register(AgentsCommand);
 cli.register(Builtins.HelpCommand);
 cli.register(Builtins.VersionCommand);
 cli.runExit(process.argv.slice(2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mokout-cli",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Quick scaffolding for agentic AI projects — uv/npm, Claude-ready CLAUDE.md, and modern tooling in one command.",
   "type": "module",
   "license": "MIT",
@@ -23,7 +23,8 @@
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",
     "format": "biome check --write .",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "postinstall": "uv tool install google-agents-cli"
   },
   "dependencies": {
     "@clack/prompts": "^0.7.0",