Merge develop into main for v1.2.0 release

Author: wagnert

.gitignore

@@ -1,5 +1,4 @@
 node_modules/
 .opencode/
-*.js
 .DS_Store
 bun.lock

CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-03-01
+
+### Added
+
+- Postlink hook (`scripts/postlink.js`) that automatically creates `~/time_tracking/` with subdirectories (`bookings/`, `charts/`, `reports/`) and symlinks `.opencode/time_tracking` → `~/time_tracking` when the plugin is linked
+- `scripts/` directory included in npm package for hook distribution
+
+### Changed
+
+- Removed `*.js` from `.gitignore` (no build step, Bun loads `.ts` directly)
+- `plugin.json` now declares `hooks.postlink` for the linker
+
 ## [1.1.0] - 2026-03-01
 
 ### Added

README.md

@@ -52,6 +52,13 @@ npx opencode-link shell-env
 npx opencode-link time-tracking
 ```
 
+When linking `time-tracking`, a postlink hook automatically:
+
+1. Creates `~/time_tracking/` with subdirectories (`bookings/`, `charts/`, `reports/`)
+2. Symlinks `.opencode/time_tracking` → `~/time_tracking`
+
+This ensures time tracking data is stored globally in your home directory and shared across projects. If `~/time_tracking/` already exists, the hook only creates missing subdirectories. If `.opencode/time_tracking` is a real directory (not a symlink), it is left untouched.
+
 ## Configuration
 
 ### 1. Project Configuration

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techdivision/opencode-plugin-time-tracking",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Automatic time tracking plugin for OpenCode. Tracks session duration and tool usage, writing entries to a CSV file compatible with Jira worklog sync incl. commands, skills and agents.",
   "type": "module",
   "main": "src/Plugin.ts",
@@ -11,6 +11,7 @@
     "agents/",
     "commands/",
     "tools/",
+    "scripts/",
     "plugin.json"
   ],
   "keywords": ["opencode", "plugin", "time-tracking", "jira", "tempo"],

plugin.json

@@ -2,5 +2,8 @@
   "name": "time-tracking",
   "description": "Automatic time tracking plugin for OpenCode. Tracks session duration and tool usage, writing entries to a CSV file compatible with Jira worklog sync incl. commands, skills and agents.",
   "category": "standard",
-  "version": "1.0.0"
+  "version": "1.2.0",
+  "hooks": {
+    "postlink": "scripts/postlink.js"
+  }
 }

scripts/postlink.js

@@ -0,0 +1,47 @@
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Postlink hook for time-tracking plugin.
+ *
+ * Creates ~/time_tracking directory with required subdirectories
+ * and symlinks .opencode/time_tracking -> ~/time_tracking so that
+ * time tracking data is stored globally and shared across projects.
+ */
+export default function postlink({ targetDir, homeDir, log }) {
+  const timeTrackingDir = path.join(homeDir, 'time_tracking');
+  const symlinkPath = path.join(targetDir, 'time_tracking');
+
+  // 1. Create ~/time_tracking + subdirs if missing
+  for (const subdir of ['', 'bookings', 'charts', 'reports']) {
+    const dirPath = path.join(timeTrackingDir, subdir);
+    if (!fs.existsSync(dirPath)) {
+      fs.mkdirSync(dirPath, { recursive: true });
+      log.success(`Created ${dirPath.replace(homeDir, '~')}`);
+    }
+  }
+
+  // 2. Symlink .opencode/time_tracking -> ~/time_tracking
+  let targetExists = false;
+  let targetIsSymlink = false;
+  try {
+    const stat = fs.lstatSync(symlinkPath);
+    targetExists = true;
+    targetIsSymlink = stat.isSymbolicLink();
+  } catch {
+    targetExists = false;
+  }
+
+  if (targetExists && targetIsSymlink) {
+    const existing = fs.readlinkSync(symlinkPath);
+    if (existing === timeTrackingDir) return; // already correct
+    fs.unlinkSync(symlinkPath);
+    fs.symlinkSync(timeTrackingDir, symlinkPath);
+    log.warning(`time_tracking -> ~/time_tracking (overridden)`);
+  } else if (targetExists) {
+    log.warning(`time_tracking (real directory, not overriding)`);
+  } else {
+    fs.symlinkSync(timeTrackingDir, symlinkPath);
+    log.success(`time_tracking -> ~/time_tracking`);
+  }
+}