@openagt/skill-scheduler 0.0.0-stage → 0.1.10

package/dist/state.d.ts

@@ -0,0 +1,194 @@
+import { type GitRunner } from '@openagt/agent-data';
+import { type Publish } from '@openagt/agent-runner';
+import { type AgentName } from './names.js';
+import { type ScheduledCommand } from './schedule.js';
+import type { PacePick } from './pace.js';
+/**
+ * The tool's state (#1774): one JSON file under `.scheduler/` at the repository root,
+ * written by the tool and read by anyone — a dashboard shows it as it is. Per user, never
+ * tracked: the directory is hidden through the repository's exclude file, the way `.branches/`
+ * is, so no tracked file changes and nothing rides a sweeping `git add -A`.
+ *
+ * What is here is what would otherwise live in a process's memory: whether the scheduler is on,
+ * whether it should outlive whatever started it, the model this user's scheduled runs start on
+ * and the spend cushion they take, which scheduled commands this machine switched on, the pace and the number of agents at once a person set for one here, how far this machine's runs of a scheduled command publish where a person picked it, the pid of the scheduler's own process when one runs, and the last tick with what it
+ * decided per command. A restart loses nothing.
+ */
+/** What the tick decided for one command. */
+export interface TickDecision {
+    command: string;
+    /** One line, for a person: `started`, `not due`, `cap reached (…)`, `quota: …`, … */
+    outcome: string;
+    /** The run's id, when one was started or resumed. */
+    run?: string;
+}
+/** One command of the schedule as the tick read it, for a dashboard to list with its switch. */
+export interface ListedCommand {
+    command: string;
+    /** How often at most, as written (`1d`). */
+    every?: string;
+    /** The check, when the skill gives one. */
+    when?: string;
+    /** What the check waits for, in one plain line, when the skill gives one. */
+    waitsFor?: string;
+    /** How often the check runs between the minute's ticks, as written (`15s`), when the skill says. */
+    checkEvery?: string;
+    /** What the command's skill does, in the skill's own words, when it says. */
+    description?: string;
+    /** Whether the row resumes the runs its check names, each on its own coding agent and model, and starts none. */
+    resumes?: true;
+    /** How many runs of the command its skill lets be in flight at once, when it is more than one. */
+    agents?: number;
+    /** Whether the command is an automation a person keeps on this machine alone, not a skill of the project. */
+    onThisMachine?: true;
+    /** Whether the command is a person's own automation as the tool wrote it: `show`, `edit` and `remove` take it. */
+    editable?: true;
+    /** The coding agent the command is made for: the one its skill names, else Claude Code when it can run the command, else the one that can. */
+    agent: AgentName;
+    /** The model its skill names, when it names one. */
+    model?: string;
+    /** The coding agent that model is a model of: the one the skill names, Claude Code when it names none. Said with the model. */
+    modelAgent?: AgentName;
+    /** The coding agents that can run the command: those whose own skills folder holds its skill; every one for an automation kept on this machine. */
+    able: AgentName[];
+}
+/** One tick as the state remembers it. */
+export interface TickRecord {
+    /** ISO timestamp. */
+    at: string;
+    decisions: TickDecision[];
+    /** The schedule's commands, as this tick read them. */
+    schedule: ListedCommand[];
+    /** Why the tick decided nothing for the scheduled commands, when it could not: the scheduler is off, no skill schedules a command, the pull failed. */
+    note?: string;
+}
+export interface State {
+    /** Whether ticks start agents. Off is the default: nothing runs until a person says so. */
+    on: boolean;
+    /** Whether the scheduler's process outlives whatever started it. Read by `stop --unless-keep-alive` only, the line a dashboard runs when it closes. */
+    keepAlive: boolean;
+    /** The model a scheduled run on Claude Code starts on, where neither its command's skill nor a person names another. */
+    model: string;
+    /** How far past the spend boundary a run may still start, in percentage points. */
+    spendOffset: number;
+    /** The scheduled commands this machine switched on, each with when it was, ISO. Every command starts switched off: a skill that arrives in a project starts no agent by itself. */
+    switches?: Record<string, string>;
+    /** This machine's publish pick per command. */
+    publishes?: Record<string, PublishPick>;
+    /** This machine's pace per command, kept only where a person set one: a command without one runs at its skill's pace. */
+    paces?: Record<string, PacePick>;
+    /** This machine's number of runs of a command in flight at once, kept only where a person set one: a command without one has its skill's number. */
+    agents?: Record<string, number>;
+    /** The coding agent this machine's runs of a command are on, kept only where a person picked one: a command without one is on the agent its skill is made for. */
+    runsOn?: Record<string, AgentName>;
+    /** The model this machine's runs of a command start on, kept only where a person picked one, with the coding agent it was picked for: a model is one agent's, and the pick holds only while the command runs on that agent. */
+    models?: Record<string, ModelPick>;
+    /** The scheduler's own process, while `start` has one running. */
+    pid?: number;
+    /** When that process started, ISO. */
+    startedAt?: string;
+    lastTick?: TickRecord;
+}
+/** A person's pick of how far a scheduled command's runs publish on their machine: nothing, or one of the levels a run may be given. */
+export type PublishPick = 'nothing' | Publish;
+export declare const PUBLISH_PICKS: readonly PublishPick[];
+/** A person's pick of a model for one command: the model's id, and the coding agent it is a model of. */
+export interface ModelPick {
+    agent: AgentName;
+    model: string;
+}
+export declare const DEFAULT_STATE: State;
+export declare function stateDir(repo: string): string;
+export declare function statePath(repo: string): string;
+/** The state as written, defaults filled in; the default state when there is none or it does not parse. */
+export declare function readState(repo: string): Promise<State>;
+/**
+ * Write the state. The first write also hides the directory from git; that is best-effort, since
+ * a repository whose exclude file cannot be written still has a scheduler.
+ */
+export declare function writeState(repo: string, state: State, git?: GitRunner): Promise<void>;
+/**
+ * The state without the scheduler's process, when that process is `pid`; unchanged otherwise. A
+ * scheduler ending must not clear a pid another scheduler wrote meanwhile: a dashboard's close
+ * hook stops one and its open hook starts the next while the first still finishes its tick.
+ */
+export declare function withoutPid(state: State, pid: number): State;
+/**
+ * The state with nothing of one command left: its switch, its publish pick, its pace, its number
+ * of agents, its coding agent and its model. What a command saved anew under a name starts from: a switch left on for a
+ * command of that name that is gone would start the new one unasked.
+ */
+export declare function withoutCommand(state: State, command: string): State;
+/**
+ * The state with a command off the last tick's record: the schedule it read and what it decided.
+ * For a command removed since that tick, so whoever lists the record's commands, a dashboard,
+ * stops listing it at once and not a tick later. The state itself is answered when the record
+ * names no such command.
+ */
+export declare function withoutListed(state: State, command: string): State;
+/**
+ * The names whose picks on this machine go before a tick: an automation kept here that the last
+ * tick listed and whose file is gone now (removed or renamed), and a name a skill and an
+ * automation kept here both have. A switch left under such a name would otherwise start whatever
+ * takes the name next: a skill of the project, which starts no agent before a person switches it on.
+ * An automation whose file is still there keeps its picks, also while a slip in the file keeps it
+ * off the list.
+ */
+export declare function namesGivenUp(lastTick: TickRecord | undefined, schedule: {
+    commands: {
+        name: string;
+        text?: string;
+    }[];
+    unreadable?: {
+        skill: string;
+        own?: true;
+    }[];
+    clashes?: string[];
+}): string[];
+/** The state with nothing left under a name: the picks of the command of that name, and of every command that is that name and a word (`triage quick`). */
+export declare function withoutName(state: State, name: string): State;
+/** When a person switched a scheduled command on on this machine, ISO; nothing for a command that is off. The state is a file a person may edit: anything but a time is off. */
+export declare function switchedOnAt(state: State, command: string): string | undefined;
+/** Whether a scheduled command runs on this machine: only where a person switched it on. */
+export declare function isSwitchedOn(state: State, command: string): boolean;
+/** The state with one command switched on at a time, or off when no time is given: only a command switched on is kept, so switching it off leaves no trace. */
+export declare function withSwitch(state: State, command: string, at: string | undefined): State;
+/** How far a run of a scheduled command publishes on this machine: its publish pick here; absent for nothing. */
+export declare function publishInForce(state: State, command: string): Publish | undefined;
+/** The state with one command's publish pick set. */
+export declare function withPublish(state: State, command: string, pick: PublishPick): State;
+/** The state with one command's pace set, or taken back when there is none: the command then runs at its skill's pace again. */
+export declare function withPace(state: State, command: string, pick: PacePick | undefined): State;
+/**
+ * How many runs of a command may be in flight at once, as this machine counts: the number a
+ * person set here, else the skill's. The count it is held against is every machine's runs. The
+ * state is a file a person may edit: a value that is no such number is no number set.
+ */
+export declare function capInForce(state: State, command: {
+    name: string;
+    cap: number;
+}): number;
+/** The state with one command's number of agents at once set, or taken back when there is none: the command then has its skill's number again. */
+export declare function withAgents(state: State, command: string, count: number | undefined): State;
+/**
+ * The coding agent a run of a command is on, on this machine: the one a person picked here, else
+ * the one the command is made for ({@link homeAgent}). The state is a file a person may edit: a
+ * word that names no agent is no pick.
+ */
+export declare function agentInForce(state: State, command: Pick<ScheduledCommand, 'name' | 'agent' | 'dirs' | 'text'>): AgentName;
+/**
+ * The model a run of a command starts on, on this machine, given the agent it is on: the one a
+ * person picked here for that agent; else the one its skill names for that agent
+ * ({@link ScheduledCommand.model}); else, on Claude Code, the scheduler's own model. Nothing on
+ * any other agent: the run then starts on that agent's own default. A pick made for another agent
+ * is no pick: the agent a command runs on can change without a person's doing, when its skill
+ * comes to name one or reaches another agent's folder.
+ */
+export declare function modelInForce(state: State, command: Pick<ScheduledCommand, 'name' | 'agent' | 'model'>, agent: AgentName): string | undefined;
+/** The state with the coding agent of one command picked, or the pick taken back when there is none. The model picked for the command goes with it either way: a model is one agent's. */
+export declare function withAgent(state: State, command: string, agent: AgentName | undefined): State;
+/** The state with the model of one command picked, for the coding agent it is a model of, or the pick taken back when there is none. */
+export declare function withModel(state: State, command: string, pick: ModelPick | undefined): State;
+/** Read, change, write: one edit of the state. */
+export declare function updateState(repo: string, change: (state: State) => State, git?: GitRunner): Promise<State>;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"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"}

