@agimon-ai/doompi-git 0.0.1-alpha.5 → 0.0.1-alpha.50

package/src/web/components/WorktreesPanel.tsx

@@ -1,174 +0,0 @@
-/**
- * The '# git' group's tab: this session's worktrees, and the form that makes one.
- *
- * DESIGN PATTERNS:
- * - Lives in the activity dock, opened by the group's name. A worktree is work
- *   in progress belonging to the session that started it, so it sits beside
- *   agents, runners and workflows rather than in a settings screen.
- * - Header, form, then cards, the same rhythm the runners and workflows panels
- *   use. A worktree row is a card because it carries three facts and two
- *   actions, which a single line cannot hold without becoming a puzzle.
- * - Local form state is never reset by a data refresh. The hub republishes this
- *   list on a timer, and a half-typed branch name must survive that.
- * - Acts through the plugin's own hub channel, so a worktree made here and one
- *   made by the tool take exactly the same path.
- * - Creating waits on the cockpit starting a session, so the hub reports each
- *   phase on that channel and the header shows it turning. A button that looks
- *   idle for two minutes reads as broken.
- *
- * AVOID:
- * - Deriving form state from props or store data. That is what wiped the
- *   fields on every poll.
- * - Colour classes outside the token set. `doom-error`, `doom-line` and
- *   `doom-bright` are not tokens: they compile to nothing and the row silently
- *   loses its border.
- */
-import { Button, Dot, EmptyState, Input, Spinner, StatusBadge } from '@agimon-ai/doompi-web-components';
-import type { TransientTab, WebPluginSlotProps } from '@agimon-ai/doompi-web-contracts';
-import { useStore } from '@tanstack/react-store';
-import { useState } from 'react';
-import type { WorktreeView } from '../../types/webWorktrees.ts';
-import { requestWorktreeClose, requestWorktreeCreate, worktreeActivity } from '../stores/worktreesActivityStore.ts';
-
-const WORKTREES_TAB_ID = 'git-worktrees';
-
-export function worktreesTab(): TransientTab {
-  return { id: WORKTREES_TAB_ID, label: 'worktrees', panel: WorktreesPanel };
-}
-
-export function WorktreesPanel({ sessionId }: WebPluginSlotProps) {
-  const session = useStore(worktreeActivity.store, (state) => worktreeActivity.select(state, sessionId));
-  const [branch, setBranch] = useState('');
-  const [baseRef, setBaseRef] = useState('');
-
-  const busy = session.pending !== undefined;
-  const canCreate = sessionId !== null && branch.trim() !== '' && !busy;
-
-  const create = (): void => {
-    if (sessionId === null || !canCreate) return;
-    requestWorktreeCreate(sessionId, branch, baseRef);
-    setBranch('');
-    setBaseRef('');
-  };
-
-  return (
-    <div data-testid="git-worktrees-panel" className="flex min-h-0 flex-1 flex-col overflow-auto">
-      <div className="flex min-h-11 shrink-0 items-center gap-2.5 border-b border-doom-border-soft px-3 sm:px-[26px]">
-        <span className="text-sm font-bold text-doom-hi">worktrees</span>
-        <span data-testid="git-worktrees-count" className="text-xs text-doom-faint">
-          {session.worktrees.length === 0 ? 'none yet' : `${String(session.worktrees.length)} open`}
-        </span>
-        <span className="min-w-0 flex-1" />
-        {session.pending === undefined ? null : (
-          <span data-testid="git-worktree-pending" className="flex min-w-0 items-center gap-1.5">
-            <Spinner className="h-3 w-3 shrink-0 text-doom-faint" label={session.pending} />
-            <span className="min-w-0 truncate text-xs text-doom-dim">{session.pending}</span>
-          </span>
-        )}
-      </div>
-
-      <div className="flex shrink-0 flex-col gap-1.5 border-b border-doom-border-soft px-3 py-2.5 sm:px-[26px]">
-        <div className="flex items-center gap-2">
-          <Input
-            data-testid="git-worktree-branch"
-            aria-label="Branch"
-            size="sm"
-            className="min-w-0 flex-1"
-            placeholder="wt/fix-auth"
-            value={branch}
-            onChange={(event) => setBranch(event.target.value)}
-            onKeyDown={(event) => {
-              if (event.key === 'Enter') create();
-            }}
-          />
-          <Input
-            data-testid="git-worktree-base"
-            aria-label="Base ref"
-            size="sm"
-            placeholder="base (current)"
-            value={baseRef}
-            onChange={(event) => setBaseRef(event.target.value)}
-            className="w-32 shrink-0"
-          />
-          <Button data-testid="git-worktree-create" size="sm" disabled={!canCreate} onClick={create}>
-            Create
-          </Button>
-        </div>
-        {session.error === undefined ? (
-          <p className="text-2xs text-doom-faint">
-            Creates the worktree outside the repository and starts a session nested under this one.
-          </p>
-        ) : (
-          <p data-testid="git-worktree-error" className="text-2xs text-doom-red">
-            {session.error}
-          </p>
-        )}
-      </div>
-
-      {session.worktrees.length === 0 ? (
-        <EmptyState
-          data-testid="git-worktrees-empty"
-          className="px-4 py-8"
-          title="no worktrees yet"
-          description="a worktree is its own checkout on its own branch, with its own session nested under this one."
-        />
-      ) : (
-        <ul data-testid="git-worktrees-list" className="flex flex-col gap-2.5 px-3 py-3 sm:px-[26px]">
-          {session.worktrees.map((worktree: WorktreeView) => (
-            <WorktreeCard key={worktree.id} worktree={worktree} sessionId={sessionId} busy={busy} />
-          ))}
-        </ul>
-      )}
-    </div>
-  );
-}
-
-/** One worktree: what it is, where it is, and the one thing you can do to it. */
-function WorktreeCard({
-  worktree,
-  sessionId,
-  busy,
-}: {
-  worktree: WorktreeView;
-  busy: boolean;
-} & Pick<WebPluginSlotProps, 'sessionId'>) {
-  return (
-    <li
-      data-testid={`git-worktree-${worktree.id}`}
-      className="flex min-w-0 flex-col gap-1.5 rounded-md border border-doom-border-soft bg-doom-panel p-2.5"
-    >
-      <div className="flex min-w-0 items-center gap-1.5">
-        <Dot tone={worktree.orphaned ? 'red' : worktree.sessionId === null ? 'muted' : 'blue'} />
-        <span className="min-w-0 flex-1 truncate text-sm font-bold text-doom-hi">{worktree.branch}</span>
-        {worktree.orphaned ? (
-          <StatusBadge tone="error" size="xs">
-            orphaned
-          </StatusBadge>
-        ) : null}
-        {worktree.unowned ? (
-          <StatusBadge tone="info" size="xs">
-            unowned
-          </StatusBadge>
-        ) : null}
-      </div>
-
-      <span className="min-w-0 truncate text-2xs text-doom-faint">{worktree.path}</span>
-
-      <div className="flex items-center gap-1.5 pt-0.5">
-        <span className="min-w-0 flex-1" />
-        {sessionId === null ? null : (
-          <Button
-            variant="danger-outline"
-            size="xs"
-            disabled={busy}
-            data-testid={`git-worktree-close-${worktree.id}`}
-            className="px-2 text-2xs font-bold"
-            onClick={() => requestWorktreeClose(sessionId, worktree.id)}
-          >
-            close
-          </Button>
-        )}
-      </div>
-    </li>
-  );
-}

