@unisonlabs/sixminute-admin 0.1.1236 → 0.1.1237-next

package/dist/sixminute-admin.mjs

@@ -16,12 +16,12 @@ var __export = (target, all) => {
 
 // tools/admin/src/main.ts
 import { spawn } from "node:child_process";
-import { readFileSync as readFileSync3 } from "node:fs";
+import { readFileSync as readFileSync4 } from "node:fs";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
 
 // tools/admin/src/build-info.ts
-var BUILT = { version: "0.1.1236", commit: "e9471c769e8799b7718544270c264cc208c3856f", surface: "dd0676dc61078cce" };
+var BUILT = { version: "0.1.1237-next", commit: "fbfe48a89dd45b61d2677caa1981d41796a47ad4", surface: "3b2db9633e846531" };
 
 // tools/admin/src/run.ts
 import { rmSync as rmSync3 } from "node:fs";
@@ -5054,7 +5054,8 @@ var TenantPolicySchema = exports_external.object({
   security_tier: exports_external.enum(["standard", "confidential"]).default("standard"),
   raw_archive: exports_external.boolean().default(false),
   research_export: exports_external.boolean().default(false),
-  context_retention_days: exports_external.number().int().min(0).max(365).default(30)
+  context_retention_days: exports_external.number().int().min(0).max(365).default(30),
+  demo: exports_external.object({ enabled: exports_external.boolean() }).optional()
 }).default({});
 var NARRATIVE_GUIDANCE_MAX_CHARS = 1500;
 var GUIDANCE_CONTROL = /[\u0000-\u0009\u000B-\u001F\u007F-\u009F]/;
@@ -5962,6 +5963,10 @@ var AdminResearchExportSetSchema = exports_external.object({ research_export: ex
 var AdminResearchExportFlagSchema = exports_external.object({
   tenant: exports_external.object({ id: TenantIdSchema, name: exports_external.string(), research_export: exports_external.boolean() })
 });
+var AdminDemoSetSchema = exports_external.object({ enabled: exports_external.boolean() });
+var AdminDemoFlagSchema = exports_external.object({
+  tenant: exports_external.object({ id: TenantIdSchema, name: exports_external.string(), demo: exports_external.boolean() })
+});
 var AdminDeviceVersionSchema = exports_external.object({
   id: DeviceIdSchema,
   name: exports_external.string(),
@@ -6256,6 +6261,140 @@ var ServedConfigBundleSchema = ConfigBundleSchema.extend({
   prompts: ServedConfigPromptsSchema,
   vocabularies: ServedConfigVocabulariesSchema
 });
+// packages/contracts/src/demo.ts
+var ClockSchema = exports_external.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "a local clock time, HH:MM");
+var KeySchema = exports_external.string().regex(/^[a-z0-9][a-z0-9_-]{0,63}$/i, "a key: letters, digits, _ and -");
+var DemoObservationSchema = exports_external.object({
+  from: ClockSchema,
+  to: ClockSchema,
+  app: exports_external.string().min(1),
+  bundle: exports_external.string().min(1),
+  title: exports_external.string(),
+  typed: exports_external.string().default(""),
+  url: exports_external.string().nullable().default(null),
+  files: exports_external.array(exports_external.string().min(1)).default([]),
+  screen: exports_external.string().optional()
+}).strict();
+var DemoDecisionSchema = exports_external.object({ summary: exports_external.string().min(1), activity: exports_external.string().min(1).nullable(), matter: KeySchema.nullable() }).strict();
+var DemoIntervalSchema = exports_external.object({ from: ClockSchema, to: ClockSchema, observations: exports_external.array(DemoObservationSchema).default([]), decision: DemoDecisionSchema.optional() }).strict();
+var DemoEntrySchema = exports_external.object({ from: ClockSchema, to: ClockSchema, matter: KeySchema.nullable(), narrative: exports_external.string().min(1), codes: exports_external.record(exports_external.string().min(1)).default({}) }).strict();
+var DemoRecordingSchema = exports_external.object({ start: ClockSchema, stop: ClockSchema, intervals: exports_external.array(DemoIntervalSchema).min(1) }).strict();
+var minutes = (clock) => Number(clock.slice(0, 2)) * 60 + Number(clock.slice(3));
+function problemsOf(s) {
+  const out = [];
+  const clients = new Set(s.clients.map((c) => c.key));
+  const matters = new Set(s.matters.map((m) => m.key));
+  if (clients.size !== s.clients.length)
+    out.push([["clients"], "a client key is used twice"]);
+  if (matters.size !== s.matters.length)
+    out.push([["matters"], "a matter key is used twice"]);
+  s.matters.forEach((m, i) => clients.has(m.client) || out.push([["matters", i, "client"], `no client ${m.client}`]));
+  const all = [];
+  let previousStop = -1;
+  s.recordings.forEach((rec, r) => {
+    const [start, stop] = [minutes(rec.start), minutes(rec.stop)];
+    if (stop <= start)
+      out.push([["recordings", r, "stop"], "a recording stops after it starts"]);
+    if (start < previousStop)
+      out.push([["recordings", r, "start"], "recordings are in order and do not overlap"]);
+    previousStop = stop;
+    rec.intervals.forEach((one, i) => {
+      const [from, to] = [minutes(one.from), minutes(one.to)];
+      const at = ["recordings", r, "intervals", i];
+      if (from % s.unit_minutes !== 0 || to - from !== s.unit_minutes)
+        out.push([at, `an interval is one unit of ${s.unit_minutes} minutes on the grid`]);
+      if (from < start || to > stop)
+        out.push([at, "an interval lies inside its recording"]);
+      if (i > 0 && minutes(rec.intervals[i - 1].to) !== from)
+        out.push([at, "intervals are contiguous"]);
+      one.observations.forEach((o, k) => {
+        if (minutes(o.from) < from || minutes(o.to) > to || minutes(o.to) <= minutes(o.from))
+          out.push([[...at, "observations", k], "an observation lies inside its interval"]);
+      });
+      const matter = one.decision?.matter ?? null;
+      if (matter !== null && !matters.has(matter))
+        out.push([[...at, "decision", "matter"], `no matter ${matter}`]);
+      const work = one.decision === undefined || one.decision.activity === null ? null : JSON.stringify([one.decision.activity, matter]);
+      all.push({ r, from, to, work, matter });
+    });
+  });
+  const covered = new Set;
+  s.entries.forEach((e, i) => {
+    const at = ["entries", i];
+    if (e.matter !== null && !matters.has(e.matter))
+      out.push([[...at, "matter"], `no matter ${e.matter}`]);
+    const first = all.findIndex((one) => one.from === minutes(e.from));
+    const last = all.findIndex((one) => one.to === minutes(e.to));
+    if (first < 0 || last < first || all[first].r !== all[last].r) {
+      out.push([at, "an entry starts and ends on interval bounds of one recording"]);
+      return;
+    }
+    const inside = all.slice(first, last + 1);
+    if (inside.some((one, k) => one.work === null || one.matter !== e.matter || k > 0 && inside[k - 1].to !== one.from)) {
+      out.push([at, "an entry covers only contiguous decided work on its own matter"]);
+    }
+    const [before, after] = [all[first - 1], all[last + 1]];
+    const joins = (a, b) => a !== undefined && a.r === b.r && a.to === b.from && a.work === b.work;
+    if (joins(before, inside[0]) || after !== undefined && joins(inside.at(-1), after))
+      out.push([at, "an entry starts and ends where an activity block does"]);
+    for (let k = first;k <= last; k++)
+      covered.has(k) ? out.push([at, "entries do not overlap"]) : covered.add(k);
+  });
+  const clock = (m) => `${String(Math.floor(m / 60)).padStart(2, "0")}:${String(m % 60).padStart(2, "0")}`;
+  if (s.entries.length > 0)
+    all.forEach((one, k) => one.work !== null && !covered.has(k) && out.push([["entries"], `the work at ${clock(one.from)} is in no entry`]));
+  return out;
+}
+var DemoScenarioSchema = exports_external.object({
+  format: exports_external.literal(1),
+  name: KeySchema,
+  description: exports_external.string().default(""),
+  time_zone: exports_external.string().min(1),
+  unit_minutes: exports_external.number().int().min(1).max(60),
+  clients: exports_external.array(exports_external.object({ key: KeySchema, name: exports_external.string().min(1) }).strict()),
+  matters: exports_external.array(exports_external.object({ key: KeySchema, client: KeySchema, number: exports_external.string().min(1), name: exports_external.string().min(1) }).strict()),
+  codes: exports_external.object({ set: exports_external.union([exports_external.string().min(1), exports_external.array(exports_external.string().min(1)).min(1)]) }).strict().optional(),
+  recordings: exports_external.array(DemoRecordingSchema).min(1),
+  entries: exports_external.array(DemoEntrySchema).default([])
+}).strict().superRefine((s, ctx) => {
+  for (const [path, message] of problemsOf(s))
+    ctx.addIssue({ code: exports_external.ZodIssueCode.custom, path, message });
+});
+function replayGap(s) {
+  if (s.recordings.some((r) => r.intervals.some((i) => i.decision === undefined)))
+    return "every interval needs its decision";
+  return s.entries.length === 0 ? "a replay needs the scenario's entries" : null;
+}
+var AdminDemoSeedSchema = exports_external.object({
+  scenario: DemoScenarioSchema,
+  day: LocalDaySchema.optional(),
+  replay: exports_external.boolean().default(false),
+  generate: exports_external.boolean().default(false)
+});
+var AdminDemoDaySchema = exports_external.object({ day: LocalDaySchema, generate: exports_external.boolean().default(false) });
+var counts = { member_id: MemberIdSchema, day: LocalDaySchema };
+var AdminDemoSeedResultSchema = exports_external.object({
+  ...counts,
+  mode: exports_external.enum(["live", "replay"]),
+  recordings: exports_external.number().int(),
+  contexts: exports_external.object({ stored: exports_external.number().int(), repeated: exports_external.number().int() }),
+  created: exports_external.object({ clients: exports_external.number().int(), matters: exports_external.number().int() }),
+  generate_run: exports_external.string().nullable()
+});
+var AdminDemoResetResultSchema = exports_external.object({
+  ...counts,
+  runs_deleted: exports_external.number().int(),
+  drafts_deleted: exports_external.number().int(),
+  released_kept: exports_external.number().int(),
+  generate_run: exports_external.string().nullable()
+});
+var AdminDemoRemoveResultSchema = exports_external.object({ ...counts, recordings_deleted: exports_external.number().int(), entries_deleted: exports_external.number().int() });
+var AdminDemoStatusSchema = exports_external.object({
+  tenant: exports_external.object({ id: TenantIdSchema, name: exports_external.string(), demo: exports_external.boolean() }),
+  member_id: MemberIdSchema,
+  caps: exports_external.object({ calls_per_day: exports_external.number().int(), cost_usd_per_day: exports_external.number() }),
+  days: exports_external.array(exports_external.object({ day: LocalDaySchema, mode: exports_external.enum(["live", "replay"]), recordings: exports_external.number().int(), entries: exports_external.number().int() }))
+});
 // packages/contracts/src/device.ts
 var DEVICE_CREDENTIAL_PREFIX = "smd_";
 var ENROLLMENT_CODE_PREFIX = "sme_";
@@ -6384,7 +6523,7 @@ var LocalSettingsSchema = exports_external.object({
   capture_enabled: exports_external.boolean(),
   excluded_bundles: exports_external.array(exports_external.string().min(1)),
   excluded_sites: exports_external.array(SiteSchema).default([]),
-  policy: TenantPolicySchema,
+  policy: TenantPolicySchema.removeDefault().omit({ demo: true }).default({}),
   lists_revision: exports_external.string().min(1).nullable().default(null),
   raw_archive: exports_external.object({
     allowed: exports_external.boolean(),
@@ -7316,11 +7455,11 @@ function fieldLines(summary) {
   ];
 }
 function summaryLines(summary) {
-  const counts = summary.counts;
+  const counts2 = summary.counts;
   return [
     `connector     ${summary.kind}  ${summary.status}`,
     `team          ${summary.team_bound} bound, ${summary.team_unbound} unbound`,
-    `lists         ${counts.matters} matters, ${counts.clients} clients, ` + `${counts.timekeepers} timekeepers, ${counts.options} options`,
+    `lists         ${counts2.matters} matters, ${counts2.clients} clients, ` + `${counts2.timekeepers} timekeepers, ${counts2.options} options`,
     `last sync     ${summary.last_sync_at ?? "never"}`,
     `last error    ${summary.last_error ?? "none"}`,
     ...summary.capabilities.accepts_by === "approval" ? [`reviewer      ${reviewerLine(summary)}`, `approval      ${approvalLine(summary)}`] : []
@@ -7480,6 +7619,84 @@ function googleAccessToken(env, platform) {
   throw new UnsealError("no Google access token: set GOOGLE_OAUTH_ACCESS_TOKEN, or install the gcloud CLI and run " + "`gcloud auth login` as yourself. The unseal runs as YOU, never as a service account.");
 }
 
+// tools/admin/src/demo.ts
+import { readFileSync as readFileSync3 } from "node:fs";
+function readScenario(path) {
+  let raw;
+  try {
+    raw = JSON.parse(readFileSync3(path, "utf8"));
+  } catch (err) {
+    throw new AdminUsageError(`${path} is not readable JSON: ${err.message}`);
+  }
+  const parsed = DemoScenarioSchema.safeParse(raw);
+  if (!parsed.success) {
+    throw new AdminUsageError(`${path} is not a demo scenario:
+${parsed.error.issues.map((i) => `  ${i.path.join(".") || "(root)"}: ${i.message}`).join(`
+`)}`);
+  }
+  return parsed.data;
+}
+function validateScenario(argv) {
+  const [path, ...rest] = argv;
+  if (path === undefined || path.startsWith("--") || rest.some((arg) => arg !== "--json"))
+    throw new AdminUsageError("demo validate takes one scenario file, and --json");
+  const s = readScenario(path);
+  const facts = {
+    name: s.name,
+    recordings: s.recordings.length,
+    intervals: s.recordings.reduce((n, r) => n + r.intervals.length, 0),
+    entries: s.entries.length,
+    replay: replayGap(s) ?? "yes"
+  };
+  if (rest.includes("--json"))
+    return { code: 0, lines: [JSON.stringify({ valid: true, ...facts }, null, 2)] };
+  return { code: 0, lines: [`valid         ${facts.name}`, `recordings    ${facts.recordings}, ${facts.intervals} intervals, ${facts.entries} entries`, `replay        ${facts.replay}`] };
+}
+async function runDemo(run2, subcommand) {
+  if (run2.environment.name === "production")
+    throw new AdminUsageError("demo commands run on staging (or local) only: production never enters demo mode");
+  const tenantId = required(run2.flags, "tenant", "which firm, an internal one");
+  const path = (rest) => tenantPath(tenantId, rest);
+  if (subcommand === "on" || subcommand === "off") {
+    const { tenant } = AdminDemoFlagSchema.parse(expectOk(await call(run2.api, "PUT", path("/demo"), { enabled: subcommand === "on" })));
+    return render(run2, { tenant }, [`tenant        ${tenant.id}  ${tenant.name}`, `demo          ${tenant.demo}`]);
+  }
+  if (subcommand === "status") {
+    const status = AdminDemoStatusSchema.parse(expectOk(await call(run2.api, "GET", path("/demo"))));
+    return render(run2, status, [
+      `tenant        ${status.tenant.id}  ${status.tenant.name}  demo ${status.tenant.demo}`,
+      `member        ${status.member_id}`,
+      `caps          ${status.caps.calls_per_day} calls, ${status.caps.cost_usd_per_day} USD per UTC day`,
+      ...status.days.length === 0 ? ["no seeded day"] : status.days.map((d) => `${d.day}    ${d.mode}  ${d.recordings} recordings, ${d.entries} entries`)
+    ]);
+  }
+  if (subcommand === "seed") {
+    const scenario = readScenario(required(run2.flags, "scenario", "the scenario file to seed"));
+    const day = run2.flags.values.has("day") ? dayOf2(run2.flags, "day", "the day to seed on") : undefined;
+    const body = { scenario, ...day === undefined ? {} : { day }, replay: switched(run2.flags, "replay"), generate: switched(run2.flags, "generate") };
+    const done = AdminDemoSeedResultSchema.parse(expectOk(await call(run2.api, "POST", path("/demo/seed"), body)));
+    return render(run2, done, [
+      `seeded        ${scenario.name} on ${done.day}, ${done.mode}, into ${done.member_id}`,
+      `contexts      ${done.contexts.stored} stored, ${done.contexts.repeated} already there, over ${done.recordings} recordings`,
+      `created       ${done.created.clients} clients, ${done.created.matters} matters`,
+      done.generate_run === null ? "Generate the day from the app, or run demo reset --generate." : `generate      ${done.generate_run}`
+    ]);
+  }
+  if (subcommand === "reset" || subcommand === "remove") {
+    const day = dayOf2(run2.flags, "day", `the seeded day to ${subcommand}`);
+    if (subcommand === "remove") {
+      const done2 = AdminDemoRemoveResultSchema.parse(expectOk(await call(run2.api, "POST", path("/demo/remove"), { day })));
+      return render(run2, done2, [`removed       ${done2.day}: ${done2.recordings_deleted} recordings, ${done2.entries_deleted} entries`]);
+    }
+    const done = AdminDemoResetResultSchema.parse(expectOk(await call(run2.api, "POST", path("/demo/reset"), { day, generate: switched(run2.flags, "generate") })));
+    return render(run2, done, [
+      `reset         ${done.day}: ${done.runs_deleted} Generate runs, ${done.drafts_deleted} drafts deleted, ${done.released_kept} released kept`,
+      ...done.generate_run === null ? [] : [`generate      ${done.generate_run}`]
+    ]);
+  }
+  throw new AdminUsageError(`unknown command: demo ${subcommand ?? ""}`.trim());
+}
+
 // tools/admin/src/run.ts
 var ROLE_SLUGS = FIRM_ROLE_SLUGS;
 var CONFIDENTIAL_EXIT_CODE = 3;
@@ -7630,6 +7847,27 @@ is required; without one every command answers 403.
         --dry-run prints every row it would remove and writes nothing; without
         it and without --yes the command prints the same list and refuses.
 
+  sixminute-admin demo on --env staging --tenant tenant_... [--json]
+  sixminute-admin demo off --env staging --tenant tenant_... [--json]
+        The firm's demo mode: its members' runs get the demo caps (50,000 calls
+        and 100 USD a day), and the demo commands below work on it. Internal
+        firms only, on staging only: every demo command refuses production.
+  sixminute-admin demo status --env staging --tenant tenant_... [--json]
+        The flag, the caps in force, and your own seeded days, live or replay.
+  sixminute-admin demo validate tools/demo-scenarios/example-small.json [--json]
+        Checks a scenario file offline: its shape, its times and every reference.
+  sixminute-admin demo seed --env staging --tenant tenant_... --scenario <file> [--day YYYY-MM-DD] [--replay] [--generate] [--json]
+        Seeds the scenario into YOUR OWN account of the firm (accept an
+        invitation with the same address first), on its own Scenario device.
+        Without --day, the most recent day it lies wholly in the past on, with
+        nothing captured. --replay makes the day's Generate answer from the
+        scenario with no model; --generate starts that Generate.
+  sixminute-admin demo reset --env staging --tenant tenant_... --day YYYY-MM-DD [--generate] [--json]
+        Drops the seeded day's Generate runs and drafts, so Generate runs
+        again over the same activity. Released entries stay.
+  sixminute-admin demo remove --env staging --tenant tenant_... --day YYYY-MM-DD [--json]
+        Deletes the seeded day entirely. Captured time is never touched.
+
   sixminute-admin attribute add --env <env> --tenant tenant_... --key utbms_task --label "UTBMS task" [--required] [--proposed] [--default-set aset_a,aset_b] [--json]
         Writes one attribute, whole: a bounded single-select field on an entry,
         which is what a firm calls its codes. --default-set names the sets a
@@ -7805,7 +8043,9 @@ var BOOLEAN_FLAGS = new Set([
   "on",
   "off",
   "auto",
-  "review"
+  "review",
+  "replay",
+  "generate"
 ]);
 function parseFlags(argv, offset) {
   const values = new Map;
@@ -7909,6 +8149,8 @@ async function runAdmin(argv, deps) {
   if (group === "--version") {
     return { code: 0, lines: [`sixminute-admin ${deps.build.version} (API ${deps.build.commit}, operator surface ${deps.build.surface})`] };
   }
+  if (group === "demo" && subcommand === "validate")
+    return validateScenario(rest);
   const oneWord = ["login", "logout", "whoami", "doctor", "versions", "audit"].includes(group);
   const vocabulary2 = group === "attribute" || group === "matter" && subcommand === "sets";
   const threeDeep = group === "tenant" && subcommand === "internal";
@@ -8000,6 +8242,8 @@ async function runAdmin(argv, deps) {
     return runEntriesPurge(run2);
   if (group === "connector")
     return runConnector(run2, subcommand);
+  if (group === "demo")
+    return runDemo(run2, subcommand);
   if (group === "firm" || group === "invite")
     return runFirm(run2, group, subcommand);
   throw new AdminUsageError(`unknown command ${JSON.stringify([group, subcommand].filter(Boolean).join(" "))}.
@@ -8264,9 +8508,9 @@ async function runVersions(run2) {
 async function runEntriesPurge(run2) {
   const { flags } = run2;
   const tenantId = required(flags, "tenant", "which firm's rows are being removed");
-  const demo = switched(flags, "demo");
+  const demo2 = switched(flags, "demo");
   const unmatched = switched(flags, "unmatched");
-  if (!demo && !unmatched) {
+  if (!demo2 && !unmatched) {
     throw new AdminUsageError("name what to remove: --demo (the rows tools/demo-seed minted) or --unmatched " + "(engine-written rows charged to no matter), or both. This command never guesses a selector.");
   }
   const author = optional(flags, "author");
@@ -8275,15 +8519,15 @@ async function runEntriesPurge(run2) {
   }
   const dryRun = switched(flags, "dry-run");
   const yes = switched(flags, "yes");
-  const purge = async (dry) => AdminEntriesPurgeResultSchema.parse(expectOk(await call(run2.api, "POST", tenantPath(tenantId, "/entries/purge"), { author, demo, unmatched, dry_run: dry })));
+  const purge = async (dry) => AdminEntriesPurgeResultSchema.parse(expectOk(await call(run2.api, "POST", tenantPath(tenantId, "/entries/purge"), { author, demo: demo2, unmatched, dry_run: dry })));
   const done = await purge(dryRun || !yes);
   const total = done.rows.demo.length + done.rows.unmatched.length;
   const listing = [
     `tenant        ${tenantId}`,
     `author        ${author}  (user ${done.user})`,
     "",
-    ...demo ? purgeSection("demo entries (entry_demo-)", done.rows.demo) : [],
-    ...demo && unmatched ? [""] : [],
+    ...demo2 ? purgeSection("demo entries (entry_demo-)", done.rows.demo) : [],
+    ...demo2 && unmatched ? [""] : [],
     ...unmatched ? purgeSection("unmatched captured entries (no matter, engine-written)", done.rows.unmatched) : [],
     ""
   ];
@@ -8937,7 +9181,7 @@ function adminSurfaceOf(document) {
 // tools/admin/src/main.ts
 function sourceBuild() {
   const document = fileURLToPath(new URL("../../../services/api/openapi.json", import.meta.url));
-  const surface = adminSurfaceOf(JSON.parse(readFileSync3(document, "utf8")));
+  const surface = adminSurfaceOf(JSON.parse(readFileSync4(document, "utf8")));
   return { version: "0.0.0-dev", commit: "source", surface };
 }
 function openBrowser(url) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unisonlabs/sixminute-admin",
-  "version": "0.1.1236",
+  "version": "0.1.1237-next",
   "description": "Sixminute operator tool: the admin commands of the Sixminute API, run with your own operator sign-in.",
   "license": "UNLICENSED",
   "repository": {