@ncukondo/search-hub 0.20.0 → 0.21.0

package/README.md

@@ -44,14 +44,14 @@ This creates config and data directories in platform-specific locations:
 
 2. Create a query file:
 ```bash
-search-hub query init -o query.yaml
+search-hub query init "my review"
 ```
 
-This generates a YAML template with JSON Schema support for editor autocompletion. Edit it to define your search:
+This creates `queries/my-review.yaml` with JSON Schema support for editor autocompletion. Edit it to define your search:
 
 ```yaml
 # yaml-language-server: $schema=./query.schema.json
-name: my_review
+name: "my review"
 description: "Literature search for scoping review"
 
 query:
@@ -70,14 +70,14 @@ filters:
 
 3. Validate the query:
 ```bash
-search-hub query validate query.yaml
+search-hub query validate my-review
 ```
 
-This checks structure, validates controlled vocabulary terms (MeSH, ERIC descriptors, Emtree) against external APIs, and suggests corrections for typos.
+This checks structure, validates controlled vocabulary terms (MeSH, ERIC descriptors, Emtree) against external APIs, and suggests corrections for typos. The query name is automatically resolved to `queries/my-review.yaml`.
 
 4. Run search:
 ```bash
-search-hub search query.yaml
+search-hub search my-review
 ```
 
 5. Export results:
@@ -91,31 +91,33 @@ Developing an effective search query is iterative. Start broad, then refine base
 
 ### Workflow
 
-1. **Start with a broad query** - Get an initial set of results:
+1. **Create a query** - Start with a template:
    ```bash
-   search-hub search query-v1.yaml --max-results 100
+   search-hub query init "my review"
+   # Creates queries/my-review.yaml
    ```
 
-2. **Review initial results** - Check titles to assess quality:
+2. **Check hit counts** - Preview before downloading:
    ```bash
-   search-hub results <session-v1> --limit 50
-   search-hub results <session-v1> -q "title:diabetes year:2023-2025"
+   search-hub search my-review --count-only
    ```
 
-3. **Check coverage** - Verify known relevant articles are captured:
+3. **Run the search** - When counts look good:
    ```bash
-   search-hub check <session-v1> --file known-articles.txt
+   search-hub search my-review
    ```
 
-4. **Refine the query** - Copy and modify your query file:
+4. **Review results** - Check titles to assess quality:
    ```bash
-   cp query-v1.yaml query-v2.yaml
-   # Edit query-v2.yaml to add/remove terms, adjust filters
+   search-hub results <session-id> --limit 50
+   search-hub results <session-id> -q "title:diabetes year:2023-2025"
    ```
 
-5. **Run the refined search**:
+5. **Refine and re-run** - Edit the query file, then iterate:
    ```bash
-   search-hub search query-v2.yaml --max-results 100
+   $EDITOR queries/my-review.yaml
+   search-hub search my-review --count-only   # Re-check counts
+   search-hub search my-review                # Execute full search
    ```
 
 6. **Compare results with diff** - See what changed:
@@ -128,22 +130,22 @@ Developing an effective search query is iterative. Start broad, then refine base
 
 - **Use `--count-only` first**: Check hit counts before downloading full results.
   ```bash
-  search-hub search query.yaml --count-only
+  search-hub search my-review --count-only
   ```
 
 - **Use `--preview`** to see hit counts with sample titles:
   ```bash
-  search-hub search query.yaml --preview
+  search-hub search my-review --preview
   ```
 
 - **Use `--dry-run`** to preview translations: See exactly what query each database will receive.
   ```bash
