prjct-cli 0.20.0 → 0.21.0

package/core/integrations/notion/templates.ts

@@ -0,0 +1,234 @@
+/**
+ * Notion Database Templates
+ * Schemas for auto-creating prjct databases in Notion.
+ */
+
+import type { NotionDatabaseSchema } from './client'
+
+// =============================================================================
+// Database Schemas
+// =============================================================================
+
+/**
+ * Shipped Features Database Schema
+ * Tracks shipped features with metrics
+ */
+export const SHIPPED_DATABASE_SCHEMA: NotionDatabaseSchema = {
+  title: 'prjct: Shipped Features',
+  properties: {
+    Name: { type: 'title', title: {} },
+    Version: { type: 'rich_text', rich_text: {} },
+    Type: {
+      type: 'select',
+      select: {
+        options: [
+          { name: 'feature', color: 'blue' },
+          { name: 'fix', color: 'red' },
+          { name: 'improvement', color: 'green' },
+          { name: 'refactor', color: 'purple' },
+        ],
+      },
+    },
+    'Shipped Date': { type: 'date', date: {} },
+    'Lines Changed': { type: 'number', number: { format: 'number' } },
+    'Files Changed': { type: 'number', number: { format: 'number' } },
+    Commits: { type: 'number', number: { format: 'number' } },
+    Duration: { type: 'rich_text', rich_text: {} },
+    Description: { type: 'rich_text', rich_text: {} },
+    Project: { type: 'rich_text', rich_text: {} },
+  },
+}
+
+/**
+ * Roadmap Database Schema
+ * Tracks feature roadmap and progress
+ */
+export const ROADMAP_DATABASE_SCHEMA: NotionDatabaseSchema = {
+  title: 'prjct: Roadmap',
+  properties: {
+    Feature: { type: 'title', title: {} },
+    Status: {
+      type: 'status',
+      status: {
+        options: [
+          { name: 'Planned', color: 'gray' },
+          { name: 'Active', color: 'blue' },
+          { name: 'Completed', color: 'green' },
+          { name: 'Shipped', color: 'purple' },
+        ],
+        groups: [
+          { name: 'To Do', option_ids: [], color: 'gray' },
+          { name: 'In Progress', option_ids: [], color: 'blue' },
+          { name: 'Done', option_ids: [], color: 'green' },
+        ],
+      },
+    },
+    Priority: {
+      type: 'select',
+      select: {
+        options: [
+          { name: 'High', color: 'red' },
+          { name: 'Medium', color: 'yellow' },
+          { name: 'Low', color: 'gray' },
+        ],
+      },
+    },
+    Progress: { type: 'number', number: { format: 'percent' } },
+    Phase: { type: 'rich_text', rich_text: {} },
+    'Target Date': { type: 'date', date: {} },
+    Description: { type: 'rich_text', rich_text: {} },
+    Tasks: { type: 'number', number: { format: 'number' } },
+    Project: { type: 'rich_text', rich_text: {} },
+  },
+}
+
+/**
+ * Ideas Database Schema
+ * Captures and tracks ideas
+ */
+export const IDEAS_DATABASE_SCHEMA: NotionDatabaseSchema = {
+  title: 'prjct: Ideas',
+  properties: {
+    Idea: { type: 'title', title: {} },
+    Status: {
+      type: 'status',
+      status: {
+        options: [
+          { name: 'Pending', color: 'gray' },
+          { name: 'Converted', color: 'green' },
+          { name: 'Archived', color: 'default' },
+        ],
+        groups: [
+          { name: 'Not Started', option_ids: [], color: 'gray' },
+          { name: 'Done', option_ids: [], color: 'green' },
+        ],
+      },
+    },
+    Priority: {
+      type: 'select',
+      select: {
+        options: [
+          { name: 'high', color: 'red' },
+          { name: 'medium', color: 'yellow' },
+          { name: 'low', color: 'gray' },
+        ],
+      },
+    },
+    Tags: { type: 'multi_select', multi_select: { options: [] } },
+    Created: { type: 'date', date: {} },
+    'Converted To': { type: 'rich_text', rich_text: {} },
+    Project: { type: 'rich_text', rich_text: {} },
+  },
+}
+
+/**
+ * Active Tasks Database Schema
+ * Tracks current task queue
+ */
+export const TASKS_DATABASE_SCHEMA: NotionDatabaseSchema = {
+  title: 'prjct: Active Tasks',
+  properties: {
+    Task: { type: 'title', title: {} },
+    Priority: {
+      type: 'select',
+      select: {
+        options: [
+          { name: 'critical', color: 'red' },
+          { name: 'high', color: 'orange' },
+          { name: 'medium', color: 'yellow' },
+          { name: 'low', color: 'gray' },
+        ],
+      },
+    },
+    Type: {
+      type: 'select',
+      select: {
+        options: [
+          { name: 'feature', color: 'blue' },
+          { name: 'bug', color: 'red' },
+          { name: 'improvement', color: 'green' },
+          { name: 'chore', color: 'gray' },
+        ],
+      },
+    },
+    Section: {
+      type: 'select',
+      select: {
+        options: [
+          { name: 'active', color: 'blue' },
+          { name: 'backlog', color: 'gray' },
+        ],
+      },
+    },
+    Completed: { type: 'checkbox', checkbox: {} },
+    Agent: { type: 'rich_text', rich_text: {} },
+    Feature: { type: 'rich_text', rich_text: {} },
+    Created: { type: 'date', date: {} },
+    'Completed At': { type: 'date', date: {} },
+    Project: { type: 'rich_text', rich_text: {} },
+  },
+}
+
+// =============================================================================
+// Dashboard Template
+// =============================================================================
+
+/**
+ * Dashboard page content template
+ */
+export function getDashboardContent(
+  projectName: string,
+  databases: {
+    shipped?: string
+    roadmap?: string
+    ideas?: string
+    tasks?: string
+  }
+): string {
+  const sections = []
+
+  sections.push(`# ${projectName} Dashboard`)
+  sections.push('')
+  sections.push('This dashboard is automatically synced by prjct-cli.')
+  sections.push('')
+
+  if (databases.shipped) {
+    sections.push('## Shipped Features')
+    sections.push(`View all shipped features and metrics.`)
+    sections.push('')
+  }
+
+  if (databases.roadmap) {
+    sections.push('## Roadmap')
+    sections.push(`Track feature progress and planning.`)
+    sections.push('')
+  }
+
+  if (databases.ideas) {
+    sections.push('## Ideas')
+    sections.push(`Captured ideas and their status.`)
+    sections.push('')
+  }
+
+  if (databases.tasks) {
+    sections.push('## Active Tasks')
+    sections.push(`Current task queue and completion status.`)
+    sections.push('')
+  }
+
+  sections.push('---')
+  sections.push('Powered by [prjct-cli](https://prjct.app)')
+
+  return sections.join('\n')
+}
+
+// =============================================================================
+// All Schemas Export
+// =============================================================================
+
+export const ALL_DATABASE_SCHEMAS = {
+  shipped: SHIPPED_DATABASE_SCHEMA,
+  roadmap: ROADMAP_DATABASE_SCHEMA,
+  ideas: IDEAS_DATABASE_SCHEMA,
+  tasks: TASKS_DATABASE_SCHEMA,
+} as const

