@openagt/dashboard 0.8.0 → 0.9.0

package/dist/event-stream.js

@@ -3,7 +3,7 @@
  * iterators, and replay history from an offset (tail=N replay).
  *
  * Absorbed from `@gemstack/ai-autopilot` when that package was deleted (A2). Its element type
- * used to default to the supervisor's event; the only caller here passes `FrameworkEvent`, so
+ * used to default to the supervisor's event; the only caller here passes `OpenAgentEvent`, so
  * the parameter is now required.
  */
 export class EventStream {

package/dist/events.d.ts

@@ -12,7 +12,7 @@ export interface ChoiceOption {
 }
 /**
  * An interactive choice the agent pauses on until a pick arrives (#304). Emitted as
- * a `choice` {@link FrameworkEvent}; the dashboard renders it in a panel and posts
+ * a `choice` {@link OpenAgentEvent}; the dashboard renders it in a panel and posts
  * the pick back. The recommended option is what an agent nobody is watching takes.
  */
 export interface ChoiceRequest {
@@ -39,7 +39,7 @@ export interface ChoiceRequest {
 }
 /** Who resolved a {@link ChoiceRequest}: a human, or a headless auto-accept. */
 export type ChoiceBy = 'user' | 'auto';
-/** What a {@link import('./agent.js').RunFrameworkOptions.requestChoice} handler resolves with. */
+/** What a {@link import('./agent.js').RunOpenAgentOptions.requestChoice} handler resolves with. */
 export interface ChoicePick {
     /** The picked option id, or (for a {@link ChoiceRequest.multi} select) the selected subset of ids. */
     picked: string | readonly string[];
@@ -49,21 +49,21 @@ export interface ChoicePick {
 /** Normalize a {@link ChoicePick} (single id or subset) to a list of picked ids. */
 export declare function pickedIds(picked: string | readonly string[]): string[];
 /**
- * The single type a run's timeline is read as. The framework emits none of these itself (#1774):
+ * The single type a run's timeline is read as. OpenAgent emits none of these itself (#1774):
  * a run's tool writes the run's diary, and every line of it is read as one of these so the
  * dashboard and the terminal render one timeline whatever wrote it.
  *
  * What a diary yields today is the agent's own progress (`driver`), the session id it reports
  * (`session-update`), the question a turn ended on (`choice`), what it cost (`usage`) and how it
  * ended (`end`). **The rest of this union is a reading vocabulary for runs recorded before the
- * daemon stopped running agents** — the framework's own narration back then. They are kept
+ * daemon stopped running agents** — OpenAgent's own narration back then. They are kept
  * because that history is still on the data branch and still has to render.
  *
  * Every event read from a diary line that says when it was written carries that time as `at`
  * (ISO 8601), so the timeline shows the same times live, after a reload, and once the run has
  * ended. Lines written before the diary kept times have none, and show none.
  */
-export type FrameworkEvent = {
+export type OpenAgentEvent = {
     at?: string;
 } & (
 /**
@@ -105,8 +105,8 @@ export type FrameworkEvent = {
  * A live screen something the agent ran is showing: a page on this machine's loopback, shown in
  * the chat where the line is, while it is the newest open screen at that address and the run
  * has not ended. `label` names what it showed then. The same address with `ended` says the
- * screen has gone. A diary line a command appends itself (agent-driver's `DIARY_ENV`); the
- * framework knows nothing of what the page is.
+ * screen has gone. A diary line a command appends itself (agent-driver's `DIARY_ENV`);
+ * OpenAgent knows nothing of what the page is.
  */
  | {
     kind: 'screen';
@@ -114,7 +114,7 @@ export type FrameworkEvent = {
     label: string;
     ended?: true;
 }
-/** A framework-level log line. */
+/** An OpenAgent-level log line. */
  | {
     kind: 'log';
     message: string;

package/dist/events.d.ts.map

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

package/dist/index.d.ts

@@ -13,7 +13,7 @@
  * ends where its consumers end, so a name nothing renders cannot quietly live on in it.
  */
 export type { AgentError, SessionInfo } from './agent-view.js';
-export type { ChoiceRequest, FrameworkEvent } from './events.js';
+export type { ChoiceRequest, OpenAgentEvent } from './events.js';
 export type { QuotaBoundary } from './quota-boundary.js';
 export type { CustomPreset, Preferences } from './registry.js';
 export type { PublishPick } from './publish-levels.js';
@@ -23,6 +23,7 @@ export type { Activity } from './dashboard/activity.js';
 export type { AgentHandoff } from './dashboard/agent-handoff.js';
 export type { GitHostHome } from './store/git-host.js';
 export type { RepositoryOffer, CreateRepositoryResult } from './store/repository.js';
+export type { BranchReach as RecordsReach } from '@openagt/agent-data';
 export type { BridgeEvent } from './dashboard/bridge-endpoints.js';
 export type { BridgeOption, BridgeQuestion } from './dashboard/bridge-question.js';
 export type { BridgeAnswer } from './dashboard/bridge-store.js';
@@ -37,5 +38,5 @@ export type { ProjectError, ProjectErrorCode } from './project-errors.js';
 export type { ProjectQueue } from './dashboard/queue.js';
 export type { QuotaView } from './dashboard/quota.js';
 export type { Ticket } from './store/tickets.js';
-export type { AgentWorktree, OnboardingSuggestion } from './dashboard/types.js';
+export type { AgentWorktree, CleanupReport, OnboardingSuggestion } from './dashboard/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACpF,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAClF,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACjF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7E,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACpF,YAAY,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAClF,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACjF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7E,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/install.d.ts

@@ -1,10 +1,12 @@
 import { type GitRunner } from '@openagt/agent-data';
 import { type StoreFs } from './store/index.js';
 /**
- * Install/activate a repo for The Framework (#391): create the `.the-framework/` marker and its
- * ignore file, committing pre-existing dirty changes first so the install commit is clean. Pure
- * core over the same {@link GitRunner} + {@link StoreFs} seams as project.ts.
+ * Install/activate a repo for OpenAgent (#391): create the `.openagent/` marker and its
+ * ignore file. Nothing is committed on a branch that has a commit. Pure core over the same
+ * {@link GitRunner} + {@link StoreFs} seams as project.ts.
  */
+/** The message of the empty commit an install gives a repository that has none. */
+export declare const FIRST_COMMIT_MESSAGE = "[OpenAgent] first commit";
 /** The outcome of {@link installProject}. Failures are values, never throws. */
 export type InstallResult = {
     ok: true;
@@ -20,10 +22,10 @@ export interface InstallDeps {
     fs?: StoreFs;
 }
 /**
- * Activate the repo at `cwd`: create `.the-framework/` with
- * its ignore file and layout marker (#1575), and commit the install. A repo whose ignore file is
- * already there is a no-op (`alreadyActivated`) — the ignore file is the activation marker.
- * Forgiving: any git/fs failure surfaces as `{ ok: false, error }`.
+ * Activate the repo at `cwd`: create `.openagent/` with its ignore file, which hides the whole
+ * directory from git, itself included, so the person's repository shows no change. A repo whose
+ * ignore file is already there is a no-op (`alreadyActivated`) — the ignore file is the
+ * activation marker. Forgiving: any git/fs failure surfaces as `{ ok: false, error }`.
  */
 export declare function installProject(cwd: string, deps?: InstallDeps): Promise<InstallResult>;
 //# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAG5D;;;;GAIG;AAEH,gFAAgF;AAChF,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhC,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,EAAE,CAAC,EAAE,OAAO,CAAA;CACb;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2BhG"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAG5D;;;;GAIG;AAEH,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,6BAA6B,CAAA;AAK9D,gFAAgF;AAChF,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhC,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,EAAE,CAAC,EAAE,OAAO,CAAA;CACb;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAgChG"}

package/dist/install.js

@@ -1,14 +1,23 @@
 import { join } from 'node:path';
 import { nodeGitRunner } from '@openagt/agent-data';
-import { THE_FRAMEWORK_DIR } from './framework-dir.js';
-import { frameworkGitignore, gitignorePath } from './framework-gitignore.js';
+import { OPENAGENT_DIR } from './openagent-dir.js';
+import { openagentGitignore, gitignorePath } from './openagent-gitignore.js';
 import { nodeStoreFs } from './store/index.js';
 import { errorMessage } from './error-message.js';
 /**
- * Activate the repo at `cwd`: create `.the-framework/` with
- * its ignore file and layout marker (#1575), and commit the install. A repo whose ignore file is
- * already there is a no-op (`alreadyActivated`) — the ignore file is the activation marker.
- * Forgiving: any git/fs failure surfaces as `{ ok: false, error }`.
+ * Install/activate a repo for OpenAgent (#391): create the `.openagent/` marker and its
+ * ignore file. Nothing is committed on a branch that has a commit. Pure core over the same
+ * {@link GitRunner} + {@link StoreFs} seams as project.ts.
+ */
+/** The message of the empty commit an install gives a repository that has none. */
+export const FIRST_COMMIT_MESSAGE = '[OpenAgent] first commit';
+/** Git's tree with no file in it. */
+const EMPTY_TREE = '4b825dc642cb6eb9a060e54bf8d69288fbee4904';
+/**
+ * Activate the repo at `cwd`: create `.openagent/` with its ignore file, which hides the whole
+ * directory from git, itself included, so the person's repository shows no change. A repo whose
+ * ignore file is already there is a no-op (`alreadyActivated`) — the ignore file is the
+ * activation marker. Forgiving: any git/fs failure surfaces as `{ ok: false, error }`.
  */
 export async function installProject(cwd, deps = {}) {
     const git = deps.git ?? nodeGitRunner();
@@ -16,21 +25,26 @@ export async function installProject(cwd, deps = {}) {
     if (await fs.exists(gitignorePath(cwd)))
         return { ok: true, alreadyActivated: true };
     try {
-        // Auto-initialize a repo when the folder isn't one yet: The Framework treats
+        // Auto-initialize a repo when the folder isn't one yet: OpenAgent treats
         // git as the source of truth, so `git init` it for the user rather than erroring.
         const insideRepo = await git(['rev-parse', '--is-inside-work-tree'], cwd)
             .then(out => out.trim() === 'true')
             .catch(() => false);
         if (!insideRepo)
             await git(['init'], cwd);
-        await fs.mkdir(join(cwd, THE_FRAMEWORK_DIR));
-        // Keep what lives under `.the-framework/` (a run's live files, the hooks file) out of git
+        // A repository with no commit cannot give an agent's branch a start. Its first commit is
+        // made empty, straight from the empty tree: the index is not read, so a file the person has
+        // staged stays staged and none of theirs is committed. Before the marker below, so a commit
+        // that fails leaves a folder the next add tries again.
+        const hasCommit = await git(['rev-parse', '--verify', '--quiet', 'HEAD'], cwd).then(() => true, () => false);
+        if (!hasCommit) {
+            const first = (await git(['commit-tree', EMPTY_TREE, '-m', FIRST_COMMIT_MESSAGE], cwd)).trim();
+            await git(['update-ref', 'HEAD', first], cwd);
+        }
+        await fs.mkdir(join(cwd, OPENAGENT_DIR));
+        // Keep what lives under `.openagent/` (a run's live files, the hooks file) out of git
         // (#313). The early return above established the file is absent.
-        await fs.write(gitignorePath(cwd), frameworkGitignore());
-        // Only The Framework's own directory (#1638): whatever the user has uncommitted stays theirs,
-        // uncommitted. Nothing is ever swept into a commit on their behalf.
-        await git(['add', THE_FRAMEWORK_DIR], cwd);
-        await git(['commit', '-m', '[The Framework] install The Framework'], cwd);
+        await fs.write(gitignorePath(cwd), openagentGitignore());
         return insideRepo ? { ok: true } : { ok: true, initialized: true };
     }
     catch (err) {

package/dist/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC5E,OAAO,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAmBjD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,IAAI,GAAgB,EAAE;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,WAAW,EAAE,CAAA;IAEnC,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAA;IAEpF,IAAI,CAAC;QACH,6EAA6E;QAC7E,kFAAkF;QAClF,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,GAAG,CAAC;aACtE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;aAClC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QACrB,IAAI,CAAC,UAAU;YAAE,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAA;QAEzC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAA;QAC5C,0FAA0F;QAC1F,iEAAiE;QACjE,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAA;QAExD,8FAA8F;QAC9F,oEAAoE;QACpE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,iBAAiB,CAAC,EAAE,GAAG,CAAC,CAAA;QAC1C,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,uCAAuC,CAAC,EAAE,GAAG,CAAC,CAAA;QACzE,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAA;IAChD,CAAC;AACH,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC5E,OAAO,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD;;;;GAIG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,CAAA;AAE9D,qCAAqC;AACrC,MAAM,UAAU,GAAG,0CAA0C,CAAA;AAa7D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,IAAI,GAAgB,EAAE;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,WAAW,EAAE,CAAA;IAEnC,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAA;IAEpF,IAAI,CAAC;QACH,yEAAyE;QACzE,kFAAkF;QAClF,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,GAAG,CAAC;aACtE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;aAClC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QACrB,IAAI,CAAC,UAAU;YAAE,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAA;QAEzC,yFAAyF;QACzF,4FAA4F;QAC5F,4FAA4F;QAC5F,uDAAuD;QACvD,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QAC5G,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,oBAAoB,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YAC9F,MAAM,GAAG,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,CAAA;QAC/C,CAAC;QAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAA;QACxC,sFAAsF;QACtF,iEAAiE;QACjE,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAA;QACxD,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAA;IAChD,CAAC;AACH,CAAC"}

package/dist/module-server.d.ts

@@ -2,7 +2,7 @@
 //
 // A module's server part is the file its package exports as `./server`. The daemon imports it once,
 // in its own process, and calls one of its reads when the module's browser part asks for it
-// (`host.read(name, input)` there). The server part imports nothing from the framework at run time:
+// (`host.read(name, input)` there). The server part imports nothing from OpenAgent at run time:
 // these are types only, and its default export is a plain object that satisfies `ModuleServer`.
 
 /** What the core knows about one run: facts, never a verdict about what the run's files are. */

package/dist/module-types/dashboard/lib/route.d.ts

@@ -2,7 +2,8 @@
  * Whether a first segment names a page a module adds (#1774) rather than a project: a lowercase
  * letter, then lowercase letters and digits. Never a project's id, which always carries a
  * `-<hash>` suffix, so the router reserves no module's word: whichever module claims the segment
- * gets it, and the shell says "no such page" when none does.
+ * gets it, and the shell says "no such page" when none does, or when the picked project
+ * has no package that adds it.
  */
 export declare function isPageSegment(segment: string): boolean;
 /** What the dashboard is looking at, as carried by the URL. */

package/dist/module-types/dashboard/lib/use-modules.d.ts

@@ -37,7 +37,7 @@ export interface MountedUsageLimit extends ModuleUsageLimit {
 /** What the installed modules bring, once loaded: their pages, their cards and their link actions. */
 export interface MountedModules {
     pages: MountedPage[];
-    /** The Overview's cards, in the order they are drawn: by `order`, then by package name. */
+    /** Every package's cards, in the order the Overview draws the ones it draws: by `order`, then by package name. */
     cards: MountedCard[];
     linkActions: MountedLinkAction[];
     /** The side-rail tabs, in package order. */
@@ -64,9 +64,10 @@ export declare function byMountOrder(a: {
  * modules claim going to the first, the cards (#1818), sorted by their order then their package, the link actions, the side-rail tabs, the run slots, the Settings sections (sorted as the cards are) and the usage bar's stop line (the first module's that declares one),
  * every one of them, each carrying the package it came from and the projects that have it. `loaded` is false until the module list has
  * been read and every module in it imported, so the shell can tell "no such page" from "not
- * loaded yet".
+ * loaded yet". A change of `reloadKey` reads the list again at once; what is mounted stays until
+ * it answers.
  */
-export declare function useModules(): MountedModules;
+export declare function useModules(reloadKey?: number): MountedModules;
 /**
  * The mounted modules, for any component in the shell (#1774): the shell reads them once with
  * {@link useModules} and provides them here, so a page deep in the tree finds the link actions

package/dist/module-types/dashboard/module/index.d.ts

@@ -84,15 +84,15 @@ export interface LinkAction {
      */
     run(host: ModuleHost, projectId: string, links: ModuleLink[]): Promise<LinkActionResult>;
 }
-/** What a module card is rendered with: the projects that have its package. A card has no URL and no sub-path. */
+/** What a module card is rendered with: the projects that have its package, never none: the card is not drawn then. With a project picked in the dashboard, that project alone. A card has no URL and no sub-path. */
 export interface ModuleCardProps {
-    /** The registered projects whose dependencies include the module's package, in the registry's order. */
+    /** The registered projects that have the module's package, in the registry's order; with a project picked in the dashboard, that project alone. Never empty. */
     projects: ModuleProject[];
 }
 /**
  * A card a module adds to the Overview (#1818): the package's own summary of its data across the
- * projects that have it, drawn beside the dashboard's own cards. A project none of whose packages
- * declares a card sees none.
+ * projects that have it, drawn beside the dashboard's own cards. Drawn only when one of the
+ * projects the Overview shows has the package: with a project picked, only when that project has it.
  */
 export interface ModuleCard {
     /** Which card this is, for the shell's key and its error line; never shown as a title. */
@@ -276,7 +276,7 @@ export interface ModuleHost {
     read(projectId: string, name: string, input?: Record<string, unknown>): Promise<ModuleReadResult>;
     /** Open one agent's page in the dashboard: its live feed while it runs, its record after. */
     openAgent(projectId: string, agentId: string): void;
-    /** Open a page a module adds (this one's or another's), at a sub-path: `openPage('tickets', [projectId, file])`. */
+    /** Open a page a module adds (this one's or another's), at a sub-path: `openPage('tickets', [projectId, file])`. With a project picked in the dashboard, a page that project's packages do not add shows "No such page". */
     openPage(segment: string, path?: string[]): void;
     /**
      * Start a run in one project with this prompt, with the person's own picks (which tool, which

package/dist/module-types/src/agent-view.d.ts

@@ -1,4 +1,4 @@
-import type { FrameworkEvent } from './events.js';
+import type { OpenAgentEvent } from './events.js';
 /** One error of a run: one the agent reported through an `error` block (#1500), or one its tool wrote in the diary. */
 export interface AgentError {
     /** What is wrong, in one line. */
@@ -16,7 +16,7 @@ export interface AgentError {
  * A fold over the log rather than state of its own: an error is an event that happened, so the
  * list only ever grows, and reopening a finished agent shows exactly what it showed while it ran.
  */
-export declare function agentErrors(events: readonly FrameworkEvent[]): AgentError[];
+export declare function agentErrors(events: readonly OpenAgentEvent[]): AgentError[];
 /** The wrapped agent session (#431): its id and a deep link, when one is known. */
 export interface SessionInfo {
     sessionId?: string;
@@ -35,4 +35,4 @@ export interface SessionInfo {
  * event, then the id and any deep link from the latest `session-update`. Null before the
  * session opens. The link is what the old dashboard surfaced as "open session".
  */
-export declare function sessionInfo(events: readonly FrameworkEvent[]): SessionInfo | null;
+export declare function sessionInfo(events: readonly OpenAgentEvent[]): SessionInfo | null;

package/dist/module-types/src/bridge-browser.d.ts

@@ -16,10 +16,10 @@
  * user has to sign in.
  */
 /** The directory holding the bridge browser's profile and binary, next to the registry file. */
-export declare const BRIDGE_BROWSER_DIR = "the-framework-browser";
+export declare const BRIDGE_BROWSER_DIR = "openagent-browser";
 /**
- * Where the bridge browser lives: `$XDG_CONFIG_HOME/the-framework-browser` when set, else the
- * dotted `$HOME/.the-framework-browser`. Beside the registry, so the same variable that isolates
+ * Where the bridge browser lives: `$XDG_CONFIG_HOME/openagent-browser` when set, else the
+ * dotted `$HOME/.openagent-browser`. Beside the registry, so the same variable that isolates
  * a test's registry isolates its browser, and a machine's real one is never touched from a test.
  * The profile inside it is persistent on purpose: the user signs in once and the sign-in outlives
  * every daemon restart.
@@ -152,7 +152,7 @@ export declare function appBundle(binary: string): string | undefined;
 export declare function bridgeBrowserDeps(): BridgeBrowserDeps;
 /**
  * Make sure nothing else holds the profile: a browser a dead daemon left behind is stopped,
- * gently first. It is the framework's own profile, so whatever holds it is the framework's own
+ * gently first. It is OpenAgent's own profile, so whatever holds it is OpenAgent's own
  * leftover; nothing the user runs shares it.
  */
 export declare function freeProfile(profileDir: string, deps: BridgeBrowserDeps): Promise<boolean>;

package/dist/module-types/src/built-in.d.ts

@@ -1,14 +1,15 @@
+import type { CleanupReport } from './dashboard/types.js';
 import { type ProjectPackage, type ProvidedCommand, type ProvidedCommandLookup } from '@openagt/agent-data';
 /**
- * The packages the framework ships for every project, by name: dependencies of the framework
+ * The packages OpenAgent ships for every project, by name: dependencies of OpenAgent
  * itself, resolved from its own install, so a project installs nothing for them and an empty
  * folder starts an agent and shows it. Each comes through the same contract as a project's own
  * package: a module by its `./dashboard` export, a provider of a kind of data and the writer of
- * its hook lines by its `framework` key. This list is the one place the framework names a
+ * its hook lines by its `openagent` key. This list is the one place OpenAgent names a
  * package, and a project's own copy of any of them wins.
  */
 export declare const BUILT_IN_PACKAGES: readonly string[];
-/** The built-in packages, resolved from the framework's own install, once; one that is not installed is skipped. */
+/** The built-in packages, resolved from OpenAgent's own install, once; one that is not installed is skipped. */
 export declare function builtInPackages(): Promise<ProjectPackage[]>;
 /** The directories the built-in packages' commands sit in: what a hook line's PATH gains after the project's own installed tools. */
 export declare function builtInBinDirs(): Promise<string[]>;
@@ -20,9 +21,17 @@ export declare function providedCommand(root: string, kind: string): Promise<Pro
 export declare function isBuiltIn(root: string, command: ProvidedCommand): Promise<boolean>;
 /**
  * Have every package that writes hook lines write its own into the project at `root`: a package
- * declares `"framework": { "hooks": "<command>" }`, and `<command> init`, run in the project,
+ * declares `"openagent": { "hooks": "<command>" }`, and `<command> init`, run in the project,
  * writes its lines into the project's hooks file, keeping every line already there. The project's
  * own packages are asked, then the built-in ones the project has no copy of. Answers one line per
  * package that could not write, in words.
  */
 export declare function writeHookLines(root: string): Promise<string[]>;
+/**
+ * Have every package that declares a clean-up remove what it left in the project at `root`: a
+ * package declares `"openagent": { "cleanup": "<command>" }`, and `<command> cleanup`, run in the
+ * project, answers `{ ok: true, removed, kept }`. The project's own packages are asked, then the
+ * built-in ones the project has no copy of, each whatever the one before answered. A package
+ * that refuses, fails or answers something else is one line in `failed`, in words.
+ */
+export declare function runCleanups(root: string): Promise<CleanupReport>;

package/dist/module-types/src/client.d.ts

@@ -1,6 +1,6 @@
 export { DRIVERS, DRIVER_LABELS, isDriverName, driverFromImpl, type DriverName } from './driver-names.js';
 export { PUBLISH_LABELS, isPublishPick, offeredPublishPicks, publishPickIn, type PublishPick } from './publish-levels.js';
-export { formatFrameworkEvent } from './terminal.js';
+export { formatOpenAgentEvent } from './terminal.js';
 export { formatBytes } from './format-bytes.js';
 export { errorMessage } from './error-message.js';
 export { pickedIds } from './events.js';

package/dist/module-types/src/cloud-run-state.d.ts

@@ -9,7 +9,7 @@ export declare const CLOUD_SESSION_WINDOW_MS: number;
  * What the cloud side of a web run is doing.
  *
  * - `waiting`: the browser bridge holds a question the session is parked on
- * - `merged`: the session's work was adopted (#1601) and its pull request merged by the framework
+ * - `merged`: the session's work was adopted (#1601) and its pull request merged by OpenAgent
  * - `in-cloud`: no pull request yet and the run is inside the session window, so it may still be working
  * - `done`: its pull request exists — the work landed, and the PR badge carries its live state — or the
  *   window passed with nothing adopted: the session finished or never pushed

package/dist/module-types/src/dashboard/agent-handoff.d.ts

@@ -43,7 +43,7 @@ export interface AgentHandoff {
     deletions: number;
     /**
      * The session produced nothing to hand off: the branch exists but carries no commit the base
-     * does not already have — or nothing beyond the framework's own bookkeeping (#1291), which is
+     * does not already have — or nothing beyond OpenAgent's own bookkeeping (#1291), which is
      * committed for provenance, never as publishable work. Said out loud, rather than shown as an
      * empty branch.
      */
@@ -161,7 +161,7 @@ export declare function mergeAgentPr(cwd: string, agent: PrAgent, deps?: {
 }): Promise<HandoffResult>;
 /**
  * Read what a finished session left behind, for `branch`: the branch's git facts from the
- * project's branches provider, and the run's own pull request from the framework's lookup.
+ * project's branches provider, and the run's own pull request from OpenAgent's lookup.
  *
  * Returns undefined only when the project has no branches provider, or the provider did not
  * answer for the branch. A branch that no longer exists still returns a handoff (with
@@ -213,8 +213,8 @@ export declare function mergeAgentBranch(cwd: string, agent: Pick<AgentMeta, 'id
 /**
  * Open a draft PR for a branch that exists only on the remote (#1601): a cloud session's own
  * `claude/*` branch was pushed from a VM this machine never sees, so there is nothing to push
- * here — the provider publishes the branch as the remote has it. Draft because a PR the
- * framework opens by itself must not put a review request in anyone's inbox, and the
+ * here — the provider publishes the branch as the remote has it. Draft because a PR
+ * OpenAgent opens by itself must not put a review request in anyone's inbox, and the
  * interventions queue keeps listing a session's draft.
  */
 export declare function openRemoteBranchPullRequest(cwd: string, agent: HandoffAgent, branch: string, deps?: {

package/dist/module-types/src/dashboard/bridge-endpoints.d.ts

@@ -26,12 +26,12 @@ export declare const BRIDGE_PREFIX = "/_bridge";
  * The extension version this daemon speaks (#1519). The extension states its own version on
  * every call, in this header, and a daemon expecting another refuses outright: a version-skewed
  * extension does not fail loudly, it half-works — missed messages, silently ignored fields —
- * which reads as a framework bug and burns a debugging session. The extension's manifest must
+ * which reads as an OpenAgent bug and burns a debugging session. The extension's manifest must
  * carry the same number; a test keeps the two in lockstep.
  */
-export declare const EXPECTED_EXTENSION_VERSION = "0.12.0";
+export declare const EXPECTED_EXTENSION_VERSION = "0.13.0";
 /** The header the extension states its version in. Lowercase, as node presents all headers. */
-export declare const EXTENSION_VERSION_HEADER = "x-tf-extension-version";
+export declare const EXTENSION_VERSION_HEADER = "x-oa-extension-version";
 /**
  * One thing a cloud session did, as scraped from its page (#1237).
  *

package/dist/module-types/src/dashboard/docs.d.ts

@@ -4,7 +4,7 @@
  *
  * These are written per session as `PLAN_<SESSION>.agent.md` (the plan for now) and
  * `TODO_<SESSION>.agent.md` (the backlog), where SESSION is a git-branch slug — by
- * The Framework's own system prompt back when it ran the agent (#323/#326), and by
+ * OpenAgent's own system prompt back when it ran the agent (#323/#326), and by
  * whatever a project's own skills tell an agent to write now. The flat fallback is `PLAN.md`
  * at the root; the `TODO` category has no flat file: the agent queue is not a document of the
  * checkout but a project package's data, and the dashboard shows it on that package's own page

package/dist/module-types/src/dashboard/git-status.d.ts

@@ -16,7 +16,7 @@ export interface GitStatusDeps {
     /**
      * The agent's start, when the status is read for an agent's checkout (#1255). The default lookup
      * answers the newest PR for the branch *in any state* — so an agent on a reused pinned branch
-     * (`the-framework/triage-quick`) wears a predecessor's merged PR as its own badge.
+     * (`openagent/triage-quick`) wears a predecessor's merged PR as its own badge.
      * With `since` set the PR is picked from the branch's whole history by {@link pickAgentPr}
      * instead: an open PR, or a closed one no older than the agent itself.
      */

package/dist/module-types/src/dashboard/interventions.d.ts

@@ -1,5 +1,5 @@
 import { type LiveAgent, type AgentMeta } from '../store/index.js';
-import type { FrameworkEvent } from '../events.js';
+import type { OpenAgentEvent } from '../events.js';
 import type { ProjectSummary, ProjectionRead } from './projects.js';
 import { type BranchesFor } from '../store/branches.js';
 import { type PrLister } from './pull-requests.js';
@@ -39,7 +39,7 @@ export interface InterventionsDeps {
     /** The reader of the runs that have a checkout (default {@link readLiveMetas}): a waiting run keeps its own; drives the `awaiting` source (#636). */
     liveAgents?: (cwd: string) => Promise<LiveAgent[]>;
     /** One run's events, by the project's path and the run's id (default {@link loadAgentEvents}): where a waiting run's question is read. */
-    events?: (cwd: string, agentId: string) => Promise<FrameworkEvent[] | undefined>;
+    events?: (cwd: string, agentId: string) => Promise<OpenAgentEvent[] | undefined>;
     /** The finished-agent reader (default {@link listAgents}); drives the `unpushed` source (#860). */
     agents?: (cwd: string) => Promise<AgentMeta[]>;
     /** The project's checkouts and branches (default the project's provider, {@link projectBranches}): where a branch's state is read; drives the `unpushed` source (#860). */

package/dist/module-types/src/dashboard/open-in-app.d.ts

@@ -7,7 +7,7 @@ export interface EditorInfo {
 }
 /**
  * The editors the picker can offer (#727), probed by their CLI launcher on PATH. Order is the
- * display order. `$FRAMEWORK_EDITOR` and a hand-typed value stay valid beyond this list; this is
+ * display order. `$OPENAGENT_EDITOR` and a hand-typed value stay valid beyond this list; this is
  * only what auto-detection looks for.
  */
 export declare const KNOWN_EDITORS: EditorInfo[];
@@ -29,7 +29,7 @@ export declare function fileManagerCommand(path: string, os?: NodeJS.Platform):
     command: string;
     args: string[];
 };
-/** The command to open a path in an editor: `$FRAMEWORK_EDITOR` when set, else the VS Code CLI. */
+/** The command to open a path in an editor: `$OPENAGENT_EDITOR` when set, else the VS Code CLI. */
 export declare function editorCommand(path: string, editor?: string | undefined): {
     command: string;
     args: string[];
@@ -37,6 +37,6 @@ export declare function editorCommand(path: string, editor?: string | undefined)
 /**
  * Open the project at `cwd` in the file manager or an editor. Failures are values, never throws.
  * `editor` (#727) is the stored preference; when unset {@link editorCommand} falls back to
- * `$FRAMEWORK_EDITOR`, then `code`.
+ * `$OPENAGENT_EDITOR`, then `code`.
  */
 export declare function openInApp(cwd: string, target: OpenTarget, agent?: SpawnRunner, editor?: string): Promise<OpenResult>;

package/dist/module-types/src/dashboard/open-questions.d.ts

@@ -1,5 +1,5 @@
 import { type AgentMeta, type LiveAgent } from '../store/index.js';
-import type { ChoiceRequest, FrameworkEvent } from '../events.js';
+import type { ChoiceRequest, OpenAgentEvent } from '../events.js';
 import { type BridgeQuestion } from './bridge-question.js';
 import type { ProjectSummary } from './projects.js';
 /** One session's open question, as the hub lists it: who waits, on what, since when. */
@@ -19,7 +19,7 @@ export interface OpenQuestionsDeps {
     /** The reader of the runs that have a checkout (default {@link readLiveMetas}): a waiting run keeps its own. */
     liveAgents?: (cwd: string) => Promise<LiveAgent[]>;
     /** One run's events, by the project's path and the run's id (default {@link loadAgentEvents}). */
-    events?: (cwd: string, agentId: string) => Promise<FrameworkEvent[] | undefined>;
+    events?: (cwd: string, agentId: string) => Promise<OpenAgentEvent[] | undefined>;
     /**
      * The questions the browser bridge holds, minus those with an answer already on its way
      * (default: the daemon's bridge store).

package/dist/module-types/src/dashboard/projects.d.ts

@@ -1,6 +1,6 @@
 import { type ProjectRecord } from '../registry.js';
 import { type AgentMeta } from '../store/index.js';
-import type { ProjectError } from '../project-errors.js';
+import type { ProjectError, StaysLocal } from '../project-errors.js';
 import { type GitHostFor } from '../store/git-host.js';
 /**
  * The multi-project read side (#392): projects the daemon serves come from the registry (#390),
@@ -16,7 +16,7 @@ export interface ProjectSummary {
     path: string;
     /** Display name (the path's basename). */
     name: string;
-    /** True when the repo still has its `.the-framework/` marker. */
+    /** True when the repo still has its `.openagent/` marker. */
     activated: boolean;
     /** Whether one of the project's packages provides a git host; without one no pull request can be opened there. */
     gitHost: boolean;
@@ -29,10 +29,11 @@ export interface ProjectSummary {
      */
     errors?: ProjectError[];
     /**
-     * The project's repository has no remote, as the daemon's last data sync found it: nothing is
-     * wrong, it lives on this machine only. Absent otherwise; attached like `errors`.
+     * Why the project's data stays on this machine, as the daemon's last data sync found it: its
+     * repository has no remote, or the person keeps the agents' records here. Nothing is wrong.
+     * Absent for a project that shares them; attached like `errors`.
      */
-    localOnly?: true;
+    local?: StaysLocal;
 }
 /**
  * A projection over the registered projects, together with the projects it could actually see.