@senad-d/branchme 0.1.1

package/docs/STRUCTURE.md

@@ -0,0 +1,82 @@
+# BranchMe Structure Guide
+
+BranchMe is a TypeScript Pi extension package for current-repository git branch, push, and GitHub pull request workflows.
+
+## Source layout
+
+```text
+src/
+├── extension.ts                  # extension entry point; registers command and tools only
+├── constants.ts                  # command/tool names, timeouts, GitHub API constants
+├── types.ts                      # serializable tool details and helper result types
+├── commands/
+│   └── branchme-command.ts       # /branchme status/help command; informational only
+├── tools/
+│   └── branchme-tools.ts         # branch_status/change_branch/create_branch/push_branch/pull_request registration
+├── git.ts                        # argv-style git helpers and per-repo workflow queue
+├── github.ts                     # GitHub repo resolution, env/.env tokens, branch preflight, REST calls, redaction
+└── ui/
+    └── branchme-panel.ts         # compact /branchme status panel renderer
+```
+
+## Module boundaries
+
+1. `src/extension.ts` stays small and only calls `registerBranchMeCommand(pi)` and `registerBranchMeTools(pi)`.
+2. `src/commands/branchme-command.ts` parses `/branchme`, `/branchme help`, `--help`, and `-h`; it never performs git or GitHub mutations and avoids raw stdout in JSON mode.
+3. `src/tools/branchme-tools.ts` owns TypeBox schemas, prompt metadata, tool content, and safe structured details.
+4. `src/git.ts` owns current-repository git behavior: root detection, branch/upstream/status inspection, branch validation, branch creation, existing-local-branch switching, clean-worktree preflight, current-branch push/publish, and the per-repository workflow queue.
+5. `src/github.ts` owns GitHub `owner/repo` parsing, repository boundary checks, `GITHUB_TOKEN`/`GH_TOKEN` process-env and hardened git-root `.env` fallback resolution, PR branch-name syntax validation, GitHub branch visibility/commit preflight, PR REST calls, response validation, and redacted errors.
+6. `src/redaction.ts` owns shared credential redaction for Git and GitHub messages.
+7. `src/types.ts` keeps serializable details shared by helpers and tools.
+8. `src/ui/branchme-panel.ts` renders a compact status panel and clips lines to terminal width.
+
+## Pi extension conventions
+
+- No long-lived processes, watchers, timers, sockets, or background jobs start in the extension factory.
+- Slash commands are informational; tools perform branch, push, and PR actions.
+- Every tool uses a strict TypeBox object schema with `additionalProperties: false`.
+- Every tool defines a description, `promptSnippet`, and tool-specific `promptGuidelines` that explicitly name the tool.
+- Git commands use `pi.exec("git", args, { cwd, signal, timeout })` with argv arrays; repository mutations run from the verified git root and same-repository mutation/PR windows are serialized per repository.
+- Tool details avoid token values and unbounded raw command/API output.
+- Pi core packages, including `@earendil-works/pi-tui` for key/width utilities, remain in `peerDependencies` with `"*"`.
+
+## Security-sensitive areas
+
+- `change_branch` mutates local HEAD and working-tree files only through `git switch <branchName>` for existing local branches after a clean-worktree preflight.
+- `create_branch` mutates local branch/HEAD only with `git switch -c`.
+- `push_branch` mutates remote refs only for the current branch and uses an explicit upstream remote/refspec instead of bare `git push` when an upstream exists.
+- `pull_request` requires `headBranch` and `baseBranch` to exist locally, requires `headBranch` to match the GitHub-visible branch commit, queues behind already-started same-repository git mutation windows, makes GitHub REST API calls for the resolved current repository only, and rejects missing, owner-prefixed, or unsafe branch refs before token lookup or the request.
+- `pull_request` reads `GITHUB_TOKEN` or `GH_TOKEN` from process environment first; only when neither process token is set does it read those token keys from a small regular `.env` file in the verified git root as a fallback.
+- BranchMe does not force checkout, stash, stage, commit, directly edit files, read non-token `.env` keys, follow unsafe `.env` file types, depend on GitHub CLI, or collect telemetry.
+
+## Documentation
+
+- `docs/PROJECT_DEFINITION_BRIEF.md` preserves the approved project definition.
+- `docs/STRUCTURE.md` describes the implemented source layout.
+- `docs/SMOKE_TEST.md` records isolated validation/smoke-test findings.
+- `docs/TUI_CAPTURE.md` stores deterministic text captures of BranchMe TUI/help surfaces for visual regression review.
+
+## Tests
+
+```text
+test/
+├── command.test.mjs      # /branchme parsing, help, fallback, panel width
+├── git.test.mjs          # git helper command construction and failures
+├── git-integration.test.mjs # isolated real-git branch helper coverage
+├── github.test.mjs       # GitHub parsing, token resolution, fetch wrapper, redaction
+├── preparation.test.mjs  # package/docs/source metadata checks
+├── tools.test.mjs        # extension registration, schemas, prompt metadata, tool behavior
+└── tui-capture.test.mjs  # generated text capture for TUI/help visual baselines
+```
+
+Validation commands:
+
+```bash
+npm run typecheck
+npm run format:check
+npm run test
+npm run check:pack
+npm run validate
+npm run smoke:pi:packed # release gate for the installed npm artifact
+pi --no-extensions -e .
+```

