codiedev 0.7.11 → 0.8.0

package/dist/cli.js

@@ -25,6 +25,7 @@ const inbox_1 = require("./commands/inbox");
 const note_1 = require("./commands/note");
 const promote_1 = require("./commands/promote");
 const reverseTicket_1 = require("./commands/reverseTicket");
+const createTicket_1 = require("./commands/createTicket");
 const doctor_1 = require("./commands/doctor");
 const search_1 = require("./commands/search");
 const library_1 = require("./commands/library");
@@ -32,6 +33,7 @@ const post_1 = require("./commands/post");
 const share_1 = require("./commands/share");
 const send_1 = require("./commands/send");
 const react_1 = require("./commands/react");
+const version_1 = require("./version");
 const HELP = `
 CodieDev CLI
 
@@ -62,6 +64,15 @@ Artifacts:
                                          Draft lands in /portal/agentic-ticketing.
   codiedev reverse-ticket --base <ref>   Override the base ref in branch mode
                                          (defaults to origin/main).
+  codiedev create-ticket [<prompt>]      Forward-write a scoped ticket plan.
+                                         Claude investigates the codebase, asks
+                                         "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.
 
 Messaging:
   codiedev ping <user> "<msg>" [--with <key>]
@@ -240,6 +251,27 @@ codiedev promote — promote an auto-extracted artifact to authored
 
   Find artifact-ids in the portal under Knowledge → Memory, or via
   the portal search.
+`.trim(),
+    "create-ticket": `
+codiedev create-ticket — forward-write a scoped ticket plan
+
+  Default path:
+    codiedev create-ticket "I want to add SSO with Google"
+
+  Bare mode (no --submit) prints skill instructions for Claude to follow.
+  Claude asks where your repos live, investigates them locally, and emits a
+  plan as JSON. The CLI then re-invokes itself with --submit to upload it.
+
+  The plan lands at /portal/research/<id> as a ready-state research session.
+  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"
+    codiedev create-ticket --submit /tmp/plan.json   # internal, called by Claude
 `.trim(),
 };
 const DOCS = `
@@ -379,7 +411,7 @@ async function main() {
         }
     }
     if (command === "version" || command === "--version" || command === "-v") {
-        console.log("codiedev cli");
+        console.log(`codiedev v${version_1.CLI_VERSION}`);
         return;
     }
     try {
@@ -430,6 +462,10 @@ async function main() {
             case "reverseTicket":
                 await (0, reverseTicket_1.runReverseTicket)(rest);
                 return;
+            case "create-ticket":
+            case "createTicket":
+                await (0, createTicket_1.runCreateTicket)(rest);
+                return;
             case "search":
                 await (0, search_1.runSearch)(rest);
                 return;

package/dist/commands/createTicket.d.ts

@@ -0,0 +1,27 @@
+import type { CodiedevConfig } from "../utils";
+export declare function substitutePrompt(protocol: string, prompt: string | undefined): string;
+interface ConnectedRepo {
+    repoId: string;
+    fullName: string;
+}
+export declare function validatePlanHasRepo(parsedPlan: any): string | null;
+export declare function resolveRepoIds(fullNames: string[], repos: ConnectedRepo[]): string[];
+export interface CreateTicketArgs {
+    mode: "bare" | "submit";
+    prompt?: string;
+    submitSource?: "stdin" | string;
+}
+export declare function parseCreateTicketArgs(args: string[]): CreateTicketArgs;
+export declare function runCreateTicket(args: string[]): Promise<void>;
+/**
+ * Bare-mode entrypoint. Fetches the protocol body from the backend so we can
+ * iterate on it without shipping a new CLI, substitutes the user's prompt,
+ * and writes the result to stdout for the agent to follow. Hard-errors on
+ * fetch failure rather than falling back to a stale local copy — the whole
+ * point of moving the protocol server-side is that the freshest version is
+ * the only version.
+ */
+export declare function runBare(config: CodiedevConfig, prompt: string | undefined): Promise<void>;
+export declare function runSubmit(config: CodiedevConfig, rawJson: string): Promise<void>;
+export declare function readSubmitInput(source: "stdin" | string): string;
+export {};

package/dist/commands/createTicket.js

@@ -0,0 +1,198 @@
+"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.substitutePrompt = substitutePrompt;
+exports.validatePlanHasRepo = validatePlanHasRepo;
+exports.resolveRepoIds = resolveRepoIds;
+exports.parseCreateTicketArgs = parseCreateTicketArgs;
+exports.runCreateTicket = runCreateTicket;
+exports.runBare = runBare;
+exports.runSubmit = runSubmit;
+exports.readSubmitInput = readSubmitInput;
+const fs = __importStar(require("node:fs"));
+const shared_1 = require("./shared");
+const PROMPT_PLACEHOLDER = "{{USER_PROMPT}}";
+const MISSING_PROMPT_FALLBACK = "(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.)";
+function substitutePrompt(protocol, prompt) {
+    return protocol.replace(PROMPT_PLACEHOLDER, prompt && prompt.length > 0 ? prompt : MISSING_PROMPT_FALLBACK);
+}
+function validatePlanHasRepo(parsedPlan) {
+    const fullNames = Array.isArray(parsedPlan?.repoFullNames) ? parsedPlan.repoFullNames : [];
+    const explicitIds = Array.isArray(parsedPlan?.repoIds) ? parsedPlan.repoIds : [];
+    if (fullNames.length === 0 && explicitIds.length === 0) {
+        return "Plan must include at least one repo (repoFullNames: ['owner/name'] or repoIds: [...])";
+    }
+    return null;
+}
+function resolveRepoIds(fullNames, repos) {
+    const lookup = new Map();
+    for (const r of repos) {
+        lookup.set(r.fullName.toLowerCase(), r.repoId);
+    }
+    const ids = [];
+    for (const fn of fullNames) {
+        const id = lookup.get(fn.toLowerCase());
+        if (!id) {
+            throw new Error(`Repo "${fn}" is not connected to your CodieDev account. Run \`codiedev connect\` to refresh, or push the missing repo through Settings.`);
+        }
+        ids.push(id);
+    }
+    return ids;
+}
+function parseCreateTicketArgs(args) {
+    let mode = "bare";
+    let prompt;
+    let submitSource;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--submit" && i + 1 < args.length) {
+            mode = "submit";
+            const next = args[++i];
+            submitSource = next === "-" ? "stdin" : next;
+        }
+        else if (a.startsWith("--submit=")) {
+            mode = "submit";
+            const v = a.slice("--submit=".length);
+            submitSource = v === "-" ? "stdin" : v;
+        }
+        else if (!a.startsWith("--") && !prompt && mode === "bare") {
+            prompt = a;
+        }
+    }
+    return { mode, prompt, submitSource };
+}
+async function runCreateTicket(args) {
+    const parsed = parseCreateTicketArgs(args);
+    if (parsed.mode === "bare") {
+        const config = (0, shared_1.requireConfig)();
+        await runBare(config, parsed.prompt);
+        return;
+    }
+    // submit mode
+    if (!parsed.submitSource) {
+        console.error("--submit requires a path or '-' for stdin");
+        process.exit(1);
+    }
+    const config = (0, shared_1.requireConfig)();
+    let raw;
+    try {
+        raw = readSubmitInput(parsed.submitSource);
+    }
+    catch (err) {
+        console.error(`Failed to read plan: ${err.message}`);
+        process.exit(1);
+    }
+    // Translate fullNames → IDs before submitting
+    let parsedPlan;
+    try {
+        parsedPlan = JSON.parse(raw);
+    }
+    catch (err) {
+        console.error(`Plan JSON did not parse: ${err.message}`);
+        process.exit(1);
+    }
+    const validationError = validatePlanHasRepo(parsedPlan);
+    if (validationError) {
+        console.error(validationError);
+        process.exit(1);
+    }
+    const fullNames = Array.isArray(parsedPlan.repoFullNames) ? parsedPlan.repoFullNames : [];
+    const explicitIds = Array.isArray(parsedPlan.repoIds) ? parsedPlan.repoIds : [];
+    if (fullNames.length > 0 && explicitIds.length === 0) {
+        parsedPlan.repoIds = resolveRepoIds(fullNames, config.repos);
+    }
+    for (const t of parsedPlan.plan?.tickets ?? []) {
+        if (t.targetRepoFullName && !t.targetRepoId) {
+            const ids = resolveRepoIds([t.targetRepoFullName], config.repos);
+            t.targetRepoId = ids[0];
+        }
+    }
+    await runSubmit(config, JSON.stringify(parsedPlan));
+}
+/**
+ * Bare-mode entrypoint. Fetches the protocol body from the backend so we can
+ * iterate on it without shipping a new CLI, substitutes the user's prompt,
+ * and writes the result to stdout for the agent to follow. Hard-errors on
+ * fetch failure rather than falling back to a stale local copy — the whole
+ * point of moving the protocol server-side is that the freshest version is
+ * the only version.
+ */
+async function runBare(config, prompt) {
+    let res;
+    try {
+        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.`);
+        }
+        process.exit(1);
+    }
+    process.stdout.write(substitutePrompt(res.protocol, prompt));
+}
+async function runSubmit(config, rawJson) {
+    let payload;
+    try {
+        payload = JSON.parse(rawJson);
+    }
+    catch (err) {
+        throw new Error(`Plan JSON did not parse — emit valid JSON matching the schema printed by \`codiedev create-ticket\`. Original error: ${err.message}`);
+    }
+    if (!payload.plan || !payload.prompt || !payload.repoIds) {
+        throw new Error("Plan JSON missing one of: plan, prompt, repoIds");
+    }
+    const res = await (0, shared_1.withTelemetry)(config, "codiedev_create_ticket", () => (0, shared_1.apiRequest)("POST", "/api/cli/createPlan", {
+        config,
+        body: payload,
+    }));
+    const portalHost = (process.env.CODIEDEV_PORTAL_URL || "https://codiedev.com").replace(/\/$/, "");
+    const portalLink = res.portalUrl.startsWith("http")
+        ? res.portalUrl
+        : `${portalHost}${res.portalUrl}`;
+    console.log(`✓ Created ${res.ticketCount} ticket(s).`);
+    console.log(`  portal: ${portalLink}`);
+    console.log("");
+    console.log("Open in your portal to review and push to Jira.");
+}
+function readSubmitInput(source) {
+    if (source === "stdin") {
+        return fs.readFileSync(0, "utf8");
+    }
+    return fs.readFileSync(source, "utf8");
+}

