codiedev 0.8.0 → 0.8.2

package/dist/cli.js

@@ -69,7 +69,6 @@ Artifacts:
                                          "single repo or multiple? where?", then
                                          emits a plan with N+1 split. Lands in
                                          /portal/research/<id>; push to Jira from there.
-                                         Beta — opt-in via betaCreateTicket.
   codiedev create-ticket --submit <path|->
                                          Internal: Claude calls this itself with
                                          a plan JSON to submit. Use - for stdin.
@@ -266,8 +265,6 @@ codiedev create-ticket — forward-write a scoped ticket plan
   Single ticket renders as one ticket; multi-ticket renders as a folder/group.
   Push to Jira from the portal.
 
-  Beta. Opt-in by setting userProfiles.betaCreateTicket = true on your row.
-
   Examples:
     codiedev create-ticket
     codiedev create-ticket "I want to add Google SSO"

package/dist/commands/createTicket.js

@@ -155,13 +155,7 @@ async function runBare(config, prompt) {
         res = await (0, shared_1.apiRequest)("GET", "/api/cli/createTicketProtocol", { config });
     }
     catch (err) {
-        const status = err.status;
-        if (status === 403) {
-            console.error("create-ticket is in beta and not enabled for your account. Ask your CodieDev admin to flip betaCreateTicket on your profile.");
-        }
-        else {
-            console.error(`Failed to fetch create-ticket protocol: ${err.message}. Check your network connection and re-run.`);
-        }
+        console.error(`Failed to fetch create-ticket protocol: ${err.message}. Check your network connection and re-run.`);
         process.exit(1);
     }
     process.stdout.write(substitutePrompt(res.protocol, prompt));

package/dist/commands/shared.d.ts

@@ -33,6 +33,20 @@ export declare function recordAgentEvent(config: CodiedevConfig, event: {
     latencyMs: number;
     error?: string;
 }): void;
