@isaacriehm/cairn 0.1.0

package/dist/frontend/discord/channels.js

@@ -0,0 +1,58 @@
+import { ChannelType, } from "discord.js";
+/**
+ * Channel-per-task lifecycle per L09 + `WORKFLOW_GUIDE` §0:
+ *   📋 backlog  — proposed but not dispatched
+ *   🟢 active   — task in flight
+ *   📦 archive  — task closed (locked for writes)
+ */
+export const CATEGORY_NAMES = {
+    backlog: "📋 backlog",
+    active: "🟢 active",
+    archive: "📦 archive",
+};
+export async function ensureCategories(guild) {
+    const result = {};
+    for (const key of Object.keys(CATEGORY_NAMES)) {
+        const name = CATEGORY_NAMES[key];
+        const existing = guild.channels.cache.find((c) => c.type === ChannelType.GuildCategory && c.name === name);
+        if (existing) {
+            result[key] = existing;
+            continue;
+        }
+        const created = await guild.channels.create({
+            name,
+            type: ChannelType.GuildCategory,
+        });
+        result[key] = created;
+    }
+    return result;
+}
+/**
+ * Slugify task body to a channel-safe suffix. Discord channel names allow
+ * lowercase letters, digits, and hyphens; max 100 chars total.
+ */
+export function slugifyForChannel(body, max = 40) {
+    const cleaned = body
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-{2,}/g, "-");
+    if (cleaned.length === 0)
+        return "task";
+    return cleaned.slice(0, max);
+}
+export async function createTaskChannel(args) {
+    const { guild, category, taskId, bodySlug } = args;
+    const name = `task-${bodySlug}-${taskId}`.slice(0, 95);
+    const channel = await guild.channels.create({
+        name,
+        type: ChannelType.GuildText,
+        parent: category.id,
+    });
+    return channel;
+}
+export async function moveChannelToCategory(args) {
+    const { channel, category } = args;
+    await channel.setParent(category.id, { lockPermissions: true });
+}
+//# sourceMappingURL=channels.js.map

package/dist/frontend/discord/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../../src/frontend/discord/channels.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAIZ,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;CACb,CAAC;AAIX,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAY;IAEZ,MAAM,MAAM,GAAG,EAA0C,CAAC;IAC1D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAkB,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CACxC,CAAC,CAAC,EAAwB,EAAE,CAC1B,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,aAAa,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAC1D,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC1C,IAAI;YACJ,IAAI,EAAE,WAAW,CAAC,aAAa;SAChC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,GAAG,GAAG,EAAE;IACtD,MAAM,OAAO,GAAG,IAAI;SACjB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC1B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAKvC;IACC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACnD,MAAM,IAAI,GAAG,QAAQ,QAAQ,IAAI,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC1C,IAAI;QACJ,IAAI,EAAE,WAAW,CAAC,SAAS;QAC3B,MAAM,EAAE,QAAQ,CAAC,EAAE;KACpB,CAAC,CAAC;IACH,OAAO,OAAsB,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAG3C;IACC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACnC,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/frontend/discord/classifier.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tier-0 free-text intent classifier — Phase 5 stub.
+ *
+ * Per `RESUME_PROMPT.md` §10 deliverable 4: real Tier-0 = Ollama llama3.2:3b
+ * (Phase 6, alongside Whisper). Phase 5 ships a deterministic regex matcher
+ * so smoke tests pass without an Ollama install. Same return shape as the
+ * future Ollama path — drop-in replacement when Phase 6 lands.
+ *
+ * Output `intent` matches the inbox-row vocabulary the orchestrator (Phase 8)
+ * will dispatch on. Add intents here as they are needed.
+ */
+export type FreeTextIntent = "code_task" | "review" | "direction" | "question" | "halt" | "status" | "unknown";
+export declare function classifyFreeText(text: string): {
+    intent: FreeTextIntent;
+    confidence: number;
+};

package/dist/frontend/discord/classifier.js

