opencode-time-tracking 0.1.5

package/src/types/TimeTrackingConfig.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Configuration type for the time tracking plugin.
+ */
+
+/**
+ * Plugin configuration loaded from `.opencode/time-tracking.json`.
+ */
+export interface TimeTrackingConfig {
+  /**
+   * Path to the CSV output file.
+   *
+   * @remarks
+   * Supports three formats:
+   * - `~/path` - Expands to home directory
+   * - `/absolute/path` - Used as-is
+   * - `relative/path` - Relative to project directory
+   */
+  csv_file: string
+
+  /** Email address of the user for the worklog */
+  user_email: string
+
+  /** Default Jira account key for time entries */
+  default_account_key: string
+}

package/src/types/Todo.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Todo item type from OpenCode SDK.
+ */
+
+/**
+ * A todo item from the session's task list.
+ */
+export interface Todo {
+  /** The content/description of the todo item */
+  content?: string
+}

package/src/types/TokenUsage.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Token usage statistics type.
+ */
+
+/**
+ * Token consumption statistics for a session.
+ */
+export interface TokenUsage {
+  /** Number of input tokens consumed */
+  input: number
+
+  /** Number of output tokens generated */
+  output: number
+
+  /** Number of reasoning tokens used (for o1-style models) */
+  reasoning: number
+
+  /** Number of tokens read from cache */
+  cacheRead: number
+
+  /** Number of tokens written to cache */
+  cacheWrite: number
+}

package/src/types/ToolExecuteAfterInput.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Input type for tool.execute.after hook.
+ */
+
+/**
+ * Input received by the tool.execute.after hook.
+ */
+export interface ToolExecuteAfterInput {
+  /** Name of the tool that was executed */
+  tool: string
+
+  /** The OpenCode session identifier */
+  sessionID: string
+
+  /** Unique identifier for this tool call */
+  callID: string
+}

package/src/types/ToolExecuteAfterOutput.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Output type for tool.execute.after hook.
+ */
+
+/**
+ * Output data from the tool.execute.after hook.
+ */
+export interface ToolExecuteAfterOutput {
+  /** Display title for the tool execution */
+  title: string
+
+  /** Tool output content */
+  output: string
+
+  /** Tool-specific metadata (varies by tool type) */
+  metadata: unknown
+}

package/src/utils/CsvFormatter.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview CSV formatting utilities.
+ */
+
+/**
+ * Utility class for CSV formatting operations.
+ *
+ * @remarks
+ * Provides static methods for escaping and formatting values
+ * according to CSV standards.
+ */
+export class CsvFormatter {
+  /**
+   * Escapes a string value for CSV output.
+   *
+   * @param value - The string to escape
+   * @returns The escaped string with double quotes doubled
+   *
+   * @example
+   * ```typescript
+   * CsvFormatter.escape('Say "Hello"')  // Returns: Say ""Hello""
+   * ```
+   */
+  static escape(value: string): string {
+    return value.replace(/"/g, '""')
+  }
+
+  /**
+   * Formats a timestamp as an ISO date string (YYYY-MM-DD).
+   *
+   * @param timestamp - The Unix timestamp in milliseconds
+   * @returns The formatted date string
+   *
+   * @example
+   * ```typescript
+   * CsvFormatter.formatDate(1704067200000)  // Returns: "2024-01-01"
+   * ```
+   */
+  static formatDate(timestamp: number): string {
+    return new Date(timestamp).toISOString().split("T")[0]
+  }
+
+  /**
+   * Formats a timestamp as a time string (HH:MM:SS).
+   *
+   * @param timestamp - The Unix timestamp in milliseconds
+   * @returns The formatted time string in local time
+   *
+   * @example
+   * ```typescript
+   * CsvFormatter.formatTime(1704067200000)  // Returns: "12:00:00"
+   * ```
+   */
+  static formatTime(timestamp: number): string {
+    return new Date(timestamp).toTimeString().split(" ")[0]
+  }
+}

package/src/utils/DescriptionGenerator.ts

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview Generates human-readable descriptions from activity data.
+ */
+
+import type { ActivityData } from "../types/ActivityData"
+
+/**
+ * Generates human-readable descriptions from tool activities.
+ *
+ * @remarks
+ * Creates descriptions summarizing what tools were used and which files
+ * were affected during a session.
+ */
+export class DescriptionGenerator {
+  /**
+   * Generates a human-readable description of activities.
+   *
+   * @param activities - Array of activity data from the session
+   * @returns A formatted description string
+   *
+   * @remarks
+   * Groups activities by type:
+   * - File edits (edit + write tools)
+   * - File reads
+   * - Commands (bash)
+   * - Searches (glob + grep)
+   *
+   * Also includes file names if 5 or fewer files were touched.
+   *
+   * @example
+   * ```typescript
+   * const desc = DescriptionGenerator.generate(activities)
+   * // Returns: "3 file edit(s), 2 file read(s) - Files: index.ts, utils.ts"
+   * ```
+   */
+  static generate(activities: ActivityData[]): string {
+    if (activities.length === 0) {
+      return "No activities tracked"
+    }
+
+    const toolCounts = activities.reduce(
+      (acc, a) => {
+        acc[a.tool] = (acc[a.tool] || 0) + 1
+        return acc
+      },
+      {} as Record<string, number>
+    )
+
+    const filesWorkedOn = new Set<string>()
+
+    for (const activity of activities) {
+      if (activity.file) {
+        const fileName = activity.file.split("/").pop() || activity.file
+        filesWorkedOn.add(fileName)
+      }
+    }
+
+    const mainActivities: string[] = []
+
+    if (toolCounts.edit || toolCounts.write) {
+      mainActivities.push(
+        `${(toolCounts.edit || 0) + (toolCounts.write || 0)} file edit(s)`
+      )
+    }
+
+    if (toolCounts.read) {
+      mainActivities.push(`${toolCounts.read} file read(s)`)
+    }
+
+    if (toolCounts.bash) {
+      mainActivities.push(`${toolCounts.bash} command(s)`)
+    }
+
+    if (toolCounts.glob || toolCounts.grep) {
+      mainActivities.push(
+        `${(toolCounts.glob || 0) + (toolCounts.grep || 0)} search(es)`
+      )
+    }
+
+    let description =
+      mainActivities.length > 0
+        ? mainActivities.join(", ")
+        : `${activities.length} tool call(s)`
+
+    if (filesWorkedOn.size > 0 && filesWorkedOn.size <= 5) {
+      description += ` - Files: ${Array.from(filesWorkedOn).join(", ")}`
+    } else if (filesWorkedOn.size > 5) {
+      description += ` - ${filesWorkedOn.size} files`
+    }
+
+    return description
+  }
+
+  /**
+   * Generates a compact tool usage summary.
+   *
+   * @param activities - Array of activity data from the session
+   * @returns A compact summary string showing tool counts
+   *
+   * @example
+   * ```typescript
+   * const summary = DescriptionGenerator.generateToolSummary(activities)
+   * // Returns: "read(5x), edit(3x), bash(2x)"
+   * ```
+   */
+  static generateToolSummary(activities: ActivityData[]): string {
+    const toolCounts = activities.reduce(
+      (acc, a) => {
+        acc[a.tool] = (acc[a.tool] || 0) + 1
+        return acc
+      },
+      {} as Record<string, number>
+    )
+
+    return Object.entries(toolCounts)
+      .map(([t, c]) => `${t}(${c}x)`)
+      .join(", ")
+  }
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": ["bun-types", "node"]
+  },
+  "include": ["src/**/*"]
+}