npm - hjworktree-cli - Versions diffs - 2.0.0 - Mend

hjworktree-cli 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (68) hide show

package/.context-snapshots/context-snapshot-20260106-110353.md +66 -0
package/.context-snapshots/context-snapshot-20260106-110441.md +66 -0
package/.context-snapshots/context-snapshot-20260106-220000.md +99 -0
package/AGENTS.md +29 -0
package/CLAUDE.md +88 -0
package/bin/cli.js +85 -0
package/dist/server/index.d.ts +6 -0
package/dist/server/index.d.ts.map +1 -0
package/dist/server/index.js +64 -0
package/dist/server/index.js.map +1 -0
package/dist/server/routes/api.d.ts +3 -0
package/dist/server/routes/api.d.ts.map +1 -0
package/dist/server/routes/api.js +101 -0
package/dist/server/routes/api.js.map +1 -0
package/dist/server/services/gitService.d.ts +13 -0
package/dist/server/services/gitService.d.ts.map +1 -0
package/dist/server/services/gitService.js +84 -0
package/dist/server/services/gitService.js.map +1 -0
package/dist/server/services/worktreeService.d.ts +17 -0
package/dist/server/services/worktreeService.d.ts.map +1 -0
package/dist/server/services/worktreeService.js +161 -0
package/dist/server/services/worktreeService.js.map +1 -0
package/dist/server/socketHandlers.d.ts +4 -0
package/dist/server/socketHandlers.d.ts.map +1 -0
package/dist/server/socketHandlers.js +118 -0
package/dist/server/socketHandlers.js.map +1 -0
package/dist/shared/constants.d.ts +10 -0
package/dist/shared/constants.d.ts.map +1 -0
package/dist/shared/constants.js +31 -0
package/dist/shared/constants.js.map +1 -0
package/dist/shared/types/index.d.ts +67 -0
package/dist/shared/types/index.d.ts.map +1 -0
package/dist/shared/types/index.js +3 -0
package/dist/shared/types/index.js.map +1 -0
package/dist/web/assets/index-C61yAbey.css +32 -0
package/dist/web/assets/index-WEdVUKxb.js +53 -0
package/dist/web/assets/index-WEdVUKxb.js.map +1 -0
package/dist/web/index.html +16 -0
package/package.json +63 -0
package/server/index.ts +75 -0
package/server/routes/api.ts +108 -0
package/server/services/gitService.ts +91 -0
package/server/services/worktreeService.ts +181 -0
package/server/socketHandlers.ts +157 -0
package/shared/constants.ts +35 -0
package/shared/types/index.ts +92 -0
package/tsconfig.json +20 -0
package/web/index.html +15 -0
package/web/src/App.tsx +65 -0
package/web/src/components/Layout/Header.tsx +29 -0
package/web/src/components/Layout/LeftNavBar.tsx +67 -0
package/web/src/components/Layout/MainLayout.tsx +23 -0
package/web/src/components/Layout/StepContainer.tsx +71 -0
package/web/src/components/Setup/AgentSelector.tsx +27 -0
package/web/src/components/Setup/BranchSelector.tsx +28 -0
package/web/src/components/Setup/SetupPanel.tsx +32 -0
package/web/src/components/Setup/WorktreeCountSelector.tsx +30 -0
package/web/src/components/Steps/AgentStep.tsx +20 -0
package/web/src/components/Steps/BranchStep.tsx +20 -0
package/web/src/components/Steps/WorktreeStep.tsx +41 -0
package/web/src/components/Terminal/TerminalPanel.tsx +113 -0
package/web/src/components/Terminal/XTerminal.tsx +203 -0
package/web/src/hooks/useSocket.ts +80 -0
package/web/src/main.tsx +10 -0
package/web/src/stores/useAppStore.ts +348 -0
package/web/src/styles/global.css +695 -0
package/web/tsconfig.json +23 -0
package/web/vite.config.ts +32 -0

package/shared/constants.ts ADDED Viewed

