slack-axi 0.1.0

package/dist/src/commands/catchup.js

@@ -0,0 +1,171 @@
+import { AxiError } from "axi-sdk-js";
+import { takeBool, takeFlag } from "../flags.js";
+import { encodeObject, joinBlocks, renderHelp, renderList, truncate } from "../output.js";
+import { activeSession } from "../session.js";
+import { allCachedUsers, ensureUsers, getChannels } from "../slack/cache.js";
+import { formatText, userName } from "../slack/format.js";
+import { getPermalink } from "../slack/permalink.js";
+import { channelLabel, resolveChannel } from "../slack/resolve.js";
+import { fetchWindow, isBot } from "../slack/threads.js";
+import { batchWindows, formatDate, formatDateTime, formatRange, parseSpanMs, resolveWindow, tsToEpochMs } from "../slack/time.js";
+import { handle } from "../slack/ts.js";
+export const CATCHUP_HELP = `usage: slack-axi catchup [flags]
+Sweeps a SCOPED set of channels over a time window and returns everything posted — a multi-channel read.
+Slack has no cross-conversation history endpoint, so this fans out per channel; scope keeps it bounded.
+flags[10]:
+  --since <span>      Window ending now: 1d, 12h, 90m (default: 1d)
+  --from <when>       Window start (date / datetime / span); --to end (default now)
+  --tz <zone>         Timezone (default America/New_York)
+  --every <span>      PLAN MODE: emit batch windows (e.g. 1w) instead of fetching — for big catch-ups
+  --type <a,b>        Conversation types to sweep (default: public,private)
+  --match <q>         Only channels whose name contains <q>
+  --in <c1,c2,...>    Explicit channel list (#name/name/id), overrides --type/--match
+  --limit-per <n>     Max messages per channel (default 50)
+  --max-channels <n>  Refuse to sweep more than this many (default 40)
+  --exclude-bots      Drop bot/automation messages
+  --cite              Add a permalink column
+Threads are not inlined here (kept cheap across many channels); a [+N replies] note marks threads —
+expand one with \`read <channel>\` or \`thread <channel> <ts>\`.
+examples:
+  slack-axi catchup --since 1d --match bid
+  slack-axi catchup --from 2026-05-01 --to 2026-06-07 --every 1w --match bid   (plan a month, weekly)
+  slack-axi catchup --from 2026-06-06T09:00 --in bid-rtd-analytics,transit-lake`;
+const DEFAULT_MAX_CHANNELS = 40;
+const DEFAULT_LIMIT_PER = 50;
+export async function catchupCommand(args) {
+    if (args.includes("--help"))
+        return CATCHUP_HELP;
+    const team = takeFlag(args, "--team");
+    const since = takeFlag(team.rest, "--since");
+    const from = takeFlag(since.rest, "--from");
+    const to = takeFlag(from.rest, "--to");
+    const tz = takeFlag(to.rest, "--tz");
+    const every = takeFlag(tz.rest, "--every");
+    const type = takeFlag(every.rest, "--type");
+    const match = takeFlag(type.rest, "--match");
+    const inList = takeFlag(match.rest, "--in");
+    const limitPer = takeFlag(inList.rest, "--limit-per");
+    const maxCh = takeFlag(limitPer.rest, "--max-channels");
+    const excludeBots = takeBool(maxCh.rest, "--exclude-bots");
+    const cite = takeBool(excludeBots.rest, "--cite");
+    const perCap = posInt(limitPer.value, DEFAULT_LIMIT_PER);
+    const maxChannels = posInt(maxCh.value, DEFAULT_MAX_CHANNELS);
+    const session = await activeSession({ teamFlag: team.value });
+    // Default window for a catch-up is the last day, not the read default of 7d.
+    const window = resolveWindow({ since: since.value ?? (from.value || to.value ? undefined : "1d"), from: from.value, to: to.value, tz: tz.value }, Date.now());
+    // Plan mode: --every emits the batch windows only (no fetch), for the agent to iterate one at a time.
+    if (every.value !== undefined) {
+        const everyMs = parseSpanMs(every.value);
+        if (everyMs === undefined) {
+            throw new AxiError(`Invalid --every '${every.value}'`, "USAGE", ["Use a span like 1w, 3d, or 12h"]);
+        }
+        const batches = batchWindows(window.oldestMs, window.endMs, everyMs);
+        const scope = scopeSuffix({ type: type.value, match: match.value, in: inList.value, excludeBots: excludeBots.present });
+        const rows = batches.map((b, i) => ({
+            n: i + 1,
+            from: formatDate(b.startMs, window.tz),
+            to: formatDate(b.endMs - 1, window.tz),
+        }));
+        return joinBlocks(encodeObject({
+            "catchup-plan": `${batches.length} batches of ${every.value} over ${formatRange(window)}`,
+        }), renderList("batches", rows), renderHelp([
+            `Run each in order: slack-axi catchup --from <from> --to <to>${scope ? ` ${scope}` : ""}`,
+            "Process one batch (read/summarize/ingest), then the next — adjacent batches tile exactly (no gap, no overlap)",
+        ]));
+    }
+    const pool = await resolveScope(session, { inList: inList.value, type: type.value, match: match.value });
+    if (pool.length === 0) {
+        return joinBlocks(encodeObject({ workspace: ws(session), range: formatRange(window) }), encodeObject({ channels: "0 channels matched the scope" }), renderHelp(["Broaden with `--type public,private,mpim,im` or `--match <q>`, or pass `--in <list>`"]));
+    }
+    if (pool.length > maxChannels) {
+        throw new AxiError(`Scope matched ${pool.length} channels; that's above --max-channels (${maxChannels})`, "TOO_MANY_CHANNELS", [
+            "Narrow with `--match <q>` or `--type`, or pass an explicit `--in <c1,c2,...>`",
+            `Or raise the cap: --max-channels ${pool.length}`,
+        ]);
+    }
+    await ensureUsers(session);
+    const users = allCachedUsers(session.teamId);
+    // Sequential sweep to respect Slack's tightened conversations.history rate limits.
+    const active = [];
+    for (const channel of pool) {
+        let msgs = await fetchWindow(session, channel.id, window.oldestMs, window.endMs);
+        if (excludeBots.present)
+            msgs = msgs.filter((m) => !isBot(m));
+        if (msgs.length === 0)
+            continue;
+        const total = msgs.length;
+        const shown = msgs.slice(-perCap);
+        const rows = [];
+        for (const m of shown)
+            rows.push(await buildRow(session, channel.id, m, users, window.tz, cite.present));
+        active.push({ channel, label: await channelLabel(session, channel), total, rows });
+    }
+    const header = encodeObject({
+        workspace: ws(session),
+        range: formatRange(window),
+        swept: `${pool.length} channels (${active.length} with activity)`,
+    });
+    const blocks = [header];
+    for (const a of active) {
+        const incomplete = a.rows.length < a.total ? ` (most recent ${a.rows.length} of ${a.total}; raise --limit-per)` : "";
+        blocks.push(`${a.label} (${a.channel.id})${incomplete}:\n${indentLines(renderList("messages", a.rows), 2)}`);
+    }
+    const help = [
+        active.length > 0 ? "Use `slack-axi read <channel> --from --to` or `thread <channel> <ts>` to expand" : "Nothing posted in this window across the scoped channels",
+        !cite.present ? "Add `--cite`, or `slack-axi cite <channel> <ts...>`, for permalinks" : undefined,
+    ].filter((l) => Boolean(l));
+    return joinBlocks(...blocks, renderHelp(help));
+}
+async function resolveScope(session, opts) {
+    if (opts.inList) {
+        const names = opts.inList.split(",").map((s) => s.trim()).filter(Boolean);
+        return Promise.all(names.map((n) => resolveChannel(session, n)));
+    }
+    const types = (opts.type ?? "public,private").split(",").map((s) => s.trim()).filter(Boolean);
+    let pool = (await getChannels(session)).filter((c) => c.is_member && types.includes(c.type));
+    if (opts.match) {
+        const q = opts.match.toLowerCase();
+        pool = pool.filter((c) => c.name.toLowerCase().includes(q));
+    }
+    return pool;
+}
+async function buildRow(session, channelId, msg, users, tz, cite) {
+    const author = msg.user ? userName(msg.user, users) : msg.botId ? "(bot)" : "(system)";
+    const replyNote = msg.replyCount > 0 ? ` [+${msg.replyCount} repl${msg.replyCount === 1 ? "y" : "ies"}]` : "";
+    const row = {
+        time: formatDateTime(tsToEpochMs(msg.ts), tz),
+        author,
+        text: truncate(formatText(msg.text, users)) + replyNote,
+        ts: handle(msg.ts),
+    };
+    if (cite)
+        row.permalink = await getPermalink(session, channelId, msg.ts);
+    return row;
+}
+function ws(session) {
+    return `${session.teamName ?? session.teamId} (${session.teamId})`;
+}
+/** Rebuild the scope flags for the per-batch command emitted by plan mode. */
+function scopeSuffix(opts) {
+    const parts = [];
+    if (opts.in)
+        parts.push(`--in ${opts.in}`);
+    else {
+        if (opts.type)
+            parts.push(`--type ${opts.type}`);
+        if (opts.match)
+            parts.push(`--match ${opts.match}`);
+    }
+    if (opts.excludeBots)
+        parts.push("--exclude-bots");
+    return parts.join(" ");
+}
+function posInt(value, fallback) {
+    const n = value ? Number.parseInt(value, 10) : NaN;
+    return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+function indentLines(text, spaces) {
+    const pad = " ".repeat(spaces);
+    return text.split("\n").map((line) => (line.length > 0 ? pad + line : line)).join("\n");
+}
+//# sourceMappingURL=catchup.js.map

package/dist/src/commands/catchup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catchup.js","sourceRoot":"","sources":["../../../src/commands/catchup.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/channels.d.ts

@@ -0,0 +1,6 @@
+export declare const CHANNELS_HELP = "usage: slack-axi channels [flags]\nLists the conversations you belong to across ALL types (public, private, group DMs, DMs).\nflags[5]:\n  --type <t>     Filter: public | private | mpim | im\n  --all          List every public+private channel in the workspace (not just yours)\n  --match <q>    Fuzzy-filter by name\n  --limit <n>    Max rows to show (default 50)\n  --fields <a,b> Extra columns: is_member, topic, purpose\nexamples:\n  slack-axi channels\n  slack-axi channels --type private\n  slack-axi channels --match bid\n  slack-axi channels --all --match bid";
+export declare const DMS_HELP = "usage: slack-axi dms\nLists your direct messages (im) and group DMs (mpim) with participant names resolved.";
+export declare const MEMBERS_HELP = "usage: slack-axi members <channel>\nLists the members of a channel (#name, name, or id), names resolved.";
+export declare function channelsCommand(args: string[]): Promise<string>;
+export declare function dmsCommand(args: string[]): Promise<string>;
+export declare function membersCommand(args: string[]): Promise<string>;

package/dist/src/commands/channels.js

@@ -0,0 +1,147 @@
+import { AxiError } from "axi-sdk-js";
+import { takeBool, takeFlag } from "../flags.js";
+import { encodeBlock, joinBlocks, renderHelp, renderList, truncate } from "../output.js";
+import { activeSession } from "../session.js";
+import { cachedChannels, ensureUsers, getChannels, refreshAllChannels, } from "../slack/cache.js";
+import { channelLabel, fuzzyChannelMatches, resolveChannel, userLabel } from "../slack/resolve.js";
+export const CHANNELS_HELP = `usage: slack-axi channels [flags]
+Lists the conversations you belong to across ALL types (public, private, group DMs, DMs).
+flags[5]:
+  --type <t>     Filter: public | private | mpim | im
+  --all          List every public+private channel in the workspace (not just yours)
+  --match <q>    Fuzzy-filter by name
+  --limit <n>    Max rows to show (default 50)
+  --fields <a,b> Extra columns: is_member, topic, purpose
+examples:
+  slack-axi channels
+  slack-axi channels --type private
+  slack-axi channels --match bid
+  slack-axi channels --all --match bid`;
+const DEFAULT_CHANNEL_LIMIT = 50;
+const DEFAULT_DM_LIMIT = 50;
+const DEFAULT_MEMBER_LIMIT = 100;
+function parseLimit(value, fallback) {
+    if (!value)
+        return fallback;
+    const n = Number.parseInt(value, 10);
+    return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+export const DMS_HELP = `usage: slack-axi dms
+Lists your direct messages (im) and group DMs (mpim) with participant names resolved.`;
+export const MEMBERS_HELP = `usage: slack-axi members <channel>
+Lists the members of a channel (#name, name, or id), names resolved.`;
+const TYPE_ORDER = { public: 0, private: 1, mpim: 2, im: 3 };
+export async function channelsCommand(args) {
+    if (args.includes("--help"))
+        return CHANNELS_HELP;
+    const team = takeFlag(args, "--team");
+    const all = takeBool(team.rest, "--all");
+    const type = takeFlag(all.rest, "--type");
+    const match = takeFlag(type.rest, "--match");
+    const limitFlag = takeFlag(match.rest, "--limit");
+    const fields = takeFlag(limitFlag.rest, "--fields");
+    const limit = parseLimit(limitFlag.value, DEFAULT_CHANNEL_LIMIT);
+    const extra = (fields.value ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+    const session = await activeSession({ teamFlag: team.value });
+    let pool;
+    if (all.present) {
+        await refreshAllChannels(session);
+        pool = cachedChannels(session.teamId).filter((c) => c.type === "public" || c.type === "private");
+    }
+    else {
+        pool = (await getChannels(session)).filter((c) => c.is_member);
+    }
+    const total = pool.length;
+    let filtered = pool;
+    if (type.value) {
+        if (!["public", "private", "mpim", "im"].includes(type.value)) {
+            throw new AxiError(`Unknown --type '${type.value}'`, "USAGE", ["Use one of: public, private, mpim, im"]);
+        }
+        filtered = filtered.filter((c) => c.type === type.value);
+    }
+    if (match.value)
+        filtered = fuzzyChannelMatches(filtered, match.value, filtered.length);
+    if (filtered.length === 0) {
+        const why = match.value ? ` matching "${match.value}"` : type.value ? ` of type ${type.value}` : "";
+        return joinBlocks(encodeBlock("channels", `0 channels${why} (of ${total} ${all.present ? "workspace" : "your"} channels)`), renderHelp(all.present ? [] : ["Run `slack-axi channels --all` to include channels you haven't joined"]));
+    }
+    // Resolve labels (im → @user) once, then sort by type group then name.
+    await ensureUsers(session);
+    const labeled = await Promise.all(filtered.map(async (c) => ({ meta: c, label: await channelLabel(session, c) })));
+    labeled.sort((a, b) => TYPE_ORDER[a.meta.type] - TYPE_ORDER[b.meta.type] || a.label.localeCompare(b.label));
+    const matched = filtered.length;
+    const capped = labeled.slice(0, limit);
+    const rows = capped.map(({ meta, label }) => {
+        const row = { id: meta.id, name: label, type: meta.type };
+        if (all.present || extra.includes("is_member"))
+            row.is_member = meta.is_member;
+        if (extra.includes("topic"))
+            row.topic = meta.topic ? truncate(meta.topic, 120) : "";
+        if (extra.includes("purpose"))
+            row.purpose = meta.purpose ? truncate(meta.purpose, 120) : "";
+        return row;
+    });
+    const help = [
+        "Run `slack-axi read <channel>` to read one (threads inlined)",
+        match.value ? undefined : "Narrow with `--match <q>` or `--type public|private|mpim|im`",
+        capped.length < matched ? `Showing ${capped.length} of ${matched}; raise with \`--limit <n>\`` : undefined,
+        all.present ? "Drop `--all` to list just your channels" : "Add `--all` to include channels you haven't joined",
+    ].filter((l) => Boolean(l));
+    return joinBlocks(encodeBlock("workspace", `${session.teamName ?? session.teamId} (${session.teamId})`), renderList("channels", rows, { total: matched }), renderHelp(help));
+}
+export async function dmsCommand(args) {
+    if (args.includes("--help"))
+        return DMS_HELP;
+    const team = takeFlag(args, "--team");
+    const limitFlag = takeFlag(team.rest, "--limit");
+    const limit = parseLimit(limitFlag.value, DEFAULT_DM_LIMIT);
+    const session = await activeSession({ teamFlag: team.value });
+    const dms = (await getChannels(session)).filter((c) => c.is_member && (c.type === "im" || c.type === "mpim"));
+    if (dms.length === 0)
+        return encodeBlock("dms", "0 direct or group-DM conversations");
+    // Sort cheaply (im first, then by id) and cap BEFORE resolving labels.
+    dms.sort((a, b) => TYPE_ORDER[a.type] - TYPE_ORDER[b.type] || a.id.localeCompare(b.id));
+    const capped = dms.slice(0, limit);
+    await ensureUsers(session); // for im labels; mpim participants come from the channel name (no calls)
+    const rows = await Promise.all(capped.map(async (c) => ({ id: c.id, type: c.type, with: await channelLabel(session, c) })));
+    const help = [
+        "Run `slack-axi read <id>` to read a DM thread",
+        capped.length < dms.length ? `Showing ${capped.length} of ${dms.length}; raise with \`--limit <n>\`` : undefined,
+    ].filter((l) => Boolean(l));
+    return joinBlocks(encodeBlock("workspace", `${session.teamName ?? session.teamId} (${session.teamId})`), renderList("dms", rows, { total: dms.length }), renderHelp(help));
+}
+export async function membersCommand(args) {
+    if (args.includes("--help"))
+        return MEMBERS_HELP;
+    const team = takeFlag(args, "--team");
+    const limitFlag = takeFlag(team.rest, "--limit");
+    const limit = parseLimit(limitFlag.value, DEFAULT_MEMBER_LIMIT);
+    const target = limitFlag.rest.find((a) => !a.startsWith("-"));
+    if (!target)
+        throw new AxiError("usage: slack-axi members <channel> [--limit <n>]", "USAGE", []);
+    const session = await activeSession({ teamFlag: team.value });
+    const channel = await resolveChannel(session, target);
+    const ids = await listMembers(session, channel.id);
+    if (ids.length === 0)
+        return encodeBlock("members", `0 members in ${await channelLabel(session, channel)}`);
+    await ensureUsers(session);
+    const labeled = await Promise.all(ids.map(async (id) => ({ user: id, name: await userLabel(session, id) })));
+    labeled.sort((a, b) => a.name.localeCompare(b.name));
+    const rows = labeled.slice(0, limit);
+    const help = rows.length < labeled.length
+        ? [`Showing ${rows.length} of ${labeled.length} members; raise with \`--limit <n>\``]
+        : [];
+    return joinBlocks(encodeBlock("channel", `${await channelLabel(session, channel)} (${channel.id})`), renderList("members", rows, { total: labeled.length }), renderHelp(help));
+}
+/** Channel member ids, paginated to completion. */
+async function listMembers(session, channel) {
+    const ids = [];
+    let cursor;
+    do {
+        const res = await session.client.conversations.members({ channel, limit: 200, ...(cursor ? { cursor } : {}) });
+        ids.push(...(res.members ?? []));
+        cursor = res.response_metadata?.next_cursor || undefined;
+    } while (cursor);
+    return ids;
+}
+//# sourceMappingURL=channels.js.map

package/dist/src/commands/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../../src/commands/channels.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/cite.d.ts

@@ -0,0 +1,2 @@
+export declare const CITE_HELP = "usage: slack-axi cite <channel> <ts> [<ts> ...]\nReconstructs permalinks (and the HQ slack_message {channel, ts, permalink} shape) for the given\nmessage handles. Stateless \u2014 channel + ts is all it needs. ts may be dotless or dotted.\nexamples:\n  slack-axi cite #eng 1717589640123456\n  slack-axi cite C09GHV2RUSJ 1717589640123456 1717589700234567";
+export declare function citeCommand(args: string[]): Promise<string>;

package/dist/src/commands/cite.js

@@ -0,0 +1,38 @@
+import { AxiError } from "axi-sdk-js";
+import { takeFlag } from "../flags.js";
+import { encodeObject, joinBlocks, renderList } from "../output.js";
+import { activeSession } from "../session.js";
+import { getPermalink } from "../slack/permalink.js";
+import { channelLabel, resolveChannel } from "../slack/resolve.js";
+import { dottedTs, handle } from "../slack/ts.js";
+export const CITE_HELP = `usage: slack-axi cite <channel> <ts> [<ts> ...]
+Reconstructs permalinks (and the HQ slack_message {channel, ts, permalink} shape) for the given
+message handles. Stateless — channel + ts is all it needs. ts may be dotless or dotted.
+examples:
+  slack-axi cite #eng 1717589640123456
+  slack-axi cite C09GHV2RUSJ 1717589640123456 1717589700234567`;
+export async function citeCommand(args) {
+    if (args.includes("--help"))
+        return CITE_HELP;
+    const team = takeFlag(args, "--team");
+    const positional = team.rest.filter((a) => !a.startsWith("-"));
+    const [target, ...tsArgs] = positional;
+    if (!target || tsArgs.length === 0) {
+        throw new AxiError("usage: slack-axi cite <channel> <ts> [<ts> ...]", "USAGE", [
+            "Pass a channel and one or more ts handles from a `read`/`search` row",
+        ]);
+    }
+    const session = await activeSession({ teamFlag: team.value });
+    const channel = await resolveChannel(session, target);
+    const rows = await Promise.all(tsArgs.map(async (raw) => {
+        const ts = dottedTs(raw);
+        try {
+            return { ts: handle(ts), permalink: await getPermalink(session, channel.id, ts) };
+        }
+        catch {
+            return { ts: handle(ts), permalink: "(not found in this channel)" };
+        }
+    }));
+    return joinBlocks(encodeObject({ workspace: `${session.teamName ?? session.teamId} (${session.teamId})`, channel: `${await channelLabel(session, channel)} (${channel.id})` }), renderList("citations", rows));
+}
+//# sourceMappingURL=cite.js.map

package/dist/src/commands/cite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cite.js","sourceRoot":"","sources":["../../../src/commands/cite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;+DAKsC,CAAC;AAEhE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC;IACvC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,QAAQ,CAAC,iDAAiD,EAAE,OAAO,EAAE;YAC7E,sEAAsE;SACvE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEtD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACpF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,6BAA6B,EAAE,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,UAAU,CACf,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAC5J,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAC9B,CAAC;AACJ,CAAC"}

package/dist/src/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare const DOCTOR_HELP = "usage: slack-axi doctor [--team <id>]\nChecks the active workspace's token, scope coverage, and read access.\nExit 1 if any check fails; warnings (e.g. a missing scope) keep exit 0.";
+export declare function doctorCommand(args: string[]): Promise<string>;

package/dist/src/commands/doctor.js

@@ -0,0 +1,46 @@
+import { resolveActiveToken } from "../config.js";
+import { takeFlag } from "../flags.js";
+import { encodeBlock, joinBlocks, renderHelp, renderList } from "../output.js";
+import { validateToken, webClient } from "../slack/client.js";
+import { toAxiError } from "../slack/errors.js";
+import { missingScopes } from "../slack/scopes.js";
+export const DOCTOR_HELP = `usage: slack-axi doctor [--team <id>]
+Checks the active workspace's token, scope coverage, and read access.
+Exit 1 if any check fails; warnings (e.g. a missing scope) keep exit 0.`;
+export async function doctorCommand(args) {
+    if (args.includes("--help"))
+        return DOCTOR_HELP;
+    const { value: teamFlag } = takeFlag(args, "--team");
+    const active = resolveActiveToken({ teamFlag });
+    const checks = [];
+    // 1. Token validity (hard fail → exit 1).
+    let identity;
+    try {
+        identity = await validateToken(active.token);
+    }
+    catch (err) {
+        throw toAxiError(err, teamFlag ? { team: teamFlag } : {});
+    }
+    checks.push({ check: "token", status: "ok", detail: "auth.test passed" });
+    // 2. Scope coverage (missing → warn, exit 0).
+    const missing = missingScopes(identity.scopes);
+    checks.push({
+        check: "scopes",
+        status: missing.length === 0 ? "ok" : "warn",
+        detail: missing.length === 0 ? "all required granted" : `missing ${missing.join(", ")}`,
+    });
+    // 3. Read probe (hard fail → exit 1).
+    try {
+        await webClient(active.token).users.conversations({ limit: 1 });
+        checks.push({ check: "read_probe", status: "ok", detail: "users.conversations reachable" });
+    }
+    catch (err) {
+        throw toAxiError(err, teamFlag ? { team: teamFlag } : {});
+    }
+    const header = encodeBlock("workspace", `${identity.teamName} (${identity.teamId}) as ${identity.userName ?? identity.userId}`);
+    const help = missing.length > 0
+        ? renderHelp([`Add missing scopes via \`slack-axi auth setup\`, then re-install + re-login`])
+        : "";
+    return joinBlocks(header, renderList("checks", checks), help);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/src/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/home.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Content-first no-args view. See specs/commands/home.md. The SDK prepends the bin/description
+ * header; this returns the live state below it.
+ * In plan 01 this shows auth/workspace state; unread + top-channels arrive with plan 02.
+ */
+export declare function homeCommand(): Promise<string>;

package/dist/src/commands/home.js

@@ -0,0 +1,37 @@
+import { listWorkspaceIds, resolveActiveToken } from "../config.js";
+import { encodeBlock, joinBlocks, renderHelp } from "../output.js";
+import { cachedChannels } from "../slack/cache.js";
+/**
+ * Content-first no-args view. See specs/commands/home.md. The SDK prepends the bin/description
+ * header; this returns the live state below it.
+ * In plan 01 this shows auth/workspace state; unread + top-channels arrive with plan 02.
+ */
+export async function homeCommand() {
+    let active;
+    try {
+        active = resolveActiveToken({});
+    }
+    catch {
+        // No token resolvable → setup-oriented home.
+        return renderHelp([
+            "Run `slack-axi auth setup` to create a Slack app and obtain a user token",
+            "Then `slack-axi auth login --token xoxp-...`",
+        ]);
+    }
+    const workspaceLabel = active.teamName
+        ? `${active.teamName} (${active.teamId ?? "?"})`
+        : active.teamId ?? "(from SLACK_AXI_TOKEN)";
+    const stored = listWorkspaceIds();
+    // Cache-only (no network): home loads on every session, so never refresh here.
+    const channelCount = active.teamId ? cachedChannels(active.teamId).filter((c) => c.is_member).length : 0;
+    const statusFields = { workspace: workspaceLabel };
+    if (channelCount > 0)
+        statusFields.your_channels = channelCount;
+    const status = encodeBlock("status", statusFields);
+    const help = ["Run `slack-axi channels` to list your channels (all types)"];
+    if (stored.length > 1)
+        help.push("Run `slack-axi auth workspaces` to see all workspaces");
+    help.push("Run `slack-axi doctor` to verify auth + scopes");
+    return joinBlocks(status, renderHelp(help));
+}
+//# sourceMappingURL=home.js.map

package/dist/src/commands/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","sourceRoot":"","sources":["../../../src/commands/home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;QAC7C,OAAO,UAAU,CAAC;YAChB,0EAA0E;YAC1E,8CAA8C;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ;QACpC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG;QAChD,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,wBAAwB,CAAC;IAE9C,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,+EAA+E;IAC/E,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzG,MAAM,YAAY,GAA4B,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5E,IAAI,YAAY,GAAG,CAAC;QAAE,YAAY,CAAC,aAAa,GAAG,YAAY,CAAC;IAChE,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAEnD,MAAM,IAAI,GAAa,CAAC,4DAA4D,CAAC,CAAC;IACtF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IAC1F,IAAI,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAE5D,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/src/commands/read.d.ts

@@ -0,0 +1,4 @@
+export declare const READ_HELP = "usage: slack-axi read <channel> [flags]\nReads a channel over a time window, threads inlined, paginated to completion.\nflags[8]:\n  --since <span>   Relative window ending now: 7d, 24h, 90m (default: 7d)\n  --from <when>    Window start: date (2026-04-23), datetime (2026-04-23T14:00), or span\n  --to <when>      Window end (default: now)\n  --tz <zone>      Timezone for parsing + display (default: America/New_York)\n  --limit <n>      Max top-level messages to show (default: 50)\n  --threads <m>    full | summary | none (default: full)\n  --exclude-bots   Drop bot/automation messages\n  --cite           Add a permalink column (for bulk citation); else use ts + `cite`\n  --full           Don't truncate message text\nexamples:\n  slack-axi read #bid-rtd-analytics\n  slack-axi read #eng --from 2026-04-23 --to 2026-04-29\n  slack-axi read #eng --since 24h --threads summary";
+export declare const THREAD_HELP = "usage: slack-axi thread <channel> <ts>\nReads a single thread fully (parent + all replies), names + permalinks resolved.";
+export declare function readCommand(args: string[]): Promise<string>;
+export declare function threadCommand(args: string[]): Promise<string>;