more fmt

Author: tnm

.github/workflows/ci.yml

@@ -29,8 +29,8 @@ jobs:
       - name: Install kit CLI (editable)
         run: uv pip install -e .
 
-      - name: Lint & Type Check (TypeScript)
-        run: scripts/format-ts.sh --fix
+      - name: Lint & Type Check (Python + TypeScript)
+        run: scripts/format.sh --fix
 
       - name: Run JS Tests
         run: npm test --prefix clients/typescript

README.md

@@ -148,6 +148,7 @@ The CLI supports all major repository operations with Unix-friendly output for s
 *   **Multiple Access Methods:**
     *   **Python API**: Direct integration for building applications and scripts.
     *   **Command Line Interface**: 11+ commands for shell scripting, CI/CD, and automation workflows.
+    *   **TypeScript / Node Client**: `npm install @runcased/kit` for type-safe wrapper that shells out to the same CLI.
     *   **REST API**: HTTP endpoints for web applications and microservices.
     *   **MCP Server**: Model Context Protocol integration for AI agents and development tools.
 

clients/typescript/README.md

@@ -1,24 +1,54 @@
 # Kit TypeScript Client
 
-TypeScript/Node.js wrapper for the Cased Kit CLI. This library provides a type-safe interface to Kit's code analysis capabilities.
+TypeScript/Node.js wrapper for the Cased **Kit** CLI. This library lets you call Kit’s powerful code-analysis features from JavaScript or TypeScript with first-class typings.
 
 ## Installation
 
 ```bash
-npm install @cased/kit
+# 1) Install the TypeScript wrapper
+npm install @runcased/kit              # or pnpm add / yarn add
+
+# 2) Install the Kit CLI itself (Python)
+uv pip install cased-kit               # or pipx install cased-kit; or any other python way
+```
+
+> The TS wrapper shells out to the `kit` executable, so the Python package must be on **$PATH** in the same environment where Node runs (local dev, Docker image, CI runner, etc.).
+
+**Requirements**
+
+- Node 16 or newer
+- Python 3.10+ with `cased-kit` installed
+
+## Quick Start
+
+```typescript
+import { Kit } from "@runcased/kit";
+
+const kit = new Kit(); // uses `kit` from $PATH
+const repo = kit.repository("./"); // current repo
+
+(async () => {
+  const info = await repo.gitInfo();
+  console.log(info);
+
+  const files = await repo.fileTree(); // structured file list
+  console.log(`Repo has ${files.length} entries`);
+})();
 ```
 
-**Prerequisites:**
+## Wrapper Highlights
 
-- Node.js 16+
-- Kit CLI installed (`pip install cased-kit`)
+- **Type-safe** – full `.d.ts` bundled, generics for options & results.
+- **Same API shape as Python** – methods map 1-to-1 to CLI commands.
+- **Repository helper** – `kit.repository(path)` returns convenience wrapper so you don’t repeat the path/ref.
+- **No native deps** – only uses Node’s `child_process` to invoke CLI.
 
-## Usage
+The remainder of this README contains advanced usage & API reference.
 
 ### Basic Setup
 
 ```typescript
-import { Kit } from "@cased/kit";
+import { Kit } from "@runcased/kit";
 
 const kit = new Kit({
   kitPath: "kit", // Path to kit executable (optional)
@@ -73,7 +103,7 @@ results.forEach((result) => {
 const review = await kit.reviewPR("https://github.com/owner/repo/pull/123", {
   githubToken: process.env.GITHUB_TOKEN,
   llmProvider: "anthropic",
-  model: "claude-3-sonnet-20240229",
+  model: "claude-4-sonnet",
   apiKey: process.env.ANTHROPIC_API_KEY,
   priorities: ["high", "medium"],
   postAsComment: false, // Don't post to GitHub
@@ -96,7 +126,7 @@ const tree = await repo.fileTree();
 ### Error Handling
 
 ```typescript