@@ -0,0 +1,35 @@
+import type { AgentType } from './types/index.js';
+export const AI_AGENTS: AgentType[] = [
+  {
+    id: 'codex',
+    name: 'Codex CLI',
+    command: 'codex',
+    installCommand: 'npm install -g @openai/codex',
+    description: 'OpenAI Codex CLI - AI-powered coding assistant'
+  },
+  {
+    id: 'claude',
+    name: 'Claude Code',
+    command: 'claude',
+    installCommand: 'npm install -g @anthropic-ai/claude-code',
+    description: 'Anthropic Claude Code - Advanced AI coding assistant'
+  },
+  {
+    id: 'gemini',
+    name: 'Gemini CLI',
+    command: 'gemini',
+    installCommand: 'npm install -g @google/gemini-cli',
+    description: 'Google Gemini CLI - Multi-modal AI assistant'
+  }
+];
+export const MAX_PARALLEL_COUNT = 10;
+export const MIN_PARALLEL_COUNT = 1;
+export const DEFAULT_PARALLEL_COUNT = 3;
+export const BRANCH_POLL_INTERVAL = 5000; // 5 seconds
+export const APP_NAME = 'hjWorktree CLI';
+export const APP_VERSION = '2.0.0';
+export const DEFAULT_PORT = 3847;

package/shared/types/index.ts ADDED Viewed

@@ -0,0 +1,92 @@
+// Navigation step types (4-step wizard)
+export type NavigationStep = 'branch' | 'agent' | 'worktree' | 'running';
+// Step status for LNB display
+export type StepStatus = 'pending' | 'current' | 'completed';
+// Step configuration
+export interface StepConfig {
+  id: NavigationStep;
+  number: number;
+  label: string;
+  description: string;
+}
+// Step order constant
+export const STEP_ORDER: NavigationStep[] = ['branch', 'agent', 'worktree', 'running'];
+// Agent types
+export type AgentId = 'codex' | 'claude' | 'gemini';
+export interface AgentType {
+  id: AgentId;
+  name: string;
+  command: string;
+  installCommand: string;
+  description: string;
+}
+// Branch types
+export interface Branch {
+  name: string;
+  isCurrent: boolean;
+  isRemote: boolean;
+  lastCommit?: string;
+}
+// Running agent types
+export type AgentStatus = 'initializing' | 'installing' | 'running' | 'stopped' | 'error';
+export interface TerminalInfo {
+  sessionId: string;
+  worktreePath: string;
+  worktreeName: string;
+  branchName: string;
+  agentType: AgentId;
+  status: AgentStatus;
+}
+// Worktree types
+export interface Worktree {
+  path: string;
+  branch: string;
+  name: string;
+}
+// Socket.IO event types
+export interface TerminalCreateData {
+  sessionId: string;
+  worktreePath: string;
+  agentType: AgentId;
+}
+export interface TerminalOutputData {
+  sessionId: string;
+  data: string;
+}
+export interface TerminalInputData {
+  sessionId: string;
+  data: string;
+}
+export interface TerminalResizeData {
+  sessionId: string;
+  cols: number;
+  rows: number;
+}
+export interface TerminalKillData {
+  sessionId: string;
+}
+// API response types
+export interface CreateWorktreesRequest {
+  branch: string;
+  count: number;
+  agentType: AgentId;
+}
+export interface CreateWorktreesResponse {
+  worktrees: Worktree[];
+}

package/tsconfig.json ADDED Viewed

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "sourceMap": true,
+    "isolatedModules": true
+  },
+  "include": ["shared/**/*", "server/**/*"],
+  "exclude": ["node_modules", "dist", "web", "src"]
+}

package/web/index.html ADDED Viewed

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>hjWorktree CLI</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="/src/main.tsx"></script>
+</body>
+</html>

package/web/src/App.tsx ADDED Viewed

@@ -0,0 +1,65 @@
+import React, { useEffect } from 'react';
+import { useAppStore } from './stores/useAppStore.js';
+import { useSocket } from './hooks/useSocket.js';
+import Header from './components/Layout/Header.js';
+import MainLayout from './components/Layout/MainLayout.js';
+import BranchStep from './components/Steps/BranchStep.js';
+import AgentStep from './components/Steps/AgentStep.js';
+import WorktreeStep from './components/Steps/WorktreeStep.js';
+import TerminalPanel from './components/Terminal/TerminalPanel.js';
+function App() {
+  const { step, isLoading, loadingMessage, error } = useAppStore();
+  const { connected } = useSocket();
+  // Fetch initial data
+  useEffect(() => {
+    useAppStore.getState().fetchProjectInfo();
+    useAppStore.getState().fetchBranches();
+  }, []);
+  const renderStepContent = () => {
+    switch (step) {
+      case 'branch':
+        return <BranchStep />;
+      case 'agent':
+        return <AgentStep />;
+      case 'worktree':
+        return <WorktreeStep />;
+      case 'running':
+        return <TerminalPanel />;
+      default:
+        return <BranchStep />;
+    }
+  };
+  return (
+    <div className="app">
+      <Header />
+      <MainLayout>
+        {renderStepContent()}
+      </MainLayout>
+      {isLoading && (
+        <div className="loading-overlay">
+          <div className="loading-spinner" />
+          <p>{loadingMessage || 'Loading...'}</p>
+        </div>
+      )}
+      {error && (
+        <div className="error-banner">
+          {error}
+        </div>
+      )}
+      <div className="connection-status">
+        <span className={`dot ${connected ? 'connected' : 'disconnected'}`} />
+        {connected ? 'Connected' : 'Disconnected'}
+      </div>
+    </div>
+  );
+}
+export default App;

