@agimon-ai/doompi-git 0.0.1-alpha.1 → 0.0.1-alpha.12

package/src/web/components/WorktreesPanel.tsx

@@ -1,125 +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.
- * - 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 takes minutes, so the hub reports progress and failure on that
- *   channel and this panel renders both. 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.
- */
-import { Button, Input } 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 className="flex flex-col gap-3 p-3" data-testid="git-worktrees-panel">
-      <div className="flex flex-col gap-1">
-        <div className="flex items-center gap-2">
-          <Input
-            data-testid="git-worktree-branch"
-            aria-label="Branch"
-            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"
-            placeholder="base (current)"
-            value={baseRef}
-            onChange={(event) => setBaseRef(event.target.value)}
-            className="w-40"
-          />
-          <Button data-testid="git-worktree-create" size="xs" disabled={!canCreate} onClick={create}>
-            Create
-          </Button>
-        </div>
-        <p className="text-[10px] text-doom-faint">
-          Creates the worktree outside the repository, installs its dependencies, then starts a session nested under
-          this one. The install is what makes the wait; a warm store is under a minute.
-        </p>
-        {session.pending === undefined ? null : (
-          <p data-testid="git-worktree-pending" className="text-[10px] text-doom-dim">
-            {session.pending}
-          </p>
-        )}
-        {session.error === undefined ? null : (
-          <p data-testid="git-worktree-error" className="text-[10px] text-doom-error">
-            {session.error}
-          </p>
-        )}
-      </div>
-
-      {session.worktrees.length === 0 ? (
-        <p className="text-[11px] text-doom-faint">No worktrees yet.</p>
-      ) : (
-        <ul className="flex flex-col gap-1">
-          {session.worktrees.map((worktree: WorktreeView) => (
-            <li
-              key={worktree.id}
-              data-testid={`git-worktree-${worktree.id}`}
-              className="flex items-center justify-between gap-2 border border-doom-line px-2 py-1"
-            >
-              <div className="flex min-w-0 flex-col">
-                <span className="truncate text-[11px] text-doom-bright">{worktree.branch}</span>
-                <span className="truncate text-[10px] text-doom-faint">{worktree.path}</span>
-              </div>
-              <div className="flex items-center gap-2">
-                {worktree.orphaned ? <span className="text-[10px] text-doom-faint">orphaned</span> : null}
-                {worktree.unowned ? <span className="text-[10px] text-doom-faint">unowned</span> : null}
-                {sessionId === null ? null : (
-                  <Button
-                    variant="link"
-                    size="xs"
-                    disabled={busy}
-                    data-testid={`git-worktree-close-${worktree.id}`}
-                    onClick={() => requestWorktreeClose(sessionId, worktree.id)}
-                  >
-                    close
-                  </Button>
-                )}
-              </div>
-            </li>
-          ))}
-        </ul>
-      )}
-    </div>
-  );
-}

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"]
-}