@4ort/cli 0.3.0 → 0.5.0

package/dist/commands/kg/entity.js

@@ -0,0 +1,33 @@
+/**
+ * 4ort kg entity <key>
+ *
+ * GET /api/v1/entities/{key}?detail=tiny|small|medium|full
+ */
+import { requireKgConfig } from "../../config.js";
+import { kgRequest } from "../../kg-client.js";
+import { printEntity, printJson } from "../../kg-output.js";
+const VALID_DETAIL = ["tiny", "small", "medium", "full"];
+export async function kgEntity(key, options) {
+    const cfg = requireKgConfig();
+    const detail = options.detail ?? "medium";
+    if (!VALID_DETAIL.includes(detail)) {
+        console.error(`Invalid --detail. Must be one of: ${VALID_DETAIL.join(", ")}`);
+        process.exit(1);
+    }
+    try {
+        const data = await kgRequest(cfg, `/api/v1/entities/${encodeURIComponent(key)}`, {
+            query: { detail },
+        });
+        if (options.json) {
+            printJson(data);
+        }
+        else {
+            printEntity(data);
+        }
+    }
+    catch (err) {
+        console.error(`✗ ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=entity.js.map

package/dist/commands/kg/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/commands/kg/entity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,OAA4C;IACtF,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;IAC1C,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAa,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,KAAK,CAAC,qCAAqC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAM,GAAG,EAAE,oBAAoB,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE;YACpF,KAAK,EAAE,EAAE,MAAM,EAAE;SAClB,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,SAAS,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/kg/match.d.ts

@@ -0,0 +1,5 @@
+export declare function kgMatch(text: string, options: {
+    limit?: string;
+    types?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/kg/match.js

@@ -0,0 +1,44 @@
+/**
+ * 4ort kg match <text>
+ *
+ * POST /api/v1/match  → ranked entity candidates with confidence scores.
+ */
+import { requireKgConfig } from "../../config.js";
+import { kgRequest } from "../../kg-client.js";
+import { printJson, printTable, truncate } from "../../kg-output.js";
+export async function kgMatch(text, options) {
+    const cfg = requireKgConfig();
+    const limit = options.limit ? parseInt(options.limit, 10) : 5;
+    const entity_types = options.types
+        ? options.types.split(",").map((t) => t.trim()).filter(Boolean)
+        : undefined;
+    try {
+        const res = await kgRequest(cfg, "/api/v1/match", {
+            method: "POST",
+            body: { text, entity_types, limit },
+        });
+        if (options.json) {
+            printJson(res);
+            return;
+        }
+        console.log(`Match for "${res.query}"  (${res.latency_ms}ms)\n`);
+        if (res.primary) {
+            console.log(`✓ primary: ${res.primary.name}${res.primary.slug ? ` (${res.primary.slug})` : ""}  conf=${res.primary.confidence.toFixed(2)}\n`);
+        }
+        else {
+            console.log("(no primary match — confidence below 0.7 threshold)\n");
+        }
+        printTable(res.candidates, [
+            ["NAME", (r) => r.name],
+            ["SLUG", (r) => r.slug || ""],
+            ["TYPE", (r) => r.type || ""],
+            ["SUMMARY", (r) => truncate(r.summary, 80)],
+            ["CONF", (r) => r.confidence.toFixed(2)],
+        ]);
+    }
+    catch (err) {
+        console.error(`✗ ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=match.js.map

package/dist/commands/kg/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../../src/commands/kg/match.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAgBrE,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAAY,EACZ,OAA2D;IAE3D,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK;QAChC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAC/D,CAAC,CAAC,SAAS,CAAC;IAEd,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAgB,GAAG,EAAE,eAAe,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE;SACpC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,SAAS,CAAC,GAAG,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,KAAK,OAAO,GAAG,CAAC,UAAU,OAAO,CAAC,CAAC;QACjE,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QACvE,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE;YACzB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACvB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7B,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7B,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC3C,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/kg/popularity.d.ts

@@ -0,0 +1,3 @@
+export declare function kgPopularity(key: string, options: {
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/kg/popularity.js

@@ -0,0 +1,42 @@
+/**
+ * 4ort kg popularity <key>
+ *
+ * GET /api/v1/popularity/{key}  — Wikipedia-pageview-derived "real-world
+ * search volume" (Ahrefs / SEMrush style metric, but measured + CC0).
+ */
+import { requireKgConfig } from "../../config.js";
+import { kgRequest } from "../../kg-client.js";
+import { fmtFloat, fmtInt, printJson } from "../../kg-output.js";
+export async function kgPopularity(key, options) {
+    const cfg = requireKgConfig();
+    try {
+        const res = await kgRequest(cfg, `/api/v1/popularity/${encodeURIComponent(key)}`);
+        if (options.json) {
+            printJson(res);
+            return;
+        }
+        console.log(`${res.name}${res.slug ? `  (${res.slug})` : ""}`);
+        console.log(`  monthly volume:       ${fmtInt(res.monthly_volume)}`);
+        if (res.annual_volume !== undefined)
+            console.log(`  annual volume:        ${fmtInt(res.annual_volume)}`);
+        if (res.trailing_12mo_avg !== undefined)
+            console.log(`  trailing 12mo avg:    ${fmtInt(res.trailing_12mo_avg)}`);
+        if (res.trend_direction)
+            console.log(`  trend:                ${res.trend_direction}`);
+        if (res.yoy_change_pct !== undefined)
+            console.log(`  YoY change:           ${fmtFloat(res.yoy_change_pct, 1)}%`);
+        if (res.rank_within_domain !== undefined && res.domain_size !== undefined) {
+            console.log(`  rank in domain:       #${res.rank_within_domain} of ${fmtInt(res.domain_size)}`);
+        }
+        if (res.trend_12mo.length > 0) {
+            console.log(`\n  12-month trend:`);
+            for (const p of res.trend_12mo)
+                console.log(`    ${p.month}  ${fmtInt(p.views)}`);
+        }
+    }
+    catch (err) {
+        console.error(`✗ ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=popularity.js.map

package/dist/commands/kg/popularity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popularity.js","sourceRoot":"","sources":["../../../src/commands/kg/popularity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAiBjE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,OAA2B;IACzE,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,GAAG,EACH,sBAAsB,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAChD,CAAC;QAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,SAAS,CAAC,GAAG,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,2BAA2B,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACrE,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACzG,IAAI,GAAG,CAAC,iBAAiB,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACjH,IAAI,GAAG,CAAC,eAAe;YAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;QACvF,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QACjH,IAAI,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,4BAA4B,GAAG,CAAC,kBAAkB,OAAO,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAClG,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU;gBAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/kg/search.d.ts

@@ -0,0 +1,4 @@
+export declare function kgSearch(query: string, options: {
+    limit?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/kg/search.js

@@ -0,0 +1,34 @@
+/**
+ * 4ort kg search <query>
+ *
+ * GET /api/v1/search?q=...&limit=...
+ */
+import { requireKgConfig } from "../../config.js";
+import { kgRequest } from "../../kg-client.js";
+import { printJson, printTable, truncate } from "../../kg-output.js";
+export async function kgSearch(query, options) {
+    const cfg = requireKgConfig();
+    const limit = options.limit ? parseInt(options.limit, 10) : 20;
+    try {
+        const res = await kgRequest(cfg, "/api/v1/search", {
+            query: { q: query, limit },
+        });
+        if (options.json) {
+            printJson(res);
+            return;
+        }
+        console.log(`${res.total_returned} results for "${res.query}"  (${res.latency_ms}ms)\n`);
+        printTable(res.hits, [
+            ["NAME", (r) => r.name],
+            ["SLUG", (r) => r.slug || ""],
+            ["TYPE", (r) => r.type || ""],
+            ["SUMMARY", (r) => truncate(r.summary, 80)],
+            ["SCORE", (r) => r.score.toFixed(3)],
+        ]);
+    }
+    catch (err) {
+        console.error(`✗ ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/kg/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/commands/kg/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAkBrE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAa,EAAE,OAA2C;IACvF,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAiB,GAAG,EAAE,gBAAgB,EAAE;YACjE,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;SAC3B,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,SAAS,CAAC,GAAG,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,cAAc,iBAAiB,GAAG,CAAC,KAAK,OAAO,GAAG,CAAC,UAAU,OAAO,CAAC,CAAC;QACzF,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;YACnB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACvB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7B,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7B,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC3C,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/kg/trending.d.ts

@@ -0,0 +1,6 @@
+export declare function kgTrending(options: {
+    hours?: string;
+    limit?: string;
+    domain?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/kg/trending.js

@@ -0,0 +1,35 @@
+/**
+ * 4ort kg trending
+ *
+ * GET /api/v1/trending  — top entities by Wikipedia pageview velocity.
+ */
+import { requireKgConfig } from "../../config.js";
+import { kgRequest } from "../../kg-client.js";
+import { fmtFloat, fmtInt, printJson, printTable } from "../../kg-output.js";
+export async function kgTrending(options) {
+    const cfg = requireKgConfig();
+    const hours = options.hours ? parseInt(options.hours, 10) : 1;
+    const limit = options.limit ? parseInt(options.limit, 10) : 50;
+    try {
+        const res = await kgRequest(cfg, "/api/v1/trending", {
+            query: { hours, limit, domain: options.domain },
+        });
+        if (options.json) {
+            printJson(res);
+            return;
+        }
+        console.log(`Trending (last ${res.window_hours}h)  generated ${res.generated_at}\n`);
+        printTable(res.entities, [
+            ["NAME", (r) => r.name],
+            ["DOMAIN", (r) => r.domain || ""],
+            ["VIEWS", (r) => fmtInt(r.views_in_window)],
+            ["VELOCITY", (r) => fmtFloat(r.velocity_score ?? null, 2)],
+            ["WHY", (r) => r.why_trending || ""],
+        ]);
+    }
+    catch (err) {
+        console.error(`✗ ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=trending.js.map

package/dist/commands/kg/trending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trending.js","sourceRoot":"","sources":["../../../src/commands/kg/trending.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAiB7E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAKhC;IACC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAmB,GAAG,EAAE,kBAAkB,EAAE;YACrE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;SAChD,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,SAAS,CAAC,GAAG,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,CAAC,YAAY,iBAAiB,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC;QACrF,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE;YACvB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACvB,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;YACjC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YAC3C,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,5 @@
+export declare function mcpStdioCommand(): Promise<void>;
+export declare function mcpServeCommand(opts: {
+    port?: string;
+    host?: string;
+}): Promise<void>;

package/dist/commands/mcp.js

@@ -0,0 +1,24 @@
+/**
+ * 4ort mcp [stdio]   — run the 4ort MCP server over stdio (Claude Desktop etc.):
+ *     { "mcpServers": { "4ort": { "command": "4ort", "args": ["mcp"] } } }
+ * 4ort mcp serve     — run it as a Streamable HTTP server (deploy behind a
+ *     reverse proxy → mcp.4ort.xyz). Default 127.0.0.1:8003.
+ *
+ * Tools (both transports): kg_search, web_get, kg_entity, kg_match, kg_agent_context.
+ * kg_search + web_get work keyless; the kg_* entity tools use whatever 4ort.xyz
+ * key the server's ~/.4ort/config.json has (run `4ort kg auth login` on the host).
+ */
+import { runMcpStdio, runMcpHttp } from "../mcp-server.js";
+export async function mcpStdioCommand() {
+    await runMcpStdio();
+}
+export async function mcpServeCommand(opts) {
+    const port = opts.port ? parseInt(opts.port, 10) : 8003;
+    const host = opts.host || "127.0.0.1";
+    if (!Number.isFinite(port) || port <= 0 || port > 65535) {
+        console.error(`Invalid --port: ${opts.port}`);
+        process.exit(1);
+    }
+    await runMcpHttp({ host, port });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,WAAW,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAsC;IAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/commands/run.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `4ort run -- <command> [args...]`
+ *
+ * Resolves any env var whose value is a `4ort://service[/name]` reference into
+ * its real secret (fetched from the 4ort.ai vault at runtime), injects the
+ * plaintext into the child process's environment ONLY, and runs the command.
+ * Plaintext never touches disk — it lives only in the child's memory.
+ * Fails closed: if any referenced secret can't be resolved, nothing runs.
+ */
+export declare function runCommand(parts: string[]): Promise<void>;

package/dist/commands/run.js

@@ -0,0 +1,74 @@
+import { spawn } from "node:child_process";
+import { requireVaultConfig } from "../config.js";
+const REF_RE = /^4ort:\/\/.+/;
+/**
+ * `4ort run -- <command> [args...]`
+ *
+ * Resolves any env var whose value is a `4ort://service[/name]` reference into
+ * its real secret (fetched from the 4ort.ai vault at runtime), injects the
+ * plaintext into the child process's environment ONLY, and runs the command.
+ * Plaintext never touches disk — it lives only in the child's memory.
+ * Fails closed: if any referenced secret can't be resolved, nothing runs.
+ */
+export async function runCommand(parts) {
+    if (!parts || parts.length === 0) {
+        console.error("Usage: 4ort run -- <command> [args...]");
+        console.error('Example:  GROQ_API_KEY=4ort://groq 4ort run -- node app.js');
+        process.exit(1);
+    }
+    const { token, server } = requireVaultConfig();
+    // Collect env vars that hold a 4ort:// reference.
+    const refsByEnv = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (typeof value === "string" && REF_RE.test(value.trim())) {
+            refsByEnv[key] = value.trim();
+        }
+    }
+    const refs = [...new Set(Object.values(refsByEnv))];
+    let resolved = {};
+    let missing = [];
+    if (refs.length > 0) {
+        try {
+            const res = await fetch(`${server.replace(/\/$/, "")}/api/secrets/resolve`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+                body: JSON.stringify({ refs }),
+            });
+            if (!res.ok) {
+                console.error(`✗ vault resolve failed (HTTP ${res.status}). Try: 4ort vault login`);
+                process.exit(1);
+            }
+            const data = (await res.json());
+            resolved = data.resolved || {};
+            missing = data.missing || [];
+        }
+        catch (e) {
+            console.error(`✗ could not reach the vault: ${e.message}`);
+            process.exit(1);
+        }
+    }
+    if (missing.length > 0) {
+        console.error(`✗ unresolved secret reference(s): ${missing.join(", ")}`);
+        console.error("  add them in the 4ort.ai Secrets panel, or fix the 4ort:// reference.");
+        process.exit(1);
+    }
+    const childEnv = { ...process.env };
+    let injected = 0;
+    for (const [key, ref] of Object.entries(refsByEnv)) {
+        if (resolved[ref] !== undefined) {
+            childEnv[key] = resolved[ref];
+            injected += 1;
+        }
+    }
+    if (injected > 0) {
+        console.error(`4ort: injected ${injected} secret${injected === 1 ? "" : "s"} into the environment`);
+    }
+    const [cmd, ...args] = parts;
+    const child = spawn(cmd, args, { stdio: "inherit", env: childEnv });
+    child.on("error", (e) => {
+        console.error(`✗ failed to run "${cmd}": ${e.message}`);
+        process.exit(1);
+    });
+    child.on("exit", (code) => process.exit(code ?? 0));
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/search.d.ts

@@ -0,0 +1,7 @@
+interface SearchOptions {
+    pages?: string;
+    sources?: string;
+    json?: boolean;
+}
+export declare function searchCommand(query: string, options: SearchOptions): Promise<void>;
+export {};

package/dist/commands/search.js

@@ -0,0 +1,105 @@
+/**
+ * 4ort search <query>  — the smart router. The front door.
+ *
+ * GET /api/v1/route?q=...&limit_pages=...&limit_sources=...   (public, no key)
+ *
+ * Returns everything an agent needs to decide where to go next:
+ *   ● KNOWLEDGE GRAPH   — the canonical 4ort.xyz entity the query names (if any),
+ *                         plus that entity's own official site / social links
+ *                         ("straight to the source"). From here: `4ort kg entity
+ *                         <slug>` / `4ort kg ask "..." --scope <slug>`.
+ *   ☎ AUTHORITATIVE SOURCES — the "phonebook": curated search URLs for the
+ *                         detected vertical (GitHub/Wikipedia/IMDb/SEC/…). The
+ *                         agent can `4ort web get <url>` any of them.
+ *   ⌕ WEB RESULTS       — ranked hits from our Common Crawl index. `4ort web get
+ *                         <url>` to read one.
+ *
+ * Distinct from `4ort kg search`, which is a pure entity-graph lookup.
+ */
+import { optionalKgConfig } from "../config.js";
+import { kgRequest } from "../kg-client.js";
+import { printJson, truncate } from "../kg-output.js";
+function slugFromEntityUrl(u) {
+    if (!u)
+        return undefined;
+    const m = u.match(/\/entity\/([^/?#]+)/);
+    return m ? m[1] : undefined;
+}
+export async function searchCommand(query, options) {
+    const cfg = optionalKgConfig();
+    const limitPages = options.pages ? parseInt(options.pages, 10) : 20;
+    const limitSources = options.sources ? parseInt(options.sources, 10) : 12;
+    try {
+        const res = await kgRequest(cfg, "/api/v1/route", {
+            query: { q: query, limit_pages: limitPages, limit_sources: limitSources },
+        });
+        if (options.json) {
+            printJson(res);
+            return;
+        }
+        // ── header / detected intent ──
+        console.log(`SEARCH  "${res.query}"`);
+        const pi = res.primary_intent;
+        if (pi) {
+            const how = pi.method === "entity"
+                ? `exact entity → ${pi.entity_name}`
+                : pi.method === "keyword"
+                    ? `keyword rule${pi.keyword_hits ? ` · ${pi.keyword_hits} hits` : ""}`
+                    : pi.method === "embedding"
+                        ? "semantic"
+                        : pi.method;
+            console.log(`  intent: ${pi.label}   [${how}]`);
+        }
+        if (res.intent_alternatives?.length) {
+            console.log(`  or maybe: ${res.intent_alternatives.map((a) => a.label).join("  ·  ")}`);
+        }
+        // ── ● knowledge graph ──
+        if (res.canonical_entity) {
+            const e = res.canonical_entity;
+            const slug = slugFromEntityUrl(e.url);
+            console.log(`\n● KNOWLEDGE GRAPH`);
+            console.log(`  ${e.name}${e.summary ? `  —  ${e.summary}` : ""}`);
+            const views = typeof e.monthly_pageviews === "number" && e.monthly_pageviews > 0
+                ? `   ~${e.monthly_pageviews.toLocaleString()} views/mo`
+                : "";
+            console.log(`  ${e.url}${views}`);
+            if (slug) {
+                console.log(`  → 4ort kg entity ${slug} --detail full`);
+                console.log(`  → 4ort kg ask "<question>" --scope ${slug}`);
+            }
+            if (e.links?.length) {
+                console.log(`  straight to the source:`);
+                for (const l of e.links)
+                    console.log(`    ${l.icon || "•"}  ${l.name}: ${l.url}`);
+            }
+        }
+        // ── ☎ the phonebook ──
+        if (res.recommended_sources?.length) {
+            console.log(`\n☎ AUTHORITATIVE SOURCES   (the phonebook — 4ort web get <url> to read one)`);
+            const w = Math.min(22, Math.max(...res.recommended_sources.map((s) => s.name.length)));
+            for (const s of res.recommended_sources) {
+                console.log(`  ${s.name.padEnd(w)}  ${s.url}`);
+            }
+        }
+        // ── ⌕ web results ──
+        if (res.our_pages?.length) {
+            console.log(`\n⌕ WEB RESULTS   (${res.our_pages.length} from our index — 4ort web get <url> to read)`);
+            for (const p of res.our_pages) {
+                console.log(`  ${p.title}${p.host ? `   ·  ${p.host}` : ""}`);
+                console.log(`    ${p.url}`);
+                if (p.snippet)
+                    console.log(`    ${truncate(p.snippet, 140)}`);
+            }
+        }
+        else {
+            console.log(`\n⌕ WEB RESULTS   (nothing in our index for this query — use the phonebook)`);
+        }
+        if (res.license)
+            console.log(`\n${res.license}`);
+    }
+    catch (err) {
+        console.error(`✗ ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

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

package/dist/commands/vault.d.ts

@@ -0,0 +1,7 @@
+/** Link this machine to the 4ort.ai secrets vault using a token minted from the
+ * Secrets panel. The token is stored at ~/.4ort/config.json (mode 0600). */
+export declare function vaultLogin(token: string | undefined, opts: {
+    server?: string;
+}): Promise<void>;
+export declare function vaultStatus(): void;
+export declare function vaultLogout(): void;

package/dist/commands/vault.js

@@ -0,0 +1,62 @@
+import { createInterface } from "node:readline";
+import { loadConfig, saveConfig, saveVaultConfig } from "../config.js";
+const DEFAULT_VAULT_SERVER = "https://4ort.ai";
+function readLine(prompt) {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/** Link this machine to the 4ort.ai secrets vault using a token minted from the
+ * Secrets panel. The token is stored at ~/.4ort/config.json (mode 0600). */
+export async function vaultLogin(token, opts) {
+    const server = (opts.server || DEFAULT_VAULT_SERVER).replace(/\/$/, "");
+    let tok = token;
+    if (!tok) {
+        tok = await readLine("Paste your vault token (4vt_…): ");
+    }
+    if (!tok || !tok.startsWith("4vt_")) {
+        console.error("Expected a token starting with 4vt_. Generate one in the 4ort.ai Secrets panel.");
+        process.exit(1);
+    }
+    // Verify the token against the vault (empty resolve = a cheap auth check).
+    try {
+        const res = await fetch(`${server}/api/secrets/resolve`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", Authorization: `Bearer ${tok}` },
+            body: JSON.stringify({ refs: [] }),
+        });
+        if (!res.ok) {
+            console.error(`Vault login failed (HTTP ${res.status}). Check the token and --server.`);
+            process.exit(1);
+        }
+    }
+    catch (e) {
+        console.error(`Could not reach the vault at ${server}: ${e.message}`);
+        process.exit(1);
+    }
+    saveVaultConfig({ token: tok, server });
+    console.error(`✓ Vault linked (${server}).`);
+    console.error("Use 4ort:// references in your env, then run:  4ort run -- <command>");
+}
+export function vaultStatus() {
+    const c = loadConfig();
+    if (c?.vault?.token) {
+        console.log(`Vault: linked to ${c.vault.server} (token ${c.vault.token.slice(0, 12)}…)`);
+    }
+    else {
+        console.log("Vault: not linked. Run: 4ort vault login");
+    }
+}
+export function vaultLogout() {
+    const c = loadConfig();
+    if (c?.vault) {
+        delete c.vault;
+        saveConfig(c);
+    }
+    console.log("Vault unlinked.");
+}
+//# sourceMappingURL=vault.js.map

package/dist/commands/vault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/commands/vault.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEvE,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAE/C,SAAS,QAAQ,CAAC,MAAc;IAC9B,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YAC7B,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;4EAC4E;AAC5E,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAyB,EACzB,IAAyB;IAEzB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxE,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,MAAM,QAAQ,CAAC,kCAAkC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACjG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,2EAA2E;IAC3E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,sBAAsB,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,GAAG,EAAE,EAAE;YAC/E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;SACnC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,4BAA4B,GAAG,CAAC,MAAM,kCAAkC,CAAC,CAAC;YACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,gCAAgC,MAAM,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,eAAe,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3F,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,CAAC,KAAK,CAAC;QACf,UAAU,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AACjC,CAAC"}

package/dist/commands/web.d.ts

@@ -0,0 +1,6 @@
+interface WebGetOptions {
+    json?: boolean;
+    maxChars?: string;
+}
+export declare function webGet(url: string, options: WebGetOptions): Promise<void>;
+export {};

package/dist/commands/web.js

@@ -0,0 +1,44 @@
+/**
+ * 4ort web get <url>
+ *
+ * Fetch a URL and return its readable text — "Reader Mode" style. Tiered:
+ * our own entity pages → structured record; everything else → live fetch +
+ * Mozilla Readability. No browser, no JS. On block / paywall / binary / parse
+ * failure: ok:false + the URL, so a calling agent can fall back.
+ */
+import { webRead } from "../web-client.js";
+import { printJson } from "../kg-output.js";
+export async function webGet(url, options) {
+    const maxChars = options.maxChars ? parseInt(options.maxChars, 10) : undefined;
+    const res = await webRead(url, { maxChars });
+    if (options.json) {
+        printJson(res);
+        process.exit(res.ok ? 0 : 1);
+    }
+    if (!res.ok) {
+        console.error(`✗ ${res.reason || "failed"}`);
+        console.error(`  ${res.final_url || res.url}`);
+        process.exit(1);
+    }
+    if (res.source === "4ort.xyz" && res.entity) {
+        const e = res.entity;
+        console.log(`# ${e?.name || res.title || res.url}`);
+        console.log(`(4ort.xyz knowledge-graph entity — structured)\n`);
+        if (e?.description)
+            console.log(`${e.description}\n`);
+        printJson(e);
+        return;
+    }
+    if (res.title)
+        console.log(`# ${res.title}`);
+    if (res.byline)
+        console.log(`_by ${res.byline}_`);
+    const meta = [
+        res.word_count != null ? `${res.word_count} words` : null,
+        res.truncated ? "truncated" : null,
+        res.reason || null,
+    ].filter(Boolean).join(" · ");
+    console.log(`<${res.final_url || res.url}>${meta ? `  — ${meta}` : ""}\n`);
+    console.log(res.text || "(no text extracted)");
+}
+//# sourceMappingURL=web.js.map

package/dist/commands/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/commands/web.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAW,EAAE,OAAsB;IAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE7C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,GAAG,CAAC,MAAa,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAChE,IAAI,CAAC,EAAE,WAAW;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;QACtD,SAAS,CAAC,CAAC,CAAC,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7C,IAAI,GAAG,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG;QACX,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,QAAQ,CAAC,CAAC,CAAC,IAAI;QACzD,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;QAClC,GAAG,CAAC,MAAM,IAAI,IAAI;KACnB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,qBAAqB,CAAC,CAAC;AACjD,CAAC"}