@yuaone/cli 0.1.0

package/dist/session.js

@@ -0,0 +1,246 @@
+/**
+ * YUAN CLI — Session Manager
+ *
+ * Handles saving/loading agent sessions for `yuan resume`.
+ * Connects to @yuaone/core SessionPersistence for disk-level persistence
+ * with checkpointing and crash recovery support.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import * as crypto from "node:crypto";
+import { SessionPersistence, } from "@yuaone/core";
+const YUAN_DIR = path.join(os.homedir(), ".yuan");
+const SESSIONS_DIR = path.join(YUAN_DIR, "sessions");
+const LAST_SESSION_FILE = path.join(YUAN_DIR, "last-session");
+/**
+ * SessionManager — save/load/resume agent sessions.
+ *
+ * Wraps @yuaone/core SessionPersistence with CLI-friendly interface.
+ * Sessions are stored in ~/.yuan/sessions/<sessionId>/ with:
+ * - state.json: metadata
+ * - messages.json: conversation history
+ * - checkpoint.json: iteration/token state
+ */
+export class SessionManager {
+    persistence;
+    constructor(baseDir) {
+        this.persistence = new SessionPersistence(baseDir);
+    }
+    /** Create a new session */
+    create(workDir, provider, model) {
+        const session = {
+            id: crypto.randomUUID(),
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+            workDir,
+            messages: [],
+            provider,
+            model,
+            status: "running",
+            iteration: 0,
+            tokenUsage: { input: 0, output: 0 },
+        };
+        // Ensure session directory exists SYNCHRONOUSLY before any async writes.
+        // This prevents ENOENT race conditions when fire-and-forget persistence.save()
+        // hasn't created the directory yet and a subsequent save() call runs concurrently.
+        const sessionDir = path.join(SESSIONS_DIR, session.id);
+        fs.mkdirSync(sessionDir, { recursive: true });
+        // Save to disk immediately
+        this.save(session);
+        return session;
+    }
+    /** Save a session to disk (via core SessionPersistence) */
+    save(session) {
+        session.updatedAt = Date.now();
+        const persistentData = {
+            snapshot: this.toSnapshot(session),
+            messages: session.messages.map((m) => ({
+                role: m.role,
+                content: m.content,
+            })),
+            plan: null,
+            changedFiles: [],
+        };
+        // Ensure session directory exists SYNCHRONOUSLY before any async writes.
+        // This prevents ENOENT when multiple fire-and-forget saves race.
+        const sessionDir = path.join(SESSIONS_DIR, session.id);
+        try {
+            fs.mkdirSync(sessionDir, { recursive: true });
+        }
+        catch {
+            // Best-effort — persistence.save() will also try ensureDir
+        }
+        // Write last-session pointer
+        try {
+            fs.writeFileSync(LAST_SESSION_FILE, session.id, "utf-8");
+        }
+        catch {
+            // Best-effort
+        }
+        // Fire-and-forget async save with error logging
+        this.persistence.save(session.id, persistentData).catch((err) => {
+            process.stderr.write(`Session save failed: ${err}\n`);
+        });
+    }
+    /** Load a session by ID */
+    load(sessionId) {
+        return this.loadSync(sessionId);
+    }
+    /** Load the last session */
+    loadLast() {
+        const lastId = this.getLastSessionId();
+        if (!lastId)
+            return null;
+        return this.loadSync(lastId);
+    }
+    /** Get the last session ID */
+    getLastSessionId() {
+        try {
+            if (fs.existsSync(LAST_SESSION_FILE)) {
+                return fs.readFileSync(LAST_SESSION_FILE, "utf-8").trim() || null;
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return null;
+    }
+    /** Add a message to a session */
+    addMessage(session, role, content) {
+        session.messages.push({
+            role,
+            content,
+            timestamp: Date.now(),
+        });
+        this.save(session);
+    }
+    /** Save a checkpoint (called after each iteration) */
+    async saveCheckpoint(session, changedFiles = [], lastToolCall) {
+        const checkpoint = {
+            iteration: session.iteration,
+            tokenUsage: session.tokenUsage,
+            timestamp: new Date().toISOString(),
+            changedFiles,
+            lastToolCall,
+        };
+        await this.persistence.checkpoint(session.id, checkpoint);
+    }
+    /** Update session status */
+    async updateStatus(session, status) {
+        session.status = status;
+        await this.persistence.updateStatus(session.id, status);
+    }
+    /** List recent sessions (async) */
+    async listSessions(limit = 20) {
+        return this.persistence.listSessions(limit);
+    }
+    /** List recent sessions (sync for CLI display) */
+    listRecent(limit = 10) {
+        const sessions = [];
+        try {
+            const entries = fs.readdirSync(SESSIONS_DIR, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                try {
+                    const stateFile = path.join(SESSIONS_DIR, entry.name, "state.json");
+                    const messagesFile = path.join(SESSIONS_DIR, entry.name, "messages.json");
+                    if (!fs.existsSync(stateFile))
+                        continue;
+                    const snapshot = JSON.parse(fs.readFileSync(stateFile, "utf-8"));
+                    let messages = [];
+                    if (fs.existsSync(messagesFile)) {
+                        const rawMessages = JSON.parse(fs.readFileSync(messagesFile, "utf-8"));
+                        messages = rawMessages.map((m, i) => ({
+                            role: m.role,
+                            content: m.content,
+                            timestamp: new Date(snapshot.createdAt).getTime() + i * 1000,
+                        }));
+                    }
+                    sessions.push({
+                        id: snapshot.id,
+                        createdAt: new Date(snapshot.createdAt).getTime(),
+                        updatedAt: new Date(snapshot.updatedAt).getTime(),
+                        workDir: snapshot.workDir,
+                        messages,
+                        provider: snapshot.provider,
+                        model: snapshot.model,
+                        status: snapshot.status,
+                        iteration: snapshot.iteration,
+                        tokenUsage: snapshot.tokenUsage,
+                    });
+                }
+                catch {
+                    // Skip corrupted sessions
+                }
+            }
+        }
+        catch {
+            // Sessions dir doesn't exist yet
+        }
+        sessions.sort((a, b) => b.updatedAt - a.updatedAt);
+        return sessions.slice(0, limit);
+    }
+    /** Detect crashed sessions */
+    async detectCrashed() {
+        return this.persistence.detectCrashedSessions();
+    }
+    /** Clean up old sessions */
+    async cleanup(maxAgeDays = 30) {
+        return this.persistence.cleanup(maxAgeDays);
+    }
+    // ─── Private ───
+    toSnapshot(session) {
+        return {
+            id: session.id,
+            createdAt: new Date(session.createdAt).toISOString(),
+            updatedAt: new Date(session.updatedAt).toISOString(),
+            workDir: session.workDir,
+            provider: session.provider,
+            model: session.model,
+            status: session.status,
+            iteration: session.iteration,
+            tokenUsage: session.tokenUsage,
+            messageCount: session.messages.length,
+        };
+    }
+    /** Sync load from disk (for CLI compatibility) */
+    loadSync(sessionId) {
+        const sessionDir = path.join(SESSIONS_DIR, sessionId);
+        if (!fs.existsSync(sessionDir))
+            return null;
+        try {
+            const stateFile = path.join(sessionDir, "state.json");
+            const messagesFile = path.join(sessionDir, "messages.json");
+            if (!fs.existsSync(stateFile))
+                return null;
+            const snapshot = JSON.parse(fs.readFileSync(stateFile, "utf-8"));
+            let messages = [];
+            if (fs.existsSync(messagesFile)) {
+                const rawMessages = JSON.parse(fs.readFileSync(messagesFile, "utf-8"));
+                messages = rawMessages.map((m, i) => ({
+                    role: m.role,
+                    content: m.content,
+                    timestamp: new Date(snapshot.createdAt).getTime() + i * 1000,
+                }));
+            }
+            return {
+                id: snapshot.id,
+                createdAt: new Date(snapshot.createdAt).getTime(),
+                updatedAt: new Date(snapshot.updatedAt).getTime(),
+                workDir: snapshot.workDir,
+                messages,
+                provider: snapshot.provider,
+                model: snapshot.model,
+                status: snapshot.status,
+                iteration: snapshot.iteration,
+                tokenUsage: snapshot.tokenUsage,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/dist/y-spinner.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @module y-spinner
+ * @description Y spinner animation for CLI.
+ * Uses ANSI 256 colors for a glowing Y logo effect.
+ */
+/**
+ * YSpinner — Terminal spinner with a glowing Y logo animation.
+ *
+ * @example
+ * ```ts
+ * const spinner = new YSpinner();
+ * spinner.start("Authenticating...");
+ * // ... async work ...
+ * spinner.success("Logged in!");
+ * ```
+ */
+export declare class YSpinner {
+    private timer;
+    private frameIndex;
+    private message;
+    /** Start the spinner with an initial message. */
+    start(message: string): void;
+    /** Update the spinner message without stopping it. */
+    update(message: string): void;
+    /** Stop the spinner and show a success message. */
+    success(message: string): void;
+    /** Stop the spinner and show a failure message. */
+    fail(message: string): void;
+    /** Stop the spinner and restore the cursor. */
+    stop(): void;
+    /** Render the current frame to stderr. */
+    private render;
+}
+//# sourceMappingURL=y-spinner.d.ts.map

package/dist/y-spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"y-spinner.d.ts","sourceRoot":"","sources":["../src/y-spinner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoCH;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAM;IAErB,iDAAiD;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAa5B,sDAAsD;IACtD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,mDAAmD;IACnD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9B,mDAAmD;IACnD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM3B,+CAA+C;IAC/C,IAAI,IAAI,IAAI;IASZ,0CAA0C;IAC1C,OAAO,CAAC,MAAM;CAIf"}

package/dist/y-spinner.js

@@ -0,0 +1,93 @@
+/**
+ * @module y-spinner
+ * @description Y spinner animation for CLI.
+ * Uses ANSI 256 colors for a glowing Y logo effect.
+ */
+/** ANSI 256-color palette for the Y spinner */
+const COLORS = {
+    dim: "\x1b[38;5;240m",
+    normal: "\x1b[38;5;33m",
+    bright: "\x1b[38;5;39m",
+    glow: "\x1b[38;5;51m",
+    accent: "\x1b[38;5;220m",
+    green: "\x1b[38;5;82m",
+    red: "\x1b[38;5;196m",
+    reset: "\x1b[0m",
+};
+/** Hide/show cursor ANSI sequences */
+const CURSOR_HIDE = "\x1b[?25l";
+const CURSOR_SHOW = "\x1b[?25h";
+const CLEAR_LINE = "\x1b[2K\r";
+/**
+ * Animation frames — 8 frames cycling through dim → normal → bright → glow.
+ * Each frame applies a different color to the Y character.
+ */
+const FRAMES = [
+    `${COLORS.dim}Y${COLORS.reset}`,
+    `${COLORS.dim}Y${COLORS.reset}`,
+    `${COLORS.normal}Y${COLORS.reset}`,
+    `${COLORS.normal}Y${COLORS.reset}`,
+    `${COLORS.bright}Y${COLORS.reset}`,
+    `${COLORS.bright}Y${COLORS.reset}`,
+    `${COLORS.glow}Y${COLORS.reset}`,
+    `${COLORS.accent}Y${COLORS.reset}`,
+];
+const FRAME_INTERVAL = 100;
+/**
+ * YSpinner — Terminal spinner with a glowing Y logo animation.
+ *
+ * @example
+ * ```ts
+ * const spinner = new YSpinner();
+ * spinner.start("Authenticating...");
+ * // ... async work ...
+ * spinner.success("Logged in!");
+ * ```
+ */
+export class YSpinner {
+    timer = null;
+    frameIndex = 0;
+    message = "";
+    /** Start the spinner with an initial message. */
+    start(message) {
+        this.message = message;
+        this.frameIndex = 0;
+        process.stderr.write(CURSOR_HIDE);
+        this.render();
+        this.timer = setInterval(() => {
+            this.frameIndex = (this.frameIndex + 1) % FRAMES.length;
+            this.render();
+        }, FRAME_INTERVAL);
+    }
+    /** Update the spinner message without stopping it. */
+    update(message) {
+        this.message = message;
+    }
+    /** Stop the spinner and show a success message. */
+    success(message) {
+        this.stop();
+        const icon = `${COLORS.green}Y\u2713${COLORS.reset}`;
+        process.stderr.write(`${CLEAR_LINE}${icon} ${message}\n`);
+    }
+    /** Stop the spinner and show a failure message. */
+    fail(message) {
+        this.stop();
+        const icon = `${COLORS.red}Y\u2717${COLORS.reset}`;
+        process.stderr.write(`${CLEAR_LINE}${icon} ${message}\n`);
+    }
+    /** Stop the spinner and restore the cursor. */
+    stop() {
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        process.stderr.write(CLEAR_LINE);
+        process.stderr.write(CURSOR_SHOW);
+    }
+    /** Render the current frame to stderr. */
+    render() {
+        const frame = FRAMES[this.frameIndex];
+        process.stderr.write(`${CLEAR_LINE}${frame} ${this.message}`);
+    }
+}
+//# sourceMappingURL=y-spinner.js.map

package/dist/y-spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"y-spinner.js","sourceRoot":"","sources":["../src/y-spinner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@yuaone/cli",
+  "version": "0.1.0",
+  "description": "YUAN — Autonomous Coding Agent CLI",
+  "license": "AGPL-3.0",
+  "type": "module",
+  "bin": {
+    "yuan": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist/", "README.md", "LICENSE"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yuaone/yuan.git",
+    "directory": "packages/yuan-cli"
+  },
+  "homepage": "https://github.com/yuaone/yuan#readme",
+  "bugs": {
+    "url": "https://github.com/yuaone/yuan/issues"
+  },
+  "keywords": ["coding-agent", "ai", "autonomous", "cli", "llm", "developer-tools"],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli.js",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "lint": "tsc --noEmit",
+    "start": "node dist/cli.js"
+  },
+  "dependencies": {
+    "@yuaone/core": "workspace:*",
+    "@yuaone/tools": "workspace:*",
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.15",
+    "typescript": "^5.7.0"
+  }
+}