refactor: replace hardcoded skipPreNav with declarative navigateBefore field (#208)

Browser adapters using COOKIE/HEADER strategy need the page on the target
domain so credentialed fetch() carries cookies. Previously, execution.ts
hardcoded `cmd.site === 'boss'` to skip this pre-navigation for adapters
that handle their own goto().

Now each adapter self-declares via `navigateBefore: false` on CliCommand.
This is more extensible — new sites that manage their own navigation just
add the field instead of editing execution.ts.

Changes:
- Add `navigateBefore?: boolean | string` to CliCommand interface
- Add `resolvePreNav()` helper in execution.ts (replaces hardcoded check)
- All 14 boss adapters declare `navigateBefore: false`
- Wire through discovery.ts (YAML + manifest) and build-manifest.ts

Author: jackwener

src/build-manifest.ts

@@ -41,6 +41,8 @@ interface ManifestEntry {
   type: 'yaml' | 'ts';
   /** Relative path from clis/ dir, e.g. 'bilibili/hot.yaml' or 'bilibili/search.js' */
   modulePath?: string;
+  /** Pre-navigation control — see CliCommand.navigateBefore */
+  navigateBefore?: boolean | string;
 }
 
 function extractBalancedBlock(
@@ -189,6 +191,7 @@ function scanYaml(filePath: string, site: string): ManifestEntry | null {
       pipeline: def.pipeline,
       timeout: def.timeout,
       type: 'yaml',
+      navigateBefore: def.navigateBefore,
     };
   } catch (err: any) {
     process.stderr.write(`Warning: failed to parse ${filePath}: ${err.message}\n`);
@@ -248,6 +251,10 @@ function scanTs(filePath: string, site: string): ManifestEntry | null {
       entry.args = parseTsArgsBlock(argsBlock);
     }
 
+    // Extract navigateBefore: false
+    const navMatch = src.match(/navigateBefore\s*:\s*(true|false)/);
+    if (navMatch) entry.navigateBefore = navMatch[1] === 'true' ? true : false;
+
     return entry;
   } catch (err: any) {
     // If parsing fails, log a warning (matching scanYaml behaviour) and skip the entry.

src/clis/boss/batchgreet.ts

@@ -13,6 +13,7 @@ cli({
   description: 'BOSS直聘批量向推荐候选人发送招呼',
   domain: 'www.zhipin.com',
   strategy: Strategy.COOKIE,
+  navigateBefore: false,
   browser: true,
   args: [
     { name: 'job-id', default: '', help: 'Filter by encrypted job ID (greet all jobs if empty)' },

src/clis/boss/chatlist.ts

@@ -7,6 +7,7 @@ cli({
   description: 'BOSS直聘查看聊天列表（招聘端）',
   domain: 'www.zhipin.com',
   strategy: Strategy.COOKIE,
+  navigateBefore: false,
   browser: true,
   args: [
     { name: 'page', type: 'int', default: 1, help: 'Page number' },

src/clis/boss/chatmsg.ts

@@ -7,6 +7,7 @@ cli({
   description: 'BOSS直聘查看与候选人的聊天消息',
   domain: 'www.zhipin.com',
   strategy: Strategy.COOKIE,
+  navigateBefore: false,
   browser: true,
   args: [
     { name: 'uid', required: true, help: 'Encrypted UID (from chatlist)' },

src/clis/boss/detail.ts

@@ -10,6 +10,7 @@ cli({
   description: 'BOSS直聘查看职位详情',
   domain: 'www.zhipin.com',
   strategy: Strategy.COOKIE,
+  navigateBefore: false,
   browser: true,
   args: [
     { name: 'security-id', required: true, help: 'Security ID from search results (securityId field)' },

src/clis/boss/exchange.ts

@@ -10,6 +10,7 @@ cli({
   description: 'BOSS直聘交换联系方式（请求手机/微信）',
   domain: 'www.zhipin.com',
   strategy: Strategy.COOKIE,
+  navigateBefore: false,
   browser: true,
   args: [
     { name: 'uid', required: true, help: 'Encrypted UID of the candidate' },

src/clis/boss/greet.ts

@@ -13,6 +13,7 @@ cli({
   description: 'BOSS直聘向新候选人发送招呼（开始聊天）',
   domain: 'www.zhipin.com',
   strategy: Strategy.COOKIE,
+  navigateBefore: false,
   browser: true,
   args: [
     { name: 'uid', required: true, help: 'Encrypted UID of the candidate (from recommend)' },

src/clis/boss/invite.ts

@@ -10,6 +10,7 @@ cli({
   description: 'BOSS直聘发送面试邀请',
   domain: 'www.zhipin.com',
   strategy: Strategy.COOKIE,
+  navigateBefore: false,
   browser: true,
   args: [
     { name: 'uid', required: true, help: 'Encrypted UID of the candidate' },

src/clis/boss/joblist.ts

@@ -10,6 +10,7 @@ cli({
   description: 'BOSS直聘查看我发布的职位列表',
   domain: 'www.zhipin.com',
   strategy: Strategy.COOKIE,
+  navigateBefore: false,
   browser: true,
   args: [],
   columns: ['job_name', 'salary', 'city', 'status', 'encrypt_job_id'],

src/clis/boss/mark.ts

@@ -19,6 +19,7 @@ cli({
   description: 'BOSS直聘给候选人添加标签',
   domain: 'www.zhipin.com',
   strategy: Strategy.COOKIE,
+  navigateBefore: false,
   browser: true,
   args: [
     { name: 'uid', required: true, help: 'Encrypted UID of the candidate' },