@guildai/cli 0.5.3 → 0.5.4

package/dist/lib/owner-helpers.js

@@ -17,49 +17,55 @@
 import inquirer from 'inquirer';
 import { loadGlobalConfig } from './guild-config.js';
 import { debug } from './errors.js';
+/**
+ * Look up an owner by ID or name against the current user and their organizations.
+ * Returns the resolved owner, or undefined if no match is found.
+ */
+export async function lookupOwner(client, val) {
+    const me = await client.get('/me');
+    if (me.id === val || me.name === val) {
+        return { id: me.id, name: me.name, type: 'user' };
+    }
+    const orgs = await client.fetchAll('/me/organizations');
+    const org = orgs.find((o) => o.id === val || o.name === val);
+    if (org) {
+        return { id: org.id, name: org.name, type: 'organization' };
+    }
+    return undefined;
+}
 export async function resolveOwnerId(options) {
     const { ownerFlag, client, interactive } = options;
     // Priority 1: --owner flag
     if (ownerFlag) {
         debug('Using owner from --owner flag: %s', ownerFlag);
-        // Try to resolve name from API (user or org)
-        const me = await client.get('/me');
-        if (me.id === ownerFlag) {
-            return { id: me.id, name: me.name, type: 'user' };
-        }
-        const orgs = await client.fetchAll('/me/organizations');
-        const org = orgs.find((o) => o.id === ownerFlag);
-        if (org) {
-            return { id: org.id, name: org.name, type: 'organization' };
-        }
+        const match = await lookupOwner(client, ownerFlag);
+        if (match)
+            return match;
         // Not found in user or orgs — pass through and let backend validate
         return { id: ownerFlag, name: ownerFlag, type: 'organization' };
     }
     // Priority 2: GUILD_OWNER_ID environment variable
     if (process.env.GUILD_OWNER_ID) {
         debug('Using owner from GUILD_OWNER_ID env var: %s', process.env.GUILD_OWNER_ID);
-        const envOwnerId = process.env.GUILD_OWNER_ID;
-        const me = await client.get('/me');
-        if (me.id === envOwnerId) {
-            return { id: me.id, name: me.name, type: 'user' };
-        }
-        const orgs = await client.fetchAll('/me/organizations');
-        const org = orgs.find((o) => o.id === envOwnerId);
-        if (org) {
-            return { id: org.id, name: org.name, type: 'organization' };
-        }
+        const match = await lookupOwner(client, process.env.GUILD_OWNER_ID);
+        if (match)
+            return match;
         // Not found in user or orgs — pass through and let backend validate
-        return { id: envOwnerId, name: envOwnerId, type: 'organization' };
+        return {
+            id: process.env.GUILD_OWNER_ID,
+            name: process.env.GUILD_OWNER_ID,
+            type: 'organization',
+        };
     }
     // Priority 3: default_owner from config
     const globalConfig = await loadGlobalConfig();
     if (globalConfig?.default_owner) {
         debug('Using owner from global config: %s', globalConfig.default_owner);
+        const match = await lookupOwner(client, globalConfig.default_owner);
+        if (match)
+            return match;
         const name = globalConfig.default_owner_name || globalConfig.default_owner;
-        // Determine type by checking against current user
-        const me = await client.get('/me');
-        const type = me.id === globalConfig.default_owner ? 'user' : 'organization';
-        return { id: globalConfig.default_owner, name, type };
+        return { id: globalConfig.default_owner, name, type: 'organization' };
     }
     // Priority 4: Fetch user + orgs
     const me = await client.get('/me');

package/docs/DESIGN.md

@@ -39,52 +39,51 @@ guild env go                    # Create environment and connect interactively
 
 ### Agent Management
 
-Manage agents via guildcore API with git-backed versioning:
-
-**Basic Operations:**
+Manage agents via the GuildCore API with git-backed versioning:
 
 ```bash
-guild agent list                                  # List all agents
-guild agent list --search "analytics"             # Search agents
-guild agent create my-agent                       # Create new agent
-guild agent create my-agent --description "..."   # Create with description
-guild agent get <agent-id>                        # Get agent details
-guild agent update <agent-id> --description "..." # Update description
+guild agent init --name my-agent --template LLM   # Initialize a new agent
+guild agent clone owner/agent-name                 # Clone an existing agent
+guild agent list                                   # List all agents
+guild agent search "analytics"                     # Search published agents
+guild agent get [identifier]                       # Get agent details
+guild agent versions [identifier]                  # List all versions
+guild agent code [identifier]                      # Fetch latest published code
 ```
 
 **Version Control** (git-backed):
 
 ```bash
-guild agent save <agent-id> --message "Initial version" --directory ./code
-guild agent save <agent-id> --message "v1.0" --publish   # Mark as published
-guild agent versions <agent-id>                           # List all versions
-guild agent code <agent-id>                               # Fetch latest published code
-guild agent code <agent-id> --draft                       # Include draft versions
-guild agent code <agent-id> --output ./my-agent           # Download to directory
+guild agent save --message "Initial version"              # Save as draft
+guild agent save --message "v1.0" --wait --publish        # Save + validate + publish
+guild agent pull                                           # Pull remote changes
 ```
 
 **How it works:**
 
-- Each agent stores code in a git repository (managed by guildcore)
-- `save` creates a new version by committing files to git
+- Each agent stores code in a git repository (managed by GuildCore)
+- `save` commits and pushes code, creating a new version
 - Versions can be DRAFT or PUBLISHED
 - `code` fetches the latest version's files
 - Every version has a git commit SHA for traceability
 
-All agent commands interact with the guildcore backend API. The CLI is a remote client, similar to the web UI.
+All agent commands interact with the GuildCore backend API. The CLI is a remote client, similar to the web UI.
 
 ### Chat
 
 Interactive chat with streaming:
 
 ```bash
-guild chat           # Interactive chat session
-guild chat --debug   # Enable debug logging
+guild chat                    # Interactive chat session
+guild chat "your message"     # One-shot message
+guild agent test              # Test agent interactively
+guild agent chat "Hello"      # Send single message to agent
 ```
 
-### Version
+### Diagnostics
 
 ```bash
+guild doctor    # Check CLI setup and diagnose issues
 guild version   # Show CLI version info
 guild --version # Show version number
 ```
@@ -151,7 +150,7 @@ No YAML files. No terraform. No kubectl. Just simple commands.
 └────────────────────────┘
 ```
 
-The CLI is a thin client that communicates with GuildCore API (default: `http://localhost:5001`).
+The CLI is a thin client that communicates with the GuildCore API (default: `https://app.guild.ai/api`).
 
 ---
 
@@ -187,49 +186,16 @@ Environments are Docker containers managed by GuildCore. The CLI provides a simp
 
 ---
 
-## Implementation Status
-
-**Implemented (v0.1.0):**
-
-- ✅ OAuth device flow authentication
-- ✅ System keyring integration
-- ✅ Environment management (create, list, destroy, cleanup, exec, go)
-- ✅ Agent management (list, create, get, update)
-- ✅ Agent version control (save, versions, code) with git backing
-- ✅ Chat with streaming responses
-- ✅ JSON output for all commands
-- ✅ E2E test coverage
-- ✅ TypeScript implementation with Commander.js
-
----
-
 ## Integration with Developer Tools
 
-The CLI is designed to integrate with AI coding assistants like Claude Code, Cursor, and others.
+The CLI integrates with AI coding assistants like Claude Code, Cursor, and others. Run `guild setup` to install Guild skills into your project.
 
 **Typical Workflow:**
 
-1. Create agent: `guild agent create my-agent --description "..."`
+1. Initialize agent: `guild agent init --name my-agent --template LLM`
 2. Write agent code locally in your editor
-3. Save as draft version: `guild agent save <agent-id> --message "WIP" --directory ./my-agent`
-4. Test with chat: `guild chat`
+3. Test interactively: `guild agent test --ephemeral`
+4. Save as draft: `guild agent save --message "WIP"`
 5. Iterate on code and save new drafts
-6. Publish stable version: `guild agent save <agent-id> --message "v1.0" --publish`
-7. Pull code later: `guild agent code <agent-id> --output ./downloaded-agent`
-
-**Version Control Benefits:**
-
-- Edit code in your favorite editor (VS Code, Vim, etc.)
-- AI assistants can help write agent code
-- Save drafts for testing without affecting published versions
-- Full git history for every change
-- Download code to any machine
-
-The CLI meets developers where they are - use your preferred editor, AI assistant, and workflow.
-
----
-
-## Related Documentation
-
-- [Specifications](../specs/) - Executable specs for all features
-- [CLI README](../README.md) - Installation and quick start
+6. Publish stable version: `guild agent save --message "v1.0" --wait --publish`
+7. Clone on another machine: `guild agent clone owner/my-agent`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guildai/cli",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Guild.ai CLI - Build, test, and deploy AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -89,12 +89,12 @@
     "@types/ws": "^8.5.13",
     "@typescript-eslint/eslint-plugin": "^8.50.0",
     "@typescript-eslint/parser": "^8.50.0",
-    "@vitest/coverage-v8": "^2.1.8",
+    "@vitest/coverage-v8": "^4.1.2",
     "eslint": "^9.39.2",
     "prettier": "^3.7.4",
     "tsx": "^4.21.0",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vitest": "^4.1.2"
   },
   "engines": {
     "node": ">=18.0.0"

package/dist/lib/formatters.d.ts

@@ -1,44 +0,0 @@
-/**
- * JSON-serializable value type
- */
-type JsonValue = string | number | boolean | null | JsonObject | JsonArray;
-interface JsonObject {
-    [key: string]: JsonValue;
-}
-type JsonArray = JsonValue[];
-/**
- * Interface for output formatting in the CLI.
- * Implementations can provide different output styles (rich terminal, JSON, etc.)
- */
-export interface OutputFormatter {
-    /**
-     * Print an error message
-     * @param message - The error message
-     * @param details - Optional detailed error information
-     */
-    printError(message: string, details?: string): void;
-    /**
-     * Print a success message
-     * @param message - The success message
-     * @param data - Optional data to display with the message
-     */
-    printSuccess(message: string, data?: JsonObject): void;
-}
-/**
- * JSON output formatter - outputs all messages as JSON
- * Useful for scripting and programmatic consumption
- */
-export declare class JSONOutputFormatter implements OutputFormatter {
-    printError(message: string, details?: string): void;
-    printSuccess(message: string, data?: JsonObject): void;
-}
-/**
- * Rich terminal output formatter - uses colors and symbols
- * Provides a better user experience in interactive terminals
- */
-export declare class RichOutputFormatter implements OutputFormatter {
-    printError(message: string, details?: string): void;
-    printSuccess(message: string, data?: JsonObject): void;
-}
-export {};
-//# sourceMappingURL=formatters.d.ts.map

package/dist/lib/formatters.js

@@ -1,51 +0,0 @@
-// Copyright (c) 2026 Guild.ai All Rights Reserved
-import chalk from 'chalk';
-import { brand } from './colors.js';
-/**
- * JSON output formatter - outputs all messages as JSON
- * Useful for scripting and programmatic consumption
- */
-export class JSONOutputFormatter {
-    printError(message, details) {
-        const error = { error: message };
-        if (details) {
-            error.details = details;
-        }
-        console.log(JSON.stringify(error, null, 2));
-    }
-    printSuccess(message, data) {
-        const result = { success: message };
-        if (data) {
-            Object.assign(result, data);
-        }
-        console.log(JSON.stringify(result, null, 2));
-    }
-}
-/**
- * Rich terminal output formatter - uses colors and symbols
- * Provides a better user experience in interactive terminals
- */
-export class RichOutputFormatter {
-    printError(message, details) {
-        console.error(chalk.red(message));
-        if (details) {
-            console.error(chalk.dim(details));
-        }
-    }
-    printSuccess(message, data) {
-        console.log(chalk.green('✓'), message);
-        if (data) {
-            for (const [key, value] of Object.entries(data)) {
-                const strValue = value === null
-                    ? 'null'
-                    : value === undefined
-                        ? 'undefined'
-                        : typeof value === 'object'
-                            ? JSON.stringify(value)
-                            : String(value);
-                console.log(`  ${key}: ${brand(strValue)}`);
-            }
-        }
-    }
-}
-//# sourceMappingURL=formatters.js.map