-  search-hub search query.yaml --dry-run
+  search-hub search my-review --dry-run
   ```
 
 - **Compare removed articles carefully**: When narrowing a search, `--show removed` reveals what you're excluding. If important papers are removed, your refinement may be too aggressive.
 
-- **Keep query versions**: Save each iteration (v1, v2, v3) to track your development process and maintain reproducibility.
+- **Track iterations**: Use `query assess` and `query log` to record and review your refinement history.
 
 ## Fulltext Retrieval
 

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAqGD;;;;;;;;;;GAUG;AACH,wBAAsB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiDzE"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAqGD;;;;;;;;;;GAUG;AACH,wBAAsB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmDzE"}

package/dist/cli/commands/init.js

@@ -99,6 +99,7 @@ async function init(options = {}) {
   } = options;
   const configPath = join(configDir, "config.toml");
   const sessionsDir = join(dataDir, "sessions");
+  const queriesDir = join(dataDir, "queries");
   const result = {
     success: false,
     configPath,
@@ -118,6 +119,7 @@ async function init(options = {}) {
   }
   await mkdir(configDir, { recursive: true });
   await mkdir(sessionsDir, { recursive: true });
+  await mkdir(queriesDir, { recursive: true });
   const defaultConfig = getDefaultConfig();
   defaultConfig.session.directory = sessionsDir;
   const configContent = generateConfigContent(defaultConfig);

package/dist/cli/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sources":["../../../src/cli/commands/init.ts"],"sourcesContent":["import { mkdir, writeFile, access, constants } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { stringify as stringifyToml } from '@iarna/toml';\nimport { getDefaultConfig } from '../../config/index.js';\nimport { getConfigDir, getDataDir } from '../../config/paths.js';\nimport type { Config } from '../../config/index.js';\n\n/**\n * Options for the init command.\n */\nexport interface InitOptions {\n  /** Config directory (defaults to platform-specific via getConfigDir()) */\n  configDir?: string;\n  /** Data directory (defaults to platform-specific via getDataDir()) */\n  dataDir?: string;\n  /** Force overwrite if directory already exists */\n  force?: boolean;\n}\n\n/**\n * Result of the init command.\n */\nexport interface InitResult {\n  /** Whether initialization was successful */\n  success: boolean;\n  /** Path to the created config file */\n  configPath: string;\n  /** Path to the sessions directory */\n  sessionsDir: string;\n  /** Path to the config directory */\n  configDir: string;\n  /** Path to the data directory */\n  dataDir: string;\n  /** Whether files already existed (only when success=false) */\n  alreadyExists?: boolean;\n  /** Whether existing files were overwritten (only when force=true) */\n  overwritten?: boolean;\n  /** Message describing the result */\n  message?: string;\n}\n\n/**\n * Check if a file or directory exists.\n */\nasync function exists(path: string): Promise<boolean> {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Convert Config to TOML-compatible object.\n * Removes undefined values and converts to the expected format.\n */\nfunction configToToml(config: Config): Record<string, unknown> {\n  return {\n    session: {\n      directory: config.session.directory,\n    },\n    log: {\n      level: config.log.level,\n    },\n    output: {\n      color: config.output.color,\n      progress_bar: config.output.progress_bar,\n    },\n    providers: {\n      pubmed: {\n        enabled: config.providers.pubmed.enabled,\n        api_key: config.providers.pubmed.api_key ?? '',\n        email: config.providers.pubmed.email ?? '',\n        rate_limit: config.providers.pubmed.rate_limit,\n        timeout: config.providers.pubmed.timeout,\n        retries: config.providers.pubmed.retries,\n        max_results: config.providers.pubmed.max_results,\n      },\n      eric: {\n        enabled: config.providers.eric.enabled,\n        rate_limit: config.providers.eric.rate_limit,\n        timeout: config.providers.eric.timeout,\n        retries: config.providers.eric.retries,\n        max_results: config.providers.eric.max_results,\n      },\n      arxiv: {\n        enabled: config.providers.arxiv.enabled,\n        rate_limit: config.providers.arxiv.rate_limit,\n        timeout: config.providers.arxiv.timeout,\n        retries: config.providers.arxiv.retries,\n        max_results: config.providers.arxiv.max_results,\n      },\n      scopus: {\n        enabled: config.providers.scopus.enabled,\n        api_key: config.providers.scopus.api_key ?? '',\n        inst_token: config.providers.scopus.inst_token ?? '',\n        rate_limit: config.providers.scopus.rate_limit,\n        timeout: config.providers.scopus.timeout,\n        retries: config.providers.scopus.retries,\n        max_results: config.providers.scopus.max_results,\n      },\n      wos: {\n        enabled: config.providers.wos.enabled,\n        api_key: config.providers.wos.api_key ?? '',\n        rate_limit: config.providers.wos.rate_limit,\n        timeout: config.providers.wos.timeout,\n        retries: config.providers.wos.retries,\n        max_results: config.providers.wos.max_results,\n      },\n      embase: {\n        enabled: config.providers.embase.enabled,\n        rate_limit: config.providers.embase.rate_limit,\n        timeout: config.providers.embase.timeout,\n        retries: config.providers.embase.retries,\n        max_results: config.providers.embase.max_results,\n      },\n    },\n    integration: {\n      reference_manager: {\n        enabled: config.integration.reference_manager.enabled,\n        command: config.integration.reference_manager.command,\n        auto_register: config.integration.reference_manager.auto_register,\n      },\n    },\n  };\n}\n\n/**\n * Generate TOML config file content with comments.\n */\nfunction generateConfigContent(config: Config): string {\n  const tomlObj = configToToml(config);\n  const header = `# search-hub configuration file\n# See: https://github.com/search-hub/search-hub for documentation\n\n`;\n  return header + stringifyToml(tomlObj as Parameters<typeof stringifyToml>[0]);\n}\n\n/**\n * Initialize the search-hub configuration directory.\n *\n * Creates:\n * - Config directory with config.toml\n * - Data directory with sessions/ subdirectory\n *\n * On Linux (XDG):\n * - ~/.config/search-hub/config.toml\n * - ~/.local/share/search-hub/sessions/\n */\nexport async function init(options: InitOptions = {}): Promise<InitResult> {\n  const {\n    configDir = getConfigDir(),\n    dataDir = getDataDir(),\n    force = false,\n  } = options;\n\n  const configPath = join(configDir, 'config.toml');\n  const sessionsDir = join(dataDir, 'sessions');\n\n  const result: InitResult = {\n    success: false,\n    configPath,\n    sessionsDir,\n    configDir,\n    dataDir,\n  };\n\n  // Check if config directory already exists\n  if (await exists(configDir)) {\n    if (!force) {\n      return {\n        ...result,\n        alreadyExists: true,\n        message: `Configuration directory already exists at ${configDir}. Use --force to overwrite.`,\n      };\n    }\n    result.overwritten = true;\n  }\n\n  // Create directories\n  await mkdir(configDir, { recursive: true });\n  await mkdir(sessionsDir, { recursive: true });\n\n  // Generate and write config file\n  // Use the default sessions directory for the saved config\n  const defaultConfig = getDefaultConfig();\n  // Set session.directory to the actual sessions path for the config file\n  defaultConfig.session.directory = sessionsDir;\n  const configContent = generateConfigContent(defaultConfig);\n  await writeFile(configPath, configContent, 'utf-8');\n\n  return {\n    ...result,\n    success: true,\n    message: result.overwritten\n      ? `Configuration overwritten at ${configDir}`\n      : `Configuration created at ${configDir}`,\n  };\n}\n"],"names":["stringifyToml"],"mappings":"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"}
+{"version":3,"file":"init.js","sources":["../../../src/cli/commands/init.ts"],"sourcesContent":["import { mkdir, writeFile, access, constants } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { stringify as stringifyToml } from '@iarna/toml';\nimport { getDefaultConfig } from '../../config/index.js';\nimport { getConfigDir, getDataDir } from '../../config/paths.js';\nimport type { Config } from '../../config/index.js';\n\n/**\n * Options for the init command.\n */\nexport interface InitOptions {\n  /** Config directory (defaults to platform-specific via getConfigDir()) */\n  configDir?: string;\n  /** Data directory (defaults to platform-specific via getDataDir()) */\n  dataDir?: string;\n  /** Force overwrite if directory already exists */\n  force?: boolean;\n}\n\n/**\n * Result of the init command.\n */\nexport interface InitResult {\n  /** Whether initialization was successful */\n  success: boolean;\n  /** Path to the created config file */\n  configPath: string;\n  /** Path to the sessions directory */\n  sessionsDir: string;\n  /** Path to the config directory */\n  configDir: string;\n  /** Path to the data directory */\n  dataDir: string;\n  /** Whether files already existed (only when success=false) */\n  alreadyExists?: boolean;\n  /** Whether existing files were overwritten (only when force=true) */\n  overwritten?: boolean;\n  /** Message describing the result */\n  message?: string;\n}\n\n/**\n * Check if a file or directory exists.\n */\nasync function exists(path: string): Promise<boolean> {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Convert Config to TOML-compatible object.\n * Removes undefined values and converts to the expected format.\n */\nfunction configToToml(config: Config): Record<string, unknown> {\n  return {\n    session: {\n      directory: config.session.directory,\n    },\n    log: {\n      level: config.log.level,\n    },\n    output: {\n      color: config.output.color,\n      progress_bar: config.output.progress_bar,\n    },\n    providers: {\n      pubmed: {\n        enabled: config.providers.pubmed.enabled,\n        api_key: config.providers.pubmed.api_key ?? '',\n        email: config.providers.pubmed.email ?? '',\n        rate_limit: config.providers.pubmed.rate_limit,\n        timeout: config.providers.pubmed.timeout,\n        retries: config.providers.pubmed.retries,\n        max_results: config.providers.pubmed.max_results,\n      },\n      eric: {\n        enabled: config.providers.eric.enabled,\n        rate_limit: config.providers.eric.rate_limit,\n        timeout: config.providers.eric.timeout,\n        retries: config.providers.eric.retries,\n        max_results: config.providers.eric.max_results,\n      },\n      arxiv: {\n        enabled: config.providers.arxiv.enabled,\n        rate_limit: config.providers.arxiv.rate_limit,\n        timeout: config.providers.arxiv.timeout,\n        retries: config.providers.arxiv.retries,\n        max_results: config.providers.arxiv.max_results,\n      },\n      scopus: {\n        enabled: config.providers.scopus.enabled,\n        api_key: config.providers.scopus.api_key ?? '',\n        inst_token: config.providers.scopus.inst_token ?? '',\n        rate_limit: config.providers.scopus.rate_limit,\n        timeout: config.providers.scopus.timeout,\n        retries: config.providers.scopus.retries,\n        max_results: config.providers.scopus.max_results,\n      },\n      wos: {\n        enabled: config.providers.wos.enabled,\n        api_key: config.providers.wos.api_key ?? '',\n        rate_limit: config.providers.wos.rate_limit,\n        timeout: config.providers.wos.timeout,\n        retries: config.providers.wos.retries,\n        max_results: config.providers.wos.max_results,\n      },\n      embase: {\n        enabled: config.providers.embase.enabled,\n        rate_limit: config.providers.embase.rate_limit,\n        timeout: config.providers.embase.timeout,\n        retries: config.providers.embase.retries,\n        max_results: config.providers.embase.max_results,\n      },\n    },\n    integration: {\n      reference_manager: {\n        enabled: config.integration.reference_manager.enabled,\n        command: config.integration.reference_manager.command,\n        auto_register: config.integration.reference_manager.auto_register,\n      },\n    },\n  };\n}\n\n/**\n * Generate TOML config file content with comments.\n */\nfunction generateConfigContent(config: Config): string {\n  const tomlObj = configToToml(config);\n  const header = `# search-hub configuration file\n# See: https://github.com/search-hub/search-hub for documentation\n\n`;\n  return header + stringifyToml(tomlObj as Parameters<typeof stringifyToml>[0]);\n}\n\n/**\n * Initialize the search-hub configuration directory.\n *\n * Creates:\n * - Config directory with config.toml\n * - Data directory with sessions/ subdirectory\n *\n * On Linux (XDG):\n * - ~/.config/search-hub/config.toml\n * - ~/.local/share/search-hub/sessions/\n */\nexport async function init(options: InitOptions = {}): Promise<InitResult> {\n  const {\n    configDir = getConfigDir(),\n    dataDir = getDataDir(),\n    force = false,\n  } = options;\n\n  const configPath = join(configDir, 'config.toml');\n  const sessionsDir = join(dataDir, 'sessions');\n  const queriesDir = join(dataDir, 'queries');\n\n  const result: InitResult = {\n    success: false,\n    configPath,\n    sessionsDir,\n    configDir,\n    dataDir,\n  };\n\n  // Check if config directory already exists\n  if (await exists(configDir)) {\n    if (!force) {\n      return {\n        ...result,\n        alreadyExists: true,\n        message: `Configuration directory already exists at ${configDir}. Use --force to overwrite.`,\n      };\n    }\n    result.overwritten = true;\n  }\n\n  // Create directories\n  await mkdir(configDir, { recursive: true });\n  await mkdir(sessionsDir, { recursive: true });\n  await mkdir(queriesDir, { recursive: true });\n\n  // Generate and write config file\n  // Use the default sessions directory for the saved config\n  const defaultConfig = getDefaultConfig();\n  // Set session.directory to the actual sessions path for the config file\n  defaultConfig.session.directory = sessionsDir;\n  const configContent = generateConfigContent(defaultConfig);\n  await writeFile(configPath, configContent, 'utf-8');\n\n  return {\n    ...result,\n    success: true,\n    message: result.overwritten\n      ? `Configuration overwritten at ${configDir}`\n      : `Configuration created at ${configDir}`,\n  };\n}\n"],"names":["stringifyToml"],"mappings":"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"}

package/dist/cli/commands/query/init.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Sanitize a title string into a safe filename (without extension).
+ */
+export declare function sanitizeForFilename(title: string): string;
 /**
  * The YAML template string with comments preserved.
  * This is a raw string (not generated by a YAML library) so comments are kept.
@@ -6,22 +10,29 @@ export declare const QUERY_SCHEMA_FILENAME = "query.schema.json";
 /**
  * Generate the query template YAML string.
  *
+ * @param title - Optional title to set as the query name
  * @returns The YAML template string with comments
  */
