@mrpatronz/nexusflow 0.2.19 → 1.3.0

package/src/types.ts

@@ -1,451 +0,0 @@
-/**
- * @module types
- * Shared interfaces and types for NexusFlow.
- */
-
-/** Supported AI assistant identifiers. */
-export type AIAssistant = 'claude' | 'antigravity' | 'codex' | 'copilot' | 'cursor';
-
-export interface LocalLlmConfig {
-  enabled: boolean;
-  provider: 'ollama' | 'openai-compatible';
-  endpoint: string;
-  model: string;
-  apiKey?: string;
-}
-
-/** Top-level NexusFlow configuration stored in ~/.nexusflow/config.json. */
-export interface NexusFlowConfig {
-  /** Semantic version of the NexusFlow config schema. */
-  version: string;
-
-  /** Root development directory. Default: ~/dev */
-  devDir: string;
-
-  /** Directory where workspaces are created. Default: ~/dev/workspaces */
-  workspacesDir: string;
-
-  /** The user's preferred AI assistant, or null if none chosen yet. */
-  defaultAssistant: AIAssistant | null;
-
-  /** The user's preferred editor command, or null if none chosen yet. */
-  defaultEditor?: string | null;
-
-  /** How many directory levels deep to scan for git repos. Default: 2 */
-  scanDepth: number;
-
-  /** Global patterns to exclude when packing/analyzing repositories. */
-  excludePatterns?: string[];
-
-  /** Active storage provider name. Default: 'local' */
-  storageProvider?: string;
-
-  /** Per-adapter settings keyed by adapter name. */
-  adapterConfig?: Record<string, Record<string, unknown>>;
-
-  /** List of plugin paths or npm packages to load. */
-  plugins?: string[];
-
-  /** ISO timestamp of the last update check. */
-  lastUpdateCheck?: string;
-
-  /** The last checked latest version from NPM. */
-  latestVersion?: string;
-  latestDownloadUrl?: string | null;
-  latestReleaseNotes?: string;
-
-  /** Local LLM settings for delegating simple tasks. */
-  localLlm?: LocalLlmConfig;
-}
-
-/** Result of probing for an AI assistant on the system. */
-export interface DetectedAI {
-  /** Canonical assistant identifier. */
-  name: AIAssistant;
-
-  /** Human-readable label shown in prompts. */
-  displayName: string;
-
-  /** Whether the assistant's CLI was found. */
-  detected: boolean;
-
-  /** The CLI command that was detected (e.g. 'claude', 'antigravity'). */
-  command?: string;
-}
-
-/** Result of probing for a code editor on the system. */
-export interface DetectedEditor {
-  /** Human-readable editor name. */
-  name: string;
-
-  /** CLI command used to launch the editor. */
-  command: string;
-
-  /** Whether the editor's CLI was found in PATH. */
-  detected: boolean;
-}
-
-/** Metadata about a discovered git repository. */
-export interface RepoInfo {
-  /** Directory name of the repo. */
-  name: string;
-
-  /** Absolute path to the repo root. */
-  path: string;
-
-  /** Default branch — typically 'main' or 'master'. */
-  defaultBranch: string;
-}
-
-/** Metadata about a past AI session. */
-export interface AISession {
-  id: string;
-  assistant: AIAssistant;
-  title: string;
-  createdAt: string;
-  updatedAt: string;
-  messageCount: number;
-  workspacePath: string;
-}
-
-/** A single chat message in a session transcript. */
-export interface ChatMessage {
-  role: 'user' | 'assistant';
-  content: string;
-  timestamp?: string;
-}
-
-
-/** Configuration for resuming the active session. */
-export interface ResumptionConfig {
-  /** The command to run verification tests. */
-  testCommand?: string;
-  /** The command to spin up dev databases/mocks/caches. */
-  mockCommand?: string;
-  /** The command to start workspace services manually if needed. */
-  startCommand?: string;
-}
-
-/** A feature workspace that spans one or more repos. */
-export interface Feature {
-  /** Unique identifier — the git branch name. */
-  id: string;
-
-  /** Git branch name created for this feature. */
-  branchName: string;
-
-  /** Short human-readable description of the feature. */
-  description: string;
-
-  /** Absolute paths to the repos included in this feature. */
-  repos: string[];
-
-  /** Absolute paths to the original repositories. */
-  originalRepos?: string[];
-
-  /** AI assistants enabled for this feature workspace. */
-  assistants: AIAssistant[];
-
-  /** Absolute path to the workspace directory on disk. */
-  workspacePath: string;
-
-  /** ISO-8601 timestamp of when the feature was created. */
-  createdAt: string;
-
-  /** Resumption configuration. */
-  resumption?: ResumptionConfig;
-
-  /** Whether the Local LLM Co-processor is active for this workspace. */
-  localLlmEnabled?: boolean;
-
-  /** Custom teamwork coordination instructions for the agent team. */
-  teamworkInstructions?: string;
-}
-
-/** Runtime context for an active workspace — now includes analysis data. */
-export interface WorkspaceContext {
-  /** The feature definition. */
-  feature: Feature;
-
-  /** Full repo metadata for every repo in the feature. */
-  repos: RepoInfo[];
-
-  /** Analysis results for each repo (keyed by repo path). */
-  analysis?: Map<string, ProjectAnalysis>;
-
-  /** The global local LLM config, to provide model context. */
-  localLlm?: LocalLlmConfig;
-}
-
-// ─── Phase 2: Project Analysis Types ──────────────────────────────────────
-
-/** Recognized language/runtime. */
-export type Language =
-  | 'typescript'
-  | 'javascript'
-  | 'csharp'
-  | 'python'
-  | 'go'
-  | 'java'
-  | 'rust'
-  | 'ruby'
-  | 'php'
-  | 'other';
-
-/** Recognized framework. */
-export type Framework =
-  | 'react'
-  | 'nextjs'
-  | 'angular'
-  | 'vue'
-  | 'svelte'
-  | 'express'
-  | 'nestjs'
-  | 'fastify'
-  | 'hono'
-  | 'aspnet'
-  | 'blazor'
-  | 'django'
-  | 'flask'
-  | 'fastapi'
-  | 'gin'
-  | 'spring'
-  | 'rails'
-  | 'laravel'
-  | 'other';
-
-/** Recognized project type. */
-export type ProjectType =
-  | 'frontend'
-  | 'backend'
-  | 'fullstack'
-  | 'library'
-  | 'api'
-  | 'cli'
-  | 'worker'
-  | 'other';
-
-/** Detected tech stack for a repo. */
-export interface TechStack {
-  languages: Language[];
-  frameworks: Framework[];
-  buildTools: string[];
-  projectType: ProjectType;
-}
-
-/** A detected API endpoint or route. */
-export interface ApiEndpoint {
-  method: string;
-  path: string;
-  source?: string;
-}
-
-/** An inter-repo dependency reference. */
-export interface RepoDependency {
-  /** Name of the dependency (npm package, NuGet package, etc.). */
-  name: string;
-  /** Type of dependency. */
-  type: 'npm' | 'nuget' | 'pip' | 'go' | 'other';
-  /** Version constraint if known. */
-  version?: string;
-}
-
-/** Port/service configuration detected in a repo. */
-export interface ServicePort {
-  port: number;
-  protocol: 'http' | 'https' | 'grpc' | 'other';
-  source: string;
-}
-
-/** Full analysis result for a single project/repo. */
-export interface ProjectAnalysis {
-  /** Repo name. */
-  name: string;
-  /** Repo path. */
-  path: string;
-  /** Detected tech stack. */
-  techStack: TechStack;
-  /** Detected API endpoints. */
-  endpoints: ApiEndpoint[];
-  /** Detected dependencies. */
-  dependencies: RepoDependency[];
-  /** Detected ports/services. */
-  ports: ServicePort[];
-  /** Summary from README.md if found. */
-  readmeSummary: string | null;
-  /** Existing AI config files found in the repo. */
-  existingAIConfigs: ExistingAIConfig[];
-  /** Produced/published packages by this repo. */
-  produces?: { name: string; type: 'npm' | 'nuget' | 'other'; version?: string; contributing?: string[] }[];
-  /** NuGet feeds detected in the repo's NuGet.config files. */
-  nugetFeeds?: { name: string; url: string }[];
-  /** Detected messaging topology. */
-  messaging?: MessagingTopology;
-  /** Detected run configurations. */
-  runConfig?: RunConfig;
-}
-
-export interface MessagePublisher {
-  contractType: string;
-  topicOrQueue: string;
-  publisherFile: string;
-}
-
-export interface MessageSubscriber {
-  contractType: string;
-  handlerFile: string;
-  registrationFile: string;
-}
-
-export interface MessagingTopology {
-  publishers: MessagePublisher[];
-  subscribers: MessageSubscriber[];
-}
-
-export interface RunConfigEntryPoint {
-  projectPath: string;
-  type: string;
-  command?: string;
-  port?: number;
-}
-
-export interface RunConfigDatabase {
-  provider: string;
-  host: string;
-  configFile: string;
-}
-
-export interface RunConfigSharedInfraWarning {
-  resource: string;
-  host: string;
-  configFile: string;
-  warning: string;
-}
-
-export interface RunConfigSecret {
-  file: string;
-  lineHint: string;
-}
-
-export interface RunConfig {
-  entryPoints: RunConfigEntryPoint[];
-  databases: RunConfigDatabase[];
-  sharedInfraWarnings: RunConfigSharedInfraWarning[];
-  committedSecrets: RunConfigSecret[];
-  externalDependencies: string[];
-}
-
-/** An existing AI configuration file found in a repo. */
-export interface ExistingAIConfig {
-  /** Which assistant this config is for. */
-  assistant: AIAssistant | 'agents';
-  /** File path relative to repo root. */
-  relativePath: string;
-  /** First 500 chars of the content for context. */
-  contentPreview: string;
-}
-
-// ─── Phase 3: Service Orchestration Types ─────────────────────────────────
-
-/** How to start a single service/project. */
-export interface ServiceConfig {
-  /** Display name for the service. */
-  name: string;
-  /** Absolute path to the project directory. */
-  cwd: string;
-  /** The command to run (e.g., 'npm', 'dotnet', 'python'). */
-  command: string;
-  /** Arguments for the command. */
-  args: string[];
-  /** Optional port the service listens on. */
-  port?: number;
-  /** How the start command was detected. */
-  source: 'package.json' | 'dotnet' | 'docker-compose' | 'aspire' | 'python' | 'go' | 'makefile' | 'manual';
-}
-
-/** Detected orchestration tool in a workspace. */
-export interface OrchestrationDetection {
-  /** Which tool was found. */
-  tool: 'docker-compose' | 'aspire' | 'tilt' | 'procfile' | 'makefile';
-  /** Path to the config file. */
-  configPath: string;
-  /** Start command for this tool. */
-  startCommand: string;
-  /** Stop command for this tool. */
-  stopCommand: string;
-}
-
-/** A currently running service process. */
-export interface RunningService {
-  /** Service name. */
-  name: string;
-  /** Process ID. */
-  pid: number;
-  /** Service config used to start it. */
-  config: ServiceConfig;
-  /** Timestamp when started. */
-  startedAt: string;
-}
-
-/** State file saved to track running services. */
-export interface RunningState {
-  /** Workspace path this state belongs to. */
-  workspacePath: string;
-  /** List of running services. */
-  services: RunningService[];
-  /** Timestamp when the state was last updated. */
-  updatedAt: string;
-}
-
-// ─── Per-Repo Sync State ──────────────────────────────────────────────────
-
-/**
- * Classified outcome of a sync/rebase attempt for a single repo.
- * See `utils/multi-git.ts` for the meaning of each value.
- */
-export type SyncStatus = 'up-to-date' | 'rebased' | 'conflict' | 'stash-conflict' | 'error';
-
-/** Persisted sync/validation state for a single repo in a workspace. */
-export interface RepoSyncState {
-  /** Directory name of the repo. */
-  repoName: string;
-  /** ISO timestamp of the last sync attempt. */
-  lastSyncedAt?: string;
-  /** Classified result of the last sync. */
-  lastSyncStatus?: SyncStatus;
-  /** Human-readable message from the last sync. */
-  lastSyncMessage?: string;
-  /** True when the repo pulled in new commits and has not yet been re-validated. */
-  pendingValidation?: boolean;
-  /** Result of the last validation run (e.g. test/e2e), if any. */
-  lastValidationResult?: 'pass' | 'fail' | null;
-  /** ISO timestamp of the last validation run. */
-  lastValidatedAt?: string;
-}
-
-/** State file saved to track per-repo sync/validation status (`.nexusflow-state.json`). */
-export interface WorkspaceState {
-  /** Workspace path this state belongs to. */
-  workspacePath: string;
-  /** Per-repo state, keyed by repo name. */
-  repos: Record<string, RepoSyncState>;
-  /** Timestamp when the state was last updated. */
-  updatedAt: string;
-}
-
-// ─── Phase 3: Dependency Graph Types ──────────────────────────────────────
-
-/** A node in the workspace dependency graph. */
-export interface DependencyNode {
-  /** Repository name. */
-  repoName: string;
-  /** Absolute path to the repository. */
-  repoPath: string;
-  /** Names of repos this one depends on. */
-  dependsOn: string[];
-  /** Names of repos that depend on this one. */
-  dependedOnBy: string[];
-}
-
-/** The full dependency graph for a workspace. */
-export type DependencyGraph = Map<string, DependencyNode>;