package/core/outcomes/analyzer.ts

@@ -6,47 +6,13 @@
  */
 
 import outcomeRecorder from './recorder'
-import type { Outcome, OutcomeSummary, QualityScore } from './types'
-
-/**
- * Pattern detected from outcomes.
- */
-export interface DetectedPattern {
-  /** Pattern description */
-  description: string
-
-  /** Confidence level (0-1) */
-  confidence: number
-
-  /** Number of occurrences supporting this pattern */
-  occurrences: number
-
-  /** Suggested action based on pattern */
-  suggestedAction?: string
-}
-
-/**
- * Agent performance metrics.
- */
-export interface AgentMetrics {
-  /** Agent name */
-  agent: string
-
-  /** Number of tasks completed */
-  tasksCompleted: number
-
-  /** Success rate (0-100) */
-  successRate: number
-
-  /** Average quality score */
-  avgQualityScore: number
-
-  /** Estimate accuracy */
-  estimateAccuracy: number
-
-  /** Best task types for this agent */
-  bestFor: string[]
-}
+import type {
+  Outcome,
+  OutcomeSummary,
+  QualityScore,
+  DetectedPattern,
+  AgentMetrics,
+} from '../types'
 
 /**
  * OutcomeAnalyzer - Extracts insights from outcomes.

package/core/outcomes/index.ts

@@ -31,4 +31,4 @@
 
 export { OutcomeRecorder, default as outcomeRecorder } from './recorder'
 export { OutcomeAnalyzer, default as outcomeAnalyzer } from './analyzer'
-export * from './types'
+export * from '../types'

package/core/outcomes/recorder.ts

@@ -9,7 +9,7 @@ import path from 'path'
 import * as fileHelper from '../utils/file-helper'
 import pathManager from '../infrastructure/path-manager'
 import { generateUUID } from '../schemas'
-import type { Outcome, OutcomeInput, OutcomeFilter } from './types'
+import type { Outcome, OutcomeInput, OutcomeFilter } from '../types'
 
 const OUTCOMES_DIR = 'outcomes'
 const OUTCOMES_FILE = 'outcomes.jsonl'

package/core/plugin/builtin/notion.ts

@@ -0,0 +1,178 @@
+/**
+ * Notion Plugin for prjct-cli
+ *
+ * Syncs prjct data to Notion databases on events.
+ * Activated when project has integrations.notion.enabled = true
+ *
+ * @version 1.0.0
+ *
+ * Configuration in GlobalConfig.integrations.notion:
+ * {
+ *   "enabled": true,
+ *   "databases": {
+ *     "shipped": "notion-db-id",
+ *     "ideas": "notion-db-id"
+ *   },
+ *   "syncOn": { "ship": true, "idea": true }
+ * }
+ */
+
+import { HookPoints } from '../hooks'
+import type { NotionIntegrationConfig } from '../../types/integrations'
+import type { ShippedFeature, Idea } from '../../types/storage'
+import { notionClient, syncShippedFeature, syncIdea } from '../../integrations/notion'
+
+interface NotionPluginContext {
+  projectId: string
+  config: NotionIntegrationConfig
+  apiToken?: string
+}
+
+const plugin = {
+  name: 'notion',
+  version: '1.0.0',
+  description: 'Sync prjct data to Notion',
+
+  // Plugin state
+  enabled: false,
+  projectId: null as string | null,
+  config: null as NotionIntegrationConfig | null,
+
+  /**
+   * Activate plugin
+   */
+  async activate(context: NotionPluginContext): Promise<void> {
+    const { projectId, config, apiToken } = context
+
+    if (!config?.enabled) {
+      return
+    }
+
+    // Initialize Notion client
+    notionClient.initialize(config, apiToken || process.env.NOTION_TOKEN)
+
+    if (!notionClient.isReady()) {
+      console.warn('[notion] API token not configured, plugin disabled')
+      return
+    }
+
+    plugin.enabled = true
+    plugin.projectId = projectId
+    plugin.config = config
+  },
+
+  /**
+   * Deactivate plugin
+   */
+  async deactivate(): Promise<void> {
+    plugin.enabled = false
+    plugin.projectId = null
+    plugin.config = null
+  },
+
+  /**
+   * Hook handlers
+   */
+  hooks: {
+    /**
+     * Sync shipped feature to Notion after ship
+     */
+    [HookPoints.AFTER_FEATURE_SHIP]: async function (data: {
+      feature: ShippedFeature
+      projectId?: string
+    }): Promise<void> {
+      if (!plugin.enabled || !plugin.config || !plugin.projectId) return
+      if (!plugin.config.syncOn?.ship) return
+
+      try {
+        const result = await syncShippedFeature(
+          data.projectId || plugin.projectId,
+          data.feature,
+          plugin.config
+        )
+
+        if (result.success) {
+          console.log(`[notion] Synced: ${data.feature.name} (${result.action})`)
+        } else if (result.error) {
+          console.warn(`[notion] Sync failed: ${result.error}`)
+        }
+      } catch (error) {
+        // Graceful degradation - don't fail the ship
+        console.warn('[notion] Sync error:', (error as Error).message)
+      }
+    },
+
+    /**
+     * Sync idea to Notion after capture
+     */
+    [HookPoints.AFTER_IDEA_CAPTURE]: async function (data: {
+      idea: Idea
+      projectId?: string
+    }): Promise<void> {
+      if (!plugin.enabled || !plugin.config || !plugin.projectId) return
+      if (!plugin.config.syncOn?.idea) return
+
+      try {
+        const result = await syncIdea(
+          data.projectId || plugin.projectId,
+          data.idea,
+          plugin.config
+        )
+
+        if (result.success) {
+          console.log(`[notion] Synced idea: ${data.idea.text.slice(0, 30)}... (${result.action})`)
+        } else if (result.error) {
+          console.warn(`[notion] Sync failed: ${result.error}`)
+        }
+      } catch (error) {
+        // Graceful degradation - don't fail the idea capture
+        console.warn('[notion] Sync error:', (error as Error).message)
+      }
+    },
+
+    /**
+     * Sync task completion (optional)
+     */
+    [HookPoints.AFTER_TASK_COMPLETE]: async function (data: {
+      taskName?: string
+      projectId?: string
+    }): Promise<void> {
+      if (!plugin.enabled || !plugin.config || !plugin.projectId) return
+      if (!plugin.config.syncOn?.done) return
+
+      // Task sync is optional and less critical
+      // Could update task status in Notion if database exists
+      if (data.taskName) {
+        console.log(`[notion] Task completed: ${data.taskName}`)
+      }
+    },
+  },
+
+  /**
+   * Check if plugin is active
+   */
+  isActive(): boolean {
+    return plugin.enabled && plugin.config?.enabled === true
+  },
+
+  /**
+   * Get current sync status
+   */
+  getStatus(): {
+    enabled: boolean
+    databases: number
+    lastSync?: string
+  } {
+    const dbCount = plugin.config?.databases
+      ? Object.values(plugin.config.databases).filter(Boolean).length
+      : 0
+
+    return {
+      enabled: plugin.enabled,
+      databases: dbCount,
+      lastSync: plugin.config?.lastSyncAt,
+    }
+  },
+}
+
+export default plugin