package/docs/TUI_CAPTURE.md

@@ -0,0 +1,209 @@
+# BranchMe TUI Capture
+
+This file is a deterministic text capture of BranchMe user-facing TUI/help surfaces.
+Use it as a visual baseline when improving layout, wording, spacing, or responsive behavior.
+Trailing spaces are shown as `·` so formatting checks can keep the repository whitespace-clean.
+
+Generated and verified by `test/tui-capture.test.mjs`.
+Update intentionally with:
+
+```text
+UPDATE_TUI_CAPTURE=1 node --test test/tui-capture.test.mjs
+```
+
+## /branchme help
+
+```text
+# BranchMe
+
+Current-repository branch workflow tools for Pi.
+
+Commands only show info; BranchMe tools perform actions.
+
+## Workflow
+
+1. `branch_status` — inspect repo and branch state.
+2. `change_branch` / `create_branch` — switch to an existing clean branch or create one from `HEAD`.
+3. Commit outside BranchMe.
+4. `push_branch` — push the current branch.
+5. `pull_request` — open a PR after `push_branch` completes and GitHub sees the branches.
+
+## Requirements
+
+- Run inside a Git repo with `git` available.
+- For PRs: GitHub `origin` and `GITHUB_TOKEN` or `GH_TOKEN` (environment or `.env`).
+- BranchMe never stages or commits.
+```
+
+## Panel: Tiny mode: clean branch with token
+
+Width: 18
+
+```text
+BranchMe
+branch: feature/c…
+repo: senad-d/bra…
+q quit
+```
+
+## Panel: Narrow mode: clean branch with token
+
+Width: 40
+
+```text
+╭ BranchMe ──────────────────── Status ╮
+│current repo only • informational     │
+│ ↑↓ section • q quit • /branchme help │
+├──────────────────────────────────────┤
+│ STATUS                               │
+│  Current branch:    feature/current  │
+│  GitHub repository: senad-d/branchme │
+│  GitHub token:      present          │
+│                                      │
+│                                      │
+│                                      │
+├──────────────────────────────────────┤
+│ 1/2 • status • current repository on…│
+╰──────────────────────────────────────╯
+```
+
+## Panel: Wide mode: Status selected
+
+Width: 80
+
+```text
+╭ BranchMe ──────────────────────────────────────────────────────────── Status ╮
+│ ↑↓ section • q quit • /branchme help                                         │
+├─────────────────────┬────────────────────────────────────────────────────────┤
+│▶  Status            │ STATUS                                                 │
+│   Workflow          │  Current branch:    feature/current                    │
+│                     │  GitHub repository: senad-d/branchme                   │
+│                     │  GitHub token:      present                            │
+│                     │                                                        │
+│                     │                                                        │
+│                     │                                                        │
+├─────────────────────┴────────────────────────────────────────────────────────┤
+│ 1/2 • status • current repository only • tools perform actions               │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Panel: Wide mode: Workflow selected
+
+Width: 80
+
+```text
+╭ BranchMe ────────────────────────────────────────────────────────── Workflow ╮
+│ ↑↓ section • q quit • /branchme help                                         │
+├─────────────────────┬────────────────────────────────────────────────────────┤
+│   Status            │ WORKFLOW                                               │
+│▶  Workflow          │  branch_status  -> inspect                             │
+│                     │  change_branch  -> existing local                      │
+│                     │  create_branch  -> from HEAD                           │
+│                     │  push_branch    -> current branch                      │
+│                     │  pull_request   -> after push                          │
+│                     │                                                        │
+├─────────────────────┴────────────────────────────────────────────────────────┤
+│ 2/2 • workflow • inspect → change/create → push → PR                         │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Panel: Very wide terminal: panel width capped
+
+Width: 112
+
+```text
+╭ BranchMe ──────────────────────────────────────────────────────────────────────────── Status ╮
+│ ↑↓ section • q quit • /branchme help                                                         │
+├──────────────────────┬───────────────────────────────────────────────────────────────────────┤
+│▶  Status             │ STATUS                                                                │
+│   Workflow           │  Current branch:    main                                              │
+│                      │  GitHub repository: senad-d/BranchMe                                  │
+│                      │  GitHub token:      not set                                           │
+│                      │                                                                       │
+│                      │                                                                       │
+│                      │                                                                       │
+├──────────────────────┴───────────────────────────────────────────────────────────────────────┤
+│ 1/2 • status • current repository only • tools perform actions                               │
+╰──────────────────────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Panel: Fallback values: detached HEAD without repository or token
+
+Width: 50
+
+```text
+╭ BranchMe ────────────────────────────── Status ╮
+│current repo only • informational               │
+│ ↑↓ section • q quit • /branchme help           │
+├────────────────────────────────────────────────┤
+│ STATUS                                         │
+│  Current branch:    detached HEAD              │
+│  GitHub repository: not resolved               │
+│  GitHub token:      not set                    │
+│                                                │
+│                                                │
+│                                                │
+├────────────────────────────────────────────────┤
+│ 1/2 • warning • Unable to resolve a GitHub rep…│
+╰────────────────────────────────────────────────╯
+```
+
+## Panel: Repository warning: boundary mismatch
+
+Width: 80
+
+```text
+╭ BranchMe ──────────────────────────────────────────────────────────── Status ╮
+│ ↑↓ section • q quit • /branchme help                                         │
+├─────────────────────┬────────────────────────────────────────────────────────┤
+│▶  Status            │ STATUS                                                 │
+│   Workflow          │  Current branch:    main                               │
+│                     │  GitHub repository: warning: Repository boundary misma…│
+│                     │  GitHub token:      present                            │
+│                     │                                                        │
+│                     │                                                        │
+│                     │                                                        │
+├─────────────────────┴────────────────────────────────────────────────────────┤
+│ 1/2 • warning • Repository boundary mismatch: local origin resolves to senad…│
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Panel: Token warning: fallback error
+
+Width: 72
+
+```text
+╭ BranchMe ──────────────────────────────────────────────────── Status ╮
+│ ↑↓ section • q quit • /branchme help                                 │
+├───────────────────┬──────────────────────────────────────────────────┤
+│▶  Status          │ STATUS                                           │
+│   Workflow        │  Current branch:    main                         │
+│                   │  GitHub repository: senad-d/branchme             │
+│                   │  GitHub token:      warning: Unable to read .env…│
+│                   │                                                  │
+│                   │                                                  │
+│                   │                                                  │
+├───────────────────┴──────────────────────────────────────────────────┤
+│ 1/2 • warning • Unable to read .env file for GitHub token fallback: …│
+╰──────────────────────────────────────────────────────────────────────╯
+```
+
+## Panel: Long values: truncation
+
+Width: 72
+
+```text
+╭ BranchMe ──────────────────────────────────────────────────── Status ╮
+│ ↑↓ section • q quit • /branchme help                                 │
+├───────────────────┬──────────────────────────────────────────────────┤
+│▶  Status          │ STATUS                                           │
+│   Workflow        │  Current branch:    feature/super-long-branch-na…│
+│                   │  GitHub repository: very-long-owner-name/very-lo…│
+│                   │  GitHub token:      present                      │
+│                   │                                                  │
+│                   │                                                  │
+│                   │                                                  │
+├───────────────────┴──────────────────────────────────────────────────┤
+│ 1/2 • warning • This deliberately long status note is captured to de…│
+╰──────────────────────────────────────────────────────────────────────╯
+```