package/src/utils/detect-ai.test.ts

@@ -1,44 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { execa } from 'execa';
-import { detectAIAssistants } from './detect-ai.js';
-
-vi.mock('execa');
-
-describe('detectAIAssistants', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it('should detect claude and antigravity when commands exit with 0', async () => {
-    vi.mocked(execa).mockImplementation((command: any, args?: any, options?: any): any => {
-      if (command === 'claude' || command === 'agy') {
-        return Promise.resolve({ exitCode: 0 } as any);
-      }
-      return Promise.resolve({ exitCode: 1 } as any);
-    });
-
-    const result = await detectAIAssistants();
-
-    expect(result).toEqual([
-      { name: 'claude', displayName: 'Claude Code', detected: true, command: 'claude' },
-      { name: 'antigravity', displayName: 'Antigravity', detected: true, command: 'agy' },
-      { name: 'codex', displayName: 'OpenAI Codex', detected: false },
-      { name: 'copilot', displayName: 'GitHub Copilot', detected: true },
-      { name: 'cursor', displayName: 'Cursor', detected: false },
-    ]);
-  });
-
-  it('should handle failures gracefully and set detected to false', async () => {
-    vi.mocked(execa).mockRejectedValue(new Error('Spawn error'));
-
-    const result = await detectAIAssistants();
-
-    expect(result).toEqual([
-      { name: 'claude', displayName: 'Claude Code', detected: false },
-      { name: 'antigravity', displayName: 'Antigravity', detected: false },
-      { name: 'codex', displayName: 'OpenAI Codex', detected: false },
-      { name: 'copilot', displayName: 'GitHub Copilot', detected: true },
-      { name: 'cursor', displayName: 'Cursor', detected: false },
-    ]);
-  });
-});