package/web/src/components/Layout/Header.tsx ADDED Viewed

@@ -0,0 +1,29 @@
+import React from 'react';
+import { useAppStore } from '../../stores/useAppStore';
+import { APP_NAME, APP_VERSION } from '../../../../shared/constants';
+function Header() {
+  const projectInfo = useAppStore((state) => state.projectInfo);
+  return (
+    <header className="header">
+      <h1>{APP_NAME}</h1>
+      <div className="project-info">
+        {projectInfo && (
+          <>
+            <span className="branch">
+              <svg width="16" height="16" viewBox="0 0 16 16" fill="currentColor">
+                <path d="M11.75 2.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5zm-2.25.75a2.25 2.25 0 1 1 3 2.122V6A2.5 2.5 0 0 1 10 8.5H6a1 1 0 0 0-1 1v1.128a2.251 2.251 0 1 1-1.5 0V5.372a2.25 2.25 0 1 1 1.5 0v1.836A2.493 2.493 0 0 1 6 7h4a1 1 0 0 0 1-1v-.628A2.25 2.25 0 0 1 9.5 3.25zM4.25 12a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5zM3.5 3.25a.75.75 0 1 1 1.5 0 .75.75 0 0 1-1.5 0z"/>
+              </svg>
+              {projectInfo.currentBranch || 'Unknown'}
+            </span>
+            <span>{projectInfo.cwd}</span>
+          </>
+        )}
+        <span>v{APP_VERSION}</span>
+      </div>
+    </header>
+  );
+}
+export default Header;

package/web/src/components/Layout/LeftNavBar.tsx ADDED Viewed

@@ -0,0 +1,67 @@
+import React from 'react';
+import { useAppStore } from '../../stores/useAppStore.js';
+import type { NavigationStep, StepStatus } from '../../../../shared/types/index.js';
+interface StepItemProps {
+  step: NavigationStep;
+  number: number;
+  label: string;
+  status: StepStatus;
+  onClick: () => void;
+  disabled: boolean;
+}
+const STEP_CONFIG = [
+  { id: 'branch' as const, number: 1, label: 'Branch Selection' },
+  { id: 'agent' as const, number: 2, label: 'Agent Selection' },
+  { id: 'worktree' as const, number: 3, label: 'Worktree Count' },
+  { id: 'running' as const, number: 4, label: 'Running' },
+];
+function StepItem({ number, label, status, onClick, disabled }: StepItemProps) {
+  return (
+    <button
+      className={`lnb-step ${status}`}
+      onClick={onClick}
+      disabled={disabled}
+      type="button"
+    >
+      <span className="step-number">
+        {status === 'completed' ? '✓' : number}
+      </span>
+      <span className="step-label">{label}</span>
+    </button>
+  );
+}
+function LeftNavBar() {
+  const { step, goToStep, canNavigateTo, getStepStatus } = useAppStore();
+  // Don't show LNB on running step
+  if (step === 'running') {
+    return null;
+  }
+  return (
+    <nav className="left-nav-bar">
+      <div className="lnb-header">
+        <span>Setup Steps</span>
+      </div>
+      <div className="lnb-steps">
+        {STEP_CONFIG.map((config) => (
+          <StepItem
+            key={config.id}
+            step={config.id}
+            number={config.number}
+            label={config.label}
+            status={getStepStatus(config.id)}
+            onClick={() => goToStep(config.id)}
+            disabled={!canNavigateTo(config.id)}
+          />
+        ))}
+      </div>
+    </nav>
+  );
+}
+export default LeftNavBar;

package/web/src/components/Layout/MainLayout.tsx ADDED Viewed

