codiedev 0.8.1 → 0.9.0-beta.0

package/README.md

@@ -1,6 +1,6 @@
 # codiedev
 
-Connect Claude Code or Codex to CodieDev for org-wide session capture.
+Connect Claude Code or Codex to Codiedev for org-wide session capture.
 
 ## Usage
 

package/dist/cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * CodieDev CLI dispatcher.
+ * Codiedev CLI dispatcher.
  *
  * Subcommands:
  *   codiedev connect                   — link agent CLIs to your org

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * CodieDev CLI dispatcher.
+ * Codiedev CLI dispatcher.
  *
  * Subcommands:
  *   codiedev connect                   — link agent CLIs to your org
@@ -35,7 +35,7 @@ const send_1 = require("./commands/send");
 const react_1 = require("./commands/react");
 const version_1 = require("./version");
 const HELP = `
-CodieDev CLI
+Codiedev CLI
 
   The team artifact layer for agent-coded work. Share specs and reviews
   with teammates, get pinged when they need your input, pick up where
@@ -132,7 +132,7 @@ Docs:    codiedev docs
 `.trim();
 const COMMAND_HELP = {
     connect: `
-codiedev connect — link your agent CLI to CodieDev
+codiedev connect — link your agent CLI to Codiedev
 
   Interactive setup. Prompts for an API token, then installs:
     - ~/.codiedev/config.json            (token + org + tracked repos)
@@ -272,11 +272,11 @@ codiedev create-ticket — forward-write a scoped ticket plan
 `.trim(),
 };
 const DOCS = `
-CodieDev — usage guide
+Codiedev — usage guide
 
 ## What this is
 
-CodieDev is a team artifact layer on top of your coding agent (Claude
+Codiedev is a team artifact layer on top of your coding agent (Claude
 Code, Codex, etc.). It persists the *durable* outputs of agent work —
 specs, reviews, decisions, proposals, and captured thoughts — so:
 

package/dist/commands/createTicket.js

@@ -65,7 +65,7 @@ function resolveRepoIds(fullNames, repos) {
     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.`);
+            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);
     }

package/dist/commands/doctor.js