@@ -0,0 +1,29 @@
+const RULES = [
+    { intent: "halt", pattern: /^\s*(halt|stop|cancel|kill)\b/i },
+    { intent: "status", pattern: /^\s*(status|state|how['’]?s it going)\b/i },
+    {
+        intent: "direction",
+        pattern: /^\s*(scrap that|actually|new direction|going forward|from now on)\b/i,
+    },
+    {
+        intent: "code_task",
+        pattern: /^\s*(fix|add|update|create|build|implement|refactor|delete|remove|migrate|wire|hook|land|rip out|rip)\b/i,
+    },
+    {
+        intent: "review",
+        pattern: /^\s*(review|audit|check|inspect|look at|smoke|sanity)\b/i,
+    },
+    {
+        intent: "question",
+        pattern: /^\s*(why|how|what|when|where|which|is|are|does|do|can|should)\b/i,
+    },
+];
+export function classifyFreeText(text) {
+    for (const rule of RULES) {
+        if (rule.pattern.test(text)) {
+            return { intent: rule.intent, confidence: 0.6 };
+        }
+    }
+    return { intent: "unknown", confidence: 0 };
+}
+//# sourceMappingURL=classifier.js.map

package/dist/frontend/discord/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../../src/frontend/discord/classifier.ts"],"names":[],"mappings":"AAyBA,MAAM,KAAK,GAA4B;IACrC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gCAAgC,EAAE;IAC7D,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,0CAA0C,EAAE;IACzE;QACE,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,sEAAsE;KAChF;IACD;QACE,MAAM,EAAE,WAAW;QACnB,OAAO,EACL,0GAA0G;KAC7G;IACD;QACE,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,0DAA0D;KACpE;IACD;QACE,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,kEAAkE;KAC5E;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAI3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AAC9C,CAAC"}

package/dist/frontend/discord/index.d.ts

@@ -0,0 +1,118 @@
+import type { Approval, ApprovalBundle, DialogResponse, DialogSpec, FreeTextEvent, FrontendAdapter, FrontendTask, IngestHandler, InteractionEvent, NotifyLevel, PostUpdate, SlashEvent, VoiceMessage } from "../types.js";
+import type { Tier0ClassifyOptions } from "../../tier0/index.js";
+import { CATEGORY_NAMES, ensureCategories, moveChannelToCategory, slugifyForChannel, type CategoryKey } from "./channels.js";
+export interface DiscordFrontendAdapterOptions {
+    /** Repo root (mirror checkout in production; project root in dev/smoke). */
+    repoRoot: string;
+    /** Bot token from `harness/.env`. */
+    token: string;
+    /** Discord guild (server) id. */
+    guildId: string;
+    /**
+     * Application id (bot's user-id). Optional — if omitted the adapter reads
+     * `client.application.id` after login.
+     */
+    applicationId?: string;
+    /** Comma-separated owner Discord user-ids env value. */
+    ownerUserIdsEnv: string | undefined;
+    /**
+     * Skip slash-command registration on start. Useful for tests; production
+     * always registers on every start to keep guild commands fresh.
+     */
+    skipSlashRegistration?: boolean;
+    /**
+     * Confidence floor for voice transcription. Below this, the bot posts a
+     * "Heard: '...' — confirm?" prompt with 🟢/🔴 buttons before treating the
+     * transcript as a real ingest. Default per L11/voice config: 0.85.
+     */
+    confidenceFloor?: number;
+    /** Tier-0 classifier overrides (host, model, fallback). */
+    tier0?: Tier0ClassifyOptions;
+}
+/**
+ * Real Discord adapter. Implements `FrontendAdapter`. Phase 5 wires:
+ *   - slash command surface per `WORKFLOW_GUIDE.md` §3
+ *   - channel-per-task lifecycle in 📋/🟢/📦 categories
+ *   - ACL on `DISCORD_OWNER_USER_IDS`
+ *   - free-text → regex Tier-0 stub (real Ollama in Phase 6)
+ *   - voice attachments → inbox row only (Whisper transcription Phase 6)
+ *   - button interactions for approval / dialog round-trips
+ *
+ * Inbox rows are the only output Phase 5 produces — the orchestrator (Phase
+ * 8) is the consumer. No code dispatch lives here.
+ */
+export declare class DiscordFrontendAdapter implements FrontendAdapter {
+    readonly name = "discord";
+    private readonly opts;
+    private readonly ownerIds;
+    private readonly client;
+    private readonly confidenceFloor;
+    private readonly tier0Opts;
+    private taskHandler;
+    private voiceHandler;
+    private slashHandler;
+    private freeTextHandler;
+    private interactionHandler;
+    private pendingApprovals;
+    private pendingDialogs;
+    /**
+     * §3.4 win 1 — bundleId → messageId for in-place dialog edit. When a
+     * follow-up DialogSpec arrives with `replaceBundleId` set, the adapter
+     * fetches that message and edits it (new prompt + new buttons) instead
+     * of posting a fresh one. Single edited message replaces the N+1
+     * scroll explosion.
+     */
+    private dialogMessageIds;
+    /**
+     * In-memory map of taskId → live status messageId. The live status
+     * message is one embed per task that gets edited in place on each
+     * postTaskUpdate call (instead of spamming the channel with a new
+     * message per phase). Restart loses the mapping; a fresh run posts a
+     * new live status message.
+     */
+    private liveStatusMessages;
+    /**
+     * Channels that have responded with Unknown Channel (Discord error
+     * 10003). Once flagged dead, subsequent postTaskUpdate / sendTyping
+     * / requestDialog calls bail without hitting Discord. This stops the
+     * 8s typing heartbeat from spamming logs after the operator deletes
+     * a per-task channel mid-run.
+     */
+    private deadChannels;
+    private started;
+    constructor(opts: DiscordFrontendAdapterOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    onTask(handler: IngestHandler<FrontendTask>): void;
+    onVoice(handler: IngestHandler<VoiceMessage>): void;
+    onSlash(handler: IngestHandler<SlashEvent>): void;
+    onFreeText(handler: IngestHandler<FreeTextEvent>): void;
+    onInteraction(handler: IngestHandler<InteractionEvent>): void;
+    postTaskUpdate(update: PostUpdate): Promise<void>;
+    requestApproval(bundle: ApprovalBundle): Promise<Approval>;
+    requestDialog(spec: DialogSpec): Promise<DialogResponse>;
+    isChannelAlive(channelId: string): Promise<boolean>;
+    startTyping(channelId: string): () => void;
+    notify(level: NotifyLevel, message: string): Promise<void>;
+    /**
+     * Discord error 10003 = Unknown Channel. Operator deleted the
+     * per-task channel after the harness recorded its id. Once flagged,
+     * silently no-op on every subsequent send/edit/typing call so we
+     * don't spam logs while the orchestrator winds the run down.
+     */
+    private isChannelDead;
+    private markChannelDead;
+    private requireGuild;
+    private handleInteraction;
+    private handleSlash;
+    private handleTaskCommand;
+    private handleButton;
+    /**
+     * Stamp the bot's processing on the message: success → ✅, decline →
+     * ❌, ask → ❓. Best-effort; reaction failures don't bubble.
+     */
+    private ackReact;
+    private handleMessage;
+    private handleVoiceAttachment;
+}
+export { CATEGORY_NAMES, ensureCategories, moveChannelToCategory, slugifyForChannel, type CategoryKey, };