azdo-cli 0.2.0-001-azdo-cli-base.5 → 0.2.0-002-get-item-command.10

package/README.md

@@ -1,79 +1,72 @@
-# bd - Beads
+# azdo-cli
 
-**Distributed, git-backed graph issue tracker for AI agents.**
+A command-line interface for Azure DevOps.
 
-**Platforms:** macOS, Linux, Windows, FreeBSD
+[![npm version](https://img.shields.io/npm/v/azdo-cli)](https://www.npmjs.com/package/azdo-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-[![License](https://img.shields.io/github/license/steveyegge/beads)](LICENSE)
-[![Go Report Card](https://goreportcard.com/badge/github.com/steveyegge/beads)](https://goreportcard.com/report/github.com/steveyegge/beads)
-[![Release](https://img.shields.io/github/v/release/steveyegge/beads)](https://github.com/steveyegge/beads/releases)
-[![npm version](https://img.shields.io/npm/v/@beads/bd)](https://www.npmjs.com/package/@beads/bd)
-[![PyPI](https://img.shields.io/pypi/v/beads-mcp)](https://pypi.org/project/beads-mcp/)
+## Installation
 
-Beads provides a persistent, structured memory for coding agents. It replaces messy markdown plans with a dependency-aware graph, allowing agents to handle long-horizon tasks without losing context.
+```bash
+npm install -g azdo-cli
+```
 
-## ⚡ Quick Start
+## Usage
 
 ```bash
-# Install beads CLI (system-wide - don't clone this repo into your project)
-curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
-
-# Initialize in YOUR project
-cd your-project
-bd init
+# Show help
+azdo --help
 
-# Tell your agent
-echo "Use 'bd' for task tracking" >> AGENTS.md
+# Show version
+azdo --version
+azdo -v
 ```
 
-**Note:** Beads is a CLI tool you install once and use everywhere. You don't need to clone this repository into your project.
+## Current Status
 
-## 🛠 Features
+This project is in early development (v0.2.0). The base CLI scaffold is in place with support for `--help` and `--version`. Azure DevOps commands (work items, pipelines, repos, etc.) will be added in future releases.
 
-* **Git as Database:** Issues stored as JSONL in `.beads/`. Versioned, branched, and merged like code.
-* **Agent-Optimized:** JSON output, dependency tracking, and auto-ready task detection.
-* **Zero Conflict:** Hash-based IDs (`bd-a1b2`) prevent merge collisions in multi-agent/multi-branch workflows.
-* **Invisible Infrastructure:** SQLite local cache for speed; background daemon for auto-sync.
-* **Compaction:** Semantic "memory decay" summarizes old closed tasks to save context window.
+## Development
 
-## 📖 Essential Commands
-
-| Command | Action |
-| --- | --- |
-| `bd ready` | List tasks with no open blockers. |
-| `bd create "Title" -p 0` | Create a P0 task. |
-| `bd update <id> --claim` | Atomically claim a task (sets assignee + in_progress). |
-| `bd dep add <child> <parent>` | Link tasks (blocks, related, parent-child). |
-| `bd show <id>` | View task details and audit trail. |
+### Prerequisites
 
-## 🔗 Hierarchy & Workflow
+- Node.js LTS (20+)
+- npm
 
-Beads supports hierarchical IDs for epics:
+### Setup
 
-* `bd-a3f8` (Epic)
-* `bd-a3f8.1` (Task)
-* `bd-a3f8.1.1` (Sub-task)
-
-**Stealth Mode:** Run `bd init --stealth` to use Beads locally without committing files to the main repo. Perfect for personal use on shared projects.
+```bash
+git clone https://github.com/alkampfergit/azdo-cli.git
+cd azdo-cli
+npm install
+```
 
-**Contributor vs Maintainer:** When working on open-source projects:
+### Scripts
 
-* **Contributors** (forked repos): Run `bd init --contributor` to route planning issues to a separate repo (e.g., `~/.beads-planning`). Keeps experimental work out of PRs.
-* **Maintainers** (write access): Beads auto-detects maintainer role via SSH URLs or HTTPS with credentials. Only need `git config beads.role maintainer` if using GitHub HTTPS without credentials but you have write access.
+| Command | Description |
+| --- | --- |
+| `npm run build` | Build the CLI with tsup |
+| `npm test` | Run tests with vitest |
+| `npm run lint` | Lint source files with ESLint |
+| `npm run typecheck` | Type-check with tsc (no emit) |
+| `npm run format` | Check formatting with Prettier |
 
-## 📦 Installation
+### Tech Stack
 
-* **npm:** `npm install -g @beads/bd`
-* **Homebrew:** `brew install beads`
-* **Go:** `go install github.com/steveyegge/beads/cmd/bd@latest`
+- **TypeScript 5.x** (strict mode, ES modules)
+- **commander.js** — CLI framework
+- **tsup** — Bundler (single-file ESM output)
+- **vitest** — Test runner
+- **ESLint + Prettier** — Linting and formatting
 
-**Requirements:** Linux, FreeBSD, macOS, or Windows.
+### Branch Strategy
 
-## 🌐 Community Tools
+This project follows **GitFlow**:
 
-See [docs/COMMUNITY_TOOLS.md](docs/COMMUNITY_TOOLS.md) for a curated list of community-built UIs, extensions, and integrations—including terminal interfaces, web UIs, editor extensions, and native apps.
+- `master` — stable releases
+- `develop` — integration branch
+- `feature/*` — feature branches off `develop`
 
-## 📝 Documentation
+## License
 
-* [Installing](docs/INSTALLING.md) | [Agent Workflow](AGENT_INSTRUCTIONS.md) | [Copilot Setup](docs/COPILOT_INTEGRATION.md) | [Articles](ARTICLES.md) | [Sync Branch Mode](docs/PROTECTED_BRANCHES.md) | [Troubleshooting](docs/TROUBLESHOOTING.md) | [FAQ](docs/FAQ.md)
-* [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/steveyegge/beads)
+[MIT](LICENSE)

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command } from "commander";
+import { Command as Command2 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -11,9 +11,277 @@ var __dirname = dirname(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(readFileSync(resolve(__dirname, "../package.json"), "utf-8"));
 var version = pkg.version;
 
+// src/commands/get-item.ts
+import { Command } from "commander";
+
+// src/services/azdo-client.ts
+async function getWorkItem(context, id, pat) {
+  const url = `https://dev.azure.com/${context.org}/${context.project}/_apis/wit/workitems/${id}?api-version=7.1`;
+  const token = Buffer.from(`:${pat}`).toString("base64");
+  let response;
+  try {
+    response = await fetch(url, {
+      headers: {
+        Authorization: `Basic ${token}`
+      }
+    });
+  } catch {
+    throw new Error("NETWORK_ERROR");
+  }
+  if (response.status === 401) throw new Error("AUTH_FAILED");
+  if (response.status === 403) throw new Error("PERMISSION_DENIED");
+  if (response.status === 404) throw new Error("NOT_FOUND");
+  if (!response.ok) {
+    throw new Error(`HTTP_${response.status}`);
+  }
+  const data = await response.json();
+  return {
+    id: data.id,
+    rev: data.rev,
+    title: data.fields["System.Title"],
+    state: data.fields["System.State"],
+    type: data.fields["System.WorkItemType"],
+    assignedTo: data.fields["System.AssignedTo"]?.displayName ?? null,
+    description: data.fields["System.Description"] ?? null,
+    areaPath: data.fields["System.AreaPath"],
+    iterationPath: data.fields["System.IterationPath"],
+    url: data._links.html.href
+  };
+}
+
+// src/services/auth.ts
+import { createInterface } from "readline";
+
+// src/services/credential-store.ts
+import { Entry } from "@napi-rs/keyring";
+var SERVICE = "azdo-cli";
+var ACCOUNT = "pat";
+async function getPat() {
+  try {
+    const entry = new Entry(SERVICE, ACCOUNT);
+    return entry.getPassword();
+  } catch {
+    return null;
+  }
+}
+async function storePat(pat) {
+  try {
+    const entry = new Entry(SERVICE, ACCOUNT);
+    entry.setPassword(pat);
+  } catch {
+  }
+}
+
+// src/services/auth.ts
+async function promptForPat() {
+  if (!process.stdin.isTTY) {
+    return null;
+  }
+  return new Promise((resolve2) => {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stderr
+    });
+    process.stderr.write("Enter your Azure DevOps PAT: ");
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    let pat = "";
+    const onData = (key) => {
+      const ch = key.toString("utf8");
+      if (ch === "") {
+        process.stdin.setRawMode(false);
+        process.stdin.removeListener("data", onData);
+        rl.close();
+        process.stderr.write("\n");
+        resolve2(null);
+      } else if (ch === "\r" || ch === "\n") {
+        process.stdin.setRawMode(false);
+        process.stdin.removeListener("data", onData);
+        rl.close();
+        process.stderr.write("\n");
+        resolve2(pat);
+      } else if (ch === "\x7F" || ch === "\b") {
+        if (pat.length > 0) {
+          pat = pat.slice(0, -1);
+          process.stderr.write("\b \b");
+        }
+      } else {
+        pat += ch;
+        process.stderr.write("*");
+      }
+    };
+    process.stdin.on("data", onData);
+  });
+}
+async function resolvePat() {
+  const envPat = process.env.AZDO_PAT;
+  if (envPat) {
+    return { pat: envPat, source: "env" };
+  }
+  const storedPat = await getPat();
+  if (storedPat !== null) {
+    return { pat: storedPat, source: "credential-store" };
+  }
+  const promptedPat = await promptForPat();
+  if (promptedPat !== null) {
+    await storePat(promptedPat);
+    return { pat: promptedPat, source: "prompt" };
+  }
+  throw new Error(
+    "Authentication cancelled. Set AZDO_PAT environment variable or run again to enter a PAT."
+  );
+}
+
+// src/services/git-remote.ts
+import { execSync } from "child_process";
+var patterns = [
+  // HTTPS (current): https://dev.azure.com/{org}/{project}/_git/{repo}
+  /^https?:\/\/dev\.azure\.com\/([^/]+)\/([^/]+)\/_git\/.+$/,
+  // HTTPS (legacy + DefaultCollection): https://{org}.visualstudio.com/DefaultCollection/{project}/_git/{repo}
+  /^https?:\/\/([^.]+)\.visualstudio\.com\/DefaultCollection\/([^/]+)\/_git\/.+$/,
+  // HTTPS (legacy): https://{org}.visualstudio.com/{project}/_git/{repo}
+  /^https?:\/\/([^.]+)\.visualstudio\.com\/([^/]+)\/_git\/.+$/,
+  // SSH (current): git@ssh.dev.azure.com:v3/{org}/{project}/{repo}
+  /^git@ssh\.dev\.azure\.com:v3\/([^/]+)\/([^/]+)\/.+$/,
+  // SSH (legacy): {org}@vs-ssh.visualstudio.com:v3/{org}/{project}/{repo}
+  /^[^@]+@vs-ssh\.visualstudio\.com:v3\/([^/]+)\/([^/]+)\/.+$/
+];
+function parseAzdoRemote(url) {
+  for (const pattern of patterns) {
+    const match = url.match(pattern);
+    if (match) {
+      return { org: match[1], project: match[2] };
+    }
+  }
+  return null;
+}
+function detectAzdoContext() {
+  let remoteUrl;
+  try {
+    remoteUrl = execSync("git remote get-url origin", { encoding: "utf-8" }).trim();
+  } catch {
+    throw new Error("Not in a git repository. Provide --org and --project explicitly.");
+  }
+  const context = parseAzdoRemote(remoteUrl);
+  if (!context) {
+    throw new Error('Git remote "origin" is not an Azure DevOps URL. Provide --org and --project explicitly.');
+  }
+  return context;
+}
+
+// src/commands/get-item.ts
+function stripHtml(html) {
+  let text = html;
+  text = text.replace(/<br\s*\/?>/gi, "\n");
+  text = text.replace(/<\/?(p|div)>/gi, "\n");
+  text = text.replace(/<li>/gi, "\n");
+  text = text.replace(/<[^>]*>/g, "");
+  text = text.replace(/&amp;/g, "&");
+  text = text.replace(/&lt;/g, "<");
+  text = text.replace(/&gt;/g, ">");
+  text = text.replace(/&quot;/g, '"');
+  text = text.replace(/&#39;/g, "'");
+  text = text.replace(/&nbsp;/g, " ");
+  text = text.replace(/\n{3,}/g, "\n\n");
+  return text.trim();
+}
+function formatWorkItem(workItem, short) {
+  const lines = [];
+  const label = (name) => name.padEnd(13);
+  lines.push(`${label("ID:")}${workItem.id}`);
+  lines.push(`${label("Type:")}${workItem.type}`);
+  lines.push(`${label("Title:")}${workItem.title}`);
+  lines.push(`${label("State:")}${workItem.state}`);
+  lines.push(`${label("Assigned To:")}${workItem.assignedTo ?? "Unassigned"}`);
+  if (!short) {
+    lines.push(`${label("Area:")}${workItem.areaPath}`);
+    lines.push(`${label("Iteration:")}${workItem.iterationPath}`);
+  }
+  lines.push(`${label("URL:")}${workItem.url}`);
+  lines.push("");
+  const descriptionText = workItem.description ? stripHtml(workItem.description) : "";
+  if (short) {
+    const descLines = descriptionText.split("\n").filter((l) => l.trim() !== "");
+    const firstThree = descLines.slice(0, 3);
+    const truncated = descLines.length > 3;
+    const descSummary = firstThree.join("\n") + (truncated ? "\n..." : "");
+    lines.push(`${label("Description:")}${descSummary}`);
+  } else {
+    lines.push("Description:");
+    lines.push(descriptionText);
+  }
+  return lines.join("\n");
+}
+function createGetItemCommand() {
+  const command = new Command("get-item");
+  command.description("Retrieve an Azure DevOps work item by ID").argument("<id>", "work item ID").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--short", "show abbreviated output").action(
+    async (idStr, options) => {
+      const id = parseInt(idStr, 10);
+      if (!Number.isInteger(id) || id <= 0) {
+        process.stderr.write(
+          `Error: Work item ID must be a positive integer. Got: "${idStr}"
+`
+        );
+        process.exit(1);
+      }
+      const hasOrg = options.org !== void 0;
+      const hasProject = options.project !== void 0;
+      if (hasOrg !== hasProject) {
+        process.stderr.write(
+          "Error: --org and --project must both be provided, or both omitted.\n"
+        );
+        process.exit(1);
+      }
+      let context;
+      try {
+        if (options.org && options.project) {
+          context = { org: options.org, project: options.project };
+        } else {
+          context = detectAzdoContext();
+        }
+        const credential = await resolvePat();
+        const workItem = await getWorkItem(context, id, credential.pat);
+        const output = formatWorkItem(workItem, options.short ?? false);
+        process.stdout.write(output + "\n");
+      } catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        const msg = error.message;
+        if (msg === "AUTH_FAILED") {
+          process.stderr.write(
+            'Error: Authentication failed. Check that your PAT is valid and has the "Work Items (read)" scope.\n'
+          );
+        } else if (msg === "NOT_FOUND") {
+          process.stderr.write(
+            `Error: Work item ${id} not found in ${context.org}/${context.project}.
+`
+          );
+        } else if (msg === "PERMISSION_DENIED") {
+          process.stderr.write(
+            `Error: Access denied. Your PAT may lack permissions for project "${context.project}".
+`
+          );
+        } else if (msg === "NETWORK_ERROR") {
+          process.stderr.write(
+            "Error: Could not connect to Azure DevOps. Check your network connection.\n"
+          );
+        } else if (msg.includes("Not in a git repository") || msg.includes("is not an Azure DevOps URL") || msg.includes("Authentication cancelled")) {
+          process.stderr.write(`Error: ${msg}
+`);
+        } else {
+          process.stderr.write(`Error: ${msg}
+`);
+        }
+        process.exit(1);
+      }
+    }
+  );
+  return command;
+}
+
 // src/index.ts
-var program = new Command();
+var program = new Command2();
 program.name("azdo").description("Azure DevOps CLI tool").version(version, "-v, --version");
+program.addCommand(createGetItemCommand());
 program.showHelpAfterError();
 program.parse();
 if (process.argv.length <= 2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.2.0-001-azdo-cli-base.5",
+  "version": "0.2.0-002-get-item-command.10",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {
@@ -22,6 +22,7 @@
   },
   "license": "MIT",
   "dependencies": {
+    "@napi-rs/keyring": "^1.2.0",
     "commander": "^14.0.3"
   },
   "devDependencies": {