@ncukondo/search-hub 0.16.0 → 0.18.0

package/dist/cli/index.js

@@ -38,15 +38,20 @@ import { executeReviewMerge, formatMergeOutput as formatMergeOutput$1 } from "./
 import { executeReviewMark } from "./commands/review/mark.js";
 import { executeReviewExport, formatExportOutput } from "./commands/review/export.js";
 import { executeReviewFinalize, formatFinalizeOutput } from "./commands/review/finalize.js";
+import "zod";
+import "./commands/review/schema.js";
 import { registerFulltextCommands } from "./commands/fulltext/index.js";
 import { parseRegisterOptions, validateRegisterInput, hasReviewFile, getReviewSummary, formatNoIncludedArticlesError, formatPendingWarning, confirmPrompt, getIncludedArticles, formatReviewRequiredMessage, formatIgnoringReviewsNote, formatDryRunOutput as formatDryRunOutput$1, formatRegistrationSummary } from "./commands/register.js";
 import { formatSuggestion } from "./suggestions/index.js";
 import { getSuggestion } from "./suggestions/rules.js";
+import { readLogEntries, computeQueryHash, appendLogEntry, buildPreviewLogEntry, buildCountLogEntry } from "./commands/query/iteration-log.js";
+import { executeQueryAssess } from "./commands/query/assess.js";
+import { formatLogOutput } from "./commands/query/log.js";
 import { registerArticles, saveRegistrationRecord } from "../integration/register.js";
 import { checkRefAvailable, checkNpmAvailable, installRefManager } from "../integration/ref-cli.js";
 import { loadSession, listSessions, sessionExists } from "../session/manager.js";
 import { parseQueryFile, detectShortKeywords } from "../query/parser.js";
-import { writeFile, readFile } from "node:fs/promises";
+import { readFile, writeFile } from "node:fs/promises";
 import { realpathSync } from "node:fs";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -346,6 +351,54 @@ Examples:
       process.exitCode = EXIT_CODES.GENERAL_ERROR;
     }
   });