package/src/utils/detect-ai.ts

@@ -1,84 +0,0 @@
-/**
- * @module utils/detect-ai
- * Detects which AI coding assistants are available on the system.
- */
-
-import { execa } from 'execa';
-
-import type { AIAssistant, DetectedAI } from '../types.js';
-
-/**
- * Attempts to run `<command> --version` and returns `true` if the process
- * exits successfully (exit code 0).
- */
-async function commandExists(command: string): Promise<boolean> {
-  try {
-    const result = await execa(command, ['--version'], {
-      reject: false,
-      shell: process.platform === 'win32',
-    });
-    return result.exitCode === 0;
-  } catch {
-    // The command could not be spawned at all (not in PATH).
-    return false;
-  }
-}
-
-/**
- * Probes the system for known AI coding assistants and returns their status.
- *
- * Detection rules:
- * - **Claude**: detected if `claude` *or* `antigravity` is on PATH.
- *   When Antigravity is found it is labelled as `'claude'` because it
- *   generates `CLAUDE.md` context files.
- * - **Codex**: detected if `codex` is on PATH.
- * - **Copilot**: always shown as an option (convention-based via
- *   `.github/copilot-instructions.md`).
- * - **Cursor**: detected if `cursor` is on PATH.
- *
- * @returns An array of {@link DetectedAI} results, one per assistant.
- */
-export async function detectAIAssistants(): Promise<DetectedAI[]> {
-  // Run all probes concurrently.
-  const [hasClaude, hasAntigravity, hasCodex, hasCursor] = await Promise.all([
-    commandExists('claude'),
-    commandExists('agy'),
-    commandExists('codex'),
-    commandExists('cursor'),
-  ]);
-
-  const results: DetectedAI[] = [
-    {
-      name: 'claude' as AIAssistant,
-      displayName: 'Claude Code',
-      detected: hasClaude,
-      ...(hasClaude ? { command: 'claude' } : {}),
-    },
-    {
-      name: 'antigravity' as AIAssistant,
-      displayName: 'Antigravity',
-      detected: hasAntigravity,
-      ...(hasAntigravity ? { command: 'agy' } : {}),
-    },
-    {
-      name: 'codex' as AIAssistant,
-      displayName: 'OpenAI Codex',
-      detected: hasCodex,
-      ...(hasCodex ? { command: 'codex' } : {}),
-    },
-    {
-      name: 'copilot' as AIAssistant,
-      displayName: 'GitHub Copilot',
-      // Copilot is convention-based; always available as an option.
-      detected: true,
-    },
-    {
-      name: 'cursor' as AIAssistant,
-      displayName: 'Cursor',
-      detected: hasCursor,
-      ...(hasCursor ? { command: 'cursor' } : {}),
-    },
-  ];
-
-  return results;
-}

