codiedev 0.5.4 → 0.5.6

package/dist/cli.js

@@ -19,6 +19,7 @@ const connect_1 = require("./connect");
 const push_1 = require("./commands/push");
 const delete_1 = require("./commands/delete");
 const pull_1 = require("./commands/pull");
+const ask_1 = require("./commands/ask");
 const ping_1 = require("./commands/ping");
 const inbox_1 = require("./commands/inbox");
 const note_1 = require("./commands/note");
@@ -43,6 +44,10 @@ Artifacts:
   codiedev delete <key> [-y]             Delete every version of an artifact you
                                          authored (clean up bad/test pushes).
                                          Asks for confirmation; -y to skip.
+  codiedev ask "<question>"              Ask a natural-language question of the
+                                         team's collective memory. Returns an
+                                         LLM-synthesized answer with citations
+                                         pointing at sessions + artifacts.
   codiedev promote <artifact-id>         Promote an auto-extracted artifact
                                          to an authored one
   codiedev reverse-ticket [<pr-url>]     Generate a Jira ticket draft.
@@ -374,6 +379,9 @@ async function main() {
             case "pull":
                 await (0, pull_1.runPull)(rest);
                 return;
+            case "ask":
+                await (0, ask_1.runAsk)(rest);
+                return;
             case "ping":
                 await (0, ping_1.runPing)(rest);
                 return;

package/dist/commands/ask.d.ts

@@ -0,0 +1 @@
+export declare function runAsk(args: string[]): Promise<void>;

package/dist/commands/ask.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAsk = runAsk;
+const shared_1 = require("./shared");
+function parseArgs(args) {
+    // Everything after the command, joined back into a question string. Allows
+    // both quoted and unquoted forms: `codiedev ask "why pg-bouncer?"` or
+    // `codiedev ask why did we drop pg-bouncer`.
+    const question = args
+        .filter((a) => !a.startsWith("--"))
+        .join(" ")
+        .trim();
+    if (!question) {
+        console.error('Usage: codiedev ask "<question>"');
+        console.error('Example: codiedev ask "why did we drop pg-bouncer?"');
+        process.exit(1);
+    }
+    return { question };
+}
+async function runAsk(args) {
+    const { question } = parseArgs(args);
+    const config = (0, shared_1.requireConfig)();
+    try {
+        const res = await (0, shared_1.apiRequest)("POST", "/api/cli/ask", {
+            config,
+            body: { question },
+        });
+        console.log("");
+        console.log(res.answer);
+        if (res.citations.length > 0) {
+            console.log("");
+            console.log("Sources:");
+            for (const c of res.citations) {
+                const label = c.kind === "artifact"
+                    ? `[${c.type}] ${c.title}`
+                    : `[session] ${c.title}`;
+                console.log(`  • ${label}`);
+            }
+        }
+        console.log("");
+    }
+    catch (err) {
+        console.error(`Ask failed: ${err.message}`);
+        process.exit(1);
+    }
+}

package/dist/mcp.js

@@ -384,7 +384,9 @@ const TOOLS = [
             "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.",
+            "with title, type, filename key, and a snippet. For open-ended " +
+            "questions where the user wants a synthesized answer (not just a list " +
+            "of hits), prefer codiedev_ask instead.",
         inputSchema: {
             type: "object",
             properties: {
@@ -394,6 +396,32 @@ const TOOLS = [
             required: ["query"],
         },
     },
+    {
+        name: "codiedev_ask",
+        description: "Ask a natural-language question of the team's collective memory and " +
+            "get a synthesized answer with citations. Searches across both " +
+            "auto-extracted artifacts (specs / decisions / bugfixes) AND raw " +
+            "session transcripts, then has an LLM compose an answer that cites " +
+            "the actual sources. Use when the user asks 'why did we…?', 'what " +
+            "does the team know about X?', 'has anyone done Y here before?', " +
+            "'who decided Z and why?', or any open-ended question about prior " +
+            "work where they want context, not just a hit list. For exact-match " +
+            "lookups (find me spec-x), prefer codiedev_pull. For browsing or " +
+            "filtering by kind/tag, prefer codiedev_get_library. For surfacing " +
+            "ranked hits without LLM synthesis, prefer codiedev_search.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                question: {
+                    type: "string",
+                    description: "Natural-language question. Open-ended is fine — e.g. 'why " +
+                        "did we drop pg-bouncer?' or 'how does the team think about " +
+                        "feature flags?'.",
+                },
+            },
+            required: ["question"],
+        },
+    },
     {
         name: "codiedev_get_library",
         description: "List artifacts in the team library — both docs (spec / decision / " +
@@ -571,6 +599,8 @@ async function dispatchTool(name, args, config) {
             return await handleSendTo(args, config);
         case "codiedev_react":
             return await handleReact(args, config);
+        case "codiedev_ask":
+            return await handleAsk(args, config);
         case "codiedev_search":
             return await handleSearch(args, config);
         case "codiedev_get_library":
@@ -621,8 +651,15 @@ async function handlePull(args, config) {
         throw new Error("key required");
     const res = await (0, shared_1.apiRequest)("GET", "/api/cli/pull", { config, query: { key, version } });
     const a = res.artifact;
+    // Lead with the new-vocab kind. Legacy doc-shape (spec/decision/...) is
+    // surfaced as a tag list after, so callers still see it but it's no
+    // longer the primary label. Falls back to "doc" if the row pre-dates the
+    // kind field.
+    const kindLabel = a.kind ?? "doc";
+    const tagList = (a.tags ?? []).filter((t) => t).join(", ");
+    const tagSuffix = tagList ? ` · tags: ${tagList}` : "";
     const header = `# ${a.title}\n\n` +
-        `**${a.type}** · v${a.version ?? 1} · ${a.lifecycle ?? "draft"} · ` +
+        `**${kindLabel}** · v${a.version ?? 1} · ${a.lifecycle ?? "draft"}${tagSuffix} · ` +
         `updated ${(0, shared_1.timeAgo)(a.updatedAt ?? a.createdAt)}\n\n---\n\n`;
     return {
         content: [{ type: "text", text: header + a.markdown }],
@@ -915,6 +952,23 @@ async function handleSearch(args, config) {
     }
     return { content: [{ type: "text", text: lines.join("\n") }] };
 }
+async function handleAsk(args, config) {
+    const question = asString(args.question);
+    if (!question)
+        throw new Error("question required");
+    const res = await (0, shared_1.apiRequest)("POST", "/api/cli/ask", { config, body: { question } });
+    const lines = [res.answer];
+    if (res.citations && res.citations.length > 0) {
+        lines.push("", "Sources:");
+        for (const c of res.citations) {
+            const label = c.kind === "artifact"
+                ? `[${c.type}] ${c.title}`
+                : `[session] ${c.title}`;
+            lines.push(`  • ${label}`);
+        }
+    }
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+}
 async function handleGetLibrary(args, config) {
     const scope = asStringOrUndefined(args.scope);
     const type = asStringOrUndefined(args.type);

package/dist/utils.js

@@ -218,6 +218,7 @@ thought, use the \`codiedev\` CLI via Bash:**
 | "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\` |
+| "why did we…?" / "what does the team know about X?" | MCP tool \`codiedev_ask\` (synthesized answer + citations) |
 | "show my library" / "what artifacts exist?" | MCP tool \`codiedev_get_library\` |
 | "react 🛠 to that post" / "mark as used" | MCP tool \`codiedev_react\` |
 

package/package.json

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