package/img/icon.svg

@@ -0,0 +1,28 @@
+<svg width="1024" height="1024" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="bg" x1="160" y1="120" x2="864" y2="904" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#111827"/>
+      <stop offset="1" stop-color="#0F766E"/>
+    </linearGradient>
+  </defs>
+
+  <!-- App tile -->
+  <rect x="96" y="96" width="832" height="832" rx="208" fill="url(#bg)"/>
+
+  <!-- Main branch shape -->
+  <path d="M344 704V320" stroke="#F8FAFC" stroke-width="72" stroke-linecap="round"/>
+  <path d="M344 512H512C604 512 680 436 680 344" stroke="#F8FAFC" stroke-width="72" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M344 512H512C604 512 680 588 680 680" stroke="#F8FAFC" stroke-width="72" stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- Nodes -->
+  <circle cx="344" cy="320" r="72" fill="#34D399"/>
+  <circle cx="344" cy="704" r="72" fill="#38BDF8"/>
+  <circle cx="680" cy="344" r="72" fill="#38BDF8"/>
+  <circle cx="680" cy="680" r="72" fill="#34D399"/>
+
+  <!-- Inner node cutouts for a clean Git-like look -->
+  <circle cx="344" cy="320" r="30" fill="#111827" opacity="0.9"/>
+  <circle cx="344" cy="704" r="30" fill="#111827" opacity="0.9"/>
+  <circle cx="680" cy="344" r="30" fill="#111827" opacity="0.9"/>
+  <circle cx="680" cy="680" r="30" fill="#111827" opacity="0.9"/>
+</svg>

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@senad-d/branchme",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "Minimal Pi extension for current-repository git branch, push, and pull request workflows.",
+  "license": "MIT",
+  "author": "Senad Dizdarević <112484166+senad-d@users.noreply.github.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/senad-d/branchme.git"
+  },
+  "bugs": {
+    "url": "https://github.com/senad-d/branchme/issues"
+  },
+  "homepage": "https://github.com/senad-d/branchme#readme",
+  "keywords": [
+    "pi",
+    "pi-package",
+    "pi-extension",
+    "pi-coding-agent",
+    "branchme",
+    "git",
+    "git-branch",
+    "git-workflow",
+    "github",
+    "github-pr",
+    "pull-request",
+    "branch-workflow",
+    "automation",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "files": [
+    ".env.example",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md",
+    "CHANGELOG.md",
+    "docs/**/*.md",
+    "img/**/*",
+    "src/**/*.ts",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "dev": "pi --no-extensions -e .",
+    "typecheck": "tsc --noEmit",
+    "lint": "npm run typecheck && npm run format:check && npm run check",
+    "format:check": "node scripts/check-format.mjs",
+    "test": "node --test test/*.test.mjs",
+    "smoke:pi": "node scripts/smoke-pi-runtime.mjs",
+    "smoke:pi:packed": "node scripts/smoke-pi-installed-package.mjs",
+    "check": "node --check scripts/check-format.mjs && node --check scripts/check-package-contents.mjs && node --check scripts/publish-npm.mjs && node --check scripts/smoke-pi-installed-package.mjs && node --check scripts/smoke-pi-runtime.mjs",
+    "pack:dry-run": "npm pack --dry-run --json",
+    "check:pack": "node scripts/check-package-contents.mjs",
+    "validate": "npm run typecheck && npm run format:check && npm run test && npm run smoke:pi && npm run check && npm run check:pack",
+    "release:check": "npm run validate && npm run smoke:pi:packed"
+  },
+  "pi": {
+    "extensions": [
+      "./src/extension.ts"
+    ],
+    "image": "https://raw.githubusercontent.com/senad-d/BranchMe/main/img/demo.gif"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.80.2",
+    "@earendil-works/pi-tui": "^0.80.2",
+    "@types/node": "^26.0.1",
+    "typebox": "^1.2.18",
+    "typescript": "^6.0.3"
+  }
+}

