@heychunky/core 0.12.0 → 0.13.0

package/dist/admin/index.d.ts

@@ -14,6 +14,7 @@ export * from "./provision.ts";
 export * from "./decommission.ts";
 export * from "./migrations.ts";
 export * from "./promote.ts";
+export * from "./runs.ts";
 export * from "./entrypoints.ts";
 export * from "./chunks.ts";
 export * from "./services/github.ts";

package/dist/admin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAG5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAG5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/admin/index.js

@@ -14,6 +14,7 @@ export * from "./provision.js";
 export * from "./decommission.js";
 export * from "./migrations.js";
 export * from "./promote.js";
+export * from "./runs.js";
 export * from "./entrypoints.js";
 export * from "./chunks.js";
 // One file per service, matching the registry.

package/dist/admin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAE5B,+CAA+C;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAE5B,+CAA+C;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/admin/runs.d.ts

@@ -0,0 +1,98 @@
+/**
+ * What the factory did, and on whose behalf.
+ *
+ * Provisioning has always returned a `Run` and never cared where it went; the
+ * CLI writes one to `~/.heychunky/runs` and says in its own header that the
+ * shape was settled and a table would take it eventually. This is that table.
+ *
+ * It matters more now than it did, because a superagent works unattended. A
+ * provisioning run had a person watching it who could say what happened; a run
+ * that classified, planned, implemented and reviewed while nobody was looking
+ * leaves nothing behind but comments on an issue and a log that ages out. The
+ * question "what has chunky been doing, and what did it cost" has had no answer
+ * anywhere.
+ *
+ * Two things are deliberately separate here:
+ *
+ *   who may *start* a run on a target   — `appFor` for an app, role for the
+ *                                          factory's own repositories
+ *   who may *see* a run afterwards      — the operator who asked, and superadmin
+ *
+ * The second is what this file answers, and it keys on the operator rather than
+ * on the app precisely so a decommissioned app does not take its history with
+ * it.
+ */
+import type { Register } from "./master.ts";
+import type { StepResult } from "./provision.ts";
+import type { User } from "./users.ts";
+/** Where the work came from: `github:heychunkydev/x#12`, `email`, `cli`. */
+export type RunSource = string;
+export interface FactoryRun {
+    id: string;
+    /** Always known. `heychunkydev/heychunky-core`. */
+    repo: string;
+    /**
+     * The app this repository belongs to, when it is one.
+     *
+     * Null means no app row — either a factory repository, which is machinery
+     * rather than somebody's app, or an app that has since been taken down. Both
+     * are read the same way on purpose: neither has an owner to answer to, so
+     * neither is a developer's to see.
+     */
+    app_id: string | null;
+    /** Whose behalf it ran on. Never chunky's own: every run traces to a human. */
+    operator_id: string;
+    source: RunSource;
+    title: string | null;
+    /** The same shape provisioning reports, so one renderer serves both. */
+    steps: StepResult[];
+    /** What the models cost, when the caller knows. */
+    cost: string | null;
+    outcome: "running" | "done" | "failed";
+    created_at: string;
+    finished_at: string | null;
+}
+/** What a caller supplies. The id is theirs to choose, so a run can be updated. */
+export interface RunRecord {
+    id: string;
+    repo: string;
+    appId?: string | null;
+    operatorId: string;
+    source: RunSource;
+    title?: string | null;
+    steps: StepResult[];
+    cost?: string | null;
+    outcome: FactoryRun["outcome"];
+    finishedAt?: string | null;
+}
+/**
+ * Make sure the table is there.
+ *
+ * `create table if not exists`, called before a write, which is the same way
+ * the migration ledger arrives in an app's database. The register has no
+ * migration mechanism of its own — `apps` and `users` were made by hand — and
+ * inventing one to add a single table would be a larger decision than this
+ * file is entitled to make. This at least leaves the schema written down in
+ * the repository rather than only in the database.
+ */
+export declare function ensureRuns(register: Register): Promise<void>;
+/**
+ * Write a run, or bring an existing one up to date.
+ *
+ * One call rather than start/step/finish, because a station boundary is the
+ * only moment worth recording and the caller already holds the whole list by
+ * then. Upserting on the id also means a run interrupted halfway leaves the
+ * steps it did reach rather than nothing at all — the same property the
+ * migration ledger has, and for the same reason.
+ */
+export declare function recordRun(run: RunRecord, register: Register): Promise<void>;
+/**
+ * The runs a person may see, newest first.
+ *
+ * Scoped on who asked rather than on which app, so a developer keeps the
+ * history of work they requested even after the app it touched is gone, and so
+ * runs against the factory's own repositories — which have no app and no owner
+ * — are visible to the superadmin who started them and to nobody else.
+ */
+export declare function listRuns(user: Pick<User, "id" | "role">, register: Register, limit?: number): Promise<FactoryRun[]>;
+//# sourceMappingURL=runs.d.ts.map