+/**
+ * Per-step install telemetry for `npx codiedev connect`. One row per phase
+ * (started, detect, install_target, validate_token, completed, failed) so
+ * the admin company page can show a timeline when a customer says "it says
+ * connected but it doesn't work." Fire-and-forget, never throws. Auto-stamps
+ * platform + node + cli version so call sites only need step/target/ok/error.
+ */
+export type InstallTelemetryStep = "started" | "detect" | "install_target" | "validate_token" | "completed" | "failed";
+export declare function recordInstallEvent(config: CodiedevConfig, event: {
+    step: InstallTelemetryStep;
+    target?: string;
+    ok: boolean;
+    error?: string;
+}): void;
 /**
  * Wraps a CLI subcommand body so success and failure both record telemetry
  * and the original error propagates after the event is queued. Use this in

package/dist/commands/shared.js

@@ -37,6 +37,7 @@ exports.applyConfigEnvOverrides = applyConfigEnvOverrides;
 exports.requireConfig = requireConfig;
 exports.apiRequest = apiRequest;
 exports.recordAgentEvent = recordAgentEvent;
+exports.recordInstallEvent = recordInstallEvent;
 exports.withTelemetry = withTelemetry;
 exports.timeAgo = timeAgo;
 exports.stripQuotes = stripQuotes;
@@ -155,6 +156,22 @@ function recordAgentEvent(config, event) {
         // Swallow — telemetry must never affect user-facing flow.
     });
 }
+function recordInstallEvent(config, event) {
+    apiRequest("POST", "/api/telemetry/install-event", {
+        config,
+        body: {
+            step: event.step,
+            target: event.target,
+            ok: event.ok,
+            error: event.error,
+            platform: process.platform,
+            nodeVersion: process.version,
+            cliVersion: version_1.CLI_VERSION,
+        },
+    }).catch(() => {
+        // Swallow — telemetry must never affect connect flow.
+    });
+}
 /**
  * Wraps a CLI subcommand body so success and failure both record telemetry
  * and the original error propagates after the event is queued. Use this in

package/dist/connect.js

@@ -41,6 +41,7 @@ const utils_1 = require("./utils");
 const connectFlow_1 = require("./connectFlow");
 const version_1 = require("./version");
 const upgradeNudge_1 = require("./upgradeNudge");
+const shared_1 = require("./commands/shared");
 const BACKEND_URL = process.env.CODIEDEV_URL || "https://judicious-falcon-861.convex.site";
 /**
  * Reads a line from stdin without echoing the typed/pasted characters —
@@ -214,6 +215,11 @@ async function runConnect(args = []) {
         console.error(`\nError: Failed to save config — ${err.message}`);
         process.exit(1);
     }
+    // Once we have a valid token + config, every subsequent step posts a
+    // per-step row to /api/telemetry/install-event so the admin page can show
+    // a timeline when a customer says "it connected but it doesn't work."
+    // Fire-and-forget — never blocks the connect flow.
+    (0, shared_1.recordInstallEvent)(config, { step: "started", ok: true });
     // Migration: strip MCP server entries written by pre-CLI-only versions
     // of `codiedev connect`. These pointed at `npx codiedev-mcp`, a binary
     // that was removed in 0.3.4 and that 0.7.11+ no longer ships. Without
@@ -242,64 +248,46 @@ async function runConnect(args = []) {
     const hasClaude = (0, utils_1.claudeCodeInstalled)();
     const hasCodex = (0, utils_1.codexInstalled)();
     const hasCursor = (0, utils_1.cursorInstalled)();
+    (0, shared_1.recordInstallEvent)(config, { step: "detect", target: "claude-code", ok: hasClaude });
+    (0, shared_1.recordInstallEvent)(config, { step: "detect", target: "codex", ok: hasCodex });
+    (0, shared_1.recordInstallEvent)(config, { step: "detect", target: "cursor", ok: hasCursor });
     const installed = [];
     // Machine-readable target keys reported back to the backend via
     // /api/cli/markInstalled so the portal's "Connected" state reflects
     // what's actually wired up on this machine, not just "token validated."
     const installedTargets = [];
-    if (hasClaude) {
+    // Wrap each per-target write so we emit one install_target row each. The
+    // existing user-visible behavior (console.warn on failure, continue) is
+    // unchanged — telemetry just observes the outcome.
+    const runInstall = (target, fn, label, targetKey) => {
         try {
-            (0, utils_1.installHook)();
-            installed.push("Claude Code SessionEnd hook (~/.claude/settings.json)");
-            installedTargets.push("claudeCode-hook");
-        }
-        catch (err) {
-            console.error(`\nWarning: Failed to install Claude Code hook — ${err.message}`);
-        }
-        try {
-            (0, utils_1.installClaudeCodeInstructions)();
-            installed.push("Claude Code agent instructions (~/.claude/CLAUDE.md)");
-            installedTargets.push("claudeCode-instructions");
+            fn();
+            installed.push(label);
+            installedTargets.push(targetKey);
+            (0, shared_1.recordInstallEvent)(config, { step: "install_target", target, ok: true });
         }
         catch (err) {
-            console.error(`\nWarning: Failed to install Claude Code instructions — ${err.message}`);
+            const message = err.message;
+            console.error(`\nWarning: Failed to install ${label} — ${message}`);
+            (0, shared_1.recordInstallEvent)(config, {
+                step: "install_target",
+                target,
+                ok: false,
+                error: message?.slice(0, 500),
+            });
         }
+    };
+    if (hasClaude) {
+        runInstall("claude-code-hook", utils_1.installHook, "Claude Code SessionEnd hook (~/.claude/settings.json)", "claudeCode-hook");
+        runInstall("claude-code-instructions", utils_1.installClaudeCodeInstructions, "Claude Code agent instructions (~/.claude/CLAUDE.md)", "claudeCode-instructions");
     }
     if (hasCodex) {
-        try {
-            (0, utils_1.installCodexHook)();
-            installed.push("Codex Stop hook (~/.codex/hooks.json)");
-            installedTargets.push("codex-hook");
-        }
-        catch (err) {
-            console.error(`\nWarning: Failed to install Codex hook — ${err.message}`);
-        }
-        try {
-            (0, utils_1.installCodexInstructions)();
-            installed.push("Codex agent instructions (~/.codex/AGENTS.md)");
-            installedTargets.push("codex-instructions");
-        }
-        catch (err) {
-            console.error(`\nWarning: Failed to install Codex instructions — ${err.message}`);
-        }
+        runInstall("codex-hook", utils_1.installCodexHook, "Codex Stop hook (~/.codex/hooks.json)", "codex-hook");
+        runInstall("codex-instructions", utils_1.installCodexInstructions, "Codex agent instructions (~/.codex/AGENTS.md)", "codex-instructions");
     }
     if (hasCursor) {
-        try {
-            (0, utils_1.installCursorHook)();
-            installed.push("Cursor sessionEnd hook (~/.cursor/hooks.json)");
-            installedTargets.push("cursor-hook");
-        }
-        catch (err) {
-            console.error(`\nWarning: Failed to install Cursor hook — ${err.message}`);
-        }
-        try {
-            (0, utils_1.installCursorInstructions)();
-            installed.push("Cursor agent instructions (~/.cursor/rules/codiedev.mdc)");
-            installedTargets.push("cursor-instructions");
-        }
-        catch (err) {
-            console.error(`\nWarning: Failed to install Cursor instructions — ${err.message}`);
-        }
+        runInstall("cursor-hook", utils_1.installCursorHook, "Cursor sessionEnd hook (~/.cursor/hooks.json)", "cursor-hook");
+        runInstall("cursor-instructions", utils_1.installCursorInstructions, "Cursor agent instructions (~/.cursor/rules/codiedev.mdc)", "cursor-instructions");
     }
     // Tell the backend which targets we wired up so the portal's onboarding
     // card flips to "Connected" only when something actually installed —
@@ -310,10 +298,17 @@ async function runConnect(args = []) {
             await postJson(`${BACKEND_URL}/api/cli/markInstalled`, {
                 installedTargets,
             }, { Authorization: `Bearer ${token}` });
+            (0, shared_1.recordInstallEvent)(config, { step: "completed", ok: true });
         }
         catch (err) {
-            console.error(`\nWarning: Failed to report install to backend — ${err.message}`);
+            const message = err.message;
+            console.error(`\nWarning: Failed to report install to backend — ${message}`);
             console.error("Local install succeeded; portal may not reflect it until you re-run.");
+            (0, shared_1.recordInstallEvent)(config, {
+                step: "failed",
+                ok: false,
+                error: message?.slice(0, 500),
+            });
         }
     }
     if (!hasClaude && !hasCodex && !hasCursor) {

package/dist/hookTransport.d.ts

@@ -0,0 +1,13 @@
+import * as http from "http";
+export declare const DEFAULT_HOOK_HTTP_TIMEOUT_MS = 8000;
+/** Hard cap for GET requests used in sync-context (e.g. auto-pull skill list).
+ *  If the backend accepts the connection but never writes a response the hook
+ *  would stall every Claude Code session start — we cap it well below any
+ *  reasonable UX threshold. */
+export declare const GET_JSON_TIMEOUT_MS = 5000;
+export declare function getHookHttpTimeoutMs(): number;
+type RequestImpl = typeof http.request;
+export declare function getJson<T>(url: string, bearerToken: string): Promise<T>;
+export declare function postJson(url: string, body: Record<string, unknown>, bearerToken: string, requestImpl?: RequestImpl): Promise<void>;
+export declare function postJsonWithHookTimeout(url: string, body: Record<string, unknown>, bearerToken: string, requestImpl?: RequestImpl): Promise<void>;
+export {};