package/src/utils/detect-editors.test.ts

@@ -1,48 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { execa } from 'execa';
-import { detectEditors } from './detect-editors.js';
-
-vi.mock('execa');
-
-describe('detectEditors', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it('should return detected = true for editors whose commands exit with 0', async () => {
-    vi.mocked(execa).mockImplementation((command: any, args?: any, options?: any): any => {
-      if (command === 'code' || command === 'cursor') {
-        return Promise.resolve({ exitCode: 0 } as any);
-      }
-      return Promise.resolve({ exitCode: 1 } as any);
-    });
-
-    const result = await detectEditors();
-
-    expect(result).toEqual([
-      { name: 'VS Code', command: 'code', detected: true },
-      { name: 'VS Code Insiders', command: 'code-insiders', detected: false },
-      { name: 'Cursor', command: 'cursor', detected: true },
-      { name: 'Antigravity', command: 'antigravity', detected: false },
-    ]);
-
-    const isWin = process.platform === 'win32';
-    expect(execa).toHaveBeenCalledWith('code', ['--version'], { reject: false, shell: isWin });
-    expect(execa).toHaveBeenCalledWith('code-insiders', ['--version'], { reject: false, shell: isWin });
-    expect(execa).toHaveBeenCalledWith('cursor', ['--version'], { reject: false, shell: isWin });
-    expect(execa).toHaveBeenCalledWith('antigravity', ['--version'], { reject: false, shell: isWin });
-  });
-
-  it('should return detected = false for all editors if execa throws an error', async () => {
-    vi.mocked(execa).mockRejectedValue(new Error('Spawn error'));
-
-    const result = await detectEditors();
-
-    expect(result).toEqual([
-      { name: 'VS Code', command: 'code', detected: false },
-      { name: 'VS Code Insiders', command: 'code-insiders', detected: false },
-      { name: 'Cursor', command: 'cursor', detected: false },
-      { name: 'Antigravity', command: 'antigravity', detected: false },
-    ]);
-  });
-});

