techprufer-mcp 0.2.0 → 0.4.0

package/README.md

@@ -12,37 +12,40 @@ One command does everything:
 npx techprufer-mcp login
 ```
 
-This runs two steps:
+1. **Pick AI tools** — interactive picker (nothing selected by default; `Space` to toggle, `Enter` when ready).
+2. **Device-code login** — opens your browser to approve the device. Agents can read `TECHPRUFER_LOGIN_URL` / `TECHPRUFER_LOGIN_CODE` from the output.
 
-1. **Configure AI tools** — an interactive picker (arrow keys, `Space` to toggle, `a` for all, `Enter` to confirm). Tools that already have the server show `(refresh)` and are pre-selected.
-2. **Device-code login** — opens your browser to approve the device. If the browser doesn't open, paste the printed link manually; the CLI keeps waiting and re-shows the link after 30 seconds.
+Use `--no-setup` to skip the picker and login only. Restart your AI tools after login so they pick up the server.
 
-Use `--no-setup` to skip the picker and login only. Restart your AI tools after setup so they pick up the server.
-
-## Commands
+### Agent-driven login (non-TTY)
 
 ```bash
-npx techprufer-mcp              # Start stdio MCP server (what AI tools run)
-npx techprufer-mcp login        # Configure tools, then device-code login
-npx techprufer-mcp setup        # Configure tools only (no login)
-npx techprufer-mcp status       # Show saved credentials
+npx -y techprufer-mcp login --tools=cursor,codex --timeout 300
 ```
 
-### Setup options (non-interactive)
+If stdin is not a TTY and you omit `--tools`, config is skipped and login still runs (no crash).
+
+## Commands
 
 ```bash
-npx techprufer-mcp setup --all
-npx techprufer-mcp setup --tools=cursor,claude-code,codex
-npx techprufer-mcp setup --print --tools=antigravity   # print snippets, write nothing
+npx techprufer-mcp              # Start stdio MCP server (what AI tools run)
+npx techprufer-mcp login        # Pick tools, configure, then device-code login
+npx techprufer-mcp status       # Show saved credentials
 ```
 
 ### Login options
 
 ```bash
-npx techprufer-mcp login --name "Work laptop"   # device name shown on the site
-npx techprufer-mcp login --no-setup             # skip the tool picker
+npx techprufer-mcp login --tools=cursor,claude-code,codex
+npx techprufer-mcp login --all
+npx techprufer-mcp login --print --tools=antigravity   # print snippets only
+npx techprufer-mcp login --name "Work laptop"
+npx techprufer-mcp login --no-setup                    # login only
+npx techprufer-mcp login --timeout 300                 # agent-run safety
 ```
 
+`setup` remains as a deprecated alias of the configure step.
+
 ## Supported tools
 
 | Id | Tool | Config written |
@@ -51,9 +54,9 @@ npx techprufer-mcp login --no-setup             # skip the tool picker
 | `claude` | Claude Desktop | `claude_desktop_config.json` (per-OS path) |
 | `claude-code` | Claude Code | `~/.claude.json` (user scope) |
 | `antigravity` | Antigravity | `~/.gemini/…/mcp_config.json` |
-| `codex` | Codex | `~/.codex/config.toml` |
+| `codex` | Codex | `~/.codex/config.toml` + `~/.codex/prompts/techprufer-*.md` |
 
-Setup merges into existing config files — other MCP servers are preserved. The server key **must** be `techprufer` so slash commands are `/techprufer/…`.
+Setup merges into existing config files — other MCP servers are preserved. The server key **must** be `techprufer`.
 
 ## Manual JSON (any mcpServers client)
 
@@ -68,14 +71,16 @@ Setup merges into existing config files — other MCP servers are preserved. The
 }
 ```
 
-## Slash commands
+## Slash commands (per tool)
 
-Type `/techprufer` in your AI tool to list:
+| Tool | Tailor | Build profile |
+|------|--------|---------------|
+| Cursor | `/techprufer/tailor` | `/techprufer/build-profile` |
+| Claude Code | `/mcp__techprufer__tailor` | `/mcp__techprufer__build-profile` |
+| Codex | `/techprufer-tailor` | `/techprufer-build-profile` |
+| Claude Desktop | `+` menu → techprufer prompts | same |
 
-| Command | Use |
-|---------|-----|
-| `/techprufer/tailor` | Process queued tailor jobs from the site |
-| `/techprufer/build-profile` | Process queued PDF→profile jobs, or build from a local resume |
+**Tailor (one command)** handles: pending jobs (process or skip) → company picker (tracked apps, incl. untailored) → enqueue + process → show job link + PDF → optional attach to other roles at the same company → edit/delete when asked.
 
 > Cursor may show `/user-techprufer/…` for user-scoped installs; same commands.
 

package/dist/api.d.ts

@@ -1,8 +1,11 @@
+import { type ClientInfo } from './clientHeader.js';
 export declare class ApiError extends Error {
     status: number;
     body: unknown;
     constructor(status: number, body: unknown, message?: string);
 }
