@mnemom/mnemom 0.9.1 → 0.10.0

package/dist/commands/advisories.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `mnemom advisories ...` commands — Piece 6 of T1-3.1 (ADR-040, ADR-045, ADR-047).
+ *
+ *   mnemom advisories list --agent <agent_id> [--source <source>] [--limit <n>] [--since <ISO>] [--json]
+ *   mnemom advisories list --team  <team_id>  [--source <source>] [--limit <n>] [--since <ISO>] [--json]
+ *   mnemom advisories show <advisory_id> [--agent <agent_id> | --team <team_id>] [--json]
+ *
+ * Surfaces the customer-facing read paths over `pending_advisories` rows
+ * with `source LIKE 'sideband.%'`. Detector firings — coherence,
+ * fault-line, fleet, drift — land here as the cross-turn carryover the
+ * gateway injects on the agent's next request.
+ *
+ * Either --agent or --team is required. Source filter accepts the closed
+ * enum values from ADR-047 §6 (sideband.coherence, sideband.fault_line,
+ * sideband.fleet, sideband.drift, manual.admin) — unknown values are
+ * accepted and applied verbatim (forward-compat for ADR-047 amendments).
+ */
+interface ListOpts {
+    agent?: string;
+    team?: string;
+    source?: string;
+    limit?: string;
+    since?: string;
+    json?: boolean;
+}
+export declare function advisoriesListCommand(opts: ListOpts): Promise<void>;
+export declare function advisoriesShowCommand(advisoryId: string, opts: {
+    agent?: string;
+    team?: string;
+    json?: boolean;
+}): Promise<void>;
+export {};

package/dist/commands/advisories.js

