codiedev 0.3.6 → 0.5.0

package/dist/cli.js

@@ -41,8 +41,12 @@ Artifacts:
                                          Fetch an artifact (stdout by default)
   codiedev promote <artifact-id>         Promote an auto-extracted artifact
                                          to an authored one
-  codiedev reverse-ticket <pr-url>       Generate a Jira ticket from a merged PR
-                                         (auto-matches spec + thread + transcript)
+  codiedev reverse-ticket [<pr-url>]     Generate a Jira ticket draft.
+                                         No URL = branch mode (uses your current
+                                         local git branch, no PR needed).
+                                         Draft lands in /portal/agentic-ticketing.
+  codiedev reverse-ticket --base <ref>   Override the base ref in branch mode
+                                         (defaults to origin/main).
 
 Messaging:
   codiedev ping <user> "<msg>" [--with <key>]

package/dist/commands/reverseTicket.js

@@ -33,6 +33,7 @@ function ghRaw(path) {
 }
 function parseArgs(args) {
     let prUrl;
+    let base;
     let forcedKey;
     let noTruncate = false;
     for (let i = 0; i < args.length; i++) {
@@ -43,6 +44,12 @@ function parseArgs(args) {
         else if (a.startsWith("--with=")) {
             forcedKey = a.slice("--with=".length);
         }
+        else if ((a === "--base" || a === "-b") && i + 1 < args.length) {
+            base = args[++i];
+        }
+        else if (a.startsWith("--base=")) {
+            base = a.slice("--base=".length);
+        }
         else if (a === "--full") {
             noTruncate = true;
         }
@@ -50,19 +57,19 @@ function parseArgs(args) {
             prUrl = a;
         }
     }
-    if (!prUrl) {
-        console.error("Usage: codiedev reverse-ticket <pr-url> [--with <artifact-key>] [--full]");
-        console.error("");
-        console.error("Example: codiedev reverse-ticket https://github.com/signalandcode/repo/pull/42");
-        process.exit(1);
-    }
-    return { prUrl, forcedKey, noTruncate };
+    return { prUrl, base, forcedKey, noTruncate };
 }
 async function runReverseTicket(args) {
-    const { prUrl, forcedKey, noTruncate } = parseArgs(args);
+    const { prUrl, base, forcedKey, noTruncate } = parseArgs(args);
+    // No PR URL → branch mode (mid-session, no PR exists yet).
+    if (!prUrl) {
+        return runBranchMode({ explicitBase: base, forcedKey });
+    }
     const parsed = parsePrUrl(prUrl);
     if (!parsed) {
         console.error("Couldn't parse PR URL. Expected format: https://github.com/<owner>/<repo>/pull/<number>");
+        console.error("");
+        console.error("Run with no arguments for branch mode (uses your current local branch).");
         process.exit(1);
     }
     if (!checkGhCli()) {
@@ -148,3 +155,135 @@ async function runReverseTicket(args) {
         process.exit(1);
     }
 }
+function git(cmd) {
+    try {
+        return (0, child_process_1.execSync)(`git ${cmd}`, {
+            stdio: ["pipe", "pipe", "pipe"],
+            maxBuffer: 32 * 1024 * 1024,
+        })
+            .toString("utf8")
+            .trim();
+    }
+    catch (err) {
+        throw new Error(`git ${cmd} failed: ${err.message}`);
+    }
+}
+function safeGit(fn) {
+    try {
+        return fn() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function runBranchMode(opts) {
+    // Confirm we're in a git repo.
+    try {
+        git("rev-parse --is-inside-work-tree");
+    }
+    catch {
+        console.error("Not inside a git repository. Run this from a checked-out repo.");
+        process.exit(1);
+    }
+    // Resolve base ref — explicit, then origin/main, then origin/master.
+    const candidates = opts.explicitBase
+        ? [opts.explicitBase]
+        : ["origin/main", "origin/master"];
+    let baseRef = null;
+    for (const c of candidates) {
+        try {
+            git(`rev-parse --verify ${c}`);
+            baseRef = c;
+            break;
+        }
+        catch {
+            // try next
+        }
+    }
+    if (!baseRef) {
+        console.error(`Couldn't find a base ref (tried ${candidates.join(", ")}). Pass --base <ref>.`);
+        process.exit(1);
+    }
+    const branch = git("rev-parse --abbrev-ref HEAD");
+    if (branch === "HEAD") {
+        console.error("Detached HEAD — checkout a branch first.");
+        process.exit(1);
+    }
+    const baseSha = git(`merge-base HEAD ${baseRef}`);
+    const headSha = git("rev-parse HEAD");
+    if (baseSha === headSha) {
+        console.error(`No commits on ${branch} ahead of ${baseRef} — make a commit first.`);
+        process.exit(1);
+    }
+    const filesRaw = git(`diff --name-only ${baseSha}...HEAD`);
+    const filesChanged = filesRaw ? filesRaw.split("\n").filter(Boolean) : [];
+    if (filesChanged.length === 0) {
+        console.error(`No files changed between ${baseRef} and ${branch} — nothing to write up.`);
+        process.exit(1);
+    }
+    let diff = "";
+    try {
+        diff = git(`diff ${baseSha}...HEAD`).slice(0, 12_000);
+    }
+    catch {
+        // best effort
+    }
+    let repo;
+    try {
+        const remoteUrl = git("config --get remote.origin.url");
+        const m = remoteUrl.match(/[:/]([^/:]+)\/([^/:]+?)(?:\.git)?$/);
+        if (!m) {
+            throw new Error(`Couldn't parse owner/repo from remote: ${remoteUrl}`);
+        }
+        repo = `${m[1]}/${m[2]}`;
+    }
+    catch (err) {
+        console.error(`Couldn't read git remote.origin.url: ${err.message}`);
+        process.exit(1);
+    }
+    const title = safeGit(() => git("log -1 --format=%s")) ?? `WIP: ${branch}`;
+    const author = safeGit(() => git("config --get user.name"));
+    const authorEmail = safeGit(() => git("config --get user.email"));
+    console.log(`Branch:  ${branch}  (${repo})`);
+    console.log(`Base:    ${baseRef} @ ${baseSha.slice(0, 12)}`);
+    console.log(`Head:    ${headSha.slice(0, 12)}`);
+    console.log(`Files:   ${filesChanged.length}`);
+    console.log("");
+    console.log("Generating ticket draft…");
+    console.log("");
+    const config = (0, shared_1.requireConfig)();
+    try {
+        const res = await (0, shared_1.apiRequest)("POST", "/api/cli/reverseTicketFromBranch", {
+            config,
+            body: {
+                branch: {
+                    repo,
+                    branch,
+                    baseSha,
+                    headSha,
+                    title,
+                    author,
+                    authorEmail,
+                    filesChanged,
+                    diff: diff || undefined,
+                },
+                forcedArtifactKey: opts.forcedKey,
+            },
+        });
+        if (!res.ok || !res.artifactId) {
+            console.error("Reverse-ticket generation returned no result. The writer may have skipped due to missing context.");
+            process.exit(1);
+        }
+        const verb = res.action === "overwritten" ? "Updated" : "Created";
+        console.log(`✓ ${verb} reverse-ticket draft.`);
+        console.log(`  artifact: ${res.artifactKey ?? res.artifactId}`);
+        console.log(`  portal:   ${res.portalUrl}`);
+        console.log("");
+        console.log("Open in your portal to review, edit, and push to Jira.");
+        console.log("When the PR opens later, the webhook dedupes against this draft — one ticket, not two.");
+    }
+    catch (err) {
+        console.error(`Reverse-ticket failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/mcp.js

@@ -52,7 +52,7 @@ const path = __importStar(require("path"));
 const utils_1 = require("./utils");
 const shared_1 = require("./commands/shared");
 const PKG_NAME = "codiedev";
-const PKG_VERSION = "0.3.0";
+const PKG_VERSION = "0.5.0";
 // ─────────────────────────────────────────────────────────────────────────────
 // Tool definitions — descriptions tuned so Claude/Codex resolve natural-language
 // requests into the right tool without manual steering.
@@ -202,6 +202,211 @@ const TOOLS = [
             required: ["artifactId"],
         },
     },
+    {
+        name: "codiedev_post_to_feed",
+        description: "Publish an artifact to the team's break-room feed with an intent " +
+            "and optional @mentions. Use when the user asks to 'post this to " +
+            "the team', 'publish to the feed', 'share with the team', 'ask the " +
+            "team', or when they want broader visibility than a single ping. " +
+            "Pass the artifact's filename (e.g., 'spec-214.md') and pick an " +
+            "intent that matches the request: share = here's a skill/spec; " +
+            "request_review = please review; request_expertise = I'm stuck, " +
+            "who knows this; link_share = fyi; rfc = proposing a change. " +
+            "Optionally @mention teammates (by first name) so they get a " +
+            "notification. Returns the feed post id.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filename: {
+                    type: "string",
+                    description: "Artifact filename to attach (e.g., 'spec-214.md'). The post " +
+                        "will render a preview card linking to it.",
+                },
+                title: {
+                    type: "string",
+                    description: "Headline of the post. Short, imperative — e.g., 'Check my " +
+                        "OAuth middleware spec' or 'Anyone know how we handle X?'.",
+                },
+                body: {
+                    type: "string",
+                    description: "Body of the post in markdown. A short explanation of why the " +
+                        "user is posting (the artifact carries the detail).",
+                },
+                intent: {
+                    type: "string",
+                    enum: [
+                        "share",
+                        "request_review",
+                        "request_expertise",
+                        "link_share",
+                        "rfc",
+                    ],
+                    description: "Why the user is posting. See tool description.",
+                },
+                mentions: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Teammate first names (or handles) to @mention. Each mention " +
+                        "creates a notification for that teammate.",
+                },
+                format: {
+                    type: "string",
+                    enum: ["article", "quick", "workflow", "review"],
+                    description: "Post format. Default 'article' if omitted. Use 'quick' for " +
+                        "short one-liners.",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional tags, lowercase, hyphen-safe.",
+                },
+            },
+            required: ["title", "body"],
+        },
+    },
+    {
+        name: "codiedev_share_with",
+        description: "Grant a teammate persistent read (or edit) access to an artifact " +
+            "without sending a notification. Use when the user says 'share this " +
+            "with Greg' or 'give Jason access', and doesn't want to surface it " +
+            "as a message. If they want the teammate actively notified, use " +
+            "codiedev_send_to instead.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filename: { type: "string", description: "Artifact filename, e.g. 'spec-214.md'." },
+                to: {
+                    type: "string",
+                    description: "Teammate first name, full name, or email. Ambiguous matches " +
+                        "return a list — reprompt the user if so.",
+                },
+                role: {
+                    type: "string",
+                    enum: ["read", "edit"],
+                    description: "Access level. Default 'read' if omitted.",
+                },
+            },
+            required: ["filename", "to"],
+        },
+    },
+    {
+        name: "codiedev_send_to",
+        description: "Grant access to an artifact AND send a short message to a " +
+            "teammate. Use when the user asks to 'send this to Greg', 'ask " +
+            "Greg to look at this', or 'share this with Jason and tell him X'. " +
+            "This is the active handoff version of codiedev_share_with — the " +
+            "recipient gets a ping in their inbox.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filename: { type: "string", description: "Artifact filename." },
+                to: { type: "string", description: "Teammate first name, full name, or email." },
+                message: {
+                    type: "string",
+                    description: "Optional short note to send with the share. If omitted, only " +
+                        "the grant is created (no ping).",
+                },
+            },
+            required: ["filename", "to"],
+        },
+    },
+    {
+        name: "codiedev_react",
+        description: "React to a feed post with an emoji. Use when the user says 'react " +
+            "to that post with X', 'mark as used', or 'upvote'. The 🛠 " +
+            "reaction is the signal for 'I used this' and bumps the linked " +
+            "artifact's reuse count. Pass the post id (get it from " +
+            "codiedev_get_library or a previous post-to-feed response).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                postId: { type: "string", description: "Feed post id." },
+                emoji: {
+                    type: "string",
+                    enum: ["👍", "🔥", "💡", "🛠", "👑"],
+                    description: "Reaction emoji. 🛠 = 'I used this' (counts heaviest toward " +
+                        "the author's score and the artifact's reuse count).",
+                },
+            },
+            required: ["postId", "emoji"],
+        },
+    },
+    {
+        name: "codiedev_search",
+        description: "Search the team's artifact library by natural-language query. Use " +
+            "when the user asks 'has anyone solved X?', 'find me the spec on Y', " +
+            "or 'look for prior work on Z'. Always search before pushing a new " +
+            "artifact so the user doesn't duplicate work. Returns ranked hits " +
+            "with title, type, filename key, and a snippet.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Natural-language search query." },
+                limit: { type: "integer", description: "Max hits. Default 10." },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "codiedev_get_library",
+        description: "List artifacts in the team library, scoped to what the current " +
+            "user authored, what's been shared with them, or everything in the " +
+            "company. Use when the user asks 'show me my artifacts', 'what did " +
+            "I push?', 'what has Greg shared with me?', or 'browse the library'.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                scope: {
+                    type: "string",
+                    enum: ["mine", "shared", "all"],
+                    description: "'mine' = artifacts I authored (default). 'shared' = artifacts " +
+                        "explicitly shared with me. 'all' = everything in the company.",
+                },
+                type: {
+                    type: "string",
+                    enum: ["spec", "bugfix", "decision", "proposal", "review", "note"],
+                    description: "Filter to one artifact type.",
+                },
+                folderPath: { type: "string", description: "Filter to one folder path." },
+                limit: { type: "integer", description: "Max rows. Default 50." },
+            },
+        },
+    },
+    {
+        name: "codiedev_reverse_ticket",
+        description: "Generate a Jira-ready reverse-ticket draft from the work the user has " +
+            "done in their CURRENT git branch — mid-session, before any PR exists. " +
+            "Reads local git state (current branch, divergence from main, diff, " +
+            "commits, files changed) and runs it through the codiedev reverse-" +
+            "ticket writer. The draft lands in the user's portal at " +
+            "/portal/agentic-ticketing where they can edit the title, description, " +
+            "and scope, then push to Jira. Use when the user asks to 'create a " +
+            "reverse ticket', 'draft a Jira ticket from this work', 'write up what " +
+            "I've done in this branch', or runs `codiedev reverse-ticket` directly. " +
+            "The webhook on PR-open later dedupes against this draft so the user " +
+            "never gets a double ticket. The draft is intentionally not auto-pushed " +
+            "to Jira — trust comes from the user reviewing in the portal first.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: {
+                    type: "string",
+                    description: "Optional working title for the ticket. Defaults to the most " +
+                        "recent commit subject on the branch.",
+                },
+                base: {
+                    type: "string",
+                    description: "Optional base ref to diff against. Defaults to 'origin/main', " +
+                        "falls back to 'origin/master'.",
+                },
+                forcedArtifactKey: {
+                    type: "string",
+                    description: "Optional — force the writer to link to a specific artifact key " +
+                        "for context (e.g. 'spec-auth.md').",
+                },
+            },
+        },
+    },
 ];
 // ─────────────────────────────────────────────────────────────────────────────
 // Server
@@ -210,6 +415,26 @@ const server = new index_js_1.Server({ name: PKG_NAME, version: PKG_VERSION }, {
 server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
     tools: TOOLS,
 }));
+/**
+ * Fire-and-forget telemetry — POST one event per tool invocation. Never blocks,
+ * never throws into the user-facing path. Drop silently on any failure.
+ */
+function emitTelemetry(config, event) {
+    if (!config)
+        return;
+    (0, shared_1.apiRequest)("POST", "/api/telemetry/mcp-event", {
+        config,
+        body: {
+            tool: event.tool,
+            ok: event.ok,
+            latencyMs: event.latencyMs,
+            error: event.error,
+            mcpVersion: PKG_VERSION,
+        },
+    }).catch(() => {
+        // Swallow — telemetry should never affect the user's session.
+    });
+}
 server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     const config = (0, utils_1.readConfig)();
     if (!config) {
@@ -227,28 +452,26 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     }
     const { name, arguments: argsRaw } = request.params;
     const args = (argsRaw ?? {});
+    const start = Date.now();
     try {
-        switch (name) {
-            case "codiedev_push":
-                return await handlePush(args, config);
-            case "codiedev_pull":
-                return await handlePull(args, config);
-            case "codiedev_ping":
-                return await handlePing(args, config);
-            case "codiedev_inbox":
-                return await handleInbox(args, config);
-            case "codiedev_note":
-                return await handleNote(args, config);
-            case "codiedev_promote":
-                return await handlePromote(args, config);
-            default:
-                return {
-                    isError: true,
-                    content: [{ type: "text", text: `Unknown tool: ${name}` }],
-                };
-        }
+        const result = await dispatchTool(name, args, config);
+        emitTelemetry(config, {
+            tool: name,
+            ok: !result?.isError,
+            latencyMs: Date.now() - start,
+            error: result?.isError
+                ? (result?.content?.[0]?.text ?? "").slice(0, 200) || "unknown error"
+                : undefined,
+        });
+        return result;
     }
     catch (err) {
+        emitTelemetry(config, {
+            tool: name,
+            ok: false,
+            latencyMs: Date.now() - start,
+            error: (err.message ?? "unknown").slice(0, 200),
+        });
         return {
             isError: true,
             content: [
@@ -260,6 +483,41 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
         };
     }
 });
+async function dispatchTool(name, args, config) {
+    switch (name) {
+        case "codiedev_push":
+            return await handlePush(args, config);
+        case "codiedev_pull":
+            return await handlePull(args, config);
+        case "codiedev_ping":
+            return await handlePing(args, config);
+        case "codiedev_inbox":
+            return await handleInbox(args, config);
+        case "codiedev_note":
+            return await handleNote(args, config);
+        case "codiedev_promote":
+            return await handlePromote(args, config);
+        case "codiedev_post_to_feed":
+            return await handlePostToFeed(args, config);
+        case "codiedev_share_with":
+            return await handleShareWith(args, config);
+        case "codiedev_send_to":
+            return await handleSendTo(args, config);
+        case "codiedev_react":
+            return await handleReact(args, config);
+        case "codiedev_search":
+            return await handleSearch(args, config);
+        case "codiedev_get_library":
+            return await handleGetLibrary(args, config);
+        case "codiedev_reverse_ticket":
+            return await handleReverseTicket(args, config);
+        default:
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+            };
+    }
+}
 async function handlePush(args, config) {
     const filename = asString(args.filename);
     const markdown = asString(args.markdown);
@@ -394,6 +652,340 @@ async function handlePromote(args, config) {
         ],
     };
 }
+async function handlePostToFeed(args, config) {
+    const filename = asStringOrUndefined(args.filename);
+    const title = asString(args.title);
+    const body = asString(args.body);
+    const intent = asStringOrUndefined(args.intent);
+    const format = asStringOrUndefined(args.format);
+    const mentionsRaw = Array.isArray(args.mentions) ? args.mentions : [];
+    const mentions = mentionsRaw.filter((m) => typeof m === "string");
+    const tagsRaw = Array.isArray(args.tags) ? args.tags : [];
+    const tags = tagsRaw.filter((t) => typeof t === "string");
+    if (!title)
+        throw new Error("title required");
+    if (!body)
+        throw new Error("body required");
+    const res = await (0, shared_1.apiRequest)("POST", "/api/cli/post-to-feed", {
+        config,
+        body: { filename, title, body, intent, format, mentions, tags },
+    });
+    const pieces = [`✓ Posted to feed (id=${res.postId}).`];
+    if (res.linkedArtifact?.key)
+        pieces.push(`  attached: ${res.linkedArtifact.key}`);
+    if (res.intent)
+        pieces.push(`  intent: ${res.intent}`);
+    if (res.mentions?.length) {
+        pieces.push(`  mentioned: ${res.mentions.map((m) => m.name).join(", ")}`);
+    }
+    return { content: [{ type: "text", text: pieces.join("\n") }] };
+}
+async function handleShareWith(args, config) {
+    const filename = asString(args.filename);
+    const to = asString(args.to);
+    const role = asStringOrUndefined(args.role);
+    if (!filename)
+        throw new Error("filename required");
+    if (!to)
+        throw new Error("to required");
+    try {
+        const res = await (0, shared_1.apiRequest)("POST", "/api/cli/share-with", {
+            config,
+            body: { filename, to, role },
+        });
+        const verb = res.action === "added"
+            ? "Shared"
+            : res.action === "updated"
+                ? "Updated share for"
+                : "Already shared with";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✓ ${verb} ${res.recipient.name} <${res.recipient.email}> on ${filename} (role=${role ?? "read"}).`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return formatAmbiguousRecipient(err, to);
+    }
+}
+async function handleSendTo(args, config) {
+    const filename = asString(args.filename);
+    const to = asString(args.to);
+    const message = asStringOrUndefined(args.message);
+    if (!filename)
+        throw new Error("filename required");
+    if (!to)
+        throw new Error("to required");
+    try {
+        const res = await (0, shared_1.apiRequest)("POST", "/api/cli/send-to", {
+            config,
+            body: { filename, to, message },
+        });
+        const suffix = res.pingId ? ` with a message.` : ` (no message).`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✓ Sent ${filename} to ${res.recipient.name} <${res.recipient.email}>${suffix}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return formatAmbiguousRecipient(err, to);
+    }
+}
+async function handleReact(args, config) {
+    const postId = asString(args.postId);
+    const emoji = asString(args.emoji);
+    if (!postId)
+        throw new Error("postId required");
+    if (!emoji)
+        throw new Error("emoji required");
+    const res = await (0, shared_1.apiRequest)("POST", "/api/cli/react", {
+        config,
+        body: { postId, emoji },
+    });
+    const verb = res.action === "added"
+        ? "Reacted"
+        : res.action === "removed"
+            ? "Removed reaction"
+            : "Swapped reaction to";
+    return {
+        content: [{ type: "text", text: `✓ ${verb} ${res.emoji}` }],
+    };
+}
+async function handleSearch(args, config) {
+    const query = asString(args.query);
+    const limit = asIntOrUndefined(args.limit);
+    if (!query)
+        throw new Error("query required");
+    const res = await (0, shared_1.apiRequest)("GET", "/api/cli/search", {
+        config,
+        query: { q: query, limit: limit?.toString() },
+    });
+    if (res.hits.length === 0) {
+        return {
+            content: [{ type: "text", text: `No artifacts matched "${query}".` }],
+        };
+    }
+    const lines = [`Found ${res.hits.length} match${res.hits.length === 1 ? "" : "es"}:`, ""];
+    for (const h of res.hits) {
+        lines.push(`[${h.type}] ${h.title}${h.key ? ` (${h.key})` : ""}`);
+        if (h.snippet) {
+            lines.push(`    ${h.snippet.slice(0, 160)}${h.snippet.length > 160 ? "…" : ""}`);
+        }
+        lines.push("");
+    }
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+}
+async function handleGetLibrary(args, config) {
+    const scope = asStringOrUndefined(args.scope);
+    const type = asStringOrUndefined(args.type);
+    const folderPath = asStringOrUndefined(args.folderPath);
+    const limit = asIntOrUndefined(args.limit);
+    const res = await (0, shared_1.apiRequest)("GET", "/api/cli/library", {
+        config,
+        query: {
+            scope,
+            type,
+            folderPath,
+            limit: limit?.toString(),
+        },
+    });
+    if (res.artifacts.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Library is empty${scope && scope !== "mine" ? ` for scope=${scope}` : ""}.`,
+                },
+            ],
+        };
+    }
+    const lines = [
+        `Library · scope=${scope ?? "mine"} · ${res.artifacts.length} item${res.artifacts.length === 1 ? "" : "s"}`,
+        "",
+    ];
+    for (const a of res.artifacts) {
+        const loc = a.folderPath ? `${a.folderPath}/` : "";
+        const v = a.version ? ` v${a.version}` : "";
+        const life = a.lifecycle ? ` · ${a.lifecycle}` : "";
+        const when = a.updatedAt ? ` · ${(0, shared_1.timeAgo)(a.updatedAt)}` : "";
+        lines.push(`[${a.type}] ${loc}${a.key ?? a.title}${v}${life}${when}`);
+        lines.push(`    ${a.title}`);
+        lines.push("");
+    }
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+}
+function formatAmbiguousRecipient(err, to) {
+    const e = err;
+    if (e.status === 409 && e.body?.candidates?.length) {
+        const list = e.body.candidates
+            .map((c) => `- ${c.name} <${c.email}>`)
+            .join("\n");
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `Multiple recipients matched "${to}". Ask the user which:\n${list}`,
+                },
+            ],
+        };
+    }
+    throw err;
+}
+async function handleReverseTicket(args, config) {
+    const explicitTitle = asStringOrUndefined(args.title);
+    const explicitBase = asStringOrUndefined(args.base);
+    const forcedKey = asStringOrUndefined(args.forcedArtifactKey);
+    // Helper that runs git from cwd with a hard-fail on error.
+    const { execSync } = await Promise.resolve().then(() => __importStar(require("child_process")));
+    const git = (cmd) => {
+        try {
+            return execSync(`git ${cmd}`, {
+                stdio: ["pipe", "pipe", "pipe"],
+                maxBuffer: 32 * 1024 * 1024,
+            })
+                .toString("utf8")
+                .trim();
+        }
+        catch (err) {
+            throw new Error(`git ${cmd} failed: ${err.message}`);
+        }
+    };
+    // Confirm we're in a git repo.
+    try {
+        git("rev-parse --is-inside-work-tree");
+    }
+    catch {
+        throw new Error("Not inside a git repository. Run this from a checked-out repo.");
+    }
+    // Resolve base ref — explicit, then origin/main, then origin/master.
+    const candidates = explicitBase
+        ? [explicitBase]
+        : ["origin/main", "origin/master"];
+    let baseRef = null;
+    for (const c of candidates) {
+        try {
+            git(`rev-parse --verify ${c}`);
+            baseRef = c;
+            break;
+        }
+        catch {
+            // try next
+        }
+    }
+    if (!baseRef) {
+        throw new Error(`Couldn't find a base ref (tried ${candidates.join(", ")}). ` +
+            `Pass an explicit base via the 'base' argument.`);
+    }
+    const branch = git("rev-parse --abbrev-ref HEAD");
+    if (branch === "HEAD") {
+        throw new Error("Detached HEAD — checkout a branch first.");
+    }
+    const baseSha = git(`merge-base HEAD ${baseRef}`);
+    const headSha = git("rev-parse HEAD");
+    if (baseSha === headSha) {
+        throw new Error(`No commits on ${branch} ahead of ${baseRef} — make a commit first.`);
+    }
+    const filesRaw = git(`diff --name-only ${baseSha}...HEAD`);
+    const filesChanged = filesRaw ? filesRaw.split("\n").filter(Boolean) : [];
+    if (filesChanged.length === 0) {
+        throw new Error(`No files changed between ${baseRef} and ${branch} — nothing to write up.`);
+    }
+    // Truncated diff (12k chars) — writer works without it but it sharpens output.
+    let diff = "";
+    try {
+        diff = git(`diff ${baseSha}...HEAD`).slice(0, 12_000);
+    }
+    catch {
+        // Best effort.
+    }
+    // Repo name from origin remote.
+    let repo;
+    try {
+        const remoteUrl = git("config --get remote.origin.url");
+        const m = remoteUrl.match(/[:/]([^/:]+)\/([^/:]+?)(?:\.git)?$/);
+        if (!m) {
+            throw new Error(`Couldn't parse owner/repo from remote: ${remoteUrl}`);
+        }
+        repo = `${m[1]}/${m[2]}`;
+    }
+    catch (err) {
+        throw new Error(`Couldn't read git remote.origin.url: ${err.message}`);
+    }
+    const title = explicitTitle ?? safeGit(() => git("log -1 --format=%s")) ?? `WIP: ${branch}`;
+    const author = safeGit(() => git("config --get user.name"));
+    const authorEmail = safeGit(() => git("config --get user.email"));
+    // Post to backend.
+    const res = await (0, shared_1.apiRequest)("POST", "/api/cli/reverseTicketFromBranch", {
+        config,
+        body: {
+            branch: {
+                repo,
+                branch,
+                baseSha,
+                headSha,
+                title,
+                author,
+                authorEmail,
+                filesChanged,
+                diff: diff || undefined,
+            },
+            forcedArtifactKey: forcedKey,
+        },
+    });
+    if (!res.ok || !res.artifactId) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Reverse-ticket generation returned no result. The writer may have " +
+                        "skipped due to missing context (no captured sessions, etc.). Try " +
+                        "again after working on the branch a bit more, or check the " +
+                        "server logs.",
+                },
+            ],
+        };
+    }
+    const portalBase = (config.backendUrl || "")
+        .replace(/\/$/, "")
+        .replace(/\.convex\.cloud$/, ".convex.cloud"); // backendUrl is the Convex site; portal is separate
+    // Best effort — surface the portal path; the user can prefix with their portal host.
+    const portalPath = res.portalUrl;
+    const verb = res.action === "overwritten" ? "Updated" : "Created";
+    return {
+        content: [
+            {
+                type: "text",
+                text: `✓ ${verb} reverse-ticket draft for branch \`${branch}\` (${repo}).\n` +
+                    `  files changed: ${filesChanged.length}\n` +
+                    `  base: ${baseSha.slice(0, 12)} → head: ${headSha.slice(0, 12)} (${baseRef})\n` +
+                    `  diff size: ${diff.length} chars\n` +
+                    `  artifact: ${res.artifactKey ?? res.artifactId}\n\n` +
+                    `Open in your portal to review, edit, and push to Jira:\n` +
+                    `  ${portalPath}\n\n` +
+                    `When the PR opens later, the webhook dedupes against this draft — ` +
+                    `you'll get one ticket, not two.`,
+            },
+        ],
+    };
+}
+// Run a git invocation; return undefined instead of throwing.
+function safeGit(fn) {
+    try {
+        return fn();
+    }
+    catch {
+        return undefined;
+    }
+}
 // ─────────────────────────────────────────────────────────────────────────────
 // Helpers
 // ─────────────────────────────────────────────────────────────────────────────

