trackly-cli 0.5.2 → 0.6.0

package/README.md

@@ -44,6 +44,7 @@ trackly jobs                          # List jobs
 trackly jobs --remote                 # Filter remote jobs (sets usStates=REMOTE)
 trackly jobs --region us              # Filter by region (us, non_us, all, or a region tag: europe, canada, remote, ...)
 trackly jobs --job-type internship    # Filter by employment type (full_time, internship, all)
+trackly jobs --work-arrangement hybrid,remote  # Filter by work arrangement independently
 trackly jobs --function product       # Filter by function
 trackly jobs --company 243            # Filter by company ID
 trackly job 1234                      # Get job details
@@ -152,7 +153,7 @@ Then use natural language in any of these clients:
 
 | Tool | Description |
 |------|-------------|
-| trackly_search_jobs | Search and filter jobs by function, company, location, modality, status |
+| trackly_search_jobs | Search and filter jobs by function, company, region, employment type, work arrangement, and status |
 | trackly_get_job | Get full details for a specific job |
 | trackly_search_companies | Semantic company search |
 | trackly_list_companies | List all tracked companies |

package/bin/trackly

@@ -57,7 +57,7 @@ const COMMAND_FLAGS = {
   login: [],
   logout: [],
   whoami: [],
-  jobs: ['function', 'company', 'region', 'job-type', 'remote', 'status', 'sort', 'limit', 'offset', 'keywords', 'location', 'modality'],
+  jobs: ['function', 'company', 'region', 'job-type', 'work-arrangement', 'remote', 'status', 'sort', 'limit', 'offset', 'keywords', 'location', 'modality'],
   job: [],
   companies: ['limit', 'offset'],
   search: [],
@@ -86,6 +86,7 @@ const STATUS_LABELS = {
   saved: 'saved',
   dismissed: 'dismissed',
 };
+const WORK_ARRANGEMENT_VALUES = ['remote', 'hybrid', 'in_person', 'unspecified'];
 
 function parseArgs(args) {
   const result = { _: [], command: null };
@@ -262,7 +263,7 @@ function hasJobListFilters(args) {
   // (which then raises the migration error) instead of cmdJob(42) silently ignoring
   // the filter. See PR #13 Cursor Bugbot finding.
   const deprecated = Object.keys(DEPRECATED_JOB_FLAGS);
-  const active = ['function', 'company', 'keywords', 'limit', 'region', 'job-type', 'remote', 'offset', 'sort', 'status'];
+  const active = ['function', 'company', 'keywords', 'limit', 'region', 'job-type', 'work-arrangement', 'remote', 'offset', 'sort', 'status'];
   return [...active, ...deprecated].some((key) => args[key] !== undefined);
 }
 
@@ -506,11 +507,24 @@ async function cmdJobs(args) {
     failNow('--remote cannot be combined with --region. Use one or the other (e.g. --region remote).');
   }
 
+  let workArrangements;
+  if (args['work-arrangement'] !== undefined) {
+    if (typeof args['work-arrangement'] !== 'string' || !args['work-arrangement'].trim()) {
+      failNow('--work-arrangement requires a comma-separated value: remote, hybrid, in_person, unspecified.');
+    }
+    workArrangements = [...new Set(args['work-arrangement'].split(',').map((value) => value.trim()))];
+    const invalid = workArrangements.filter((value) => !WORK_ARRANGEMENT_VALUES.includes(value));
+    if (invalid.length > 0) {
+      failNow(`Invalid --work-arrangement value "${invalid.join(',')}". Use: ${WORK_ARRANGEMENT_VALUES.join(', ')}.`);
+    }
+  }
+
   const params = new URLSearchParams();
   if (args.function) params.set('jobFunction', args.function);
   if (args.company) params.set('companyId', args.company);
   if (args.region) params.set('locationFilter', args.region);
   if (args['job-type']) params.set('jobModality', args['job-type']);
+  if (workArrangements) params.set('workArrangements', workArrangements.join(','));
   if (args.remote) params.set('usStates', 'REMOTE');
   if (args.status) params.set('status', args.status);
   if (args.sort) params.set('sort', args.sort);
@@ -994,7 +1008,7 @@ ${color('bold', 'Commands:')}
   ${color('cyan', 'login')}                Authenticate via Google OAuth
   ${color('cyan', 'logout')}               Clear credentials
   ${color('cyan', 'whoami')}               Show current user
-  ${color('cyan', 'jobs')}                 List jobs (--function, --company <id>, --region <tag>, --job-type <type>, --remote, --status, --sort, --limit, --offset, --keywords)
+  ${color('cyan', 'jobs')}                 List jobs (--function, --company <id>, --region <tag>, --job-type <type>, --work-arrangement <values>, --remote, --status, --sort, --limit, --offset, --keywords)
   ${color('cyan', 'job <id>')}             Get full job detail
   ${color('cyan', 'jobs <id>')}            Alias for job <id>
   ${color('cyan', 'companies')}            List companies
@@ -1036,6 +1050,8 @@ ${color('bold', 'Filter values:')}
                    Use a comma-separated list of region tags for multiple regions;
                    us/non_us/all cannot be combined.
   --job-type       full_time, internship, all  (employment type, not work-location)
+  --work-arrangement
+                   remote, hybrid, in_person, unspecified (comma-separated)
   --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)

package/docs/trackly-tools.md

@@ -72,7 +72,8 @@ You can also pass `TRACKLY_API_KEY` as an environment variable for one-off runs.
   - `locationFilter`: pass ONE of
     - a single scalar: `us`, `non_us`, `all`, or a region tag (`europe`, `latam`, `middle_east`, `asia`, `africa`, `canada`, `oceania`, `remote`, `unknown`), OR
     - an array of region tags for multi-region (e.g. `["europe", "canada"]`). The array form excludes `us` — combining `us` with other tags in an array causes the backend to silently drop the others. To get "not US" use the scalar `non_us` alone.
-  - `jobModality`: `full_time`, `internship`, `all` — employment type, NOT work-location style. For remote filtering, use the `remote` boolean or `locationFilter: "remote"`. Hybrid and onsite are not exposed as filters.
+  - `jobModality`: `full_time`, `internship`, `all` — employment type, NOT work arrangement.
+  - `workArrangements`: one or more of `remote`, `hybrid`, `in_person`, `unspecified`. This is an independent axis and combines with region, employment type, and function filters.
   - `remote` (boolean): filter to remote jobs only. Maps to `usStates=REMOTE`.
   - `status`: your application pipeline state. Values: `new`, `applied_confirmed`, `check_later`, `not_interested`, `all`. Older `applying` requests are accepted by the backend as a private compatibility alias for `check_later`, but new clients must not emit it.
   - `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.

package/mcp/server.js

@@ -40,6 +40,10 @@ const STATUS_VALUES = ['new', 'applied_confirmed', 'check_later', 'not_intereste
 // `jobModality` enum matches `jobscout.ts:2870-2875`. Employment type, NOT work-location.
 const JOB_MODALITIES = ['full_time', 'internship', 'all'];
 
+// Independent from geography and employment type. Matches the backend's
+// workArrangements query contract and job_postings constraint.
+const WORK_ARRANGEMENTS = ['remote', 'hybrid', 'in_person', 'unspecified'];
+
 // `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'];
@@ -126,7 +130,7 @@ function createServer() {
 
   server.tool(
     'trackly_search_jobs',
-    'Search and filter job postings. Returns matching jobs with title, company, location, and structured fields. Use companyId to filter jobs at a specific company (get companyId from trackly_search_companies first). Pass `remote: true` for remote-only jobs.',
+    'Search and filter job postings. Returns matching jobs with title, company, location, and structured fields. Use companyId to filter jobs at a specific company (get companyId from trackly_search_companies first). Work arrangement is independent from region and employment type: use workArrangements for remote, hybrid, in-person, or unspecified classifications.',
     {
       function: z.enum(JOB_FUNCTIONS).optional().describe('Job function filter. One of: ' + JOB_FUNCTIONS.join(', ')),
       companyId: z.number().optional().describe('Filter jobs by company ID (get from trackly_search_companies)'),
@@ -138,7 +142,10 @@ function createServer() {
         "Region tag filter. Pass ONE of: (a) a single scalar from 'us', 'non_us', 'all', or a REGION_TAGS value ('europe', 'latam', 'middle_east', 'asia', 'africa', 'canada', 'oceania', 'remote', 'unknown'); or (b) an array of region tags for multi-region (e.g. ['europe', 'canada']). The array form excludes 'us' — combining 'us' with other tags causes the backend to silently drop the others. For 'not US' use the scalar 'non_us' alone."
       ),
       jobModality: z.enum(JOB_MODALITIES).optional().describe(
-        "Employment type (NOT work-location style). full_time = full-time roles, internship = internships, all = both. For remote filtering, use the `remote` boolean or locationFilter='remote'. Hybrid and onsite are not exposed as filters."
+        'Employment type (NOT work arrangement). full_time = full-time roles, internship = internships, all = both. Use workArrangements for remote, hybrid, or in-person classification.'
+      ),
+      workArrangements: z.array(z.enum(WORK_ARRANGEMENTS)).min(1).max(4).optional().describe(
+        'Work arrangement filter, independent from geography and employment type. Values: remote, hybrid, in_person, unspecified. Multiple values use OR semantics.'
       ),
       remote: z.boolean().optional().describe('Filter to remote jobs only (maps to usStates=REMOTE).'),
       status: z.enum(STATUS_VALUES).optional().describe(
@@ -168,6 +175,7 @@ function createServer() {
         qs.set('locationFilter', value);
       }
       if (params.jobModality !== undefined) qs.set('jobModality', params.jobModality);
+      if (params.workArrangements !== undefined) qs.set('workArrangements', params.workArrangements.join(','));
       if (params.remote === true) qs.set('usStates', 'REMOTE');
       if (params.status !== undefined) qs.set('status', params.status);
       if (params.sort !== undefined) qs.set('sort', params.sort);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trackly-cli",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "mcpName": "io.github.trackly-app/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.5.2",
+  "version": "0.6.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "trackly-cli",
-      "version": "0.5.2",
+      "version": "0.6.0",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {