@knowledgine/cli 0.1.0 → 0.2.1

package/dist/lib/progress.js

@@ -0,0 +1,228 @@
+/**
+ * Progress display utility for CLI operations.
+ * TTY: in-place updates with \r
+ * Non-TTY: milestone-only output
+ * All output goes to stderr to avoid MCP stdout conflicts.
+ */
+import { colors, createBox } from "./ui/index.js";
+import { createSpinner } from "./ui/spinner.js";
+export function createSummaryReport(title, entries) {
+    const maxLabelLen = entries.length > 0 ? Math.max(...entries.map((e) => e.label.length)) : 0;
+    const lines = entries.map((e) => `${colors.label(e.label.padEnd(maxLabelLen))}  ${e.value}`);
+    const content = lines.join("\n");
+    return createBox(content, { type: "success", title });
+}
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    const minutes = Math.floor(ms / 60_000);
+    const seconds = Math.round((ms % 60_000) / 1000);
+    return `${minutes}m ${seconds}s`;
+}
+function useColor() {
+    return !process.env["NO_COLOR"];
+}
+function stepIcon(status) {
+    if (!useColor()) {
+        switch (status) {
+            case "done":
+                return "[ok]";
+            case "failed":
+                return "[fail]";
+            case "skipped":
+                return "[skip]";
+            case "running":
+                return "[..]";
+            default:
+                return "[ ]";
+        }
+    }
+    switch (status) {
+        case "done":
+            return "\u2714"; // ✔
+        case "failed":
+            return "\u2718"; // ✘
+        case "skipped":
+            return "\u2212"; // −
+        case "running":
+            return "\u25ba"; // ►
+        default:
+            return " ";
+    }
+}
+function renderProgressBar(current, total, width = 16) {
+    const ratio = total > 0 ? Math.min(current / total, 1) : 0;
+    const filled = Math.round(ratio * width);
+    const empty = width - filled;
+    return `[${"█".repeat(filled)}${"░".repeat(empty)}]`;
+}
+export function createProgress(total, label) {
+    const isTTY = process.stderr.isTTY ?? false;
+    const startTime = Date.now();
+    let lastMilestone = -1;
+    function write(text) {
+        process.stderr.write(text);
+    }
+    function update(current, detail) {
+        if (isTTY) {
+            const detailStr = detail ? ` ${detail}` : "";
+            const bar = renderProgressBar(current, total);
+            const line = `\r[${current}/${total}] ${label}...${detailStr} ${bar}`;
+            write(line);
+        }
+        else {
+            // Non-TTY: output at 0%, 25%, 50%, 75%, 100% milestones
+            const pct = total > 0 ? Math.floor((current / total) * 4) : 0;
+            if (pct > lastMilestone) {
+                lastMilestone = pct;
+                write(`[${current}/${total}] ${label}...\n`);
+            }
+        }
+    }
+    function finish() {
+        const elapsed = formatDuration(Date.now() - startTime);
+        if (isTTY) {
+            write(`\r[${total}/${total}] ${label} (${elapsed})\n`);
+        }
+        else {
+            write(`${label}: ${total} done (${elapsed})\n`);
+        }
+    }
+    return { update, finish };
+}
+/**
+ * Create a step-based progress tracker for structured multi-step CLI operations.
+ *
+ * Each step is printed as it starts/completes to give real-time feedback.
+ * Designed to be used with init, upgrade, and other multi-phase commands.
+ *
+ * @param totalSteps - Expected number of steps (used for summary only)
+ * @param title - Optional title printed before the first step
+ *
+ * @example
+ * ```ts
+ * const steps = createStepProgress(4, "Initializing knowledgine");
+ * steps.startStep("Creating directory");
+ * steps.completeStep("Creating directory");
+ * steps.startStep("Reading configuration");
+ * steps.failStep("Reading configuration", "Permission denied");
+ * steps.finish();
+ * ```
+ */
+export function createStepProgress(totalSteps, title) {
+    const steps = [];
+    const startTime = Date.now();
+    let warnCount = 0;
+    function write(text) {
+        process.stderr.write(text);
+    }
+    function findStep(name) {
+        return steps.find((s) => s.name === name);
+    }
+    function printStepLine(step) {
+        const icon = stepIcon(step.status);
+        const reasonStr = step.reason ? ` (${step.reason})` : "";
+        if (useColor()) {
+            switch (step.status) {
+                case "done":
+                    write(`  ${colors.success(icon)} ${step.name}${reasonStr}\n`);
+                    break;
+                case "failed":
+                    write(`  ${colors.error(icon)} ${colors.error(step.name)}${reasonStr}\n`);
+                    break;
+                case "skipped":
+                    write(`  ${colors.warning(icon)} ${colors.dim(step.name)}${reasonStr}\n`);
+                    break;
+                default:
+                    write(`  ${icon} ${step.name}${reasonStr}\n`);
+            }
+        }
+        else {
+            write(`  ${icon} ${step.name}${reasonStr}\n`);
+        }
+    }
+    if (title) {
+        write(`\n${title}\n`);
+    }
+    function startStep(name) {
+        let step = findStep(name);
+        if (!step) {
+            step = { name, status: "running" };
+            steps.push(step);
+        }
+        else {
+            step.status = "running";
+            step.reason = undefined;
+        }
+        // Print running indicator so the user sees activity
+        const icon = stepIcon("running");
+        if (useColor()) {
+            write(`  ${colors.info(icon)} ${name}...\n`);
+        }
+        else {
+            write(`  ${icon} ${name}...\n`);
+        }
+    }
+    function completeStep(name) {
+        let step = findStep(name);
+        if (!step) {
+            step = { name, status: "done" };
+            steps.push(step);
+        }
+        else {
+            step.status = "done";
+            step.reason = undefined;
+        }
+        printStepLine(step);
+    }
+    function failStep(name, reason) {
+        let step = findStep(name);
+        if (!step) {
+            step = { name, status: "failed", reason };
+            steps.push(step);
+        }
+        else {
+            step.status = "failed";
+            step.reason = reason;
+        }
+        printStepLine(step);
+    }
+    function skipStep(name, reason) {
+        let step = findStep(name);
+        if (!step) {
+            step = { name, status: "skipped", reason };
+            steps.push(step);
+        }
+        else {
+            step.status = "skipped";
+            step.reason = reason;
+        }
+        printStepLine(step);
+    }
+    function warn(message) {
+        warnCount++;
+        write(`  ! ${message}\n`);
+    }
+    function finish() {
+        const elapsed = formatDuration(Date.now() - startTime);
+        const doneCount = steps.filter((s) => s.status === "done").length;
+        const failCount = steps.filter((s) => s.status === "failed").length;
+        const skipCount = steps.filter((s) => s.status === "skipped").length;
+        write(`\n`);
+        if (failCount > 0) {
+            write(`Completed with errors (${elapsed}): ${doneCount}/${totalSteps} steps, ${failCount} failed, ${skipCount} skipped\n`);
+        }
+        else if (warnCount > 0 || skipCount > 0) {
+            write(`Completed with warnings (${elapsed}): ${doneCount}/${totalSteps} steps, ${skipCount} skipped\n`);
+        }
+        else {
+            write(`All steps completed (${elapsed})\n`);
+        }
+    }
+    return { startStep, completeStep, failStep, skipStep, warn, finish };
+}
+// Re-export spinner for convenience in commands
+export { createSpinner } from "./ui/spinner.js";
+//# sourceMappingURL=progress.js.map

package/dist/lib/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/lib/progress.ts"],"names":[],"mappings":"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"}

package/dist/lib/ui/box.d.ts

@@ -0,0 +1,7 @@
+export type BoxType = "success" | "error" | "warning" | "info" | "default";
+export declare function createBox(content: string, options?: {
+    title?: string;
+    type?: BoxType;
+    padding?: number;
+}): string;
+//# sourceMappingURL=box.d.ts.map

package/dist/lib/ui/box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/box.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAU3E,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CASjH"}

package/dist/lib/ui/box.js

@@ -0,0 +1,19 @@
+import boxen, {} from "boxen";
+const borderColors = {
+    success: "green",
+    error: "red",
+    warning: "yellow",
+    info: "cyan",
+    default: "gray",
+};
+export function createBox(content, options) {
+    const type = options?.type ?? "default";
+    return boxen(content, {
+        title: options?.title,
+        titleAlignment: "left",
+        padding: options?.padding ?? 1,
+        borderColor: borderColors[type],
+        borderStyle: "round",
+    });
+}
+//# sourceMappingURL=box.js.map

package/dist/lib/ui/box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.js","sourceRoot":"","sources":["../../../src/lib/ui/box.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAgC,MAAM,OAAO,CAAC;AAI5D,MAAM,YAAY,GAA4B;IAC5C,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,KAAK;IACZ,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;CAChB,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,OAA8D;IACvG,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,SAAS,CAAC;IACxC,OAAO,KAAK,CAAC,OAAO,EAAE;QACpB,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,CAAC;QAC9B,WAAW,EAAE,YAAY,CAAC,IAAI,CAAgC;QAC9D,WAAW,EAAE,OAAO;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/ui/error-formatter.d.ts

@@ -0,0 +1,8 @@
+export interface StructuredError {
+    message: string;
+    cause?: string;
+    solutions?: string[];
+    hint?: string;
+}
+export declare function formatStructuredError(err: StructuredError): string;
+//# sourceMappingURL=error-formatter.d.ts.map

package/dist/lib/ui/error-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/error-formatter.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAiBlE"}

package/dist/lib/ui/error-formatter.js

@@ -0,0 +1,21 @@
+import { colors, symbols } from "./theme.js";
+import { createBox } from "./box.js";
+export function formatStructuredError(err) {
+    const lines = [
+        `${symbols.error} ${colors.error(colors.bold(err.message))}`,
+    ];
+    if (err.cause) {
+        lines.push("", `${colors.dim("Cause:")} ${err.cause}`);
+    }
+    if (err.solutions && err.solutions.length > 0) {
+        lines.push("", colors.dim("Solutions:"));
+        for (const s of err.solutions) {
+            lines.push(`  ${symbols.arrow} ${s}`);
+        }
+    }
+    if (err.hint) {
+        lines.push("", colors.hint(err.hint));
+    }
+    return createBox(lines.join("\n"), { type: "error", title: "Error" });
+}
+//# sourceMappingURL=error-formatter.js.map

package/dist/lib/ui/error-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.js","sourceRoot":"","sources":["../../../src/lib/ui/error-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AASrC,MAAM,UAAU,qBAAqB,CAAC,GAAoB;IACxD,MAAM,KAAK,GAAa;QACtB,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE;KAC7D,CAAC;IACF,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/lib/ui/index.d.ts

@@ -0,0 +1,7 @@
+export { colors, symbols, scoreColor } from "./theme.js";
+export { createTable, type TableConfig } from "./table.js";
+export { createBox, type BoxType } from "./box.js";
+export { createSpinner, type Ora } from "./spinner.js";
+export { formatStructuredError, type StructuredError } from "./error-formatter.js";
+export { stderr } from "./output.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,KAAK,GAAG,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/ui/index.js

@@ -0,0 +1,7 @@
+export { colors, symbols, scoreColor } from "./theme.js";
+export { createTable } from "./table.js";
+export { createBox } from "./box.js";
+export { createSpinner } from "./spinner.js";
+export { formatStructuredError } from "./error-formatter.js";
+export { stderr } from "./output.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,WAAW,EAAoB,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAgB,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,aAAa,EAAY,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAwB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/ui/output.d.ts

@@ -0,0 +1,2 @@
+export declare function stderr(text: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/ui/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/output.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzC"}

package/dist/lib/ui/output.js

@@ -0,0 +1,4 @@
+export function stderr(text) {
+    process.stderr.write(text + "\n");
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/ui/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/lib/ui/output.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/lib/ui/spinner.d.ts

@@ -0,0 +1,4 @@
+import { type Ora } from "ora";
+export declare function createSpinner(text: string): Ora;
+export type { Ora };
+//# sourceMappingURL=spinner.d.ts.map

package/dist/lib/ui/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/spinner.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAE/C;AAED,YAAY,EAAE,GAAG,EAAE,CAAC"}

package/dist/lib/ui/spinner.js

@@ -0,0 +1,5 @@
+import ora, {} from "ora";
+export function createSpinner(text) {
+    return ora({ text, stream: process.stderr });
+}
+//# sourceMappingURL=spinner.js.map

package/dist/lib/ui/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../../src/lib/ui/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,EAAE,EAAY,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lib/ui/table.d.ts

@@ -0,0 +1,9 @@
+export interface TableConfig {
+    head: string[];
+    rows: (string | number)[][];
+    colWidths?: number[];
+    compact?: boolean;
+}
+export declare function createTable(config: TableConfig): string;
+export declare function createTable(head: string[], rows: (string | number)[][]): string;
+//# sourceMappingURL=table.d.ts.map

package/dist/lib/ui/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/table.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC"}

package/dist/lib/ui/table.js

@@ -0,0 +1,28 @@
+import Table from "cli-table3";
+import { colors } from "./theme.js";
+export function createTable(configOrHead, rows) {
+    let config;
+    if (Array.isArray(configOrHead)) {
+        config = { head: configOrHead, rows: rows ?? [] };
+    }
+    else {
+        config = configOrHead;
+    }
+    const tableOptions = {
+        head: config.head.map(h => colors.bold(h)),
+        style: {
+            head: [],
+            border: ["gray"],
+            compact: config.compact ?? false,
+        },
+    };
+    if (config.colWidths !== undefined) {
+        tableOptions.colWidths = config.colWidths;
+    }
+    const table = new Table(tableOptions);
+    for (const row of config.rows) {
+        table.push(row.map(String));
+    }
+    return table.toString();
+}
+//# sourceMappingURL=table.js.map

package/dist/lib/ui/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../src/lib/ui/table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAWpC,MAAM,UAAU,WAAW,CACzB,YAAoC,EACpC,IAA4B;IAE5B,IAAI,MAAmB,CAAC;IACxB,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,YAAY,CAAC;IACxB,CAAC;IAED,MAAM,YAAY,GAA2C;QAC3D,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,KAAK,EAAE;YACL,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,CAAC,MAAM,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;SACjC;KACF,CAAC;IACF,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,YAAY,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAC5C,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC"}

package/dist/lib/ui/theme.d.ts

@@ -0,0 +1,21 @@
+export declare const colors: {
+    readonly success: import("chalk").ChalkInstance;
+    readonly error: import("chalk").ChalkInstance;
+    readonly warning: import("chalk").ChalkInstance;
+    readonly info: import("chalk").ChalkInstance;
+    readonly hint: import("chalk").ChalkInstance;
+    readonly accent: import("chalk").ChalkInstance;
+    readonly bold: import("chalk").ChalkInstance;
+    readonly dim: import("chalk").ChalkInstance;
+    readonly label: import("chalk").ChalkInstance;
+};
+export declare const symbols: {
+    readonly success: string;
+    readonly error: string;
+    readonly warning: string;
+    readonly info: string;
+    readonly arrow: "→";
+    readonly bullet: "●";
+};
+export declare function scoreColor(score: number): (text: string) => string;
+//# sourceMappingURL=theme.d.ts.map

package/dist/lib/ui/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/theme.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM;;;;;;;;;;CAUT,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;;CAOV,CAAC;AAEX,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAIlE"}

package/dist/lib/ui/theme.js

@@ -0,0 +1,29 @@
+import chalk from "chalk";
+import logSymbols from "log-symbols";
+export const colors = {
+    success: chalk.green,
+    error: chalk.red,
+    warning: chalk.yellow,
+    info: chalk.cyan,
+    hint: chalk.gray,
+    accent: chalk.magenta,
+    bold: chalk.bold,
+    dim: chalk.dim,
+    label: chalk.bold.white,
+};
+export const symbols = {
+    success: logSymbols.success,
+    error: logSymbols.error,
+    warning: logSymbols.warning,
+    info: logSymbols.info,
+    arrow: "→",
+    bullet: "●",
+};
+export function scoreColor(score) {
+    if (score >= 0.7)
+        return chalk.green;
+    if (score >= 0.4)
+        return chalk.yellow;
+    return chalk.red;
+}
+//# sourceMappingURL=theme.js.map

package/dist/lib/ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/lib/ui/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,UAAU,MAAM,aAAa,CAAC;AAErC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,KAAK,CAAC,KAAK;IACpB,KAAK,EAAE,KAAK,CAAC,GAAG;IAChB,OAAO,EAAE,KAAK,CAAC,MAAM;IACrB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,MAAM,EAAE,KAAK,CAAC,OAAO;IACrB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,GAAG,EAAE,KAAK,CAAC,GAAG;IACd,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;CACf,CAAC;AAEX,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO,EAAE,UAAU,CAAC,OAAO;IAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,OAAO,EAAE,UAAU,CAAC,OAAO;IAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;IACrB,KAAK,EAAE,GAAG;IACV,MAAM,EAAE,GAAG;CACH,CAAC;AAEX,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IACrC,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IACtC,OAAO,KAAK,CAAC,GAAG,CAAC;AACnB,CAAC"}

package/dist/lib/unknown-command-handler.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generates the "available commands" help text when an unknown command is entered.
+ *
+ * This is extracted as a pure function to enable unit testing independent of
+ * Commander.js program state.
+ */
+export declare function buildUnknownCommandHelp(commandNames: string[]): string;
+/**
+ * Creates a Commander.js outputError handler that:
+ *  1. Writes the original error message
+ *  2. Appends available commands list when the error is "unknown command"
+ */
+export declare function createOutputErrorHandler(getCommandNames: () => string[]): (str: string, write: (s: string) => void) => void;
+//# sourceMappingURL=unknown-command-handler.d.ts.map

package/dist/lib/unknown-command-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-command-handler.d.ts","sourceRoot":"","sources":["../../src/lib/unknown-command-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,MAAM,EAAE,GAC9B,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI,CAOnD"}

package/dist/lib/unknown-command-handler.js

@@ -0,0 +1,25 @@
+/**
+ * Generates the "available commands" help text when an unknown command is entered.
+ *
+ * This is extracted as a pure function to enable unit testing independent of
+ * Commander.js program state.
+ */
+export function buildUnknownCommandHelp(commandNames) {
+    const sorted = [...commandNames].sort();
+    return (`\nAvailable commands: ${sorted.join(", ")}\n` +
+        `Run 'knowledgine --help' for usage information.\n`);
+}
+/**
+ * Creates a Commander.js outputError handler that:
+ *  1. Writes the original error message
+ *  2. Appends available commands list when the error is "unknown command"
+ */
+export function createOutputErrorHandler(getCommandNames) {
+    return (str, write) => {
+        write(str);
+        if (str.includes("unknown command")) {
+            write(buildUnknownCommandHelp(getCommandNames()));
+        }
+    };
+}
+//# sourceMappingURL=unknown-command-handler.js.map

package/dist/lib/unknown-command-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-command-handler.js","sourceRoot":"","sources":["../../src/lib/unknown-command-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAsB;IAC5D,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,CACL,yBAAyB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAC9C,mDAAmD,CACpD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,eAA+B;IAE/B,OAAO,CAAC,GAAW,EAAE,KAA0B,EAAE,EAAE;QACjD,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACpC,KAAK,CAAC,uBAAuB,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/url-validator.d.ts

@@ -0,0 +1,2 @@
+export declare function validateCaptureUrl(url: string): URL;
+//# sourceMappingURL=url-validator.d.ts.map

package/dist/lib/url-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-validator.d.ts","sourceRoot":"","sources":["../../src/lib/url-validator.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAqBnD"}

package/dist/lib/url-validator.js

@@ -0,0 +1,21 @@
+export function validateCaptureUrl(url) {
+    const parsed = new URL(url);
+    if (!["http:", "https:"].includes(parsed.protocol)) {
+        throw new Error("Only HTTP/HTTPS URLs are supported");
+    }
+    const hostname = parsed.hostname.toLowerCase();
+    // localhost拒否
+    if (hostname === "localhost" ||
+        hostname === "127.0.0.1" ||
+        hostname === "::1" ||
+        hostname === "[::1]" ||
+        hostname === "0.0.0.0") {
+        throw new Error("Local addresses are not allowed");
+    }
+    // プライベートIP拒否
+    if (/^(10\.|172\.(1[6-9]|2[0-9]|3[01])\.|192\.168\.|169\.254\.)/.test(hostname)) {
+        throw new Error("Private network addresses are not allowed");
+    }
+    return parsed;
+}
+//# sourceMappingURL=url-validator.js.map

package/dist/lib/url-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-validator.js","sourceRoot":"","sources":["../../src/lib/url-validator.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC/C,cAAc;IACd,IACE,QAAQ,KAAK,WAAW;QACxB,QAAQ,KAAK,WAAW;QACxB,QAAQ,KAAK,KAAK;QAClB,QAAQ,KAAK,OAAO;QACpB,QAAQ,KAAK,SAAS,EACtB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,aAAa;IACb,IAAI,4DAA4D,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}