codiedev 0.9.83 → 0.9.85

package/dist/teamSkillContext.js

@@ -5,7 +5,7 @@ exports.teamSkillSessionOutput = teamSkillSessionOutput;
 /** Session-start context uses each client's supported output contract. */
 exports.TEAM_SKILL_CONTEXT = `This machine is connected to Codiedev, the team's artifact and skill library.
 Before a substantial coding task, run codiedev search "<brief task description>" and reuse a relevant team skill by running codiedev pull <exact-key> and following its instructions. If no skill fits, continue the task.
-Use codiedev push <file.md> to share an artifact when asked, codiedev ask "<question>" for team knowledge, and codiedev inbox to check messages. Use codiedev --help for other commands. If codiedev is unavailable, use npx codiedev@latest.`;
+Use codiedev push <file.md> to share an artifact when asked, and codiedev inbox to check messages. Use codiedev --help for other commands. If codiedev is unavailable, use npx codiedev@latest.`;
 function teamSkillSessionOutput(source, context = exports.TEAM_SKILL_CONTEXT) {
     return source === "cursor" ? { additional_context: context } : { additionalContext: context };
 }

package/dist/unreadNotice.d.ts

@@ -0,0 +1,22 @@
+export interface UnreadPings {
+    count: number;
+    newestPingId: string | null;
+    from: string[];
+    senderCount?: number;
+}
+/** Repeat an unchanged notice at most this often. A new ping always shows. */
+export declare const UNREAD_NOTICE_INTERVAL_MS: number;
+export declare function parseUnreadPings(value: unknown): UnreadPings | null;
+/** The line added to the session's context. Written for the agent: it says
+ *  what is waiting and what to do about it. */
+export declare function unreadNoticeLine(u: UnreadPings): string;
+/**
+ * Returns the notice to print, or null. Shown when the newest unread ping is
+ * one we haven't announced, or the same pile is still there a day later.
+ * Records that it spoke; any failure is silent — never slow or break a
+ * session start over a reminder.
+ */
+export declare function takeUnreadNotice(value: unknown, options?: {
+    dir?: string;
+    now?: number;
+}): string | null;

package/dist/unreadNotice.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNREAD_NOTICE_INTERVAL_MS = void 0;
+exports.parseUnreadPings = parseUnreadPings;
+exports.unreadNoticeLine = unreadNoticeLine;
+exports.takeUnreadNotice = takeUnreadNotice;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const configDir_1 = require("./configDir");
+/** Repeat an unchanged notice at most this often. A new ping always shows. */
+exports.UNREAD_NOTICE_INTERVAL_MS = 20 * 60 * 60 * 1000;
+const STATE_FILE = "unread-notice.json";
+function parseUnreadPings(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const v = value;
+    if (typeof v.count !== "number" || !Number.isFinite(v.count) || v.count <= 0)
+        return null;
+    return {
+        count: Math.floor(v.count),
+        newestPingId: typeof v.newestPingId === "string" ? v.newestPingId : null,
+        from: Array.isArray(v.from) ? v.from.filter((n) => typeof n === "string" && n.trim() !== "") : [],
+        senderCount: typeof v.senderCount === "number" ? v.senderCount : undefined,
+    };
+}
+function nameList(from, senderCount) {
+    if (from.length === 0)
+        return "";
+    const others = Math.max(0, senderCount - from.length);
+    const names = others > 0 ? [...from, `${others} other${others === 1 ? "" : "s"}`] : from;
+    if (names.length === 1)
+        return ` from ${names[0]}`;
+    return ` from ${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`;
+}
+/** The line added to the session's context. Written for the agent: it says
+ *  what is waiting and what to do about it. */
+function unreadNoticeLine(u) {
+    const who = nameList(u.from, u.senderCount ?? u.from.length);
+    return (`Codiedev: ${u.count} unread message${u.count === 1 ? "" : "s"}${who}. ` +
+        "Tell the user at the start of your first reply, and offer to show them with `codiedev inbox --unread`. " +
+        'Answer one with `codiedev reply <ping-id> "<message>"`.');
+}
+function readState(dir) {
+    try {
+        const raw = JSON.parse(fs_1.default.readFileSync(path_1.default.join(dir, STATE_FILE), "utf8"));
+        if (typeof raw?.at !== "number")
+            return null;
+        return { newestPingId: typeof raw.newestPingId === "string" ? raw.newestPingId : null, at: raw.at };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Returns the notice to print, or null. Shown when the newest unread ping is
+ * one we haven't announced, or the same pile is still there a day later.
+ * Records that it spoke; any failure is silent — never slow or break a
+ * session start over a reminder.
+ */
+function takeUnreadNotice(value, options = {}) {
+    try {
+        const unread = parseUnreadPings(value);
+        if (!unread)
+            return null;
+        const dir = options.dir ?? (0, configDir_1.codiedevStateDir)();
+        const now = options.now ?? Date.now();
+        const last = readState(dir);
+        const sameNewest = !!last && last.newestPingId === unread.newestPingId;
+        if (sameNewest && last.at <= now && now - last.at < exports.UNREAD_NOTICE_INTERVAL_MS)
+            return null;
+        fs_1.default.mkdirSync(dir, { recursive: true });
+        fs_1.default.writeFileSync(path_1.default.join(dir, STATE_FILE), JSON.stringify({ newestPingId: unread.newestPingId, at: now }));
+        return unreadNoticeLine(unread);
+    }
+    catch {
+        return null;
+    }
+}

package/dist/utils.js

@@ -1673,14 +1673,14 @@ thought, use the \`codiedev\` CLI via Bash:**
 | "push this spec" / "save this as a skill" | \`codiedev push <file.md>\` |
 | "pull X" / "grab the latest spec-X" / "what did a teammate push?" | \`codiedev pull <key>\` |
 | "delete X" / "remove that test push" / "rm spec-old" | \`codiedev delete <key>\` (always confirm with the user first) |
-| "ping a teammate about this" / "ask someone for their take" | \`codiedev ping <name> "<msg>" [--with <key>]\` |
+| "ping a teammate about this" / "ask someone for their take" / "send them this file" | \`codiedev ping <name> "<msg>" [--with <key>] [--file <path>]\` |
 | "any messages?" / "check my inbox" / "what did a teammate say?" | \`codiedev inbox\` |
 | "read that reply" / "mark that ping read" | \`codiedev read <ping-id>\` |
+| "reply to that" / "tell them X" (answering a message from \`codiedev inbox\`) | \`codiedev reply <ping-id> "<msg>" [--file <path>]\` (not a new ping: this threads it and marks theirs answered) |
 | "note that X is a follow-up" / "remember X" | \`codiedev note "<text>"\` |
 | "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>"]\` |
 | "find something about X" / "has anyone solved Y?" | \`codiedev search "<query>" [--limit N]\` |
-| "why did we…?" / "what does the team know about X?" | \`codiedev ask "<question>"\` (synthesized answer + citations) |
 | "show my library" / "what artifacts exist?" | \`codiedev library [--scope mine\\|shared\\|all] [--kind doc\\|skill]\` |
 | "run my agent's test cases" / "check the dataset on model Y" / "run v2 of the dataset" | \`codiedev traces cases <agent> [--dataset <name> [--version <n>]] [--model <id>]\` (writes cases + RUN_CASES.md + results.json; follow it, then \`codiedev traces report <results.json>\`) |
 | "how are my agents doing?" / "what's failing this week?" / "show the booking agent's failed runs" / "why did run X fail?" | \`codiedev traces overview\`; \`codiedev traces runs <agent> [--failed] [--flag <issue>] [--days n]\`; \`codiedev traces run <run> --agent <name>\` (add \`--json\` to read the data yourself) |
@@ -1695,9 +1695,10 @@ thought, use the \`codiedev\` CLI via Bash:**
 is classified into one of two kinds at upload time:
 
 - **skill** — the file has SKILL.md frontmatter (\`name:\` + \`description:\`
-  inside a \`---\` block). Lands under \`Artifacts → Skills tab\` and is
+  inside a \`---\` block). Shows on the Skills page in the portal and is
   invokable as a slash command (\`/<name>\`).
-- **doc** — everything else. Lands under \`Artifacts → My artifacts\`.
+- **doc** — everything else. Lives in the library: list it with
+  \`codiedev library\`, fetch it with \`codiedev pull <key>\`.
 
 Detection is content-based, not filename-based. The filename prefix
 (\`spec-\` / \`decision-\` / \`proposal-\` / \`bugfix-\` / \`review-\` /

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codiedev",
-  "version": "0.9.83",
+  "version": "0.9.85",
   "description": "Connect Claude Code, Codex, Cursor, OpenCode, or VS Code Copilot to Codiedev for team session capture and artifact collaboration — and run the governed Codie harness",
   "bin": {
     "codiedev": "dist/cli.js",

package/dist/commands/ask.d.ts

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

package/dist/commands/ask.js

@@ -1,58 +0,0 @@
-"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)();
-    const start = Date.now();
-    try {
-        const res = await (0, shared_1.apiRequest)("POST", "/api/cli/ask", {
-            config,
-            body: { question },
-        });
-        (0, shared_1.recordAgentEvent)(config, {
-            tool: "codiedev_ask",
-            ok: true,
-            latencyMs: Date.now() - start,
-        });
-        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) {
-        (0, shared_1.recordAgentEvent)(config, {
-            tool: "codiedev_ask",
-            ok: false,
-            latencyMs: Date.now() - start,
-            error: err.message,
-        });
-        console.error(`Ask failed: ${err.message}`);
-        process.exit(1);
-    }
-}