package/src/web/components/toolRenderers.ts

@@ -1,7 +0,0 @@
-import type { ToolRendererContribution } from '@agimon-ai/doompi-web-contracts';
-import { RunWorktreeToolMessage } from './RunWorktreeToolMessage.tsx';
-
-/** The timeline items for this package's tools. */
-export const gitToolRenderers: ToolRendererContribution[] = [
-  { tools: ['run_worktree'], message: RunWorktreeToolMessage },
-];

package/src/web/index.ts

@@ -1,30 +0,0 @@
-import { defineWebPlugin } from '@agimon-ai/doompi-web-contracts';
-import { gitToolRenderers } from './components/toolRenderers.ts';
-import { WorktreesActivitySection } from './components/WorktreesActivitySection.tsx';
-import { worktreesTab } from './components/WorktreesPanel.tsx';
-import { startWorktreeRuntime, worktreeActivitySource, worktreesChannel } from './stores/worktreesActivityStore.ts';
-
-/** The named export the generated plugin registry imports. */
-export const webPlugin = defineWebPlugin({
-  id: 'git',
-  channels: [worktreesChannel],
-  // The panel commands the hub over its own channel, which needs the page's
-  // hub socket rather than the per-session frame sender the slots carry.
-  start: startWorktreeRuntime,
-  activityGroups: [
-    {
-      name: 'git',
-      keys: 'g w',
-      // The source keeps the group present while idle, which is exactly when
-      // its launcher matters: a repository with no worktrees is where someone
-      // wants to make the first one.
-      activeSource: worktreeActivitySource,
-      // A standing worktree is not background work in progress; it is state.
-      marksBackgroundWork: false,
-      transientTab: worktreesTab,
-      order: 30,
-    },
-  ],
-  activitySections: [{ id: 'git', component: WorktreesActivitySection }],
-  toolRenderers: gitToolRenderers,
-});

package/src/web/stores/worktreesActivityStore.ts

@@ -1,124 +0,0 @@
-/**
- * The dock's view of this session's worktrees, and the commands it sends.
- *
- * DESIGN PATTERNS:
- * - Session-scoped store fed by one hub channel. The hub is authoritative; the
- *   page never reads a registry and never guesses.
- * - Actions are channel frames, not prompts. The hub half owns the tool's
- *   operations, so the panel names the work and the hub performs it; a
- *   worktree made from the dock is the same object the tool makes, without
- *   spending a turn of the conversation to ask for it.
- * - The sender lives in a store rather than a module variable, because a web
- *   plugin keeps no mutable module state and the page may reconnect.
- *
- * AVOID:
- * - Calling the hub package API from here. A dock slot gets no sealed request
- *   transport, and raw fetch breaks the remote cockpit.
- * - `sendSessionFrame` for a command. It envelopes the frame as a session
- *   command bound for the agent, which never reaches a channel's `receive`.
- */
-import { defineGlobalStore, defineSessionStore, type WebPluginRuntime } from '@agimon-ai/doompi-web-contracts';
-import { GIT_WORKTREES_TYPE, type GitWorktreesCommand, type WorktreeView } from '../../types/webWorktrees.ts';
-
-export interface WorktreesSession {
-  /** The worktrees the hub last reported for this session's repository. */
-  worktrees: WorktreeView[];
-  /** Label of the operation the hub is running for this session. */
-  pending: string | undefined;
-  /** The last failure the hub reported, shown until the next command. */
-  error: string | undefined;
-}
-
-export const worktreeActivity = defineSessionStore<WorktreesSession>({
-  worktrees: [],
-  pending: undefined,
-  error: undefined,
-});
-
-/**
- * The page's hub socket sender, held for as long as the plugin runs.
- *
- * Undefined before `startWorktreeRuntime` and after it disposes; a command
- * sent in that window is dropped rather than queued, because a queue would
- * replay a worktree create against a socket that has since changed sessions.
- */
-const worktreeSender = defineGlobalStore<WebPluginRuntime['sendHubFrame'] | undefined>(undefined);
-
-/** Binds the page's hub socket. The plugin host calls this once per page. */
-export function startWorktreeRuntime(runtime: WebPluginRuntime): () => void {
-  // Wrapped rather than referenced: an unbound method would lose the runtime
-  // it belongs to the moment the store hands it back.
-  const send = (frame: Record<string, unknown>): void => {
-    runtime.sendHubFrame(frame);
-  };
-  worktreeSender.update(() => send);
-  return () => {
-    worktreeSender.update((current) => (current === send ? undefined : current));
-  };
-}
-
-/**
- * Whether this session has worktree work in flight.
- *
- * A standing worktree is state, not work: it sits there until someone closes
- * it, so counting it would leave the session reading as busy forever, with a
- * "background work is still running" notice under a conversation where
- * nothing is running. Only a create or close actually in progress counts.
- *
- * The group stays visible either way. Declaring an active source at all is
- * what keeps it in the dock; this answers how it is drawn, not whether it is
- * there.
- */
-export const worktreeActivitySource = {
-  subscribe(listener: () => void) {
-    const subscription = worktreeActivity.store.subscribe(listener);
-    return () => subscription.unsubscribe();
-  },
-  isActive(sessionId: string | null) {
-    return worktreeActivity.select(worktreeActivity.store.state, sessionId).pending !== undefined;
-  },
-};
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function optionalText(value: unknown): string | undefined {
-  return typeof value === 'string' && value !== '' ? value : undefined;
-}
-
-/** The plugin's session data channel: 'git_worktrees' payloads into the store. */
-export const worktreesChannel = worktreeActivity.channel<WorktreesSession>({
-  channel: GIT_WORKTREES_TYPE,
-  parse(input) {
-    if (!isRecord(input) || !Array.isArray(input.worktrees)) return null;
-    return {
-      worktrees: input.worktrees.filter(isRecord) as unknown as WorktreeView[],
-      pending: optionalText(input.pending),
-      error: optionalText(input.error),
-    };
-  },
-  reduce(_current, next) {
-    return next;
-  },
-});
-
-/** Sends one command to the session's worktrees channel. */
-function command(sessionId: string, payload: GitWorktreesCommand): void {
-  worktreeSender.store.state?.({ type: GIT_WORKTREES_TYPE, sessionId, payload });
-}
-
-/** Asks the hub for a worktree. The hub answers on the same channel. */
-export function requestWorktreeCreate(sessionId: string, branch: string, baseRef: string): void {
-  const trimmedBase = baseRef.trim();
-  command(sessionId, {
-    action: 'create',
-    branch: branch.trim(),
-    ...(trimmedBase === '' ? {} : { baseRef: trimmedBase }),
-  });
-}
-
-/** Asks the hub to close one worktree. Refusal on a dirty tree stays the hub's call. */
-export function requestWorktreeClose(sessionId: string, id: string): void {
-  command(sessionId, { action: 'close', id });
-}

package/src/web/tsconfig.json

@@ -1,22 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2023", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "jsx": "react-jsx",
-    "strict": true,
-    "noImplicitAny": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "noEmit": true,
-    "resolveJsonModule": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "allowImportingTsExtensions": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": [".", "../types/worktreeRegistry.ts", "../types/webWorktrees.ts", "../exports/webClient.ts"]
-}