terminal-jarvis 0.0.78 → 0.0.80

package/README.md

@@ -11,6 +11,8 @@ Manage Claude, Gemini, Qwen, and 19 more AI assistants from one terminal interfa
 [![Homebrew](https://img.shields.io/badge/Homebrew-Available-blue.svg?logo=homebrew&style=flat-square)](https://github.com/BA-CalderonMorales/homebrew-terminal-jarvis)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 [![Mentioned in Awesome](https://img.shields.io/badge/Mentioned%20in-Awesome-6f42c1?style=flat-square)](https://github.com/Piebald-AI/awesome-gemini-cli)
+[![Docs](https://img.shields.io/badge/docs-latest-blue.svg?style=flat-square)](https://ba-calderonmorales.github.io/my-life-as-a-dev/latest/projects/active/terminal-jarvis/)
+[![Coverage](https://img.shields.io/badge/coverage-report-green.svg?style=flat-square)](/coverage)
 
 <img src="https://raw.githubusercontent.com/BA-CalderonMorales/terminal-jarvis/docs/screenshots_and_demos/screenshots_and_demo/promo_image_for_readme.png" alt="Terminal Jarvis Interface" width="100%">
 
@@ -22,6 +24,19 @@ Manage Claude, Gemini, Qwen, and 19 more AI assistants from one terminal interfa
 
 ---
 
+## Table of Contents
+
+- [Quick Start](#quick-start)
+- [What It Does](#what-it-does)
+- [Documentation](#documentation)
+- [Project Structure](#project-structure)
+- [Development](#development)
+- [Contributing](#contributing)
+- [License](#license)
+
+
+> *Note: If these links do not respond in the GitHub Mobile app, try viewing in a browser. This is a known platform limitation.*
+
 ## Quick Start
 
 ```bash

package/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Terminal Jarvis - TypeScript Type Definitions
+ *
+ * A thin wrapper that provides a unified interface for managing
+ * and running AI coding tools including Claude, Gemini, Qwen,
+ * OpenCode, Codex, Aider, Goose, Amp, Crush, LLXPRT, and more.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Options for running Terminal Jarvis
+ */
+export interface JarvisOptions {
+  /** Run in headless mode without interactive prompts */
+  headless?: boolean;
+  /** UI theme to use */
+  theme?: "default" | "classic" | "matrix";
+  /** Enable verbose logging */
+  verbose?: boolean;
+  /** Configuration file path */
+  config?: string;
+}
+
+/**
+ * Execute a terminal-jarvis command with the specified tool
+ *
+ * @param tool - The AI tool to run (e.g., "claude", "gemini", "codex")
+ * @param options - Optional configuration for the execution
+ * @returns Promise that resolves when the command completes
+ *
+ * @example
+ * ```typescript
+ * import { run } from "terminal-jarvis";
+ *
+ * await run("claude", { theme: "matrix" });
+ * ```
+ */
+export function run(tool: string, options?: JarvisOptions): Promise<void>;
+
+/**
+ * Execute terminal-jarvis with raw command arguments
+ *
+ * @param args - Array of command-line arguments to pass to terminal-jarvis
+ * @returns Promise that resolves with the exit code
+ *
+ * @example
+ * ```typescript
+ * import { runRaw } from "terminal-jarvis";
+ *
+ * const exitCode = await runRaw(["--version"]);
+ * ```
+ */
+export function runRaw(args: string[]): Promise<number>;
+
+/**
+ * Get the path to the bundled Rust binary
+ *
+ * @returns The absolute path to the binary, or null if not found
+ */
+export function getBinaryPath(): string | null;
+
+/**
+ * Check if terminal-jarvis is properly installed and available
+ *
+ * @returns Promise that resolves to true if available
+ */
+export function isAvailable(): Promise<boolean>;
+
+/**
+ * Supported AI tools that can be managed through Terminal Jarvis
+ */
+export type SupportedTool =
+  | "claude"
+  | "gemini"
+  | "qwen"
+  | "opencode"
+  | "codex"
+  | "aider"
+  | "goose"
+  | "amp"
+  | "crush"
+  | "llxprt"
+  | string;
+
+/**
+ * Version information for Terminal Jarvis
+ */
+export interface VersionInfo {
+  /** NPM wrapper version */
+  npmVersion: string;
+  /** Core Rust binary version */
+  coreVersion: string;
+  /** Platform binary was built for */
+  platform: string;
+}
+
+/**
+ * Get version information for Terminal Jarvis
+ *
+ * @returns Promise that resolves with version information
+ */
+export function getVersion(): Promise<VersionInfo>;

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "terminal-jarvis",
-  "version": "0.0.78",
+  "version": "0.0.80",
   "description": "AI Coding Tools Wrapper - Unified interface for claude-code, gemini-cli, qwen-code, opencode, llxprt, codex, crush, goose, amp, and aider",
   "bin": {
     "terminal-jarvis": "bin/terminal-jarvis"
   },
+  "types": "index.d.ts",
   "files": [
     "lib/",
     "bin/",
     "scripts/",
     "config/",
     "README.md",
-    "package.json"
+    "package.json",
+    "index.d.ts"
   ],
   "scripts": {
     "generate-tools": "../../scripts/utils/generate-readme-tools.sh",
@@ -30,6 +32,7 @@
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit && echo 'TypeScript type check passed'",
     "test:e2e": "npm run build-rust && vitest run",
     "build": "npm run copy-configs && npm run sync-readme-npm",
     "prepack": "npm run build",
@@ -56,14 +59,14 @@
   },
   "homepage": "https://github.com/BA-CalderonMorales/terminal-jarvis#readme",
   "devDependencies": {
-    "@biomejs/biome": "^2.1.3",
-    "@types/node": "^24.7.0",
-    "@vitest/ui": "^3.2.4",
-    "cli-testing-library": "^3.0.1",
-    "string-width": "^8.1.0",
-    "typescript": "^5.9.2",
-    "vitest": "^3.2.4",
-    "zod": "^4.1.11"
+    "@biomejs/biome": "2.1.4",
+    "@types/node": "22.15.3",
+    "@vitest/ui": "3.2.4",
+    "cli-testing-library": "3.0.1",
+    "string-width": "8.1.0",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4",
+    "zod": "3.25.56"
   },
   "engines": {
     "node": ">=16.0.0"

package/scripts/postinstall.js

@@ -8,7 +8,7 @@
  - Verify installation
 
  Version Hint (used by CI for consistency checks):
- Terminal Jarvis v0.0.78
+ Terminal Jarvis v0.0.79
 */
 
 const fs = require('fs');
@@ -218,6 +218,13 @@ function checkPrerequisites() {
 (async () => {
     const startTime = Date.now();
 
+    // Skip binary download in CI environments - binary hasn't been released yet
+    if (process.env.CI || process.env.SKIP_POSTINSTALL) {
+        log('CI environment detected - skipping binary download');
+        log('Binary will be built from source or downloaded on first use');
+        process.exit(0);
+    }
+
     try {
         // Detect platform
         const platformInfo = getPlatformInfo();