@@ -0,0 +1,23 @@
+import React from 'react';
+import LeftNavBar from './LeftNavBar.js';
+import { useAppStore } from '../../stores/useAppStore.js';
+interface MainLayoutProps {
+  children: React.ReactNode;
+}
+function MainLayout({ children }: MainLayoutProps) {
+  const step = useAppStore((state) => state.step);
+  const showLNB = step !== 'running';
+  return (
+    <div className="main-layout">
+      {showLNB && <LeftNavBar />}
+      <div className={`main-content-area ${showLNB ? 'with-lnb' : 'full-width'}`}>
+        {children}
+      </div>
+    </div>
+  );
+}
+export default MainLayout;

package/web/src/components/Layout/StepContainer.tsx ADDED Viewed

@@ -0,0 +1,71 @@
+import React from 'react';
+import { useAppStore } from '../../stores/useAppStore.js';
+interface StepContainerProps {
+  children: React.ReactNode;
+  title: string;
+  description?: string;
+  showNavButtons?: boolean;
+  nextLabel?: string;
+  onNext?: () => void;
+  nextDisabled?: boolean;
+}
+function StepContainer({
+  children,
+  title,
+  description,
+  showNavButtons = true,
+  nextLabel = 'Next',
+  onNext,
+  nextDisabled = false,
+}: StepContainerProps) {
+  const { step, goToNext, goToPrev, isStepComplete } = useAppStore();
+  const isFirstStep = step === 'branch';
+  const canProceed = isStepComplete(step);
+  const handleNext = () => {
+    if (onNext) {
+      onNext();
+    } else {
+      goToNext();
+    }
+  };
+  return (
+    <div className="step-container">
+      <div className="step-header">
+        <h2>{title}</h2>
+        {description && <p>{description}</p>}
+      </div>
+      <div className="step-content">
+        {children}
+      </div>
+      {showNavButtons && (
+        <div className="step-navigation">
+          <button
+            className="nav-button prev"
+            onClick={goToPrev}
+            disabled={isFirstStep}
+            type="button"
+          >
+            Previous
+          </button>
+          <button
+            className="nav-button next"
+            onClick={handleNext}
+            disabled={nextDisabled || !canProceed}
+            type="button"
+          >
+            {nextLabel}
+          </button>
+        </div>
+      )}
+    </div>
+  );
+}
+export default StepContainer;

package/web/src/components/Setup/AgentSelector.tsx ADDED Viewed

@@ -0,0 +1,27 @@
+import React from 'react';
+import { useAppStore } from '../../stores/useAppStore';
+import { AI_AGENTS } from '../../../../shared/constants';
+function AgentSelector() {
+  const { selectedAgent, setSelectedAgent } = useAppStore();
+  return (
+    <div className="setup-section">
+      <label>Select AI Agent</label>
+      <div className="agent-cards">
+        {AI_AGENTS.map((agent) => (
+          <div
+            key={agent.id}
+            className={`agent-card ${selectedAgent === agent.id ? 'selected' : ''}`}
+            onClick={() => setSelectedAgent(agent.id)}
+          >
+            <h4>{agent.name}</h4>
+            <p>{agent.description}</p>
+          </div>
+        ))}
+      </div>
+    </div>
+  );
+}
+export default AgentSelector;

package/web/src/components/Setup/BranchSelector.tsx ADDED Viewed

@@ -0,0 +1,28 @@
+import React from 'react';
+import { useAppStore } from '../../stores/useAppStore';
+function BranchSelector() {
+  const { branches, selectedBranch, setSelectedBranch } = useAppStore();
+  return (
+    <div className="setup-section">
+      <label htmlFor="branch-select">Select Branch</label>
+      <select
+        id="branch-select"
+        value={selectedBranch || ''}
+        onChange={(e) => setSelectedBranch(e.target.value || null)}
+      >
+        <option value="">-- Select a branch --</option>
+        {branches.map((branch) => (
+          <option key={branch.name} value={branch.name}>
+            {branch.name}
+            {branch.isCurrent ? ' (current)' : ''}
+            {branch.isRemote ? ' (remote)' : ''}
+          </option>
+        ))}
+      </select>
+    </div>
+  );
+}
+export default BranchSelector;

package/web/src/components/Setup/SetupPanel.tsx ADDED Viewed

@@ -0,0 +1,32 @@
+import React from 'react';
+import { useAppStore } from '../../stores/useAppStore';
+import BranchSelector from './BranchSelector';
+import AgentSelector from './AgentSelector';
+import WorktreeCountSelector from './WorktreeCountSelector';
+function SetupPanel() {
+  const { selectedBranch, isLoading, execute } = useAppStore();
+  return (
+    <div className="setup-panel">
+      <div style={{ textAlign: 'center', marginBottom: '16px' }}>
+        <h2>Configure Parallel Agents</h2>
+        <p>Set up multiple AI coding agents in separate git worktrees</p>
+      </div>
+      <BranchSelector />
+      <AgentSelector />
+      <WorktreeCountSelector />
+      <button
+        className="execute-button"
+        onClick={execute}
+        disabled={!selectedBranch || isLoading}
+      >
+        {isLoading ? 'Creating...' : 'Execute'}
+      </button>
+    </div>
+  );
+}
+export default SetupPanel;

package/web/src/components/Setup/WorktreeCountSelector.tsx ADDED Viewed

@@ -0,0 +1,30 @@
+import React from 'react';
+import { useAppStore } from '../../stores/useAppStore';
+import { MIN_PARALLEL_COUNT, MAX_PARALLEL_COUNT } from '../../../../shared/constants';
+function WorktreeCountSelector() {
+  const { worktreeCount, incrementWorktreeCount, decrementWorktreeCount } = useAppStore();
+  return (
+    <div className="setup-section">
+      <label>Number of Worktrees</label>
+      <div className="counter">
+        <button
+          onClick={decrementWorktreeCount}
+          disabled={worktreeCount <= MIN_PARALLEL_COUNT}
+        >
+          -
+        </button>
+        <span>{worktreeCount}</span>
+        <button
+          onClick={incrementWorktreeCount}
+          disabled={worktreeCount >= MAX_PARALLEL_COUNT}
+        >
+          +
+        </button>
+      </div>
+    </div>
+  );
+}
+export default WorktreeCountSelector;

package/web/src/components/Steps/AgentStep.tsx ADDED Viewed

@@ -0,0 +1,20 @@
+import React from 'react';
+import StepContainer from '../Layout/StepContainer.js';
+import AgentSelector from '../Setup/AgentSelector.js';
+import { useAppStore } from '../../stores/useAppStore.js';
+function AgentStep() {
+  const selectedAgent = useAppStore((state) => state.selectedAgent);
+  return (
+    <StepContainer
+      title="Select AI Agent"
+      description="Choose which AI coding agent to run in each worktree"
+      nextDisabled={!selectedAgent}
+    >
+      <AgentSelector />
+    </StepContainer>
+  );
+}
+export default AgentStep;

package/web/src/components/Steps/BranchStep.tsx ADDED Viewed

@@ -0,0 +1,20 @@
+import React from 'react';
+import StepContainer from '../Layout/StepContainer.js';
+import BranchSelector from '../Setup/BranchSelector.js';
+import { useAppStore } from '../../stores/useAppStore.js';
+function BranchStep() {
+  const selectedBranch = useAppStore((state) => state.selectedBranch);
+  return (
+    <StepContainer
+      title="Select Branch"
+      description="Choose the Git branch to create worktrees from"
+      nextDisabled={!selectedBranch}
+    >
+      <BranchSelector />
+    </StepContainer>
+  );
+}
+export default BranchStep;

package/web/src/components/Steps/WorktreeStep.tsx ADDED Viewed

@@ -0,0 +1,41 @@
+import React from 'react';
+import StepContainer from '../Layout/StepContainer.js';
+import WorktreeCountSelector from '../Setup/WorktreeCountSelector.js';
+import { useAppStore } from '../../stores/useAppStore.js';
+import { AI_AGENTS } from '../../../../shared/constants.js';
+function WorktreeStep() {
+  const { execute, isLoading, selectedBranch, selectedAgent, worktreeCount } = useAppStore();
+  const agentName = AI_AGENTS.find(a => a.id === selectedAgent)?.name || selectedAgent;
+  return (
+    <StepContainer
+      title="Configure Worktrees"
+      description="Set the number of parallel worktrees to create"
+      nextLabel={isLoading ? 'Creating...' : 'Execute'}
+      onNext={execute}
+      nextDisabled={!selectedBranch || isLoading || worktreeCount < 1}
+    >
+      <WorktreeCountSelector />
+      <div className="execution-summary">
+        <h4>Summary</h4>
+        <div className="summary-item">
+          <span className="summary-label">Branch:</span>
+          <span className="summary-value">{selectedBranch}</span>
+        </div>
+        <div className="summary-item">
+          <span className="summary-label">Agent:</span>
+          <span className="summary-value">{agentName}</span>
+        </div>
+        <div className="summary-item">
+          <span className="summary-label">Worktrees:</span>
+          <span className="summary-value">{worktreeCount}</span>
+        </div>
+      </div>
+    </StepContainer>
+  );
+}
+export default WorktreeStep;