trackly-cli 0.2.1 → 0.2.2

package/bin/trackly

@@ -466,13 +466,30 @@ async function cmdStats() {
 }
 
 const ACTION_TO_COMMAND = { applied: 'apply', saved: 'save', dismissed: 'dismiss' };
+
+// CLI surface accepts applied|saved|dismissed (legacy human-friendly terms).
+// Backend `/api/jobscout/tracker/jobs/:id/stage` expects stage values:
+//   applied → applied, saved → backlog, dismissed → discarded
+// The old `/api/jobscout-tracker/status` endpoint was removed; the new stage
+// endpoint is what production actually serves (and what hosted MCP uses).
+const ACTION_TO_STAGE = { applied: 'applied', saved: 'backlog', dismissed: 'discarded' };
+
 async function cmdUpdateStatus(id, action) {
   const jobId = parseJobId(id);
   if (jobId === null) failNow(`Job ID must be a positive integer. Usage: trackly ${ACTION_TO_COMMAND[action] || action} <id>`);
   if (!hasAuth()) failNow(AUTH_HELP_TEXT);
 
+  // action is already validated by the command dispatcher (apply/save/dismiss subcommands
+  // pass literal strings). No `|| action` fallback — if ACTION_TO_STAGE is ever widened
+  // without updating the dispatcher (or vice versa), fail loud rather than silently POST
+  // an unintended stage value (e.g., posting stage='snoozed' when backend only knows the
+  // stage column's allowlist). Mirrors the defensive throw in mcp/server.js.
+  const stage = ACTION_TO_STAGE[action];
+  if (!stage) {
+    failNow(`Internal error: unknown action "${action}" — expected applied|saved|dismissed.`);
+  }
   try {
-    const result = await apiRequest('POST', '/api/jobscout-tracker/status', { jobId, action });
+    const result = await apiRequest('POST', `/api/jobscout/tracker/jobs/${jobId}/stage`, { stage });
     if (isJSON()) return printJson(result);
     console.log(color('green', `Job ${jobId} marked as ${STATUS_LABELS[action]}.`));
   } catch (e) {
@@ -767,7 +784,7 @@ ${color('bold', 'Filter values:')}
   --remote         Flag (no value). Filters for remote jobs (equivalent to usStates=REMOTE).
   --status         new, applying, applied_confirmed, check_later, not_interested, all
                    (filters by YOUR application pipeline state)
-  --sort           newest, oldest, company
+  --sort           newest (default), match (highest match score first, requires resume)
 
 ${color('bold', 'MCP Setup:')}
   Claude Code: claude mcp add --scope user trackly -- trackly mcp

package/docs/trackly-tools.md

@@ -75,7 +75,7 @@ You can also pass `TRACKLY_API_KEY` as an environment variable for one-off runs.
   - `jobModality`: `full_time`, `internship`, `all` — employment type, NOT work-location style. For remote/hybrid/onsite filtering, use the `remote` boolean or `locationFilter: "remote"`; hybrid and onsite are not exposed as filters.
   - `remote` (boolean): filter to remote jobs only. Maps to `usStates=REMOTE`.
   - `status`: your application pipeline state. Values: `new`, `applying`, `applied_confirmed`, `check_later`, `not_interested`, `all`.
-  - `sort`: `newest`, `oldest`, `company`.
+  - `sort`: `newest` (default) or `match` (highest match score first; requires a resume on file). Backend rejects the deprecated values `oldest` and `company` with HTTP 400.
   - `keywords`, `companyId`, `limit`, `offset`.
 - **trackly_get_job** — Get full job details by ID
 - **trackly_search_companies** — Semantic company search

package/mcp/server.js

@@ -36,6 +36,16 @@ const STATUS_VALUES = ['new', 'applying', 'applied_confirmed', 'check_later', 'n
 // `jobModality` enum matches `jobscout.ts:2870-2875`. Employment type, NOT work-location.
 const JOB_MODALITIES = ['full_time', 'internship', 'all'];
 
+// `sort` enum matches backend handler at `jobscout.ts:3053` — NOT the pre-fix
+// `newest|oldest|company` (backend rejects oldest/company with HTTP 400).
+const SORT_VALUES = ['newest', 'match'];
+
+// Maps the user-facing trackly_update_status action to the backend's tracker
+// stage column. Backend `/api/jobscout/tracker/jobs/:id/stage` expects the
+// stage value, NOT the legacy action name. Hoisted to module scope so it's not
+// rebuilt on every tool invocation.
+const ACTION_TO_STAGE = { applied: 'applied', saved: 'backlog', dismissed: 'discarded' };
+
 function createErrorResult(error, fallbackMessage, extra = {}) {
   const payload = {
     error: error?.error || error?.message || fallbackMessage,
@@ -111,7 +121,7 @@ function createServer() {
       status: z.enum(STATUS_VALUES).optional().describe(
         'Filter by YOUR application pipeline state. Not a generic job-posting status. Values: ' + STATUS_VALUES.join(', ')
       ),
-      sort: z.enum(['newest', 'oldest', 'company']).optional().describe('Sort order: newest, oldest, company'),
+      sort: z.enum(SORT_VALUES).optional().describe('Sort order: newest (default) or match (highest match score first; requires resume). Backend rejects legacy oldest/company with HTTP 400.'),
       limit: z.number().max(50).optional().describe('Max results (default 20, max 50)'),
       offset: z.number().min(0).optional().describe('Pagination offset'),
       keywords: z.string().max(500).optional().describe('Keyword search in title, company, or description'),
@@ -194,7 +204,16 @@ function createServer() {
       action: z.enum(['applied', 'saved', 'dismissed']).describe('Status action'),
     },
     wrapTool(async ({ id, action }) => {
-      return apiRequest('POST', '/api/jobscout-tracker/status', { jobId: id, action }, false, false, MCP_USER_AGENT);
+      // Backend expects the stage name, not the human-friendly action name.
+      // ACTION_TO_STAGE is defined at module scope (mirrors the same map in bin/trackly).
+      const stage = ACTION_TO_STAGE[action];
+      if (!stage) {
+        // Defensive: the z.enum above already rejects values outside applied|saved|dismissed,
+        // but if the enum is ever widened the mapping must be updated in lockstep — fail loud
+        // rather than silently sending an unintended stage.
+        throw new Error(`trackly_update_status: unknown action "${action}" — expected applied|saved|dismissed`);
+      }
+      return apiRequest('POST', `/api/jobscout/tracker/jobs/${id}/stage`, { stage }, false, false, MCP_USER_AGENT);
     }, 'Failed to update job status')
   );
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trackly-cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "mcpName": "io.github.kevinastuhuaman/trackly",
   "description": "AI job search CLI + hosted MCP server with OAuth. 128K+ jobs, 1,900+ companies, 40+ ATS. Works with Claude, ChatGPT, Cursor, Windsurf, Codex via hosted streamable-http or local stdio.",
   "bin": {

package/server.json

@@ -17,12 +17,12 @@
       ]
     }
   ],
-  "version": "0.2.1",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "trackly-cli",
-      "version": "0.2.1",
+      "version": "0.2.2",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {