@voidlabs.gg/voidshift 0.4.3 → 0.4.5

package/README.md

@@ -50,15 +50,24 @@ Five agents, installed into Claude Code (and Codex if you use it):
 | QA | CI, then code review, then a usability check in a headless browser |
 
 Use them yourself (`/vs-plan ENG-123` in Claude Code), or let a **workflow**
-run them. A workflow starts when one of your Linear cards gets a label, runs
-agents in order in a project (a repo on your Mac), and sends work back to the
-step that made it when a check fails:
+run them. A workflow starts when one of your Linear or VoidTrack cards gets a
+label, or on a schedule, runs agents in order in a project (a repo on your
+machine), and sends work back to the step that made it when a check fails:
 
 ```
 when ENG + vs-plan:  Dev → QA  in tether-relay
 ```
 
-The runner checks Linear every minute, works in its own copy of the repo so
+Triggers, as `--trigger` takes them:
+
+```
+ENG:vs-plan                           # a Linear card in ENG assigned to you gets vs-plan
+voidtrack:ORG:vs-start                # the same for VoidTrack (vsf agents key --voidtrack)
+"cron:0 5 * * 1:Update dependencies"  # every Monday 05:00, no card, on its own branch
+```
+
+A schedule fires once when due (a missed one is made up within a day) and
+`vsf agents run --workflow NAME` fires it now. The runner checks every minute, works in its own copy of the repo so
 your checkout is never touched, and keeps two labels on the card as it goes: the
 stage (`vs-planning`, `vs-plan-review`, `vs-dev`, `vs-qa`, then `vs-qa-verified`
 or `vs-parked`) and the round (`vs-v1`, `vs-v2`). On Linear it posts the plan and
@@ -77,8 +86,33 @@ vsf agents workflow add|edit|show|rename|move|rm
 vsf agents projects | project add|edit|show|rename|rm
 vsf agents homes | link DIR        # where the agents are installed
 vsf agents clean                   # old worktrees and run logs
