docs: JSDocコメントを実装と一致するよう修正

- pipeline.ts: process.exit(1)ではなく例外伝搬である旨に修正
- crawl.ts: CrawlAggregateErrorコンストラクタに@paramタグ追加
- database.ts: getJSON関数に@templateタグ追加

https://claude.ai/code/session_01Gz7eS3SnV1N6LakV8b7CxM

Author: claude

packages/@nitpicker/cli/src/commands/crawl.ts

@@ -332,6 +332,9 @@ export async function crawl(args: string[], flags: CrawlFlags) {
 export class CrawlAggregateError extends Error {
 	/** The individual errors that occurred during crawling. */
 	readonly errors: readonly (CrawlerError | Error)[];
+	/**
+	 * @param errors - The individual errors collected during the crawl session.
+	 */
 	constructor(errors: (CrawlerError | Error)[]) {
 		super(`Crawl completed with ${errors.length} error(s).`);
 		this.errors = errors;

packages/@nitpicker/cli/src/commands/pipeline.ts

@@ -178,7 +178,7 @@ type PipelineFlags = InferFlags<typeof commandDef.flags>;
  * to the analyze step. If `--sheet` is provided, the report step runs
  * last to publish results to Google Sheets.
  *
- * Each step's errors cause `process.exit(1)`, halting the pipeline.
+ * Errors from any step propagate to the caller as exceptions.
  * @param args - Positional arguments; first argument is the root URL to crawl.
  * @param flags - Parsed CLI flags from the `pipeline` command.
  * @returns Resolves when all pipeline steps complete.

packages/@nitpicker/crawler/src/archive/database.ts

@@ -1021,6 +1021,7 @@ function redirectTable(includeNull = true) {
  * Safely parses a JSON string, returning a fallback value if parsing fails or the input is not a string.
  * Logs a warning via {@link dbLog} when invalid JSON is detected, including a truncated preview
  * of the data and the parse error message.
+ * @template T The expected type of the parsed JSON value and the fallback.
  * @param data - The data to parse. Only string values are parsed; other types return the fallback.
  * @param fallback - The value to return if parsing fails or the result is falsy.
  * @returns The parsed JSON value, or the fallback.