+  queryCommand.command("assess").description("Record an assessment of the current query iteration").argument("<file>", "path to query YAML file").option("--verdict <verdict>", "assessment verdict (e.g., reject, good, refine)").option("--precision <precision>", "estimated precision (e.g., ~60%)").option("--comment <comment>", "free-text comment").addHelpText("after", `
+Examples:
+  $ search-hub query assess query.yaml --verdict reject --comment "Too broad"
+  $ search-hub query assess query.yaml --verdict good --precision "~60%"`).action(async (file, options) => {
+    const globalOpts = program.opts();
+    try {
+      const result = await executeQueryAssess(file, options);
+      if (result.success) {
+        if (!globalOpts.quiet) {
+          console.log("Assessment recorded.");
+          const suggestion = formatSuggestion(getSuggestion({
+            command: "query assess",
+            queryFile: file
+          }));
+          if (suggestion) console.log(suggestion);
+        }
+        process.exitCode = EXIT_CODES.SUCCESS;
+      } else {
+        if (!globalOpts.quiet) {
+          console.error(`Error: ${result.error}`);
+        }
+        process.exitCode = EXIT_CODES.GENERAL_ERROR;
+      }
+    } catch (error) {
+      if (!globalOpts.quiet) {
+        console.error("Error:", error instanceof Error ? error.message : error);
+      }
+      process.exitCode = EXIT_CODES.GENERAL_ERROR;
+    }
+  });
+  queryCommand.command("log").description("View the query iteration history").argument("<file>", "path to query YAML file").option("--json", "output as JSON").addHelpText("after", `
+Examples:
+  $ search-hub query log query.yaml
+  $ search-hub query log query.yaml --json`).action(async (file, options) => {
+    const globalOpts = program.opts();
+    try {
+      const entries = await readLogEntries(file);
+      if (!globalOpts.quiet) {
+        console.log(formatLogOutput(entries, { json: options?.json }));
+      }
+      process.exitCode = EXIT_CODES.SUCCESS;
+    } catch (error) {
+      if (!globalOpts.quiet) {
+        console.error("Error:", error instanceof Error ? error.message : error);
+      }
+      process.exitCode = EXIT_CODES.GENERAL_ERROR;
+    }
+  });
   program.command("status").description("Show session status and statistics").argument("[session-id]", "session ID to show details for").option("--json", "output as JSON").option("--all", "include completed sessions").addHelpText("after", `
 Examples:
   $ search-hub status                           # List recent sessions
@@ -501,8 +554,21 @@ Query features (use "query init" to see full template):
             process.exitCode = EXIT_CODES.GENERAL_ERROR;
             return;
           }
+          if (searchOpts.queryFile) {
+            try {
+              const qContent = await readFile(searchOpts.queryFile, "utf-8");
+              const qHash = computeQueryHash(qContent);
+              await appendLogEntry(searchOpts.queryFile, buildPreviewLogEntry(qHash, previews));
+            } catch {
+            }
+          }
           if (!globalOpts.quiet) {
             console.log(formatPreviewOutput(previews, searchOpts.queryFile));
+            const suggestion = formatSuggestion(getSuggestion({
+              command: "search --preview",
+              queryFile: searchOpts.queryFile
+            }));
+            if (suggestion) console.log(suggestion);
           }
           const previewHasErrors = previews.some((p) => p.error);
           const previewAllFailed = previews.every((p) => p.error);
@@ -536,6 +602,14 @@ Warning: Some providers failed:
             process.exitCode = EXIT_CODES.GENERAL_ERROR;
             return;
           }
+          if (searchOpts.queryFile) {
+            try {
+              const qContent = await readFile(searchOpts.queryFile, "utf-8");
+              const qHash = computeQueryHash(qContent);
+              await appendLogEntry(searchOpts.queryFile, buildCountLogEntry(qHash, counts));
+            } catch {
+            }
+          }
           if (!globalOpts.quiet) {
             console.log(formatCountOnlyOutput(counts, searchOpts.queryFile));
             const suggestion = formatSuggestion(getSuggestion({
@@ -1790,13 +1864,21 @@ Examples:
       process.exitCode = EXIT_CODES.SESSION_ERROR;
     }
   });
-  reviewCommand.command("finalize").description("Auto-set finalDecision for articles with reviewer consensus").requiredOption("--session <id>", "session ID").option("--dry-run", "preview without changes", false).option("--min-reviewers <n>", "minimum agreeing reviewers needed", "1").action(async (options) => {
+  reviewCommand.command("finalize").description("Auto-set finalDecision for articles with reviewer consensus").requiredOption("--session <id>", "session ID").option("--dry-run", "preview without changes", false).option("--min-reviewers <n>", "minimum agreeing reviewers needed", "1").option("--decision <type>", "only finalize this decision type (include or exclude)").action(async (options) => {
     const globalOpts = program.opts();
     try {
       const sessionsDir = await getSessionsDir(globalOpts);
+      if (options.decision && options.decision !== "include" && options.decision !== "exclude") {
+        if (!globalOpts.quiet) {
+          console.error(`Error: --decision must be "include" or "exclude", got "${options.decision}"`);
+        }
+        process.exitCode = EXIT_CODES.GENERAL_ERROR;
+        return;
+      }
       const finalizeOptions = {
         sessionId: options.session,
-        ...options.dryRun && { dryRun: options.dryRun }
+        ...options.dryRun && { dryRun: options.dryRun },
+        ...options.decision && { decision: options.decision }
       };
       const minReviewers = parseInt(options.minReviewers, 10);
       if (!Number.isNaN(minReviewers) && minReviewers > 1) {
@@ -1804,7 +1886,10 @@ Examples:
       }
       const result = await executeReviewFinalize(finalizeOptions, sessionsDir);
       if (!globalOpts.quiet) {
-        console.log(formatFinalizeOutput(result, { dryRun: options.dryRun }));
+        console.log(formatFinalizeOutput(result, {
+          dryRun: options.dryRun,
+          ...finalizeOptions.decision && { decision: finalizeOptions.decision }
+        }));
         if (!options.dryRun) {
           const statusResult = await executeReviewStatus({ sessionId: options.session }, sessionsDir);
           const suggestion = formatSuggestion(getSuggestion({