+vsf agents validate [DIR]          # check the config and agent folders
+```
+
+A workflow can also be a folder you write by hand,
+`~/.config/voidshift/agents/defs/NAME/agent.json`, with its prompt files next to
+it. Steps are the built-in ids above or your own:
+
+```json
+{
+  "triggers": [{ "source": "cron", "schedule": "0 7 * * 1-5", "task": "Morning brief" }],
+  "steps": [{ "id": "brief", "prompt": "brief.md", "output": "none", "model": "haiku", "timeoutMinutes": 10 }],
+  "maxRounds": 1,
+  "project": "tether-relay",
+  "writeBack": { "labels": true, "state": null, "comment": true }
+}
 ```
 
+A step's `output` is `plan`, `verdict`, `commits`, `publish` or `none`; a failed
+`verdict` sends the work back to the nearest `plan` or `commits` step. `engine`,
+`model` and `timeoutMinutes` fall back to the config, and `write` to true only
+for `commits`. A `publish` step takes no prompt; the others take one `prompt`
+file or `skill`, which must ask for a `RESULT:` line (`plan`, `commits`) or a
+`VERDICT:` line (`verdict`). `writeBack` applies to card runs: `state` moves a
+verified card there (`null` never moves it), `labels: false` only takes the
+trigger label off, and `comment: false` skips the closing comment. Edit the file,
+then `vsf agents validate`.
+
 ### memory
 
 A folder of markdown notes, one topic per note, with an `INDEX.md` holding one
@@ -99,6 +133,20 @@ vsf memory on | off        # turn recall on or off
 Setup creates a vault at `~/memory` or uses one you already have. Codex asks you
 to trust the recall hook once: run `/hooks` in Codex.
 
+### Your profile
+
+Every agent run carries your profile, on any machine, without touching your
+Claude or Codex folder. `vsf agents profile init` creates
+`~/.config/voidshift/agents/profile/`:
+
+- `RULES.md` is added to every step's prompt (style, commit rules, tone).
+- `claude-settings.json` is passed to Claude runs with `--settings`, so hooks
+  come along. `{{profile}}` stands for the folder, so hook scripts can live in it.
+
+Setup also asks what the runner does to agent commits before it pushes them:
+remove AI co-author lines, and add `Signed-off-by` for repos that ask for a
+DCO. Only the new commits of that step are rewritten, never pushed ones.
+
 ## What to know
 
 - **Your own logins.** Agents run the official `claude` and `codex` CLIs you

package/dist/tui/data.d.ts

@@ -63,8 +63,10 @@ export interface WorkflowItem {
     name: string;
     triggers: {
         source: string;
-        team: string;
-        label: string;
+        team?: string;
+        label?: string;
+        schedule?: string;
+        task?: string;
     }[];
     steps: string[];
     maxRounds: number;

package/dist/tui/screens/workflow-form.js

@@ -8,7 +8,7 @@ import { useBackGuard, useEquivalent, useHints, useKeys, useScreen } from "../co
 import { theme } from "../theme.js";
 import { Panel, Select, TextInput } from "../widgets.js";
 import { tilde } from "../format.js";
-import { matchWarnings, stepLabel, stepName, triggerText, warningText, sameTriggerLike } from "./workflows.js";
+import { matchWarnings, stepLabel, stepName, triggerSpec, triggerText, warningText, sameTriggerLike } from "./workflows.js";
 const h = React.createElement;
 export function formReducer(s, a) {
     switch (a.type) {
@@ -38,7 +38,7 @@ export function formReducer(s, a) {
 }
 export function initialForm(w, name, projects) {
     if (w)
-        return { name, triggers: w.triggers.map((t) => ({ team: t.team, label: t.label })), steps: [...w.steps], project: w.project, rounds: w.maxRounds };
+        return { name, triggers: w.triggers.map((t) => ({ ...t })), steps: [...w.steps], project: w.project, rounds: w.maxRounds };
     return { name: '', triggers: [], steps: [], project: projects.length === 1 ? projects[0] : '', rounds: 3 };
 }
 const FALLBACK_PRODUCERS = ['vs-plan', 'vs-dev'];
@@ -95,7 +95,7 @@ export function saveArgs(s, isNew, catalog) {
         'workflow',
         isNew ? 'add' : 'edit',
         s.name.trim(),
-        ...s.triggers.flatMap((t) => ['--trigger', `${t.team}:${t.label}`]),
+        ...s.triggers.flatMap((t) => ['--trigger', triggerSpec(t)]),
         '--steps',
         s.steps.map((id) => stepName(catalog, id)).join(','),
         '--project',
@@ -105,17 +105,19 @@ export function saveArgs(s, isNew, catalog) {
     ];
 }
 export const renameArgs = (from, to) => ['agents', 'workflow', 'rename', from, to];
-// A trigger from the two text fields, or a complaint.
+// A trigger from the two text fields, or a complaint. A team written as
+// voidtrack:ORG is a VoidTrack team; schedules are added with the CLI.
 export function makeTrigger(team, label) {
-    const t = team.trim().toUpperCase();
+    const voidtrack = /^voidtrack:/i.test(team.trim());
+    const t = team.trim().replace(/^voidtrack:/i, '').toUpperCase();
     const l = label.trim();
     if (!t)
-        return { error: 'Give the Linear team, like ENG.' };
+        return { error: 'Give the team, like ENG, or voidtrack:ORG for VoidTrack.' };
     if (t.includes(':') || /\s/.test(t))
-        return { error: 'The team is a short key like ENG.' };
+        return { error: 'The team is a short key like ENG, or voidtrack:ORG.' };
     if (!l)
         return { error: 'Give the label, like vs-plan.' };
-    return { trigger: { team: t, label: l } };
+    return { trigger: { source: voidtrack ? 'voidtrack' : 'linear', team: t, label: l } };
 }
 // Warnings for triggers this workflow shares with another. In place when
 // editing, last in order when new.
@@ -348,7 +350,7 @@ function WorkflowForm(props) {
     // Triggers
     h(Box, null, h(Label, { text: 'Starts when', focused: where === 'triggers' }), h(Box, { flexDirection: 'column', flexGrow: 1 }, form.triggers.length === 0 ? h(Text, { color: theme.dim }, ' no trigger yet') : null, ...form.triggers.map((t, i) => {
         const on = where === 'triggers' && i === tCursor && adding === null;
-        return h(Text, { key: `${t.team}:${t.label}`, backgroundColor: on ? theme.selected : undefined, bold: on, color: on ? theme.bold : undefined }, ` ${triggerText(t)} `);
+        return h(Text, { key: triggerSpec(t), backgroundColor: on ? theme.selected : undefined, bold: on, color: on ? theme.bold : undefined }, ` ${triggerText(t)} `);
     }), adding !== null
         ? h(Box, { flexDirection: 'column' }, h(Box, null, h(Text, { color: theme.dim }, ' team '), h(TextInput, { value: newTeam, onChange: setNewTeam, focus: adding === 'team', placeholder: 'ENG', onSubmit: () => setAdding('label') }), h(Text, { color: theme.dim }, '  label '), h(TextInput, { value: newLabel, onChange: setNewLabel, focus: adding === 'label', placeholder: 'vs-plan', onSubmit: commitTrigger })), addError ? h(Text, { color: theme.red }, `  ${addError}`) : null)
         : null), h(Box, { flexShrink: 0, marginLeft: 2 }, h(Text, { color: theme.dim }, where === 'triggers' ? 'a add trigger · x remove' : ''))), h(Text, null, ' '), 

package/dist/tui/screens/workflows.d.ts

@@ -4,10 +4,14 @@ import type { Screen } from '../screens.ts';
 export declare function stepLabel(catalog: StepsCatalog | null, id: string): string;
 export declare function stepName(catalog: StepsCatalog | null, id: string): string;
 export interface TriggerLike {
-    team: string;
-    label: string;
+    source?: string;
+    team?: string;
+    label?: string;
+    schedule?: string;
+    task?: string;
 }
 export declare const triggerText: (t: TriggerLike) => string;
+export declare const triggerSpec: (t: TriggerLike) => string;
 export declare const triggersText: (triggers: TriggerLike[]) => string;
 export declare const sameTriggerLike: (a: TriggerLike, b: TriggerLike) => boolean;
 export declare const stepsText: (catalog: StepsCatalog | null, steps: string[]) => string;

package/dist/tui/screens/workflows.js

@@ -28,9 +28,11 @@ export function stepLabel(catalog, id) {
 export function stepName(catalog, id) {
     return catalog?.steps.find((s) => s.id === id)?.name ?? id.replace(/^vs-/, '');
 }
-export const triggerText = (t) => `${t.team} + ${t.label}`;
+export const triggerText = (t) => t.source === 'cron' ? `cron ${t.schedule}` : `${t.source === 'voidtrack' ? 'VoidTrack ' : ''}${t.team} + ${t.label}`;
+// The form `--trigger` takes.
+export const triggerSpec = (t) => t.source === 'cron' ? `cron:${t.schedule}:${t.task}` : t.source === 'voidtrack' ? `voidtrack:${t.team}:${t.label}` : `${t.team}:${t.label}`;
 export const triggersText = (triggers) => triggers.map(triggerText).join(', ');
-export const sameTriggerLike = (a, b) => a.team === b.team && a.label === b.label;
+export const sameTriggerLike = (a, b) => triggerSpec(a) === triggerSpec(b);
 export const stepsText = (catalog, steps) => steps.map((s) => stepLabel(catalog, s)).join(' → ');
 // Two workflows that start on the same TEAM:LABEL: only the first in order
 // starts the card. One entry per (loser, winner) pair.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidlabs.gg/voidshift",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "One CLI for the Void dev tools: keep your Mac awake, run agents in the background, shared skills and memory for Claude Code and Codex.",
   "license": "Apache-2.0",
   "repository": {