-export declare function generateQueryTemplate(): string;
+export declare function generateQueryTemplate(title?: string): string;
+export declare const QUERIES_DIR = "queries";
+export interface WriteQueryTemplateOptions {
+    title: string;
+    output?: string | undefined;
+    stdout?: boolean | undefined;
+    force?: boolean | undefined;
+    cwd?: string | undefined;
+}
 /**
  * Write the query template to a file or return it as a message.
  *
- * @param options - Output options
- * @param options.output - File path to write to (if omitted, returns template in message)
- * @param options.force - Whether to overwrite existing files
- * @returns Result with success status and message
+ * Output priority:
+ * 1. --stdout → return template as message (no file)
+ * 2. -o <path> → write to that path
+ * 3. default → write to queries/<sanitized-title>.yaml
  */
-export declare function writeQueryTemplate(options: {
-    output?: string;
-    force?: boolean;
-}): Promise<{
+export declare function writeQueryTemplate(options: WriteQueryTemplateOptions): Promise<{
     success: boolean;
     message: string;
+    outputPath?: string;
 }>;
 //# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/query/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/query/init.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AA2DzD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAkCjD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/query/init.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYzD;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AA2DzD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwChJ"}

package/dist/cli/commands/query/init.js

@@ -1,6 +1,13 @@
-import { access, writeFile } from "node:fs/promises";
+import { access, mkdir, writeFile } from "node:fs/promises";
 import { join, dirname } from "node:path";
 import { generateQueryJSONSchema } from "../../../query/json-schema.js";
+function sanitizeForFilename(title) {
+  const result = title.trim().toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9_-]/g, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  if (!result) {
+    throw new Error("Title produces an empty filename after sanitization");
+  }
+  return result;
+}
 const QUERY_SCHEMA_FILENAME = "query.schema.json";
 const QUERY_TEMPLATE = `# yaml-language-server: $schema=./${QUERY_SCHEMA_FILENAME}
 name: my_search
@@ -57,36 +64,44 @@ query:
 #           exclude:
 #             - "Letter"
 `;