package/src/commands/branchme-command.ts

@@ -0,0 +1,166 @@
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { BRANCHME_COMMAND_NAME, EXTENSION_DISPLAY_NAME } from "../constants.ts";
+import { getBranchStatus } from "../git.ts";
+import { redactSecrets, repositoryLabel, resolveGitHubRepository, resolveGitHubToken } from "../github.ts";
+import { BranchMePanel, type BranchMePanelData } from "../ui/branchme-panel.ts";
+
+export type BranchMeCommandMode = "panel" | "help" | "unsupported";
+
+function firstBranchMeArgumentLine(args: string): string {
+  return args.split(/\r?\n/u, 1)[0] ?? "";
+}
+
+export function parseBranchMeArgs(args: string): BranchMeCommandMode {
+  const normalized = firstBranchMeArgumentLine(args).trim().toLowerCase();
+  if (!normalized) return "panel";
+  if (normalized === "help" || normalized === "--help" || normalized === "-h") return "help";
+  return "unsupported";
+}
+
+export function formatUnsupportedBranchMeArgument(args: string): string {
+  return `Unknown /branchme argument ${JSON.stringify(firstBranchMeArgumentLine(args).trim())}. Use /branchme help.`;
+}
+
+export function getBranchMeHelpText(): string {
+  return [
+    "# BranchMe",
+    "",
+    "Current-repository branch workflow tools for Pi.",
+    "",
+    "Commands only show info; BranchMe tools perform actions.",
+    "",
+    "## Workflow",
+    "",
+    "1. `branch_status` — inspect repo and branch state.",
+    "2. `change_branch` / `create_branch` — switch to an existing clean branch or create one from `HEAD`.",
+    "3. Commit outside BranchMe.",
+    "4. `push_branch` — push the current branch.",
+    "5. `pull_request` — open a PR after `push_branch` completes and GitHub sees the branches.",
+    "",
+    "## Requirements",
+    "",
+    "- Run inside a Git repo with `git` available.",
+    "- For PRs: GitHub `origin` and `GITHUB_TOKEN` or `GH_TOKEN` (environment or `.env`).",
+    "- BranchMe never stages or commits.",
+  ].join("\n");
+}
+
+function emitCommandMessage(ctx: ExtensionCommandContext, message: string, level: "info" | "warning" | "error" = "info"): void {
+  if (ctx.hasUI) {
+    ctx.ui.notify(message, level);
+    return;
+  }
+
+  if (ctx.mode === "print") {
+    console.log(message);
+  }
+}
+
+function safeWarningText(error: unknown): string {
+  return redactSecrets(error instanceof Error ? error.message : String(error));
+}
+
+function repositoryWarningFromError(error: unknown): string | null {
+  const message = safeWarningText(error);
+  if (/Unable to resolve a GitHub repository from origin or GITHUB_REPOSITORY/iu.test(message)) return null;
+  if (/Not a git repository/iu.test(message)) return null;
+  return message;
+}
+
+function tokenWarningFromError(error: unknown): string | null {
+  const message = safeWarningText(error);
+  if (/GitHub token is required\. Set GITHUB_TOKEN or GH_TOKEN/iu.test(message)) return null;
+  return message;
+}
+
+function hasPanelWarning(data: BranchMePanelData): boolean {
+  return Boolean(data.statusNote || data.repositoryWarning || data.tokenWarning);
+}
+
+function summaryRepository(data: BranchMePanelData): string {
+  return data.repositoryWarning ? `warning: ${data.repositoryWarning}` : data.githubRepository ?? "not resolved";
+}
+
+function summaryToken(data: BranchMePanelData): string {
+  return data.tokenWarning ? `warning: ${data.tokenWarning}` : data.tokenSource ? `present (${data.tokenSource})` : "not set";
+}
+
+function summaryStatusWarning(data: BranchMePanelData): string {
+  return data.statusNote ? `; warning: ${data.statusNote}` : "";
+}
+
+async function collectPanelData(
+  pi: Pick<ExtensionAPI, "exec">,
+  ctx: ExtensionCommandContext,
+): Promise<BranchMePanelData> {
+  const data: BranchMePanelData = {
+    currentBranch: null,
+    detached: false,
+    githubRepository: null,
+    tokenSource: null,
+  };
+
+  let tokenLookupCwd: string | undefined;
+  try {
+    const status = await getBranchStatus(pi, ctx, ctx.signal);
+    data.currentBranch = status.currentBranch;
+    data.detached = status.detached;
+    tokenLookupCwd = status.repoRoot;
+  } catch (error) {
+    data.statusNote = safeWarningText(error);
+  }
+
+  if (!data.statusNote) {
+    try {
+      const repository = await resolveGitHubRepository(pi, ctx, ctx.signal);
+      data.githubRepository = repositoryLabel(repository);
+    } catch (error) {
+      data.githubRepository = null;
+      data.repositoryWarning = repositoryWarningFromError(error) ?? undefined;
+    }
+  }
+
+  try {
+    data.tokenSource = (await resolveGitHubToken(process.env, { cwd: tokenLookupCwd, signal: ctx.signal })).source;
+  } catch (error) {
+    data.tokenSource = null;
+    data.tokenWarning = tokenWarningFromError(error) ?? undefined;
+  }
+
+  return data;
+}
+
+async function showPanel(pi: Pick<ExtensionAPI, "exec">, ctx: ExtensionCommandContext): Promise<void> {
+  const data = await collectPanelData(pi, ctx);
+
+  if (ctx.mode !== "tui") {
+    const branch = data.detached ? "detached HEAD" : data.currentBranch ?? "unknown";
+    emitCommandMessage(
+      ctx,
+      `${EXTENSION_DISPLAY_NAME}: branch ${branch}; GitHub repository ${summaryRepository(data)}; token ${summaryToken(data)}${summaryStatusWarning(data)}.`,
+      hasPanelWarning(data) ? "warning" : "info",
+    );
+    return;
+  }
+
+  await ctx.ui.custom<void>((tui, theme, _keybindings, done) => new BranchMePanel(data, theme, () => done(undefined), () => tui.requestRender()));
+}
+
+export function registerBranchMeCommand(pi: Pick<ExtensionAPI, "registerCommand" | "exec">): void {
+  pi.registerCommand(BRANCHME_COMMAND_NAME, {
+    description: "Show BranchMe status and help",
+    handler: async (args, ctx) => {
+      const mode = parseBranchMeArgs(args);
+      if (mode === "help") {
+        emitCommandMessage(ctx, getBranchMeHelpText(), "info");
+        return;
+      }
+      if (mode === "unsupported") {
+        emitCommandMessage(ctx, formatUnsupportedBranchMeArgument(args), "warning");
+        return;
+      }
+
+      await showPanel(pi, ctx);
+    },
+  });
+}