+export declare function setActiveClientInfo(info: ClientInfo | null): void;
+export declare function getActiveClientInfo(): ClientInfo | null;
 export declare function apiFetch<T>(path: string, init?: RequestInit & {
     token?: string | null;
     baseUrl?: string;

package/dist/api.js

@@ -1,4 +1,5 @@
 import { getApiUrl, loadCredentials } from './config.js';
+import { formatClientHeader, TP_CLIENT_HEADER } from './clientHeader.js';
 export class ApiError extends Error {
     status;
     body;
@@ -19,6 +20,14 @@ function formatFetchError(err) {
         return cause;
     return err.message;
 }
+/** Set by the stdio server after the MCP initialize handshake. */
+let activeClientInfo = null;
+export function setActiveClientInfo(info) {
+    activeClientInfo = info;
+}
+export function getActiveClientInfo() {
+    return activeClientInfo;
+}
 export async function apiFetch(path, init = {}) {
     const creds = loadCredentials();
     const token = init.token === undefined ? creds?.token : init.token;
@@ -36,6 +45,9 @@ export async function apiFetch(path, init = {}) {
     }
     if (token)
         headers.set('Authorization', `Bearer ${token}`);
+    const clientHeader = formatClientHeader(activeClientInfo);
+    if (clientHeader)
+        headers.set(TP_CLIENT_HEADER, clientHeader);
     let res;
     try {
         res = await fetch(`${base}${path}`, { ...fetchInit, headers });

package/dist/cli.js

@@ -14,20 +14,65 @@ function parseFlagValue(args, name) {
 function hasFlag(args, name) {
     return args.includes(name);
 }
+function assertSupportedNode() {
+    const major = Number.parseInt(process.versions.node.split('.')[0] ?? '', 10);
+    if (Number.isFinite(major) && major >= 18)
+        return;
+    console.error(`techprufer-mcp requires Node.js 18+ (got v${process.versions.node}).\n` +
+        `Headers/fetch are not available on older Node — upgrade Node, then retry:\n` +
+        `  npx techprufer-mcp@latest login`);
+    process.exit(1);
+}
+function parseTimeoutSec(args) {
+    const raw = parseFlagValue(args, '--timeout');
+    if (!raw)
+        return undefined;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n <= 0) {
+        console.error('--timeout must be a positive number of seconds');
+        process.exit(1);
+    }
+    return Math.floor(n);
+}
+function parseToolsFlag(args) {
+    const toolsRaw = parseFlagValue(args, '--tools');
+    if (!toolsRaw)
+        return undefined;
+    return toolsRaw.split(',').map((s) => s.trim()).filter(Boolean);
+}
 async function main() {
+    assertSupportedNode();
     const args = process.argv.slice(2);
     const cmd = args[0];
     if (cmd === 'login') {
         const nameIdx = args.indexOf('--name');
         const deviceName = nameIdx >= 0 ? args[nameIdx + 1] : undefined;
         const skipSetup = hasFlag(args, '--no-setup');
+        const timeoutSec = parseTimeoutSec(args);
+        const tools = parseToolsFlag(args);
+        let configuredIds = [];
         if (!skipSetup) {
-            await runSetup({ beforeLogin: true });
+            const outcome = await runSetup({
+                beforeLogin: true,
+                allowSkip: true,
+                all: hasFlag(args, '--all'),
+                tools,
+                printOnly: hasFlag(args, '--print'),
+                yes: hasFlag(args, '-y') || hasFlag(args, '--yes'),
+            });
+            configuredIds = outcome.configuredIds;
+            if (hasFlag(args, '--print'))
+                return;
             console.error('');
         }
-        await runLogin(deviceName, skipSetup ? {} : { stepLabel: 'step 2/2 · login' });
+        await runLogin(deviceName, {
+            stepLabel: skipSetup ? undefined : 'login',
+            timeoutSec,
+            configuredIds,
+        });
         return;
     }
+    // Deprecated alias — prefer `login` (which includes tool config).
     if (cmd === 'setup') {
         const toolsRaw = parseFlagValue(args, '--tools');
         await runSetup({
@@ -57,25 +102,26 @@ async function main() {
 
 Usage:
   npx techprufer-mcp              Start stdio MCP server (for AI tools)
-  npx techprufer-mcp login        Pick AI tools to configure, then device-code login
-  npx techprufer-mcp setup        Configure AI tools only (no login)
+  npx techprufer-mcp login        Pick AI tools, configure, then device-code login
   npx techprufer-mcp status       Show saved credentials
 
-Setup options:
-  --tools=id,id   Non-interactive: comma-separated tool ids
+Login options:
+  --tools=id,id   Configure these tools (non-interactive; comma-separated)
   --all           Configure every supported tool
-  --print         Print config snippets only (no file writes)
+  --print         Print config snippets only (no file writes / no login)
   -y, --yes       Require --tools or --all (no prompts)
+  --name <label>  Device name shown on the site
+  --no-setup      Skip the tool picker; login only
+  --timeout <sec> Fail login poll after N seconds (agent-run safety)
 
 Supported tools:
 ${listToolsForHelp()}
 
-Login options:
-  --name <label>  Device name shown on the site
-  --no-setup      Skip the tool picker; login only
-
 Env:
   TECHPRUFER_API_URL              Override API base (default https://techprufer.com)
+
+Deprecated:
+  npx techprufer-mcp setup        Alias — use login instead
 `);
         return;
     }

package/dist/clientHeader.d.ts

@@ -0,0 +1,10 @@
+/** Header the stdio server sends so the site can label agent_devices by IDE. */
+export declare const TP_CLIENT_HEADER = "X-TP-Client";
+export interface ClientInfo {
+    name: string;
+    version?: string;
+}
+/** Format `name/version` for the header (version optional). */
+export declare function formatClientHeader(info: ClientInfo | null | undefined): string | null;
+/** Parse `name/version` from the request header. */
+export declare function parseClientHeader(raw: string | null | undefined): ClientInfo | null;

package/dist/clientHeader.js

@@ -0,0 +1,23 @@
+/** Header the stdio server sends so the site can label agent_devices by IDE. */
+export const TP_CLIENT_HEADER = 'X-TP-Client';
+/** Format `name/version` for the header (version optional). */
+export function formatClientHeader(info) {
+    if (!info?.name?.trim())
+        return null;
+    const name = info.name.trim().slice(0, 64);
+    const version = info.version?.trim().slice(0, 64);
+    return version ? `${name}/${version}` : name;
+}
+/** Parse `name/version` from the request header. */
+export function parseClientHeader(raw) {
+    if (!raw?.trim())
+        return null;
+    const value = raw.trim().slice(0, 130);
+    const slash = value.indexOf('/');
+    if (slash <= 0)
+        return { name: value };
+    return {
+        name: value.slice(0, slash),
+        version: value.slice(slash + 1) || undefined,
+    };
+}

package/dist/commands.d.ts

@@ -0,0 +1,17 @@
+import type { AiToolId } from './tools.js';
+/** Canonical Cursor / generic slash paths (server key must be `techprufer`). */
+export declare const MCP_CMD_TAILOR = "/techprufer/tailor";
+export declare const MCP_CMD_BUILD_PROFILE = "/techprufer/build-profile";
+export interface ToolCommands {
+    tailor: string;
+    buildProfile: string;
+    /** Short note when the tool has no typed slash command. */
+    hint?: string;
+}
+/**
+ * How to invoke TechPrufer prompts in each client after MCP is connected.
+ * Codex uses custom prompt files written during setup (not MCP prompts).
+ * Edit/delete/list flows live under tailor — there is no separate edit command.
+ */
+export declare const TOOL_COMMANDS: Record<AiToolId, ToolCommands>;
+export declare function formatCommandsForTools(ids: AiToolId[]): string;

package/dist/commands.js

@@ -0,0 +1,54 @@
+/** Canonical Cursor / generic slash paths (server key must be `techprufer`). */
+export const MCP_CMD_TAILOR = '/techprufer/tailor';
+export const MCP_CMD_BUILD_PROFILE = '/techprufer/build-profile';
+/**
+ * How to invoke TechPrufer prompts in each client after MCP is connected.
+ * Codex uses custom prompt files written during setup (not MCP prompts).
+ * Edit/delete/list flows live under tailor — there is no separate edit command.
+ */
+export const TOOL_COMMANDS = {
+    cursor: {
+        tailor: MCP_CMD_TAILOR,
+        buildProfile: MCP_CMD_BUILD_PROFILE,
+    },
+    'claude-code': {
+        tailor: '/mcp__techprufer__tailor',
+        buildProfile: '/mcp__techprufer__build-profile',
+    },
+    claude: {
+        tailor: 'techprufer → tailor',
+        buildProfile: 'techprufer → build-profile',
+        hint: 'Open the + attachments menu and pick the techprufer prompts.',
+    },
+    codex: {
+        tailor: '/techprufer-tailor',
+        buildProfile: '/techprufer-build-profile',
+    },
+    antigravity: {
+        tailor: MCP_CMD_TAILOR,
+        buildProfile: MCP_CMD_BUILD_PROFILE,
+    },
+};
+export function formatCommandsForTools(ids) {
+    if (ids.length === 0) {
+        return [
+            'After restarting your AI tool, run:',
+            `  ${MCP_CMD_TAILOR}  (pending jobs, edit/delete, or pick a company resume)`,
+            `  ${MCP_CMD_BUILD_PROFILE}`,
+        ].join('\n');
+    }
+    const lines = ['After restarting your AI tool(s), use:'];
+    for (const id of ids) {
+        const cmds = TOOL_COMMANDS[id];
+        const label = id === 'claude-code' ? 'Claude Code' : id === 'claude' ? 'Claude Desktop' : id;
+        lines.push(`  ${label}:`);
+        if (cmds.hint) {
+            lines.push(`    ${cmds.hint}`);
+        }
+        else {
+            lines.push(`    ${cmds.tailor}`);
+            lines.push(`    ${cmds.buildProfile}`);
+        }
+    }
+    return lines.join('\n');
+}

package/dist/login.d.ts

@@ -1,3 +1,4 @@
+import type { AiToolId } from './tools.js';
 /** Exported for tests — resolve platform-specific open command. */
 export declare function browserOpenArgs(url: string, os?: NodeJS.Platform): {
     command: string;
@@ -6,6 +7,11 @@ export declare function browserOpenArgs(url: string, os?: NodeJS.Platform): {
         windowsHide?: boolean;
     };
 };
-export declare function runLogin(deviceName?: string, opts?: {
+export interface LoginOptions {
     stepLabel?: string;
-}): Promise<void>;
+    /** Hard deadline in seconds (agent-run safety). Default: device-code expiry. */
+    timeoutSec?: number;
+    /** Tools configured in this session — used for post-login slash-command hints. */
+    configuredIds?: AiToolId[];
+}
+export declare function runLogin(deviceName?: string, opts?: LoginOptions): Promise<void>;

package/dist/login.js

@@ -2,6 +2,7 @@ import { spawn } from 'child_process';
 import { platform } from 'os';
 import { apiFetch } from './api.js';
 import { getApiUrl, saveCredentials } from './config.js';
+import { formatCommandsForTools } from './commands.js';
 /** Exported for tests — resolve platform-specific open command. */
 export function browserOpenArgs(url, os = platform()) {
     if (os === 'darwin')
@@ -61,6 +62,8 @@ function alignVerifyUrl(verifyUrl, apiUrl) {
 export async function runLogin(deviceName, opts = {}) {
     const apiUrl = getApiUrl();
     console.error(`TechPrufer MCP${opts.stepLabel ? ` — ${opts.stepLabel}` : ''} — logging in against ${apiUrl}`);
+    console.error('');
+    console.error('Login phase: open the link below and approve this device in your browser.');
     const start = await apiFetch('/api/agent/device/start', {
         method: 'POST',
         token: null,
@@ -68,6 +71,9 @@ export async function runLogin(deviceName, opts = {}) {
         body: JSON.stringify({ deviceName: deviceName || undefined }),
     });
     const verifyUrl = alignVerifyUrl(start.verifyUrl, apiUrl);
+    // Machine-readable lines for agents driving the terminal.
+    console.error(`TECHPRUFER_LOGIN_URL=${verifyUrl}`);
+    console.error(`TECHPRUFER_LOGIN_CODE=${start.userCode}`);
     console.error('');
     console.error(`  Code:  ${start.userCode}`);
     console.error(`  Open:  ${verifyUrl}`);
@@ -76,7 +82,11 @@ export async function runLogin(deviceName, opts = {}) {
     console.error('Waiting for approval (Ctrl+C to cancel)…');
     openBrowser(verifyUrl);
     const intervalMs = Math.max(3, start.interval || 5) * 1000;
-    const deadline = Date.now() + start.expiresIn * 1000;
+    const deviceDeadline = Date.now() + start.expiresIn * 1000;
+    const timeoutDeadline = opts.timeoutSec && opts.timeoutSec > 0
+        ? Date.now() + opts.timeoutSec * 1000
+        : deviceDeadline;
+    const deadline = Math.min(deviceDeadline, timeoutDeadline);
     const startedAt = Date.now();
     let remindedManualOpen = false;
     while (Date.now() < deadline) {
@@ -88,6 +98,8 @@ export async function runLogin(deviceName, opts = {}) {
             console.error('Still waiting. If no browser window opened, visit:');
             console.error(`  ${verifyUrl}`);
             console.error(`  and enter code ${start.userCode}`);
+            console.error(`TECHPRUFER_LOGIN_URL=${verifyUrl}`);
+            console.error(`TECHPRUFER_LOGIN_CODE=${start.userCode}`);
             console.error('');
         }
         let poll;
@@ -115,7 +127,10 @@ export async function runLogin(deviceName, opts = {}) {
                 apiUrl,
                 deviceId: poll.deviceId,
             });
-            console.error('Logged in. You can close this window and use /techprufer/tailor or /techprufer/build-profile.');
+            console.error('');
+            console.error('Logged in. Credentials saved.');
+            console.error('');
+            console.error(formatCommandsForTools(opts.configuredIds ?? []));
             return;
         }
     }

package/dist/server.js

@@ -1,7 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-import { apiFetch, ApiError } from './api.js';
+import { apiFetch, ApiError, setActiveClientInfo } from './api.js';
 import { brandIcons } from './brand.js';
 import { loadCredentials, credentialsFilePath } from './config.js';
 import { runLogin } from './login.js';
@@ -21,7 +21,7 @@ export function createServer() {
     const server = new McpServer({
         name: 'techprufer',
         title: 'TechPrufer',
-        version: '0.1.5',
+        version: '0.4.0',
         description: 'Tailor resumes and build profiles with your AI tool — no Gemini API key.',
         websiteUrl: 'https://techprufer.com',
         icons: brandIcons(),
@@ -99,32 +99,52 @@ export function createServer() {
         }
     });
     // Slash path in Cursor: /techprufer/tailor (user installs may show /user-techprufer/tailor)
-    server.prompt('tailor', 'TechPrufer — tailor a queued resume job', {
+    server.prompt('tailor', 'TechPrufer — pending jobs, company picker, tailor, edit/delete, attach siblings (one command)', {
         jobId: z
             .string()
             .optional()
-            .describe('Optional specific job id; otherwise process all pending jobs in order'),
-    }, async ({ jobId }) => ({
+            .describe('Optional queued job id — process that job only'),
+        applicationId: z
+            .string()
+            .optional()
+            .describe('Optional application id — skip picker (tailor or edit that app)'),
+        profileId: z
+            .string()
+            .optional()
+            .describe('Optional base profile id — skip picker (edit that base resume)'),
+    }, async ({ jobId, applicationId, profileId }) => ({
         messages: [
             {
                 role: 'user',
                 content: {
                     type: 'text',
                     text: [
-                        'Process TechPrufer MCP tailor jobs.',
-                        jobId
-                            ? `Focus on jobId=${jobId}.`
-                            : 'Fetch pending jobs and process them ONE AT A TIME in order.',
+                        'TechPrufer MCP — all resume control under /techprufer/tailor.',
                         '',
-                        'For each job:',
-                        '1. Call get_tailor_job (with jobId if provided).',
-                        '2. Execute the returned messages verbatim with your own model.',
-                        '3. Produce ONLY the tailored JSON object (experience, projects, skills, meta, linkedinMessage).',
-                        '4. Call submit_tailor_result with that JSON.',
-                        '5. If the tool returns a correctiveMessage (validation / layout fill), fix the JSON and resubmit once.',
-                        '6. Proceed to the next pending job.',
+                        '### Flow',
+                        jobId
+                            ? `1) Process jobId=${jobId}: get_tailor_job → execute → submit_tailor_result.`
+                            : '1) Call list_pending_tailor_jobs. Show company/role for each. Ask: process them now, or SKIP to company picker? If process: ONE AT A TIME (get_tailor_job → execute → submit_tailor_result; fix once on correctiveMessage).',
+                        applicationId
+                            ? `2) applicationId=${applicationId}: enqueue_tailor_job({ applicationId }) then process, OR get_resume(kind=tailored) to edit/delete.`
+                            : '2) If user gave an application id: enqueue_tailor_job or edit/delete that app.',
+                        profileId
+                            ? `3) profileId=${profileId}: get_resume(kind=base) → update_resume / delete_resume.`
+                            : '3) If user gave a base profile id: edit/delete that base resume.',
+                        '4) Company picker (when skipping pending / no id):',
+                        '   - list_tracked_companies (top 10, paginate, or query= typed name). Show total / withTailored / withoutTailored.',
+                        '   - Ask which company (or they type the name).',
+                        '   - list_applications_at_company(company, onlyUntailored=true preferred for new tailor). If multiple roles, list roles and ask which.',
+                        '   - enqueue_tailor_job({ applicationId }) → process like step 1.',
+                        '   - Or edit/delete via get_resume / update_resume / delete_resume.',
+                        '5) AFTER a successful submit_tailor_result that returns siblingCount > 0:',
+                        '   - Tell the user: this company has N other tracked roles — attach this resume to them?',
+                        '   - If yes: preview_company_siblings then attach_tailored_to_siblings({ sourceApplicationId, sessionId }).',
+                        '   - If no: leave siblings alone.',
+                        '6) Always show the user from submit result: jdUrl (job link), resumePdfUrl, dashboardUrl.',
+                        '   On that job page the Chrome extension can inject or download the PDF when resumePdfUrl is set.',
                         '',
-                        'Do not invent experience or metrics. Zero hallucination. Complete output only.',
+                        'Zero hallucination. Complete JSON only when submitting or saving.',
                     ].join('\n'),
                 },
             },
@@ -239,6 +259,247 @@ export function createServer() {
             return textResult(`Submit failed: ${msg}`, true);
         }
     });
+    server.tool('list_resumes', 'List TechPrufer resumes for MCP edit/tailor picker. Paginated. ' +
+        'kind=base|tailored|all. For tailored, default is AI-tailored only; ' +
+        'pass includeAttachedOrEdited=true to also show attach/edit snapshots. ' +
+        'Filter with company and/or role.', {
+        kind: z
+            .enum(['base', 'tailored', 'all'])
+            .optional()
+            .describe('Default all'),
+        company: z.string().optional(),
+        role: z.string().optional(),
+        includeAttachedOrEdited: z
+            .boolean()
+            .optional()
+            .describe('Include non-AI tailored snapshots (attach/edit). Default false.'),
+        page: z.number().int().min(1).optional(),
+        pageSize: z.number().int().min(1).max(50).optional(),
+    }, async ({ kind, company, role, includeAttachedOrEdited, page, pageSize }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const qs = new URLSearchParams();
+            qs.set('kind', kind ?? 'all');
+            if (company)
+                qs.set('company', company);
+            if (role)
+                qs.set('role', role);
+            if (includeAttachedOrEdited)
+                qs.set('includeAttachedOrEdited', 'true');
+            if (page)
+                qs.set('page', String(page));
+            if (pageSize)
+                qs.set('pageSize', String(pageSize));
+            const data = await apiFetch(`/api/agent/resumes?${qs.toString()}`);
+            return textResult(JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Failed to list resumes: ${msg}`, true);
+        }
+    });
+    server.tool('list_resume_companies', 'List companies (and roles) that have tailored resumes — use before asking which company to edit.', {
+        includeAttachedOrEdited: z.boolean().optional(),
+    }, async ({ includeAttachedOrEdited }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const qs = includeAttachedOrEdited ? '?includeAttachedOrEdited=true' : '';
+            const data = await apiFetch(`/api/agent/resumes/companies${qs}`);
+            return textResult(JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Failed to list companies: ${msg}`, true);
+        }
+    });
+    server.tool('get_resume', 'Load one resume for editing. kind=base (master profile) or tailored (application snapshot).', {
+        kind: z.enum(['base', 'tailored']),
+        id: z.string().describe('Profile id or application id'),
+    }, async ({ kind, id }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const data = await apiFetch(`/api/agent/resumes/${encodeURIComponent(id)}?kind=${kind}`);
+            return textResult(JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Failed to get resume: ${msg}`, true);
+        }
+    });
+    server.tool('update_resume', 'Save edits to a base profile or tailored application resume. Pass the full CPM profile JSON.', {
+        kind: z.enum(['base', 'tailored']),
+        id: z.string(),
+        profileJson: z.union([z.record(z.string(), z.unknown()), z.string()]),
+        name: z.string().optional().describe('Optional new name for base profiles only'),
+    }, async ({ kind, id, profileJson, name }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const parsed = typeof profileJson === 'string' ? JSON.parse(profileJson) : profileJson;
+            const result = await apiFetch(`/api/agent/resumes/${encodeURIComponent(id)}`, {
+                method: 'PATCH',
+                body: JSON.stringify({ kind, profileJson: parsed, name }),
+            });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (e) {
+            if (e instanceof ApiError && (e.status === 400 || e.status === 422)) {
+                return textResult(JSON.stringify(e.body, null, 2), true);
+            }
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Update failed: ${msg}`, true);
+        }
+    });
+    server.tool('delete_resume', 'Delete a base profile, or delete the whole application for a tailored resume. Always confirm with the user first.', {
+        kind: z.enum(['base', 'tailored']),
+        id: z.string(),
+    }, async ({ kind, id }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const result = await apiFetch(`/api/agent/resumes/${encodeURIComponent(id)}?kind=${kind}`, { method: 'DELETE' });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Delete failed: ${msg}`, true);
+        }
+    });
+    server.tool('enqueue_tailor_job', 'Queue a tailor job for MCP. Prefer applicationId when the user named a job/app — JD is loaded from the application. ' +
+        'Otherwise pass jdText + profileId (or sourceApplicationId as the source resume).', {
+        applicationId: z.string().optional(),
+        profileId: z.string().optional(),
+        sourceApplicationId: z.string().optional(),
+        jdText: z.string().optional(),
+    }, async ({ applicationId, profileId, sourceApplicationId, jdText }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const result = await apiFetch('/api/agent/jobs', {
+                method: 'POST',
+                body: JSON.stringify({
+                    applicationId,
+                    profileId,
+                    sourceApplicationId,
+                    jdText,
+                }),
+            });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (e) {
+            if (e instanceof ApiError && e.status === 402) {
+                return textResult(JSON.stringify(e.body, null, 2), true);
+            }
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Enqueue failed: ${msg}`, true);
+        }
+    });
+    server.tool('list_tracked_companies', 'List companies from tracked applications (includes untailored). Top 10 by default; paginate or pass query= for a name filter. Use after skipping pending jobs.', {
+        page: z.number().int().min(1).optional(),
+        pageSize: z.number().int().min(1).max(50).optional(),
+        query: z.string().optional().describe('Company name filter (substring)'),
+    }, async ({ page, pageSize, query }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const qs = new URLSearchParams();
+            if (page)
+                qs.set('page', String(page));
+            if (pageSize)
+                qs.set('pageSize', String(pageSize));
+            if (query)
+                qs.set('query', query);
+            const q = qs.toString();
+            const data = await apiFetch(`/api/agent/applications/companies${q ? `?${q}` : ''}`);
+            return textResult(JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Failed to list companies: ${msg}`, true);
+        }
+    });
+    server.tool('list_applications_at_company', 'List applications at a company for the tailor picker. Set onlyUntailored=true to focus on roles that still need a resume.', {
+        company: z.string(),
+        onlyUntailored: z.boolean().optional(),
+        role: z.string().optional(),
+        page: z.number().int().min(1).optional(),
+        pageSize: z.number().int().min(1).max(50).optional(),
+    }, async ({ company, onlyUntailored, role, page, pageSize }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const qs = new URLSearchParams({ company });
+            if (onlyUntailored)
+                qs.set('onlyUntailored', 'true');
+            if (role)
+                qs.set('role', role);
+            if (page)
+                qs.set('page', String(page));
+            if (pageSize)
+                qs.set('pageSize', String(pageSize));
+            const data = await apiFetch(`/api/agent/applications?${qs.toString()}`);
+            return textResult(JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Failed to list applications: ${msg}`, true);
+        }
+    });
+    server.tool('preview_company_siblings', 'After tailoring one application: preview other roles at the same company (for “attach to N others?”).', {
+        sourceApplicationId: z.string(),
+    }, async ({ sourceApplicationId }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const data = await apiFetch(`/api/agent/applications/siblings?sourceApplicationId=${encodeURIComponent(sourceApplicationId)}`);
+            return textResult(JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Failed to preview siblings: ${msg}`, true);
+        }
+    });
+    server.tool('attach_tailored_to_siblings', 'Attach the tailor session from a source application onto other roles at that company (or explicit target ids).', {
+        sourceApplicationId: z.string(),
+        sessionId: z.string().describe('sessionId from submit_tailor_result'),
+        targetApplicationIds: z.array(z.string()).optional(),
+        onlyUntailored: z
+            .boolean()
+            .optional()
+            .describe('Default true — only attach to apps that do not already have a tailored resume'),
+    }, async ({ sourceApplicationId, sessionId, targetApplicationIds, onlyUntailored }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const result = await apiFetch('/api/agent/applications/siblings', {
+                method: 'POST',
+                body: JSON.stringify({
+                    sourceApplicationId,
+                    sessionId,
+                    targetApplicationIds,
+                    onlyUntailored,
+                }),
+            });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Attach siblings failed: ${msg}`, true);
+        }
+    });
     // Slash path in Cursor: /techprufer/build-profile
     server.prompt('build-profile', 'TechPrufer — build a profile from PDF job or local resume', {
         jobId: z.string().optional().describe('Optional queued profile job id'),
@@ -275,6 +536,16 @@ export function createServer() {
 }
 export async function startStdioServer() {
     const server = createServer();
+    // Capture IDE identity from the MCP initialize handshake (not env vars).
+    server.server.oninitialized = () => {
+        const info = server.server.getClientVersion();
+        if (info?.name) {
+            setActiveClientInfo({
+                name: info.name,
+                version: info.version,
+            });
+        }
+    };
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/setup.d.ts

@@ -12,6 +12,15 @@ export interface SetupOptions {
     yes?: boolean;
     /** Called as step 1 of `login` — tweaks copy and skips the "next" hints. */
     beforeLogin?: boolean;
+    /**
+     * When true (login flow, non-TTY, no --tools): skip config with guidance
+     * and return [] instead of exiting — login continues.
+     */
+    allowSkip?: boolean;
 }
-export declare function runSetup(opts?: SetupOptions): Promise<void>;
+export type SetupOutcome = {
+    configuredIds: AiToolId[];
+    skipped: boolean;
+};
+export declare function runSetup(opts?: SetupOptions): Promise<SetupOutcome>;
 export declare function listToolsForHelp(): string;

package/dist/setup.js

@@ -1,5 +1,6 @@
 import { createInterface, emitKeypressEvents } from 'readline';
 import { AI_TOOLS, getTool, installTool, isToolConfigured, printSnippetForTool, resolveToolIds, } from './tools.js';
+import { formatCommandsForTools } from './commands.js';
 const ANSI = {
     hideCursor: '\x1b[?25l',
     showCursor: '\x1b[?25h',
@@ -10,6 +11,7 @@ const ANSI = {
     cyan: (s) => `\x1b[36m${s}\x1b[39m`,
     green: (s) => `\x1b[32m${s}\x1b[39m`,
     red: (s) => `\x1b[31m${s}\x1b[39m`,
+    yellow: (s) => `\x1b[33m${s}\x1b[39m`,
 };
 function isTty() {
     return Boolean(process.stdin.isTTY && process.stderr.isTTY);
@@ -49,11 +51,14 @@ export function parseSelection(input) {
     }
     return ids;
 }
-function renderPicker(items, cursor) {
+function renderPicker(items, cursor, emptyHint) {
     const lines = [];
     const selectedLabels = items.filter((i) => i.selected).map((i) => i.tool.label);
-    lines.push(`${ANSI.bold('? Select AI tools to set up')} ${ANSI.dim(`(${AI_TOOLS.length} available)`)}`);
-    lines.push(`  Selected: ${selectedLabels.length ? ANSI.cyan(selectedLabels.join(', ')) : ANSI.dim('none')}`);
+    lines.push(`${ANSI.bold('? Select AI tools to configure')} ${ANSI.dim(`(${AI_TOOLS.length} available)`)}`);
+    lines.push(`  Selected: ${selectedLabels.length ? ANSI.cyan(selectedLabels.join(', ')) : ANSI.dim('none — Space to select')}`);
+    if (emptyHint) {
+        lines.push(ANSI.yellow('  Select at least one tool (Space), then press Enter.'));
+    }
     lines.push(ANSI.dim('  ↑↓ navigate · Space toggle · a all · Enter confirm · q quit'));
     for (let i = 0; i < items.length; i++) {
         const item = items[i];
@@ -65,21 +70,20 @@ function renderPicker(items, cursor) {
     }
     return lines.join('\n');
 }
-/** Arrow-key multi-select; pre-selects tools that already have a techprufer entry. */
+/**
+ * Arrow-key multi-select. Defaults to EMPTY — user must select at least one.
+ * Already-configured tools show (refresh) but are not pre-selected.
+ */
 async function interactivePicker() {
     const items = AI_TOOLS.map((tool) => {
         const configured = isToolConfigured(tool);
-        return { tool, selected: configured, configured };
+        return { tool, selected: false, configured };
     });
-    // Nothing configured yet → pre-select everything for a fast first run.
-    if (!items.some((i) => i.selected)) {
-        for (const item of items)
-            item.selected = true;
-    }
     let cursor = 0;
     let renderedLines = 0;
+    let emptyHint = false;
     const draw = () => {
-        const frame = renderPicker(items, cursor);
+        const frame = renderPicker(items, cursor, emptyHint);
         process.stderr.write(ANSI.up(renderedLines) + '\r' + ANSI.clearDown + frame + '\n');
         renderedLines = frame.split('\n').length;
     };
@@ -103,22 +107,32 @@ async function interactivePicker() {
                 return;
             }
             if (key.name === 'up' || key.name === 'k') {
+                emptyHint = false;
                 cursor = (cursor - 1 + items.length) % items.length;
             }
             else if (key.name === 'down' || key.name === 'j') {
+                emptyHint = false;
                 cursor = (cursor + 1) % items.length;
             }
             else if (key.name === 'space') {
+                emptyHint = false;
                 items[cursor].selected = !items[cursor].selected;
             }
             else if (key.name === 'a') {
+                emptyHint = false;
                 const allOn = items.every((i) => i.selected);
                 for (const item of items)
                     item.selected = !allOn;
             }
             else if (key.name === 'return' || key.name === 'enter') {
+                const selected = items.filter((i) => i.selected).map((i) => i.tool.id);
+                if (selected.length === 0) {
+                    emptyHint = true;
+                    draw();
+                    return;
+                }
                 cleanup();
-                resolve(items.filter((i) => i.selected).map((i) => i.tool.id));
+                resolve(selected);
                 return;
             }
             draw();
@@ -137,14 +151,19 @@ async function promptToolSelection() {
             // Raw-mode failure → fall through to the plain prompt.
         }
     }
-    console.error('AI tools:');
+    console.error('AI tools (select at least one):');
     AI_TOOLS.forEach((t, i) => {
         console.error(`  ${i + 1}) ${t.label.padEnd(16)}  ${t.hint}`);
     });
     console.error('  a) all');
     console.error('');
-    const answer = await ask('Select tools (numbers or ids, comma-separated; "all"): ');
-    return parseSelection(answer);
+    for (;;) {
+        const answer = await ask('Select tools (numbers or ids, comma-separated; "all"): ');
+        const ids = parseSelection(answer);
+        if (ids.length > 0)
+            return ids;
+        console.error(ANSI.yellow('Select at least one tool.'));
+    }
 }
 function printResults(results, opts = {}) {
     console.error('');
@@ -159,15 +178,26 @@ function printResults(results, opts = {}) {
     }
     console.error('');
     console.error(ANSI.dim('Restart your AI tools for the MCP server to take effect.'));
+    if (opts.configuredIds?.length) {
+        console.error('');
+        console.error(formatCommandsForTools(opts.configuredIds));
+    }
     if (!opts.beforeLogin) {
         console.error('');
-        console.error('Next: npx techprufer-mcp login  (if you have not already)');
-        console.error('Then: /techprufer/tailor or /techprufer/build-profile');
+        console.error('Next: npx techprufer-mcp login --no-setup  (if you have not already)');
     }
 }
+function printNonInteractiveSkipHint() {
+    console.error(ANSI.yellow('No interactive terminal — skipping tool config.'));
+    console.error('To configure tools from an agent/script, re-run with:');
+    console.error(`  npx techprufer-mcp login --tools=${AI_TOOLS.map((t) => t.id).join(',')}`);
+    console.error('Or paste the JSON snippet from the TechPrufer MCP hub (Copy JSON).');
+    console.error('Continuing to device login…');
+    console.error('');
+}
 export async function runSetup(opts = {}) {
     console.error(ANSI.bold(opts.beforeLogin
-        ? 'TechPrufer MCP — step 1/2 · configure AI tools'
+        ? 'TechPrufer MCP — configure AI tools'
         : 'TechPrufer MCP — configure AI tools'));
     console.error('');
     let ids;
@@ -180,14 +210,18 @@ export async function runSetup(opts = {}) {
     else if (isTty() && !opts.yes) {
         ids = await promptToolSelection();
     }
+    else if (opts.allowSkip || opts.beforeLogin) {
+        printNonInteractiveSkipHint();
+        return { configuredIds: [], skipped: true };
+    }
     else {
         console.error('Non-interactive mode: pass --all or --tools=cursor,claude,claude-code,antigravity,codex');
         process.exit(1);
     }
     if (ids.length === 0) {
-        if (opts.beforeLogin) {
+        if (opts.beforeLogin || opts.allowSkip) {
             console.error('No tools selected — skipping setup.');
-            return;
+            return { configuredIds: [], skipped: true };
         }
         console.error('No tools selected.');
         process.exit(1);
@@ -199,13 +233,14 @@ export async function runSetup(opts = {}) {
             console.error(printSnippetForTool(tool));
             console.error('');
         }
-        return;
+        return { configuredIds: ids, skipped: false };
     }
     const results = selected.map((tool) => installTool(tool));
-    printResults(results, { beforeLogin: opts.beforeLogin });
+    printResults(results, { beforeLogin: opts.beforeLogin, configuredIds: ids });
     if (results.some((r) => !r.ok) && !opts.beforeLogin) {
         process.exit(1);
     }
+    return { configuredIds: ids, skipped: false };
 }
 export function listToolsForHelp() {
     return AI_TOOLS.map((t) => `    ${t.id.padEnd(14)} ${t.label}`).join('\n');

package/dist/setup.nontty.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/setup.nontty.test.js

@@ -0,0 +1,27 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { runSetup } from './setup.js';
+describe('runSetup non-TTY login path', () => {
+    it('skips config without exiting when beforeLogin + allowSkip', async () => {
+        // Ensure we look non-interactive even if the test runner has a TTY.
+        const prevIn = Object.getOwnPropertyDescriptor(process.stdin, 'isTTY');
+        const prevErr = Object.getOwnPropertyDescriptor(process.stderr, 'isTTY');
+        Object.defineProperty(process.stdin, 'isTTY', { configurable: true, value: false });
+        Object.defineProperty(process.stderr, 'isTTY', { configurable: true, value: false });
+        try {
+            const outcome = await runSetup({ beforeLogin: true, allowSkip: true });
+            assert.equal(outcome.skipped, true);
+            assert.deepEqual(outcome.configuredIds, []);
+        }
+        finally {
+            if (prevIn)
+                Object.defineProperty(process.stdin, 'isTTY', prevIn);
+            else
+                delete process.stdin.isTTY;
+            if (prevErr)
+                Object.defineProperty(process.stderr, 'isTTY', prevErr);
+            else
+                delete process.stderr.isTTY;
+        }
+    });
+});

package/dist/tools.d.ts

@@ -45,5 +45,12 @@ export type InstallResult = {
     path: string;
     error: string;
 };
+/** Codex surfaces custom prompts as `/name` from `~/.codex/prompts/<name>.md`. */
+export declare function codexPromptsDir(): string;
+/** Write Codex slash-command prompt files (idempotent). */
+export declare function writeCodexPromptFiles(): {
+    path: string;
+    created: boolean;
+}[];
 export declare function installTool(tool: AiToolDef): InstallResult;
 export declare function printSnippetForTool(tool: AiToolDef): string;

package/dist/tools.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'fs';
 import { homedir, platform } from 'os';
 import { dirname, join } from 'path';
 /** Server key must stay `techprufer` so slash commands are `/techprufer/…`. */
@@ -157,6 +157,64 @@ export function isToolConfigured(tool) {
         return false;
     }
 }
+/** Codex surfaces custom prompts as `/name` from `~/.codex/prompts/<name>.md`. */
+export function codexPromptsDir() {
+    return join(homedir(), '.codex', 'prompts');
+}
+const CODEX_TAILOR_PROMPT = [
+    'TechPrufer MCP — all resume control under /techprufer-tailor.',
+    '',
+    '1) list_pending_tailor_jobs — show them; ask process now or SKIP to company picker.',
+    '2) applicationId / profileId: enqueue or edit/delete.',
+    '3) Company picker: list_tracked_companies (top 10 / query) → list_applications_at_company → enqueue_tailor_job → process.',
+    '4) After submit_tailor_result: show jdUrl + resumePdfUrl. If siblingCount>0, ask to attach to other roles (preview_company_siblings → attach_tailored_to_siblings).',
+    '',
+    'Zero hallucination. Complete JSON only when submitting or saving.',
+    '',
+].join('\n');
+const CODEX_BUILD_PROFILE_PROMPT = [
+    'Process TechPrufer MCP profile-build jobs (or build from a local resume).',
+    '',
+    'Path A — queued PDF jobs from the site:',
+    '1. Call list_pending_profile_jobs; for each QUEUED/CLAIMED job call get_profile_job.',
+    '2. Execute returned messages verbatim; output ONLY CPM profile JSON.',
+    '3. Call submit_profile_job_result. On correctiveMessage, fix once and resubmit.',
+    '',
+    'Path B — local resume file (user selected / open in this tool):',
+    '1. Read the resume file and extract full text.',
+    '2. Call get_profile_build_messages with that resumeText.',
+    '3. Execute messages verbatim; output ONLY CPM profile JSON.',
+    '4. Call submit_built_profile (optional name from file / identity.name).',
+    '',
+    'Prefer Path A if pending jobs exist; otherwise Path B when a local resume is available.',
+    'Zero hallucination. Complete JSON only. Faithful extraction, not rewriting.',
+    '',
+].join('\n');
+/** Write Codex slash-command prompt files (idempotent). */
+export function writeCodexPromptFiles() {
+    const dir = codexPromptsDir();
+    mkdirSync(dir, { recursive: true });
+    const files = [
+        { name: 'techprufer-tailor.md', body: CODEX_TAILOR_PROMPT },
+        { name: 'techprufer-build-profile.md', body: CODEX_BUILD_PROFILE_PROMPT },
+    ];
+    // Remove deprecated separate edit prompt if an older package version wrote it.
+    const deprecatedEdit = join(dir, 'techprufer-edit.md');
+    if (existsSync(deprecatedEdit)) {
+        try {
+            unlinkSync(deprecatedEdit);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return files.map(({ name, body }) => {
+        const path = join(dir, name);
+        const existed = existsSync(path);
+        writeFileSync(path, body, 'utf8');
+        return { path, created: !existed };
+    });
+}
 export function installTool(tool) {
     const path = tool.configPath();
     try {
@@ -167,6 +225,9 @@ export function installTool(tool) {
             : mergeJsonMcpServers(prev);
         mkdirSync(dirname(path), { recursive: true });
         writeFileSync(path, next, 'utf8');
+        if (tool.id === 'codex') {
+            writeCodexPromptFiles();
+        }
         return { ok: true, tool, path, created: !existed };
     }
     catch (e) {

package/dist/tools.test.js

@@ -1,7 +1,12 @@
 import { describe, it } from 'node:test';
 import assert from 'node:assert/strict';
-import { mergeJsonMcpServers, mergeTomlMcpServers, MCP_SERVER_KEY, MCP_SERVER_ENTRY, } from './tools.js';
+import { mkdtempSync, readFileSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { mergeJsonMcpServers, mergeTomlMcpServers, MCP_SERVER_KEY, MCP_SERVER_ENTRY, writeCodexPromptFiles, codexPromptsDir, } from './tools.js';
 import { parseSelection } from './setup.js';
+import { formatClientHeader, parseClientHeader } from './clientHeader.js';
+import { formatCommandsForTools, TOOL_COMMANDS } from './commands.js';
 describe('mergeJsonMcpServers', () => {
     it('creates mcpServers when file is empty', () => {
         const out = JSON.parse(mergeJsonMcpServers(null));
@@ -64,4 +69,52 @@ describe('parseSelection', () => {
     it('rejects unknown tokens', () => {
         assert.throws(() => parseSelection('windsurf'), /Unknown selection/);
     });
+    it('empty selection is empty array (picker defaults empty)', () => {
+        assert.deepEqual(parseSelection(''), []);
+        assert.deepEqual(parseSelection('   '), []);
+    });
+});
+describe('clientHeader', () => {
+    it('formats and parses name/version', () => {
+        assert.equal(formatClientHeader({ name: 'cursor', version: '2.1.3' }), 'cursor/2.1.3');
+        assert.equal(formatClientHeader({ name: 'codex' }), 'codex');
+        assert.equal(formatClientHeader(null), null);
+        assert.deepEqual(parseClientHeader('cursor/2.1.3'), { name: 'cursor', version: '2.1.3' });
+        assert.deepEqual(parseClientHeader('claude-code'), { name: 'claude-code' });
+    });
+});
+describe('TOOL_COMMANDS', () => {
+    it('exposes per-tool slash paths', () => {
+        assert.equal(TOOL_COMMANDS.cursor.tailor, '/techprufer/tailor');
+        assert.equal(TOOL_COMMANDS['claude-code'].tailor, '/mcp__techprufer__tailor');
+        assert.equal(TOOL_COMMANDS.codex.tailor, '/techprufer-tailor');
+        assert.match(formatCommandsForTools(['codex']), /\/techprufer-tailor/);
+    });
+});
+describe('writeCodexPromptFiles', () => {
+    it('writes idempotent prompt markdown under ~/.codex/prompts', () => {
+        // Use real home dir path but write into a temp HOME if possible.
+        const prevHome = process.env.HOME;
+        const tmp = mkdtempSync(join(tmpdir(), 'tp-codex-'));
+        process.env.HOME = tmp;
+        try {
+            const first = writeCodexPromptFiles();
+            assert.equal(first.length, 2);
+            assert.equal(first.every((f) => f.created), true);
+            assert.equal(codexPromptsDir(), join(tmp, '.codex', 'prompts'));
+            const tailor = readFileSync(join(tmp, '.codex', 'prompts', 'techprufer-tailor.md'), 'utf8');
+            assert.match(tailor, /list_pending_tailor_jobs/);
+            assert.match(tailor, /list_tracked_companies/);
+            assert.match(tailor, /attach_tailored_to_siblings/);
+            const second = writeCodexPromptFiles();
+            assert.equal(second.every((f) => f.created), false);
+        }
+        finally {
+            if (prevHome === undefined)
+                delete process.env.HOME;
+            else
+                process.env.HOME = prevHome;
+            rmSync(tmp, { recursive: true, force: true });
+        }
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "techprufer-mcp",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "TechPrufer MCP — tailor resumes and build profiles from your AI tool",
   "homepage": "https://techprufer.com",
   "type": "module",