@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/conversations.d.ts

@@ -0,0 +1,93 @@
+import { type StoreFs } from './store/index.js';
+/**
+ * The committed conversations (#908): the human turns and the agent's replies of a run, kept in
+ * the Git repo so a clone carries the chat and not just the fact a run happened (#857).
+ *
+ * Deliberately not the verbose transcript — #857 leaves the tool-call-level log to the model
+ * provider, which is also the standing policy in run-store.ts. What lands here is what a person
+ * would reread: what was asked, and what came back.
+ *
+ * One file per run rather than one shared file, because run worktrees are live concurrently and
+ * each auto-commits its own pending work on teardown; a shared file would be a merge conflict
+ * every time two runs chatted at once. The run id is the join key back to the `- run:` field
+ * LOGS.md records (#898), so the committed session list and the committed chat line up.
+ *
+ * Pure core over the same {@link StoreFs} seam as logs.ts.
+ */
+/** The directory, under `.the-framework/`, that holds one markdown file per conversation. */
+export declare const CONVERSATIONS_DIR = "conversations";
+/**
+ * The `.the-framework/.gitignore` that keeps run state transient while committing the DB. The
+ * conversations rules need both entries: the `*` rule makes git skip the directory without ever
+ * descending into it, so un-ignoring the files alone would never be reached.
+ */
+export declare const CONVERSATIONS_GITIGNORE = "!conversations/\n!conversations/**\n";
+/** Who said it. The transport is {@link ConversationMessage.via}, not this. */
+export type ConversationRole = 'user' | 'agent';
+/** One turn in a conversation. */
+export interface ConversationMessage {
+    /** ISO timestamp. */
+    at: string;
+    role: ConversationRole;
+    /**
+     * The surface the turn came through — `dashboard`, `discord`, … Recorded so a conversation
+     * read back shows where it happened, while this module stays free of any transport.
+     */
+    via: string;
+    /** The message. Multi-line and kept that way; only line-leading markers are escaped. */
+    text: string;
+}
+/**
+ * Whether a transport name is safe to record. Exported because #917 lets a surface name itself
+ * over the control channel, so the name now arrives from outside this module: a `via` carrying
+ * the heading separator, a newline or a `#` would forge structure in a file whose entries are
+ * line-parsed, exactly the way #897 forged a LOGS.md title. Checked at the boundary rather than
+ * trusted, and the same predicate {@link parseConversation} reads back with.
+ */
+export declare function isSafeVia(via: unknown): via is string;
+/**
+ * Escape a message body so it cannot forge structure (#897's threat model, applied to a
+ * transcript). LOGS.md collapses free text to one line, which is right for a line-parsed record
+ * and wrong here: a multi-paragraph reply has to stay readable in a `git diff`. So the text stays
+ * as written and only a line's leading `#` or `\` is escaped, which is enough — an entry is only
+ * ever started by a line beginning `## `. Reversed by {@link unescapeBody}.
+ */
+export declare function escapeBody(text: string): string;
+/** Reverse {@link escapeBody}. */
+export declare function unescapeBody(text: string): string;
+/** The directory holding every conversation under `cwd`. */
+export declare function conversationsDir(cwd: string): string;
+/**
+ * One conversation's path. `undefined` for an unsafe run id: the id reaches this from a run
+ * store and, once #680 lands, indirectly from a chat surface, so it is checked rather than
+ * trusted into a path.
+ */
+export declare function conversationPath(cwd: string, runId: string): string | undefined;
+/** Markdown for one message, starting at `## ` (no file header, no blank lines around it). */
+export declare function renderMessage(message: ConversationMessage): string;
+/**
+ * Parse every message out of the markdown, in file order (append order, so oldest-first — a
+ * transcript reads forwards, unlike the newest-first project log). Forgiving: a malformed or
+ * torn message is skipped, never thrown.
+ */
+export declare function parseConversation(md: string): ConversationMessage[];
+/**
+ * Make sure `.the-framework/.gitignore` un-ignores the conversations dir, returning whether it
+ * wrote. Done lazily on append rather than only at install time: the seeded ignore file is
+ * written once and only when absent (`install.ts`), so every repo activated before this feature
+ * still carries the old three-line allow-list and would silently drop its own conversations.
+ *
+ * Only ours is upgraded — a file we do not recognize is left alone rather than appended to.
+ */
+export declare function ensureConversationsIgnored(cwd: string, fs?: StoreFs): Promise<boolean>;
+/**
+ * Append one message to `.the-framework/conversations/<runId>.md`, creating the dir, the
+ * one-time file header, and the ignore rule when absent. A raw write (may reject); the caller
+ * decides best-effort. A no-op for an unsafe run id.
+ */
+export declare function appendMessage(cwd: string, runId: string, message: ConversationMessage, fs?: StoreFs): Promise<void>;
+/** Read one conversation, oldest-first. Missing file (or unsafe id) yields `[]`. */
+export declare function readConversation(cwd: string, runId: string, fs?: StoreFs): Promise<ConversationMessage[]>;
+/** The run ids that have a committed conversation, sorted. Missing dir yields `[]`. */
+export declare function listConversations(cwd: string, fs?: StoreFs): Promise<string[]>;
+//# sourceMappingURL=conversations.d.ts.map

package/dist/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../src/conversations.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAEzE;;;;;;;;;;;;;;GAcG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,kBAAkB,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,yCAAuD,CAAA;AAE3F,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAA;AAE/C,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,gBAAgB,CAAA;IACtB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAA;CACb;AAUD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,kCAAkC;AAClC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAOD,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/E;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmBnE;AAoBD;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAE,OAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAW3G;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mBAAmB,EAC5B,EAAE,GAAE,OAAuB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,oFAAoF;AACpF,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,EAAE,GAAE,OAAuB,GAC1B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAIhC;AAED,uFAAuF;AACvF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAE,OAAuB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnG"}

package/dist/conversations.js

@@ -0,0 +1,176 @@
+import { join } from 'node:path';
+import { THE_FRAMEWORK_DIR } from './framework-dir.js';
+import { gitignorePath, LOGS_GITIGNORE } from './logs.js';
+import { isSafeRunId, nodeStoreFs } from './store/index.js';
+/**
+ * The committed conversations (#908): the human turns and the agent's replies of a run, kept in
+ * the Git repo so a clone carries the chat and not just the fact a run happened (#857).
+ *
+ * Deliberately not the verbose transcript — #857 leaves the tool-call-level log to the model
+ * provider, which is also the standing policy in run-store.ts. What lands here is what a person
+ * would reread: what was asked, and what came back.
+ *
+ * One file per run rather than one shared file, because run worktrees are live concurrently and
+ * each auto-commits its own pending work on teardown; a shared file would be a merge conflict
+ * every time two runs chatted at once. The run id is the join key back to the `- run:` field
+ * LOGS.md records (#898), so the committed session list and the committed chat line up.
+ *
+ * Pure core over the same {@link StoreFs} seam as logs.ts.
+ */
+/** The directory, under `.the-framework/`, that holds one markdown file per conversation. */
+export const CONVERSATIONS_DIR = 'conversations';
+/**
+ * The `.the-framework/.gitignore` that keeps run state transient while committing the DB. The
+ * conversations rules need both entries: the `*` rule makes git skip the directory without ever
+ * descending into it, so un-ignoring the files alone would never be reached.
+ */
+export const CONVERSATIONS_GITIGNORE = `!${CONVERSATIONS_DIR}/\n!${CONVERSATIONS_DIR}/**\n`;
+const ROLES = ['user', 'agent'];
+/** Heading field separator, matching LOGS.md: a middle dot (U+00B7) with a space on each side. */
+const SEP = ' · ';
+/** A transport name is a plain word, so it can never carry the heading separator into a heading. */
+const VIA = /^[A-Za-z0-9_-]+$/;
+/**
+ * Whether a transport name is safe to record. Exported because #917 lets a surface name itself
+ * over the control channel, so the name now arrives from outside this module: a `via` carrying
+ * the heading separator, a newline or a `#` would forge structure in a file whose entries are
+ * line-parsed, exactly the way #897 forged a LOGS.md title. Checked at the boundary rather than
+ * trusted, and the same predicate {@link parseConversation} reads back with.
+ */
+export function isSafeVia(via) {
+    return typeof via === 'string' && VIA.test(via);
+}
+/**
+ * Escape a message body so it cannot forge structure (#897's threat model, applied to a
+ * transcript). LOGS.md collapses free text to one line, which is right for a line-parsed record
+ * and wrong here: a multi-paragraph reply has to stay readable in a `git diff`. So the text stays
+ * as written and only a line's leading `#` or `\` is escaped, which is enough — an entry is only
+ * ever started by a line beginning `## `. Reversed by {@link unescapeBody}.
+ */
+export function escapeBody(text) {
+    return text.replace(/^([\\#])/gm, '\\$1');
+}
+/** Reverse {@link escapeBody}. */
+export function unescapeBody(text) {
+    return text.replace(/^\\([\\#])/gm, '$1');
+}
+/** The one-time first line of a conversation file. */
+function conversationHeader(runId) {
+    return `# Conversation ${runId}\n`;
+}
+/** The directory holding every conversation under `cwd`. */
+export function conversationsDir(cwd) {
+    return join(cwd, THE_FRAMEWORK_DIR, CONVERSATIONS_DIR);
+}
+/**
+ * One conversation's path. `undefined` for an unsafe run id: the id reaches this from a run
+ * store and, once #680 lands, indirectly from a chat surface, so it is checked rather than
+ * trusted into a path.
+ */
+export function conversationPath(cwd, runId) {
+    if (!isSafeRunId(runId))
+        return undefined;
+    return join(conversationsDir(cwd), `${runId}.md`);
+}
+/** Markdown for one message, starting at `## ` (no file header, no blank lines around it). */
+export function renderMessage(message) {
+    return `## ${message.at}${SEP}${message.role}${SEP}${message.via}\n\n${escapeBody(message.text)}`;
+}
+/**
+ * Parse every message out of the markdown, in file order (append order, so oldest-first — a
+ * transcript reads forwards, unlike the newest-first project log). Forgiving: a malformed or
+ * torn message is skipped, never thrown.
+ */
+export function parseConversation(md) {
+    const messages = [];
+    let block;
+    const flush = () => {
+        const message = block && parseMessage(block);
+        if (message)
+            messages.push(message);
+        block = undefined;
+    };
+    for (const line of md.split('\n')) {
+        if (line.startsWith('## ')) {
+            flush();
+            block = [line];
+        }
+        else if (block) {
+            block.push(line);
+        }
+        // Anything before the first `## ` (the file header) is ignored.
+    }
+    flush();
+    return messages;
+}
+/** Parse one `## `-headed block; `undefined` when a required field is missing/invalid. */
+function parseMessage(lines) {
+    const heading = lines[0]?.slice('## '.length) ?? '';
+    const parts = heading.split(SEP);
+    const at = parts[0];
+    const role = parts[1];
+    const via = parts[2];
+    if (!at || !role || !via || !ROLES.includes(role) || !VIA.test(via))
+        return undefined;
+    // A heading carries exactly three fields; anything more is not one of ours.
+    if (parts.length !== 3)
+        return undefined;
+    // Drop the blank line the renderer puts under the heading, and any trailing blank lines that
+    // are really the separator before the next message.
+    const body = lines.slice(1).join('\n').replace(/^\n/, '').replace(/\n+$/, '');
+    return { at, role: role, via, text: unescapeBody(body) };
+}
+/**
+ * Make sure `.the-framework/.gitignore` un-ignores the conversations dir, returning whether it
+ * wrote. Done lazily on append rather than only at install time: the seeded ignore file is
+ * written once and only when absent (`install.ts`), so every repo activated before this feature
+ * still carries the old three-line allow-list and would silently drop its own conversations.
+ *
+ * Only ours is upgraded — a file we do not recognize is left alone rather than appended to.
+ */
+export async function ensureConversationsIgnored(cwd, fs = nodeStoreFs()) {
+    const path = gitignorePath(cwd);
+    if (!(await fs.exists(path))) {
+        await fs.write(path, LOGS_GITIGNORE + CONVERSATIONS_GITIGNORE);
+        return true;
+    }
+    const current = await fs.read(path);
+    if (current.includes(`!${CONVERSATIONS_DIR}/**`))
+        return false;
+    if (!current.includes('!LOGS.md'))
+        return false;
+    await fs.write(path, current.endsWith('\n') ? current + CONVERSATIONS_GITIGNORE : current + '\n' + CONVERSATIONS_GITIGNORE);
+    return true;
+}
+/**
+ * Append one message to `.the-framework/conversations/<runId>.md`, creating the dir, the
+ * one-time file header, and the ignore rule when absent. A raw write (may reject); the caller
+ * decides best-effort. A no-op for an unsafe run id.
+ */
+export async function appendMessage(cwd, runId, message, fs = nodeStoreFs()) {
+    const path = conversationPath(cwd, runId);
+    if (!path)
+        return;
+    await fs.mkdir(conversationsDir(cwd));
+    await ensureConversationsIgnored(cwd, fs);
+    if (!(await fs.exists(path)))
+        await fs.write(path, conversationHeader(runId));
+    await fs.append(path, '\n' + renderMessage(message) + '\n');
+}
+/** Read one conversation, oldest-first. Missing file (or unsafe id) yields `[]`. */
+export async function readConversation(cwd, runId, fs = nodeStoreFs()) {
+    const path = conversationPath(cwd, runId);
+    if (!path || !(await fs.exists(path)))
+        return [];
+    return parseConversation(await fs.read(path));
+}
+/** The run ids that have a committed conversation, sorted. Missing dir yields `[]`. */
+export async function listConversations(cwd, fs = nodeStoreFs()) {
+    const names = await fs.readdir(conversationsDir(cwd)).catch(() => []);
+    return names
+        .filter(name => name.endsWith('.md'))
+        .map(name => name.slice(0, -'.md'.length))
+        .filter(isSafeRunId)
+        .sort();
+}
+//# sourceMappingURL=conversations.js.map

package/dist/conversations.js.map

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

package/dist/daemon-runtime.d.ts

@@ -0,0 +1,41 @@
+import type { FrameworkEvent } from './events.js';
+import type { StartAgentOptions, StartAgentResult, AddProjectResult } from './dashboard/index.js';
+import type { EventsSource, RemoteAgents } from './dashboard/rpc-serve.js';
+/**
+ * What the daemon does for a project (#393): start a run, add a project, and relay a run to and
+ * from a connected device. Split from daemon.ts so that file reads as the daemon's lifecycle
+ * (state file, ports, boot, shutdown). The daemon runs no agent itself (#1774): a Start is the
+ * project's own `start` hook line, and the run it begins belongs to whatever tool that line names.
+ */
+/** Inputs to {@link createProjectRuntime}. */
+export interface ProjectRuntimeOptions {
+    /** The daemon's home workspace; a run with no project id targets it. */
+    cwd: string;
+    /** Env for the registry lookups (#393). */
+    env: NodeJS.ProcessEnv;
+}
+/** The per-project surface the dashboard drives, plus its teardown. */
+export interface ProjectRuntime {
+    onStart: (prompt: string, options?: StartAgentOptions, targetProjectId?: string) => Promise<StartAgentResult>;
+    onAddProject: (path: string) => Promise<AddProjectResult>;
+    /** The live event stream for an agent this daemon is relaying from a device (#1067), else undefined
+     *  so `onEvents` falls back to tailing the on-disk log. Wired as the dashboard's events source. */
+    remoteEventsSource: EventsSource;
+    /** Tail a relay-started agent's on-disk events (#1067): the daemon's `/_relay/events` endpoint uses
+     *  it to stream one agent back to whichever daemon relayed it here. */
+    tailRelayEvents: (agentId: string, onEvent: (event: FrameworkEvent) => void) => () => void;
+    /** The relayed-agent lookup the dashboard's read RPCs consult (#1067 slice 2): which device a remote
+     *  run runs on, so a run-scoped RPC forwards there instead of resolving a local checkout. */
+    remoteAgents: RemoteAgents;
+    /** The device side of the relay (#1067 slice 2): run one whitelisted read/steer/handoff RPC against
+     *  this daemon's own home checkout, for a daemon that relayed an agent here. */
+    onRelayRpc: (fn: string, args: unknown[]) => Promise<unknown>;
+    /** Let go of the relayed streams. */
+    dispose: () => Promise<void>;
+}
+/**
+ * The daemon's per-project runtime (#393). The home `cwd` is the default target: a request with
+ * no project id (or the home id) resolves to it without a registry lookup.
+ */
+export declare function createProjectRuntime({ cwd, env }: ProjectRuntimeOptions): ProjectRuntime;
+//# sourceMappingURL=daemon-runtime.d.ts.map

package/dist/daemon-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-runtime.d.ts","sourceRoot":"","sources":["../src/daemon-runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACjG,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAa1E;;;;;GAKG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAA;IACX,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CACvB;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAAE,eAAe,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC7G,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACzD;uGACmG;IACnG,kBAAkB,EAAE,YAAY,CAAA;IAChC;2EACuE;IACvE,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;IAC1F;iGAC6F;IAC7F,YAAY,EAAE,YAAY,CAAA;IAC1B;oFACgF;IAChF,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7D,qCAAqC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,qBAAqB,GAAG,cAAc,CAiHxF"}

package/dist/daemon-runtime.js

@@ -0,0 +1,133 @@
+import { resolve } from 'node:path';
+import { stat } from 'node:fs/promises';
+import { fromDiaryLine, projectBranches, resolveAgentDiary } from './store/index.js';
+import { RelayedAgents, startRemoteAgent } from './dashboard/remote-run.js';
+import { dispatchRelayRpc } from './dashboard-rpc/relay-dispatch.js';
+import { tailAgentEvents } from './dashboard-rpc/events-tail.js';
+import { addProject, listProjects, projectId } from './registry.js';
+import { writeHookLines } from './built-in.js';
+import { installProject } from './install.js';
+import { runProjectHooks, runStartHook } from './project-hooks.js';
+import { publishLevelOf, publishPickIn } from './publish-levels.js';
+import { isBranchName } from './branch-name.js';
+import { hasRemote } from './has-remote.js';
+import { projectGitHost } from './store/git-host.js';
+/**
+ * The daemon's per-project runtime (#393). The home `cwd` is the default target: a request with
+ * no project id (or the home id) resolves to it without a registry lookup.
+ */
+export function createProjectRuntime({ cwd, env }) {
+    const homeId = projectId(resolve(cwd));
+    // Runs this daemon is relaying to/from a connected device (#1067): the local half of a remote agent.
+    const relayedAgents = new RelayedAgents();
+    // The relayed-agent lookup the dashboard's read RPCs consult (#1067 slice 2): is this agentId remote, and
+    // which device owns it. Outlives the event stream so a finished remote agent's push/PR still reaches it.
+    const remoteAgents = {
+        target: agentId => relayedAgents.target(agentId),
+        list: projectId => relayedAgents.list(projectId),
+    };
+    // The device side of the relay (#1067 slice 2): run one whitelisted read/steer/handoff RPC against this
+    // daemon's own home checkout, for a daemon that relayed an agent here. Home id forces the addressed project.
+    const onRelayRpc = (fn, args) => dispatchRelayRpc(homeId, fn, args);
+    // A project id resolves to its repo path via the registry; the home id (or none)
+    // resolves to the daemon's own `cwd` without a lookup.
+    const resolveProject = async (id) => {
+        if (!id || id === homeId)
+            return cwd;
+        const records = await listProjects(undefined, env).catch(() => []);
+        return records.find(record => record.id === id)?.path;
+    };
+    // Start (#1774): the project's own `start` hook line, which answers the id of the run it began.
+    // The daemon names no tool and holds nothing about the run: no slot, no cap (a person's click is
+    // the brake), no process to stop at shutdown. A project without the line cannot start a run here.
+    const onStart = async (prompt, options = {}, targetProjectId) => {
+        // Run on a connected device (#1067): forward the start to the remote daemon, which runs its own
+        // project's hook, and relay the run's events back. `remote` is stripped so the device does not
+        // relay onward, and `base` because a branch of this machine names nothing on the device (the device drops it too). The
+        // device starts it in its own home project.
+        if (options.remote) {
+            const { remote, base: _thisMachines, ...forwarded } = options;
+            const result = await startRemoteAgent(remote, { prompt, options: forwarded });
+            if (result.ok) {
+                // A relayed agent has no local checkout or pid, so its list row is a memory-only stub (#1077):
+                // registered here so onAgents can show it and a dashboard reload re-opens it. Never written to disk.
+                const now = new Date().toISOString();
+                const meta = {
+                    status: 'running',
+                    id: result.agentId,
+                    startedAt: now,
+                    updatedAt: now,
+                    target: 'remote',
+                    intent: prompt,
+                    ...(remote.label ? { remoteLabel: remote.label } : {}),
+                };
+                relayedAgents.register(result.agentId, remote, meta, targetProjectId ?? homeId);
+            }
+            return result;
+        }
+        const projectCwd = await resolveProject(targetProjectId);
+        if (!projectCwd)
+            return { ok: false, error: `unknown project: ${targetProjectId}` };
+        // The branch to start from ends up on the line's command line: only a branch name goes there.
+        // Refused, not dropped: a run started from the main branch instead would be a silent swap.
+        if (options.base !== undefined && !isBranchName(options.base))
+            return { ok: false, error: `not a branch name: ${String(options.base)}` };
+        // The pick in force is decided here, so every Start goes the same way whichever page sent it:
+        // with none saved, or one the project is not offered, the run goes as far as the project does
+        // with no pull request: its branch pushed, or its work committed where there is no remote.
+        const publish = publishLevelOf(publishPickIn(options.publish, (await projectGitHost(projectCwd).catch(() => undefined)) !== undefined, await hasRemote(projectCwd)));
+        const started = await runStartHook(projectCwd, {
+            prompt,
+            ...(options.driver !== undefined ? { driver: options.driver } : {}),
+            ...(options.model !== undefined ? { model: options.model } : {}),
+            ...(options.then !== undefined ? { then: options.then } : {}),
+            ...(publish !== undefined ? { publish } : {}),
+            ...(options.base !== undefined ? { base: options.base } : {}),
+        });
+        // The line made a checkout (or is about to): the project's checkouts are read again on the
+        // next look rather than a few seconds from now, so the new run's page finds its own.
+        if (started.ok)
+            projectBranches.changed(projectCwd);
+        return started.ok ? { ok: true, agentId: started.id } : { ok: false, error: started.error };
+    };
+    // Add a project (#396): install the repo, then register it so it appears in the Projects
+    // list. installProject is idempotent (an already-activated repo is a no-op success).
+    const onAddProject = async (path) => {
+        // Resolve relative input against the daemon cwd, and check the directory really
+        // exists first: without this a bad path reaches git as a missing cwd, which
+        // surfaces as the confusing "spawn git ENOENT" rather than a path error.
+        const abs = resolve(path);
+        const isDir = await stat(abs).then(s => s.isDirectory()).catch(() => false);
+        if (!isDir)
+            return { ok: false, error: `path does not exist or is not a directory: ${abs}` };
+        const result = await installProject(abs);
+        if (!result.ok)
+            return { ok: false, error: result.error };
+        // Each package that writes hook lines writes its own (the built-in runner's start, resume and
+        // check among them), so the new project starts an agent with nothing typed by hand. A writer
+        // keeps every line already there, so adding a project again only fills what is missing.
+        for (const failed of await writeHookLines(abs))
+            console.log(`[framework] hook lines (${abs}): ${failed}`);
+        await addProject(abs, new Date().toISOString()).catch(() => { });
+        // The project's open hooks (#1774): a project added while the daemon runs is a project the
+        // boot never saw, so its open lines run now, the way they would have at boot.
+        await runProjectHooks(abs, 'open', { log: console.log });
+        return { ok: true, alreadyActivated: result.alreadyActivated === true };
+    };
+    // The dashboard's events source (#1067): a stream for an agent this daemon is relaying from a device,
+    // else undefined so `onEvents` tails the on-disk log as usual for an ordinary local agent.
+    const remoteEventsSource = (_projectId, agentId) => relayedAgents.get(agentId);
+    // Tail a relay-started run's own log (#1067) for the `/_relay/events` endpoint: the diary the
+    // run's tool keeps, its lines turned into events. The relocating tail, for the same reason as
+    // the dashboard's onEvents: the diary becomes the finished run's when the run ends.
+    const tailRelayEvents = (agentId, onEvent) => tailAgentEvents(() => resolveAgentDiary(cwd, agentId), line => {
+        const event = fromDiaryLine(line);
+        if (event)
+            onEvent(event);
+    });
+    const dispose = async () => {
+        relayedAgents.dispose();
+    };
+    return { onStart, onAddProject, remoteEventsSource, tailRelayEvents, remoteAgents, onRelayRpc, dispose };
+}
+//# sourceMappingURL=daemon-runtime.js.map

package/dist/daemon-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-runtime.js","sourceRoot":"","sources":["../src/daemon-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAqC,MAAM,kBAAkB,CAAA;AAIvH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAqCpD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAyB;IACtE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;IACtC,qGAAqG;IACrG,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAA;IACzC,0GAA0G;IAC1G,yGAAyG;IACzG,MAAM,YAAY,GAAiB;QACjC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC;QAChD,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC;KACjD,CAAA;IACD,wGAAwG;IACxG,6GAA6G;IAC7G,MAAM,UAAU,GAAG,CAAC,EAAU,EAAE,IAAe,EAAoB,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;IAExG,iFAAiF;IACjF,uDAAuD;IACvD,MAAM,cAAc,GAAG,KAAK,EAAE,EAAsB,EAA+B,EAAE;QACnF,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,MAAM;YAAE,OAAO,GAAG,CAAA;QACpC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAClE,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAA;IACvD,CAAC,CAAA;IAED,gGAAgG;IAChG,iGAAiG;IACjG,kGAAkG;IAClG,MAAM,OAAO,GAAG,KAAK,EAAE,MAAc,EAAE,OAAO,GAAsB,EAAE,EAAE,eAAwB,EAA6B,EAAE;QAC7H,gGAAgG;QAChG,+FAA+F;QAC/F,uHAAuH;QACvH,4CAA4C;QAC5C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,SAAS,EAAE,GAAG,OAAO,CAAA;YAC7D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAA;YAC7E,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,+FAA+F;gBAC/F,qGAAqG;gBACrG,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;gBACpC,MAAM,IAAI,GAAc;oBACtB,MAAM,EAAE,SAAS;oBACjB,EAAE,EAAE,MAAM,CAAC,OAAO;oBAClB,SAAS,EAAE,GAAG;oBACd,SAAS,EAAE,GAAG;oBACd,MAAM,EAAE,QAAQ;oBAChB,MAAM,EAAE,MAAM;oBACd,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACvD,CAAA;gBACD,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,IAAI,MAAM,CAAC,CAAA;YACjF,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,CAAA;QACxD,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,eAAe,EAAE,EAAE,CAAA;QACnF,8FAA8F;QAC9F,2FAA2F;QAC3F,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;QACxI,8FAA8F;QAC9F,8FAA8F;QAC9F,2FAA2F;QAC3F,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QACpK,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE;YAC7C,MAAM;YACN,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAA;QACF,2FAA2F;QAC3F,qFAAqF;QACrF,IAAI,OAAO,CAAC,EAAE;YAAE,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QACnD,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAA;IAC7F,CAAC,CAAA;IAED,yFAAyF;IACzF,qFAAqF;IACrF,MAAM,YAAY,GAAG,KAAK,EAAE,IAAY,EAA6B,EAAE;QACrE,gFAAgF;QAChF,4EAA4E;QAC5E,yEAAyE;QACzE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QAC3E,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,8CAA8C,GAAG,EAAE,EAAE,CAAA;QAC5F,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAA;QACzD,8FAA8F;QAC9F,6FAA6F;QAC7F,wFAAwF;QACxF,KAAK,MAAM,MAAM,IAAI,MAAM,cAAc,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,GAAG,MAAM,MAAM,EAAE,CAAC,CAAA;QACzG,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC/D,2FAA2F;QAC3F,8EAA8E;QAC9E,MAAM,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACxD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAA;IACzE,CAAC,CAAA;IAED,sGAAsG;IACtG,2FAA2F;IAC3F,MAAM,kBAAkB,GAAiB,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAE5F,8FAA8F;IAC9F,8FAA8F;IAC9F,oFAAoF;IACpF,MAAM,eAAe,GAAG,CAAC,OAAe,EAAE,OAAwC,EAAgB,EAAE,CAClG,eAAe,CAAe,GAAG,EAAE,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE;QAC1E,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEJ,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,aAAa,CAAC,OAAO,EAAE,CAAA;IACzB,CAAC,CAAA;IAED,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,CAAA;AAC1G,CAAC"}

package/dist/daemon-services.d.ts

@@ -0,0 +1,36 @@
+import type { ProjectErrors } from './project-errors.js';
+/** What the daemon needs back. */
+export interface BackgroundServices {
+    /**
+     * Stop every background job. Resolves once the tick in flight has finished: these jobs commit
+     * and push, and stopping their clock does not stop their turn.
+     */
+    quiesce: () => Promise<void>;
+}
+/** What {@link startBackgroundServices} needs from the daemon. */
+export interface BackgroundServiceDeps {
+    env: NodeJS.ProcessEnv;
+    /** Where a job records a project state the user must fix (#1500), for the dashboard to show. */
+    projectErrors: ProjectErrors;
+    log: (message: string) => void;
+}
+/**
+ * One project's data-sync turn (#1599): converge the `agent-data` branch — the skills' branch,
+ * which carries the tickets, the queue and the `logs` skill's runs — with
+ * origin through the shared branch library, one pull, and set or clear the project's `data-sync`
+ * error by the outcome. The clear is unconditional on success, so the error lives exactly as long
+ * as the condition — the next tick after the user fixes the remote, it is gone. A repository with
+ * no remote is no error: the project is marked local only, for as long as it has none. The daemon knows
+ * nothing of what is on the branch (#1774): a skill's own setup makes its files.
+ */
+export declare function syncProjectData(path: string, errors: ProjectErrors, log: (message: string) => void): Promise<void>;
+/**
+ * One project's provider check (#1820), on the data sync's clock: a kind of the project's data
+ * that packages declare but none is settled to provide (several declare it and the project's
+ * package.json names none, or names one that does not declare it) is the project's `provider`
+ * error, every such kind on its own line; every kind settled clears it. The framework never picks
+ * the first declarer silently: the project says, or nothing provides and the banner says why.
+ */
+export declare function checkProviders(path: string, errors: ProjectErrors): Promise<void>;
+export declare function startBackgroundServices(deps: BackgroundServiceDeps): BackgroundServices;
+//# sourceMappingURL=daemon-services.d.ts.map

package/dist/daemon-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-services.d.ts","sourceRoot":"","sources":["../src/daemon-services.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA8BxD,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,gGAAgG;IAChG,aAAa,EAAE,aAAa,CAAA;IAC5B,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CASxH;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvF;AAQD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,kBAAkB,CAuDvF"}

package/dist/daemon-services.js

@@ -0,0 +1,120 @@
+import { basename } from 'node:path';
+import { listProjects } from './registry.js';
+import { startDaemonTick, DAEMON_TICK_MS } from './daemon-tick.js';
+import { DATA_BRANCH, pullFileBranch } from '@openagt/agent-data';
+import { startCloudScratchSweep } from './cloud-scratch-refs.js';
+import { adoptCloudWork, startCloudWorkAdoption } from './cloud-work.js';
+import { providerProblems } from './store/provided.js';
+import { projectGitHost } from './store/git-host.js';
+/**
+ * Everything the daemon runs in the background beside serving the dashboard: the data sync (#1599),
+ * the cloud-scratch sweep (#1547) and the cloud work adoption (#1601). None of them starts a run
+ * (#1774).
+ *
+ * All of it used to sit inline in `runDaemon`, which meant its body was a lifecycle narrative with
+ * ~200 lines of service wiring in the middle of it; the daemon body is left with the sequence it
+ * actually owns.
+ *
+ * They share one clock (E4). Each used to own a `setInterval`, so six intervals ran side by side
+ * with no single place to look when a sweep was not running; now each declares how many ticks it
+ * wants between turns and `daemon-tick.ts` fires them.
+ */
+/** Ticks between cloud work adoption passes: a ten-minute job. */
+const TEN_MINUTES_EVERY = Math.round((10 * 60 * 1000) / DAEMON_TICK_MS);
+/**
+ * Ticks between cloud-scratch sweeps (#1547): hourly. The refs it deletes have to sit for a day
+ * first, so a finer cadence would only spend `ls-remote` round-trips asking the same question.
+ */
+const CLOUD_SCRATCH_EVERY = Math.round((60 * 60 * 1000) / DAEMON_TICK_MS);
+/**
+ * One project's data-sync turn (#1599): converge the `agent-data` branch — the skills' branch,
+ * which carries the tickets, the queue and the `logs` skill's runs — with
+ * origin through the shared branch library, one pull, and set or clear the project's `data-sync`
+ * error by the outcome. The clear is unconditional on success, so the error lives exactly as long
+ * as the condition — the next tick after the user fixes the remote, it is gone. A repository with
+ * no remote is no error: the project is marked local only, for as long as it has none. The daemon knows
+ * nothing of what is on the branch (#1774): a skill's own setup makes its files.
+ */
+export async function syncProjectData(path, errors, log) {
+    const result = await pullFileBranch(path, DATA_BRANCH, { log });
+    const localOnly = !result.ok && result.noRemote === true;
+    errors.setLocalOnly(path, localOnly);
+    if (result.ok || localOnly)
+        errors.clear(path, 'data-sync');
+    else {
+        log(`[framework] data sync: ${result.error}`);
+        errors.set(path, 'data-sync', result.error);
+    }
+}
+/**
+ * One project's provider check (#1820), on the data sync's clock: a kind of the project's data
+ * that packages declare but none is settled to provide (several declare it and the project's
+ * package.json names none, or names one that does not declare it) is the project's `provider`
+ * error, every such kind on its own line; every kind settled clears it. The framework never picks
+ * the first declarer silently: the project says, or nothing provides and the banner says why.
+ */
+export async function checkProviders(path, errors) {
+    const problems = await providerProblems(path);
+    if (problems.length === 0)
+        errors.clear(path, 'provider');
+    else
+        errors.set(path, 'provider', problems.join('\n'));
+}
+/** The registered projects as dashboard summaries. */
+async function listSummaries(env) {
+    const records = await listProjects(undefined, env).catch(() => []);
+    return Promise.all(records.map(async (p) => ({ id: p.id, path: p.path, name: basename(p.path), activated: true, gitHost: (await projectGitHost(p.path).catch(() => undefined)) !== undefined })));
+}
+export function startBackgroundServices(deps) {
+    const { env, log } = deps;
+    const projects = () => listSummaries(env);
+    // Delete the scratch refs a web hand-off leaves on origin (#1547): the pre-hand-off `cloud-*`
+    // ref and the run branch, one dead pair per web run. Daemon-side rather than in the driver,
+    // because session creation only signals "created", not "clone finished" — a driver deleting its
+    // own ref races the provisioning and can strand the session. The sweep waits out that race
+    // (~a day) and only deletes refs whose work is provably on the default branch.
+    const cloudScratch = startCloudScratchSweep({ projects, log });
+    // Adopt the branch a cloud session actually worked on (#1601): match each settled web run to
+    // the `claude/*` head descending from its hand-off anchor, record the branch and PR on the
+    // run's archive, and open the armed draft PR the session never did. Daemon-side by necessity:
+    // the branch does not exist yet when the wrapper ends — the cloud VM is still provisioning.
+    const cloudWork = startCloudWorkAdoption({ projects, log, adopt: cwd => adoptCloudWork(cwd) });
+    // One clock for every background job (E4). Each says how many ticks it wants between turns
+    // instead of owning an interval, so there is one place to look when the answer to "why is
+    // nothing happening" is that a sweep is not running — and the ratios are exact rather than six
+    // timers drifting apart.
+    const clock = startDaemonTick({
+        log,
+        jobs: [
+            // The eager data pull (#1582): converge every project's data checkout on what other
+            // machines and cloud sessions pushed, and carry out anything a failed cycle left local.
+            // Its start-up turn is also what creates the checkout on a fresh clone. A project that
+            // cannot converge is recorded as such for the dashboard (#1599).
+            {
+                name: 'data sync',
+                every: 2,
+                run: async () => {
+                    for (const project of await projects().catch(() => [])) {
+                        await syncProjectData(project.path, deps.projectErrors, log);
+                        await checkProviders(project.path, deps.projectErrors);
+                    }
+                },
+            },
+            // Hourly. Its start-up turn is what starts a `cloud-*` ref's one-day clock (#1547): the
+            // sweep ages those refs from when it first saw them, so the sooner it looks, the sooner
+            // a leftover can go.
+            { name: 'cloud scratch sweep', every: CLOUD_SCRATCH_EVERY, run: () => cloudScratch.tick() },
+            // Ten minutes: the cloud session it waits on lives minutes-to-hours itself, and the pass
+            // costs an `ls-remote` per project only while a settled web run is actually waiting.
+            { name: 'cloud work adoption', every: TEN_MINUTES_EVERY, run: () => cloudWork.tick() },
+        ],
+    });
+    return {
+        quiesce: async () => {
+            await clock.stop();
+            cloudScratch.stop();
+            cloudWork.stop();
+        },
+    };
+}
+//# sourceMappingURL=daemon-services.js.map