@ctrl-spc/cs 0.6.0 → 0.7.1

package/dist/workflows.js

@@ -0,0 +1,68 @@
+async function read(query, subject) {
+    const { data, error } = await query;
+    if (error)
+        throw new Error(`could not read ${subject}: ${error.message}`);
+    return data ?? [];
+}
+/**
+ * A workflow, its stages in order, and the exits off them.
+ *
+ * SORTED HERE RATHER THAN TRUSTED, which is the web reader's own rule: order is
+ * the whole point of a workflow, positions are deliberately not unique (a
+ * reorder rewrites the set), and a tie has to break the same way twice.
+ *
+ * FOUR READS RATHER THAN ONE EMBED. `cliv2_workflow_stages_in_workflow` carries
+ * two foreign keys into `cliv2_workflow_stages` (`stage_id` and
+ * `loop_to_stage_id`), so a nested embed of the stage document would need
+ * disambiguating by constraint name — a coupling to a constraint's spelling for
+ * the sake of saving a round trip on a tool call an agent makes once.
+ */
+export async function readWorkflow(client, workflowId) {
+    const found = await read(client.from('cliv2_workflows').select('id, name, description, ending').eq('id', workflowId), `workflow ${workflowId}`);
+    if (found.length === 0) {
+        throw new Error(`could not read workflow ${workflowId}: there is no such row, or it is not yours`);
+    }
+    const row = found[0];
+    const [links, exits] = await Promise.all([
+        read(client.from('cliv2_workflow_stages_in_workflow').select('stage_id, position')
+            .eq('workflow_id', workflowId), `the stages of workflow ${workflowId}`),
+        read(client.from('cliv2_workflow_stage_exits').select('stage_id, to_stage_id, condition, position')
+            .eq('workflow_id', workflowId), `the exits of workflow ${workflowId}`),
+    ]);
+    const ordered = [...links].sort((a, b) => a.position - b.position || a.stage_id.localeCompare(b.stage_id));
+    const stageRows = ordered.length === 0 ? [] : await read(client.from('cliv2_workflow_stages').select('id, name, description, body')
+        .in('id', ordered.map((link) => link.stage_id)), `the stage documents of workflow ${workflowId}`);
+    const byId = new Map(stageRows.map((stage) => [stage.id, stage]));
+    return {
+        id: row.id,
+        name: row.name,
+        description: row.description ?? '',
+        /* Defaulted here as well as in the column, for the web reader's reason: a
+           workflow written before the ending existed reads back as 'end'. */
+        ending: row.ending ?? 'end',
+        stages: ordered.map((link) => {
+            const stage = byId.get(link.stage_id);
+            /* A LISTED STAGE THAT DID NOT COME BACK IS AN ERROR, NEVER A GAP. The
+               join cascades on delete and archiving is not deletion, so this cannot
+               happen through the product — and a stage silently missing from the
+               middle of a recipe would be a different process presented as this one. */
+            if (!stage) {
+                throw new Error(`could not read the stage documents of workflow ${workflowId}: stage ${link.stage_id} `
+                    + 'is in the workflow but its document did not come back');
+            }
+            return {
+                id: stage.id,
+                name: stage.name,
+                description: stage.description ?? '',
+                body: stage.body ?? '',
+            };
+        }),
+        exits: [...exits]
+            .sort((a, b) => a.position - b.position || a.to_stage_id.localeCompare(b.to_stage_id))
+            .map((exit) => ({
+            stageId: exit.stage_id,
+            toStageId: exit.to_stage_id,
+            condition: exit.condition,
+        })),
+    };
+}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@ctrl-spc/cs",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "CTRL+SPC — minimal, reliable per-machine agent presence. Sign-in, auto-start, agent detection, heartbeat presence, and ping acknowledgement.",
   "engines": {
     "node": ">=22"
   },
   "type": "module",
   "bin": {
-    "cs": "dist/index.js"
+    "cs": "dist/index.js",
+    "cs3": "dist/panel3/cli.js"
   },
   "files": [
     "dist"