@senad-d/branchme 0.2.2 → 0.3.1

package/src/tools/branchme-tools.ts

@@ -1,4 +1,5 @@
 import { StringEnum } from "@earendil-works/pi-ai";
+import { registerWorkflowTools } from "./workflow-tools.ts";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import {
@@ -7,10 +8,14 @@ import {
   CREATE_BRANCH_TOOL_NAME,
   CREATE_WORKTREE_TOOL_NAME,
   FETCH_BRANCH_TOOL_NAME,
+  GIT_BRANCH_SUMMARY_LIMIT_CHARS,
   GIT_INTEGRATION_SUMMARY_LIMIT_CHARS,
   GIT_RETIREMENT_SUMMARY_LIMIT_CHARS,
   GIT_WORKTREE_SUMMARY_LIMIT_CHARS,
+  INIT_REPOSITORY_TOOL_NAME,
   INTEGRATE_BRANCH_TOOL_NAME,
+  LAND_BRANCH_TOOL_NAME,
+  LIST_BRANCHES_TOOL_NAME,
   LIST_WORKTREES_TOOL_NAME,
   PULL_BRANCH_TOOL_NAME,
   PULL_REQUEST_TOOL_NAME,
@@ -29,6 +34,8 @@ import {
   getLocalBranchCommit,
   getPullRequestCommitSubjects,
   inferPullRequestBaseBranch,
+  initializeRepository,
+  listBranches,
   listWorktrees,
   localBranchExists,
   pullCurrentBranch,
@@ -42,8 +49,9 @@ import {
 import { collectGitContext, formatGitContext } from "../git-context.ts";
 import { integrateBranch } from "../git-integration.ts";
 import { retireBranch } from "../git-retirement.ts";
+import { formatLandBranch, landBranch } from "../git-landing.ts";
 import {
-  createGitHubPullRequest,
+  createOrReuseGitHubPullRequest,
   ensureGitHubBranchExists,
   redactSecrets,
   repositoryLabel,
@@ -56,9 +64,9 @@ import type {
   ChangeBranchDetails,
   CreateWorktreeDetails,
   GitContextDetails,
+  InitRepositoryDetails,
   IntegrateBranchDetails,
   ListWorktreesDetails,
-  PullRequestDetails,
   PullRequestInput,
   PullRequestInputField,
   PullRequestToolDetails,
@@ -70,6 +78,16 @@ import type {
 
 const EmptyParametersSchema = Type.Object({}, { additionalProperties: false });
 
+const InitRepositoryParametersSchema = Type.Object(
+  {
+    initialBranch: Type.Optional(Type.String({
+      minLength: 1,
+      description: "Initial unborn branch name; defaults to main.",
+    })),
+  },
+  { additionalProperties: false },
+);
+
 const BranchStatusParametersSchema = Type.Object(
   {
     ancestry: Type.Optional(
@@ -106,6 +124,17 @@ const RetireBranchParametersSchema = Type.Object(
   { additionalProperties: false },
 );
 
+const LandBranchParametersSchema = Type.Object(
+  {
+    sourceBranch: Type.String({ minLength: 1, description: "Merged local feature branch to delete, or its name on an idempotent retry." }),
+    targetBranch: Type.String({ minLength: 1, description: "Local default branch to fast-forward after cleanup." }),
+    remote: Type.Optional(Type.String({ minLength: 1, description: "Configured remote name; defaults to origin." })),
+    worktreePath: Type.Optional(Type.String({ minLength: 1, description: "Absolute linked-worktree path to remove, including one parked on targetBranch. Omit to find the source branch's worktree." })),
+    pullRequestNumber: Type.Optional(Type.Integer({ minimum: 1, description: "Merged GitHub PR number for exact host-merge evidence, required for squash/rebase merges without source ancestry." })),
+  },
+  { additionalProperties: false },
+);
+
 const CreateBranchParametersSchema = Type.Object(
   {
     branchName: Type.String({ minLength: 1, description: "Name of the new branch to create from current HEAD." }),
@@ -152,6 +181,9 @@ const FetchBranchParametersSchema = Type.Object(
 const RemoveWorktreeParametersSchema = Type.Object(
   {
     worktreePath: Type.String({ minLength: 1, description: "Explicit absolute path of the linked worktree to remove." }),
+    deleteIgnored: Type.Optional(Type.Boolean({
+      description: "Explicit authorization to delete ignored files and directories with the worktree; defaults to false.",
+    })),
   },
   { additionalProperties: false },
 );
@@ -188,9 +220,9 @@ export function formatChangeBranch(details: ChangeBranchDetails): string {
   return `Changed branch from ${previous} to ${details.currentBranch}.`;
 }
 
-export function formatPullRequest(details: PullRequestDetails, autofilledFields: PullRequestInputField[] = []): string {
+export function formatPullRequest(details: PullRequestToolDetails, autofilledFields: PullRequestInputField[] = []): string {
   const autofill = autofilledFields.length > 0 ? ` Autofilled fields: ${autofilledFields.join(", ")}.` : "";
-  return `Created pull request #${details.number} (${details.state}) for ${repositoryLabel(details.repository)}: ${details.url}.${autofill}`;
+  return `${details.outcome === "existing" ? "Reused existing" : "Created"} pull request #${details.number} (${details.state}) for ${repositoryLabel(details.repository)}: ${details.url}.${autofill}`;
 }
 
 const WORKTREE_FORMAT_PATH_LIMIT_CHARS = 512;
@@ -271,6 +303,12 @@ export function formatListWorktrees(details: ListWorktreesDetails): string {
   return lines.join("\n");
 }
 
+export function formatInitRepository(details: InitRepositoryDetails): string {
+  const root = safeWorktreeFormatValue(details.repoRoot, WORKTREE_FORMAT_PATH_LIMIT_CHARS);
+  const branch = safeWorktreeFormatValue(details.initialBranch, WORKTREE_FORMAT_BRANCH_LIMIT_CHARS);
+  return `Initialized non-bare Git repository at ${root} with unborn initial branch ${branch}. No files were staged or committed.`;
+}
+
 export function formatCreateWorktree(details: CreateWorktreeDetails): string {
   const cwd = safeWorktreeFormatValue(details.handoff.cwd, WORKTREE_FORMAT_PATH_LIMIT_CHARS);
   const branch = safeWorktreeFormatValue(details.handoff.branch, WORKTREE_FORMAT_BRANCH_LIMIT_CHARS);
@@ -506,6 +544,28 @@ async function requireGitHubHeadMatchesLocalBranch(
 }
 
 export function registerBranchMeTools(pi: Pick<ExtensionAPI, "registerTool" | "exec">, options: BranchMeToolOptions = {}): void {
+  registerWorkflowTools(pi, options);
+  pi.registerTool({
+    name: LIST_BRANCHES_TOOL_NAME,
+    label: "List Branches",
+    description: "list_branches reads up to 200 local and remote-tracking branches, including commits, upstream counts, symbolic refs, and worktree occupancy. Read-only; cached remote refs are not fetched. Text is bounded to 4000 characters.",
+    promptSnippet: "list_branches: discover local and cached remote-tracking branches without mutation",
+    promptGuidelines: [
+      "Use list_branches to discover names and worktree occupancy before branch operations; it never fetches or mutates Git state.",
+      "Treat list_branches names and paths as display metadata; redacted or truncated values are not executable identities.",
+    ],
+    parameters: EmptyParametersSchema,
+    async execute(_toolCallId, _params, signal, _onUpdate, ctx) {
+      const details = await listBranches(pi, ctx, signal);
+      const lines = details.branches.map((branch) =>
+        `${branch.current ? "*" : "-"} ${JSON.stringify(branch.name)} (${branch.kind}) ${shortCommit(branch.head)}; upstream ${JSON.stringify(branch.upstream)}; ahead ${branch.ahead ?? "?"}, behind ${branch.behind ?? "?"}; worktrees ${JSON.stringify(branch.worktreePaths)}`);
+      const text = [`Branches: ${details.branches.length}; omitted: ${details.omitted}.`, ...lines].join("\n");
+      return {
+        content: [{ type: "text", text: text.length <= GIT_BRANCH_SUMMARY_LIMIT_CHARS ? text : `${text.slice(0, GIT_BRANCH_SUMMARY_LIMIT_CHARS - 20)}\n[summary truncated]` }],
+        details,
+      };
+    },
+  });
   pi.registerTool({
     name: BRANCH_STATUS_TOOL_NAME,
     label: "Branch Status",
@@ -540,6 +600,27 @@ export function registerBranchMeTools(pi: Pick<ExtensionAPI, "registerTool" | "e
     },
   });
 
+  pi.registerTool({
+    name: INIT_REPOSITORY_TOOL_NAME,
+    label: "Initialize Repository",
+    description: "init_repository initializes the exact current working directory as a new non-bare Git repository with an unborn initial branch (default main). It rejects an existing .git entry, any directory already inside a Git repository, nested initialization, paths, bare/separate-Git-dir modes, templates, shared modes, staging, commits, remotes, and file creation outside Git metadata.",
+    promptSnippet: "init_repository: initialize the exact current working directory as a verified new non-bare Git repository",
+    promptGuidelines: [
+      "Use init_repository only when the user explicitly asks to initialize the current working directory as a new Git repository.",
+      "Use init_repository with optional initialBranch; it defaults to main and never accepts or infers a path, bare mode, separate Git directory, template, shared mode, remote, initial commit, README, or gitignore content.",
+      "init_repository rejects reinitialization and nested repositories; it creates only Git metadata and an unborn branch, then verifies the exact repository root and Git directory.",
+      "Call init_repository by itself and wait for verification before using repository-dependent Git tools.",
+    ],
+    parameters: InitRepositoryParametersSchema,
+    async execute(_toolCallId, params, signal, _onUpdate, ctx) {
+      const details = await initializeRepository(pi, ctx, params.initialBranch ?? "main", signal);
+      return {
+        content: [{ type: "text", text: formatInitRepository(details) }],
+        details,
+      };
+    },
+  });
+
   pi.registerTool({
     name: CREATE_BRANCH_TOOL_NAME,
     label: "Create Branch",
@@ -703,6 +784,29 @@ export function registerBranchMeTools(pi: Pick<ExtensionAPI, "registerTool" | "e
     },
   });
 
+  pi.registerTool({
+    name: LAND_BRANCH_TOOL_NAME,
+    label: "Land Branch",
+    description: "land_branch performs deterministic post-merge cleanup: fetch the remote target, prove source ancestry or verify exact merged GitHub PR evidence via pullRequestNumber, remove its clean linked worktree (including ignored residue), lease-delete the local source branch, then fast-forward the local target without switching branches. Returns a structured per-step receipt and one-line summary. No remote mutation, force, stash, reset, checkout, or prune; retries are idempotent. Diagnostics are redacted and bounded to 4000 characters each.",
+    promptSnippet: "land_branch: post-merge linked-worktree cleanup, leased source retirement, and independent fast-forward target sync with verified receipts",
+    promptGuidelines: [
+      "Use land_branch after the pull request merged on the host; supply pullRequestNumber for squash/rebase merges. It verifies exact merged PR head/base identities and containment of the merge commit in the fetched remote target.",
+      "Without pullRequestNumber, land_branch still requires source ancestry. PR evidence permits deletion of original source history after a squash/rebase merge; inspect the mergeProof receipt.",
+      "land_branch is cwd-independent; run from the repository root, never inside the worktree being removed.",
+      "land_branch deletes ignored files such as .env, .pi/, node_modules/, and dist/ with the worktree and lists their top-level entries in deletedIgnoredPaths; preserve anything needed beforehand.",
+      "land_branch target sync never touches a dirty checkout; skipped-dirty reports its path and ahead/behind counts, independently of cleanup outcomes.",
+      "Call land_branch by itself and inspect each receipt outcome; do not batch it with other Git mutations. It never switches branches or mutates remote branches.",
+    ],
+    parameters: LandBranchParametersSchema,
+    async execute(_toolCallId, params, signal, _onUpdate, ctx) {
+      const details = await landBranch(pi, ctx, params, signal, options);
+      return {
+        content: [{ type: "text", text: formatLandBranch(details) }],
+        details,
+      };
+    },
+  });
+
   pi.registerTool({
     name: PUSH_BRANCH_TOOL_NAME,
     label: "Push Branch",
@@ -738,6 +842,7 @@ export function registerBranchMeTools(pi: Pick<ExtensionAPI, "registerTool" | "e
       "Do not call push_branch and pull_request in the same tool batch; call pull_request only after push_branch has completed.",
       "Use pull_request only for the resolved current repository; pull_request never accepts owner, repo, or owner-prefixed branch refs.",
       "Use pull_request with GITHUB_TOKEN or GH_TOKEN from the process environment or local .env fallback; pull_request must not expose token values.",
+      "pull_request reuses an existing open PR only when its exact head commit and base match; it never updates existing title, body, or draft state.",
     ],
     parameters: PullRequestParametersSchema,
     async execute(_toolCallId, params, signal, _onUpdate, ctx) {
@@ -760,7 +865,7 @@ export function registerBranchMeTools(pi: Pick<ExtensionAPI, "registerTool" | "e
             fetchImpl: options.fetchImpl,
             signal,
           });
-          const details = await createGitHubPullRequest(repository, resolved.input, token, {
+          const details = await createOrReuseGitHubPullRequest(repository, resolved.input, headBranch.commitSha, token, {
             fetchImpl: options.fetchImpl,
             signal,
           });
@@ -830,16 +935,17 @@ export function registerBranchMeTools(pi: Pick<ExtensionAPI, "registerTool" | "e
   pi.registerTool({
     name: REMOVE_WORKTREE_TOOL_NAME,
     label: "Remove Worktree",
-    description: "remove_worktree force-free removes one verified clean linked worktree at an explicit absolute worktreePath while retaining and returning its exact local branch identity. remove_worktree rejects main, current, dirty, detached, locked, prunable, missing, and foreign worktrees and never deletes branches.",
-    promptSnippet: "remove_worktree: force-free removal of an explicitly selected clean linked worktree while retaining its branch",
+    description: "remove_worktree force-free removes one verified clean linked worktree at an explicit absolute worktreePath while retaining and returning its exact local branch identity. Ignored residue is refused by default; deleteIgnored: true explicitly authorizes deleting it with the worktree and reports its top-level paths. remove_worktree rejects main, current, dirty, detached, locked, prunable, missing, and foreign worktrees and never deletes branches.",
+    promptSnippet: "remove_worktree: force-free removal of an explicitly selected clean linked worktree, with optional explicit ignored-residue deletion, while retaining its branch",
     promptGuidelines: [
       "Use remove_worktree only when the user explicitly requests worktree removal and provides or approves the exact absolute worktreePath; remove_worktree must never infer a filesystem path silently.",
-      "Use remove_worktree with exactly worktreePath; remove_worktree never accepts force, move, prune, repair, lock, unlock, branch deletion, remote, or refspec parameters.",
+      "Use remove_worktree with worktreePath and optional deleteIgnored; set deleteIgnored: true only after the user explicitly authorizes deleting all ignored files and directories, including possible .env, .pi/, dependency, and build residue.",
+      "remove_worktree never accepts force, move, prune, repair, lock, unlock, branch deletion, remote, or refspec parameters.",
       "Do not batch remove_worktree with dependent worktree mutations; wait for remove_worktree to complete and verify its non-ready handoff before continuing.",
     ],
     parameters: RemoveWorktreeParametersSchema,
     async execute(_toolCallId, params, signal, _onUpdate, ctx) {
-      const details = await removeWorktree(pi, ctx, params.worktreePath, signal);
+      const details = await removeWorktree(pi, ctx, params.worktreePath, signal, params.deleteIgnored === true);
       return {
         content: [{ type: "text", text: formatRemoveWorktree(details) }],
         details,

package/src/tools/workflow-tools.ts

@@ -0,0 +1,86 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { PULL_REQUEST_STATUS_TOOL_NAME, TRACK_BRANCH_TOOL_NAME, UPDATE_FROM_BASE_TOOL_NAME } from "../constants.ts";
+import { getGitRoot, requireCurrentBranch } from "../git.ts";
+import { findGitHubPullRequest, getGitHubPullRequest, resolveGitHubRepository, resolveGitHubToken } from "../github.ts";
+import type { PullRequestStatusDetails } from "../types.ts";
+import type { BranchMeToolOptions } from "./branchme-tools.ts";
+import { trackBranch, updateFromBase } from "../git-workflow.ts";
+
+function formatPullRequestStatus(pullRequest: PullRequestStatusDetails | null): string {
+  if (!pullRequest) return "No matching pull request found.";
+  const state = pullRequest.merged ? "merged" : pullRequest.state;
+  const draft = pullRequest.draft ? " (draft)" : "";
+  return `PR #${pullRequest.number}: ${state}${draft}; ${pullRequest.head} -> ${pullRequest.base}. ${pullRequest.url}`;
+}
+
+export function registerWorkflowTools(pi: Pick<ExtensionAPI, "registerTool" | "exec">, options: BranchMeToolOptions = {}): void {
+  pi.registerTool({
+    name: PULL_REQUEST_STATUS_TOOL_NAME,
+    label: "Pull Request Status",
+    description: "pull_request_status reads one same-repository GitHub PR by number, or the most recently updated PR for a head branch (current branch by default). Reports open/closed/merged state and exact head/base/merge identities. No mutations; not a CI-check or review-approval verdict.",
+    promptSnippet: "pull_request_status: inspect open, closed, or merged PR state and immutable commit identities",
+    promptGuidelines: [
+      "Use pull_request_status with number for exact lifecycle verification; number and headBranch are mutually exclusive.",
+      "Without number, pull_request_status returns the most recently updated PR for headBranch or the current branch. Prefer its exact number for subsequent checks.",
+      "pull_request_status never merges, edits, closes, or deletes a PR and does not claim CI checks or review requirements passed.",
+    ],
+    parameters: Type.Object({
+      number: Type.Optional(Type.Integer({ minimum: 1, description: "Exact PR number; mutually exclusive with headBranch." })),
+      headBranch: Type.Optional(Type.String({ minLength: 1, description: "Head branch to look up; defaults to current branch when number is omitted." })),
+    }, { additionalProperties: false }),
+    async execute(_id, params, signal, _update, ctx) {
+      if (params.number !== undefined && params.headBranch !== undefined) throw new Error("Supply number or headBranch, not both.");
+      const rootCtx = { cwd: await getGitRoot(pi, ctx, signal) };
+      const repository = await resolveGitHubRepository(pi, rootCtx, signal, options.env);
+      const token = (await resolveGitHubToken(options.env, { cwd: rootCtx.cwd, signal })).token;
+      const requestOptions = { fetchImpl: options.fetchImpl, signal };
+      const pullRequest = params.number === undefined
+        ? await findGitHubPullRequest(repository, params.headBranch ?? await requireCurrentBranch(pi, rootCtx, signal), token, requestOptions)
+        : await getGitHubPullRequest(repository, params.number, token, requestOptions);
+      return {
+        content: [{ type: "text", text: formatPullRequestStatus(pullRequest) }],
+        details: { action: "pull_request_status", pullRequest },
+      };
+    },
+  });
+  pi.registerTool({
+    name: UPDATE_FROM_BASE_TOOL_NAME,
+    label: "Update From Base",
+    description: "update_from_base fetches one remote base and merges its captured commit into the clean current feature branch with verified no-op, fast-forward, merge-commit, or automatically aborted conflict results. Never rebases, pushes, stashes, or changes upstream configuration.",
+    promptSnippet: "update_from_base: merge a fresh remote base into the current feature without rewriting published history",
+    promptGuidelines: [
+      "Use update_from_base only when asked to update the current feature branch from an explicit baseBranch; remote defaults to origin.",
+      "Run update_from_base by itself. It fetches the base and uses the fixed normal-merge policy; conflicts are automatically aborted with restoration verified.",
+      "update_from_base preserves published history and upstream configuration; committing conflict-resolution changes belongs to a separate workflow.",
+    ],
+    parameters: Type.Object({
+      baseBranch: Type.String({ minLength: 1, description: "Exact base branch on the remote, for example main." }),
+      remote: Type.Optional(Type.String({ minLength: 1, description: "Configured remote; defaults to origin." })),
+    }, { additionalProperties: false }),
+    async execute(_id, params, signal, _update, ctx) {
+      const details = await updateFromBase(pi, ctx, params, signal);
+      return { content: [{ type: "text", text: `update_from_base: ${details.status}. ${details.status === "conflict" ? "Merge aborted and restoration verified; inspect conflict paths in details." : "Base integration verified without rewriting published history."}` }], details };
+    },
+  });
+  pi.registerTool({
+    name: TRACK_BRANCH_TOOL_NAME,
+    label: "Track Branch",
+    description: "track_branch fetches one exact remote branch, creates and checks out a new local tracking branch, and verifies HEAD/upstream. Requires a clean idle checkout. Never forces, stashes, commits, or pushes.",
+    promptSnippet: "track_branch: join an existing remote branch with a verified local tracking checkout",
+    promptGuidelines: [
+      "Use track_branch only when explicitly asked to create and check out a local branch tracking an existing remote branch.",
+      "Run track_branch by itself; it fetches before checkout. Supply branchName and optionally remote (default origin) and remoteBranch (default branchName).",
+      "track_branch rejects existing local branches and dirty or in-progress worktrees; it never stashes or discards changes.",
+    ],
+    parameters: Type.Object({
+      branchName: Type.String({ minLength: 1, description: "New local branch name." }),
+      remote: Type.Optional(Type.String({ minLength: 1, description: "Configured remote; defaults to origin." })),
+      remoteBranch: Type.Optional(Type.String({ minLength: 1, description: "Existing branch on that remote; defaults to branchName." })),
+    }, { additionalProperties: false }),
+    async execute(_id, params, signal, _update, ctx) {
+      const details = await trackBranch(pi, ctx, params, signal);
+      return { content: [{ type: "text", text: `Checked out ${details.branchName} tracking ${details.upstream} at ${details.head}.` }], details };
+    },
+  });
+}

package/src/types.ts

@@ -29,6 +29,42 @@ export interface BranchStatusToolInput {
   ancestry?: BranchStatusAncestryQuery;
 }
 
+export type ListBranchesToolInput = Record<string, never>;
+
+export interface BranchEntry {
+  name: string;
+  fullRef: string;
+  kind: "local" | "remote-tracking";
+  head: string;
+  current: boolean;
+  upstream: string | null;
+  ahead: number | null;
+  behind: number | null;
+  symbolicTarget: string | null;
+  worktreePaths: string[];
+}
+
+export interface ListBranchesDetails {
+  action: "list_branches";
+  repoRoot: string;
+  branches: BranchEntry[];
+  omitted: number;
+}
+
+export interface InitRepositoryToolInput {
+  initialBranch?: string;
+}
+
+export interface InitRepositoryDetails {
+  action: "init_repository";
+  request: InitRepositoryToolInput;
+  repoRoot: string;
+  gitDirectory: string;
+  initialBranch: string;
+  bare: false;
+  unborn: true;
+}
+
 export interface IntegrateBranchToolInput {
   sourceBranch: string;
   targetBranch: string;
@@ -55,6 +91,8 @@ export interface CreateWorktreeToolInput {
 
 export interface RemoveWorktreeToolInput {
   worktreePath: string;
+  /** Explicitly authorizes deleting ignored files and directories with the worktree. */
+  deleteIgnored?: boolean;
 }
 
 export interface WorktreeEntry {
@@ -137,6 +175,7 @@ export interface CreateWorktreeDetails {
 
 export interface RemoveWorktreeDetails {
   action: "remove_worktree";
+  deletedIgnoredPaths: string[];
   repoRoot: string;
   request: RemoveWorktreeToolInput;
   verified: {
@@ -452,6 +491,21 @@ export interface PullRequestDetails {
   draft: boolean;
 }
 
+export interface PullRequestStatusInput {
+  number?: number;
+  headBranch?: string;
+}
+
+export interface PullRequestStatusDetails extends PullRequestDetails {
+  title: string;
+  state: "open" | "closed";
+  merged: boolean;
+  mergedAt: string | null;
+  headSha: string;
+  baseSha: string;
+  mergeCommitSha: string | null;
+}
+
 export interface PullRequestInput {
   headBranch: string;
   baseBranch: string;
@@ -465,6 +519,7 @@ export type PullRequestInputField = keyof PullRequestInput;
 export type PullRequestToolInput = Partial<PullRequestInput>;
 
 export interface PullRequestToolDetails extends PullRequestDetails {
+  outcome?: "created" | "existing";
   autofilledFields?: PullRequestInputField[];
 }
 

package/src/ui/branchme-panel.ts

@@ -179,7 +179,7 @@ function sectionFooter(section: BranchMePanelSection, data: BranchMePanelData):
 
   switch (section) {
     case "status":
-      return "status • current repository only • tools perform actions";
+      return "status • init or current repository • tools perform actions";
     case "workflow":
       return "workflow • inspect → change → fetch/pull/rebase → create → push → PR";
     case "integration":
@@ -196,6 +196,7 @@ function sectionRows(section: BranchMePanelSection, data: BranchMePanelData): Pa
     case "status":
       return [
         heading("STATUS"),
+        workflowDetailRow("init_repository", "new current directory"),
         statusDetailRow("Current branch:", values.branch),
         statusDetailRow("GitHub repository:", values.repository),
         statusDetailRow("GitHub token:", values.token),
@@ -258,7 +259,7 @@ function renderNarrow(data: BranchMePanelData, width: number, selectedSection: B
   const counter = `${sectionIndex(section) + 1}/${PANEL_SECTIONS.length}`;
   const lines = [
     titleBorder(width, sectionLabel(section), theme),
-    framedLine("current repo only • informational", width, theme),
+    framedLine("init or current repo • informational", width, theme),
     framedLine(layoutCell(" ↑↓ section • q quit • /branchme help"), width, theme),
     horizontal(width, "├", "─", "┤", theme),
   ];