lastlight 0.1.15 → 0.2.1

package/dist/engine/classifier.js

@@ -5,66 +5,195 @@
  * a GitHub comment is requesting a code change (build/fix), an idea
  * exploration, or a lightweight action (close, label, question, etc.).
  */
+import { chat as realChat, defaultFastModel as realDefaultFastModel } from "./llm.js";
 const CLASSIFIER_PROMPT = `You are a router for messages directed at a GitHub/Slack bot.
 Classify the user's message into exactly one category, and extract any repository or issue references.
 
 Categories:
-BUILD — The user wants code changes NOW: implement a feature, fix a bug, write code, create/send a PR, resolve an issue with code. They already know what to build.
-EXPLORE — The user has a half-formed idea and wants help thinking it through BEFORE code: "help me think through X", "brainstorm Y", "spec this out", "explore an idea for Z".
-TRIAGE — The user wants to scan/triage issues on a repo: "triage cliftonc/repo", "scan for new issues".
-REVIEW — The user wants to review PRs on a repo: "review cliftonc/repo", "check PRs".
+BUILD — The user is ASKING YOU (the bot) to make code changes NOW in a GitHub repo: implement a feature, fix a bug, create/send a PR, resolve an issue with code. BUILD requires a GitHub target — either an explicit repo reference (owner/name or github.com URL) in the message, OR an ISSUE TITLE context line indicating the comment is a reply on an existing issue/PR. If neither is present, classify as CHAT — local filesystem operations ("delete files in ~/foo", "clean up my downloads"), shell-style commands, or vague "build something" with no target are NOT BUILD.
+  BUILD is a REQUEST for NEW work directed at you. A comment that merely REPORTS work the human has ALREADY done is NOT BUILD — it is CHAT. Tells: past-tense ("fixed", "done", "implemented", "added a test", "pushed a fix", "handled it"), a reference to a commit the human made ("addressed in <sha>", "see commit abc123"), thanking you, or explaining/justifying a change they made in response to your review. These are status reports, not requests — classify them CHAT even when the comment is on a PR and even when it @-mentions you. Only classify BUILD when the human asks you to do NEW work (imperative request: "fix X", "now also handle Y", "can you update Z").
+EXPLORE — The user wants help shaping an idea BEFORE writing code: "help me think through X", "brainstorm Y", "spec this out", "explore an idea for Z". A bare "explore" / "explore this" / "let's explore" is also EXPLORE — especially as a reply on an existing issue (ISSUE TITLE present), where the implicit object is the issue's idea. EXPLORE = shape the idea / write a spec; BUILD = write the code now.
+QUESTION — The user is asking a substantive INFORMATIONAL question that warrants research to answer well: "how does X work?", "what's the difference between X and Y?", "how does <repo> compare to <other tool>?", "is it possible to do Z?", "why does X happen?". The deliverable is an ANSWER, not code and not a spec. QUESTION is for real questions that benefit from reading docs/code or searching the web — NOT casual chat, thanks, or one-word replies (those stay CHAT). EXPLORE shapes a NEW idea into a spec; QUESTION answers an EXISTING question about how something works or compares.
+TRIAGE — The user wants to scan/triage issues on a repo: "triage cliftonc/repo", "scan for new issues", "can you triage <repo>?".
+REVIEW — The user wants to review PRs on a repo: "review cliftonc/repo", "check PRs", "can you review PRs on <repo>?".
+SECURITY — The user wants a security scan/review of a repo: "security review cliftonc/repo", "scan for vulnerabilities", "check security", "can you do a security review of <repo>?".
+VERIFY — The user wants you to TEST whether a specific claim or behaviour is actually true and report the evidence: "verify that the rate limiter blocks", "does this PR really fix the crash?", "confirm X actually works", "check that Y no longer happens", "prove the --fork flag creates a new session". The deliverable is a CONFIRMED/REFUTED verdict backed by RUNNING the code — not a code change and not a code-quality review. Prefer VERIFY over REVIEW when the user wants proof a behaviour works/is fixed, rather than an assessment of the diff.
+QATEST — The user wants you to drive an app or CLI through a flow and report step-level pass/fail: "qa test the signup flow", "run through login and tell me what breaks", "smoke-test the CLI commands", "exercise the checkout flow". The deliverable is a step-by-step QA report. Prefer QATEST over VERIFY when it's a multi-step flow to exercise rather than a single claim to confirm.
+DEMO — The user wants you to record a DEMO VIDEO of a feature/PR: "demo this", "record a demo of the new dashboard", "make a video showing the dark-mode toggle", "show me a before/after of the fix". The deliverable is a short screen-recorded mp4 of the running web UI, not a pass/fail report and not a verdict. Prefer DEMO over QATEST/VERIFY when the user explicitly asks for a recording, a video, or "show"/"demo" rather than to test or confirm a behaviour.
 APPROVE — The user is approving a pending gate: "approve", "go ahead", "looks good, continue", "yes proceed".
 REJECT — The user is rejecting a pending gate: "reject", "abort", "cancel this", "no don't proceed". Extract any reason given.
 STATUS — The user wants to know what's running: "status", "what's running", "any tasks active?".
 RESET — The user wants to start a fresh session: "new", "reset", "start over", "fresh session".
-CHAT — Anything else: questions, conversation, thanks, general discussion.
+CHAT — Anything else: questions, conversation, thanks, general discussion, and status reports of work the human already did ("thanks, fixed in <sha>", "addressed your comments", "done — added tests").
 
-When ambiguous between EXPLORE and CHAT, prefer CHAT. Only pick EXPLORE when the user is explicitly asking for brainstorming / spec-shaping / design exploration.
+Polite or question phrasings are still clear intent. "Can you do a security review of X?",
+"could you triage <repo>?", "please review PRs on <repo>" are SECURITY, TRIAGE, REVIEW
+respectively — not CHAT. The "prefer CHAT when ambiguous" rule only applies when the
+message has no clear action verb. Presence of "security review", "triage", "review PRs",
+"scan for vulnerabilities", etc. makes the intent unambiguous regardless of politeness.
+
+When ambiguous between EXPLORE and CHAT, prefer CHAT. Only pick EXPLORE when the user is explicitly asking for brainstorming / spec-shaping / design exploration — OR gives a bare "explore"/"explore this" command (see the issue-reply rule below), which is unambiguous, not chat.
+When ambiguous between QUESTION and CHAT, prefer CHAT — only pick QUESTION for a substantive informational question that genuinely benefits from research (reading docs/code or a web search). Casual conversation, greetings, thanks, and trivial one-liners stay CHAT.
 When ambiguous between BUILD and CHAT, prefer CHAT.
+When ambiguous between VERIFY/QATEST and REVIEW/CHAT, prefer the existing category — only pick VERIFY or QATEST when the user explicitly asks you to test, run, confirm, or exercise a behaviour/flow.
+When ambiguous between DEMO and VERIFY/QATEST, prefer the existing category — only pick DEMO when the user explicitly asks for a video, a recording, or to "demo"/"show" the feature.
 When ambiguous between APPROVE/REJECT and CHAT, prefer CHAT — only classify as APPROVE/REJECT when the intent is clearly about a pending workflow gate.
 
+Repo extraction: always emit REPO as "owner/name" (never a URL). If the message contains
+a github.com URL, convert it: https://github.com/cliftonc/lastlight → cliftonc/lastlight.
+URL paths like /issues/42 or /pull/5 should populate ISSUE as well.
+
+When the message is a reply on an existing issue/PR, the issue title is provided
+as ISSUE TITLE. Short imperative replies classify by their verb, with the issue
+as the implicit object — the "prefer CHAT when ambiguous" rule does NOT apply to
+a clear command directed at the issue's subject:
+- "lets build this", "build it", "go ahead", "ship it", "do it", "implement
+  this", "make it so" → BUILD (write the code now).
+- "explore", "explore this", "let's explore", "think this through", "spec this
+  out", "brainstorm this" → EXPLORE (shape the idea / write a spec first).
+A bare command word ("explore", "build") on an existing issue is a clear
+command, NOT ambiguous chat.
+This verb rule is for IMPERATIVE requests only. A PR/issue reply that REPORTS
+already-completed work or responds to your review — "thanks, fixed in <sha>",
+"addressed in commit abc123", "done, added a regression test", "this is
+intentional, confirmed with the maintainer" — is a status report, NOT a
+command. Classify it CHAT regardless of the ISSUE TITLE or an @mention. Do not
+let words like "fix"/"build"/"add" inside a past-tense report flip it to BUILD.
+
 Respond in exactly this format (each on its own line, no extra text):
-INTENT: BUILD|EXPLORE|TRIAGE|REVIEW|APPROVE|REJECT|STATUS|RESET|CHAT
+INTENT: BUILD|EXPLORE|QUESTION|TRIAGE|REVIEW|SECURITY|VERIFY|QATEST|DEMO|APPROVE|REJECT|STATUS|RESET|CHAT
 REPO: owner/name or NONE
 ISSUE: number or NONE
 REASON: text or NONE
 
 Examples:
 "explore adding webhooks to cliftonc/drizby" → INTENT: EXPLORE, REPO: cliftonc/drizby, ISSUE: NONE, REASON: NONE
+"how does cliftonc/lastlight compare to Vercel's Eve framework?" → INTENT: QUESTION, REPO: cliftonc/lastlight, ISSUE: NONE, REASON: NONE
+"what's the difference between a sandbox phase and a chat session in cliftonc/lastlight?" → INTENT: QUESTION, REPO: cliftonc/lastlight, ISSUE: NONE, REASON: NONE
+"thanks, that makes sense!" → INTENT: CHAT, REPO: NONE, ISSUE: NONE, REASON: NONE
 "build cliftonc/drizzle-cube#42" → INTENT: BUILD, REPO: cliftonc/drizzle-cube, ISSUE: 42, REASON: NONE
+"lets build this!" with ISSUE TITLE "Security Review" → INTENT: BUILD, REPO: NONE, ISSUE: NONE, REASON: NONE
+"go ahead" with ISSUE TITLE "Add CSV export" → INTENT: BUILD, REPO: NONE, ISSUE: NONE, REASON: NONE
+"Thanks @last-light — addressed in 49ccadf. Fixed the nested body in the core and added a regression test; point 3 is intentional, confirmed with the maintainer." with ISSUE TITLE "Port fastify/hono/nextjs adapters" → INTENT: CHAT, REPO: NONE, ISSUE: NONE, REASON: NONE
+"done, pushed a fix for the type error in 1a2b3c4" with ISSUE TITLE "Fix build" → INTENT: CHAT, REPO: NONE, ISSUE: NONE, REASON: NONE
+"now also handle the GET /sql case please" with ISSUE TITLE "Port adapters" → INTENT: BUILD, REPO: NONE, ISSUE: NONE, REASON: NONE
+"verify that the --fork flag creates a new session in cliftonc/foo#12" → INTENT: VERIFY, REPO: cliftonc/foo, ISSUE: 12, REASON: NONE
+"does this actually fix the crash?" with ISSUE TITLE "Fix null deref on resize" → INTENT: VERIFY, REPO: NONE, ISSUE: NONE, REASON: NONE
+"can you confirm the rate limiter actually blocks at 100 req/s?" with ISSUE TITLE "Add rate limiter" → INTENT: VERIFY, REPO: NONE, ISSUE: NONE, REASON: NONE
+"qa test the login flow on this PR" with ISSUE TITLE "Add login" → INTENT: QATEST, REPO: NONE, ISSUE: NONE, REASON: NONE
+"run through the signup flow and tell me what breaks" with ISSUE TITLE "Signup v2" → INTENT: QATEST, REPO: NONE, ISSUE: NONE, REASON: NONE
+"record a demo of this" with ISSUE TITLE "Add dark-mode toggle" → INTENT: DEMO, REPO: NONE, ISSUE: NONE, REASON: NONE
+"make a short before/after video of the fix on cliftonc/foo#12" → INTENT: DEMO, REPO: cliftonc/foo, ISSUE: 12, REASON: NONE
+"explore" with ISSUE TITLE "Feature: Allow configuration of otel endpoints" → INTENT: EXPLORE, REPO: NONE, ISSUE: NONE, REASON: NONE
+"explore this" with ISSUE TITLE "Add webhook support" → INTENT: EXPLORE, REPO: NONE, ISSUE: NONE, REASON: NONE
 "approve" → INTENT: APPROVE, REPO: NONE, ISSUE: NONE, REASON: NONE
 "reject, the plan is too complex" → INTENT: REJECT, REPO: NONE, ISSUE: NONE, REASON: the plan is too complex
-"what's running?" → INTENT: STATUS, REPO: NONE, ISSUE: NONE, REASON: NONE`;
+"what's running?" → INTENT: STATUS, REPO: NONE, ISSUE: NONE, REASON: NONE
+"run a security review on cliftonc/lastlight" → INTENT: SECURITY, REPO: cliftonc/lastlight, ISSUE: NONE, REASON: NONE
+"can you do a security review of https://github.com/cliftonc/lastlight" → INTENT: SECURITY, REPO: cliftonc/lastlight, ISSUE: NONE, REASON: NONE
+"could you triage https://github.com/foo/bar?" → INTENT: TRIAGE, REPO: foo/bar, ISSUE: NONE, REASON: NONE
+"please review https://github.com/foo/bar/pull/42" → INTENT: REVIEW, REPO: foo/bar, ISSUE: 42, REASON: NONE
+"scan https://github.com/cliftonc/lastlight for vulnerabilities" → INTENT: SECURITY, REPO: cliftonc/lastlight, ISSUE: NONE, REASON: NONE
+"delete any files in ~/work/lastlight/docs" → INTENT: CHAT, REPO: NONE, ISSUE: NONE, REASON: NONE
+"can you remove the old docs folder for me" (no ISSUE TITLE, no repo) → INTENT: CHAT, REPO: NONE, ISSUE: NONE, REASON: NONE
+"build something cool" (no repo, no ISSUE TITLE) → INTENT: CHAT, REPO: NONE, ISSUE: NONE, REASON: NONE`;
+/**
+ * Extract owner/repo and optional issue/PR number from any github.com URL
+ * in the text. Belt-and-suspenders for the LLM — if the classifier forgets
+ * to normalize a URL to owner/name, this fallback still recovers the repo.
+ * Returns undefined when no github.com URL is present.
+ */
+export function extractGithubRefFromText(text) {
+    // URL with /issues/N or /pull/N — capture the number too
+    const withNumber = text.match(/github\.com\/([\w-]+)\/([\w.-]+?)\/(?:issues|pull)\/(\d+)\b/i);
+    if (withNumber) {
+        return {
+            repo: `${withNumber[1]}/${cleanRepoName(withNumber[2])}`,
+            issueNumber: parseInt(withNumber[3], 10),
+        };
+    }
+    // Bare repo URL — stop at next slash / whitespace / query / fragment, then
+    // strip trailing sentence punctuation and any .git suffix.
+    const bare = text.match(/github\.com\/([\w-]+)\/([\w.-]+?)(?=[\s/?#,]|$)/i);
+    if (bare) {
+        return { repo: `${bare[1]}/${cleanRepoName(bare[2])}` };
+    }
+    return undefined;
+}
+function cleanRepoName(name) {
+    // Repo names don't end in punctuation; a trailing `.` or `,` is sentence
+    // punctuation that leaked into the match.
+    return name.replace(/[.,]+$/, "").replace(/\.git$/i, "");
+}
+const ISSUE_QUESTION_PROMPT = `You are a router for newly-opened GitHub issues.
+Decide whether the issue is a QUESTION or a WORK item.
+
+QUESTION — the issue asks for information, explanation, comparison, or guidance.
+The reporter wants an ANSWER, not code: "How does X work?", "What's the difference
+between X and Y?", "Is it possible to...?", "Which approach should I use?", "Why
+does X happen?". The deliverable is a written reply.
+
+WORK — the issue requests a code change: a bug report (something is broken and
+should be fixed) or a feature/enhancement request (build or change something).
+The deliverable is a commit or PR.
+
+Decide by the DOMINANT intent. If the issue asks a question AND also requests a
+change ("How do I do X — and could you add it?"), it is WORK: the change is the
+deliverable and triage should handle it. Only pure information requests are QUESTION.
+When genuinely unsure, answer WORK — triage is the safe default.
+
+Respond with exactly one word on its own line: QUESTION or WORK`;
+/**
+ * Classify whether a newly-opened issue is a pure question (wants an answer)
+ * versus a work item (wants a code change). Used by the router to send
+ * question issues down the dedicated answer path instead of triage.
+ *
+ * Falls back to `false` (WORK → triage) on any error — triage is the safe
+ * default, and a question that slips through still hits the issue-triage
+ * skill's question safety net.
+ */
+export async function classifyIssueIsQuestion(title, body, options = {}) {
+    try {
+        const chat = options.chat ?? realChat;
+        const defaultFastModel = options.defaultFastModel ?? realDefaultFastModel;
+        const output = await chat(options.model ?? defaultFastModel("classifier"), [
+            { role: "system", content: ISSUE_QUESTION_PROMPT },
+            { role: "user", content: `TITLE: ${title}\n\nBODY: ${body}` },
+        ], { maxTokens: 16 });
+        return /\bQUESTION\b/i.test(output);
+    }
+    catch (err) {
+        console.error(`[classifier] Error classifying issue: ${err.message}`);
+        return false;
+    }
+}
 /**
  * Classify a GitHub/Slack comment's intent and extract a repo reference.
  * Falls back to intent=action on any error (safe default).
  */
-export async function classifyComment(commentBody, model) {
+export async function classifyComment(commentBody, context, options = {}) {
     try {
-        const { query } = await import("@anthropic-ai/claude-agent-sdk");
-        let output = "";
-        for await (const msg of query({
-            prompt: `Classify this comment:\n\n${commentBody}`,
-            options: {
-                model: model || "claude-haiku-4-5-20251001",
-                systemPrompt: CLASSIFIER_PROMPT,
-                permissionMode: "bypassPermissions",
-                maxTurns: 1,
-                allowedTools: [],
-                settingSources: [],
-            },
-        })) {
-            const m = msg;
-            if (m.type === "result") {
-                output = m.result || "";
-            }
-        }
+        const userPrompt = context?.issueTitle
+            ? `Classify this comment (replying on an existing ${context.isPullRequest ? "PR" : "issue"}):\n\nISSUE TITLE: ${context.issueTitle}\n\nCOMMENT: ${commentBody}`
+            : `Classify this comment:\n\n${commentBody}`;
+        const resolvedOptions = typeof options === "string" ? { model: options } : options;
+        const chat = resolvedOptions.chat ?? realChat;
+        const defaultFastModel = resolvedOptions.defaultFastModel ?? realDefaultFastModel;
+        const output = await chat(resolvedOptions.model ?? defaultFastModel("classifier"), [
+            { role: "system", content: CLASSIFIER_PROMPT },
+            { role: "user", content: userPrompt },
+        ], { maxTokens: 128 });
         const upper = output.trim().toUpperCase();
         const intentMap = {
             BUILD: "build",
             EXPLORE: "explore",
+            QUESTION: "question",
             TRIAGE: "triage",
             REVIEW: "review",
+            SECURITY: "security",
+            VERIFY: "verify",
+            QATEST: "qa-test",
+            DEMO: "demo",
             APPROVE: "approve",
             REJECT: "reject",
             STATUS: "status",
@@ -76,12 +205,22 @@ export async function classifyComment(commentBody, model) {
         const intent = intentMatch
             ? (intentMap[intentMatch[1]] ?? "chat")
             : "chat";
-        // Extract repo from "REPO: owner/name" line
+        // Extract repo from "REPO: owner/name" line. If the classifier didn't
+        // emit one (e.g. the user pasted a full github.com URL and the model
+        // left REPO as NONE), recover it from the raw message.
         const repoMatch = output.match(/REPO:\s*([\w-]+\/[\w.-]+)/i);
-        const repo = repoMatch?.[1];
-        // Extract issue number
         const issueMatch = output.match(/ISSUE:\s*(\d+)/i);
-        const issueNumber = issueMatch ? parseInt(issueMatch[1], 10) : undefined;
+        let repo = repoMatch?.[1];
+        let issueNumber = issueMatch ? parseInt(issueMatch[1], 10) : undefined;
+        if (!repo) {
+            const fallback = extractGithubRefFromText(commentBody);
+            if (fallback) {
+                repo = fallback.repo;
+                if (issueNumber === undefined && fallback.issueNumber !== undefined) {
+                    issueNumber = fallback.issueNumber;
+                }
+            }
+        }
         // Extract reject reason
         const reasonMatch = output.match(/REASON:\s*(.+)/i);
         const reason = reasonMatch && reasonMatch[1].trim().toUpperCase() !== "NONE"

package/dist/engine/classifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../src/engine/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EA6BgD,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,KAAc;IAEd,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;QAEjE,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,CAAC;YAC5B,MAAM,EAAE,6BAA6B,WAAW,EAAE;YAClD,OAAO,EAAE;gBACP,KAAK,EAAE,KAAK,IAAI,2BAA2B;gBAC3C,YAAY,EAAE,iBAAiB;gBAC/B,cAAc,EAAE,mBAA4B;gBAC5C,QAAQ,EAAE,CAAC;gBACX,YAAY,EAAE,EAAE;gBAChB,cAAc,EAAE,EAAE;aACnB;SACF,CAAC,EAAE,CAAC;YACH,MAAM,CAAC,GAAG,GAAU,CAAC;YACrB,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE1C,MAAM,SAAS,GAAkC;YAC/C,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,MAAM;SACb,CAAC;QAEF,oBAAoB;QACpB,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACnD,MAAM,MAAM,GAAkB,WAAW;YACvC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;YACvC,CAAC,CAAC,MAAM,CAAC;QAEX,4CAA4C;QAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QAE5B,uBAAuB;QACvB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEzE,wBAAwB;QACxB,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,WAAW,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM;YAC1E,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YACvB,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,2CAA2C,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACxE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC"}
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../src/engine/classifier.ts"],"names":[],"mappings":"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"}

package/dist/engine/classifier.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/engine/classifier.test.js

@@ -0,0 +1,115 @@
+import { describe, it, expect, vi } from "vitest";
+import { classifyComment, classifyIssueIsQuestion, extractGithubRefFromText } from "./classifier.js";
+describe("extractGithubRefFromText", () => {
+    it("returns undefined when no github.com URL is present", () => {
+        expect(extractGithubRefFromText("hi there")).toBeUndefined();
+        expect(extractGithubRefFromText("check cliftonc/lastlight")).toBeUndefined();
+    });
+    it("extracts owner/repo from a bare github.com URL", () => {
+        expect(extractGithubRefFromText("https://github.com/cliftonc/lastlight")).toEqual({
+            repo: "cliftonc/lastlight",
+        });
+    });
+    it("extracts from a URL embedded in surrounding text", () => {
+        const input = "can you do a security review of https://github.com/cliftonc/lastlight";
+        expect(extractGithubRefFromText(input)).toEqual({ repo: "cliftonc/lastlight" });
+    });
+    it("strips a trailing slash", () => {
+        expect(extractGithubRefFromText("https://github.com/cliftonc/lastlight/")).toEqual({
+            repo: "cliftonc/lastlight",
+        });
+    });
+    it("strips a trailing punctuation (question mark, comma, period)", () => {
+        expect(extractGithubRefFromText("triage https://github.com/foo/bar?")).toEqual({
+            repo: "foo/bar",
+        });
+        expect(extractGithubRefFromText("review https://github.com/foo/bar, please")).toEqual({
+            repo: "foo/bar",
+        });
+        expect(extractGithubRefFromText("scan https://github.com/foo/bar.")).toEqual({
+            repo: "foo/bar",
+        });
+    });
+    it("strips a .git suffix", () => {
+        expect(extractGithubRefFromText("https://github.com/foo/bar.git")).toEqual({
+            repo: "foo/bar",
+        });
+    });
+    it("extracts an issue number from /issues/N URLs", () => {
+        expect(extractGithubRefFromText("please look at https://github.com/cliftonc/lastlight/issues/42")).toEqual({ repo: "cliftonc/lastlight", issueNumber: 42 });
+    });
+    it("extracts a PR number from /pull/N URLs", () => {
+        expect(extractGithubRefFromText("review https://github.com/foo/bar/pull/7 when you can")).toEqual({ repo: "foo/bar", issueNumber: 7 });
+    });
+    it("ignores trailing URL path segments beyond owner/repo when no issue/PR", () => {
+        expect(extractGithubRefFromText("https://github.com/foo/bar/tree/main/src")).toEqual({
+            repo: "foo/bar",
+        });
+    });
+    it("handles http:// in addition to https://", () => {
+        expect(extractGithubRefFromText("http://github.com/foo/bar")).toEqual({
+            repo: "foo/bar",
+        });
+    });
+    it("handles repo names with dots and hyphens", () => {
+        expect(extractGithubRefFromText("https://github.com/cliftonc/drizzle-cube")).toEqual({
+            repo: "cliftonc/drizzle-cube",
+        });
+        expect(extractGithubRefFromText("https://github.com/user/foo.bar")).toEqual({
+            repo: "user/foo.bar",
+        });
+    });
+});
+describe("classifyComment — injected chat", () => {
+    it("parses build intent responses", async () => {
+        const chat = vi.fn().mockResolvedValue("INTENT: BUILD\nREPO: cliftonc/lastlight\nISSUE: 96\nREASON: NONE");
+        const r = await classifyComment("@last-light can you build this?", { issueTitle: "Introduce one provider-agnostic chat() seam" }, { chat, defaultFastModel: () => "openai/test" });
+        expect(r).toMatchObject({ intent: "build", repo: "cliftonc/lastlight", issueNumber: 96 });
+        expect(chat).toHaveBeenCalledOnce();
+        expect(chat).toHaveBeenCalledWith("openai/test", expect.arrayContaining([
+            expect.objectContaining({ role: "system" }),
+            expect.objectContaining({ role: "user", content: expect.stringContaining("@last-light can you build this?") }),
+        ]), { maxTokens: 128 });
+    });
+    it("falls back to a GitHub URL when model output omits repo and issue", async () => {
+        const chat = vi.fn().mockResolvedValue("INTENT: SECURITY\nREPO: NONE\nISSUE: NONE\nREASON: NONE");
+        const r = await classifyComment("security review https://github.com/foo/bar/pull/7 please", {}, { chat, defaultFastModel: () => "openai/test" });
+        expect(r).toMatchObject({ intent: "security", repo: "foo/bar", issueNumber: 7 });
+    });
+    it("falls back to chat intent when chat rejects", async () => {
+        const chat = vi.fn().mockRejectedValue(new Error("network"));
+        const errorSpy = vi.spyOn(console, "error").mockImplementation(() => undefined);
+        const r = await classifyComment("@last-light can you build this?", {}, { chat, defaultFastModel: () => "openai/test" });
+        expect(r).toEqual({ intent: "chat" });
+        expect(errorSpy).toHaveBeenCalled();
+        errorSpy.mockRestore();
+    });
+});
+describe("classifyIssueIsQuestion — injected chat", () => {
+    it("returns true for a question issue", async () => {
+        const chat = vi.fn().mockResolvedValue("QUESTION");
+        const r = await classifyIssueIsQuestion("How is lastlight different to Vercel Eve?", "Keen on a comparison.", { chat, defaultFastModel: () => "openai/test" });
+        expect(r).toBe(true);
+        expect(chat).toHaveBeenCalledWith("openai/test", expect.arrayContaining([
+            expect.objectContaining({ role: "system" }),
+            expect.objectContaining({ role: "user", content: expect.stringContaining("How is lastlight different") }),
+        ]), { maxTokens: 16 });
+    });
+    it("returns false for a work item", async () => {
+        const chat = vi.fn().mockResolvedValue("WORK");
+        const r = await classifyIssueIsQuestion("Crash on startup", "App throws on boot.", {
+            chat,
+            defaultFastModel: () => "openai/test",
+        });
+        expect(r).toBe(false);
+    });
+    it("defaults to false (work → triage) when chat rejects", async () => {
+        const chat = vi.fn().mockRejectedValue(new Error("network"));
+        const errorSpy = vi.spyOn(console, "error").mockImplementation(() => undefined);
+        const r = await classifyIssueIsQuestion("Anything", "body", { chat, defaultFastModel: () => "openai/test" });
+        expect(r).toBe(false);
+        expect(errorSpy).toHaveBeenCalled();
+        errorSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=classifier.test.js.map

package/dist/engine/classifier.test.js.map

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

package/dist/engine/dispatcher.d.ts

@@ -0,0 +1,60 @@
+import type { EventEnvelope } from "../connectors/types.js";
+import type { SessionManager } from "../connectors/index.js";
+import type { StateDb } from "../state/db.js";
+import type { GitHubClient } from "./github.js";
+import type { ChatResult } from "./chat.js";
+import { type Route, type RouterDeps } from "./router.js";
+/**
+ * Hand a workflow to the runner. Matches `dispatchWorkflow` in index.ts — the
+ * dispatcher names workflows and accumulates their outcome but owns none of the
+ * sandbox/runner plumbing.
+ */
+export type DispatchWorkflowFn = (workflowName: string, context: Record<string, unknown>, onRunStart?: (runId: string) => Promise<void>) => Promise<{
+    success: boolean;
+    error?: string;
+    paused?: boolean;
+}>;
+/** Run one in-process chat turn. Injected so the chat branch is testable. */
+export type RunChatFn = (message: string, messagingSessionId: string, sender: string, resumeAgentSessionId: string | undefined) => Promise<ChatResult>;
+/**
+ * Everything the dispatcher needs, bundled so `main()` constructs it once and
+ * hands it over. `route` defaults to `routeEvent` but is injectable so a
+ * branch test names the exact Route it wants without mocking the classifier.
+ */
+export interface DispatchDeps {
+    db: StateDb;
+    github: GitHubClient | null;
+    dispatchWorkflow: DispatchWorkflowFn;
+    sessionManager: SessionManager;
+    runChat: RunChatFn;
+    route?: (envelope: EventEnvelope, deps: RouterDeps) => Promise<Route>;
+    reviewPostsCheck: boolean;
+    publicUrl?: string;
+}
+/**
+ * The typed result of dispatching one event. Handlers return an outcome rather
+ * than only producing side effects, so each branch is assertable through the
+ * single `dispatch` seam.
+ */
+export type DispatchOutcome = {
+    kind: "ignored";
+    reason: string;
+} | {
+    kind: "replied";
+    message: string;
+} | {
+    kind: "skipped";
+    reason: string;
+} | {
+    kind: "handled";
+    handler: string;
+} | {
+    kind: "dispatched";
+    workflow: string;
+};
+/**
+ * Turn an EventEnvelope into a workflow dispatch (or an in-process handler
+ * run). Classifies via `route`, then acts on the decision. Extracted from the
+ * former `registry.onEvent` closure so every event branch is testable.
+ */
+export declare function dispatch(envelope: EventEnvelope, deps: DispatchDeps): Promise<DispatchOutcome>;