package/src/constants.ts

@@ -0,0 +1,27 @@
+export const EXTENSION_DISPLAY_NAME = "BranchMe";
+export const BRANCHME_COMMAND_NAME = "branchme";
+
+export const BRANCH_STATUS_TOOL_NAME = "branch_status";
+export const CREATE_BRANCH_TOOL_NAME = "create_branch";
+export const CHANGE_BRANCH_TOOL_NAME = "change_branch";
+export const PUSH_BRANCH_TOOL_NAME = "push_branch";
+export const PULL_REQUEST_TOOL_NAME = "pull_request";
+
+export const BRANCHME_TOOL_NAMES = [
+  BRANCH_STATUS_TOOL_NAME,
+  CREATE_BRANCH_TOOL_NAME,
+  CHANGE_BRANCH_TOOL_NAME,
+  PUSH_BRANCH_TOOL_NAME,
+  PULL_REQUEST_TOOL_NAME,
+] as const;
+
+export const GIT_STATUS_TIMEOUT_MS = 5_000;
+export const GIT_MUTATION_TIMEOUT_MS = 30_000;
+export const GIT_PUSH_TIMEOUT_MS = 120_000;
+
+export const GITHUB_API_BASE_URL = "https://api.github.com";
+export const GITHUB_API_VERSION = "2022-11-28";
+export const GITHUB_USER_AGENT = "BranchMe Pi extension";
+
+export const MAX_SUMMARY_OUTPUT_CHARS = 4_000;
+export const GITHUB_RESPONSE_BODY_LIMIT_BYTES = 64 * 1024;

package/src/extension.ts

@@ -0,0 +1,10 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { registerBranchMeCommand } from "./commands/branchme-command.ts";
+import { registerBranchMeTools } from "./tools/branchme-tools.ts";
+
+export function branchMeExtension(pi: ExtensionAPI): void {
+  registerBranchMeCommand(pi);
+  registerBranchMeTools(pi);
+}
+
+export default branchMeExtension;