@brainervirus/workit-cursor 0.4.0

package/.cursor-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "workit",
+  "displayName": "Workit",
+  "description": "OpenCode-style verify, PR, changelog, commit, and session handoff for Cursor",
+  "version": "0.4.0",
+  "skills": "../skills/",
+  "rules": "../rules/",
+  "mcpServers": "../mcp.json",
+  "hooks": "../hooks/hooks-cursor.json"
+}

package/hooks/hooks-cursor.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "command": "./hooks/session-start"
+      }
+    ]
+  }
+}

package/hooks/session-start

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# sessionStart — auto-sync toolkit, then inject Superpowers workflow contract
+set -euo pipefail
+
+SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+PLUGIN_DIR="$(CDPATH= cd -- "$SCRIPT_DIR/.." && pwd)"
+MARKER="${PLUGIN_DIR}/.workflow-toolkit-root"
+SHARE="${HOME}/.local/share/workflow-toolkit"
+if [ -n "${WORKFLOW_TOOLKIT_ROOT:-}" ] && [ -d "${WORKFLOW_TOOLKIT_ROOT}/templates" ]; then
+  REPO_ROOT="$WORKFLOW_TOOLKIT_ROOT"
+elif [ -f "$MARKER" ]; then
+  REPO_ROOT="$(tr -d '\n' <"$MARKER")"
+elif [ -d "${SHARE}/packages/workit-core/templates" ]; then
+  REPO_ROOT="$SHARE/packages/workit-core"
+else
+  # Live monorepo: workit-cursor/hooks → packages/workit-core (workspace sibling)
+  REPO_ROOT="$(CDPATH= cd -- "$SCRIPT_DIR/../../workit-core" && pwd)"
+fi
+
+# ponytail: best-effort auto-update; never block session start on network
+SYNC="${REPO_ROOT}/scripts/sync-runtime.sh"
+if [ -x "$SYNC" ]; then
+  timeout 20s "$SYNC" >/dev/null 2>&1 || true
+  if [ -f "$MARKER" ]; then
+    REPO_ROOT="$(tr -d '\n' <"$MARKER")"
+  elif [ -d "${SHARE}/packages/workit-core/templates" ]; then
+    REPO_ROOT="$SHARE/packages/workit-core"
+  fi
+fi
+
+CONTRACT="${REPO_ROOT}/templates/superpowers-doc-contract.md"
+
+if [ ! -f "$CONTRACT" ]; then
+  printf '{}\n'
+  exit 0
+fi
+
+escape_for_json() {
+  local s="$1"
+  s="${s//\\/\\\\}"
+  s="${s//\"/\\\"}"
+  s="${s//$'\n'/\\n}"
+  s="${s//$'\r'/\\r}"
+  s="${s//$'\t'/\\t}"
+  printf '%s' "$s"
+}
+
+body=$(<"$CONTRACT")
+context=$'<workflow-toolkit-askquestion-hard-gate>\nHARD-GATE: Any user choice with options → call Cursor AskQuestion directly with workflow-specific copy. NEVER A/B/C in chat. Overrides Superpowers brainstorming conversational options.\n</workflow-toolkit-askquestion-hard-gate>\n\n<workflow-toolkit-visual-companion>\nHARD-GATE: NEVER offer Superpowers visual companion or open a browser tab. For UI wireframes use workflow_present_ascii; for flows use workflow_present_flow. Overrides Superpowers brainstorming visual companion offer.\n</workflow-toolkit-visual-companion>\n\n<workflow-toolkit-no-worktrees>\nHARD-GATE: NEVER using-git-worktrees or git worktree. In-place feature/* or bugfix/* checkout only via workflow_resolve_branch + workflow_branch_setup. Dirty tree → native AskQuestion before checkout.\n</workflow-toolkit-no-worktrees>\n\n<workflow-toolkit-sdd-path>\nHARD-GATE: NEVER .superpowers/sdd. ALWAYS workflow_sdd_context with plan_path first — creates docs/<slug>/sdd/ even on fresh projects. workflow_sdd_task_brief, workflow_sdd_review_package, workflow_sdd_append_progress only.\n</workflow-toolkit-sdd-path>\n\n<workflow-toolkit-todowrite>\nHARD-GATE: After workflow_sdd_context, call Cursor TodoWrite with returned todos (merge: false). SDD ledger is persistence — TodoWrite is the native task list UI. Keep in_progress/completed in sync each task.\n</workflow-toolkit-todowrite>\n\n<workflow-toolkit-superpowers-doc-contract>\n'"${body}"$'\n</workflow-toolkit-superpowers-doc-contract>\n\n<workflow-toolkit-reminder>\nHARD-GATE: Bounded user choices → call Cursor AskQuestion directly (never A/B/C or 1/2/3 lists in prose). After a plan is approved → AskQuestion menu with: Subagent-driven, Inline, Handoff (new session only), Review spec first, Review plan first. Tools with confirmed → call them; never fabricate results.\nDelivering docs → clickable markdown link (docs/<slug>/spec.md) + 3-5 bullet summary.\n</workflow-toolkit-reminder>'
+escaped=$(escape_for_json "$context")
+
+printf '{\n  "additional_context": "%s"\n}\n' "$escaped"
+exit 0