package/dist/utils.js

@@ -206,13 +206,19 @@ thought, use the \`codiedev\` CLI via Bash:**
 
 | Intent | Command |
 |---|---|
-| "push this spec" / "share this with the team" | \`codiedev push <file.md>\` |
+| "push this spec" / "save this as a skill" | \`codiedev push <file.md>\` |
 | "pull X" / "grab the latest spec-X" / "what did Maya push?" | \`codiedev pull <key>\` |
 | "ping Nic about this" / "ask Maya for her take" | \`codiedev ping <name> "<msg>" [--with <key>]\` |
 | "any messages?" / "check my inbox" / "what did Nic say?" | \`codiedev inbox\` |
 | "read Nic's 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>\` |
+| "post this to the team" / "publish to the feed" / "share with the team" | MCP tool \`codiedev_post_to_feed\` |
+| "share with Greg" / "give Jason access" (no notification) | MCP tool \`codiedev_share_with\` |
+| "send this to Greg" / "ask Greg to look at this" | MCP tool \`codiedev_send_to\` |
+| "find something about X" / "has anyone solved Y?" | MCP tool \`codiedev_search\` |
+| "show my library" / "what artifacts exist?" | MCP tool \`codiedev_get_library\` |
+| "react 🛠 to that post" / "mark as used" | MCP tool \`codiedev_react\` |
 
 **Filename conventions (set artifact type automatically):**
 - \`spec-*.md\` → spec
@@ -231,6 +237,22 @@ thought, use the \`codiedev\` CLI via Bash:**
 **Teammate names:** first name usually works (\`codiedev ping nic ...\`).
 If ambiguous, the CLI returns candidates — retry with the full email.
 
+**Feed posts (broad team reach):** use \`codiedev_post_to_feed\` when the
+user wants visibility beyond one teammate — e.g., announcing a new skill,
+asking the team who knows about X, proposing a change. Always pass an
+\`intent\` that matches the request: \`share\` (here's a skill),
+\`request_review\`, \`request_expertise\` (stuck, who knows this),
+\`link_share\` (fyi), or \`rfc\` (proposing a change). Attach a \`filename\`
+to link a specific artifact and \`mentions\` to tag teammates.
+
+**Search before pushing.** For any "save this as …" request, call
+\`codiedev_search\` first with a relevant query. If prior art exists, pull
+it and iterate rather than duplicating.
+
+**Sharing vs sending:** \`codiedev_share_with\` is silent (access only, no
+notification). \`codiedev_send_to\` both grants access AND pings the
+recipient. Use send when the user is actively looping someone in.
+
 **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.3.6",
+  "version": "0.5.0",
   "description": "Connect Claude Code or Codex to CodieDev for org-wide session capture and artifact collaboration",
   "bin": {
     "codiedev": "./dist/cli.js",