package/dist/state.js

@@ -0,0 +1,208 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { excludeFromGit, nodeGitRunner } from '@openagt/agent-data';
+import { PUBLISH_LEVELS } from '@openagt/agent-runner';
+import { DEFAULT_AGENT, DEFAULT_MODEL, DEFAULT_PUBLISH, DEFAULT_SPEND_OFFSET, STATE_DIR, STATE_FILE, isAgent, isAgents, isTime } from './names.js';
+import { homeAgent } from './schedule.js';
+export const PUBLISH_PICKS = ['nothing', ...PUBLISH_LEVELS];
+/** Where the state keeps what a person set for one command on this machine. */
+const PICKS = ['switches', 'publishes', 'paces', 'agents', 'runsOn', 'models'];
+export const DEFAULT_STATE = { on: false, keepAlive: false, model: DEFAULT_MODEL, spendOffset: DEFAULT_SPEND_OFFSET };
+export function stateDir(repo) {
+    return join(repo, STATE_DIR);
+}
+export function statePath(repo) {
+    return join(stateDir(repo), STATE_FILE);
+}
+/** The state as written, defaults filled in; the default state when there is none or it does not parse. */
+export async function readState(repo) {
+    const raw = await readFile(statePath(repo), 'utf8').catch(() => undefined);
+    if (raw === undefined)
+        return { ...DEFAULT_STATE };
+    try {
+        const parsed = JSON.parse(raw);
+        return { ...DEFAULT_STATE, ...(parsed && typeof parsed === 'object' ? parsed : {}) };
+    }
+    catch {
+        return { ...DEFAULT_STATE };
+    }
+}
+/**
+ * Write the state. The first write also hides the directory from git; that is best-effort, since
+ * a repository whose exclude file cannot be written still has a scheduler.
+ */
+export async function writeState(repo, state, git = nodeGitRunner()) {
+    await mkdir(stateDir(repo), { recursive: true });
+    await excludeFromGit(repo, `/${STATE_DIR}`, undefined, git).catch(() => { });
+    await writeFile(statePath(repo), JSON.stringify(state, null, 2) + '\n');
+}
+/**
+ * The state without the scheduler's process, when that process is `pid`; unchanged otherwise. A
+ * scheduler ending must not clear a pid another scheduler wrote meanwhile: a dashboard's close
+ * hook stops one and its open hook starts the next while the first still finishes its tick.
+ */
+export function withoutPid(state, pid) {
+    if (state.pid !== pid)
+        return state;
+    const { pid: _pid, startedAt: _startedAt, ...rest } = state;
+    return rest;
+}
+/**
+ * The state with nothing of one command left: its switch, its publish pick, its pace, its number
+ * of agents, its coding agent and its model. What a command saved anew under a name starts from: a switch left on for a
+ * command of that name that is gone would start the new one unasked.
+ */
+export function withoutCommand(state, command) {
+    let rest = state;
+    for (const key of PICKS) {
+        const picks = state[key];
+        if (!picks || !Object.hasOwn(picks, command))
+            continue;
+        const { [command]: _gone, ...others } = picks;
+        // The state itself is answered when it holds nothing of the command, so a caller can tell there is nothing to write.
+        rest = { ...rest };
+        if (Object.keys(others).length)
+            Object.assign(rest, { [key]: others });
+        else
+            delete rest[key];
+    }
+    return rest;
+}
+/**
+ * The state with a command off the last tick's record: the schedule it read and what it decided.
+ * For a command removed since that tick, so whoever lists the record's commands, a dashboard,
+ * stops listing it at once and not a tick later. The state itself is answered when the record
+ * names no such command.
+ */
+export function withoutListed(state, command) {
+    const tick = state.lastTick;
+    if (!tick || !(tick.schedule.some(c => c.command === command) || tick.decisions.some(d => d.command === command)))
+        return state;
+    return { ...state, lastTick: { ...tick, schedule: tick.schedule.filter(c => c.command !== command), decisions: tick.decisions.filter(d => d.command !== command) } };
+}
+/**
+ * The names whose picks on this machine go before a tick: an automation kept here that the last
+ * tick listed and whose file is gone now (removed or renamed), and a name a skill and an
+ * automation kept here both have. A switch left under such a name would otherwise start whatever
+ * takes the name next: a skill of the project, which starts no agent before a person switches it on.
+ * An automation whose file is still there keeps its picks, also while a slip in the file keeps it
+ * off the list.
+ */
+export function namesGivenUp(lastTick, schedule) {
+    const kept = new Set([...schedule.commands.filter(c => c.text !== undefined).map(c => c.name), ...(schedule.unreadable ?? []).filter(u => u.own).map(u => u.skill)]);
+    const gone = (lastTick?.schedule ?? []).filter(c => c.onThisMachine === true && !kept.has(c.command)).map(c => c.command);
+    return [...new Set([...gone, ...(schedule.clashes ?? [])])];
+}
+/** The state with nothing left under a name: the picks of the command of that name, and of every command that is that name and a word (`triage quick`). */
+export function withoutName(state, name) {
+    let rest = state;
+    for (const key of PICKS) {
+        for (const command of Object.keys(state[key] ?? {})) {
+            if (command.split(' ')[0] === name)
+                rest = withoutCommand(rest, command);
+        }
+    }
+    return rest;
+}
+/** When a person switched a scheduled command on on this machine, ISO; nothing for a command that is off. The state is a file a person may edit: anything but a time is off. */
+export function switchedOnAt(state, command) {
+    const at = state.switches?.[command];
+    return isTime(at) ? at : undefined;
+}
+/** Whether a scheduled command runs on this machine: only where a person switched it on. */
+export function isSwitchedOn(state, command) {
+    return switchedOnAt(state, command) !== undefined;
+}
+/** The state with one command switched on at a time, or off when no time is given: only a command switched on is kept, so switching it off leaves no trace. */
+export function withSwitch(state, command, at) {
+    const { [command]: _previous, ...others } = state.switches ?? {};
+    const switches = at !== undefined ? { ...others, [command]: at } : others;
+    const { switches: _switches, ...rest } = state;
+    return Object.keys(switches).length ? { ...rest, switches } : rest;
+}
+/**
+ * This machine's publish pick for a scheduled command: what a person picked here, else commit. The
+ * state is a file a person may edit: a word that is no pick is no pick.
+ */
+function publishPick(state, command) {
+    const pick = state.publishes?.[command];
+    return pick !== undefined && PUBLISH_PICKS.includes(pick) ? pick : DEFAULT_PUBLISH;
+}
+/** How far a run of a scheduled command publishes on this machine: its publish pick here; absent for nothing. */
+export function publishInForce(state, command) {
+    const pick = publishPick(state, command);
+    return pick === 'nothing' ? undefined : pick;
+}
+/** The state with one command's publish pick set. */
+export function withPublish(state, command, pick) {
+    return { ...state, publishes: { ...state.publishes, [command]: pick } };
+}
+/** The state with one command's pace set, or taken back when there is none: the command then runs at its skill's pace again. */
+export function withPace(state, command, pick) {
+    const { [command]: _previous, ...others } = state.paces ?? {};
+    const paces = pick === undefined ? others : { ...others, [command]: pick };
+    const { paces: _paces, ...rest } = state;
+    return Object.keys(paces).length ? { ...rest, paces } : rest;
+}
+/**
+ * How many runs of a command may be in flight at once, as this machine counts: the number a
+ * person set here, else the skill's. The count it is held against is every machine's runs. The
+ * state is a file a person may edit: a value that is no such number is no number set.
+ */
+export function capInForce(state, command) {
+    const own = state.agents?.[command.name];
+    return isAgents(own) ? own : command.cap;
+}
+/** The state with one command's number of agents at once set, or taken back when there is none: the command then has its skill's number again. */
+export function withAgents(state, command, count) {
+    const { [command]: _previous, ...others } = state.agents ?? {};
+    const agents = count === undefined ? others : { ...others, [command]: count };
+    const { agents: _agents, ...rest } = state;
+    return Object.keys(agents).length ? { ...rest, agents } : rest;
+}
+/**
+ * The coding agent a run of a command is on, on this machine: the one a person picked here, else
+ * the one the command is made for ({@link homeAgent}). The state is a file a person may edit: a
+ * word that names no agent is no pick.
+ */
+export function agentInForce(state, command) {
+    const pick = state.runsOn?.[command.name];
+    return isAgent(pick) ? pick : homeAgent(command);
+}
+/**
+ * The model a run of a command starts on, on this machine, given the agent it is on: the one a
+ * person picked here for that agent; else the one its skill names for that agent
+ * ({@link ScheduledCommand.model}); else, on Claude Code, the scheduler's own model. Nothing on
+ * any other agent: the run then starts on that agent's own default. A pick made for another agent
+ * is no pick: the agent a command runs on can change without a person's doing, when its skill
+ * comes to name one or reaches another agent's folder.
+ */
+export function modelInForce(state, command, agent) {
+    const pick = state.models?.[command.name];
+    if (pick && typeof pick === 'object' && pick.agent === agent && typeof pick.model === 'string' && pick.model.trim())
+        return pick.model;
+    if (command.model !== undefined && agent === (command.agent ?? DEFAULT_AGENT))
+        return command.model;
+    return agent === DEFAULT_AGENT ? state.model : undefined;
+}
+/** The state with the coding agent of one command picked, or the pick taken back when there is none. The model picked for the command goes with it either way: a model is one agent's. */
+export function withAgent(state, command, agent) {
+    const { [command]: _previous, ...others } = state.runsOn ?? {};
+    const runsOn = agent === undefined ? others : { ...others, [command]: agent };
+    const { runsOn: _runsOn, ...rest } = withModel(state, command, undefined);
+    return Object.keys(runsOn).length ? { ...rest, runsOn } : rest;
+}
+/** The state with the model of one command picked, for the coding agent it is a model of, or the pick taken back when there is none. */
+export function withModel(state, command, pick) {
+    const { [command]: _previous, ...others } = state.models ?? {};
+    const models = pick === undefined ? others : { ...others, [command]: pick };
+    const { models: _models, ...rest } = state;
+    return Object.keys(models).length ? { ...rest, models } : rest;
+}
+/** Read, change, write: one edit of the state. */
+export async function updateState(repo, change, git) {
+    const next = change(await readState(repo));
+    await writeState(repo, next, git);
+    return next;
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAA;AACnF,OAAO,EAAE,cAAc,EAAgB,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAkB,MAAM,YAAY,CAAA;AAClK,OAAO,EAAE,SAAS,EAAyB,MAAM,eAAe,CAAA;AAiGhE,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,SAAS,EAAE,GAAG,cAAc,CAAC,CAAA;AAQnF,+EAA+E;AAC/E,MAAM,KAAK,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAA;AAEvF,MAAM,CAAC,MAAM,aAAa,GAAU,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAE5H,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAA;AACzC,CAAC;AAED,2GAA2G;AAC3G,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC1E,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAA;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAA;QAChD,OAAO,EAAE,GAAG,aAAa,EAAE,GAAG,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,aAAa,EAAE,CAAA;IAC7B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,KAAY,EAAE,GAAG,GAAc,aAAa,EAAE;IAC3F,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAChD,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,SAAS,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC3E,MAAM,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,GAAW;IAClD,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG;QAAE,OAAO,KAAK,CAAA;IACnC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IAC3D,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,OAAe;IAC1D,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;QACxB,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC;YAAE,SAAQ;QACtD,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,GAAG,KAAgC,CAAA;QACxE,qHAAqH;QACrH,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAA;QAClB,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;;YACjE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,OAAe;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAA;IAC3B,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IAC/H,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,EAAE,EAAE,CAAA;AACtK,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgC,EAAE,QAA2H;IACxL,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACpK,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACzH,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AAC7D,CAAC;AAED,2JAA2J;AAC3J,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,IAAY;IACpD,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACpD,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;gBAAE,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,gLAAgL;AAChL,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,OAAe;IACxD,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAA;IACpC,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACpC,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,OAAe;IACxD,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,SAAS,CAAA;AACnD,CAAC;AAED,+JAA+J;AAC/J,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,OAAe,EAAE,EAAsB;IAC9E,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAA;IAChE,MAAM,QAAQ,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;IACzE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IAC9C,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACpE,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,KAAY,EAAE,OAAe;IAChD,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAA;IACvC,OAAO,IAAI,KAAK,SAAS,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAA;AACpF,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,OAAe;IAC1D,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACxC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,OAAe,EAAE,IAAiB;IAC1E,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,CAAA;AACzE,CAAC;AAED,gIAAgI;AAChI,MAAM,UAAU,QAAQ,CAAC,KAAY,EAAE,OAAe,EAAE,IAA0B;IAChF,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAA;IAC7D,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAA;IAC1E,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,OAAsC;IAC7E,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA;AAC1C,CAAC;AAED,kJAAkJ;AAClJ,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,OAAe,EAAE,KAAyB;IACjF,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAA;IAC9D,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAA;IAC7E,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,OAAmE;IAC5G,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;AAClD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,OAA2D,EAAE,KAAgB;IACtH,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC,KAAK,CAAA;IACtI,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;QAAE,OAAO,OAAO,CAAC,KAAK,CAAA;IACnG,OAAO,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1D,CAAC;AAED,0LAA0L;AAC1L,MAAM,UAAU,SAAS,CAAC,KAAY,EAAE,OAAe,EAAE,KAA4B;IACnF,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAA;IAC9D,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAA;IAC7E,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;IACzE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAChE,CAAC;AAED,wIAAwI;AACxI,MAAM,UAAU,SAAS,CAAC,KAAY,EAAE,OAAe,EAAE,IAA2B;IAClF,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAA;IAC9D,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAA;IAC3E,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAChE,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,MAA+B,EAAE,GAAe;IAC9F,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;IAC1C,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACjC,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/test-repo.d.ts

@@ -0,0 +1,20 @@
+import { type AnyDiaryLine } from '@openagt/skill-logs';
+/**
+ * A project for the tests: one commit on `main`, a bare `origin`, the `agent-data` branch born
+ * on origin, a tracked `.claude/skills/work-queue`. Real git, because the records, the checkouts
+ * and the reclaim rule are git.
+ */
+export declare const git: import("@openagt/agent-data").GitRunner;
+export declare const RETRIED_RM: {
+    readonly recursive: true;
+    readonly force: true;
+    readonly maxRetries: 10;
+};
+export declare function testRepo(): Promise<string>;
+/** A skill of the project, in the folder Claude Code reads it from, with the lines given as the rest of its front matter. */
+export declare function writeSkill(repo: string, name: string, frontMatter: string): Promise<void>;
+/** The repository and its origin go together. */
+export declare function removeRepo(repo: string): Promise<void>;
+/** A run's diary with each line's time checked and taken off: what is left is what happened. */
+export declare function readUntimedDiary(repo: string, id: string): Promise<AnyDiaryLine[]>;
+//# sourceMappingURL=test-repo.d.ts.map

package/dist/test-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-repo.d.ts","sourceRoot":"","sources":["../src/test-repo.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElE;;;;GAIG;AAEH,eAAO,MAAM,GAAG,yCAAkB,CAAA;AAElC,eAAO,MAAM,UAAU;aAAK,SAAS;aAAQ,KAAK;aAAQ,UAAU,EAAE,EAAE;CAAW,CAAA;AAEnF,wBAAsB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAwBhD;AAED,6HAA6H;AAC7H,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/F;AAED,iDAAiD;AACjD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,gGAAgG;AAChG,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAMxF"}

package/dist/test-repo.js

@@ -0,0 +1,56 @@
+import { mkdir, mkdtemp, realpath, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { strict as assert } from 'node:assert';
+import { DATA_BRANCH, nodeGitRunner, writeSharing } from '@openagt/agent-data';
+import { readDiary } from '@openagt/skill-logs';
+/**
+ * A project for the tests: one commit on `main`, a bare `origin`, the `agent-data` branch born
+ * on origin, a tracked `.claude/skills/work-queue`. Real git, because the records, the checkouts
+ * and the reclaim rule are git.
+ */
+export const git = nodeGitRunner();
+export const RETRIED_RM = { recursive: true, force: true, maxRetries: 10 };
+export async function testRepo() {
+    const base = await realpath(await mkdtemp(join(tmpdir(), 'scheduler-')));
+    const repo = join(base, 'repo');
+    const origin = join(base, 'origin.git');
+    await mkdir(repo);
+    await git(['init', '-q', '-b', 'main'], repo);
+    await git(['config', 'user.email', 'tester@example.com'], repo);
+    await git(['config', 'user.name', 'tester'], repo);
+    await writeFile(join(repo, 'README.md'), '# t\n');
+    await mkdir(join(repo, '.claude', 'skills', 'work-queue'), { recursive: true });
+    await writeFile(join(repo, '.claude', 'skills', 'work-queue', 'SKILL.md'), '---\nname: work-queue\n---\nWork one queued task.\n');
+    await git(['add', '-A'], repo);
+    await git(['commit', '-q', '-m', 'init'], repo);
+    await git(['init', '-q', '--bare', origin], base);
+    await git(['remote', 'add', 'origin', origin], repo);
+    await git(['push', '-q', '-u', 'origin', 'main'], repo);
+    // The data branch, parentless, as the skills make it.
+    const tree = (await git(['hash-object', '-t', 'tree', '/dev/null'], repo)).trim();
+    const commit = (await git(['commit-tree', tree, '-m', `create the ${DATA_BRANCH} branch`], repo)).trim();
+    await git(['push', '-q', 'origin', `${commit}:refs/heads/${DATA_BRANCH}`], repo);
+    await git(['fetch', '-q', 'origin'], repo);
+    // A project that shares its records with origin: the person's yes, given once per clone.
+    await writeSharing(repo, true);
+    return repo;
+}
+/** A skill of the project, in the folder Claude Code reads it from, with the lines given as the rest of its front matter. */
+export async function writeSkill(repo, name, frontMatter) {
+    await mkdir(join(repo, '.claude', 'skills', name), { recursive: true });
+    await writeFile(join(repo, '.claude', 'skills', name, 'SKILL.md'), `---\nname: ${name}\n${frontMatter}---\nDo the job.\n`);
+}
+/** The repository and its origin go together. */
+export async function removeRepo(repo) {
+    await rm(dirname(repo), RETRIED_RM);
+}
+/** A run's diary with each line's time checked and taken off: what is left is what happened. */
+export async function readUntimedDiary(repo, id) {
+    const lines = (await readDiary(repo, id)) ?? assert.fail(`no diary for ${id}`);
+    return lines.map(({ at, ...line }) => {
+        assert.equal(typeof at === 'string' && new Date(at).toISOString(), at, `a time on ${line.kind}`);
+        return line;
+    });
+}
+//# sourceMappingURL=test-repo.js.map

package/dist/test-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-repo.js","sourceRoot":"","sources":["../src/test-repo.ts"],"names":[],"mappings":"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"}