@4ort/cli 0.4.0 → 0.6.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/mov.d.ts

@@ -0,0 +1,17 @@
+export declare function movLogin(options: {
+    server?: string;
+    username?: string;
+    password?: string;
+}): Promise<void>;
+export declare function movPublish(file: string, options: {
+    title?: string;
+    channel?: string;
+    description?: string;
+    thumbnail?: string;
+    privacy?: string;
+}): Promise<void>;
+export declare function movList(): Promise<void>;
+export declare function movChannels(options: {
+    create?: string;
+}): Promise<void>;
+export declare function movDelete(id: string): Promise<void>;

package/dist/commands/mov.js

@@ -0,0 +1,124 @@
+/**
+ * 4ort mov — publish & manage videos on 4ort.mov (PeerTube).
+ *
+ * login    — OAuth password grant, persists tokens to ~/.4ort/config.json
+ * publish  — upload a finished video file
+ * list     — list your videos
+ * channels — list channels (or --create one)
+ * delete   — delete a video by id
+ */
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { saveMovConfig, optionalMovConfig } from "../config.js";
+import { getOAuthClient, getToken, uploadVideo, listMyChannels, createChannel, listMyVideos, deleteVideo, resolveChannelId, privacyToEnum, buildWatchUrl, } from "../peertube-client.js";
+const DEFAULT_SERVER = "https://4ort.mov";
+export async function movLogin(options) {
+    const server = options.server || DEFAULT_SERVER;
+    // Non-interactive (agents/CI): flags or env. Falls back to prompts for humans.
+    let username = options.username || process.env.FORT_MOV_USERNAME;
+    let password = options.password || process.env.FORT_MOV_PASSWORD;
+    let rl;
+    try {
+        if (!username || !password) {
+            rl = readline.createInterface({ input, output });
+            if (!username)
+                username = (await rl.question("PeerTube username (e.g. root): ")).trim();
+            if (!password)
+                password = (await rl.question("Password: ")).trim();
+        }
+        if (!username || !password) {
+            console.error("username and password required (use --username/--password or env FORT_MOV_USERNAME/FORT_MOV_PASSWORD)");
+            process.exit(1);
+        }
+        console.log(`\nAuthenticating to ${server}...`);
+        const client = await getOAuthClient(server);
+        const tok = await getToken(server, client, username, password);
+        saveMovConfig({
+            server,
+            accessToken: tok.accessToken,
+            refreshToken: tok.refreshToken,
+            clientId: client.clientId,
+            clientSecret: client.clientSecret,
+            username,
+        });
+        console.log("✓ Signed in to 4ort.mov. Try: 4ort mov channels");
+    }
+    catch (e) {
+        console.error(`✗ ${e.message}`);
+        process.exit(1);
+    }
+    finally {
+        rl?.close();
+    }
+}
+export async function movPublish(file, options) {
+    try {
+        const cfg = optionalMovConfig();
+        if (!options.title) {
+            console.error("--title is required");
+            process.exit(1);
+        }
+        const channels = await listMyChannels(cfg);
+        const channelId = resolveChannelId(channels, options.channel);
+        const privacy = privacyToEnum(options.privacy || "unlisted");
+        console.log(`Uploading ${file}...`);
+        const v = await uploadVideo(cfg, {
+            file,
+            name: options.title,
+            channelId,
+            privacy,
+            description: options.description,
+            thumbnail: options.thumbnail,
+        });
+        console.log(`✓ Published: ${buildWatchUrl(cfg.server, v.shortUUID)}`);
+    }
+    catch (e) {
+        console.error(`✗ ${e.message}`);
+        process.exit(1);
+    }
+}
+export async function movList() {
+    try {
+        const cfg = optionalMovConfig();
+        const vids = await listMyVideos(cfg);
+        if (!vids.length) {
+            console.log("(no videos)");
+            return;
+        }
+        for (const v of vids)
+            console.log(`${v.id}\t${v.privacy}\t${v.name}\t${buildWatchUrl(cfg.server, v.shortUUID)}`);
+    }
+    catch (e) {
+        console.error(`✗ ${e.message}`);
+        process.exit(1);
+    }
+}
+export async function movChannels(options) {
+    try {
+        const cfg = optionalMovConfig();
+        if (options.create) {
+            const id = await createChannel(cfg, options.create);
+            console.log(`✓ created channel '${options.create}' (id ${id})`);
+            return;
+        }
+        const channels = await listMyChannels(cfg);
+        for (const c of channels)
+            console.log(`${c.id}\t${c.name}\t${c.displayName}`);
+    }
+    catch (e) {
+        console.error(`✗ ${e.message}`);
+        process.exit(1);
+    }
+}
+export async function movDelete(id) {
+    try {
+        const cfg = optionalMovConfig();
+        await deleteVideo(cfg, Number(id));
+        console.log(`✓ deleted video ${id}`);
+    }
+    catch (e) {
+        console.error(`✗ ${e.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=mov.js.map

package/dist/commands/mov.js.map

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

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