@@ -134,13 +134,13 @@ function hasGlabCli() {
 }
 async function runDoctor(_args) {
     const checks = [];
-    console.log("\nCodieDev doctor — checking your setup…\n");
+    console.log("\nCodiedev doctor — checking your setup…\n");
     await (0, upgradeNudge_1.maybePrintUpgradeNudge)();
     // 1. Config file
     const config = (0, utils_1.readConfig)();
     if (!config) {
         checks.push({
-            name: "CodieDev config (~/.codiedev/config.json)",
+            name: "Codiedev config (~/.codiedev/config.json)",
             status: "fail",
             detail: "Not found. Run `codiedev connect` first.",
         });
@@ -148,7 +148,7 @@ async function runDoctor(_args) {
         process.exit(1);
     }
     checks.push({
-        name: "CodieDev config",
+        name: "Codiedev config",
         status: "pass",
         detail: `connected to ${config.companyName}`,
     });

package/dist/commands/library.js

@@ -1,6 +1,6 @@
 "use strict";
 // `codiedev library [--scope mine|shared|all] [--kind doc|skill] [--tag X]
-// [--type spec|...] [--limit N]` — list artifacts in your CodieDev workspace.
+// [--type spec|...] [--limit N]` — list artifacts in your Codiedev workspace.
 // Server applies companyId scoping; --scope filters within that.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runLibrary = runLibrary;

package/dist/commands/shared.d.ts

@@ -8,12 +8,12 @@ import { CodiedevConfig } from "../utils";
  */
 export declare function applyConfigEnvOverrides(config: CodiedevConfig): CodiedevConfig;
 /**
- * Require a connected CodieDev config. Exits the process with a helpful
+ * Require a connected Codiedev config. Exits the process with a helpful
  * message if the user hasn't run `codiedev connect` yet.
  */
 export declare function requireConfig(): CodiedevConfig;
 /**
- * Perform an authenticated HTTP request against the CodieDev backend.
+ * Perform an authenticated HTTP request against the Codiedev backend.
  * Returns the parsed JSON response body. Throws on non-2xx.
  */
 export declare function apiRequest<T = unknown>(method: "GET" | "POST", path: string, options: {
@@ -33,6 +33,20 @@ export declare function recordAgentEvent(config: CodiedevConfig, event: {
     latencyMs: number;
     error?: string;
 }): void;
+/**
+ * Per-step install telemetry for `npx codiedev connect`. One row per phase
+ * (started, detect, install_target, validate_token, completed, failed) so
+ * the admin company page can show a timeline when a customer says "it says
+ * connected but it doesn't work." Fire-and-forget, never throws. Auto-stamps
+ * platform + node + cli version so call sites only need step/target/ok/error.
+ */
+export type InstallTelemetryStep = "started" | "detect" | "install_target" | "validate_token" | "completed" | "failed";
+export declare function recordInstallEvent(config: CodiedevConfig, event: {
+    step: InstallTelemetryStep;
+    target?: string;
+    ok: boolean;
+    error?: string;
+}): void;
 /**
  * Wraps a CLI subcommand body so success and failure both record telemetry
  * and the original error propagates after the event is queued. Use this in

package/dist/commands/shared.js

@@ -37,6 +37,7 @@ exports.applyConfigEnvOverrides = applyConfigEnvOverrides;
 exports.requireConfig = requireConfig;
 exports.apiRequest = apiRequest;
 exports.recordAgentEvent = recordAgentEvent;
+exports.recordInstallEvent = recordInstallEvent;
 exports.withTelemetry = withTelemetry;
 exports.timeAgo = timeAgo;
 exports.stripQuotes = stripQuotes;
@@ -60,7 +61,7 @@ function applyConfigEnvOverrides(config) {
     return config;
 }
 /**
- * Require a connected CodieDev config. Exits the process with a helpful
+ * Require a connected Codiedev config. Exits the process with a helpful
  * message if the user hasn't run `codiedev connect` yet.
  */
 function requireConfig() {
@@ -72,7 +73,7 @@ function requireConfig() {
     return applyConfigEnvOverrides(config);
 }
 /**
- * Perform an authenticated HTTP request against the CodieDev backend.
+ * Perform an authenticated HTTP request against the Codiedev backend.
  * Returns the parsed JSON response body. Throws on non-2xx.
  */
 function apiRequest(method, path, options) {
@@ -155,6 +156,22 @@ function recordAgentEvent(config, event) {
         // Swallow — telemetry must never affect user-facing flow.
     });
 }
+function recordInstallEvent(config, event) {
+    apiRequest("POST", "/api/telemetry/install-event", {
+        config,
+        body: {
+            step: event.step,
+            target: event.target,
+            ok: event.ok,
+            error: event.error,
+            platform: process.platform,
+            nodeVersion: process.version,
+            cliVersion: version_1.CLI_VERSION,
+        },
+    }).catch(() => {
+        // Swallow — telemetry must never affect connect flow.
+    });
+}
 /**
  * Wraps a CLI subcommand body so success and failure both record telemetry
  * and the original error propagates after the event is queued. Use this in

package/dist/connect.js

@@ -41,6 +41,7 @@ const utils_1 = require("./utils");
 const connectFlow_1 = require("./connectFlow");
 const version_1 = require("./version");
 const upgradeNudge_1 = require("./upgradeNudge");
+const shared_1 = require("./commands/shared");
 const BACKEND_URL = process.env.CODIEDEV_URL || "https://judicious-falcon-861.convex.site";
 /**
  * Reads a line from stdin without echoing the typed/pasted characters —
@@ -160,9 +161,9 @@ async function runConnect(args = []) {
     // mint a fresh token from the portal — which is what bit Sonifi's first
     // engineer when he interpreted "no visible token" as "the old one is gone".
     const force = args.includes("--force") || args.includes("-f");
-    console.log("\nWelcome to CodieDev CLI\n");
+    console.log("\nWelcome to Codiedev CLI\n");
     await (0, upgradeNudge_1.maybePrintUpgradeNudge)();
-    console.log("This will connect your coding agent to your CodieDev workspace and install");
+    console.log("This will connect your coding agent to your Codiedev workspace and install");
     console.log("the session capture hook for org-wide session sharing.\n");
     const saved = (0, utils_1.readConfig)();
     const decision = (0, connectFlow_1.resolveConnectToken)({ savedConfig: saved, force });
@@ -174,7 +175,7 @@ async function runConnect(args = []) {
     else {
         // Hidden prompt — masks the token with `*` as it's typed/pasted so it
         // doesn't end up in terminal scrollback or screenshots.
-        token = await promptHidden("Enter your CodieDev API token: ");
+        token = await promptHidden("Enter your Codiedev API token: ");
         if (!token) {
             console.error("Error: API token is required.");
             process.exit(1);
@@ -214,6 +215,11 @@ async function runConnect(args = []) {
         console.error(`\nError: Failed to save config — ${err.message}`);
         process.exit(1);
     }
+    // Once we have a valid token + config, every subsequent step posts a
+    // per-step row to /api/telemetry/install-event so the admin page can show
+    // a timeline when a customer says "it connected but it doesn't work."
+    // Fire-and-forget — never blocks the connect flow.
+    (0, shared_1.recordInstallEvent)(config, { step: "started", ok: true });
     // Migration: strip MCP server entries written by pre-CLI-only versions
     // of `codiedev connect`. These pointed at `npx codiedev-mcp`, a binary
     // that was removed in 0.3.4 and that 0.7.11+ no longer ships. Without
@@ -242,64 +248,46 @@ async function runConnect(args = []) {
     const hasClaude = (0, utils_1.claudeCodeInstalled)();
     const hasCodex = (0, utils_1.codexInstalled)();
     const hasCursor = (0, utils_1.cursorInstalled)();
+    (0, shared_1.recordInstallEvent)(config, { step: "detect", target: "claude-code", ok: hasClaude });
+    (0, shared_1.recordInstallEvent)(config, { step: "detect", target: "codex", ok: hasCodex });
+    (0, shared_1.recordInstallEvent)(config, { step: "detect", target: "cursor", ok: hasCursor });
     const installed = [];
     // Machine-readable target keys reported back to the backend via
     // /api/cli/markInstalled so the portal's "Connected" state reflects
     // what's actually wired up on this machine, not just "token validated."
     const installedTargets = [];
-    if (hasClaude) {
+    // Wrap each per-target write so we emit one install_target row each. The
+    // existing user-visible behavior (console.warn on failure, continue) is
+    // unchanged — telemetry just observes the outcome.
+    const runInstall = (target, fn, label, targetKey) => {
         try {
-            (0, utils_1.installHook)();
-            installed.push("Claude Code SessionEnd hook (~/.claude/settings.json)");
-            installedTargets.push("claudeCode-hook");
-        }
-        catch (err) {
-            console.error(`\nWarning: Failed to install Claude Code hook — ${err.message}`);
-        }
-        try {
-            (0, utils_1.installClaudeCodeInstructions)();
-            installed.push("Claude Code agent instructions (~/.claude/CLAUDE.md)");
-            installedTargets.push("claudeCode-instructions");
+            fn();
+            installed.push(label);
+            installedTargets.push(targetKey);
+            (0, shared_1.recordInstallEvent)(config, { step: "install_target", target, ok: true });
         }
         catch (err) {
-            console.error(`\nWarning: Failed to install Claude Code instructions — ${err.message}`);
+            const message = err.message;
+            console.error(`\nWarning: Failed to install ${label} — ${message}`);
+            (0, shared_1.recordInstallEvent)(config, {
+                step: "install_target",
+                target,
+                ok: false,
+                error: message?.slice(0, 500),
+            });
         }
+    };
+    if (hasClaude) {
+        runInstall("claude-code-hook", utils_1.installHook, "Claude Code SessionEnd hook (~/.claude/settings.json)", "claudeCode-hook");
+        runInstall("claude-code-instructions", utils_1.installClaudeCodeInstructions, "Claude Code agent instructions (~/.claude/CLAUDE.md)", "claudeCode-instructions");
     }
     if (hasCodex) {
-        try {
-            (0, utils_1.installCodexHook)();
-            installed.push("Codex Stop hook (~/.codex/hooks.json)");
-            installedTargets.push("codex-hook");
-        }
-        catch (err) {
-            console.error(`\nWarning: Failed to install Codex hook — ${err.message}`);
-        }
-        try {
-            (0, utils_1.installCodexInstructions)();
-            installed.push("Codex agent instructions (~/.codex/AGENTS.md)");
-            installedTargets.push("codex-instructions");
-        }
-        catch (err) {
-            console.error(`\nWarning: Failed to install Codex instructions — ${err.message}`);
-        }
+        runInstall("codex-hook", utils_1.installCodexHook, "Codex Stop hook (~/.codex/hooks.json)", "codex-hook");
+        runInstall("codex-instructions", utils_1.installCodexInstructions, "Codex agent instructions (~/.codex/AGENTS.md)", "codex-instructions");
     }
     if (hasCursor) {
-        try {
-            (0, utils_1.installCursorHook)();
-            installed.push("Cursor sessionEnd hook (~/.cursor/hooks.json)");
-            installedTargets.push("cursor-hook");
-        }
-        catch (err) {
-            console.error(`\nWarning: Failed to install Cursor hook — ${err.message}`);
-        }
-        try {
-            (0, utils_1.installCursorInstructions)();
-            installed.push("Cursor agent instructions (~/.cursor/rules/codiedev.mdc)");
-            installedTargets.push("cursor-instructions");
-        }
-        catch (err) {
-            console.error(`\nWarning: Failed to install Cursor instructions — ${err.message}`);
-        }
+        runInstall("cursor-hook", utils_1.installCursorHook, "Cursor sessionEnd hook (~/.cursor/hooks.json)", "cursor-hook");
+        runInstall("cursor-instructions", utils_1.installCursorInstructions, "Cursor agent instructions (~/.cursor/rules/codiedev.mdc)", "cursor-instructions");
     }
     // Tell the backend which targets we wired up so the portal's onboarding
     // card flips to "Connected" only when something actually installed —
@@ -310,10 +298,17 @@ async function runConnect(args = []) {
             await postJson(`${BACKEND_URL}/api/cli/markInstalled`, {
                 installedTargets,
             }, { Authorization: `Bearer ${token}` });
+            (0, shared_1.recordInstallEvent)(config, { step: "completed", ok: true });
         }
         catch (err) {
-            console.error(`\nWarning: Failed to report install to backend — ${err.message}`);
+            const message = err.message;
+            console.error(`\nWarning: Failed to report install to backend — ${message}`);
             console.error("Local install succeeded; portal may not reflect it until you re-run.");
+            (0, shared_1.recordInstallEvent)(config, {
+                step: "failed",
+                ok: false,
+                error: message?.slice(0, 500),
+            });
         }
     }
     if (!hasClaude && !hasCodex && !hasCursor) {

package/dist/hook.js

@@ -39,6 +39,66 @@ const https = __importStar(require("https"));
 const http = __importStar(require("http"));
 const utils_1 = require("./utils");
 const version_1 = require("./version");
+function getJson(url, bearerToken) {
+    return new Promise((resolve, reject) => {
+        const parsed = new URL(url);
+        const options = {
+            hostname: parsed.hostname,
+            port: parsed.port || (parsed.protocol === "https:" ? 443 : 80),
+            path: parsed.pathname + parsed.search,
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${bearerToken}`,
+                "X-Codiedev-Cli-Version": version_1.CLI_VERSION,
+            },
+        };
+        const lib = parsed.protocol === "https:" ? https : http;
+        const req = lib.request(options, (res) => {
+            let body = "";
+            res.on("data", (c) => (body += c));
+            res.on("end", () => {
+                try {
+                    resolve(JSON.parse(body));
+                }
+                catch {
+                    reject(new Error("bad json"));
+                }
+            });
+        });
+        req.on("error", reject);
+        req.end();
+    });
+}
+// UserPromptSubmit: query skill discovery for the prompt and, if a team skill
+// clears the confidence threshold, inject it as additionalContext so the agent
+// can offer to pull+run it. Fully silent on miss/error — never blocks input.
+async function runDiscover(prompt) {
+    if (!prompt || !prompt.trim())
+        process.exit(0);
+    const config = (0, utils_1.readConfig)();
+    if (!config)
+        process.exit(0);
+    try {
+        const res = await getJson(`${config.backendUrl}/api/cli/skill-discovery?q=${encodeURIComponent(prompt)}`, config.token);
+        const skills = res?.skills ?? [];
+        if (skills.length > 0) {
+            const lines = skills
+                .slice(0, 3)
+                .map((s) => `- ${s.key} — ${(s.score * 100).toFixed(0)}% match`)
+                .join("\n");
+            const additionalContext = "A CodieDev team skill may apply to this task:\n" +
+                lines +
+                "\nIf one fits, pull and use it before improvising: `codiedev pull <key>`.";
+            process.stdout.write(JSON.stringify({
+                hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext },
+            }));
+        }
+    }
+    catch {
+        // silent — discovery is best-effort
+    }
+    process.exit(0);
+}
 function postJson(url, body, bearerToken) {
     return new Promise((resolve, reject) => {
         const parsed = new URL(url);
@@ -94,7 +154,6 @@ function resolveMode(arg) {
     return "claude-code";
 }
 async function main() {
-    const mode = resolveMode(process.argv[2]);
     let hookInput = {};
     try {
         const raw = await readStdin();
@@ -105,6 +164,15 @@ async function main() {
     catch {
         process.exit(0);
     }
+    // UserPromptSubmit discovery path — separate from session capture.
+    if (process.argv[2] === "discover") {
+        await runDiscover(hookInput.prompt);
+        return;
+    }
+    const mode = resolveMode(process.argv[2]);
+    // Self-heal: a user who upgraded the CLI but hasn't re-run `connect` gets the
+    // discovery hook wired on their next SessionEnd, without re-connecting.
+    (0, utils_1.ensureDiscoveryHookInstalled)();
     const { session_id, transcript_path, cwd, workspace_roots } = hookInput;
     const workspaceRoot = workspace_roots && workspace_roots.length > 0
         ? workspace_roots[0]

package/dist/mcp.d.ts

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 /**
- * CodieDev MCP server.
+ * Codiedev MCP server.
  *
- * Exposes the CodieDev artifact-collaboration surface as Model Context
+ * Exposes the Codiedev artifact-collaboration surface as Model Context
  * Protocol tools so Claude Code / Codex / any MCP-capable agent can invoke
  * them natively from natural language (e.g. "push the spec we just worked on").
  *

package/dist/mcp.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * CodieDev MCP server.
+ * Codiedev MCP server.
  *
- * Exposes the CodieDev artifact-collaboration surface as Model Context
+ * Exposes the Codiedev artifact-collaboration surface as Model Context
  * Protocol tools so Claude Code / Codex / any MCP-capable agent can invoke
  * them natively from natural language (e.g. "push the spec we just worked on").
  *
@@ -70,7 +70,7 @@ const PKG_VERSION = (() => {
 const TOOLS = [
     {
         name: "codiedev_push",
-        description: "Push any markdown artifact (doc or skill) to the team's CodieDev " +
+        description: "Push any markdown artifact (doc or skill) to the team's Codiedev " +
             "artifact layer so teammates can see, discuss, and run it. Works for " +
             "specs, decisions, proposals, bugfixes, reviews, notes, AND " +
             "Claude Code / Codex skills (files with SKILL.md frontmatter — " +
@@ -127,7 +127,7 @@ const TOOLS = [
     },
     {
         name: "codiedev_pull",
-        description: "Fetch any artifact (doc or skill) from the team's CodieDev artifact " +
+        description: "Fetch any artifact (doc or skill) from the team's Codiedev artifact " +
             "layer. Works for specs, decisions, proposals, bugfixes, reviews, " +
             "notes, AND skills (SKILL.md frontmatter files surfaced as slash " +
             "commands). Use when the user asks to pull, grab, fetch, or resume " +
@@ -171,7 +171,7 @@ const TOOLS = [
     },
     {
         name: "codiedev_ping",
-        description: "Send a message to a teammate on CodieDev, optionally attached to a " +
+        description: "Send a message to a teammate on Codiedev, optionally attached to a " +
             "specific artifact. Use when the user asks to ping, ask, share with, " +
             "or get feedback from a teammate by name (e.g. 'ping a teammate about " +
             "this spec'). Recipients are resolved by first name, full name, or email " +
@@ -200,7 +200,7 @@ const TOOLS = [
     },
     {
         name: "codiedev_inbox",
-        description: "Check the user's CodieDev inbox for messages from teammates. Use " +
+        description: "Check the user's Codiedev inbox for messages from teammates. Use " +
             "when the user asks 'any messages?', 'what did [name] say?', 'check " +
             "my inbox', or when they open a session and want to catch up on " +
             "what's waiting for them. Returns a list with sender, subject " +
@@ -224,7 +224,7 @@ const TOOLS = [
         description: "Capture a passing thought and link it to the current agent session. " +
             "Use when the user says 'note that', 'remember', 'worth capturing', " +
             "'jot this down', or drops a short observation that isn't a full " +
-            "spec. Notes show up in the user's CodieDev memory feed.",
+            "spec. Notes show up in the user's Codiedev memory feed.",
         inputSchema: {
             type: "object",
             properties: {
@@ -238,7 +238,7 @@ const TOOLS = [
     },
     {
         name: "codiedev_promote",
-        description: "Promote an auto-extracted CodieDev artifact (spec/bugfix/decision " +
+        description: "Promote an auto-extracted Codiedev artifact (spec/bugfix/decision " +
             "produced by the session-capture pipeline) to an authored artifact " +
             "so teammates can collaborate on it. Use when the user says 'publish " +
             "the extracted spec', 'promote this', or 'make the auto-extracted X " +
@@ -248,7 +248,7 @@ const TOOLS = [
             properties: {
                 artifactId: {
                     type: "string",
-                    description: "The extracted artifact's id from CodieDev.",
+                    description: "The extracted artifact's id from Codiedev.",
                 },
                 keyOverride: {
                     type: "string",
@@ -545,7 +545,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             content: [
                 {
                     type: "text",
-                    text: "CodieDev is not connected on this machine. Ask the user to run " +
+                    text: "Codiedev is not connected on this machine. Ask the user to run " +
                         "`npx codiedev connect` with an API token from " +
                         "https://codiedev.com/portal/integrations/claude-code.",
                 },
@@ -579,7 +579,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             content: [
                 {
                     type: "text",
-                    text: `CodieDev error: ${err.message}`,
+                    text: `Codiedev error: ${err.message}`,
                 },
             ],
         };

package/dist/utils.d.ts

@@ -33,24 +33,26 @@ export declare function cursorInstalled(): boolean;
  * the presence of any `github.copilot*` directory as the Copilot fingerprint.
  */
 export declare function vscodeCopilotInstalled(): boolean;
+export declare function upsertCodiedevHook(hooks: Record<string, unknown>, eventName: string, subcommand: string): void;
 export declare function installHook(): void;
+export declare function ensureDiscoveryHookInstalled(): void;
 export declare function installClaudeCodeInstructions(): void;
 export declare function installCodexInstructions(): void;
 export declare function installCursorInstructions(): void;
 /**
- * Install the CodieDev MCP server into Claude Code's user-scope config.
+ * Install the Codiedev MCP server into Claude Code's user-scope config.
  * Safe to call multiple times — updates the existing entry if present.
  */
 export declare function installClaudeCodeMcp(): void;
 /**
- * Install the CodieDev MCP server into Cursor's user-scope config.
+ * Install the Codiedev MCP server into Cursor's user-scope config.
  * Cursor uses the same `mcpServers` schema as Claude Code; just a different
  * file path (~/.cursor/mcp.json). Project-scoped servers can also live at
  * <project>/.cursor/mcp.json — we only manage the user-scope one.
  */
 export declare function installCursorMcp(): void;
 /**
- * Install the CodieDev MCP server into VS Code's user-scope MCP config so
+ * Install the Codiedev MCP server into VS Code's user-scope MCP config so
  * GitHub Copilot Chat picks it up. VS Code uses a different schema than
  * Claude / Cursor: top-level key is `servers` (not `mcpServers`). On first
  * Copilot Chat run after install, VS Code prompts the user to trust the
@@ -84,7 +86,7 @@ export declare function cleanupVSCodeMcp(): void;
  */
 export declare function cleanupCodexMcp(): void;
 /**
- * Best-effort append of the CodieDev MCP server block to ~/.codex/config.toml.
+ * Best-effort append of the Codiedev MCP server block to ~/.codex/config.toml.
  *
  * Codex uses TOML and we don't want a full parser for such a small addition,
  * so we append a well-marked block if one isn't already present. Idempotent.

package/dist/utils.js

@@ -43,7 +43,9 @@ exports.claudeCodeInstalled = claudeCodeInstalled;
 exports.codexInstalled = codexInstalled;
 exports.cursorInstalled = cursorInstalled;
 exports.vscodeCopilotInstalled = vscodeCopilotInstalled;
+exports.upsertCodiedevHook = upsertCodiedevHook;
 exports.installHook = installHook;
+exports.ensureDiscoveryHookInstalled = ensureDiscoveryHookInstalled;
 exports.installClaudeCodeInstructions = installClaudeCodeInstructions;
 exports.installCodexInstructions = installCodexInstructions;
 exports.installCursorInstructions = installCursorInstructions;
@@ -230,6 +232,27 @@ function vscodeCopilotInstalled() {
         return false;
     }
 }
+// Idempotently put a single codiedev hook (matcher ".*", running our hook.js
+// with `subcommand`) into the given hook event, stripping any prior codiedev
+// entries first so connect re-runs / upgrades refresh the resolved binary path.
+// Mutates `hooks` in place. Exported for unit testing.
+function upsertCodiedevHook(hooks, eventName, subcommand) {
+    if (!hooks[eventName])
+        hooks[eventName] = [];
+    const existing = hooks[eventName];
+    const filtered = existing.filter((hook) => {
+        const inner = hook.hooks;
+        if (Array.isArray(inner)) {
+            return !inner.some((h) => (0, detection_1.isCodiedevHookCommand)(h.command));
+        }
+        return !(0, detection_1.isCodiedevHookCommand)(hook.matcher);
+    });
+    filtered.push({
+        matcher: ".*",
+        hooks: [{ type: "command", command: resolveHookCommand(subcommand) }],
+    });
+    hooks[eventName] = filtered;
+}
 function installHook() {
     let settings = {};
     try {
@@ -245,35 +268,42 @@ function installHook() {
         settings.hooks = {};
     }
     const hooks = settings.hooks;
-    if (!hooks.SessionEnd) {
-        hooks.SessionEnd = [];
-    }
-    // Drop any prior codiedev entries (legacy `npx` form or older absolute
-    // paths) before re-adding so connect re-runs upgrade the resolved binary
-    // path instead of leaving stale entries behind.
-    const existing = hooks.SessionEnd;
-    const filtered = existing.filter((hook) => {
-        const inner = hook.hooks;
-        if (Array.isArray(inner)) {
-            return !inner.some((h) => (0, detection_1.isCodiedevHookCommand)(h.command));
-        }
-        return !(0, detection_1.isCodiedevHookCommand)(hook.matcher);
-    });
-    filtered.push({
-        matcher: ".*",
-        hooks: [
-            {
-                type: "command",
-                command: resolveHookCommand("capture"),
-            },
-        ],
-    });
-    hooks.SessionEnd = filtered;
+    // SessionEnd → capture (upload the finished session for the team library).
+    upsertCodiedevHook(hooks, "SessionEnd", "capture");
+    // UserPromptSubmit → discover (surface a matching team skill for the task).
+    upsertCodiedevHook(hooks, "UserPromptSubmit", "discover");
     if (!fs.existsSync(CLAUDE_DIR)) {
         fs.mkdirSync(CLAUDE_DIR, { recursive: true });
     }
     fs.writeFileSync(CLAUDE_SETTINGS_PATH, JSON.stringify(settings, null, 2), "utf8");
 }
+// Self-heal: ensure the discovery (UserPromptSubmit) hook is present without a
+// full `connect` re-run. Called from the capture hook on SessionEnd, so a user
+// who upgrades the CLI gets the new hook wired on their next session. Only
+// writes when missing, to avoid churning settings.json every run.
+function ensureDiscoveryHookInstalled() {
+    try {
+        if (!fs.existsSync(CLAUDE_SETTINGS_PATH))
+            return; // not a Claude Code user
+        const raw = fs.readFileSync(CLAUDE_SETTINGS_PATH, "utf8");
+        const settings = JSON.parse(raw);
+        const hooks = (settings.hooks ?? {});
+        const ups = (hooks.UserPromptSubmit ?? []);
+        const present = ups.some((hook) => {
+            const inner = hook.hooks;
+            return (Array.isArray(inner) &&
+                inner.some((h) => (0, detection_1.isCodiedevHookCommand)(h.command)));
+        });
+        if (present)
+            return;
+        settings.hooks = hooks;
+        upsertCodiedevHook(hooks, "UserPromptSubmit", "discover");
+        fs.writeFileSync(CLAUDE_SETTINGS_PATH, JSON.stringify(settings, null, 2), "utf8");
+    }
+    catch {
+        // Best-effort — never block a session on self-heal.
+    }
+}
 // ─────────────────────────────────────────────────────────────────────────────
 // MCP server installation — writes the codiedev MCP server config into each
 // agent CLI's expected location so "npx codiedev connect" wires it up once.
@@ -284,9 +314,9 @@ const CODEX_USER_INSTRUCTIONS_PATH = path.join(os.homedir(), ".codex", "AGENTS.m
 const CODEX_CONFIG_PATH = path.join(os.homedir(), ".codex", "config.toml");
 const CODIEDEV_INSTRUCTIONS_BEGIN = "<!-- codiedev-cli:begin -->";
 const CODIEDEV_INSTRUCTIONS_END = "<!-- codiedev-cli:end -->";
-const CODIEDEV_INSTRUCTIONS_BODY = `## CodieDev — team artifact layer
+const CODIEDEV_INSTRUCTIONS_BODY = `## Codiedev — team artifact layer
 
-This machine is connected to CodieDev. Teammates share specs, reviews,
+This machine is connected to Codiedev. Teammates share specs, reviews,
 decisions, and messages via a CLI on every dev's machine.
 
 **When the user asks to share, push, ping, check messages, or capture a
@@ -426,7 +456,7 @@ function installCodexInstructions() {
 // Cursor uses .mdc rule files with YAML frontmatter (description, alwaysApply,
 // globs). `.cursorrules` is deprecated and ignored by Agent mode as of 2026.
 const CURSOR_INSTRUCTIONS_FRONTMATTER = `---
-description: CodieDev team artifact layer — push, pull, search, ping, and share artifacts with teammates
+description: Codiedev team artifact layer — push, pull, search, ping, and share artifacts with teammates
 alwaysApply: true
 ---
 
@@ -483,7 +513,7 @@ function readMcpConfigSafely(path) {
     }
 }
 /**
- * Install the CodieDev MCP server into Claude Code's user-scope config.
+ * Install the Codiedev MCP server into Claude Code's user-scope config.
  * Safe to call multiple times — updates the existing entry if present.
  */
 function installClaudeCodeMcp() {
@@ -499,7 +529,7 @@ function installClaudeCodeMcp() {
     fs.writeFileSync(CLAUDE_USER_CONFIG_PATH, JSON.stringify(config, null, 2), "utf8");
 }
 /**
- * Install the CodieDev MCP server into Cursor's user-scope config.
+ * Install the Codiedev MCP server into Cursor's user-scope config.
  * Cursor uses the same `mcpServers` schema as Claude Code; just a different
  * file path (~/.cursor/mcp.json). Project-scoped servers can also live at
  * <project>/.cursor/mcp.json — we only manage the user-scope one.
@@ -520,7 +550,7 @@ function installCursorMcp() {
     fs.writeFileSync(CURSOR_MCP_PATH, JSON.stringify(config, null, 2), "utf8");
 }
 /**
- * Install the CodieDev MCP server into VS Code's user-scope MCP config so
+ * Install the Codiedev MCP server into VS Code's user-scope MCP config so
  * GitHub Copilot Chat picks it up. VS Code uses a different schema than
  * Claude / Cursor: top-level key is `servers` (not `mcpServers`). On first
  * Copilot Chat run after install, VS Code prompts the user to trust the
@@ -635,7 +665,7 @@ function cleanupCodexMcp() {
     fs.writeFileSync(CODEX_CONFIG_PATH, out.join("\n"), "utf8");
 }
 /**
- * Best-effort append of the CodieDev MCP server block to ~/.codex/config.toml.
+ * Best-effort append of the Codiedev MCP server block to ~/.codex/config.toml.
  *
  * Codex uses TOML and we don't want a full parser for such a small addition,
  * so we append a well-marked block if one isn't already present. Idempotent.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "codiedev",
-  "version": "0.8.1",
-  "description": "Connect Claude Code, Codex, Cursor, or VS Code Copilot to CodieDev for org-wide session capture and artifact collaboration",
+  "version": "0.9.0-beta.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",
     "codiedev-hook": "dist/hook.js"