prjct-cli 0.20.1 → 0.21.0

package/core/integrations/notion/sync.ts

@@ -0,0 +1,311 @@
+/**
+ * Notion Sync Logic
+ * Sync prjct data to Notion databases.
+ */
+
+import type { ShippedFeature, Idea } from '../../types/storage'
+import type { NotionIntegrationConfig } from '../../types/integrations'
+import { notionClient } from './client'
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export interface SyncResult {
+  success: boolean
+  action: 'created' | 'updated' | 'skipped'
+  pageId?: string
+  url?: string
+  error?: string
+}
+
+// =============================================================================
+// Property Builders
+// =============================================================================
+
+/**
+ * Build Notion properties for a shipped feature
+ */
+function buildShippedProperties(
+  feature: ShippedFeature,
+  projectId: string
+): Record<string, unknown> {
+  const props: Record<string, unknown> = {
+    Name: {
+      title: [{ text: { content: feature.name } }],
+    },
+    Project: {
+      rich_text: [{ text: { content: projectId } }],
+    },
+  }
+
+  if (feature.version) {
+    props.Version = {
+      rich_text: [{ text: { content: feature.version } }],
+    }
+  }
+
+  if (feature.type) {
+    props.Type = {
+      select: { name: feature.type },
+    }
+  }
+
+  if (feature.shippedAt) {
+    props['Shipped Date'] = {
+      date: { start: feature.shippedAt.split('T')[0] },
+    }
+  }
+
+  if (feature.codeMetrics) {
+    const metrics = feature.codeMetrics
+    props['Lines Changed'] = {
+      number: (metrics.linesAdded || 0) + (metrics.linesRemoved || 0),
+    }
+    props['Files Changed'] = {
+      number: metrics.filesChanged || 0,
+    }
+    props.Commits = {
+      number: metrics.commits || 0,
+    }
+  }
+
+  if (feature.duration) {
+    props.Duration = {
+      rich_text: [{ text: { content: feature.duration } }],
+    }
+  }
+
+  if (feature.description) {
+    props.Description = {
+      rich_text: [{ text: { content: feature.description.slice(0, 2000) } }],
+    }
+  }
+
+  return props
+}
+
+/**
+ * Build Notion properties for an idea
+ */
+function buildIdeaProperties(
+  idea: Idea,
+  projectId: string
+): Record<string, unknown> {
+  const props: Record<string, unknown> = {
+    Idea: {
+      title: [{ text: { content: idea.text } }],
+    },
+    Project: {
+      rich_text: [{ text: { content: projectId } }],
+    },
+  }
+
+  if (idea.status) {
+    const statusMap: Record<string, string> = {
+      pending: 'Pending',
+      converted: 'Converted',
+      completed: 'Converted',
+      archived: 'Archived',
+    }
+    props.Status = {
+      status: { name: statusMap[idea.status] || 'Pending' },
+    }
+  }
+
+  if (idea.priority) {
+    props.Priority = {
+      select: { name: idea.priority },
+    }
+  }
+
+  if (idea.tags && idea.tags.length > 0) {
+    props.Tags = {
+      multi_select: idea.tags.map((tag) => ({ name: tag })),
+    }
+  }
+
+  const createdDate = idea.createdAt || idea.addedAt
+  if (createdDate) {
+    props.Created = {
+      date: { start: createdDate.split('T')[0] },
+    }
+  }
+
+  if (idea.convertedTo) {
+    props['Converted To'] = {
+      rich_text: [{ text: { content: idea.convertedTo } }],
+    }
+  }
+
+  return props
+}
+
+// =============================================================================
+// Sync Functions
+// =============================================================================
+
+/**
+ * Sync a shipped feature to Notion
+ */
+export async function syncShippedFeature(
+  projectId: string,
+  feature: ShippedFeature,
+  config: NotionIntegrationConfig
+): Promise<SyncResult> {
+  if (!config.enabled || !config.databases.shipped) {
+    return { success: false, action: 'skipped', error: 'Notion not configured' }
+  }
+
+  if (!notionClient.isReady()) {
+    return { success: false, action: 'skipped', error: 'Notion client not ready' }
+  }
+
+  try {
+    const databaseId = config.databases.shipped
+    const properties = buildShippedProperties(feature, projectId)
+
+    // Check if already exists (upsert)
+    const existingPageId = await notionClient.findPageByProjectAndName(
+      databaseId,
+      projectId,
+      feature.name
+    )
+
+    if (existingPageId) {
+      const page = await notionClient.updatePage(existingPageId, properties)
+      if (page) {
+        return {
+          success: true,
+          action: 'updated',
+          pageId: page.id,
+          url: page.url,
+        }
+      }
+    } else {
+      const page = await notionClient.createPage(databaseId, properties)
+      if (page) {
+        return {
+          success: true,
+          action: 'created',
+          pageId: page.id,
+          url: page.url,
+        }
+      }
+    }
+
+    return { success: false, action: 'skipped', error: 'Failed to sync' }
+  } catch (error) {
+    return {
+      success: false,
+      action: 'skipped',
+      error: (error as Error).message,
+    }
+  }
+}
+
+/**
+ * Sync an idea to Notion
+ */
+export async function syncIdea(
+  projectId: string,
+  idea: Idea,
+  config: NotionIntegrationConfig
+): Promise<SyncResult> {
+  if (!config.enabled || !config.databases.ideas) {
+    return { success: false, action: 'skipped', error: 'Notion not configured' }
+  }
+
+  if (!notionClient.isReady()) {
+    return { success: false, action: 'skipped', error: 'Notion client not ready' }
+  }
+
+  try {
+    const databaseId = config.databases.ideas
+    const properties = buildIdeaProperties(idea, projectId)
+
+    // Check if already exists (by ID in text)
+    const existingPageId = await notionClient.findPageByProjectAndName(
+      databaseId,
+      projectId,
+      idea.text
+    )
+
+    if (existingPageId) {
+      const page = await notionClient.updatePage(existingPageId, properties)
+      if (page) {
+        return {
+          success: true,
+          action: 'updated',
+          pageId: page.id,
+          url: page.url,
+        }
+      }
+    } else {
+      const page = await notionClient.createPage(databaseId, properties)
+      if (page) {
+        return {
+          success: true,
+          action: 'created',
+          pageId: page.id,
+          url: page.url,
+        }
+      }
+    }
+
+    return { success: false, action: 'skipped', error: 'Failed to sync' }
+  } catch (error) {
+    return {
+      success: false,
+      action: 'skipped',
+      error: (error as Error).message,
+    }
+  }
+}
+
+/**
+ * Full sync - sync all data to Notion
+ * Used for initial setup or manual resync
+ */
+export async function fullSync(
+  projectId: string,
+  config: NotionIntegrationConfig,
+  data: {
+    shipped?: ShippedFeature[]
+    ideas?: Idea[]
+  }
+): Promise<{
+  shipped: { synced: number; failed: number }
+  ideas: { synced: number; failed: number }
+}> {
+  const results = {
+    shipped: { synced: 0, failed: 0 },
+    ideas: { synced: 0, failed: 0 },
+  }
+
+  // Sync shipped features
+  if (data.shipped && config.databases.shipped) {
+    for (const feature of data.shipped) {
+      const result = await syncShippedFeature(projectId, feature, config)
+      if (result.success) {
+        results.shipped.synced++
+      } else {
+        results.shipped.failed++
+      }
+    }
+  }
+
+  // Sync ideas
+  if (data.ideas && config.databases.ideas) {
+    for (const idea of data.ideas) {
+      const result = await syncIdea(projectId, idea, config)
+      if (result.success) {
+        results.ideas.synced++
+      } else {
+        results.ideas.failed++
+      }
+    }
+  }
+
+  return results
+}

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/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