package/dist/hookTransport.js

@@ -0,0 +1,136 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_JSON_TIMEOUT_MS = exports.DEFAULT_HOOK_HTTP_TIMEOUT_MS = void 0;
+exports.getHookHttpTimeoutMs = getHookHttpTimeoutMs;
+exports.getJson = getJson;
+exports.postJson = postJson;
+exports.postJsonWithHookTimeout = postJsonWithHookTimeout;
+const http = __importStar(require("http"));
+const https = __importStar(require("https"));
+const version_1 = require("./version");
+exports.DEFAULT_HOOK_HTTP_TIMEOUT_MS = 8_000;
+/** Hard cap for GET requests used in sync-context (e.g. auto-pull skill list).
+ *  If the backend accepts the connection but never writes a response the hook
+ *  would stall every Claude Code session start — we cap it well below any
+ *  reasonable UX threshold. */
+exports.GET_JSON_TIMEOUT_MS = 5_000;
+function getHookHttpTimeoutMs() {
+    const raw = process.env.CODIEDEV_HOOK_HTTP_TIMEOUT_MS;
+    if (!raw)
+        return exports.DEFAULT_HOOK_HTTP_TIMEOUT_MS;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        return exports.DEFAULT_HOOK_HTTP_TIMEOUT_MS;
+    }
+    return parsed;
+}
+function requestJson(method, url, bearerToken, body, requestImpl, useTimeout = false, 
+/** When set, overrides getHookHttpTimeoutMs() for this request. */
+explicitTimeoutMs) {
+    return new Promise((resolve, reject) => {
+        const parsed = new URL(url);
+        const data = body === undefined ? undefined : JSON.stringify(body);
+        const headers = {
+            Authorization: `Bearer ${bearerToken}`,
+            "X-Codiedev-Cli-Version": version_1.CLI_VERSION,
+        };
+        if (data !== undefined) {
+            headers["Content-Type"] = "application/json";
+            headers["Content-Length"] = Buffer.byteLength(data);
+        }
+        const options = {
+            hostname: parsed.hostname,
+            port: parsed.port || (parsed.protocol === "https:" ? 443 : 80),
+            path: parsed.pathname + parsed.search,
+            method,
+            headers,
+        };
+        const lib = parsed.protocol === "https:" ? https : http;
+        const request = requestImpl ?? lib.request;
+        let settled = false;
+        const timeoutMs = explicitTimeoutMs ?? getHookHttpTimeoutMs();
+        let timer;
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            fn();
+        };
+        const req = request(options, (res) => {
+            let responseData = "";
+            res.on("data", (chunk) => {
+                responseData += chunk;
+            });
+            res.on("end", () => {
+                if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                    try {
+                        const parsedBody = responseData.length === 0 ? undefined : JSON.parse(responseData);
+                        finish(() => resolve(parsedBody));
+                    }
+                    catch (e) {
+                        finish(() => reject(e));
+                    }
+                }
+                else {
+                    finish(() => reject(new Error(`HTTP ${res.statusCode}: ${responseData}`)));
+                }
+            });
+        });
+        if (useTimeout) {
+            timer = setTimeout(() => {
+                req.destroy(new Error(`request timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+        }
+        req.on("error", (err) => finish(() => reject(err)));
+        if (data !== undefined) {
+            req.write(data);
+        }
+        req.end();
+    });
+}
+function getJson(url, bearerToken) {
+    // Always apply a 5-second cap so a hanging backend cannot stall a
+    // SessionStart hook (which would freeze every Claude Code session start).
+    return requestJson("GET", url, bearerToken, undefined, undefined, true, exports.GET_JSON_TIMEOUT_MS);
+}
+function postJson(url, body, bearerToken, requestImpl) {
+    return requestJson("POST", url, bearerToken, body, requestImpl);
+}
+function postJsonWithHookTimeout(url, body, bearerToken, requestImpl) {
+    return requestJson("POST", url, bearerToken, body, requestImpl, true);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codiedev",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Connect Claude Code, Codex, Cursor, or VS Code Copilot to CodieDev for org-wide session capture and artifact collaboration",
   "bin": {
     "codiedev": "dist/cli.js",

package/dist/createTicketSkill.d.ts

@@ -1,12 +0,0 @@
-/**
- * Skill instructions printed to stdout when `codiedev create-ticket` is
- * invoked without `--submit`. Claude (running the CLI via Bash) reads
- * this content and follows the protocol: ask the dev about repos,
- * investigate locally, emit a plan, call back into the CLI to submit.
- *
- * The scoping rules (#### TICKET QUALITY BAR onwards) are lifted verbatim
- * from `modal/runner.py:_format_ticket_from_analysis` so the CLI path
- * produces structurally-identical plans to the Modal path.
- */
-export declare const CREATE_TICKET_SKILL_INSTRUCTIONS = "\nYou are conducting a forward ticket-writing session for the user via codiedev.\nFollow this protocol exactly. Do not improvise the ticket structure.\n\n## Step 1 \u2014 Ask about repos\nAsk the user once:\n  \"Is this work in a single repo or across multiple? If multiple, please tell me where each one is located on disk.\"\nWait for their reply. They will give you absolute paths like /Users/x/code/foo.\n\n## Step 2 \u2014 Investigate (read-only)\nFor each repo path the user gave you:\n  - cd into the repo\n  - Read the user's intent (their prompt, given below)\n  - Find the primary files related to that intent. Use grep for class names,\n    function names, enum values, constants, file names extracted from the prompt.\n  - For each file found, report what it contains: function signatures, enum\n    values, switch/case statements, existing patterns.\n  - Grep for who imports each file (consumers, dependencies).\n  - Check for existing tests related to those files.\n  - Note migration patterns, naming conventions, barrel exports.\nDO NOT modify any files. This is read-only.\n\n## Step 2.5 \u2014 Ask if the prompt doesn't match the codebase\n\nBefore writing the plan, check: do the user's literal words appear in the codebase as named?\n\n- If they said \"delete X\" but only \"archive X\" / \"setArchived\" exists, ask one question quoting\n  both sides: \"You said `delete`, but I see only `setArchived` \u2014 confirm the modal is for the\n  archive button?\"\n- If they said \"the analytics dashboard\" but the named component (e.g. AnalyticsTab) is already\n  reactive and the only useEffect-fetch lives elsewhere, ask: \"AnalyticsTab is already on\n  useQuery; the only useEffect-fetch I found is in admin/page.tsx LangfuseCostsSection \u2014 is\n  that the target?\"\n- If they named a feature/flag/component that doesn't exist at all, ask which of the closest\n  matches they meant, listing each with a one-line reason it's plausible.\n\nDo NOT silently route to the closest match in these cases. Silently routing buries the mismatch\nin scope OUT and produces a ticket the user didn't ask for. One targeted question that quotes\nthe user's word AND the codebase's actual word is the right move.\n\nIf you also have a separate genuine ambiguity (two plausible places the change could go that\nboth match the user's words), bundle it into the same question \u2014 but don't fabricate ambiguity\nto hit a quota. If the words map to the codebase clearly, do not ask further questions \u2014\nproceed to Step 3.\n\n## Step 3 \u2014 Format the plan\n\nThe user's request defines WHAT to build. The investigation defines HOW to build it.\nYour job is to translate the user's exact request into actionable tickets using\nthe investigation as supporting evidence. The user chose their words carefully \u2014\nuse them.\n\nOutput a plan as one or more tickets. Each ticket becomes a single PR handled\nby a coding agent. The agent works alone and makes one PR per ticket.\n\nEACH TICKET = ONE MERGEABLE PR\nA ticket is ready when its PR can merge to main and the app compiles, renders,\nand passes tests with zero other tickets merged. This is the only rule that matters.\n\nHow to group work:\n- The investigation identified every file that needs to change. Your job is to\n  package that into tickets, not to re-scope. Every file from the investigation\n  appears in at least one ticket.\n- Each ticket becomes one PR. A PR should be focused enough that a reviewer\n  understands it in one sitting and CI validates it fully.\n- Include every file needed for the change to be complete \u2014 don't leave wiring,\n  migrations, or consumer updates for a follow-up.\n- If the work naturally spans independent modules, output multiple tickets ordered\n  by dependency. Use the `dependsOn` field (array of zero-indexed ticket numbers\n  this ticket depends on).\n- \"After this PR merges, the app:\" must describe a working state. If you can't,\n  the ticket is incomplete \u2014 add what's missing.\n- Default to ONE ticket. Only split when ticket 2 could merge to main without\n  ticket 1 and the app still compiles.\n\nQUALITY BAR \u2014 every ticket must:\n- Quantify the problem: count the calls, files, violations. \"6 manager.getRepository()\n  calls\", not \"several calls\".\n- Name the codebase's own patterns: use the exact class names, method names, and\n  conventions found in the investigation. \"injectable wrapper pattern with\n  @InjectRepository\", not \"create a new class\".\n- Include specific file paths with line numbers from the investigation findings.\n- Say what stays the same: \"Keep standard CRUD in AceService\", \"do not export it\",\n  \"no logic changes\".\n- Scope IN/OUT must reference concrete things in the codebase, not abstract categories.\n\nFor each ticket, fill these fields:\n  - title: <80 chars, imperative mood\n  - description: GIVEN/WHEN/THEN format, quantify the problem\n  - technicalDetails: specific files with line numbers, the approach,\n    patterns from the codebase to follow, what to keep unchanged\n  - scope: IN: ... / OUT: ...\n  - targetRepoId: leave empty for now \u2014 the CLI will fill this from the repo paths\n  - targetRepoFullName: \"owner/name\" matching the git remote of the repo this\n    ticket touches (e.g. \"ericlam1114/vm-demo\")\n  - dependsOn: [zero-indexed ticket numbers] or [] if independent\n\n## Step 4 \u2014 Submit\nWhen the plan is ready, write it to a temp file as JSON matching this schema:\n\n{\n  \"plan\": {\n    \"summary\": \"<one sentence: what this plan delivers and how many tickets>\",\n    \"tickets\": [\n      {\n        \"title\": \"...\",\n        \"description\": \"...\",\n        \"technicalDetails\": \"...\",\n        \"scope\": \"...\",\n        \"targetRepoFullName\": \"owner/name\",\n        \"dependsOn\": []\n      }\n    ]\n  },\n  \"prompt\": \"<the user's original intent verbatim>\",\n  \"repoFullNames\": [\"owner/name\", ...]\n}\n\nThen run:\n  codiedev create-ticket --submit <path-to-temp-file.json>\n\nThe CLI will translate `targetRepoFullName` and `repoFullNames` into repo IDs,\nPOST the plan, and print the portal URL. Tell the user the URL when it returns.\n\n## The user's intent\n{{USER_PROMPT}}\n";
-export declare function renderSkillInstructions(prompt: string | undefined): string;

package/dist/createTicketSkill.js

@@ -1,146 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CREATE_TICKET_SKILL_INSTRUCTIONS = void 0;
-exports.renderSkillInstructions = renderSkillInstructions;
-/**
- * Skill instructions printed to stdout when `codiedev create-ticket` is
- * invoked without `--submit`. Claude (running the CLI via Bash) reads
- * this content and follows the protocol: ask the dev about repos,
- * investigate locally, emit a plan, call back into the CLI to submit.
- *
- * The scoping rules (#### TICKET QUALITY BAR onwards) are lifted verbatim
- * from `modal/runner.py:_format_ticket_from_analysis` so the CLI path
- * produces structurally-identical plans to the Modal path.
- */
-exports.CREATE_TICKET_SKILL_INSTRUCTIONS = `
-You are conducting a forward ticket-writing session for the user via codiedev.
-Follow this protocol exactly. Do not improvise the ticket structure.
-
-## Step 1 — Ask about repos
-Ask the user once:
-  "Is this work in a single repo or across multiple? If multiple, please tell me where each one is located on disk."
-Wait for their reply. They will give you absolute paths like /Users/x/code/foo.
-
-## Step 2 — Investigate (read-only)
-For each repo path the user gave you:
-  - cd into the repo
-  - Read the user's intent (their prompt, given below)
-  - Find the primary files related to that intent. Use grep for class names,
-    function names, enum values, constants, file names extracted from the prompt.
-  - For each file found, report what it contains: function signatures, enum
-    values, switch/case statements, existing patterns.
-  - Grep for who imports each file (consumers, dependencies).
-  - Check for existing tests related to those files.
-  - Note migration patterns, naming conventions, barrel exports.
-DO NOT modify any files. This is read-only.
-
-## Step 2.5 — Ask if the prompt doesn't match the codebase
-
-Before writing the plan, check: do the user's literal words appear in the codebase as named?
-
-- If they said "delete X" but only "archive X" / "setArchived" exists, ask one question quoting
-  both sides: "You said \`delete\`, but I see only \`setArchived\` — confirm the modal is for the
-  archive button?"
-- If they said "the analytics dashboard" but the named component (e.g. AnalyticsTab) is already
-  reactive and the only useEffect-fetch lives elsewhere, ask: "AnalyticsTab is already on
-  useQuery; the only useEffect-fetch I found is in admin/page.tsx LangfuseCostsSection — is
-  that the target?"
-- If they named a feature/flag/component that doesn't exist at all, ask which of the closest
-  matches they meant, listing each with a one-line reason it's plausible.
-
-Do NOT silently route to the closest match in these cases. Silently routing buries the mismatch
-in scope OUT and produces a ticket the user didn't ask for. One targeted question that quotes
-the user's word AND the codebase's actual word is the right move.
-
-If you also have a separate genuine ambiguity (two plausible places the change could go that
-both match the user's words), bundle it into the same question — but don't fabricate ambiguity
-to hit a quota. If the words map to the codebase clearly, do not ask further questions —
-proceed to Step 3.
-
-## Step 3 — Format the plan
-
-The user's request defines WHAT to build. The investigation defines HOW to build it.
-Your job is to translate the user's exact request into actionable tickets using
-the investigation as supporting evidence. The user chose their words carefully —
-use them.
-
-Output a plan as one or more tickets. Each ticket becomes a single PR handled
-by a coding agent. The agent works alone and makes one PR per ticket.
-
-EACH TICKET = ONE MERGEABLE PR
-A ticket is ready when its PR can merge to main and the app compiles, renders,
-and passes tests with zero other tickets merged. This is the only rule that matters.
-
-How to group work:
-- The investigation identified every file that needs to change. Your job is to
-  package that into tickets, not to re-scope. Every file from the investigation
-  appears in at least one ticket.
-- Each ticket becomes one PR. A PR should be focused enough that a reviewer
-  understands it in one sitting and CI validates it fully.
-- Include every file needed for the change to be complete — don't leave wiring,
-  migrations, or consumer updates for a follow-up.
-- If the work naturally spans independent modules, output multiple tickets ordered
-  by dependency. Use the \`dependsOn\` field (array of zero-indexed ticket numbers
-  this ticket depends on).
-- "After this PR merges, the app:" must describe a working state. If you can't,
-  the ticket is incomplete — add what's missing.
-- Default to ONE ticket. Only split when ticket 2 could merge to main without
-  ticket 1 and the app still compiles.
-
-QUALITY BAR — every ticket must:
-- Quantify the problem: count the calls, files, violations. "6 manager.getRepository()
-  calls", not "several calls".
-- Name the codebase's own patterns: use the exact class names, method names, and
-  conventions found in the investigation. "injectable wrapper pattern with
-  @InjectRepository", not "create a new class".
-- Include specific file paths with line numbers from the investigation findings.
-- Say what stays the same: "Keep standard CRUD in AceService", "do not export it",
-  "no logic changes".
-- Scope IN/OUT must reference concrete things in the codebase, not abstract categories.
-
-For each ticket, fill these fields:
-  - title: <80 chars, imperative mood
-  - description: GIVEN/WHEN/THEN format, quantify the problem
-  - technicalDetails: specific files with line numbers, the approach,
-    patterns from the codebase to follow, what to keep unchanged
-  - scope: IN: ... / OUT: ...
-  - targetRepoId: leave empty for now — the CLI will fill this from the repo paths
-  - targetRepoFullName: "owner/name" matching the git remote of the repo this
-    ticket touches (e.g. "ericlam1114/vm-demo")
-  - dependsOn: [zero-indexed ticket numbers] or [] if independent
-
-## Step 4 — Submit
-When the plan is ready, write it to a temp file as JSON matching this schema:
-
-{
-  "plan": {
-    "summary": "<one sentence: what this plan delivers and how many tickets>",
-    "tickets": [
-      {
-        "title": "...",
-        "description": "...",
-        "technicalDetails": "...",
-        "scope": "...",
-        "targetRepoFullName": "owner/name",
-        "dependsOn": []
-      }
-    ]
-  },
-  "prompt": "<the user's original intent verbatim>",
-  "repoFullNames": ["owner/name", ...]
-}
-
-Then run:
-  codiedev create-ticket --submit <path-to-temp-file.json>
-
-The CLI will translate \`targetRepoFullName\` and \`repoFullNames\` into repo IDs,
-POST the plan, and print the portal URL. Tell the user the URL when it returns.
-
-## The user's intent
-{{USER_PROMPT}}
-`;
-function renderSkillInstructions(prompt) {
-    return exports.CREATE_TICKET_SKILL_INSTRUCTIONS.replace("{{USER_PROMPT}}", prompt && prompt.length > 0
-        ? prompt
-        : "(not yet provided — ask the user a single combined question that covers both the intent AND repo locations: \"What are you working on, and is this in a single repo or multiple? If multiple, give me the paths.\" Skip Step 1 since you've folded it into this question. Then proceed to Step 2.)");
-}