mneme-ai 3.16.0 → 3.17.0

package/dist/commands/orbital.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `mneme orbital` — a sensory nerve to the sky for a space-ops agent (internal).
+ * Pulls REAL, free, public, real-time telemetry over plain internet (no API key) and turns it into a
+ * signed context + an honest operational advisory that can tighten an APHELION charter.
+ *   orbital weather                          → live NOAA space weather + advisory
+ *   orbital track --lat 13.7 --lon 100.5     → is the ISS overhead you right now
+ * HONEST: telemetry the agent READS + governs by — not a claim that space weather alters the model.
+ */
+import type { Command } from "commander";
+export declare function registerOrbitalCommands(program: Command): void;
+//# sourceMappingURL=orbital.d.ts.map

package/dist/commands/orbital.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbital.d.ts","sourceRoot":"","sources":["../../src/commands/orbital.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoC9D"}

package/dist/commands/orbital.js

@@ -0,0 +1,68 @@
+import { get as httpsGet } from "node:https";
+import { get as httpGet } from "node:http";
+import { orbital } from "@mneme-ai/core";
+function out(s) { process.stdout.write(s + "\n"); }
+function fetchJson(url) {
+    return new Promise((resolve, reject) => {
+        const lib = url.startsWith("https") ? httpsGet : httpGet;
+        const req = lib(url, (r) => { let b = ""; r.on("data", (c) => (b += c)); r.on("end", () => { try {
+            resolve(JSON.parse(b));
+        }
+        catch (e) {
+            reject(e);
+        } }); });
+        req.on("error", reject);
+        req.setTimeout(8000, () => req.destroy(new Error("timeout")));
+    });
+}
+export function registerOrbitalCommands(program) {
+    const k = program.command("orbital").description("🛰 ORBITAL (internal) — a sensory nerve to the sky: ingest REAL free public space-weather (NOAA) + satellite position as signed context + an APHELION charter advisory. Honest: the agent READS the sky, it doesn't 'feel' it.");
+    k.command("weather", { isDefault: true }).description("Live NOAA space weather (geomagnetic / radio-blackout / solar + Kp) → an operational advisory.")
+        .option("--json", "print the parsed weather + advisory as JSON")
+        .action(async (o) => {
+        try {
+            const [scales, kp] = await Promise.all([
+                fetchJson("https://services.swpc.noaa.gov/products/noaa-scales.json"),
+                fetchJson("https://services.swpc.noaa.gov/json/planetary_k_index_1m.json").catch(() => []),
+            ]);
+            const sw = orbital.parseSpaceWeather(scales, kp);
+            const adv = orbital.spaceWeatherAdvisory(sw);
+            if (o.json) {
+                out(JSON.stringify({ sw, advisory: adv }, null, 2));
+                return;
+            }
+            const ico = adv.level === "severe" ? "🔴" : adv.level === "warning" ? "🟠" : adv.level === "caution" ? "🟡" : "🟢";
+            out(`🛰 SPACE WEATHER · ${ico} ${adv.level.toUpperCase()} · ${sw.condition} · captured ${sw.capturedAt || "now"}`);
+            out(`   geomagnetic G${sw.geomagnetic.scale} · radio-blackout R${sw.radioBlackout.scale} · solar S${sw.solarRadiation.scale} · Kp ${sw.kpIndex ?? "?"} · risk ${adv.riskFactor}`);
+            for (const i of adv.impacts)
+                out(`   • ${i}`);
+            if (adv.charterSuggestion) {
+                const c = adv.charterSuggestion;
+                out(`   🛡 suggested APHELION charter: maxRisk→${c.lowerMaxRiskTo}${c.requireApprovalFor?.length ? ` · approve: ${c.requireApprovalFor.join("/")}` : ""}${c.addForbidden?.length ? ` · forbid: ${c.addForbidden.join("/")}` : ""}`);
+                out(`     → apply: mneme aphelion amend --node <n> --reason "${c.reason}" --max-risk ${c.lowerMaxRiskTo}`);
+            }
+            else
+                out("   🟢 nominal — no charter change advised.");
+            out("   (real NOAA telemetry the agent reads + governs by — not a mood/entropy claim)");
+        }
+        catch (e) {
+            out(`✗ could not reach NOAA (need internet): ${e.message}`);
+            process.exitCode = 2;
+        }
+    });
+    k.command("track").description("Is the ISS overhead you right now? (live position over plain internet).")
+        .requiredOption("--lat <n>", "your latitude", parseFloat).requiredOption("--lon <n>", "your longitude", parseFloat)
+        .action(async (o) => {
+        try {
+            const iss = await fetchJson("http://api.open-notify.org/iss-now.json");
+            const sLat = Number(iss?.iss_position?.latitude), sLon = Number(iss?.iss_position?.longitude);
+            const v = orbital.isOverhead(sLat, sLon, 420, o.lat, o.lon);
+            out(`🛰 ISS at ${sLat.toFixed(2)}, ${sLon.toFixed(2)} · ${v.overhead ? "🟢 OVERHEAD (in view)" : "⚪ below horizon"} · ${v.groundDistanceKm} km away (horizon ${v.horizonKm} km)`);
+        }
+        catch (e) {
+            out(`✗ could not reach the ISS feed: ${e.message}`);
+            process.exitCode = 2;
+        }
+    });
+}
+//# sourceMappingURL=orbital.js.map

