@detent/cli 0.0.0

package/README.md

@@ -0,0 +1,45 @@
+# Detent CLI - npm Distribution
+
+Run GitHub Actions locally with intelligent error troubleshooting. Detent executes workflows, parses errors, categorizes them intelligently, and leverages Claude AI with parallel iterations to troubleshoot issues automatically.
+
+## Installation
+
+```bash
+npm install -g @detent/cli
+```
+
+After installation, the `dt` command will be available globally.
+
+## Usage
+
+```bash
+dt --help
+dt --version
+```
+
+## How It Works
+
+Detent streamlines your CI/CD development workflow:
+
+1. **Local Execution**: Runs GitHub Actions workflows on your local machine
+2. **Error Detection**: Automatically parses and extracts errors from workflow outputs
+3. **Smart Categorization**: Intelligently groups and categorizes error types
+4. **AI Troubleshooting**: Prompts Claude in parallel with multiple iterations to diagnose and suggest fixes
+5. **Iterative Refinement**: Continues troubleshooting across multiple rounds until issues are resolved
+
+### Binary Distribution
+
+This npm package automatically downloads the appropriate pre-built Go binary for your platform during installation:
+
+- Linux: amd64, arm64
+- macOS: amd64 (Intel), arm64 (Apple Silicon)
+- Windows: amd64
+
+## Troubleshooting
+
+If the installation fails, you can manually download the binary from:
+https://github.com/handleui/detent/releases
+
+## License
+
+MIT

package/bin.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+const { spawn } = require("node:child_process");
+const { join } = require("node:path");
+
+const binPath = join(__dirname, "bin", "dt");
+
+const child = spawn(binPath, process.argv.slice(2), { stdio: "inherit" });
+
+child.on("exit", (code) => {
+  process.exit(code);
+});

package/install.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+
+const { existsSync, mkdirSync, chmodSync } = require("node:fs");
+const { join } = require("node:path");
+const { pipeline } = require("node:stream");
+const { promisify } = require("node:util");
+const https = require("node:https");
+const { createGunzip } = require("node:zlib");
+const tar = require("tar-fs");
+
+const streamPipeline = promisify(pipeline);
+
+const PACKAGE_JSON = require("./package.json");
+
+const getPlatform = () => {
+  const platform = process.platform;
+  if (platform === "win32") {
+    return "windows";
+  }
+  if (platform === "darwin") {
+    return "darwin";
+  }
+  if (platform === "linux") {
+    return "linux";
+  }
+  throw new Error(`Unsupported platform: ${platform}`);
+};
+
+const getArch = () => {
+  const arch = process.arch;
+  if (arch === "x64") {
+    return "amd64";
+  }
+  if (arch === "arm64") {
+    return "arm64";
+  }
+  throw new Error(`Unsupported architecture: ${arch}`);
+};
+
+const getExtension = () => (process.platform === "win32" ? "zip" : "tar.gz");
+
+const getBinaryName = () => (process.platform === "win32" ? "dt.exe" : "dt");
+
+const download = (url) =>
+  new Promise((resolve, reject) => {
+    https
+      .get(url, (response) => {
+        if (response.statusCode === 302 || response.statusCode === 301) {
+          return download(response.headers.location).then(resolve, reject);
+        }
+        if (response.statusCode !== 200) {
+          reject(new Error(`Failed to download: ${response.statusCode}`));
+          return;
+        }
+        resolve(response);
+      })
+      .on("error", reject);
+  });
+
+const install = async () => {
+  try {
+    const platform = getPlatform();
+    const arch = getArch();
+    const ext = getExtension();
+    const version = PACKAGE_JSON.version;
+
+    const url = PACKAGE_JSON.goBinary.url
+      .replace("{{version}}", version)
+      .replace("{{platform}}", platform)
+      .replace("{{arch}}", arch)
+      .replace("{{ext}}", ext);
+
+    const binDir = join(__dirname, PACKAGE_JSON.goBinary.path);
+    const binaryName = getBinaryName();
+    const binaryPath = join(binDir, binaryName);
+
+    if (!existsSync(binDir)) {
+      mkdirSync(binDir, { recursive: true });
+    }
+
+    console.log(`Downloading binary from ${url}...`);
+
+    const response = await download(url);
+
+    if (process.platform === "win32") {
+      const AdmZip = require("adm-zip");
+      const chunks = [];
+
+      await new Promise((resolve, reject) => {
+        response.on("data", (chunk) => chunks.push(chunk));
+        response.on("end", resolve);
+        response.on("error", reject);
+      });
+
+      const buffer = Buffer.concat(chunks);
+      const zip = new AdmZip(buffer);
+      zip.extractAllTo(binDir, true);
+    } else {
+      await streamPipeline(response, createGunzip(), tar.extract(binDir));
+    }
+
+    if (process.platform !== "win32") {
+      chmodSync(binaryPath, 0o755);
+    }
+
+    console.log(`Binary installed successfully at ${binaryPath}`);
+  } catch (error) {
+    console.error("Failed to install binary:", error.message);
+    console.error("\nYou can manually download the binary from:");
+    console.error(
+      `https://github.com/handleui/detent/releases/tag/v${PACKAGE_JSON.version}`
+    );
+
+    // Exit gracefully in CI or during development (version 0.0.0)
+    if (process.env.CI || PACKAGE_JSON.version === "0.0.0") {
+      console.log("Skipping binary installation in CI/development mode");
+      process.exit(0);
+    }
+
+    process.exit(1);
+  }
+};
+
+install();

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@detent/cli",
+  "version": "0.0.0",
+  "description": "Run GitHub Actions locally, intelligently parse errors, and troubleshoot with parallel Claude iterations",
+  "author": "handleui",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/handleui/detent.git",
+    "directory": "apps/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/handleui/detent/issues"
+  },
+  "homepage": "https://github.com/handleui/detent#readme",
+  "keywords": [
+    "cli",
+    "github-actions",
+    "local-runner",
+    "error-parsing",
+    "ai-troubleshooting",
+    "claude",
+    "detent"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bin": {
+    "dt": "bin.js"
+  },
+  "files": [
+    "bin.js",
+    "install.js",
+    "uninstall.js",
+    "bin/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "sh -c 'VERSION=$(node -p \"require(\\\"./package.json\\\").version\") && go build -ldflags \"-X github.com/detent/cli/cmd.Version=$VERSION\" -o dist/dt'",
+    "clean": "rm -rf dist bin",
+    "prepare-release": "npm run clean && mkdir -p bin",
+    "postinstall": "node ./install.js",
+    "preuninstall": "node ./uninstall.js"
+  },
+  "dependencies": {
+    "tar-fs": "^3.0.6",
+    "adm-zip": "^0.5.16"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "goBinary": {
+    "name": "dt",
+    "path": "./bin",
+    "url": "https://github.com/handleui/detent/releases/download/v{{version}}/dt-{{platform}}-{{arch}}.{{ext}}"
+  }
+}

package/uninstall.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+const { existsSync, rmSync } = require("node:fs");
+const { join } = require("node:path");
+
+const PACKAGE_JSON = require("./package.json");
+
+const uninstall = () => {
+  const binDir = join(__dirname, PACKAGE_JSON.goBinary.path);
+
+  if (existsSync(binDir)) {
+    rmSync(binDir, { recursive: true, force: true });
+    console.log("Binary uninstalled successfully");
+  }
+};
+
+uninstall();