prjct-cli 1.6.7 → 1.6.9

package/core/types/diff.ts

@@ -0,0 +1,41 @@
+/**
+ * Diff Types
+ * Types for sync diff and preserved sections.
+ */
+
+export interface DiffSection {
+  name: string
+  type: 'added' | 'modified' | 'removed' | 'unchanged'
+  before?: string
+  after?: string
+  lineCount: number
+}
+
+export interface PreservedInfo {
+  name: string
+  lineCount: number
+}
+
+export interface SyncDiff {
+  hasChanges: boolean
+  added: DiffSection[]
+  modified: DiffSection[]
+  removed: DiffSection[]
+  preserved: PreservedInfo[]
+  tokensBefore: number
+  tokensAfter: number
+  tokenDelta: number
+}
+
+export interface DiffOptions {
+  showFullDiff?: boolean
+  colorize?: boolean
+}
+
+/** Parsed markdown section (header + content range) */
+export interface ParsedMarkdownSection {
+  name: string
+  content: string
+  startLine: number
+  endLine: number
+}

package/core/types/errors.ts

@@ -0,0 +1,111 @@
+/**
+ * Error Types and Catalog
+ * ErrorWithHint, ErrorCode, and ERRORS catalog.
+ */
+
+export interface ErrorWithHint {
+  message: string
+  hint?: string
+  file?: string
+  docs?: string
+  code?: string
+}
+
+export const ERRORS = {
+  NO_PROJECT: {
+    message: 'No prjct project found in this directory',
+    hint: "Run 'prjct init' to set up a new project",
+    file: '.prjct/prjct.config.json',
+  },
+  NO_PROJECT_ID: {
+    message: 'Project ID not found',
+    hint: "Run 'prjct init' or check .prjct/prjct.config.json",
+    file: '.prjct/prjct.config.json',
+  },
+  CONFIG_NOT_FOUND: {
+    message: 'Configuration file not found',
+    hint: "Run 'prjct init' to create project configuration",
+    file: '.prjct/prjct.config.json',
+  },
+  CONFIG_INVALID: {
+    message: 'Invalid configuration file',
+    hint: 'Check JSON syntax or delete .prjct/ and run init again',
+    file: '.prjct/prjct.config.json',
+  },
+  GIT_NOT_FOUND: {
+    message: 'Git repository not detected',
+    hint: "Run 'git init' first, then 'prjct init'",
+  },
+  GIT_NO_COMMITS: {
+    message: 'No commits in repository',
+    hint: 'Make an initial commit before using prjct',
+  },
+  GIT_DIRTY: {
+    message: 'Working directory has uncommitted changes',
+    hint: "Commit or stash changes, or use '--force' to override",
+  },
+  GIT_ON_MAIN: {
+    message: 'Cannot ship from main/master branch',
+    hint: 'Create a feature branch first: git checkout -b feature/your-feature',
+  },
+  GIT_OPERATION_FAILED: {
+    message: 'Git operation failed',
+    hint: 'Check git status and resolve any conflicts',
+  },
+  GH_NOT_AUTHENTICATED: {
+    message: 'GitHub CLI not authenticated',
+    hint: "Run 'gh auth login' to authenticate",
+    docs: 'https://cli.github.com/manual/gh_auth_login',
+  },
+  LINEAR_NOT_CONFIGURED: {
+    message: 'Linear integration not configured',
+    hint: "Run 'p. linear setup' to configure Linear",
+  },
+  LINEAR_API_ERROR: {
+    message: 'Linear API error',
+    hint: 'Check your API key or network connection',
+  },
+  NO_ACTIVE_TASK: {
+    message: 'No active task',
+    hint: 'Start a task with \'p. task "description"\'',
+  },
+  TASK_ALREADY_ACTIVE: {
+    message: 'A task is already in progress',
+    hint: "Complete it with 'p. done' or pause with 'p. pause'",
+  },
+  SYNC_FAILED: {
+    message: 'Project sync failed',
+    hint: 'Check file permissions and try again',
+  },
+  NOTHING_TO_SHIP: {
+    message: 'Nothing to ship',
+    hint: 'Make some changes first, then run ship',
+  },
+  PR_CREATE_FAILED: {
+    message: 'Failed to create pull request',
+    hint: 'Check GitHub auth and remote configuration',
+  },
+  NO_AI_PROVIDER: {
+    message: 'No AI provider detected',
+    hint: "Install Claude Code or Gemini CLI, then run 'prjct start'",
+    docs: 'https://prjct.app/docs',
+  },
+  PROVIDER_NOT_CONFIGURED: {
+    message: 'AI provider not configured for prjct',
+    hint: "Run 'prjct start' to configure your provider",
+  },
+  UNKNOWN_COMMAND: {
+    message: 'Unknown command',
+    hint: "Run 'prjct --help' to see available commands",
+  },
+  MISSING_PARAM: {
+    message: 'Missing required parameter',
+    hint: 'Check command usage below',
+  },
+  UNKNOWN: {
+    message: 'An unexpected error occurred',
+    hint: 'Check the error details and try again',
+  },
+} as const
+
+export type ErrorCode = keyof typeof ERRORS

