prjct-cli 0.35.4 → 0.37.0

package/core/types/provider.ts

@@ -0,0 +1,134 @@
+/**
+ * AI Provider Types
+ *
+ * Abstractions for supporting multiple AI coding agents:
+ * - Claude Code (CLI)
+ * - Gemini CLI (CLI)
+ * - Cursor IDE (GUI, project-level config)
+ *
+ * Key discovery: Skills use identical SKILL.md format for CLI providers.
+ * Cursor uses .mdc files with frontmatter for rules.
+ *
+ * @see https://geminicli.com/docs/cli/gemini-md/
+ * @see https://geminicli.com/docs/cli/skills/
+ * @see https://cursor.com/docs/context/rules
+ */
+
+/**
+ * Supported AI provider names
+ */
+export type AIProviderName = 'claude' | 'gemini' | 'cursor'
+
+/**
+ * Command format for each provider
+ * - Claude: Markdown files (.md)
+ * - Gemini: TOML files (.toml)
+ */
+export type CommandFormat = 'md' | 'toml'
+
+/**
+ * AI Provider configuration
+ * Defines paths and formats for each AI coding agent
+ */
+export interface AIProviderConfig {
+  /** Provider identifier */
+  name: AIProviderName
+
+  /** Display name for UI/logs */
+  displayName: string
+
+  /** CLI command name (e.g., 'claude', 'gemini'). Null for GUI apps like Cursor */
+  cliCommand: string | null
+
+  /** Global config directory (e.g., ~/.claude, ~/.gemini). Null for project-level only (Cursor) */
+  configDir: string | null
+
+  /** Context file name (CLAUDE.md, GEMINI.md, or prjct.mdc for Cursor) */
+  contextFile: string
+
+  /** Skills directory (e.g., ~/.claude/skills). Null for providers without skill support */
+  skillsDir: string | null
+
+  /** Commands directory relative to project (e.g., .claude/commands, .cursor/commands) */
+  commandsDir: string
+
+  /** Rules directory for project-level config (e.g., .cursor/rules). Only used by Cursor */
+  rulesDir?: string
+
+  /** Command file format */
+  commandFormat: CommandFormat
+
+  /** Settings file name (settings.json). Null if not applicable */
+  settingsFile: string | null
+
+  /** Project settings file (e.g., settings.local.json). Null if not applicable */
+  projectSettingsFile: string | null
+
+  /** Ignore file name (.claudeignore, .geminiignore, .cursorignore) */
+  ignoreFile: string
+
+  /** Whether config is project-level only (no global config directory) */
+  isProjectLevel?: boolean
+
+  /** URL for provider website */
+  websiteUrl: string
+
+  /** URL for provider documentation */
+  docsUrl: string
+}
+
+/**
+ * Provider detection result
+ */
+export interface ProviderDetectionResult {
+  /** Whether the provider CLI is installed */
+  installed: boolean
+
+  /** Provider version if installed */
+  version?: string
+
+  /** Path to the CLI executable */
+  path?: string
+}
+
+/**
+ * Result of provider selection during setup
+ */
+export interface ProviderSelectionResult {
+  /** Selected provider */
+  provider: AIProviderName
+
+  /** Whether user was prompted to choose (multiple installed) */
+  userSelected: boolean
+
+  /** Detection details for CLI-based providers */
+  detection: {
+    claude: ProviderDetectionResult
+    gemini: ProviderDetectionResult
+  }
+}
+
+/**
+ * Result of Cursor project detection
+ */
+export interface CursorProjectDetection {
+  /** Whether .cursor/ directory exists in project */
+  detected: boolean
+
+  /** Whether prjct router is installed */
+  routerInstalled: boolean
+
+  /** Project root path */
+  projectRoot?: string
+}
+
+/**
+ * Provider-aware branding configuration
+ */
+export interface ProviderBranding {
+  /** Commit footer text */
+  commitFooter: string
+
+  /** Short signature */
+  signature: string
+}

package/core/utils/branding.ts

@@ -1,9 +1,13 @@
 /**
  * Branding Configuration for prjct-cli
- * Single source of truth for all branding across CLI and Claude Code
+ * Single source of truth for all branding across CLI and AI agents
+ *
+ * Supports multiple AI providers (Claude Code, Gemini CLI)
  */
 
 import chalk from 'chalk'
+import type { AIProviderName } from '../types/provider'
+import { getProviderBranding, Providers } from '../infrastructure/ai-provider'
 
 const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
 const SPINNER_SPEED = 80
@@ -30,6 +34,9 @@ interface Branding {
     website: string
     docs: string
   }
+  // Provider-aware methods
+  getCommitFooter: (provider?: AIProviderName) => string
+  getSignature: (provider?: AIProviderName) => string
 }
 
 const branding: Branding = {
@@ -52,13 +59,13 @@ const branding: Branding = {
       chalk.cyan('⚡') + ' ' + chalk.cyan('prjct') + ' ' + chalk.cyan(SPINNER_FRAMES[frame % 10]) + ' ' + chalk.dim(msg || '')
   },
 
-  // Template/Claude (plain text)
+  // Template (plain text)
   template: {
     header: '⚡ prjct',
     footer: '⚡ prjct'
   },
 
-  // Git commit footer
+  // Default Git commit footer (Claude - for backward compatibility)
   commitFooter: `🤖 Generated with [p/](https://www.prjct.app/)
 Designed for [Claude](https://www.anthropic.com/claude)`,
 
@@ -66,6 +73,16 @@ Designed for [Claude](https://www.anthropic.com/claude)`,
   urls: {
     website: 'https://prjct.app',
     docs: 'https://prjct.app/docs'
+  },
+
+  // Provider-aware commit footer
+  getCommitFooter: (provider: AIProviderName = 'claude') => {
+    return getProviderBranding(provider).commitFooter
+  },
+
+  // Provider-aware signature
+  getSignature: (provider: AIProviderName = 'claude') => {
+    return getProviderBranding(provider).signature
   }
 }