package/dist/commands/orbital.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbital.js","sourceRoot":"","sources":["../../src/commands/orbital.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,GAAG,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,SAAS,GAAG,CAAC,CAAS,IAAU,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACjE,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;QACzD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7J,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,gOAAgO,CAAC,CAAC;IAEnR,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,gGAAgG,CAAC;SACpJ,MAAM,CAAC,QAAQ,EAAE,6CAA6C,CAAC;SAC/D,MAAM,CAAC,KAAK,EAAE,CAAqB,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACrC,SAAS,CAAC,0DAA0D,CAAC;gBACrE,SAAS,CAAC,+DAA+D,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;aAC3F,CAAC,CAAC;YACH,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAAC,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;YAC/F,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC5E,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACnH,GAAG,CAAC,sBAAsB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,SAAS,eAAe,EAAE,CAAC,UAAU,IAAI,KAAK,EAAE,CAAC,CAAC;YACnH,GAAG,CAAC,mBAAmB,EAAE,CAAC,WAAW,CAAC,KAAK,sBAAsB,EAAE,CAAC,aAAa,CAAC,KAAK,aAAa,EAAE,CAAC,cAAc,CAAC,KAAK,SAAS,EAAE,CAAC,OAAO,IAAI,GAAG,WAAW,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;YAClL,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO;gBAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC;gBAC1B,MAAM,CAAC,GAAG,GAAG,CAAC,iBAAiB,CAAC;gBAChC,GAAG,CAAC,6CAA6C,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpO,GAAG,CAAC,2DAA2D,CAAC,CAAC,MAAM,gBAAgB,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;YAC7G,CAAC;;gBAAM,GAAG,CAAC,4CAA4C,CAAC,CAAC;YACzD,GAAG,CAAC,kFAAkF,CAAC,CAAC;QAC1F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,GAAG,CAAC,2CAA4C,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QAAC,CAAC;IAC/G,CAAC,CAAC,CAAC;IAEL,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,yEAAyE,CAAC;SACtG,cAAc,CAAC,WAAW,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,gBAAgB,EAAE,UAAU,CAAC;SAClH,MAAM,CAAC,KAAK,EAAE,CAA+B,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,yCAAyC,CAAiE,CAAC;YACvI,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;YAC9F,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;YAC5D,GAAG,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,iBAAiB,MAAM,CAAC,CAAC,gBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC;QACpL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,GAAG,CAAC,mCAAoC,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QAAC,CAAC;IACvG,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkMA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkmNvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmMA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmmNvD"}

package/dist/index.js

@@ -112,6 +112,7 @@ import { registerAgentcertCommands } from "./commands/agentcert.js";
 import { registerThymosCommands } from "./commands/thymos.js";
 import { registerInfraCommands } from "./commands/infra.js";
 import { registerAphelionCommands } from "./commands/aphelion.js";
+import { registerOrbitalCommands } from "./commands/orbital.js";
 import { registerAdamasCommands } from "./commands/adamas.js";
 import { registerPrismCommands } from "./commands/prism.js";
 import { registerGoldilocksCommands } from "./commands/goldilocks.js";
@@ -4791,6 +4792,7 @@ export async function run(argv) {
     registerThymosCommands(program);
     registerInfraCommands(program);
     registerAphelionCommands(program);
+    registerOrbitalCommands(program);
     registerAdamasCommands(program);
     registerPrismCommands(program);
     registerGoldilocksCommands(program);