package/core/types/index.ts

@@ -141,6 +141,10 @@ export type {
 } from './bus'
 export { EventTypes } from './bus'
 // =============================================================================
+// Citations Types
+// =============================================================================
+export type { ContextSources, SourceInfo, SourceType } from './citations'
+// =============================================================================
 // Command Types
 // =============================================================================
 export type {
@@ -172,6 +176,7 @@ export type {
   GlobalConfig as CommandGlobalConfig,
   HandlerFn,
   HealthResult,
+  InitOptions,
   LayerCounts,
   MigrationConfig,
   // Migration types
@@ -206,6 +211,16 @@ export type {
   ProjectState,
 } from './core'
 // =============================================================================
+// Diff Types
+// =============================================================================
+export type {
+  DiffOptions,
+  DiffSection,
+  ParsedMarkdownSection,
+  PreservedInfo,
+  SyncDiff,
+} from './diff'
+// =============================================================================
 // Domain Types
 // =============================================================================
 export type {
@@ -216,6 +231,11 @@ export type {
   TaskSwitchResult,
 } from './domain'
 // =============================================================================
+// Error Types
+// =============================================================================
+export type { ErrorCode, ErrorWithHint } from './errors'
+export { ERRORS } from './errors'
+// =============================================================================
 // Event Types
 // =============================================================================
 export type {
@@ -250,6 +270,8 @@ export type {
   GlobalConfigResult,
   InstallResult,
   LayerType,
+  MonorepoInfo,
+  MonorepoPackage,
   PathSessionInfo,
   PermissionCheckResult,
   PermissionLevel,
@@ -267,6 +289,19 @@ export type {
 } from './integrations'
 export { DEFAULT_JIRA_CONFIG, DEFAULT_LINEAR_CONFIG } from './integrations'
 // =============================================================================
+// JIRA Types
+// =============================================================================
+export type {
+  JiraAuthMode,
+  JiraIssue,
+  JiraProject,
+  JiraSearchResponse,
+} from './jira'
+// =============================================================================
+// Logger Types
+// =============================================================================
+export type { LogFunction, Logger, LogLevel as LoggerLogLevel } from './logger'
+// =============================================================================
 // Memory Types
 // =============================================================================
 export type {
@@ -299,6 +334,10 @@ export type {
   QualityScore,
 } from './outcomes'
 // =============================================================================
+// Output Types
+// =============================================================================
+export type { Output, OutputMetrics, OutputTier, TierConfig } from './output'
+// =============================================================================
 // Plugin Types
 // =============================================================================
 export type {
@@ -307,6 +346,20 @@ export type {
   WebhookPluginContext,
 } from './plugin'
 // =============================================================================
+// Project Sync Types (sync-service / context-generator)
+// =============================================================================
+export type {
+  AIToolResult,
+  ContextGeneratorConfig,
+  GitData,
+  ProjectCommands,
+  ProjectStats,
+  ProjectSyncResult,
+  SyncAgentInfo,
+  SyncMetrics,
+  SyncOptions,
+} from './project-sync'
+// =============================================================================
 // Provider Types (AI CLI abstraction)
 // =============================================================================
 export type {
@@ -322,15 +375,19 @@ export type {
 // =============================================================================
 export type {
   ServerConfig,
+  ServerHandle,
   ServerInstance,
   SSEClient,
   SSEEventType,
+  SSEInternalClient,
   SSEManager,
 } from './server'
+export { SSE_EVENTS } from './server'
 // =============================================================================
 // Service Types
 // =============================================================================
 export type {
+  AIToolConfig,
   ComplexityEstimate,
   MemoryServiceEntry,
   Severity,
@@ -355,6 +412,10 @@ export type {
   TimelineEvent,
 } from './session'
 // =============================================================================
+// Stack Types
+// =============================================================================
+export type { StackDetection, StackPackageJson } from './stack'
+// =============================================================================
 // Storage Types
 // =============================================================================
 export type {
@@ -393,6 +454,15 @@ export type {
   SyncStatus,
 } from './sync'
 // =============================================================================
+// Sync Verifier Types
+// =============================================================================
+export type {
+  VerificationCheck,
+  VerificationCheckResult,
+  VerificationConfig,
+  VerificationReport,
+} from './sync-verifier'
+// =============================================================================
 // Task Types
 // =============================================================================
 export type {
@@ -425,3 +495,13 @@ export type {
   MaybePromise,
   Runtime,
 } from './utils'
+// =============================================================================
+// Workflow Types
+// =============================================================================
+export type {
+  HookCommand,
+  HookPhase,
+  HookResult,
+  PreferenceScope,
+  WorkflowPreference,
+} from './workflow'

package/core/types/infrastructure.ts

@@ -7,6 +7,20 @@
 // Path Management Types
 // =============================================================================
 
+export interface MonorepoPackage {
+  name: string
+  path: string
+  relativePath: string
+  hasPrjctMd: boolean
+}
+
+export interface MonorepoInfo {
+  isMonorepo: boolean
+  type: 'pnpm' | 'npm' | 'yarn' | 'lerna' | 'nx' | 'rush' | 'turborepo' | null
+  rootPath: string
+  packages: MonorepoPackage[]
+}
+
 /**
  * Session information for date-based paths
  */

package/core/types/jira.ts

@@ -0,0 +1,51 @@
+/**
+ * JIRA Integration Types
+ * Types for JIRA API client.
+ */
+
+export interface JiraIssue {
+  id: string
+  key: string
+  self: string
+  fields: {
+    summary: string
+    description?:
+      | {
+          type: string
+          content: Array<{
+            type: string
+            content?: Array<{ type: string; text?: string }>[]
+          }>
+        }
+      | string
+      | null
+    status: {
+      id: string
+      name: string
+      statusCategory: { key: string; name: string }
+    }
+    priority?: { id: string; name: string }
+    issuetype: { id: string; name: string; subtask: boolean }
+    assignee?: { accountId: string; displayName: string; emailAddress?: string }
+    reporter?: { accountId: string; displayName: string; emailAddress?: string }
+    project: { id: string; key: string; name: string }
+    labels: string[]
+    created: string
+    updated: string
+  }
+}
+
+export interface JiraSearchResponse {
+  issues: JiraIssue[]
+  total: number
+  maxResults: number
+  startAt: number
+}
+
+export interface JiraProject {
+  id: string
+  key: string
+  name: string
+}
+
+export type JiraAuthMode = 'api-token' | 'mcp' | 'none'

package/core/types/logger.ts

@@ -0,0 +1,17 @@
+/**
+ * Logger Types
+ * Types for centralized logging.
+ */
+
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug'
+
+export type LogFunction = (...args: unknown[]) => void
+
+export interface Logger {
+  error: LogFunction
+  warn: LogFunction
+  info: LogFunction
+  debug: LogFunction
+  isEnabled: () => boolean
+  level: () => LogLevel | 'disabled'
+}

package/core/types/output.ts

@@ -0,0 +1,47 @@
+/**
+ * Output Types
+ * Types for CLI output, tiers, and metrics.
+ */
+
+/** Error shape for failWithHint (matches ErrorWithHint from ./errors). */
+export interface ErrorWithHintLike {
+  message: string
+  hint?: string
+  file?: string
+  docs?: string
+  code?: string
+}
+
+export type OutputTier = 'silent' | 'minimal' | 'compact' | 'verbose'
+
+export interface TierConfig {
+  maxLines: number
+  maxCharsPerLine: number
+  showMetrics: boolean
+}
+
+export interface OutputMetrics {
+  agents?: number
+  reduction?: number
+  tokens?: number
+}
+
+export interface Output {
+  start(): Output
+  end(): Output
+  spin(msg: string): Output
+  done(msg: string, metrics?: OutputMetrics): Output
+  fail(msg: string): Output
+  failWithHint(error: ErrorWithHintLike | string): Output
+  warn(msg: string): Output
+  info(msg: string): Output
+  debug(msg: string): Output
+  success(msg: string, metrics?: OutputMetrics): Output
+  list(items: string[], options?: { bullet?: string; indent?: number }): Output
+  table(rows: Array<Record<string, string | number>>, options?: { header?: boolean }): Output
+  box(title: string, content: string): Output
+  section(title: string): Output
+  stop(): Output
+  step(current: number, total: number, msg: string): Output
+  progress(current: number, total: number, msg?: string): Output
+}

package/core/types/project-sync.ts

@@ -0,0 +1,109 @@
+/**
+ * Project Sync Types
+ *
+ * Shared types for sync-service and context-generator.
+ * Single source of truth for GitData, ProjectStats, ProjectCommands, SyncAgentInfo.
+ */
+
+import type { SyncDiff } from './diff'
+import type { StackDetection } from './stack'
+import type { VerificationReport } from './sync-verifier'
+
+// =============================================================================
+// Git & Project Data
+// =============================================================================
+
+export interface GitData {
+  branch: string
+  commits: number
+  contributors: number
+  hasChanges: boolean
+  stagedFiles: string[]
+  modifiedFiles: string[]
+  untrackedFiles: string[]
+  recentCommits: { hash: string; message: string; date: string }[]
+  weeklyCommits: number
+}
+
+export interface ProjectStats {
+  fileCount: number
+  version: string
+  name: string
+  ecosystem: string
+  projectType: string
+  languages: string[]
+  frameworks: string[]
+}
+
+/** Project command strings (install, dev, test, etc.). Distinct from Command/CommandResult. */
+export interface ProjectCommands {
+  install: string
+  run?: string
+  test: string
+  build: string
+  dev: string
+  lint: string
+  format: string
+}
+
+/** Agent info as produced by sync/context (name, type, skill). Distinct from types/agents.AgentInfo. */
+export interface SyncAgentInfo {
+  name: string
+  type: 'workflow' | 'domain'
+  skill?: string
+}
+
+// =============================================================================
+// Sync Metrics & Options
+// =============================================================================
+
+export interface SyncMetrics {
+  duration: number
+  originalSize: number
+  filteredSize: number
+  compressionRate: number
+}
+
+export interface SyncOptions {
+  aiTools?: string[]
+  preview?: boolean
+  skipConfirmation?: boolean
+  packagePath?: string
+  packageName?: string
+}
+
+export interface AIToolResult {
+  toolId: string
+  outputFile: string
+  success: boolean
+}
+
+// =============================================================================
+// Sync Result & Context Generator Config
+// =============================================================================
+
+export interface ProjectSyncResult {
+  success: boolean
+  projectId: string
+  cliVersion: string
+  git: GitData
+  stats: ProjectStats
+  commands: ProjectCommands
+  stack: StackDetection
+  agents: SyncAgentInfo[]
+  skills: { agent: string; skill: string }[]
+  skillsInstalled: { name: string; agent: string; status: 'installed' | 'skipped' | 'error' }[]
+  contextFiles: string[]
+  aiTools: AIToolResult[]
+  syncMetrics?: SyncMetrics
+  verification?: VerificationReport
+  error?: string
+  isPreview?: boolean
+  previewDiff?: SyncDiff
+}
+
+export interface ContextGeneratorConfig {
+  projectId: string
+  projectPath: string
+  globalPath: string
+}

package/core/types/server.ts

@@ -9,6 +9,8 @@ import type { Context, Hono } from 'hono'
 // Server Types
 // =============================================================================
 
+export type ServerHandle = { stop: () => void } | null
+
 export interface ServerConfig {
   port: number
   host?: string
@@ -31,23 +33,39 @@ export interface ServerInstance {
 
 export interface SSEClient {
   id: string
+  connectedAt: string
   send: (event: string, data: unknown) => void
   close: () => void
 }
 
+export interface SSEInternalClient {
+  client: SSEClient
+  heartbeatInterval: ReturnType<typeof setInterval>
+  ttlTimeout: ReturnType<typeof setTimeout>
+  abortController: AbortController
+}
+
 export interface SSEManager {
   handleConnection: (c: Context) => Response
   broadcast: (event: string, data: unknown) => void
   getClientCount: () => number
+  shutdown: () => void
 }
 
-export type SSEEventType =
-  | 'connected'
-  | 'session.started'
-  | 'session.updated'
-  | 'session.completed'
-  | 'task.created'
-  | 'task.updated'
-  | 'feature.shipped'
-  | 'sync.completed'
-  | 'error'
+export const SSE_EVENTS = {
+  TASK_STARTED: 'task:started',
+  TASK_COMPLETED: 'task:completed',
+  TASK_PAUSED: 'task:paused',
+  TASK_RESUMED: 'task:resumed',
+  FEATURE_CREATED: 'feature:created',
+  FEATURE_SHIPPED: 'feature:shipped',
+  IDEA_CAPTURED: 'idea:captured',
+  IDEA_CONVERTED: 'idea:converted',
+  STATE_UPDATED: 'state:updated',
+  QUEUE_UPDATED: 'queue:updated',
+  CONNECTED: 'connected',
+  HEARTBEAT: 'heartbeat',
+  ERROR: 'error',
+} as const
+
+export type SSEEventType = (typeof SSE_EVENTS)[keyof typeof SSE_EVENTS]

package/core/types/services.ts

@@ -54,6 +54,20 @@ export interface SkillSearchResult {
   matchedTerms?: string[]
 }
 
+// =============================================================================
+// AI Tools Registry Types
+// =============================================================================
+
+export interface AIToolConfig {
+  id: string
+  name: string
+  outputFile: string
+  outputPath: 'repo' | 'global'
+  maxTokens: number
+  format: 'detailed' | 'concise' | 'minimal' | 'json'
+  description: string
+}
+
 // =============================================================================
 // Memory Service Types
 // =============================================================================

package/core/types/stack.ts

@@ -0,0 +1,19 @@
+/**
+ * Stack Detection Types
+ * Types for project technology stack detection.
+ */
+
+export interface StackDetection {
+  hasFrontend: boolean
+  hasBackend: boolean
+  hasDatabase: boolean
+  hasDocker: boolean
+  hasTesting: boolean
+  frontendType: 'web' | 'mobile' | 'both' | null
+  frameworks: string[]
+}
+
+export interface StackPackageJson {
+  dependencies?: Record<string, string>
+  devDependencies?: Record<string, string>
+}