package/dist/admin/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/admin/runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wEAAwE;IACxE,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,mDAAmD;IACnD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBlE;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjF;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,EAC/B,QAAQ,EAAE,QAAQ,EAClB,KAAK,SAAK,GACT,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvB"}

package/dist/admin/runs.js

@@ -0,0 +1,66 @@
+/**
+ * Make sure the table is there.
+ *
+ * `create table if not exists`, called before a write, which is the same way
+ * the migration ledger arrives in an app's database. The register has no
+ * migration mechanism of its own — `apps` and `users` were made by hand — and
+ * inventing one to add a single table would be a larger decision than this
+ * file is entitled to make. This at least leaves the schema written down in
+ * the repository rather than only in the database.
+ */
+export async function ensureRuns(register) {
+    await register.write(`create table if not exists runs (
+       id uuid primary key,
+       repo text not null,
+       app_id uuid references apps(id) on delete set null,
+       operator_id uuid not null references users(id),
+       source text not null,
+       title text,
+       steps jsonb not null default '[]'::jsonb,
+       cost numeric,
+       outcome text not null default 'running',
+       created_at timestamptz not null default now(),
+       finished_at timestamptz
+     )`);
+}
+/**
+ * Write a run, or bring an existing one up to date.
+ *
+ * One call rather than start/step/finish, because a station boundary is the
+ * only moment worth recording and the caller already holds the whole list by
+ * then. Upserting on the id also means a run interrupted halfway leaves the
+ * steps it did reach rather than nothing at all — the same property the
+ * migration ledger has, and for the same reason.
+ */
+export async function recordRun(run, register) {
+    await ensureRuns(register);
+    await register.write(`insert into runs (id, repo, app_id, operator_id, source, title, steps, cost, outcome, finished_at)
+     values ($1, $2, $3, $4, $5, $6, $7::jsonb, $8, $9, $10)
+     on conflict (id) do update set
+       steps = excluded.steps,
+       cost = coalesce(excluded.cost, runs.cost),
+       outcome = excluded.outcome,
+       title = coalesce(excluded.title, runs.title),
+       finished_at = coalesce(excluded.finished_at, runs.finished_at)`, [
+        run.id, run.repo, run.appId ?? null, run.operatorId, run.source,
+        run.title ?? null, JSON.stringify(run.steps), run.cost ?? null,
+        run.outcome, run.finishedAt ?? null,
+    ]);
+}
+/**
+ * The runs a person may see, newest first.
+ *
+ * Scoped on who asked rather than on which app, so a developer keeps the
+ * history of work they requested even after the app it touched is gone, and so
+ * runs against the factory's own repositories — which have no app and no owner
+ * — are visible to the superadmin who started them and to nobody else.
+ */
+export async function listRuns(user, register, limit = 50) {
+    await ensureRuns(register);
+    const select = `select * from runs`;
+    const { rows } = user.role === "superadmin"
+        ? await register.query(`${select} order by created_at desc limit $1`, [limit])
+        : await register.query(`${select} where operator_id = $1 order by created_at desc limit $2`, [user.id, limit]);
+    return rows;
+}
+//# sourceMappingURL=runs.js.map

package/dist/admin/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/admin/runs.ts"],"names":[],"mappings":"AAuEA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAkB;IACjD,MAAM,QAAQ,CAAC,KAAK,CAClB;;;;;;;;;;;;OAYG,CACJ,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAc,EAAE,QAAkB;IAChE,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3B,MAAM,QAAQ,CAAC,KAAK,CAClB;;;;;;;sEAOkE,EAClE;QACE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM;QAC/D,GAAG,CAAC,KAAK,IAAI,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,IAAI;QAC9D,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;KACpC,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAA+B,EAC/B,QAAkB,EAClB,KAAK,GAAG,EAAE;IAEV,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,oBAAoB,CAAC;IACpC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,YAAY;QACzC,CAAC,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,GAAG,MAAM,oCAAoC,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9E,CAAC,CAAC,MAAM,QAAQ,CAAC,KAAK,CAClB,GAAG,MAAM,2DAA2D,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9F,OAAO,IAA+B,CAAC;AACzC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heychunky/core",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "The engine the Chunky CLI, worker and apps run on.",
   "license": "MIT",
   "type": "module",