recess-cli 2.0.0 → 2.1.0

package/dist/command-schema.js

@@ -2,9 +2,11 @@ import { CliError } from "./errors.js";
 export const AGENT_CONTEXT_SCHEMA_VERSION = "3";
 const BOOLEAN_FLAGS = new Set([
     "all-references",
+    "apply",
     "allow-strand",
     "archived",
     "cancel-subscriptions",
+    "clear",
     "confirm",
     "confirm-destructive-changes",
     "disable-applet-follow-ups",
@@ -19,12 +21,14 @@ const BOOLEAN_FLAGS = new Set([
     "no-collision",
     "no-invite",
     "refresh",
+    "resend",
     "restore",
     "revoke",
     "send-email",
     "skill-only",
     "spec-only",
     "starter-only",
+    "supersede",
     "visual-only",
     "wait",
 ]);

package/dist/commands/applications.js

@@ -0,0 +1,336 @@
+import { unwrap } from "../api.js";
+import { flagList, flagString, hasFlag } from "../args.js";
+import { CliError } from "../errors.js";
+import { assertChoice, flagInteger, positional, readJsonFile, } from "./shared.js";
+const APPLICATION_STATUSES = [
+    "SUBMITTED",
+    "CLAIMED",
+    "ENROLLED",
+    "CLOSED",
+];
+const APPLICATION_DISPOSITIONS = [
+    "READY_TO_ENROLL",
+    "TRIAL",
+    "PENDING_FUNDING",
+    "NO",
+];
+const APPLICATION_QUALITIES = [
+    "QUALIFIED",
+    "NEEDS_NURTURE",
+    "UNKNOWN",
+];
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function parseEnrollKidSpec(raw) {
+    const parts = raw.split(":").map((part) => part.trim());
+    const [quoteLineId, firstName, ageRaw, ...extra] = parts;
+    if (!quoteLineId || !firstName || extra.length > 0) {
+        throw new CliError("invalid_arguments", `--kid must be "<quoteLineId>:<firstName>[:<age>]"; got "${raw}".`);
+    }
+    if (ageRaw === undefined || ageRaw === "") {
+        return { quoteLineId, firstName };
+    }
+    const age = Number(ageRaw);
+    if (!Number.isInteger(age) || age < 1 || age > 25) {
+        throw new CliError("invalid_arguments", `--kid age must be a whole number from 1 to 25; got "${ageRaw}".`);
+    }
+    return { quoteLineId, firstName, age };
+}
+export async function runApplicationsCommand({ parsed, api, writeCommand, }) {
+    const noun = parsed.positionals[0] ?? "";
+    const verb = parsed.positionals[1] ?? "";
+    if (noun === "applications" && verb === "list") {
+        const statusRaw = flagString(parsed, "status");
+        const dispositionRaw = flagString(parsed, "disposition");
+        const qualityRaw = flagString(parsed, "quality");
+        const sourceRaw = flagString(parsed, "source");
+        const statusScopeRaw = flagString(parsed, "status-scope");
+        const dispositionedRaw = flagString(parsed, "dispositioned");
+        const status = statusRaw
+            ? assertChoice(statusRaw, APPLICATION_STATUSES, "--status")
+            : undefined;
+        const dispositionBucket = dispositionRaw
+            ? assertChoice(dispositionRaw, APPLICATION_DISPOSITIONS, "--disposition")
+            : undefined;
+        const leadQuality = qualityRaw
+            ? assertChoice(qualityRaw, APPLICATION_QUALITIES, "--quality")
+            : undefined;
+        const source = sourceRaw
+            ? assertChoice(sourceRaw, ["PUBLIC", "STAFF"], "--source")
+            : undefined;
+        const statusScope = statusScopeRaw
+            ? assertChoice(statusScopeRaw, ["active", "closed"], "--status-scope")
+            : undefined;
+        const dispositioned = dispositionedRaw
+            ? assertChoice(dispositionedRaw, ["true", "false"], "--dispositioned")
+            : undefined;
+        const limit = flagInteger(parsed, "limit", { min: 1, max: 500 });
+        const cursor = flagString(parsed, "cursor");
+        return unwrap(await api.client.GET("/admin/applications/", {
+            params: {
+                query: {
+                    ...(status ? { status } : {}),
+                    ...(dispositionBucket ? { dispositionBucket } : {}),
+                    ...(leadQuality ? { leadQuality } : {}),
+                    ...(source ? { source } : {}),
+                    ...(statusScope ? { statusScope } : {}),
+                    ...(dispositioned ? { dispositioned } : {}),
+                    ...(limit !== undefined ? { limit } : {}),
+                    ...(cursor ? { cursor } : {}),
+                },
+            },
+        }));
+    }
+    if (noun === "applications" &&
+        ["get", "quotes", "meetings", "call-notes"].includes(verb)) {
+        const applicationId = positional(parsed, 2, "application ID");
+        if (verb === "get") {
+            return unwrap(await api.client.GET("/admin/applications/{applicationId}", {
+                params: { path: { applicationId } },
+            }));
+        }
+        if (verb === "quotes") {
+            return unwrap(await api.client.GET("/admin/applications/{applicationId}/quotes", {
+                params: { path: { applicationId } },
+            }));
+        }
+        if (verb === "meetings") {
+            return unwrap(await api.client.GET("/admin/applications/{applicationId}/meetings", {
+                params: { path: { applicationId } },
+            }));
+        }
+        return unwrap(await api.client.GET("/admin/applications/{applicationId}/call-notes", {
+            params: { path: { applicationId } },
+        }));
+    }
+    if (noun === "applications" && verb === "create") {
+        const body = (await readJsonFile(flagString(parsed, "data-file", { required: true }), "Staff application file"));
+        return writeCommand(parsed, {
+            action: "create a staff-entered application and guardian-only family shell (does not enroll, charge, create kid accounts, or send email)",
+            target: {
+                partnerSlug: body.partnerSlug,
+                parentEmail: body.parent?.email,
+            },
+            request: body,
+        }, async () => unwrap(await api.client.POST("/admin/onboarding/applications", { body })));
+    }
+    if (noun === "applications" && verb === "disposition") {
+        const applicationId = positional(parsed, 2, "application ID");
+        const body = (await readJsonFile(flagString(parsed, "data-file", { required: true }), "Application disposition file"));
+        return writeCommand(parsed, {
+            action: "record the application's sales disposition",
+            target: { applicationId },
+            request: body,
+        }, async () => unwrap(await api.client.POST("/admin/applications/{applicationId}/disposition", { params: { path: { applicationId } }, body })));
+    }
+    if (noun === "applications" && verb === "qualify") {
+        const applicationId = positional(parsed, 2, "application ID");
+        const qualityOverride = assertChoice(flagString(parsed, "quality", { required: true }), APPLICATION_QUALITIES, "--quality");
+        const reason = flagString(parsed, "reason", { required: true }).trim();
+        if (!reason) {
+            throw new CliError("invalid_arguments", "--reason must not be empty.");
+        }
+        const body = { qualityOverride, reason };
+        return writeCommand(parsed, {
+            action: "override the application's qualification verdict",
+            target: { applicationId },
+            request: body,
+        }, async () => unwrap(await api.client.POST("/admin/applications/{applicationId}/qualification", { params: { path: { applicationId } }, body })));
+    }
+    if (noun === "applications" && verb === "update-contact") {
+        const applicationId = positional(parsed, 2, "application ID");
+        const body = (await readJsonFile(flagString(parsed, "data-file", { required: true }), "Application contact file"));
+        return writeCommand(parsed, {
+            action: "correct application contact details (changing parent email revokes every live claim link)",
+            target: { applicationId },
+            request: body,
+        }, async () => unwrap(await api.client.PATCH("/admin/applications/{applicationId}/contact", { params: { path: { applicationId } }, body })));
+    }
+    if (noun === "applications" &&
+        (verb === "claim-email" || verb === "claim-link")) {
+        const applicationId = positional(parsed, 2, "application ID");
+        const intentKey = flagString(parsed, "intent-key", { required: true });
+        if (!UUID_RE.test(intentKey)) {
+            throw new CliError("invalid_arguments", "--intent-key must be a UUID.");
+        }
+        const supersede = hasFlag(parsed, "supersede");
+        const body = { intentKey, supersede };
+        return writeCommand(parsed, {
+            action: verb === "claim-email"
+                ? `${supersede ? "replace the current claim link and " : ""}email the application claim link to its frozen recipient`
+                : `${supersede ? "replace the current claim link and " : ""}REVEAL a one-time application claim URL in CLI output`,
+            target: {
+                applicationId,
+                channel: verb === "claim-email" ? "email" : "reveal",
+            },
+            request: body,
+        }, async () => {
+            if (verb === "claim-email") {
+                return unwrap(await api.client.POST("/admin/applications/{applicationId}/claim-token/email", { params: { path: { applicationId } }, body }));
+            }
+            return unwrap(await api.client.POST("/admin/applications/{applicationId}/claim-token", { params: { path: { applicationId } }, body }));
+        });
+    }
+    if (noun === "applications" && verb === "revoke-claim") {
+        const applicationId = positional(parsed, 2, "application ID");
+        return writeCommand(parsed, {
+            action: "revoke every live claim link for the application",
+            target: { applicationId },
+            request: {},
+        }, async () => unwrap(await api.client.POST("/admin/applications/{applicationId}/claim-token/revoke", { params: { path: { applicationId } } })));
+    }
+    if (noun === "applications" && verb === "link-family") {
+        const applicationId = positional(parsed, 2, "application ID");
+        const familyId = flagString(parsed, "family", { required: true });
+        const body = { familyId };
+        return writeCommand(parsed, {
+            action: "permanently associate the application with this existing family (there is no unlink route)",
+            target: { applicationId, familyId },
+            request: body,
+        }, async () => unwrap(await api.client.POST("/admin/applications/{applicationId}/link-family", { params: { path: { applicationId } }, body })));
+    }
+    if (noun === "applications" && verb === "close") {
+        const applicationId = positional(parsed, 2, "application ID");
+        const reason = flagString(parsed, "reason", { required: true }).trim();
+        if (!reason) {
+            throw new CliError("invalid_arguments", "--reason must not be empty.");
+        }
+        const body = { reason };
+        return writeCommand(parsed, {
+            action: "close the submitted application permanently (no reopen route)",
+            target: { applicationId },
+            request: body,
+        }, async () => unwrap(await api.client.POST("/admin/applications/{applicationId}/close", {
+            params: { path: { applicationId } },
+            body,
+        })));
+    }
+    if (noun === "applications" && verb === "add-call-note") {
+        const applicationId = positional(parsed, 2, "application ID");
+        const body = (await readJsonFile(flagString(parsed, "data-file", { required: true }), "Application call-note file"));
+        return writeCommand(parsed, {
+            action: "append a call note to the application (Granola references are resolved and persisted now)",
+            target: { applicationId },
+            request: body,
+        }, async () => unwrap(await api.client.POST("/admin/applications/{applicationId}/call-notes", { params: { path: { applicationId } }, body })));
+    }
+    if (noun === "applications" && verb === "edit-call-note") {
+        const applicationId = positional(parsed, 2, "application ID");
+        const noteId = flagString(parsed, "note-id", { required: true });
+        const body = (await readJsonFile(flagString(parsed, "data-file", { required: true }), "Application call-note comment file"));
+        return writeCommand(parsed, {
+            action: "edit only the staff comment on the application call note (the persisted call summary is unchanged)",
+            target: { applicationId, noteId },
+            request: body,
+        }, async () => unwrap(await api.client.PATCH("/admin/applications/{applicationId}/call-notes/{noteId}", { params: { path: { applicationId, noteId } }, body })));
+    }
+    if (noun === "applications" && verb === "enroll") {
+        const applicationId = positional(parsed, 2, "application ID");
+        const quoteId = flagString(parsed, "quote", { required: true });
+        const institutionSlug = flagString(parsed, "school", { required: true });
+        const familyId = flagString(parsed, "family");
+        const note = flagString(parsed, "note");
+        // Repeatable --kid, one per PRICED LINE on the quote. The server refuses a
+        // partial roster (every priced student must be enrolled), so this is
+        // deliberately not a convenience list — it is the whole quote, echoed back.
+        const kidSpecs = flagList(parsed, "kid");
+        if (kidSpecs.length === 0) {
+            throw new CliError("invalid_arguments", 'Missing --kid. Pass one per quote line: --kid "<quoteLineId>:<firstName>[:<age>]".');
+        }
+        const kids = kidSpecs.map(parseEnrollKidSpec);
+        // Every OTHER live child in the family must be named explicitly. The server
+        // refuses the whole enrollment otherwise, listing who was unlisted — so the
+        // failure is legible either way, but naming them here is how a staffer says
+        // "yes, I know, they are not enrolling".
+        const dispositions = flagList(parsed, "unassign").map((kidUserId) => ({
+            kidUserId,
+            action: "unassigned",
+        }));
+        return writeCommand(parsed, {
+            // One short clause, like every other preview in this file. The
+            // consequences are enumerated in `request` below, which is what the
+            // confirmation prompt prints in full — restating them here would make
+            // this the only preview a staffer has to read twice.
+            action: "enroll an application from its accepted quote (creates children, charges the first month, cancels marketplace subscriptions)",
+            target: { applicationId, quoteId, institutionSlug, familyId },
+            request: { kids, dispositions, note },
+        }, async () => unwrap(await api.client.POST("/admin/applications/{applicationId}/enroll", {
+            params: { path: { applicationId } },
+            body: {
+                quoteId,
+                institutionSlug,
+                kids,
+                ...(familyId ? { familyId } : {}),
+                ...(dispositions.length > 0 ? { dispositions } : {}),
+                ...(note ? { note } : {}),
+            },
+        })));
+    }
+    if (noun === "quotes" && verb === "get") {
+        const id = positional(parsed, 2, "quote ID");
+        return unwrap(await api.client.GET("/admin/quotes/{id}", {
+            params: { path: { id } },
+        }));
+    }
+    if (noun === "quotes" && verb === "preview") {
+        const body = (await readJsonFile(flagString(parsed, "data-file", { required: true }), "Quote preview file"));
+        return unwrap(await api.client.POST("/admin/quotes/preview", { body }));
+    }
+    if (noun === "quotes" && verb === "create") {
+        const body = (await readJsonFile(flagString(parsed, "data-file", { required: true }), "Quote file"));
+        return writeCommand(parsed, {
+            action: "create and store a DRAFT manual quote for the application (no email and no charge)",
+            target: { applicationId: body.applicationId },
+            request: body,
+        }, async () => unwrap(await api.client.POST("/admin/quotes/", { body })));
+    }
+    if (noun === "quotes" && verb === "update") {
+        const id = positional(parsed, 2, "quote ID");
+        const body = (await readJsonFile(flagString(parsed, "data-file", { required: true }), "Quote update file"));
+        return writeCommand(parsed, {
+            action: "replace the DRAFT quote's manual lines and note (sent quotes are immutable)",
+            target: { quoteId: id },
+            request: body,
+        }, async () => unwrap(await api.client.PATCH("/admin/quotes/{id}", {
+            params: { path: { id } },
+            body,
+        })));
+    }
+    if (noun === "quotes" && verb === "send") {
+        const id = positional(parsed, 2, "quote ID");
+        const expectedRevision = flagString(parsed, "expected-revision");
+        const body = expectedRevision ? { expectedRevision } : {};
+        return writeCommand(parsed, {
+            action: "send the DRAFT quote to the family and transition it to SENT",
+            target: { quoteId: id },
+            request: body,
+        }, async () => unwrap(await api.client.POST("/admin/quotes/{id}/send", {
+            params: { path: { id } },
+            body,
+        })));
+    }
+    if (noun === "quotes" && verb === "accept") {
+        const id = positional(parsed, 2, "quote ID");
+        return writeCommand(parsed, {
+            action: "record the family's acceptance of this SENT quote (does not enroll or charge yet)",
+            target: { quoteId: id },
+            request: {},
+        }, async () => unwrap(await api.client.POST("/admin/quotes/{id}/accept", {
+            params: { path: { id } },
+        })));
+    }
+    if (noun === "quotes" && verb === "decline") {
+        const id = positional(parsed, 2, "quote ID");
+        const note = flagString(parsed, "note");
+        const body = note ? { note } : {};
+        return writeCommand(parsed, {
+            action: "decline the SENT quote",
+            target: { quoteId: id },
+            request: body,
+        }, async () => unwrap(await api.client.POST("/admin/quotes/{id}/decline", {
+            params: { path: { id } },
+            body,
+        })));
+    }
+    throw new CliError("invalid_arguments", `Unknown ${noun} command. Run \`recess ${noun} --help\` for the current command list.`);
+}
+//# sourceMappingURL=applications.js.map