package/src/utils/detect-editors.ts

@@ -1,57 +0,0 @@
-/**
- * @module utils/detect-editors
- * Detects which code editors are available on the system.
- */
-
-import { execa } from 'execa';
-
-import type { DetectedEditor } from '../types.js';
-
-/** Editor definitions we probe for. */
-const EDITOR_CANDIDATES: ReadonlyArray<{ name: string; command: string }> = [
-  { name: 'VS Code', command: 'code' },
-  { name: 'VS Code Insiders', command: 'code-insiders' },
-  { name: 'Cursor', command: 'cursor' },
-  { name: 'Antigravity', command: 'antigravity' },
-];
-
-/**
- * Attempts to run `<command> --version` and returns `true` if the process
- * exits successfully (exit code 0).
- */
-async function commandExists(command: string): Promise<boolean> {
-  try {
-    const result = await execa(command, ['--version'], {
-      reject: false,
-      shell: process.platform === 'win32',
-    });
-    return result.exitCode === 0;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Probes the system for known code editors by checking whether their CLI
- * commands are available on PATH.
- *
- * Currently checks for:
- * - **VS Code** (`code`)
- * - **VS Code Insiders** (`code-insiders`)
- * - **Cursor** (`cursor`)
- * - **Antigravity** (`antigravity`)
- *
- * @returns An array of {@link DetectedEditor} results, one per editor.
- */
-export async function detectEditors(): Promise<DetectedEditor[]> {
-  const probes = EDITOR_CANDIDATES.map(async (editor) => {
-    const detected = await commandExists(editor.command);
-    return {
-      name: editor.name,
-      command: editor.command,
-      detected,
-    } satisfies DetectedEditor;
-  });
-
-  return Promise.all(probes);
-}