toolroll 0.9.88 → 0.9.90

package/dist/up-processes.d.ts

@@ -10,7 +10,12 @@ export type UpConsoleConfig = {
     projectRoots: string[];
     registryPath: string;
     editor: boolean;
+    /** Easy-start C4: how `up` itself was authorised at this start ("full": a password verified; "local": local mode's
+     * owner; "none": nothing). The console mints a sign-in link only of this kind, whatever a later message asks for. */
+    startAuthority: UpStartAuthority;
 };
+/** How an `up` start was authorised (resolveUpApprover). */
+export type UpStartAuthority = "full" | "local" | "none";
 export type UpWorkerConfig = {
     runner: string;
     token: string;
@@ -57,10 +62,17 @@ export type ParentToRole = {
     type: "stopping";
 } | {
     type: "hard-stop";
-} | {
+}
+/** A full link names its account; a local one names none (the console reads local mode's owner itself). */
+ | {
     type: "sign-in-link";
     id: number;
+    kind: "full";
     account: string;
+} | {
+    type: "sign-in-link";
+    id: number;
+    kind: "local";
 };
 export type RoleToParent = {
     type: "ready";

package/dist/up-processes.js

@@ -31,7 +31,16 @@ export function parentMessage(value) {
         case "repos": return texts(value["repos"]) ? { type: "repos", repos: [...value["repos"]] } : null;
         case "stopping": return { type: "stopping" };
         case "hard-stop": return { type: "hard-stop" };
-        case "sign-in-link": return whole(value["id"]) && nonEmpty(value["account"], 256) ? { type: "sign-in-link", id: value["id"], account: value["account"] } : null;
+        case "sign-in-link": {
+            if (!whole(value["id"]))
+                return null;
+            // Exactly one of two shapes: a kind this build doesn't name, or a local request carrying an account, is no request.
+            if (value["kind"] === "full")
+                return nonEmpty(value["account"], 256) ? { type: "sign-in-link", id: value["id"], kind: "full", account: value["account"] } : null;
+            if (value["kind"] === "local")
+                return value["account"] === undefined ? { type: "sign-in-link", id: value["id"], kind: "local" } : null;
+            return null;
+        }
         default: return null;
     }
 }
@@ -70,11 +79,12 @@ export function startMessage(value) {
         return null;
     const base = { type: "start", databaseFile: value["databaseFile"], containment: value["containment"], build: value["build"] };
     if (value["role"] === "console") {
-        const keys = ["host", "port", "allowedHosts", "publicUrl", "localRunner", "poolRoot", "repos", "projectRoots", "registryPath", "editor"];
+        const keys = ["host", "port", "allowedHosts", "publicUrl", "localRunner", "poolRoot", "repos", "projectRoots", "registryPath", "editor", "startAuthority"];
         if (Object.keys(config).some(key => !keys.includes(key)))
             return null;
         if (!nonEmpty(config["host"], 253) || !whole(config["port"], 0, 65_535) || !orNull(config["allowedHosts"], texts) || !orNull(config["publicUrl"], (one) => nonEmpty(one, 2_048)) ||
-            !nonEmpty(config["localRunner"], 256) || !nonEmpty(config["poolRoot"], 4_096) || !texts(config["repos"]) || !texts(config["projectRoots"]) || !nonEmpty(config["registryPath"], 4_096) || typeof config["editor"] !== "boolean")
+            !nonEmpty(config["localRunner"], 256) || !nonEmpty(config["poolRoot"], 4_096) || !texts(config["repos"]) || !texts(config["projectRoots"]) || !nonEmpty(config["registryPath"], 4_096) || typeof config["editor"] !== "boolean" ||
+            !(config["startAuthority"] === "full" || config["startAuthority"] === "local" || config["startAuthority"] === "none"))
             return null;
         return { ...base, role: "console", config: config };
     }

package/dist/welcome-facts.d.ts

@@ -0,0 +1,18 @@
+import { type WelcomeModel } from "./first-run.js";
+import { type ConnectionChecker } from "./provider-connection.js";
+import type { Store } from "./store.js";
+export type WelcomeHere = {
+    model: WelcomeModel;
+    projects: readonly string[];
+};
+/** The welcome model for this computer now. `check`: the agent sign-in check (tests pass their own). */
+export declare function welcomeHere(store: Store, databaseFile: string, now: Date, options?: {
+    check?: ConnectionChecker;
+    platform?: NodeJS.Platform;
+}): Promise<WelcomeHere>;
+export type WelcomeStepKey = "agent" | "project" | "task";
+export declare const WELCOME_STEPS: readonly WelcomeStepKey[];
+/** One step as lines for a terminal: its number and name, Done or what to do next, in plain words. */
+export declare function welcomeStepLines(model: WelcomeModel, key: WelcomeStepKey): string[];
+/** The welcome as lines for a terminal: how many steps are left, then each step. */
+export declare function welcomeLines(model: WelcomeModel): string[];

package/dist/welcome-facts.js

@@ -0,0 +1,79 @@
+/**
+ * The welcome's facts read from this computer, for the screens that are not the console: `toolroll welcome` and the
+ * terminal UI's Setup screen. The console's /welcome reads the same facts from its runtime (server/welcome.ts); both
+ * go through first-run.ts's one model (welcomeModel), so the three steps say the same thing everywhere.
+ *
+ * Reads only: the project registry beside the database, the store, and each agent CLI's own sign-in check (no model,
+ * nothing spent).
+ */
+import { basename, dirname, join } from "node:path";
+import { resolvePhaseAgent } from "./agentconfig.js";
+import { builderReadyFor, firstRunBuilderRepo } from "./dispatch.js";
+import { SAMPLE_FIRST_TASKS, SAMPLE_PROJECT_NAME, GENERIC_FIRST_TASKS, welcomeModel } from "./first-run.js";
+import { createConnectionChecker } from "./provider-connection.js";
+import { loadProjectRegistry } from "./repos.js";
+const AGENT_OF = { "claude-subscription": "claude", "codex-subscription": "codex" };
+/** The welcome model for this computer now. `check`: the agent sign-in check (tests pass their own). */
+export async function welcomeHere(store, databaseFile, now, options = {}) {
+    const registry = await loadProjectRegistry(join(dirname(databaseFile), "repos.json"));
+    const repos = "error" in registry ? [] : registry.repos;
+    const root = "error" in registry ? null : registry.roots[0] ?? null;
+    const check = options.check ?? createConnectionChecker();
+    const states = await Promise.all(["claude", "codex"].map(one => check(one).then(value => value.state, () => "unverified")));
+    const repo = firstRunBuilderRepo(store, null, () => true, repos);
+    const sample = root === null ? null : `${root.replace(/\/+$/, "")}/${SAMPLE_PROJECT_NAME}`;
+    const build = resolvePhaseAgent(store, "build", repo, {});
+    const model = welcomeModel({
+        agents: { claude: states[0] ?? null, codex: states[1] ?? null },
+        inUse: AGENT_OF[store.getChatConfig()?.provider ?? ""] ?? null,
+        buildsOn: build.ok ? build.spec.provider : null,
+        // Choosing the agent is the console's act ("Use this one"); these screens show the step and its sign-in command.
+        canChoose: false,
+        projects: repos.map(path => ({ name: basename(path), path })),
+        projectRoot: root,
+        ready: builderReadyFor(store, repo, now),
+        hasTask: store.hasAnyWork(),
+        starters: repo !== null && repo === sample ? SAMPLE_FIRST_TASKS : GENERIC_FIRST_TASKS,
+        platform: options.platform ?? process.platform,
+    });
+    return { model, projects: repos };
+}
+export const WELCOME_STEPS = ["agent", "project", "task"];
+/** One step as lines for a terminal: its number and name, Done or what to do next, in plain words. */
+export function welcomeStepLines(model, key) {
+    const mark = (done) => (done ? "Done" : "To do");
+    const lines = [];
+    if (key === "agent") {
+        lines.push(`1. Agent · ${mark(model.agent.done)}`);
+        for (const agent of model.agent.agents) {
+            const state = agent.state === "signed-in" ? "signed in" : agent.state === "checking" ? "checking" : agent.state === "not-installed" ? "not installed" : "not signed in";
+            lines.push(`   ${agent.name}: ${state}${agent.inUse ? " (in use)" : ""}`);
+            if (agent.command !== null)
+                lines.push(`     To sign in, run: ${agent.command}`);
+        }
+    }
+    else if (key === "project") {
+        lines.push(`2. Project · ${mark(model.project.done)}`);
+        for (const one of model.project.projects.slice(0, 3))
+            lines.push(`   ${one.name}  ${one.path}`);
+        if (model.project.projects.length === 0)
+            lines.push("   Add a git repository: run `toolroll repos add <folder>`, or `toolroll open --web` and choose one.");
+        else if (model.project.notTakingWork)
+            lines.push("   Tasks can't start yet: nothing on this computer is taking work. Run `toolroll`.");
+    }
+    else {
+        lines.push(`3. First task · ${mark(model.task.done)}`);
+        if (model.task.done)
+            lines.push("   Filed. Its plan waits for your approval.");
+        else if (!model.task.open)
+            lines.push("   Add a project first.");
+        else
+            for (const one of model.task.starters)
+                lines.push(`   Idea: ${one.draft}`);
+    }
+    return lines;
+}
+/** The welcome as lines for a terminal: how many steps are left, then each step. */
+export function welcomeLines(model) {
+    return [model.left === 0 ? "Setup is done." : `${model.left} ${model.left === 1 ? "step" : "steps"} left.`, "", ...WELCOME_STEPS.flatMap(key => welcomeStepLines(model, key))];
+}

package/dist/youiyoux-intake.js

@@ -74,6 +74,7 @@ import { noteAssignmentStatus } from "./assignment-status.js";
 import { completionProblem } from "./landed-cleanup.js";
 import { COMPLETION_ACTION, LANDED_ACTOR } from "./result-completion.js";
 import { optionsProblem, PROPOSAL_ID, proposalFileOf, proposalIdOf, readYouiyouxProposal, readYouiyouxRequest, readYouiyouxRequestTask, YOUIYOUX_CARD_KIND, YOUIYOUX_FILED_VIA, YOUIYOUX_HOME_PATH } from "./contracts/youiyoux-request.js";
+import { FolderUnavailable } from "./folder-gate.js";
 export { YOUIYOUX_FILED_VIA };
 /** Who files the tasks: an automation, like a flow trigger. */
 export const YOUIYOUX_ACTOR = "youiyoux";
@@ -605,7 +606,16 @@ function intake(store, given, now, io, options) {
     const pass = NOTHING();
     const none = { pass, repo: null };
     // The project as Toolroll recorded it, resolved: a folder that isn't one of its projects is never read.
-    const repo = canonicalProject(given);
+    let repo;
+    // A folder the console's gate holds back (folder-gate.ts) isn't read this pass.
+    try {
+        repo = canonicalProject(given);
+    }
+    catch (error) {
+        if (error instanceof FolderUnavailable)
+            return none;
+        throw error;
+    }
     if (repo === null || !store.listProjects().some(one => one.path === repo))
         return none;
     const row = intakeRow(store, repo);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolroll",
-  "version": "0.9.88",
+  "version": "0.9.90",
   "description": "A control plane for unattended coding agents — queue tasks, walk away, come back to pull requests. Agents build in leased worktrees, never touch your default branch, and interrupt you only for decisions that need a human.",
   "directories": {
     "doc": "docs"
@@ -14,7 +14,7 @@
     "test:git": "vitest run test/attacks/checkout-git- test/attacks/fence-git-views test/attacks/repository-context-git test/attacks/discover-dirty src/teardown-git.test.ts src/worktree.slow.test.ts",
     "check:quick": "node scripts/quick-check.mjs",
     "dev": "tsx src/cli.ts",
-    "typecheck": "tsc --noEmit && tsc -p tsconfig.browser.json",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.browser.json && tsc -p tsconfig.tui.json",
     "certify:provider": "npm run build && node scripts/provider-canary.mjs",
     "certify:recovery": "npm run build && node scripts/recovery-canary.mjs",
     "certify:crash": "npm run build && node scripts/crash-canary.mjs",
@@ -93,6 +93,8 @@
     "clsx": "2.1.1",
     "esbuild": "0.28.2",
     "happy-dom": "20.14.5",
+    "ink": "6.8.0",
+    "ink-testing-library": "4.0.0",
     "lucide-react": "1.52.0",
     "react": "19.3.0",
     "react-dom": "19.3.0",