@@ -0,0 +1,158 @@
+/**
+ * `mnemom advisories ...` commands — Piece 6 of T1-3.1 (ADR-040, ADR-045, ADR-047).
+ *
+ *   mnemom advisories list --agent <agent_id> [--source <source>] [--limit <n>] [--since <ISO>] [--json]
+ *   mnemom advisories list --team  <team_id>  [--source <source>] [--limit <n>] [--since <ISO>] [--json]
+ *   mnemom advisories show <advisory_id> [--agent <agent_id> | --team <team_id>] [--json]
+ *
+ * Surfaces the customer-facing read paths over `pending_advisories` rows
+ * with `source LIKE 'sideband.%'`. Detector firings — coherence,
+ * fault-line, fleet, drift — land here as the cross-turn carryover the
+ * gateway injects on the agent's next request.
+ *
+ * Either --agent or --team is required. Source filter accepts the closed
+ * enum values from ADR-047 §6 (sideband.coherence, sideband.fault_line,
+ * sideband.fleet, sideband.drift, manual.admin) — unknown values are
+ * accepted and applied verbatim (forward-compat for ADR-047 amendments).
+ */
+import chalk from "chalk";
+import { listSidebandAdvisoriesForAgent, listSidebandAdvisoriesForTeam, } from "../lib/api.js";
+import { requireAuth } from "../lib/auth.js";
+import { fmt } from "../lib/format.js";
+function statusBadge(s) {
+    switch (s) {
+        case "pending":
+            return fmt.badge("PENDING", "yellow");
+        case "consumed":
+            return chalk.dim("consumed");
+        case "expired":
+            return chalk.dim("expired");
+        default:
+            return chalk.dim(s.toUpperCase());
+    }
+}
+function shortId(id) {
+    return id.length <= 16 ? id : id.slice(0, 13) + "...";
+}
+function formatRow(a) {
+    return [
+        chalk.dim(shortId(a.id).padEnd(16)),
+        chalk.cyan(a.source.padEnd(22)),
+        statusBadge(a.status).padEnd(20),
+        chalk.dim(a.created_at.replace("T", " ").replace(/\.\d+Z$/, "Z")),
+        a.concerns_summary,
+    ].join("  ");
+}
+// ─── mnemom advisories list ──────────────────────────────────────────────
+export async function advisoriesListCommand(opts) {
+    if (!opts.agent && !opts.team) {
+        console.error(fmt.error("--agent <id> or --team <id> is required") + "\n");
+        process.exit(1);
+    }
+    if (opts.agent && opts.team) {
+        console.error(fmt.error("--agent and --team are mutually exclusive") + "\n");
+        process.exit(1);
+    }
+    await requireAuth();
+    const limit = opts.limit ? parseInt(opts.limit, 10) : undefined;
+    if (opts.limit && (Number.isNaN(limit) || (limit ?? 0) <= 0)) {
+        console.error(fmt.error(`--limit must be a positive integer (got '${opts.limit}')`) + "\n");
+        process.exit(1);
+    }
+    let result;
+    let scopeLabel;
+    try {
+        if (opts.agent) {
+            result = await listSidebandAdvisoriesForAgent(opts.agent, {
+                limit,
+                since: opts.since,
+            });
+            scopeLabel = `agent ${opts.agent}`;
+        }
+        else {
+            result = await listSidebandAdvisoriesForTeam(opts.team, {
+                limit,
+                since: opts.since,
+            });
+            scopeLabel = `team ${opts.team}`;
+        }
+    }
+    catch (err) {
+        console.error(fmt.error(err instanceof Error ? err.message : String(err)) + "\n");
+        process.exit(1);
+        return;
+    }
+    let advisories = result.advisories;
+    if (opts.source) {
+        advisories = advisories.filter((a) => a.source === opts.source);
+    }
+    if (opts.json) {
+        console.log(fmt.json({ ...result, advisories }));
+        return;
+    }
+    if (advisories.length === 0) {
+        console.log(chalk.dim(`No sideband advisories for ${scopeLabel}.`));
+        return;
+    }
+    console.log(chalk.bold(`Sideband advisories — ${scopeLabel}`));
+    console.log(chalk.dim(`(${advisories.length} row(s))`));
+    console.log();
+    console.log(chalk.dim("ID                SOURCE                  STATUS              CREATED              SUMMARY"));
+    for (const a of advisories) {
+        console.log(formatRow(a));
+    }
+}
+// ─── mnemom advisories show ──────────────────────────────────────────────
+export async function advisoriesShowCommand(advisoryId, opts) {
+    if (!opts.agent && !opts.team) {
+        console.error(fmt.error("--agent <id> or --team <id> is required (the listing endpoint scopes results)") +
+            "\n");
+        process.exit(1);
+    }
+    await requireAuth();
+    let advisories;
+    try {
+        if (opts.agent) {
+            advisories = (await listSidebandAdvisoriesForAgent(opts.agent, { limit: 200 })).advisories;
+        }
+        else {
+            advisories = (await listSidebandAdvisoriesForTeam(opts.team, { limit: 500 })).advisories;
+        }
+    }
+    catch (err) {
+        console.error(fmt.error(err instanceof Error ? err.message : String(err)) + "\n");
+        process.exit(1);
+        return;
+    }
+    const match = advisories.find((a) => a.id === advisoryId);
+    if (!match) {
+        console.error(fmt.error(`Advisory '${advisoryId}' not found in scope.`) + "\n");
+        process.exit(1);
+        return;
+    }
+    if (opts.json) {
+        console.log(fmt.json(match));
+        return;
+    }
+    console.log(chalk.bold(match.id));
+    console.log();
+    console.log(fmt.label("source       ", match.source));
+    console.log(fmt.label("status       ", match.status));
+    console.log(fmt.label("agent_id     ", match.agent_id));
+    console.log(fmt.label("created_at   ", match.created_at));
+    console.log(fmt.label("expires_at   ", match.expires_at));
+    if (match.consumed_at) {
+        console.log(fmt.label("consumed_at  ", match.consumed_at));
+    }
+    console.log();
+    console.log(chalk.bold("Concerns summary"));
+    console.log(`  ${match.concerns_summary}`);
+    console.log();
+    console.log(chalk.bold("Nudge content (injected to agent)"));
+    console.log(`  ${match.nudge_content}`);
+    if (match.source_ref) {
+        console.log();
+        console.log(chalk.bold("source_ref"));
+        console.log(fmt.json(match.source_ref));
+    }
+}

