codiedev 0.7.11 → 0.8.1

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,14 @@ 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.
+  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 +250,25 @@ 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.
+
+  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 +408,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 +459,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,192 @@
+"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) {
+        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/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.1",
   "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",