package/dist/commands/shared.d.ts

@@ -1,4 +1,12 @@
 import { CodiedevConfig } from "../utils";
+/**
+ * Layer per-command env overrides on top of the on-disk config. Useful for
+ * ad-hoc testing — point a prod-connected CLI at a dev Convex deployment
+ * without re-running `codiedev connect`. Both CODIEDEV_URL and CODIEDEV_TOKEN
+ * must be set together (half-overrides would mismatch URL and auth realm).
+ * Other fields (companyId, repos[]) come from the file unchanged.
+ */
+export declare function applyConfigEnvOverrides(config: CodiedevConfig): CodiedevConfig;
 /**
  * Require a connected CodieDev config. Exits the process with a helpful
  * message if the user hasn't run `codiedev connect` yet.

package/dist/commands/shared.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyConfigEnvOverrides = applyConfigEnvOverrides;
 exports.requireConfig = requireConfig;
 exports.apiRequest = apiRequest;
 exports.recordAgentEvent = recordAgentEvent;
@@ -43,6 +44,21 @@ const https = __importStar(require("https"));
 const http = __importStar(require("http"));
 const utils_1 = require("../utils");
 const version_1 = require("../version");
+/**
+ * Layer per-command env overrides on top of the on-disk config. Useful for
+ * ad-hoc testing — point a prod-connected CLI at a dev Convex deployment
+ * without re-running `codiedev connect`. Both CODIEDEV_URL and CODIEDEV_TOKEN
+ * must be set together (half-overrides would mismatch URL and auth realm).
+ * Other fields (companyId, repos[]) come from the file unchanged.
+ */
+function applyConfigEnvOverrides(config) {
+    const url = process.env.CODIEDEV_URL;
+    const token = process.env.CODIEDEV_TOKEN;
+    if (url && token) {
+        return { ...config, backendUrl: url, token };
+    }
+    return config;
+}
 /**
  * Require a connected CodieDev config. Exits the process with a helpful
  * message if the user hasn't run `codiedev connect` yet.
@@ -53,7 +69,7 @@ function requireConfig() {
         console.error("Not connected. Run `npx codiedev connect` first and enter your API token.");
         process.exit(1);
     }
-    return config;
+    return applyConfigEnvOverrides(config);
 }
 /**
  * Perform an authenticated HTTP request against the CodieDev backend.

package/dist/createTicketSkill.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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

@@ -0,0 +1,146 @@
+"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.)");
+}

package/dist/utils.js

@@ -302,6 +302,7 @@ thought, use the \`codiedev\` CLI via Bash:**
 | "read that reply" / "mark that ping read" | \`codiedev read <ping-id>\` |
 | "note that X is a follow-up" / "remember X" | \`codiedev note "<text>"\` |
 | "promote the extracted spec" | \`codiedev promote <artifact-id>\` |
+| "create a ticket" / "scope this into tickets" / "ticket this for me" | \`codiedev create-ticket [optional-inline-prompt]\` |
 | "post this to the team" / "publish to the feed" / "share with the team" | \`codiedev post --title "<t>" --body "<b>" [--intent <intent>] [--filename <key>] [--mention <name>]\` |
 | "share with a teammate" / "give someone access" (no notification) | \`codiedev share <key> <name> [--role read\\|edit]\` |
 | "send this to a teammate" / "ask someone to look at this" | \`codiedev send <key> <name> ["<msg>"]\` |
@@ -369,6 +370,11 @@ iterate rather than duplicating.
 notification). \`codiedev send\` both grants access AND pings the
 recipient. Use send when the user is actively looping someone in.
 
+**\`create-ticket\` flow:** when invoked without \`--submit\`, the CLI prints
+skill instructions you should follow. Step 1 is asking the user about repos.
+Step 4 calls \`codiedev create-ticket --submit <path>\` with the plan JSON.
+Tell the user the portal URL when the submit returns.
+
 **Errors:**
 - "not connected" → user needs to run \`npx codiedev connect\` with their
   API token from https://codiedev.com/portal/integrations/claude-code

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codiedev",
-  "version": "0.7.11",
+  "version": "0.8.0",
   "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",