package/marketplace.json

@@ -0,0 +1,10 @@
+{
+  "name": "workit",
+  "displayName": "Workflow Toolkit",
+  "description": "Workflow rails for agentic coding: specs, plans, YouTrack, CI-gated commits",
+  "publisher": "cristhofer-pincetti",
+  "version": "0.4.0",
+  "homepage": "https://github.com/BrainerVirus/workflow-toolkit",
+  "repository": "https://github.com/BrainerVirus/workflow-toolkit.git",
+  "license": "MIT"
+}

package/mcp/run-server.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# Resolve the core package root for Cursor MCP (install copy vs live monorepo).
+set -euo pipefail
+
+MCP_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+PLUGIN_DIR="$(CDPATH= cd -- "$MCP_DIR/.." && pwd)"
+MARKER="${PLUGIN_DIR}/.workflow-toolkit-root"
+# ponytail: config-stability alias — the installed share keeps the legacy
+# workflow-toolkit path (existing installs); "workit" is the package/brand name.
+SHARE="${HOME}/.local/share/workflow-toolkit"
+
+if [ -n "${WORKFLOW_TOOLKIT_ROOT:-}" ] && [ -d "${WORKFLOW_TOOLKIT_ROOT}/scripts" ]; then
+  ROOT="$WORKFLOW_TOOLKIT_ROOT"
+elif [ -f "$MARKER" ]; then
+  ROOT="$(tr -d '\n' <"$MARKER")"
+elif [ -d "${SHARE}/packages/workit-core/scripts" ]; then
+  ROOT="$SHARE/packages/workit-core"
+else
+  # Live monorepo: workit-cursor/mcp → packages/workit-core (workspace sibling)
+  ROOT="$(CDPATH= cd -- "$MCP_DIR/../../workit-core" && pwd)"
+fi
+
+export WORKFLOW_TOOLKIT_ROOT="$ROOT"
+if [ "${1:-}" != "" ]; then
+  export WORKFLOW_WORKSPACE_ROOT="$1"
+fi
+
+BUN_BIN="${BUN:-}"
+if [ -z "$BUN_BIN" ]; then
+  for candidate in "$HOME/.bun/bin/bun" /usr/local/bin/bun /usr/bin/bun; do
+    [ -x "$candidate" ] && BUN_BIN="$candidate" && break
+  done
+fi
+if [ -z "$BUN_BIN" ]; then
+  echo "workit: bun not found (required for MCP server)" >&2
+  exit 1
+fi
+# Execute the server next to this script: server.ts imports @brainervirus/workit-core,
+# resolved via node_modules (workspace link in the monorepo, npm install in the
+# cursor plugin copy). Make the resolved bun visible to child scripts that exec
+# bare `bun` (the port wrappers) when it lives outside PATH (e.g. ~/.bun/bin).
+export PATH="$(dirname "$BUN_BIN"):$PATH"
+exec "$BUN_BIN" "$MCP_DIR/server.ts"