-import { KitError } from "@cased/kit";
+import { KitError } from "@runcased/kit";
 
 try {
   const symbols = await repo.symbols("nonexistent.ts");
@@ -207,7 +237,7 @@ See `types.ts` for complete option interfaces including:
 ### Analyze a Repository
 
 ```typescript
-import { Kit } from "@cased/kit";
+import { Kit } from "@runcased/kit";
 
 async function analyzeRepo(repoPath: string) {
   const kit = new Kit();

clients/typescript/examples/analyze-repo.ts

@@ -1,4 +1,4 @@
-import { Kit } from "@cased/kit";
+import { Kit } from "@runcased/kit";
 
 async function main() {
   // Initialize Kit

clients/typescript/src/__tests__/integration.test.ts

@@ -9,9 +9,15 @@ maybeDescribe("Kit TypeScript wrapper – integration", () => {
     const repoRoot = path.resolve(__dirname, "../../../../");
 
     // Build the TypeScript client (dist/) – quiet if already built
-    execSync("npm run build", { cwd: path.join(repoRoot, "clients/typescript"), stdio: "inherit" });
+    execSync("npm run build", {
+      cwd: path.join(repoRoot, "clients/typescript"),
+      stdio: "inherit",
+    });
 
     // Run the manual wrapper test script; will throw if non-zero exit
-    execSync("node clients/typescript/test-wrapper.js", { cwd: repoRoot, stdio: "inherit" });
+    execSync("node clients/typescript/test-wrapper.js", {
+      cwd: repoRoot,
+      stdio: "inherit",
+    });
   }, 300_000); // allow up to 5 min in CI
-}); 
+});

clients/typescript/src/__tests__/kit.test.ts

@@ -1,6 +1,5 @@
 import { spawn } from "child_process";
-import { Kit, Repository } from "../kit";
-import { KitError } from "../types";
+import { Kit } from "../kit";
 import fs from "fs";
 
 // Mock child_process

clients/typescript/src/__tests__/repository.test.ts

@@ -6,7 +6,10 @@ jest.mock("child_process");
 const mockSpawn = spawn as jest.MockedFunction<typeof spawn>;
 
 jest.mock("fs");
-const mockFs = fs as unknown as { readFileSync: jest.Mock; unlinkSync: jest.Mock };
+const mockFs = fs as unknown as {
+  readFileSync: jest.Mock;
+  unlinkSync: jest.Mock;
+};
 
 // Helper to create mock child process
 function createMockProcess(
@@ -84,7 +87,7 @@ describe("Repository", () => {
       mockSpawn.mockReturnValue(createMockProcess("File tree written") as any);
       mockFs.readFileSync.mockReturnValue(mockOutput);
 
-      const files = await repo.fileTree();
+      const _files = await repo.fileTree();
 
       expect(mockSpawn).toHaveBeenCalledWith(
         "kit",
@@ -98,6 +101,7 @@ describe("Repository", () => {
         ],
         expect.any(Object),
       );
+      expect(_files.length).toBeGreaterThanOrEqual(0);
     });
   });
 

clients/typescript/src/kit.ts

@@ -15,6 +15,21 @@ import {
   DependenciesOptions,
   GitInfo,
 } from "./types";
+import os from "os";
+import path from "path";
+
+class KitCommandError extends Error implements KitError {
+  code: string;
+  exitCode: number;
+  stderr: string;
+  constructor(message: string, exitCode: number, stderr: string) {
+    super(message);
+    this.name = "KitCommandError";
+    this.code = "KIT_COMMAND_FAILED";
+    this.exitCode = exitCode;
+    this.stderr = stderr;
+  }
+}
 
 export class Kit {
   private options: Required<KitOptions>;
@@ -55,11 +70,13 @@ export class Kit {
         if (code === 0) {
           resolve(stdout);
         } else {
-          const error = new Error(`Kit command failed: ${stderr}`) as KitError;
-          error.code = "KIT_COMMAND_FAILED";
-          error.exitCode = code || 1;
-          error.stderr = stderr;
-          reject(error);
+          reject(
+            new KitCommandError(
+              `Kit command failed: ${stderr}`,
+              code || 1,
+              stderr,
+            ),
+          );
         }
       });
 
@@ -102,11 +119,11 @@ export class Kit {
   /**
    * Get file tree structure
    */
-  async fileTree(path: string = ".", ref?: string): Promise<FileNode[]> {
-    const args = ["file-tree", path];
+  async fileTree(repoPath: string = ".", ref?: string): Promise<FileNode[]> {
+    const args = ["file-tree", repoPath];
 
     // Create a temporary file for JSON output
-    const tmpFile = `/tmp/kit-file-tree-${Date.now()}.json`;
+    const tmpFile = path.join(os.tmpdir(), `kit-file-tree-${Date.now()}.json`);
 
     args.push("--output", tmpFile);
     if (ref) args.push("--ref", ref);
@@ -116,14 +133,11 @@ export class Kit {
       // Read the JSON from the temp file
       const fs = require("fs");
       const jsonData = fs.readFileSync(tmpFile, "utf8");
-      fs.unlinkSync(tmpFile); // Clean up
       return JSON.parse(jsonData);
-    } catch (error) {
-      // Clean up temp file on error
+    } finally {
       try {
         require("fs").unlinkSync(tmpFile);
       } catch {}
-      throw error;
     }
   }
 

scripts/format-ts.sh

@@ -21,4 +21,42 @@ else
   # Ruff check combines linting and format checking
   ruff check .
   echo "Ruff checks passed successfully!"
-fi 
+fi
+
+# -----------------------------------------------------------------------------
+# TypeScript Client formatting, linting, and type-checking
+# -----------------------------------------------------------------------------
+
+echo "----------------------------------------------"
+echo "TypeScript client checks (clients/typescript)"
+echo "----------------------------------------------"
+
+# Navigate to TypeScript client directory
+pushd clients/typescript > /dev/null
+
+# Install dependencies if node_modules missing
+if [ ! -d "node_modules" ]; then
+  echo "Installing TypeScript client dependencies..."
+  npm ci
+fi
+
+# Run Prettier and ESLint
+if [ "$1" == "--fix" ]; then
+  echo "Running Prettier (write)..."
+  npm run format:fix
+  echo "Running ESLint with --fix..."
+  npm run lint -- --fix
+else
+  echo "Running Prettier (check)..."
+  npm run format
+  echo "Running ESLint..."
+  npm run lint
+fi
+
+# TypeScript type check
+echo "Running TypeScript type check (tsc --noEmit)..."
+npm run typecheck
+
+popd > /dev/null
+
+echo "✅ All Python & TypeScript formatting and lint checks passed!"