-function generateQueryTemplate() {
-  return QUERY_TEMPLATE;
+function generateQueryTemplate(title) {
+  if (!title) return QUERY_TEMPLATE;
+  const escaped = title.replace(/"/g, '\\"');
+  return QUERY_TEMPLATE.replace("name: my_search", `name: "${escaped}"`);
 }
+const QUERIES_DIR = "queries";
 async function writeQueryTemplate(options) {
-  const template = generateQueryTemplate();
-  if (!options.output) {
+  const template = generateQueryTemplate(options.title);
+  if (options.stdout) {
     return { success: true, message: template };
   }
+  const outputPath = options.output ?? join(options.cwd ?? process.cwd(), QUERIES_DIR, `${sanitizeForFilename(options.title)}.yaml`);
   if (!options.force) {
     try {
-      await access(options.output);
+      await access(outputPath);
       return {
         success: false,
-        message: `File already exists: ${options.output}. Use --force to overwrite.`
+        message: `File already exists: ${outputPath}. Use --force to overwrite.`
       };
     } catch {
     }
   }
-  await writeFile(options.output, template, "utf-8");
-  const schemaPath = join(dirname(options.output), QUERY_SCHEMA_FILENAME);
+  await mkdir(dirname(outputPath), { recursive: true });
+  await writeFile(outputPath, template, "utf-8");
+  const schemaPath = join(dirname(outputPath), QUERY_SCHEMA_FILENAME);
   const jsonSchema = generateQueryJSONSchema();
   await writeFile(schemaPath, JSON.stringify(jsonSchema, null, 2) + "\n", "utf-8");
   return {
     success: true,
-    message: `Template written to ${options.output}`
+    message: `Created: ${outputPath}`,
+    outputPath
   };
 }
 export {
+  QUERIES_DIR,
   QUERY_SCHEMA_FILENAME,
   generateQueryTemplate,
+  sanitizeForFilename,
   writeQueryTemplate
 };
 //# sourceMappingURL=init.js.map

package/dist/cli/commands/query/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sources":["../../../../src/cli/commands/query/init.ts"],"sourcesContent":["/**\n * Query init command implementation.\n *\n * Generates a skeleton YAML query file with helpful comments.\n */\nimport { writeFile as fsWriteFile, access } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport { generateQueryJSONSchema } from \"../../../query/json-schema.js\";\n\n/**\n * The YAML template string with comments preserved.\n * This is a raw string (not generated by a YAML library) so comments are kept.\n */\nexport const QUERY_SCHEMA_FILENAME = \"query.schema.json\";\n\n// prettier-ignore\nconst QUERY_TEMPLATE =\n  `# yaml-language-server: $schema=./${QUERY_SCHEMA_FILENAME}\\n` +\n  \"name: my_search\\n\" +\n  \"description: \\\"\\\"\\n\" +\n  \"\\n\" +\n  \"query:\\n\" +\n  \"  - id: concept-1             # Unique block identifier (for provider replacements)\\n\" +\n  \"    field: title_abstract    # title, abstract, title_abstract, author, keyword, all\\n\" +\n  \"    terms:\\n\" +\n  \"      keywords:\\n\" +\n  \"        - \\\"search term 1\\\"\\n\" +\n  \"        - \\\"search term 2\\\"\\n\" +\n  \"      # mesh:                 # PubMed MeSH terms (optional)\\n\" +\n  \"      #   - \\\"MeSH Heading\\\"\\n\" +\n  \"      # eric:                 # ERIC Descriptors (optional, ERIC only)\\n\" +\n  \"      #   - \\\"ERIC Descriptor\\\"\\n\" +\n  \"      exclude: []             # Terms to exclude (NOT operator)\\n\" +\n  \"      # Tip: Use exclude to filter out false matches from short keywords/acronyms\\n\" +\n  \"      # exclude:\\n\" +\n  \"      #   - \\\"unwanted term\\\"\\n\" +\n  \"      #   - \\\"irrelevant topic\\\"\\n\" +\n  \"    operator: OR             # How to combine terms within this block\\n\" +\n  \"\\n\" +\n  \"  # Add more blocks — blocks are AND'd together\\n\" +\n  \"  # - id: concept-2\\n\" +\n  \"  #   field: title_abstract\\n\" +\n  \"  #   terms:\\n\" +\n  \"  #     keywords:\\n\" +\n  \"  #       - \\\"another term\\\"\\n\" +\n  \"  #   operator: OR\\n\" +\n  \"\\n\" +\n  \"# filters:                   # Optional: apply to all databases\\n\" +\n  \"#   year_from: 2020\\n\" +\n  \"#   year_to: 2026\\n\" +\n  \"#   language:\\n\" +\n  \"#     - en\\n\" +\n  \"#   publication_types:\\n\" +\n  \"#     exclude:\\n\" +\n  \"#       - \\\"Review\\\"\\n\" +\n  \"#       - \\\"Comment\\\"\\n\" +\n  \"\\n\" +\n  \"# providers:                 # Optional: per-database block replacements & filter additions\\n\" +\n  \"#   pubmed:\\n\" +\n  \"#     replaces:\\n\" +\n  \"#       concept-1:           # Replace block by id\\n\" +\n  \"#         field: keyword\\n\" +\n  \"#         terms:\\n\" +\n  \"#           mesh:\\n\" +\n  \"#             - \\\"MeSH Heading\\\"\\n\" +\n  \"#         operator: OR\\n\" +\n  \"#     adds:\\n\" +\n  \"#       filters:\\n\" +\n  \"#         publication_types:\\n\" +\n  \"#           exclude:\\n\" +\n  \"#             - \\\"Letter\\\"\\n\";\n\n/**\n * Generate the query template YAML string.\n *\n * @returns The YAML template string with comments\n */\nexport function generateQueryTemplate(): string {\n  return QUERY_TEMPLATE;\n}\n\n/**\n * Write the query template to a file or return it as a message.\n *\n * @param options - Output options\n * @param options.output - File path to write to (if omitted, returns template in message)\n * @param options.force - Whether to overwrite existing files\n * @returns Result with success status and message\n */\nexport async function writeQueryTemplate(options: {\n  output?: string;\n  force?: boolean;\n}): Promise<{ success: boolean; message: string }> {\n  const template = generateQueryTemplate();\n\n  if (!options.output) {\n    // No output file specified, return template as message\n    return { success: true, message: template };\n  }\n\n  // Check if file exists (unless force is set)\n  if (!options.force) {\n    try {\n      await access(options.output);\n      // File exists and force is not set\n      return {\n        success: false,\n        message: `File already exists: ${options.output}. Use --force to overwrite.`,\n      };\n    } catch {\n      // File does not exist, proceed\n    }\n  }\n\n  // Write to file\n  await fsWriteFile(options.output, template, \"utf-8\");\n\n  // Generate JSON Schema file alongside output\n  const schemaPath = join(dirname(options.output), QUERY_SCHEMA_FILENAME);\n  const jsonSchema = generateQueryJSONSchema();\n  await fsWriteFile(schemaPath, JSON.stringify(jsonSchema, null, 2) + \"\\n\", \"utf-8\");\n\n  return {\n    success: true,\n    message: `Template written to ${options.output}`,\n  };\n}\n"],"names":["fsWriteFile"],"mappings":";;;AAaO,MAAM,wBAAwB;AAGrC,MAAM,iBACJ,qCAAqC,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4DrD,SAAS,wBAAgC;AAC9C,SAAO;AACT;AAUA,eAAsB,mBAAmB,SAGU;AACjD,QAAM,WAAW,sBAAA;AAEjB,MAAI,CAAC,QAAQ,QAAQ;AAEnB,WAAO,EAAE,SAAS,MAAM,SAAS,SAAA;AAAA,EACnC;AAGA,MAAI,CAAC,QAAQ,OAAO;AAClB,QAAI;AACF,YAAM,OAAO,QAAQ,MAAM;AAE3B,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,wBAAwB,QAAQ,MAAM;AAAA,MAAA;AAAA,IAEnD,QAAQ;AAAA,IAER;AAAA,EACF;AAGA,QAAMA,UAAY,QAAQ,QAAQ,UAAU,OAAO;AAGnD,QAAM,aAAa,KAAK,QAAQ,QAAQ,MAAM,GAAG,qBAAqB;AACtE,QAAM,aAAa,wBAAA;AACnB,QAAMA,UAAY,YAAY,KAAK,UAAU,YAAY,MAAM,CAAC,IAAI,MAAM,OAAO;AAEjF,SAAO;AAAA,IACL,SAAS;AAAA,IACT,SAAS,uBAAuB,QAAQ,MAAM;AAAA,EAAA;AAElD;"}
+{"version":3,"file":"init.js","sources":["../../../../src/cli/commands/query/init.ts"],"sourcesContent":["/**\n * Query init command implementation.\n *\n * Generates a skeleton YAML query file with helpful comments.\n */\nimport { writeFile as fsWriteFile, access, mkdir } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport { generateQueryJSONSchema } from \"../../../query/json-schema.js\";\n\n/**\n * Sanitize a title string into a safe filename (without extension).\n */\nexport function sanitizeForFilename(title: string): string {\n  const result = title\n    .trim()\n    .toLowerCase()\n    .replace(/\\s+/g, '-')\n    .replace(/[^a-z0-9_-]/g, '')\n    .replace(/-+/g, '-')\n    .replace(/^-|-$/g, '');\n  if (!result) {\n    throw new Error('Title produces an empty filename after sanitization');\n  }\n  return result;\n}\n\n/**\n * The YAML template string with comments preserved.\n * This is a raw string (not generated by a YAML library) so comments are kept.\n */\nexport const QUERY_SCHEMA_FILENAME = \"query.schema.json\";\n\n// prettier-ignore\nconst QUERY_TEMPLATE =\n  `# yaml-language-server: $schema=./${QUERY_SCHEMA_FILENAME}\\n` +\n  \"name: my_search\\n\" +\n  \"description: \\\"\\\"\\n\" +\n  \"\\n\" +\n  \"query:\\n\" +\n  \"  - id: concept-1             # Unique block identifier (for provider replacements)\\n\" +\n  \"    field: title_abstract    # title, abstract, title_abstract, author, keyword, all\\n\" +\n  \"    terms:\\n\" +\n  \"      keywords:\\n\" +\n  \"        - \\\"search term 1\\\"\\n\" +\n  \"        - \\\"search term 2\\\"\\n\" +\n  \"      # mesh:                 # PubMed MeSH terms (optional)\\n\" +\n  \"      #   - \\\"MeSH Heading\\\"\\n\" +\n  \"      # eric:                 # ERIC Descriptors (optional, ERIC only)\\n\" +\n  \"      #   - \\\"ERIC Descriptor\\\"\\n\" +\n  \"      exclude: []             # Terms to exclude (NOT operator)\\n\" +\n  \"      # Tip: Use exclude to filter out false matches from short keywords/acronyms\\n\" +\n  \"      # exclude:\\n\" +\n  \"      #   - \\\"unwanted term\\\"\\n\" +\n  \"      #   - \\\"irrelevant topic\\\"\\n\" +\n  \"    operator: OR             # How to combine terms within this block\\n\" +\n  \"\\n\" +\n  \"  # Add more blocks — blocks are AND'd together\\n\" +\n  \"  # - id: concept-2\\n\" +\n  \"  #   field: title_abstract\\n\" +\n  \"  #   terms:\\n\" +\n  \"  #     keywords:\\n\" +\n  \"  #       - \\\"another term\\\"\\n\" +\n  \"  #   operator: OR\\n\" +\n  \"\\n\" +\n  \"# filters:                   # Optional: apply to all databases\\n\" +\n  \"#   year_from: 2020\\n\" +\n  \"#   year_to: 2026\\n\" +\n  \"#   language:\\n\" +\n  \"#     - en\\n\" +\n  \"#   publication_types:\\n\" +\n  \"#     exclude:\\n\" +\n  \"#       - \\\"Review\\\"\\n\" +\n  \"#       - \\\"Comment\\\"\\n\" +\n  \"\\n\" +\n  \"# providers:                 # Optional: per-database block replacements & filter additions\\n\" +\n  \"#   pubmed:\\n\" +\n  \"#     replaces:\\n\" +\n  \"#       concept-1:           # Replace block by id\\n\" +\n  \"#         field: keyword\\n\" +\n  \"#         terms:\\n\" +\n  \"#           mesh:\\n\" +\n  \"#             - \\\"MeSH Heading\\\"\\n\" +\n  \"#         operator: OR\\n\" +\n  \"#     adds:\\n\" +\n  \"#       filters:\\n\" +\n  \"#         publication_types:\\n\" +\n  \"#           exclude:\\n\" +\n  \"#             - \\\"Letter\\\"\\n\";\n\n/**\n * Generate the query template YAML string.\n *\n * @param title - Optional title to set as the query name\n * @returns The YAML template string with comments\n */\nexport function generateQueryTemplate(title?: string): string {\n  if (!title) return QUERY_TEMPLATE;\n  const escaped = title.replace(/\"/g, '\\\\\"');\n  return QUERY_TEMPLATE.replace('name: my_search', `name: \"${escaped}\"`);\n}\n\nexport const QUERIES_DIR = \"queries\";\n\nexport interface WriteQueryTemplateOptions {\n  title: string;\n  output?: string | undefined;\n  stdout?: boolean | undefined;\n  force?: boolean | undefined;\n  cwd?: string | undefined;\n}\n\n/**\n * Write the query template to a file or return it as a message.\n *\n * Output priority:\n * 1. --stdout → return template as message (no file)\n * 2. -o <path> → write to that path\n * 3. default → write to queries/<sanitized-title>.yaml\n */\nexport async function writeQueryTemplate(options: WriteQueryTemplateOptions): Promise<{ success: boolean; message: string; outputPath?: string }> {\n  const template = generateQueryTemplate(options.title);\n\n  if (options.stdout) {\n    return { success: true, message: template };\n  }\n\n  // Determine output path\n  const outputPath = options.output\n    ?? join(options.cwd ?? process.cwd(), QUERIES_DIR, `${sanitizeForFilename(options.title)}.yaml`);\n\n  // Check if file exists (unless force is set)\n  if (!options.force) {\n    try {\n      await access(outputPath);\n      return {\n        success: false,\n        message: `File already exists: ${outputPath}. Use --force to overwrite.`,\n      };\n    } catch {\n      // File does not exist, proceed\n    }\n  }\n\n  // Ensure parent directory exists\n  await mkdir(dirname(outputPath), { recursive: true });\n\n  // Write template\n  await fsWriteFile(outputPath, template, \"utf-8\");\n\n  // Generate JSON Schema file alongside output\n  const schemaPath = join(dirname(outputPath), QUERY_SCHEMA_FILENAME);\n  const jsonSchema = generateQueryJSONSchema();\n  await fsWriteFile(schemaPath, JSON.stringify(jsonSchema, null, 2) + \"\\n\", \"utf-8\");\n\n  return {\n    success: true,\n    message: `Created: ${outputPath}`,\n    outputPath,\n  };\n}\n"],"names":["fsWriteFile"],"mappings":";;;AAYO,SAAS,oBAAoB,OAAuB;AACzD,QAAM,SAAS,MACZ,KAAA,EACA,cACA,QAAQ,QAAQ,GAAG,EACnB,QAAQ,gBAAgB,EAAE,EAC1B,QAAQ,OAAO,GAAG,EAClB,QAAQ,UAAU,EAAE;AACvB,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,SAAO;AACT;AAMO,MAAM,wBAAwB;AAGrC,MAAM,iBACJ,qCAAqC,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6DrD,SAAS,sBAAsB,OAAwB;AAC5D,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,UAAU,MAAM,QAAQ,MAAM,KAAK;AACzC,SAAO,eAAe,QAAQ,mBAAmB,UAAU,OAAO,GAAG;AACvE;AAEO,MAAM,cAAc;AAkB3B,eAAsB,mBAAmB,SAAyG;AAChJ,QAAM,WAAW,sBAAsB,QAAQ,KAAK;AAEpD,MAAI,QAAQ,QAAQ;AAClB,WAAO,EAAE,SAAS,MAAM,SAAS,SAAA;AAAA,EACnC;AAGA,QAAM,aAAa,QAAQ,UACtB,KAAK,QAAQ,OAAO,QAAQ,IAAA,GAAO,aAAa,GAAG,oBAAoB,QAAQ,KAAK,CAAC,OAAO;AAGjG,MAAI,CAAC,QAAQ,OAAO;AAClB,QAAI;AACF,YAAM,OAAO,UAAU;AACvB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,wBAAwB,UAAU;AAAA,MAAA;AAAA,IAE/C,QAAQ;AAAA,IAER;AAAA,EACF;AAGA,QAAM,MAAM,QAAQ,UAAU,GAAG,EAAE,WAAW,MAAM;AAGpD,QAAMA,UAAY,YAAY,UAAU,OAAO;AAG/C,QAAM,aAAa,KAAK,QAAQ,UAAU,GAAG,qBAAqB;AAClE,QAAM,aAAa,wBAAA;AACnB,QAAMA,UAAY,YAAY,KAAK,UAAU,YAAY,MAAM,CAAC,IAAI,MAAM,OAAO;AAEjF,SAAO;AAAA,IACL,SAAS;AAAA,IACT,SAAS,YAAY,UAAU;AAAA,IAC/B;AAAA,EAAA;AAEJ;"}

package/dist/cli/commands/query/resolve.d.ts

@@ -0,0 +1,5 @@
+export declare class NotAFileError extends Error {
+    constructor(path: string);
+}
+export declare function resolveQueryFile(arg: string): Promise<string>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/cli/commands/query/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/query/resolve.ts"],"names":[],"mappings":"AAYA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,IAAI,EAAE,MAAM;CAIzB;AAiBD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0CnE"}

package/dist/cli/commands/query/resolve.js

@@ -0,0 +1,59 @@
+import { stat } from "node:fs/promises";
+class NotAFileError extends Error {
+  constructor(path) {
+    super(`Path is not a file: ${path}`);
+    this.name = "NotAFileError";
+  }
+}
+async function isFile(path) {
+  try {
+    const s = await stat(path);
+    if (!s.isFile()) {
+      throw new NotAFileError(path);
+    }
+    return true;
+  } catch (error) {
+    if (error instanceof NotAFileError) {
+      throw error;
+    }
+    return false;
+  }
+}
+async function resolveQueryFile(arg) {
+  if (await isFile(arg)) {
+    return arg;
+  }
+  const candidates = [];
+  if (!arg.endsWith(".yaml") && !arg.endsWith(".yml")) {
+    const withExt = `${arg}.yaml`;
+    candidates.push(withExt);
+    if (await isFile(withExt)) {
+      return withExt;
+    }
+  }
+  const basename = arg.endsWith(".yaml") || arg.endsWith(".yml") ? arg : `${arg}.yaml`;
+  const inQueries = `queries/${basename}`;
+  candidates.push(inQueries);
+  if (await isFile(inQueries)) {
+    return inQueries;
+  }
+  if (!arg.endsWith(".yaml") && !arg.endsWith(".yml")) {
+    const inQueriesYml = `queries/${arg}.yml`;
+    candidates.push(inQueriesYml);
+    if (await isFile(inQueriesYml)) {
+      return inQueriesYml;
+    }
+  }
+  const tried = [`./${arg}`, ...candidates.map((c) => `./${c}`)];
+  throw new Error(
+    `Query file not found: "${arg}"
+  Tried:
+` + tried.map((p) => `    ${p}`).join("\n") + `
+  Create a new query: search-hub query init "${arg}"`
+  );
+}
+export {
+  NotAFileError,
+  resolveQueryFile
+};
+//# sourceMappingURL=resolve.js.map

package/dist/cli/commands/query/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sources":["../../../../src/cli/commands/query/resolve.ts"],"sourcesContent":["/**\n * Smart query file resolution.\n *\n * Resolution order:\n * 1. Exact path exists → use it\n * 2. <arg>.yaml exists → use it\n * 3. queries/<arg>.yaml exists → use it\n * 4. queries/<arg>.yml exists → use it\n * 5. Error with tried paths\n */\nimport { stat } from 'node:fs/promises';\n\nexport class NotAFileError extends Error {\n  constructor(path: string) {\n    super(`Path is not a file: ${path}`);\n    this.name = 'NotAFileError';\n  }\n}\n\nasync function isFile(path: string): Promise<boolean> {\n  try {\n    const s = await stat(path);\n    if (!s.isFile()) {\n      throw new NotAFileError(path);\n    }\n    return true;\n  } catch (error) {\n    if (error instanceof NotAFileError) {\n      throw error;\n    }\n    return false;\n  }\n}\n\nexport async function resolveQueryFile(arg: string): Promise<string> {\n  // 1. Exact path\n  if (await isFile(arg)) {\n    return arg;\n  }\n\n  const candidates: string[] = [];\n\n  // 2. arg + .yaml (skip if already ends with .yaml)\n  if (!arg.endsWith('.yaml') && !arg.endsWith('.yml')) {\n    const withExt = `${arg}.yaml`;\n    candidates.push(withExt);\n    if (await isFile(withExt)) {\n      return withExt;\n    }\n  }\n\n  // 3. queries/<arg>.yaml\n  const basename = arg.endsWith('.yaml') || arg.endsWith('.yml') ? arg : `${arg}.yaml`;\n  const inQueries = `queries/${basename}`;\n  candidates.push(inQueries);\n  if (await isFile(inQueries)) {\n    return inQueries;\n  }\n\n  // 4. queries/<arg>.yml (skip if arg already has extension)\n  if (!arg.endsWith('.yaml') && !arg.endsWith('.yml')) {\n    const inQueriesYml = `queries/${arg}.yml`;\n    candidates.push(inQueriesYml);\n    if (await isFile(inQueriesYml)) {\n      return inQueriesYml;\n    }\n  }\n\n  // 5. Error\n  const tried = [`./${arg}`, ...candidates.map(c => `./${c}`)];\n  throw new Error(\n    `Query file not found: \"${arg}\"\\n` +\n    `  Tried:\\n` +\n    tried.map(p => `    ${p}`).join('\\n') + '\\n' +\n    `  Create a new query: search-hub query init \"${arg}\"`\n  );\n}\n"],"names":[],"mappings":";AAYO,MAAM,sBAAsB,MAAM;AAAA,EACvC,YAAY,MAAc;AACxB,UAAM,uBAAuB,IAAI,EAAE;AACnC,SAAK,OAAO;AAAA,EACd;AACF;AAEA,eAAe,OAAO,MAAgC;AACpD,MAAI;AACF,UAAM,IAAI,MAAM,KAAK,IAAI;AACzB,QAAI,CAAC,EAAE,UAAU;AACf,YAAM,IAAI,cAAc,IAAI;AAAA,IAC9B;AACA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,QAAI,iBAAiB,eAAe;AAClC,YAAM;AAAA,IACR;AACA,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,iBAAiB,KAA8B;AAEnE,MAAI,MAAM,OAAO,GAAG,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,QAAM,aAAuB,CAAA;AAG7B,MAAI,CAAC,IAAI,SAAS,OAAO,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG;AACnD,UAAM,UAAU,GAAG,GAAG;AACtB,eAAW,KAAK,OAAO;AACvB,QAAI,MAAM,OAAO,OAAO,GAAG;AACzB,aAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAM,WAAW,IAAI,SAAS,OAAO,KAAK,IAAI,SAAS,MAAM,IAAI,MAAM,GAAG,GAAG;AAC7E,QAAM,YAAY,WAAW,QAAQ;AACrC,aAAW,KAAK,SAAS;AACzB,MAAI,MAAM,OAAO,SAAS,GAAG;AAC3B,WAAO;AAAA,EACT;AAGA,MAAI,CAAC,IAAI,SAAS,OAAO,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG;AACnD,UAAM,eAAe,WAAW,GAAG;AACnC,eAAW,KAAK,YAAY;AAC5B,QAAI,MAAM,OAAO,YAAY,GAAG;AAC9B,aAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAM,QAAQ,CAAC,KAAK,GAAG,IAAI,GAAG,WAAW,IAAI,CAAA,MAAK,KAAK,CAAC,EAAE,CAAC;AAC3D,QAAM,IAAI;AAAA,IACR,0BAA0B,GAAG;AAAA;AAAA,IAE7B,MAAM,IAAI,CAAA,MAAK,OAAO,CAAC,EAAE,EAAE,KAAK,IAAI,IAAI;AAAA,+CACQ,GAAG;AAAA,EAAA;AAEvD;"}

package/dist/cli/commands/register.d.ts

@@ -89,6 +89,14 @@ export declare function formatNoIncludedArticlesError(summary: ReviewSummary, se
  * Format warning when pending articles exist with --reviewed.
  */
 export declare function formatPendingWarning(summary: ReviewSummary): string;
+/**
+ * Format library path display for CLI output.
+ */
+export declare function formatLibraryPath(sessionDir: string): string;
+/**
+ * Format hint for importing into default ref library.
+ */
+export declare function formatDefaultLibraryHint(sessionDir: string): string;
 /**
  * Format note when --all is used with reviews.yaml present.
  */

package/dist/cli/commands/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAU,MAAM,+BAA+B,CAAC;AAInF,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,gCAAgC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,GAC1B,sBAAsB,CAgBxB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CASvF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAsBT;AAgBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAuD9D;AAaD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ5F;AAWD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2BrG;AAiBD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA6CpG;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAU7F;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK/F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAMnE;AAGD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,GAAE,MAAM,CAAC,cAA8B,EAC5C,MAAM,GAAE,MAAM,CAAC,cAA+B,GAC7C,OAAO,CAAC,OAAO,CAAC,CAelB"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAU,MAAM,+BAA+B,CAAC;AAInF,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,gCAAgC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,GAC1B,sBAAsB,CAgBxB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CASvF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAsBT;AAgBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAuD9D;AAaD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ5F;AAWD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2BrG;AAiBD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA6CpG;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAU7F;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK/F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAMnE;AAGD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,GAAE,MAAM,CAAC,cAA8B,EAC5C,MAAM,GAAE,MAAM,CAAC,cAA+B,GAC7C,OAAO,CAAC,OAAO,CAAC,CAelB"}

package/dist/cli/commands/register.js

@@ -199,6 +199,13 @@ Registering ${summary.included} included articles...
 
 Proceed? [Y/n]`;
 }
+function formatLibraryPath(sessionDir) {
+  return `Library: ${join(sessionDir, "references.json")}`;
+}
+function formatDefaultLibraryHint(sessionDir) {
+  return `To also add to your default ref library:
+  ref add -i json "${join(sessionDir, "references.json")}"`;
+}
 function formatIgnoringReviewsNote(total) {
   return `Note: Ignoring review decisions. Registering all ${total} articles.`;
 }
@@ -218,8 +225,10 @@ async function confirmPrompt(input = process.stdin, output = process.stdout) {
 }
 export {
   confirmPrompt,
+  formatDefaultLibraryHint,
   formatDryRunOutput,
   formatIgnoringReviewsNote,
+  formatLibraryPath,
   formatNoIncludedArticlesError,
   formatPendingWarning,
   formatRegistrationSummary,

package/dist/cli/commands/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sources":["../../../src/cli/commands/register.ts"],"sourcesContent":["/**\n * Register command for reference-manager integration.\n * Registers search results with reference-manager CLI.\n */\n\nimport { join } from 'node:path';\nimport { readFile, access } from 'node:fs/promises';\nimport { constants } from 'node:fs';\nimport { createInterface } from 'node:readline';\nimport { parse as parseYaml } from 'yaml';\nimport type { ProviderName, Article, Author } from '../../providers/base/types.js';\nimport { parseProviderNames } from '../utils/validation.js';\nimport { classifyStatus, type ReviewFile } from './review/types.js';\n\nexport interface RegisterCommandOptions {\n  sessionId: string;\n  providers?: ProviderName[];\n  dryRun: boolean;\n  withAbstracts: boolean;\n  /** Register only reviewed articles with finalDecision='include' */\n  reviewed?: boolean;\n  /** Register all articles, ignoring reviews */\n  all?: boolean;\n  /** Skip confirmation prompts */\n  force?: boolean;\n  /** Suppress tips and suggestions */\n  quiet?: boolean;\n}\n\nexport interface CommandLineOptions {\n  db?: string | undefined;\n  dryRun?: boolean | undefined;\n  withAbstracts?: boolean | undefined;\n  reviewed?: boolean | undefined;\n  all?: boolean | undefined;\n  force?: boolean | undefined;\n  quiet?: boolean | undefined;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  error?: string;\n}\n\n/**\n * Parse command line options into RegisterCommandOptions.\n */\nexport function parseRegisterOptions(\n  sessionId: string,\n  options: CommandLineOptions\n): RegisterCommandOptions {\n  const result: RegisterCommandOptions = {\n    sessionId,\n    dryRun: options.dryRun ?? false,\n    withAbstracts: options.withAbstracts ?? false,\n    reviewed: options.reviewed ?? false,\n    all: options.all ?? false,\n    force: options.force ?? false,\n    quiet: options.quiet ?? false,\n  };\n\n  if (options.db) {\n    result.providers = parseProviderNames(options.db);\n  }\n\n  return result;\n}\n\n/**\n * Validate register command input.\n */\nexport function validateRegisterInput(options: RegisterCommandOptions): ValidationResult {\n  if (!options.sessionId || options.sessionId.trim() === '') {\n    return {\n      valid: false,\n      error: 'A session ID is required',\n    };\n  }\n\n  return { valid: true };\n}\n\n/**\n * Format registration summary for CLI output.\n */\nexport function formatRegistrationSummary(summary: {\n  total: number;\n  added: number;\n  skipped: number;\n  failed: number;\n  noId: number;\n}): string {\n  const lines: string[] = ['Registration complete:'];\n\n  // Added\n  lines.push(`  ✓ ${summary.added} added`);\n\n  // Duplicates (skipped)\n  if (summary.skipped > 0) {\n    lines.push(`  ⚠ ${summary.skipped} duplicates (already in library)`);\n  }\n\n  // Failed\n  if (summary.failed > 0) {\n    lines.push(`  ✗ ${summary.failed} failed`);\n  }\n\n  // No ID (skipped)\n  if (summary.noId > 0) {\n    lines.push(`  - ${summary.noId} skipped (no identifier)`);\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Get registration identifier for an article.\n * PMID is preferred over DOI for better metadata quality.\n */\nfunction getRegistrationId(article: Article): string | null {\n  if (article.pmid) {\n    return `pmid:${article.pmid}`;\n  }\n  if (article.doi) {\n    return article.doi;\n  }\n  return null;\n}\n\n/**\n * Format dry run output showing what would be registered.\n */\nexport function formatDryRunOutput(articles: Article[]): string {\n  const withId: Array<{ article: Article; id: string }> = [];\n  const withoutId: Article[] = [];\n\n  for (const article of articles) {\n    const id = getRegistrationId(article);\n    if (id) {\n      withId.push({ article, id });\n    } else {\n      withoutId.push(article);\n    }\n  }\n\n  const lines: string[] = [];\n\n  // Summary\n  lines.push(\n    `Would register ${withId.length} reference${withId.length !== 1 ? 's' : ''}:`\n  );\n\n  // List articles with IDs\n  for (const { id, article } of withId) {\n    const title = article.title.length > 60\n      ? article.title.substring(0, 57) + '...'\n      : article.title;\n    lines.push(`  - ${id}: ${title}`);\n  }\n\n  // Details about articles without DOI/PMID\n  if (withoutId.length > 0) {\n    lines.push('');\n    lines.push(\n      `${withoutId.length} article${withoutId.length !== 1 ? 's' : ''} will be skipped (no DOI or PMID):`\n    );\n\n    const maxDisplay = 10;\n    const displayed = withoutId.slice(0, maxDisplay);\n\n    for (const article of displayed) {\n      const truncatedTitle = article.title.length > 50\n        ? article.title.substring(0, 50) + '...'\n        : article.title;\n\n      const altIds = getAlternativeIds(article);\n      const hasAltIds = altIds.length > 0 ? `, has: ${altIds.join(', ')}` : '';\n\n      lines.push(`  - \"${truncatedTitle}\" (source: ${article.source}${hasAltIds})`);\n    }\n\n    if (withoutId.length > maxDisplay) {\n      lines.push(`  ... and ${withoutId.length - maxDisplay} more`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Get alternative (non-DOI/PMID) identifiers for an article.\n */\nfunction getAlternativeIds(article: Article): string[] {\n  const ids: string[] = [];\n  if (article.arxivId) ids.push(`arxiv:${article.arxivId}`);\n  if (article.ericId) ids.push(`eric:${article.ericId}`);\n  if (article.scopusId) ids.push(`scopus:${article.scopusId}`);\n  return ids;\n}\n\n/**\n * Summary of review decisions for a session.\n */\nexport interface ReviewSummary {\n  /** Total articles in review file */\n  total: number;\n  /** Articles with finalDecision='include' */\n  included: number;\n  /** Articles with finalDecision='exclude' */\n  excluded: number;\n  /** Articles without finalDecision (pending, incomplete, all-uncertain, agreed, divided) */\n  pending: number;\n}\n\n/**\n * Check if a session has a reviews.yaml file.\n */\nexport async function hasReviewFile(sessionId: string, sessionsDir: string): Promise<boolean> {\n  const reviewsPath = join(sessionsDir, sessionId, '.internal', 'reviews.yaml');\n  try {\n    await access(reviewsPath, constants.R_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Load and parse the review file for a session.\n */\nasync function loadReviewFile(sessionId: string, sessionsDir: string): Promise<ReviewFile> {\n  const reviewsPath = join(sessionsDir, sessionId, '.internal', 'reviews.yaml');\n  const content = await readFile(reviewsPath, 'utf-8');\n  return parseYaml(content) as ReviewFile;\n}\n\n/**\n * Get review summary (counts) for a session.\n * Throws if reviews.yaml does not exist.\n */\nexport async function getReviewSummary(sessionId: string, sessionsDir: string): Promise<ReviewSummary> {\n  const reviewFile = await loadReviewFile(sessionId, sessionsDir);\n  const articles = reviewFile.articles ?? [];\n\n  const summary: ReviewSummary = {\n    total: articles.length,\n    included: 0,\n    excluded: 0,\n    pending: 0,\n  };\n\n  for (const article of articles) {\n    const status = classifyStatus(article);\n\n    if (status === 'finalized') {\n      if (article.finalDecision === 'include') {\n        summary.included++;\n      } else {\n        summary.excluded++;\n      }\n    } else {\n      // pending, incomplete, all-uncertain, agreed, divided all count as pending for registration\n      summary.pending++;\n    }\n  }\n\n  return summary;\n}\n\n/**\n * Parse author name string into Author object.\n * Simple heuristic: last word is family name, rest is given name.\n */\nfunction parseAuthorName(name: string): Author {\n  const parts = name.trim().split(/\\s+/);\n  if (parts.length === 1) {\n    return { family: parts[0] ?? '' };\n  }\n  // Last part is family name (most common pattern in scientific citations)\n  const family = parts.pop() ?? '';\n  const given = parts.join(' ');\n  return { family, given };\n}\n\n/**\n * Get articles with finalDecision='include' from review file.\n * Converts from ArticleEntry format to Article format.\n *\n * @throws Error if mergedFrom is missing or empty (indicates legacy review file)\n */\nexport async function getIncludedArticles(sessionId: string, sessionsDir: string): Promise<Article[]> {\n  const reviewFile = await loadReviewFile(sessionId, sessionsDir);\n  const articles = reviewFile.articles ?? [];\n\n  return articles\n    .filter((entry) => entry.finalDecision === 'include')\n    .map((entry): Article => {\n      // Validate mergedFrom exists\n      if (!entry.mergedFrom) {\n        throw new Error(\n          `Article \"${entry.title}\" has mergedFrom missing. ` +\n            `This may be a legacy review file created before source tracking was fixed. ` +\n            `Please re-run 'review init' to regenerate the review file with source tracking.`\n        );\n      }\n      if (entry.mergedFrom.length === 0) {\n        throw new Error(\n          `Article \"${entry.title}\" has empty mergedFrom array. ` +\n            `This is an invalid state - please re-run 'review init' to regenerate.`\n        );\n      }\n\n      const authors: Author[] = entry.authors\n        ? entry.authors.split(/,\\s*/).map(parseAuthorName)\n        : [];\n\n      // Get source from the first entry in mergedFrom\n      const source = entry.mergedFrom[0]!.source as ProviderName;\n\n      const article: Article = {\n        title: entry.title,\n        authors,\n        source,\n        retrievedAt: new Date().toISOString(),\n      };\n      // Only set optional fields if they have values\n      if (entry.doi) article.doi = entry.doi;\n      if (entry.pmid) article.pmid = entry.pmid;\n      if (entry.scopusId) article.scopusId = entry.scopusId;\n      if (entry.arxivId) article.arxivId = entry.arxivId;\n      if (entry.ericId) article.ericId = entry.ericId;\n      if (entry.abstract) article.abstract = entry.abstract;\n      if (entry.year) article.publicationDate = entry.year;\n      return article;\n    });\n}\n\n/**\n * Format message when reviews exist but no flag specified.\n */\nexport function formatReviewRequiredMessage(summary: ReviewSummary, sessionId: string): string {\n  return `This session has a review file.\n  Status: ${summary.included} include / ${summary.excluded} exclude / ${summary.pending} pending\n\nPlease specify which articles to register:\n  --reviewed   Register ${summary.included} included articles\n  --all        Register all ${summary.total} articles (ignore reviews)\n\nExample:\n  search-hub register ${sessionId} --reviewed`;\n}\n\n/**\n * Format error when --reviewed used but no articles are included.\n */\nexport function formatNoIncludedArticlesError(summary: ReviewSummary, sessionId: string): string {\n  return `Error: No articles marked as 'include' in reviews.\n  Status: ${summary.included} include / ${summary.excluded} exclude / ${summary.pending} pending\n\nRun 'search-hub review status ${sessionId}' for details.`;\n}\n\n/**\n * Format warning when pending articles exist with --reviewed.\n */\nexport function formatPendingWarning(summary: ReviewSummary): string {\n  const articleWord = summary.pending === 1 ? 'article' : 'articles';\n  return `Warning: ${summary.pending} ${articleWord} still pending review (will be skipped).\nRegistering ${summary.included} included articles...\n\nProceed? [Y/n]`;\n}\n\n\n/**\n * Format note when --all is used with reviews.yaml present.\n */\nexport function formatIgnoringReviewsNote(total: number): string {\n  return `Note: Ignoring review decisions. Registering all ${total} articles.`;\n}\n\n/**\n * Prompt user for Y/n confirmation.\n * Returns true if user confirms (Y/y/Enter), false otherwise.\n */\nexport async function confirmPrompt(\n  input: NodeJS.ReadableStream = process.stdin,\n  output: NodeJS.WritableStream = process.stdout\n): Promise<boolean> {\n  const rl = createInterface({\n    input,\n    output,\n    terminal: false,\n  });\n\n  return new Promise((resolve) => {\n    rl.question('', (answer) => {\n      rl.close();\n      const trimmed = answer.trim().toLowerCase();\n      // Empty (Enter) or 'y' or 'yes' means confirm\n      resolve(trimmed === '' || trimmed === 'y' || trimmed === 'yes');\n    });\n  });\n}\n"],"names":["parseYaml"],"mappings":"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"}
+{"version":3,"file":"register.js","sources":["../../../src/cli/commands/register.ts"],"sourcesContent":["/**\n * Register command for reference-manager integration.\n * Registers search results with reference-manager CLI.\n */\n\nimport { join } from 'node:path';\nimport { readFile, access } from 'node:fs/promises';\nimport { constants } from 'node:fs';\nimport { createInterface } from 'node:readline';\nimport { parse as parseYaml } from 'yaml';\nimport type { ProviderName, Article, Author } from '../../providers/base/types.js';\nimport { parseProviderNames } from '../utils/validation.js';\nimport { classifyStatus, type ReviewFile } from './review/types.js';\n\nexport interface RegisterCommandOptions {\n  sessionId: string;\n  providers?: ProviderName[];\n  dryRun: boolean;\n  withAbstracts: boolean;\n  /** Register only reviewed articles with finalDecision='include' */\n  reviewed?: boolean;\n  /** Register all articles, ignoring reviews */\n  all?: boolean;\n  /** Skip confirmation prompts */\n  force?: boolean;\n  /** Suppress tips and suggestions */\n  quiet?: boolean;\n}\n\nexport interface CommandLineOptions {\n  db?: string | undefined;\n  dryRun?: boolean | undefined;\n  withAbstracts?: boolean | undefined;\n  reviewed?: boolean | undefined;\n  all?: boolean | undefined;\n  force?: boolean | undefined;\n  quiet?: boolean | undefined;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  error?: string;\n}\n\n/**\n * Parse command line options into RegisterCommandOptions.\n */\nexport function parseRegisterOptions(\n  sessionId: string,\n  options: CommandLineOptions\n): RegisterCommandOptions {\n  const result: RegisterCommandOptions = {\n    sessionId,\n    dryRun: options.dryRun ?? false,\n    withAbstracts: options.withAbstracts ?? false,\n    reviewed: options.reviewed ?? false,\n    all: options.all ?? false,\n    force: options.force ?? false,\n    quiet: options.quiet ?? false,\n  };\n\n  if (options.db) {\n    result.providers = parseProviderNames(options.db);\n  }\n\n  return result;\n}\n\n/**\n * Validate register command input.\n */\nexport function validateRegisterInput(options: RegisterCommandOptions): ValidationResult {\n  if (!options.sessionId || options.sessionId.trim() === '') {\n    return {\n      valid: false,\n      error: 'A session ID is required',\n    };\n  }\n\n  return { valid: true };\n}\n\n/**\n * Format registration summary for CLI output.\n */\nexport function formatRegistrationSummary(summary: {\n  total: number;\n  added: number;\n  skipped: number;\n  failed: number;\n  noId: number;\n}): string {\n  const lines: string[] = ['Registration complete:'];\n\n  // Added\n  lines.push(`  ✓ ${summary.added} added`);\n\n  // Duplicates (skipped)\n  if (summary.skipped > 0) {\n    lines.push(`  ⚠ ${summary.skipped} duplicates (already in library)`);\n  }\n\n  // Failed\n  if (summary.failed > 0) {\n    lines.push(`  ✗ ${summary.failed} failed`);\n  }\n\n  // No ID (skipped)\n  if (summary.noId > 0) {\n    lines.push(`  - ${summary.noId} skipped (no identifier)`);\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Get registration identifier for an article.\n * PMID is preferred over DOI for better metadata quality.\n */\nfunction getRegistrationId(article: Article): string | null {\n  if (article.pmid) {\n    return `pmid:${article.pmid}`;\n  }\n  if (article.doi) {\n    return article.doi;\n  }\n  return null;\n}\n\n/**\n * Format dry run output showing what would be registered.\n */\nexport function formatDryRunOutput(articles: Article[]): string {\n  const withId: Array<{ article: Article; id: string }> = [];\n  const withoutId: Article[] = [];\n\n  for (const article of articles) {\n    const id = getRegistrationId(article);\n    if (id) {\n      withId.push({ article, id });\n    } else {\n      withoutId.push(article);\n    }\n  }\n\n  const lines: string[] = [];\n\n  // Summary\n  lines.push(\n    `Would register ${withId.length} reference${withId.length !== 1 ? 's' : ''}:`\n  );\n\n  // List articles with IDs\n  for (const { id, article } of withId) {\n    const title = article.title.length > 60\n      ? article.title.substring(0, 57) + '...'\n      : article.title;\n    lines.push(`  - ${id}: ${title}`);\n  }\n\n  // Details about articles without DOI/PMID\n  if (withoutId.length > 0) {\n    lines.push('');\n    lines.push(\n      `${withoutId.length} article${withoutId.length !== 1 ? 's' : ''} will be skipped (no DOI or PMID):`\n    );\n\n    const maxDisplay = 10;\n    const displayed = withoutId.slice(0, maxDisplay);\n\n    for (const article of displayed) {\n      const truncatedTitle = article.title.length > 50\n        ? article.title.substring(0, 50) + '...'\n        : article.title;\n\n      const altIds = getAlternativeIds(article);\n      const hasAltIds = altIds.length > 0 ? `, has: ${altIds.join(', ')}` : '';\n\n      lines.push(`  - \"${truncatedTitle}\" (source: ${article.source}${hasAltIds})`);\n    }\n\n    if (withoutId.length > maxDisplay) {\n      lines.push(`  ... and ${withoutId.length - maxDisplay} more`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Get alternative (non-DOI/PMID) identifiers for an article.\n */\nfunction getAlternativeIds(article: Article): string[] {\n  const ids: string[] = [];\n  if (article.arxivId) ids.push(`arxiv:${article.arxivId}`);\n  if (article.ericId) ids.push(`eric:${article.ericId}`);\n  if (article.scopusId) ids.push(`scopus:${article.scopusId}`);\n  return ids;\n}\n\n/**\n * Summary of review decisions for a session.\n */\nexport interface ReviewSummary {\n  /** Total articles in review file */\n  total: number;\n  /** Articles with finalDecision='include' */\n  included: number;\n  /** Articles with finalDecision='exclude' */\n  excluded: number;\n  /** Articles without finalDecision (pending, incomplete, all-uncertain, agreed, divided) */\n  pending: number;\n}\n\n/**\n * Check if a session has a reviews.yaml file.\n */\nexport async function hasReviewFile(sessionId: string, sessionsDir: string): Promise<boolean> {\n  const reviewsPath = join(sessionsDir, sessionId, '.internal', 'reviews.yaml');\n  try {\n    await access(reviewsPath, constants.R_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Load and parse the review file for a session.\n */\nasync function loadReviewFile(sessionId: string, sessionsDir: string): Promise<ReviewFile> {\n  const reviewsPath = join(sessionsDir, sessionId, '.internal', 'reviews.yaml');\n  const content = await readFile(reviewsPath, 'utf-8');\n  return parseYaml(content) as ReviewFile;\n}\n\n/**\n * Get review summary (counts) for a session.\n * Throws if reviews.yaml does not exist.\n */\nexport async function getReviewSummary(sessionId: string, sessionsDir: string): Promise<ReviewSummary> {\n  const reviewFile = await loadReviewFile(sessionId, sessionsDir);\n  const articles = reviewFile.articles ?? [];\n\n  const summary: ReviewSummary = {\n    total: articles.length,\n    included: 0,\n    excluded: 0,\n    pending: 0,\n  };\n\n  for (const article of articles) {\n    const status = classifyStatus(article);\n\n    if (status === 'finalized') {\n      if (article.finalDecision === 'include') {\n        summary.included++;\n      } else {\n        summary.excluded++;\n      }\n    } else {\n      // pending, incomplete, all-uncertain, agreed, divided all count as pending for registration\n      summary.pending++;\n    }\n  }\n\n  return summary;\n}\n\n/**\n * Parse author name string into Author object.\n * Simple heuristic: last word is family name, rest is given name.\n */\nfunction parseAuthorName(name: string): Author {\n  const parts = name.trim().split(/\\s+/);\n  if (parts.length === 1) {\n    return { family: parts[0] ?? '' };\n  }\n  // Last part is family name (most common pattern in scientific citations)\n  const family = parts.pop() ?? '';\n  const given = parts.join(' ');\n  return { family, given };\n}\n\n/**\n * Get articles with finalDecision='include' from review file.\n * Converts from ArticleEntry format to Article format.\n *\n * @throws Error if mergedFrom is missing or empty (indicates legacy review file)\n */\nexport async function getIncludedArticles(sessionId: string, sessionsDir: string): Promise<Article[]> {\n  const reviewFile = await loadReviewFile(sessionId, sessionsDir);\n  const articles = reviewFile.articles ?? [];\n\n  return articles\n    .filter((entry) => entry.finalDecision === 'include')\n    .map((entry): Article => {\n      // Validate mergedFrom exists\n      if (!entry.mergedFrom) {\n        throw new Error(\n          `Article \"${entry.title}\" has mergedFrom missing. ` +\n            `This may be a legacy review file created before source tracking was fixed. ` +\n            `Please re-run 'review init' to regenerate the review file with source tracking.`\n        );\n      }\n      if (entry.mergedFrom.length === 0) {\n        throw new Error(\n          `Article \"${entry.title}\" has empty mergedFrom array. ` +\n            `This is an invalid state - please re-run 'review init' to regenerate.`\n        );\n      }\n\n      const authors: Author[] = entry.authors\n        ? entry.authors.split(/,\\s*/).map(parseAuthorName)\n        : [];\n\n      // Get source from the first entry in mergedFrom\n      const source = entry.mergedFrom[0]!.source as ProviderName;\n\n      const article: Article = {\n        title: entry.title,\n        authors,\n        source,\n        retrievedAt: new Date().toISOString(),\n      };\n      // Only set optional fields if they have values\n      if (entry.doi) article.doi = entry.doi;\n      if (entry.pmid) article.pmid = entry.pmid;\n      if (entry.scopusId) article.scopusId = entry.scopusId;\n      if (entry.arxivId) article.arxivId = entry.arxivId;\n      if (entry.ericId) article.ericId = entry.ericId;\n      if (entry.abstract) article.abstract = entry.abstract;\n      if (entry.year) article.publicationDate = entry.year;\n      return article;\n    });\n}\n\n/**\n * Format message when reviews exist but no flag specified.\n */\nexport function formatReviewRequiredMessage(summary: ReviewSummary, sessionId: string): string {\n  return `This session has a review file.\n  Status: ${summary.included} include / ${summary.excluded} exclude / ${summary.pending} pending\n\nPlease specify which articles to register:\n  --reviewed   Register ${summary.included} included articles\n  --all        Register all ${summary.total} articles (ignore reviews)\n\nExample:\n  search-hub register ${sessionId} --reviewed`;\n}\n\n/**\n * Format error when --reviewed used but no articles are included.\n */\nexport function formatNoIncludedArticlesError(summary: ReviewSummary, sessionId: string): string {\n  return `Error: No articles marked as 'include' in reviews.\n  Status: ${summary.included} include / ${summary.excluded} exclude / ${summary.pending} pending\n\nRun 'search-hub review status ${sessionId}' for details.`;\n}\n\n/**\n * Format warning when pending articles exist with --reviewed.\n */\nexport function formatPendingWarning(summary: ReviewSummary): string {\n  const articleWord = summary.pending === 1 ? 'article' : 'articles';\n  return `Warning: ${summary.pending} ${articleWord} still pending review (will be skipped).\nRegistering ${summary.included} included articles...\n\nProceed? [Y/n]`;\n}\n\n\n/**\n * Format library path display for CLI output.\n */\nexport function formatLibraryPath(sessionDir: string): string {\n  return `Library: ${join(sessionDir, 'references.json')}`;\n}\n\n/**\n * Format hint for importing into default ref library.\n */\nexport function formatDefaultLibraryHint(sessionDir: string): string {\n  return `To also add to your default ref library:\\n  ref add -i json \"${join(sessionDir, 'references.json')}\"`;\n}\n\n/**\n * Format note when --all is used with reviews.yaml present.\n */\nexport function formatIgnoringReviewsNote(total: number): string {\n  return `Note: Ignoring review decisions. Registering all ${total} articles.`;\n}\n\n/**\n * Prompt user for Y/n confirmation.\n * Returns true if user confirms (Y/y/Enter), false otherwise.\n */\nexport async function confirmPrompt(\n  input: NodeJS.ReadableStream = process.stdin,\n  output: NodeJS.WritableStream = process.stdout\n): Promise<boolean> {\n  const rl = createInterface({\n    input,\n    output,\n    terminal: false,\n  });\n\n  return new Promise((resolve) => {\n    rl.question('', (answer) => {\n      rl.close();\n      const trimmed = answer.trim().toLowerCase();\n      // Empty (Enter) or 'y' or 'yes' means confirm\n      resolve(trimmed === '' || trimmed === 'y' || trimmed === 'yes');\n    });\n  });\n}\n"],"names":["parseYaml"],"mappings":"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"}

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAQA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAuM5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA+tFvC;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAQA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAyM5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA+vFvC;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C"}