package/dist/commands/org.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `mnemom org list`
+ *
+ * Lists every org the user is a member of, including their personal-org-of-one
+ * (per ADR-044 Option A — GitHub model). Personal orgs are tagged `(personal)`
+ * in the Name column. Output is a human-readable table; pass `--json` for
+ * machine-readable output.
+ */
+export declare function orgListCommand(opts: {
+    json?: boolean;
+}): Promise<void>;
+/**
+ * `mnemom org show [<org_id>]` or `mnemom org show --personal`
+ *
+ * Print details for one organization. With `--personal`, fetches the user's
+ * personal org via `/v1/auth/me/personal-org`. Otherwise, the membership
+ * matching `<org_id>` is printed (or, if no id is given and the user has
+ * exactly one membership, that one).
+ */
+export declare function orgShowCommand(orgIdArg: string | undefined, opts: {
+    personal?: boolean;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/org.js

@@ -0,0 +1,122 @@
+import { listMyOrgs, getMyPersonalOrg } from "../lib/api.js";
+import { requireAuth } from "../lib/auth.js";
+import { fmt } from "../lib/format.js";
+/**
+ * `mnemom org list`
+ *
+ * Lists every org the user is a member of, including their personal-org-of-one
+ * (per ADR-044 Option A — GitHub model). Personal orgs are tagged `(personal)`
+ * in the Name column. Output is a human-readable table; pass `--json` for
+ * machine-readable output.
+ */
+export async function orgListCommand(opts) {
+    await requireAuth();
+    let orgs;
+    try {
+        orgs = await listMyOrgs();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.log(fmt.error(`Failed to list orgs: ${msg}`) + "\n");
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(orgs, null, 2));
+        return;
+    }
+    console.log(fmt.header("Organizations"));
+    console.log();
+    if (orgs.length === 0) {
+        console.log("  No organizations found.\n");
+        return;
+    }
+    const nameW = 32;
+    const idW = 24;
+    const roleW = 10;
+    const ownerW = 8;
+    const header = "Name".padEnd(nameW) +
+        "ID".padEnd(idW) +
+        "Role".padEnd(roleW) +
+        "Owner".padEnd(ownerW);
+    console.log(`  ${header}`);
+    console.log(`  ${"─".repeat(nameW + idW + roleW + ownerW)}`);
+    for (const org of orgs) {
+        const tag = org.is_personal ? " (personal)" : "";
+        const name = `${org.name}${tag}`.slice(0, nameW - 2).padEnd(nameW);
+        const id = org.org_id.slice(0, idW - 2).padEnd(idW);
+        const role = (org.role ?? "-").padEnd(roleW);
+        const owner = (org.is_owner ? "yes" : "no").padEnd(ownerW);
+        console.log(`  ${name}${id}${role}${owner}`);
+    }
+    console.log(`\n  Total: ${orgs.length} organization(s)\n`);
+}
+/**
+ * `mnemom org show [<org_id>]` or `mnemom org show --personal`
+ *
+ * Print details for one organization. With `--personal`, fetches the user's
+ * personal org via `/v1/auth/me/personal-org`. Otherwise, the membership
+ * matching `<org_id>` is printed (or, if no id is given and the user has
+ * exactly one membership, that one).
+ */
+export async function orgShowCommand(orgIdArg, opts) {
+    await requireAuth();
+    let target = null;
+    try {
+        if (opts.personal) {
+            const ref = await getMyPersonalOrg();
+            // Re-resolve to the full org row so we can print every field.
+            const orgs = await listMyOrgs();
+            target = orgs.find((o) => o.org_id === ref.org_id) ?? null;
+        }
+        else {
+            const orgs = await listMyOrgs();
+            if (orgIdArg) {
+                target = orgs.find((o) => o.org_id === orgIdArg) ?? null;
+                if (!target) {
+                    console.log(fmt.error(`Org '${orgIdArg}' not found in your memberships.`) + "\n");
+                    process.exit(1);
+                }
+            }
+            else if (orgs.length === 1) {
+                target = orgs[0];
+            }
+            else {
+                console.log(fmt.warn(`You have ${orgs.length} memberships. Specify an org_id or pass --personal.`) + "\n");
+                process.exit(1);
+                return;
+            }
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.log(fmt.error(`Failed to fetch org: ${msg}`) + "\n");
+        process.exit(1);
+        return;
+    }
+    if (!target) {
+        console.log(fmt.error("Org not found.") + "\n");
+        process.exit(1);
+        return;
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(target, null, 2));
+        return;
+    }
+    console.log(fmt.header(target.name));
+    console.log();
+    console.log(`  ID:          ${target.org_id}`);
+    console.log(`  Slug:        ${target.slug}`);
+    console.log(`  Personal:    ${target.is_personal ? "yes" : "no"}`);
+    console.log(`  Role:        ${target.role ?? "-"}`);
+    console.log(`  Owner:       ${target.is_owner ? "yes (you)" : "no"}`);
+    if (target.billing_email) {
+        console.log(`  Billing:     ${target.billing_email}`);
+    }
+    if (target.company_name) {
+        console.log(`  Company:     ${target.company_name}`);
+    }
+    if (target.accepted_at) {
+        console.log(`  Accepted at: ${new Date(target.accepted_at).toLocaleDateString()}`);
+    }
+    console.log();
+}

package/dist/commands/posture.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `mnemom posture ...` commands — Piece 3 of T1-3.1 (ADR-045).
+ *
+ *   mnemom posture list [--org <id>] [--include-platform=false] [--json]
+ *   mnemom posture show <posture_id> [--json]
+ *   mnemom posture create --org <id> --slug <slug> --name <name>
+ *                         --from <file> [--description <text>]
+ *   mnemom posture update <posture_id> --from <file> [--summary <text>]
+ *   mnemom posture clone <posture_id> --org <id> [--slug <slug>] [--name <name>]
+ *   mnemom posture revisions <posture_id> [--json]
+ *   mnemom posture diff <posture_id> --from <N> --to <M> [--json]
+ *   mnemom posture assign <posture_id> --team <team_id> [--pin-revision <N>]
+ *   mnemom posture unassign <posture_id> --team <team_id>
+ *   mnemom posture preview-compose <posture_id> --team <team_id> [--json]
+ *   mnemom posture delete <posture_id>
+ *
+ * Per ADR-045: postures are team-scoped policy input; cards remain
+ * agent-scoped runtime output. The CLI authenticates the user the same
+ * way `mnemom team` and `mnemom org` do — login token or MNEMOM_API_KEY.
+ */
+export declare function postureListCommand(opts: {
+    org?: string;
+    includePlatform?: boolean;
+    json?: boolean;
+}): Promise<void>;
+export declare function postureShowCommand(postureId: string | undefined, opts: {
+    json?: boolean;
+}): Promise<void>;
+export declare function postureCreateCommand(opts: {
+    org?: string;
+    slug?: string;
+    name?: string;
+    from?: string;
+    description?: string;
+    summary?: string;
+    json?: boolean;
+}): Promise<void>;
+export declare function postureUpdateCommand(postureId: string | undefined, opts: {
+    from?: string;
+    summary?: string;
+    name?: string;
+    description?: string;
+    json?: boolean;
+}): Promise<void>;
+export declare function postureCloneCommand(postureId: string | undefined, opts: {
+    org?: string;
+    slug?: string;
+    name?: string;
+    description?: string;
+    json?: boolean;
+}): Promise<void>;
+export declare function postureRevisionsCommand(postureId: string | undefined, opts: {
+    json?: boolean;
+}): Promise<void>;
+export declare function postureDiffCommand(postureId: string | undefined, opts: {
+    from?: string;
+    to?: string;
+    json?: boolean;
+}): Promise<void>;
+export declare function postureAssignCommand(postureId: string | undefined, opts: {
+    team?: string;
+    pinRevision?: string;
+}): Promise<void>;
+export declare function postureUnassignCommand(postureId: string | undefined, opts: {
+    team?: string;
+}): Promise<void>;
+export declare function posturePreviewComposeCommand(postureId: string | undefined, opts: {
+    team?: string;
+    json?: boolean;
+}): Promise<void>;
+export declare function postureDeleteCommand(postureId: string | undefined): Promise<void>;