@bretwardjames/tw-bridge 0.5.0 → 0.7.0

package/dist/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import fs4 from "fs";
-import path5 from "path";
-import os4 from "os";
+import fs5 from "fs";
+import path6 from "path";
+import os5 from "os";
 
 // src/config.ts
 import fs from "fs";
@@ -241,8 +241,8 @@ async function oauthLogin(clientId, clientSecret, rl) {
   saveTokens(tokens);
   return tokens;
 }
-async function asanaFetch(path6, token, options = {}) {
-  const url = `${API_BASE}${path6}`;
+async function asanaFetch(path7, token, options = {}) {
+  const url = `${API_BASE}${path7}`;
   const res = await fetch(url, {
     ...options,
     headers: {
@@ -258,9 +258,9 @@ async function asanaFetch(path6, token, options = {}) {
   const json = await res.json();
   return json.data;
 }
-async function asanaFetchAll(path6, token) {
+async function asanaFetchAll(path7, token) {
   const results = [];
-  let nextPage = path6;
+  let nextPage = path7;
   while (nextPage) {
     const url = `${API_BASE}${nextPage}`;
     const res = await fetch(url, {
@@ -572,10 +572,319 @@ function mapAsanaPriority(fields) {
   return void 0;
 }
 
+// src/adapters/strety.ts
+import fs3 from "fs";
+import path4 from "path";
+import os3 from "os";
+import { execSync as execSync2 } from "child_process";
+import { createInterface as createInterface2 } from "readline/promises";
+import { stdin as stdin2, stdout as stdout2 } from "process";
+var API_BASE2 = "https://2.strety.com/api/v1";
+var OAUTH_AUTHORIZE2 = `${API_BASE2}/oauth/authorize`;
+var OAUTH_TOKEN2 = `${API_BASE2}/oauth/token`;
+var TOKEN_FILE2 = path4.join(os3.homedir(), ".config", "tw-bridge", "strety-tokens.json");
+function loadTokens2() {
+  try {
+    return JSON.parse(fs3.readFileSync(TOKEN_FILE2, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function saveTokens2(tokens) {
+  fs3.mkdirSync(path4.dirname(TOKEN_FILE2), { recursive: true });
+  fs3.writeFileSync(TOKEN_FILE2, JSON.stringify(tokens, null, 2), { mode: 384 });
+}
+async function refreshAccessToken2(tokens) {
+  const now = Date.now();
+  if (tokens.access_token && tokens.expires_at > now + 3e5) {
+    return tokens.access_token;
+  }
+  const res = await fetch(OAUTH_TOKEN2, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({
+      grant_type: "refresh_token",
+      refresh_token: tokens.refresh_token,
+      client_id: tokens.client_id,
+      client_secret: tokens.client_secret
+    })
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`Token refresh failed (${res.status}): ${body}`);
+  }
+  const data = await res.json();
+  tokens.access_token = data.access_token;
+  if (data.refresh_token) {
+    tokens.refresh_token = data.refresh_token;
+  }
+  tokens.expires_at = now + (data.expires_in ?? 7200) * 1e3;
+  saveTokens2(tokens);
+  return tokens.access_token;
+}
+var REDIRECT_URI = "https://localhost/callback";
+async function oauthLogin2(clientId, clientSecret, rl) {
+  const authUrl = `${OAUTH_AUTHORIZE2}?response_type=code&client_id=${encodeURIComponent(clientId)}&redirect_uri=${encodeURIComponent(REDIRECT_URI)}&scope=${encodeURIComponent("read write")}`;
+  console.log(`
+  Opening browser for authorization...`);
+  console.log(`  If it doesn't open, visit:
+  ${authUrl}
+`);
+  try {
+    execSync2(`xdg-open "${authUrl}" 2>/dev/null || open "${authUrl}" 2>/dev/null`, {
+      stdio: "ignore"
+    });
+  } catch {
+  }
+  console.log("  After authorizing, the browser will redirect to a page that");
+  console.log("  won't load. Copy the full URL from the address bar and paste it here.\n");
+  const pasted = (await rl.question("Paste the callback URL: ")).trim();
+  let code;
+  try {
+    const url = new URL(pasted);
+    const error = url.searchParams.get("error");
+    if (error) {
+      throw new Error(`OAuth error: ${error}`);
+    }
+    const authCode = url.searchParams.get("code");
+    if (!authCode) {
+      throw new Error("No authorization code found in URL");
+    }
+    code = authCode;
+  } catch (err) {
+    if (err instanceof Error && err.message.startsWith("OAuth error:")) throw err;
+    if (err instanceof Error && err.message.startsWith("No authorization")) throw err;
+    throw new Error(`Could not parse callback URL: ${pasted}`);
+  }
+  const tokenRes = await fetch(OAUTH_TOKEN2, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({
+      grant_type: "authorization_code",
+      code,
+      redirect_uri: REDIRECT_URI,
+      client_id: clientId,
+      client_secret: clientSecret
+    })
+  });
+  if (!tokenRes.ok) {
+    const body = await tokenRes.text();
+    throw new Error(`Token exchange failed (${tokenRes.status}): ${body}`);
+  }
+  const data = await tokenRes.json();
+  const tokens = {
+    access_token: data.access_token,
+    refresh_token: data.refresh_token,
+    expires_at: Date.now() + (data.expires_in ?? 7200) * 1e3,
+    client_id: clientId,
+    client_secret: clientSecret
+  };
+  saveTokens2(tokens);
+  return tokens;
+}
+async function stretyFetch(urlOrPath, token, options = {}) {
+  const url = urlOrPath.startsWith("http") ? urlOrPath : `${API_BASE2}${urlOrPath}`;
+  const res = await fetch(url, {
+    ...options,
+    headers: {
+      Authorization: `Bearer ${token}`,
+      Accept: "application/vnd.api+json",
+      "Content-Type": "application/vnd.api+json",
+      ...options.headers
+    }
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`Strety API ${res.status}: ${body}`);
+  }
+  return res.json();
+}
+async function stretyFetchAll(path7, token) {
+  const results = [];
+  let url = `${API_BASE2}${path7}`;
+  while (url) {
+    const json = await stretyFetch(url, token);
+    results.push(...json.data);
+    url = json.links?.next ?? null;
+  }
+  return results;
+}
+async function pickOne2(rl, label, items) {
+  console.log(`
+${label}:`);
+  for (let i = 0; i < items.length; i++) {
+    const name = items[i].attributes.name ?? items[i].attributes.title ?? items[i].id;
+    console.log(`  ${i + 1}) ${name}`);
+  }
+  while (true) {
+    const answer = await rl.question(`Choose (1-${items.length}): `);
+    const idx = parseInt(answer, 10) - 1;
+    if (idx >= 0 && idx < items.length) {
+      const item = items[idx];
+      return { id: item.id, name: item.attributes.name ?? item.attributes.title ?? item.id };
+    }
+    console.log("  Invalid choice, try again.");
+  }
+}
+var StretyAdapter = class {
+  name = "strety";
+  config;
+  accessToken = null;
+  async resolveToken() {
+    const auth = this.config.auth;
+    if (auth === "oauth") {
+      const tokens = loadTokens2();
+      if (!tokens) throw new Error("No OAuth tokens found. Run `tw-bridge add` to authenticate.");
+      this.accessToken = await refreshAccessToken2(tokens);
+      return this.accessToken;
+    }
+    if (this.accessToken) return this.accessToken;
+    if (auth.startsWith("env:")) {
+      const envVar = auth.slice(4);
+      const val = process.env[envVar];
+      if (!val) throw new Error(`Environment variable ${envVar} not set`);
+      this.accessToken = val;
+      return val;
+    }
+    this.accessToken = auth;
+    return auth;
+  }
+  defaultConfig(_cwd) {
+    return {
+      auth: "env:STRETY_TOKEN",
+      assignee_id: "",
+      assignee_name: ""
+    };
+  }
+  async setup(_cwd) {
+    const rl = createInterface2({ input: stdin2, output: stdout2 });
+    try {
+      console.log("\n\u2500\u2500 Strety Adapter Setup \u2500\u2500\n");
+      console.log("Authentication:");
+      console.log("  1) OAuth (browser login)");
+      console.log("  2) Environment variable");
+      const authChoice = (await rl.question("\nChoose (1-2): ")).trim();
+      let authConfig;
+      let token;
+      if (authChoice === "1") {
+        console.log(`
+  Register a Strety app at My Integrations > My Apps.`);
+        console.log(`  Set the Redirect URI to: ${REDIRECT_URI}
+`);
+        const clientId = (await rl.question("Strety App Client ID: ")).trim();
+        const clientSecret = (await rl.question("Strety App Client Secret: ")).trim();
+        if (!clientId || !clientSecret) {
+          console.error("\n  Client ID and Secret are required.");
+          rl.close();
+          process.exit(1);
+        }
+        const tokens = await oauthLogin2(clientId, clientSecret, rl);
+        token = tokens.access_token;
+        authConfig = "oauth";
+      } else {
+        const envVar = await rl.question("Environment variable name [STRETY_TOKEN]: ");
+        const varName = envVar.trim() || "STRETY_TOKEN";
+        authConfig = `env:${varName}`;
+        token = process.env[varName] ?? "";
+        if (!token) {
+          console.error(`
+  Cannot complete setup without a valid token.`);
+          console.error(`  Set ${varName} in your environment and try again.`);
+          rl.close();
+          process.exit(1);
+        }
+      }
+      console.log("\nVerifying...");
+      let people;
+      try {
+        people = await stretyFetchAll("/people?page[size]=20", token);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`  Authentication failed: ${msg}`);
+        rl.close();
+        process.exit(1);
+      }
+      console.log(`  Connected! Found ${people.length} people.`);
+      const person = await pickOne2(rl, "Which person are you? (for filtering your todos)", people);
+      rl.close();
+      console.log(`
+  Assignee: ${person.name}`);
+      console.log("  Syncing: Todos assigned to you");
+      return {
+        auth: authConfig,
+        assignee_id: person.id,
+        assignee_name: person.name
+      };
+    } catch (err) {
+      rl.close();
+      throw err;
+    }
+  }
+  async init(config) {
+    this.config = config;
+    if (!this.config.assignee_id) {
+      throw new Error('strety adapter requires "assignee_id" in config');
+    }
+  }
+  async pull() {
+    const token = await this.resolveToken();
+    const raw = await stretyFetchAll(
+      `/todos?filter[assignee_id]=${this.config.assignee_id}&page[size]=20`,
+      token
+    );
+    const tasks = [];
+    for (const item of raw) {
+      const attrs = item.attributes;
+      if (attrs.completed_at) continue;
+      const priority = mapStretyPriority(attrs.priority);
+      const task = {
+        uuid: "",
+        description: attrs.title,
+        status: "pending",
+        entry: attrs.created_at ?? (/* @__PURE__ */ new Date()).toISOString(),
+        tags: [],
+        priority,
+        backend: "",
+        backend_id: item.id,
+        ...attrs.due_date && { due: new Date(attrs.due_date).toISOString() }
+      };
+      tasks.push(task);
+    }
+    return tasks;
+  }
+  async onDone(task) {
+    const todoId = task.backend_id;
+    if (!todoId) return;
+    const token = await this.resolveToken();
+    process.stderr.write(`tw-bridge [strety]: marking todo complete
+`);
+    await stretyFetch(`/todos/${todoId}`, token, {
+      method: "PATCH",
+      headers: { "If-Match": "*" },
+      body: JSON.stringify({
+        data: {
+          type: "todo",
+          attributes: {
+            completed_at: (/* @__PURE__ */ new Date()).toISOString()
+          }
+        }
+      })
+    });
+  }
+};
+function mapStretyPriority(priority) {
+  if (!priority || priority === "none") return void 0;
+  if (priority === "highest" || priority === "high") return "H";
+  if (priority === "medium") return "M";
+  if (priority === "low" || priority === "lowest") return "L";
+  return void 0;
+}
+
 // src/registry.ts
 var BUILTIN_ADAPTERS = {
   ghp: () => new GhpAdapter(),
-  asana: () => new AsanaAdapter()
+  asana: () => new AsanaAdapter(),
+  strety: () => new StretyAdapter()
 };
 function matchBackend(task, config) {
   if (task.backend && config.backends[task.backend]) {
@@ -697,6 +1006,34 @@ function completeTask(existing, keepTags) {
   );
   return result.status === 0;
 }
+function findTaskByBackendId(backend, backendId) {
+  const existing = getExistingTasks(backend);
+  return existing.get(backendId) ?? null;
+}
+function startTask(uuid) {
+  const result = spawnSync2(
+    "task",
+    ["rc.confirmation=off", uuid, "start"],
+    {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+      env: { ...process.env, TW_BRIDGE_REVERSE_SYNC: "1" }
+    }
+  );
+  return result.status === 0;
+}
+function doneTask(uuid) {
+  const result = spawnSync2(
+    "task",
+    ["rc.confirmation=off", uuid, "done"],
+    {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+      env: { ...process.env, TW_BRIDGE_REVERSE_SYNC: "1" }
+    }
+  );
+  return result.status === 0;
+}
 function updateTaskDescription(existing, newDescription) {
   if (existing.description === newDescription) return false;
   const result = spawnSync2(
@@ -708,21 +1045,21 @@ function updateTaskDescription(existing, newDescription) {
 }
 
 // src/tracking.ts
-import fs3 from "fs";
-import path4 from "path";
-import os3 from "os";
+import fs4 from "fs";
+import path5 from "path";
+import os4 from "os";
 import { spawnSync as spawnSync3 } from "child_process";
-var TRACKING_FILE = path4.join(os3.homedir(), ".config", "tw-bridge", "tracking.json");
+var TRACKING_FILE = path5.join(os4.homedir(), ".config", "tw-bridge", "tracking.json");
 function loadTracking() {
   try {
-    return JSON.parse(fs3.readFileSync(TRACKING_FILE, "utf-8"));
+    return JSON.parse(fs4.readFileSync(TRACKING_FILE, "utf-8"));
   } catch {
     return {};
   }
 }
 function saveTracking(state) {
-  fs3.mkdirSync(path4.dirname(TRACKING_FILE), { recursive: true });
-  fs3.writeFileSync(TRACKING_FILE, JSON.stringify(state));
+  fs4.mkdirSync(path5.dirname(TRACKING_FILE), { recursive: true });
+  fs4.writeFileSync(TRACKING_FILE, JSON.stringify(state));
 }
 function mergedTags(state) {
   const all = /* @__PURE__ */ new Set();
@@ -760,11 +1097,13 @@ function getActiveMeetings() {
 }
 
 // src/cli.ts
-var HOOKS_DIR = path5.join(os4.homedir(), ".task", "hooks");
+var HOOKS_DIR = path6.join(os5.homedir(), ".task", "hooks");
 var commands = {
   add: addBackend,
   install,
   sync,
+  start: startCmd,
+  done: doneCmd,
   meeting: meetingCmd,
   timewarrior: timewarriorCmd,
   which,
@@ -778,6 +1117,8 @@ async function main() {
     console.log("  add         Add a new backend instance");
     console.log("  install     Install Taskwarrior hooks and shell integration");
     console.log("  sync        Pull tasks from all backends");
+    console.log("  start       Start a task by backend ID (e.g., tw-bridge start ghp#123)");
+    console.log("  done        Complete a task by backend ID (e.g., tw-bridge done ghp#123)");
     console.log("  meeting     Track meetings in Timewarrior (no task created)");
     console.log("  timewarrior Manage Timewarrior integration");
     console.log("  which       Print the context for the current directory");
@@ -854,18 +1195,18 @@ Added backend "${name}" (adapter: ${adapterType})`);
 Use 'task context ${matchTag}' to switch to this project.`);
 }
 async function install() {
-  fs4.mkdirSync(HOOKS_DIR, { recursive: true });
-  const hookSource = path5.resolve(
-    path5.dirname(new URL(import.meta.url).pathname),
+  fs5.mkdirSync(HOOKS_DIR, { recursive: true });
+  const hookSource = path6.resolve(
+    path6.dirname(new URL(import.meta.url).pathname),
     "hooks",
     "on-modify.js"
   );
-  const hookTarget = path5.join(HOOKS_DIR, "on-modify.tw-bridge");
-  if (fs4.existsSync(hookTarget)) {
-    fs4.unlinkSync(hookTarget);
+  const hookTarget = path6.join(HOOKS_DIR, "on-modify.tw-bridge");
+  if (fs5.existsSync(hookTarget)) {
+    fs5.unlinkSync(hookTarget);
   }
-  fs4.symlinkSync(hookSource, hookTarget);
-  fs4.chmodSync(hookSource, 493);
+  fs5.symlinkSync(hookSource, hookTarget);
+  fs5.chmodSync(hookSource, 493);
   console.log(`Installed hook: ${hookTarget} -> ${hookSource}`);
   console.log("\nAdd these to your .taskrc:\n");
   console.log("# --- tw-bridge UDAs ---");
@@ -882,26 +1223,26 @@ async function install() {
   console.log("urgency.user.tag.ready_for_beta.coefficient=-4.0");
   console.log("urgency.user.tag.in_beta.coefficient=-6.0");
   installTimewExtension();
-  if (fs4.existsSync(STANDARD_TIMEW_HOOK)) {
+  if (fs5.existsSync(STANDARD_TIMEW_HOOK)) {
     console.log("\nTimewarrior hook detected. To enable tw-bridge time tracking:");
     console.log("  tw-bridge timewarrior enable");
   }
   installShellFunction();
 }
-var TIMEW_EXT_DIR = path5.join(os4.homedir(), ".timewarrior", "extensions");
+var TIMEW_EXT_DIR = path6.join(os5.homedir(), ".timewarrior", "extensions");
 function installTimewExtension() {
-  fs4.mkdirSync(TIMEW_EXT_DIR, { recursive: true });
-  const extSource = path5.resolve(
-    path5.dirname(new URL(import.meta.url).pathname),
+  fs5.mkdirSync(TIMEW_EXT_DIR, { recursive: true });
+  const extSource = path6.resolve(
+    path6.dirname(new URL(import.meta.url).pathname),
     "extensions",
     "bridge.js"
   );
-  const extTarget = path5.join(TIMEW_EXT_DIR, "bridge");
-  if (fs4.existsSync(extTarget)) {
-    fs4.unlinkSync(extTarget);
+  const extTarget = path6.join(TIMEW_EXT_DIR, "bridge");
+  if (fs5.existsSync(extTarget)) {
+    fs5.unlinkSync(extTarget);
   }
-  fs4.symlinkSync(extSource, extTarget);
-  fs4.chmodSync(extSource, 493);
+  fs5.symlinkSync(extSource, extTarget);
+  fs5.chmodSync(extSource, 493);
   console.log(`
 Installed Timewarrior extension: ${extTarget} -> ${extSource}`);
   console.log("  Usage: timew bridge [task-time|wall-time] [project-filter]");
@@ -915,8 +1256,8 @@ function detectProjectContext() {
   for (const [, backend] of Object.entries(config.backends)) {
     const backendCwd = backend.config?.cwd;
     if (!backendCwd) continue;
-    const resolved = path5.resolve(backendCwd);
-    if (cwd === resolved || cwd.startsWith(resolved + path5.sep)) {
+    const resolved = path6.resolve(backendCwd);
+    if (cwd === resolved || cwd.startsWith(resolved + path6.sep)) {
       return backend.match.tags?.[0] ?? null;
     }
   }
@@ -1008,7 +1349,7 @@ async function meetingCmd() {
   console.error(`Unknown subcommand: ${sub}`);
   process.exit(1);
 }
-var STANDARD_TIMEW_HOOK = path5.join(HOOKS_DIR, "on-modify.timewarrior");
+var STANDARD_TIMEW_HOOK = path6.join(HOOKS_DIR, "on-modify.timewarrior");
 async function timewarriorCmd() {
   const sub = process.argv[3];
   if (!sub || sub === "--help") {
@@ -1031,8 +1372,8 @@ async function timewarriorCmd() {
       console.log("Timewarrior: enabled");
       console.log("  Parallel tracking: use `task start <id> --parallel`");
     }
-    const hookExists = fs4.existsSync(STANDARD_TIMEW_HOOK);
-    const hookDisabled = fs4.existsSync(STANDARD_TIMEW_HOOK + ".disabled");
+    const hookExists = fs5.existsSync(STANDARD_TIMEW_HOOK);
+    const hookDisabled = fs5.existsSync(STANDARD_TIMEW_HOOK + ".disabled");
     if (hookExists) {
       console.log(`Standard hook: active (${STANDARD_TIMEW_HOOK})`);
       if (tw?.enabled) {
@@ -1050,9 +1391,9 @@ async function timewarriorCmd() {
     const configPath = saveConfig(config);
     console.log("Timewarrior tracking enabled");
     console.log(`Config: ${configPath}`);
-    if (fs4.existsSync(STANDARD_TIMEW_HOOK)) {
+    if (fs5.existsSync(STANDARD_TIMEW_HOOK)) {
       const disabled = STANDARD_TIMEW_HOOK + ".disabled";
-      fs4.renameSync(STANDARD_TIMEW_HOOK, disabled);
+      fs5.renameSync(STANDARD_TIMEW_HOOK, disabled);
       console.log(`
 Disabled standard hook: ${STANDARD_TIMEW_HOOK} -> .disabled`);
       console.log("tw-bridge will handle Timewarrior tracking directly.");
@@ -1065,8 +1406,8 @@ Disabled standard hook: ${STANDARD_TIMEW_HOOK} -> .disabled`);
     console.log("Timewarrior tracking disabled");
     console.log(`Config: ${configPath}`);
     const disabled = STANDARD_TIMEW_HOOK + ".disabled";
-    if (fs4.existsSync(disabled)) {
-      fs4.renameSync(disabled, STANDARD_TIMEW_HOOK);
+    if (fs5.existsSync(disabled)) {
+      fs5.renameSync(disabled, STANDARD_TIMEW_HOOK);
       console.log(`
 Restored standard hook: ${STANDARD_TIMEW_HOOK}`);
     }
@@ -1096,28 +1437,28 @@ task() {
 var SHELL_MARKER = "# tw-bridge: auto-context task wrapper";
 function installShellFunction() {
   const shell = process.env.SHELL ?? "/bin/bash";
-  const home = os4.homedir();
+  const home = os5.homedir();
   let rcFile;
   if (shell.endsWith("zsh")) {
-    rcFile = path5.join(home, ".zshrc");
+    rcFile = path6.join(home, ".zshrc");
   } else {
-    rcFile = path5.join(home, ".bashrc");
+    rcFile = path6.join(home, ".bashrc");
   }
-  const existing = fs4.existsSync(rcFile) ? fs4.readFileSync(rcFile, "utf-8") : "";
+  const existing = fs5.existsSync(rcFile) ? fs5.readFileSync(rcFile, "utf-8") : "";
   if (existing.includes(SHELL_MARKER)) {
     console.log(`
 Shell integration already installed in ${rcFile}`);
     return;
   }
-  fs4.appendFileSync(rcFile, "\n" + SHELL_FUNCTION + "\n");
+  fs5.appendFileSync(rcFile, "\n" + SHELL_FUNCTION + "\n");
   console.log(`
 Shell integration installed in ${rcFile}`);
   console.log("Restart your shell or run: source " + rcFile);
 }
-var SEEN_FILE = path5.join(os4.homedir(), ".config", "tw-bridge", ".seen-dirs");
+var SEEN_FILE = path6.join(os5.homedir(), ".config", "tw-bridge", ".seen-dirs");
 function loadSeenDirs() {
   try {
-    const raw = fs4.readFileSync(SEEN_FILE, "utf-8");
+    const raw = fs5.readFileSync(SEEN_FILE, "utf-8");
     return new Set(raw.split("\n").filter(Boolean));
   } catch {
     return /* @__PURE__ */ new Set();
@@ -1127,15 +1468,15 @@ function markDirSeen(dir) {
   const seen = loadSeenDirs();
   if (seen.has(dir)) return;
   seen.add(dir);
-  fs4.mkdirSync(path5.dirname(SEEN_FILE), { recursive: true });
-  fs4.writeFileSync(SEEN_FILE, [...seen].join("\n") + "\n");
+  fs5.mkdirSync(path6.dirname(SEEN_FILE), { recursive: true });
+  fs5.writeFileSync(SEEN_FILE, [...seen].join("\n") + "\n");
 }
 function isGitRepo(dir) {
   try {
     let current = dir;
-    while (current !== path5.dirname(current)) {
-      if (fs4.existsSync(path5.join(current, ".git"))) return true;
-      current = path5.dirname(current);
+    while (current !== path6.dirname(current)) {
+      if (fs5.existsSync(path6.join(current, ".git"))) return true;
+      current = path6.dirname(current);
     }
     return false;
   } catch {
@@ -1148,8 +1489,8 @@ async function which() {
   for (const [_name, backend] of Object.entries(config.backends)) {
     const backendCwd = backend.config?.cwd;
     if (!backendCwd) continue;
-    const resolved = path5.resolve(backendCwd);
-    if (cwd === resolved || cwd.startsWith(resolved + path5.sep)) {
+    const resolved = path6.resolve(backendCwd);
+    if (cwd === resolved || cwd.startsWith(resolved + path6.sep)) {
       const contextTag = backend.match.tags?.[0];
       if (contextTag) {
         process.stdout.write(contextTag);
@@ -1165,15 +1506,15 @@ async function which() {
     const seen = loadSeenDirs();
     let gitRoot = cwd;
     let current = cwd;
-    while (current !== path5.dirname(current)) {
-      if (fs4.existsSync(path5.join(current, ".git"))) {
+    while (current !== path6.dirname(current)) {
+      if (fs5.existsSync(path6.join(current, ".git"))) {
         gitRoot = current;
         break;
       }
-      current = path5.dirname(current);
+      current = path6.dirname(current);
     }
     if (!seen.has(gitRoot)) {
-      const dirName = path5.basename(gitRoot);
+      const dirName = path6.basename(gitRoot);
       process.stderr.write(
         `tw-bridge: unconfigured project "${dirName}". Run: tw-bridge add ${dirName} --adapter ghp
 `
@@ -1193,6 +1534,75 @@ async function sync() {
     await syncBackend(name, config.backends[name], config);
   }
 }
+function parseBackendRef(ref) {
+  const match = ref.match(/^([^#]+)#(.+)$/);
+  if (!match) return null;
+  return { backend: match[1], id: match[2] };
+}
+async function resolveTaskByRef(ref) {
+  const config = loadConfig();
+  const backendName = Object.keys(config.backends).find(
+    (name) => name === ref.backend || config.backends[name].adapter === ref.backend
+  );
+  if (!backendName) {
+    console.error(`No backend found matching "${ref.backend}".`);
+    console.error(`Configured backends: ${Object.keys(config.backends).join(", ")}`);
+    process.exit(1);
+  }
+  let task = findTaskByBackendId(backendName, ref.id);
+  if (!task) {
+    console.log(`Task #${ref.id} not in Taskwarrior yet, syncing ${backendName}...`);
+    await syncBackend(backendName, config.backends[backendName], config);
+    task = findTaskByBackendId(backendName, ref.id);
+  }
+  if (!task) {
+    console.error(`Task #${ref.id} not found in backend "${backendName}" after sync.`);
+    process.exit(1);
+  }
+  return task;
+}
+async function startCmd() {
+  const ref = process.argv[3];
+  if (!ref || ref.startsWith("--")) {
+    console.error("Usage: tw-bridge start <backend>#<id>  (e.g., tw-bridge start ghp#123)");
+    process.exit(1);
+  }
+  const parsed = parseBackendRef(ref);
+  if (!parsed) {
+    console.error(`Invalid reference "${ref}". Expected format: backend#id (e.g., ghp#123)`);
+    process.exit(1);
+  }
+  const task = await resolveTaskByRef(parsed);
+  if (task.start) {
+    console.log(`Task #${parsed.id} is already started (${task.uuid.slice(0, 8)})`);
+    return;
+  }
+  if (startTask(task.uuid)) {
+    console.log(`Started: [#${parsed.id}] ${task.description} (${task.uuid.slice(0, 8)})`);
+  } else {
+    console.error(`Failed to start task ${task.uuid}`);
+    process.exit(1);
+  }
+}
+async function doneCmd() {
+  const ref = process.argv[3];
+  if (!ref || ref.startsWith("--")) {
+    console.error("Usage: tw-bridge done <backend>#<id>  (e.g., tw-bridge done ghp#123)");
+    process.exit(1);
+  }
+  const parsed = parseBackendRef(ref);
+  if (!parsed) {
+    console.error(`Invalid reference "${ref}". Expected format: backend#id (e.g., ghp#123)`);
+    process.exit(1);
+  }
+  const task = await resolveTaskByRef(parsed);
+  if (doneTask(task.uuid)) {
+    console.log(`Completed: [#${parsed.id}] ${task.description} (${task.uuid.slice(0, 8)})`);
+  } else {
+    console.error(`Failed to complete task ${task.uuid}`);
+    process.exit(1);
+  }
+}
 async function syncBackend(name, backend, config) {
   const adapter = await resolveAdapter(
     { backend: name },

package/dist/hooks/on-modify.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/hooks/on-modify.ts
-import fs4 from "fs";
+import fs5 from "fs";
 import { spawnSync as spawnSync3 } from "child_process";
 
 // src/config.ts
@@ -234,8 +234,8 @@ async function oauthLogin(clientId, clientSecret, rl) {
   saveTokens(tokens);
   return tokens;
 }
-async function asanaFetch(path5, token, options = {}) {
-  const url = `${API_BASE}${path5}`;
+async function asanaFetch(path6, token, options = {}) {
+  const url = `${API_BASE}${path6}`;
   const res = await fetch(url, {
     ...options,
     headers: {
@@ -251,9 +251,9 @@ async function asanaFetch(path5, token, options = {}) {
   const json = await res.json();
   return json.data;
 }
-async function asanaFetchAll(path5, token) {
+async function asanaFetchAll(path6, token) {
   const results = [];
-  let nextPage = path5;
+  let nextPage = path6;
   while (nextPage) {
     const url = `${API_BASE}${nextPage}`;
     const res = await fetch(url, {
@@ -565,10 +565,319 @@ function mapAsanaPriority(fields) {
   return void 0;
 }
 
+// src/adapters/strety.ts
+import fs3 from "fs";
+import path4 from "path";
+import os3 from "os";
+import { execSync as execSync2 } from "child_process";
+import { createInterface as createInterface2 } from "readline/promises";
+import { stdin as stdin2, stdout as stdout2 } from "process";
+var API_BASE2 = "https://2.strety.com/api/v1";
+var OAUTH_AUTHORIZE2 = `${API_BASE2}/oauth/authorize`;
+var OAUTH_TOKEN2 = `${API_BASE2}/oauth/token`;
+var TOKEN_FILE2 = path4.join(os3.homedir(), ".config", "tw-bridge", "strety-tokens.json");
+function loadTokens2() {
+  try {
+    return JSON.parse(fs3.readFileSync(TOKEN_FILE2, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function saveTokens2(tokens) {
+  fs3.mkdirSync(path4.dirname(TOKEN_FILE2), { recursive: true });
+  fs3.writeFileSync(TOKEN_FILE2, JSON.stringify(tokens, null, 2), { mode: 384 });
+}
+async function refreshAccessToken2(tokens) {
+  const now = Date.now();
+  if (tokens.access_token && tokens.expires_at > now + 3e5) {
+    return tokens.access_token;
+  }
+  const res = await fetch(OAUTH_TOKEN2, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({
+      grant_type: "refresh_token",
+      refresh_token: tokens.refresh_token,
+      client_id: tokens.client_id,
+      client_secret: tokens.client_secret
+    })
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`Token refresh failed (${res.status}): ${body}`);
+  }
+  const data = await res.json();
+  tokens.access_token = data.access_token;
+  if (data.refresh_token) {
+    tokens.refresh_token = data.refresh_token;
+  }
+  tokens.expires_at = now + (data.expires_in ?? 7200) * 1e3;
+  saveTokens2(tokens);
+  return tokens.access_token;
+}
+var REDIRECT_URI = "https://localhost/callback";
+async function oauthLogin2(clientId, clientSecret, rl) {
+  const authUrl = `${OAUTH_AUTHORIZE2}?response_type=code&client_id=${encodeURIComponent(clientId)}&redirect_uri=${encodeURIComponent(REDIRECT_URI)}&scope=${encodeURIComponent("read write")}`;
+  console.log(`
+  Opening browser for authorization...`);
+  console.log(`  If it doesn't open, visit:
+  ${authUrl}
+`);
+  try {
+    execSync2(`xdg-open "${authUrl}" 2>/dev/null || open "${authUrl}" 2>/dev/null`, {
+      stdio: "ignore"
+    });
+  } catch {
+  }
+  console.log("  After authorizing, the browser will redirect to a page that");
+  console.log("  won't load. Copy the full URL from the address bar and paste it here.\n");
+  const pasted = (await rl.question("Paste the callback URL: ")).trim();
+  let code;
+  try {
+    const url = new URL(pasted);
+    const error = url.searchParams.get("error");
+    if (error) {
+      throw new Error(`OAuth error: ${error}`);
+    }
+    const authCode = url.searchParams.get("code");
+    if (!authCode) {
+      throw new Error("No authorization code found in URL");
+    }
+    code = authCode;
+  } catch (err) {
+    if (err instanceof Error && err.message.startsWith("OAuth error:")) throw err;
+    if (err instanceof Error && err.message.startsWith("No authorization")) throw err;
+    throw new Error(`Could not parse callback URL: ${pasted}`);
+  }
+  const tokenRes = await fetch(OAUTH_TOKEN2, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({
+      grant_type: "authorization_code",
+      code,
+      redirect_uri: REDIRECT_URI,
+      client_id: clientId,
+      client_secret: clientSecret
+    })
+  });
+  if (!tokenRes.ok) {
+    const body = await tokenRes.text();
+    throw new Error(`Token exchange failed (${tokenRes.status}): ${body}`);
+  }
+  const data = await tokenRes.json();
+  const tokens = {
+    access_token: data.access_token,
+    refresh_token: data.refresh_token,
+    expires_at: Date.now() + (data.expires_in ?? 7200) * 1e3,
+    client_id: clientId,
+    client_secret: clientSecret
+  };
+  saveTokens2(tokens);
+  return tokens;
+}
+async function stretyFetch(urlOrPath, token, options = {}) {
+  const url = urlOrPath.startsWith("http") ? urlOrPath : `${API_BASE2}${urlOrPath}`;
+  const res = await fetch(url, {
+    ...options,
+    headers: {
+      Authorization: `Bearer ${token}`,
+      Accept: "application/vnd.api+json",
+      "Content-Type": "application/vnd.api+json",
+      ...options.headers
+    }
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`Strety API ${res.status}: ${body}`);
+  }
+  return res.json();
+}
+async function stretyFetchAll(path6, token) {
+  const results = [];
+  let url = `${API_BASE2}${path6}`;
+  while (url) {
+    const json = await stretyFetch(url, token);
+    results.push(...json.data);
+    url = json.links?.next ?? null;
+  }
+  return results;
+}
+async function pickOne2(rl, label, items) {
+  console.log(`
+${label}:`);
+  for (let i = 0; i < items.length; i++) {
+    const name = items[i].attributes.name ?? items[i].attributes.title ?? items[i].id;
+    console.log(`  ${i + 1}) ${name}`);
+  }
+  while (true) {
+    const answer = await rl.question(`Choose (1-${items.length}): `);
+    const idx = parseInt(answer, 10) - 1;
+    if (idx >= 0 && idx < items.length) {
+      const item = items[idx];
+      return { id: item.id, name: item.attributes.name ?? item.attributes.title ?? item.id };
+    }
+    console.log("  Invalid choice, try again.");
+  }
+}
+var StretyAdapter = class {
+  name = "strety";
+  config;
+  accessToken = null;
+  async resolveToken() {
+    const auth = this.config.auth;
+    if (auth === "oauth") {
+      const tokens = loadTokens2();
+      if (!tokens) throw new Error("No OAuth tokens found. Run `tw-bridge add` to authenticate.");
+      this.accessToken = await refreshAccessToken2(tokens);
+      return this.accessToken;
+    }
+    if (this.accessToken) return this.accessToken;
+    if (auth.startsWith("env:")) {
+      const envVar = auth.slice(4);
+      const val = process.env[envVar];
+      if (!val) throw new Error(`Environment variable ${envVar} not set`);
+      this.accessToken = val;
+      return val;
+    }
+    this.accessToken = auth;
+    return auth;
+  }
+  defaultConfig(_cwd) {
+    return {
+      auth: "env:STRETY_TOKEN",
+      assignee_id: "",
+      assignee_name: ""
+    };
+  }
+  async setup(_cwd) {
+    const rl = createInterface2({ input: stdin2, output: stdout2 });
+    try {
+      console.log("\n\u2500\u2500 Strety Adapter Setup \u2500\u2500\n");
+      console.log("Authentication:");
+      console.log("  1) OAuth (browser login)");
+      console.log("  2) Environment variable");
+      const authChoice = (await rl.question("\nChoose (1-2): ")).trim();
+      let authConfig;
+      let token;
+      if (authChoice === "1") {
+        console.log(`
+  Register a Strety app at My Integrations > My Apps.`);
+        console.log(`  Set the Redirect URI to: ${REDIRECT_URI}
+`);
+        const clientId = (await rl.question("Strety App Client ID: ")).trim();
+        const clientSecret = (await rl.question("Strety App Client Secret: ")).trim();
+        if (!clientId || !clientSecret) {
+          console.error("\n  Client ID and Secret are required.");
+          rl.close();
+          process.exit(1);
+        }
+        const tokens = await oauthLogin2(clientId, clientSecret, rl);
+        token = tokens.access_token;
+        authConfig = "oauth";
+      } else {
+        const envVar = await rl.question("Environment variable name [STRETY_TOKEN]: ");
+        const varName = envVar.trim() || "STRETY_TOKEN";
+        authConfig = `env:${varName}`;
+        token = process.env[varName] ?? "";
+        if (!token) {
+          console.error(`
+  Cannot complete setup without a valid token.`);
+          console.error(`  Set ${varName} in your environment and try again.`);
+          rl.close();
+          process.exit(1);
+        }
+      }
+      console.log("\nVerifying...");
+      let people;
+      try {
+        people = await stretyFetchAll("/people?page[size]=20", token);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`  Authentication failed: ${msg}`);
+        rl.close();
+        process.exit(1);
+      }
+      console.log(`  Connected! Found ${people.length} people.`);
+      const person = await pickOne2(rl, "Which person are you? (for filtering your todos)", people);
+      rl.close();
+      console.log(`
+  Assignee: ${person.name}`);
+      console.log("  Syncing: Todos assigned to you");
+      return {
+        auth: authConfig,
+        assignee_id: person.id,
+        assignee_name: person.name
+      };
+    } catch (err) {
+      rl.close();
+      throw err;
+    }
+  }
+  async init(config) {
+    this.config = config;
+    if (!this.config.assignee_id) {
+      throw new Error('strety adapter requires "assignee_id" in config');
+    }
+  }
+  async pull() {
+    const token = await this.resolveToken();
+    const raw = await stretyFetchAll(
+      `/todos?filter[assignee_id]=${this.config.assignee_id}&page[size]=20`,
+      token
+    );
+    const tasks = [];
+    for (const item of raw) {
+      const attrs = item.attributes;
+      if (attrs.completed_at) continue;
+      const priority = mapStretyPriority(attrs.priority);
+      const task = {
+        uuid: "",
+        description: attrs.title,
+        status: "pending",
+        entry: attrs.created_at ?? (/* @__PURE__ */ new Date()).toISOString(),
+        tags: [],
+        priority,
+        backend: "",
+        backend_id: item.id,
+        ...attrs.due_date && { due: new Date(attrs.due_date).toISOString() }
+      };
+      tasks.push(task);
+    }
+    return tasks;
+  }
+  async onDone(task) {
+    const todoId = task.backend_id;
+    if (!todoId) return;
+    const token = await this.resolveToken();
+    process.stderr.write(`tw-bridge [strety]: marking todo complete
+`);
+    await stretyFetch(`/todos/${todoId}`, token, {
+      method: "PATCH",
+      headers: { "If-Match": "*" },
+      body: JSON.stringify({
+        data: {
+          type: "todo",
+          attributes: {
+            completed_at: (/* @__PURE__ */ new Date()).toISOString()
+          }
+        }
+      })
+    });
+  }
+};
+function mapStretyPriority(priority) {
+  if (!priority || priority === "none") return void 0;
+  if (priority === "highest" || priority === "high") return "H";
+  if (priority === "medium") return "M";
+  if (priority === "low" || priority === "lowest") return "L";
+  return void 0;
+}
+
 // src/registry.ts
 var BUILTIN_ADAPTERS = {
   ghp: () => new GhpAdapter(),
-  asana: () => new AsanaAdapter()
+  asana: () => new AsanaAdapter(),
+  strety: () => new StretyAdapter()
 };
 function matchBackend(task, config) {
   if (task.backend && config.backends[task.backend]) {
@@ -600,21 +909,21 @@ async function resolveAdapter(task, config) {
 }
 
 // src/tracking.ts
-import fs3 from "fs";
-import path4 from "path";
-import os3 from "os";
+import fs4 from "fs";
+import path5 from "path";
+import os4 from "os";
 import { spawnSync as spawnSync2 } from "child_process";
-var TRACKING_FILE = path4.join(os3.homedir(), ".config", "tw-bridge", "tracking.json");
+var TRACKING_FILE = path5.join(os4.homedir(), ".config", "tw-bridge", "tracking.json");
 function loadTracking() {
   try {
-    return JSON.parse(fs3.readFileSync(TRACKING_FILE, "utf-8"));
+    return JSON.parse(fs4.readFileSync(TRACKING_FILE, "utf-8"));
   } catch {
     return {};
   }
 }
 function saveTracking(state) {
-  fs3.mkdirSync(path4.dirname(TRACKING_FILE), { recursive: true });
-  fs3.writeFileSync(TRACKING_FILE, JSON.stringify(state));
+  fs4.mkdirSync(path5.dirname(TRACKING_FILE), { recursive: true });
+  fs4.writeFileSync(TRACKING_FILE, JSON.stringify(state));
 }
 function mergedTags(state) {
   const all = /* @__PURE__ */ new Set();
@@ -689,10 +998,10 @@ tw-bridge: Currently tracking: ${tags} (${duration})`
   lines.push("  [s] Switch \u2014 stop current, start new task (default)");
   lines.push("  [p] Parallel \u2014 add new task to current tracking");
   lines.push("");
-  fs4.writeSync(ttyFd, lines.join("\n"));
-  fs4.writeSync(ttyFd, "  > ");
+  fs5.writeSync(ttyFd, lines.join("\n"));
+  fs5.writeSync(ttyFd, "  > ");
   const buf = Buffer.alloc(64);
-  const bytesRead = fs4.readSync(ttyFd, buf, 0, 64, null);
+  const bytesRead = fs5.readSync(ttyFd, buf, 0, 64, null);
   const answer = buf.toString("utf-8", 0, bytesRead).trim().toLowerCase();
   return answer.startsWith("p") ? "parallel" : "switch";
 }
@@ -738,7 +1047,7 @@ function handleTimewarriorStop(config, task) {
   }
 }
 async function main() {
-  const input = fs4.readFileSync("/dev/stdin", "utf-8").trim().split("\n");
+  const input = fs5.readFileSync("/dev/stdin", "utf-8").trim().split("\n");
   const oldTask = JSON.parse(input[0]);
   const newTask = JSON.parse(input[1]);
   process.stdout.write(JSON.stringify(newTask) + "\n");
@@ -749,7 +1058,7 @@ async function main() {
   let ttyFd = null;
   if (wasStarted) {
     try {
-      ttyFd = fs4.openSync("/dev/tty", "r+");
+      ttyFd = fs5.openSync("/dev/tty", "r+");
     } catch {
     }
   }
@@ -759,6 +1068,7 @@ async function main() {
     } else if (wasStopped || wasCompleted) {
       handleTimewarriorStop(config, oldTask);
     }
+    if (process.env.TW_BRIDGE_REVERSE_SYNC) return;
     const adapter = await resolveAdapter(newTask, config);
     if (!adapter) return;
     if (wasStarted && adapter.onStart) {
@@ -777,7 +1087,7 @@ async function main() {
     process.stderr.write(`tw-bridge: ${msg}
 `);
   } finally {
-    if (ttyFd !== null) fs4.closeSync(ttyFd);
+    if (ttyFd !== null) fs5.closeSync(ttyFd);
   }
 }
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bretwardjames/tw-bridge",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Taskwarrior backend bridge — unified sync and hooks for multiple task management platforms",
   "type": "module",
   "license": "MIT",