@web42/stask 0.1.5 → 0.1.6

package/commands/create.mjs

@@ -9,7 +9,7 @@ import fs from 'fs';
 import { createHash } from 'crypto';
 import { CONFIG, getWorkspaceLibs } from '../lib/env.mjs';
 import { withTransaction } from '../lib/tx.mjs';
-import { syncTaskToSlack } from '../lib/slack-row.mjs';
+import { syncTaskToSlack, setThreadRef } from '../lib/slack-row.mjs';
 
 function parseArgs(argv) {
   const args = {};
@@ -21,6 +21,31 @@ function parseArgs(argv) {
   return args;
 }
 
+/**
+ * Discover the list item's comment thread on the list channel.
+ * Slack Lists internally use a channel (list ID with F→C prefix swap).
+ * Each list item gets a thread whose ts shares the same epoch second
+ * as the item's date_created.
+ *
+ * @param {object} slackApi - Slack API module
+ * @param {string} listChannelId - List channel ID (C-prefixed)
+ * @param {number} itemDateCreated - Item's date_created (Unix epoch)
+ */
+async function discoverListItemThread(slackApi, listChannelId, itemDateCreated) {
+  const epoch = String(itemDateCreated);
+  const oldest = String(itemDateCreated - 2);
+  const latest = String(itemDateCreated + 5);
+
+  for (let attempt = 0; attempt < 3; attempt++) {
+    const result = await slackApi.getChannelHistory(listChannelId, { oldest, latest, limit: 10 });
+    const messages = result.messages || [];
+    const match = messages.find(m => m.ts && m.ts.startsWith(epoch + '.'));
+    if (match) return match.ts;
+    await new Promise(r => setTimeout(r, 1000));
+  }
+  return null;
+}
+
 export async function run(argv) {
   const args = parseArgs(argv);
 
@@ -84,5 +109,29 @@ export async function run(argv) {
     }
   );
 
+  // Post-commit: discover list item thread and post creation message (best-effort)
+  try {
+    const listChannelId = CONFIG.slack.listId.replace(/^F/, 'C');
+    const db = libs.trackerDb.getDb();
+    // Get the Slack item's date_created (Unix epoch) to match the thread ts
+    const { getSlackRowId } = await import('../lib/slack-row.mjs');
+    const rowId = getSlackRowId(db, result.taskId);
+    const itemInfo = await libs.slackApi.slackApiRequest('POST', '/slackLists.items.info', {
+      list_id: CONFIG.slack.listId, id: rowId,
+    });
+    const dateCreated = itemInfo.record?.date_created;
+    if (dateCreated) {
+      const threadTs = await discoverListItemThread(libs.slackApi, listChannelId, dateCreated);
+      if (threadTs) {
+        const humanMention = `<@${CONFIG.human.slackUserId}>`;
+        const msg = `Creating this thread to discuss *${result.taskId}: ${args.name}*. This will be the thread where we post updates and talk about this task.\n\n${humanMention} spec is ready for your review. Let me know what you think!`;
+        await libs.slackApi.postMessage(listChannelId, msg, { threadTs });
+        setThreadRef(db, result.taskId, listChannelId, threadTs);
+      }
+    }
+  } catch (err) {
+    console.error(`WARNING: Thread linking failed: ${err.message}`);
+  }
+
   console.log(`Created ${result.taskId}: "${args.name}" | Status: To-Do | Assigned: ${CONFIG.human.name} | Spec: ${fileId}`);
 }

package/lib/env.mjs

@@ -76,6 +76,7 @@ export function loadEnv() {
   if (config.slack?.listId === 'FROM_ENV' && process.env.LIST_ID) {
     config.slack.listId = process.env.LIST_ID;
   }
+
 }
 
 // ─── Local lib imports (all bundled in stask/lib/) ─────────────────

package/lib/slack-api.mjs

@@ -187,6 +187,26 @@ export async function updateListCells(listId, cells) {
   });
 }
 
+/**
+ * Fetch recent messages from a channel (conversations.history).
+ */
+export async function getChannelHistory(channelId, { limit = 20, oldest, latest } = {}) {
+  const payload = { channel: channelId, limit };
+  if (oldest) payload.oldest = oldest;
+  if (latest) payload.latest = latest;
+  return slackApiRequest('POST', '/conversations.history', payload);
+}
+
+/**
+ * Post a message to a channel (optionally as a thread reply).
+ * Returns the full Slack response including ts (message timestamp).
+ */
+export async function postMessage(channelId, text, { threadTs, unfurlLinks } = {}) {
+  const payload = { channel: channelId, text, unfurl_links: unfurlLinks ?? false };
+  if (threadTs) payload.thread_ts = threadTs;
+  return slackApiRequest('POST', '/chat.postMessage', payload);
+}
+
 /**
  * Delete a row from a Slack List.
  */

package/lib/slack-row.mjs

@@ -26,6 +26,9 @@ let _rowTableCreated = false;
 function ensureRowIdsTable(db) {
   if (_rowTableCreated) return;
   db.exec(ROW_IDS_TABLE_SQL);
+  // Migrate: add thread tracking columns (no-op if already present)
+  try { db.exec('ALTER TABLE slack_row_ids ADD COLUMN channel_id TEXT'); } catch {}
+  try { db.exec('ALTER TABLE slack_row_ids ADD COLUMN thread_ts TEXT'); } catch {}
   _rowTableCreated = true;
 }
 
@@ -45,6 +48,19 @@ function setSlackRowId(db, taskId, rowId) {
   `).run(taskId, rowId);
 }
 
+export function getThreadRef(db, taskId) {
+  ensureRowIdsTable(db);
+  const row = db.prepare('SELECT channel_id, thread_ts FROM slack_row_ids WHERE task_id = ?').get(taskId);
+  if (!row?.channel_id || !row?.thread_ts) return null;
+  return { channelId: row.channel_id, threadTs: row.thread_ts };
+}
+
+export function setThreadRef(db, taskId, channelId, threadTs) {
+  ensureRowIdsTable(db);
+  db.prepare('UPDATE slack_row_ids SET channel_id = ?, thread_ts = ? WHERE task_id = ?')
+    .run(channelId, threadTs, taskId);
+}
+
 // ─── Cell formatting (config-driven) ───────────────────────────────
 
 function formatCell(fieldName, value, columnId, taskRow) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@web42/stask",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "SQLite-backed task lifecycle CLI with Slack sync for AI agent teams",
   "type": "module",
   "bin": {