@knpkv/jira-clockify 0.2.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knpkv/jira-clockify",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "description": "TUI for Jira-Clockify time tracking, attachable to neovim",
   "license": "MIT",
   "author": "knpkv",
@@ -13,29 +13,28 @@
   },
   "files": [
     "dist",
-    "nvim"
+    "nvim",
+    "skills"
   ],
   "dependencies": {
-    "@effect-atom/atom": "latest",
-    "@effect-atom/atom-react": "latest",
-    "@effect/cli": "latest",
-    "@effect/platform": "latest",
-    "@effect/platform-node": "latest",
+    "@effect/atom-react": "4.0.0-beta.87",
+    "@effect/platform-node": "4.0.0-beta.87",
     "@opentui/core": "https://pkg.pr.new/anomalyco/opentui/@opentui/core@367a94087821b3b5feedd35bbb57df43b10a286e",
     "@opentui/react": "https://pkg.pr.new/anomalyco/opentui/@opentui/react@367a94087821b3b5feedd35bbb57df43b10a286e",
-    "effect": "latest",
-    "react": "^19.1.0",
-    "@knpkv/atlassian-common": "^0.2.0",
-    "@knpkv/clockify-api-client": "^0.2.0",
-    "@knpkv/jira-api-client": "^0.2.0",
-    "@knpkv/jira-cli": "^0.1.1"
+    "effect": "4.0.0-beta.87",
+    "react": "^19.2.7",
+    "@knpkv/agent-skills": "^0.2.0",
+    "@knpkv/atlassian-common": "^0.3.0",
+    "@knpkv/jira-api-client": "^0.3.0",
+    "@knpkv/jira-cli": "^0.3.0",
+    "@knpkv/clockify-api-client": "^0.3.0"
   },
   "devDependencies": {
-    "@effect/vitest": "latest",
+    "@effect/vitest": "4.0.0-beta.87",
     "@types/node": "latest",
-    "@types/react": "^19.1.8",
-    "tsx": "^4.19.4",
-    "vitest": "latest"
+    "@types/react": "^19.2.17",
+    "tsx": "^4.22.4",
+    "vitest": "^4.1.9"
   },
   "scripts": {
     "start": "tsx src/bin.ts",

package/skills/jcf/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: jcf
+description: Use the @knpkv/jira-clockify CLI to track work across Jira and Clockify. Trigger when the user asks an agent to start, stop, discard, edit, inspect, or manually log time for Jira tickets; configure Jira OAuth or Clockify API access; list current Jira tickets; set default Clockify project, billable flag, or JQL; or launch the jcf TUI.
+---
+
+# Jcf
+
+Use the `jcf` binary to manage Jira-backed Clockify timers.
+
+## Preconditions
+
+- Configure both services before timer operations: Jira OAuth and Clockify API key.
+- Use `jcf auth status` to check readiness.
+- Timer operations write to Clockify and may write Jira worklogs; confirm ambiguous ticket keys, durations, dates, and comments before running them.
+- Use `jcf list --json` when an agent needs structured ticket data.
+
+## Setup
+
+```bash
+jcf auth status
+jcf auth jira create
+jcf auth jira configure
+jcf auth jira login
+jcf auth clockify setup
+```
+
+Configure defaults:
+
+```bash
+jcf config show
+jcf config set project
+jcf config set billable
+jcf config set jql 'assignee = currentUser() AND status != Done ORDER BY updated DESC'
+jcf config reset
+```
+
+## Timer Commands
+
+Launch the TUI:
+
+```bash
+jcf
+jcf tui
+```
+
+List available Jira tickets:
+
+```bash
+jcf list
+jcf list --json
+```
+
+Start work:
+
+```bash
+jcf start PROJ-123
+jcf start PROJ-123 --ago 15m
+jcf start PROJ-123 --since 09:30
+jcf start PROJ-123 --project <clockify-project-id> --billable
+```
+
+Stop or discard current work:
+
+```bash
+jcf status
+jcf stop
+jcf stop --project <clockify-project-id> --billable
+jcf discard
+```
+
+Log completed work manually:
+
+```bash
+jcf log PROJ-123 --time 1h30m
+jcf log PROJ-123 --time 45m --date 2026-06-24 --at 09:00 --comment "Pairing on release notes"
+```
+
+Edit the running timer:
+
+```bash
+jcf edit
+```
+
+## Agent Workflow
+
+1. Run `jcf auth status` and `jcf status` before changing timer state.
+2. Use `jcf list --json` to resolve issue keys when the user gives a vague ticket description.
+3. Prefer explicit flags for non-interactive work: issue key, duration, date, time, project id, billable flag, and comment.
+4. If no timer is running, `jcf stop` may offer an interactive correction interval; use `jcf log` for deterministic manual logging.

package/skills/jcf/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Jira Clockify CLI"
+  short_description: "Track Jira work in Clockify"
+  default_prompt: "Use $jcf to start, stop, log, or inspect Jira Clockify timers."