package/core/{plugins → plugin/builtin}/webhook.ts

@@ -18,25 +18,9 @@
  */
 
 import crypto from 'crypto'
-import { EventTypes } from '../bus'
-import { HookPoints } from '../plugin/hooks'
-
-interface WebhookConfig {
-  url?: string
-  events?: string[]
-  secret?: string
-}
-
-interface PluginContext {
-  config: WebhookConfig
-}
-
-interface WebhookPayload {
-  event: string
-  timestamp: string
-  source: string
-  data: unknown
-}
+import { EventTypes } from '../../bus'
+import { HookPoints } from '../hooks'
+import type { WebhookConfig, WebhookPluginContext, WebhookPayload } from '../../types'
 
 const plugin = {
   name: 'webhook',
@@ -46,12 +30,12 @@ const plugin = {
   // Plugin state
   config: null as WebhookConfig | null,
   enabled: false,
-  events: [] as string[],
+  enabledEvents: [] as string[],
 
   /**
    * Activate plugin
    */
-  async activate({ config }: PluginContext): Promise<void> {
+  async activate({ config }: WebhookPluginContext): Promise<void> {
     plugin.config = config
 
     if (!config.url) {
@@ -60,7 +44,7 @@ const plugin = {
     }
 
     plugin.enabled = true
-    plugin.events = config.events || [
+    plugin.enabledEvents = config.events || [
       EventTypes.SESSION_COMPLETED,
       EventTypes.FEATURE_SHIPPED,
       EventTypes.SNAPSHOT_CREATED

package/core/plugin/loader.ts

@@ -12,7 +12,7 @@
 import fs from 'fs/promises'
 import path from 'path'
 import { hookSystem } from './hooks'
-import { eventBus } from '../bus'
+import { eventBus, type EventCallback } from '../bus'
 import pathManager from '../infrastructure/path-manager'
 
 type PluginSource = 'builtin' | 'global' | 'project'
@@ -23,7 +23,7 @@ interface Plugin {
   version?: string
   description?: string
   hooks?: Record<string, HookHandler>
-  events?: Record<string, HookHandler>
+  events?: Record<string, EventCallback>
   commands?: Record<string, { handler: () => void; description?: string }>
   priority?: number
   activate?: (context: PluginContext) => Promise<void>
@@ -83,10 +83,10 @@ class PluginLoader {
   }
 
   /**
-   * Load built-in plugins from core/plugins
+   * Load built-in plugins from core/plugin/builtin
    */
   async loadBuiltinPlugins(): Promise<void> {
-    const builtinPath = path.join(__dirname, '..', 'plugins')
+    const builtinPath = path.join(__dirname, 'builtin')
 
     try {
       const files = await fs.readdir(builtinPath)
@@ -106,7 +106,7 @@ class PluginLoader {
    * Load global plugins from ~/.prjct-cli/plugins
    */
   async loadGlobalPlugins(): Promise<void> {
-    const globalPath = path.join(pathManager.getGlobalStoragePath(), 'plugins')
+    const globalPath = path.join(pathManager.getGlobalBasePath(), 'plugins')
 
     try {
       const files = await fs.readdir(globalPath)

package/core/plugin/registry.ts

@@ -57,7 +57,7 @@ class PluginRegistry {
 
     // Global plugins
     await this.discoverFromPath(
-      path.join(pathManager.getGlobalStoragePath(), 'plugins'),
+      path.join(pathManager.getGlobalBasePath(), 'plugins'),
       'global'
     )
   }
@@ -188,7 +188,7 @@ class PluginRegistry {
    * Install a plugin (copy to global plugins)
    */
   async install(sourcePath: string, name: string | null = null): Promise<void> {
-    const globalPluginsPath = path.join(pathManager.getGlobalStoragePath(), 'plugins')
+    const globalPluginsPath = path.join(pathManager.getGlobalBasePath(), 'plugins')
     await fs.mkdir(globalPluginsPath, { recursive: true })
 
     const stat = await fs.stat(sourcePath)