toolroll 0.9.103 → 0.9.105

package/dist/server/render-new-task.d.ts

@@ -1,54 +0,0 @@
-import type { QualityMode } from "../quality.js";
-import type { UnattendedPermissionMode } from "../scope.js";
-import { type Chrome, type Screen } from "./chrome.js";
-import type { Scope } from "../scope.js";
-import type { Store } from "../store.js";
-export type TaskComposerPrefill = {
-    title: string;
-    goal: string;
-    not: string;
-    touches: string;
-    acceptance: string;
-    values?: URLSearchParams;
-};
-export declare function newTaskPage(chrome: Chrome, project: string | null, 
-/** undefined: keep the revision the refused form posted (its draft), so a project switch since still refuses. */
-projectRevision: number | undefined, problem: string | null, candidates?: {
-    id: string;
-    title: string;
-}[], permissionDefault?: UnattendedPermissionMode, qualityDefault?: QualityMode, projects?: {
-    path: string;
-    name: string;
-}[], 
-/** A shipped template's fields, or a refused filing's own words, back in the form. */
-prefill?: TaskComposerPrefill | null, 
-/** Words an idea's link put in the box (GET ?text=). */
-draft?: string | null, 
-/** Ideas for the chosen project: one tap drafts the words into the box. */
-suggestions?: ReadonlyArray<{
-    label: string;
-    draft: string;
-}>, 
-/** A link the lead or a person put in the address (GET ?from=). */
-fromLink?: string | null): Screen;
-/** The terms as label and words: the lines every approval surface reads (fast-terms.ts), with nothing hidden. */
-export declare function fastTermsRows(store: Store, scope: Scope, repo: string): ReadonlyArray<readonly [string, string]>;
-/** Build (docs/plans/plain-toolroll.md P2.4): the exact terms this small task would be approved on, and the one button
- * that approves them. The fields of "Plan it first" are the person's own words, on the ordinary road. */
-export declare function fastStartPage(chrome: Chrome, input: {
-    title: string;
-    repo: string;
-    preview: string;
-    digest: string;
-    terms: ReadonlyArray<readonly [string, string]>;
-}): Screen;
-/** An issue or pull request, read and quoted before anything is filed. Add task files it for the ordinary approval. */
-export declare function importPage(chrome: Chrome, input: {
-    repo: string;
-    url: string;
-    title: string;
-    body: string;
-    kind: "issue" | "pull";
-    number: number;
-    head: string | null;
-}): Screen;

package/dist/server/render-pages.d.ts

@@ -1,236 +0,0 @@
-/** Everyday console pages: home, inbox, board, work, projects, fleet and the queue. */
-import { type TidyItem } from "../tidy.js";
-import { type Html } from "../html.js";
-import { type AssignmentSnapshot } from "../assignment.js";
-import { type BoardCard } from "../board.js";
-import { type BrowserLimits } from "../browser-workspace.js";
-import { type DispatchDiagnosis } from "../dispatch.js";
-import { type Gap } from "../gaps.js";
-import { type parseBaseTreeSnapshot } from "../peek.js";
-import { type Runner } from "../runner.js";
-import { type Decision, type Incident, type Run, type Store, type TaskState, type WorktreeRow } from "../store.js";
-import { tally } from "../summary.js";
-import { type WorkIndexGroup, type WorkIndexItem, type WorkIndexPage } from "../work-index.js";
-import { type ChipTone } from "../design/kit.js";
-import { type WorkFacts, type WorkStatus, type WorkView } from "../workspace-ui.js";
-import { type Chrome, type Screen } from "./chrome.js";
-export declare const TASK_STATES: readonly TaskState[];
-/**
- * The inbox (v3): only things stalling progress without a person, one card
- * per underlying stall, each with its verb inline or one step away. No
- * auto-refresh — approval links lead to the step-up screen, and a page
- * that might hold typed input never re-renders itself.
- */
-/** Start a builder: the one command, as text to select (/start-builder, where every "Connect a builder" leads, and
- * the Agents page). `project`: the open project's name, when the viewer may see it; `connected`: whether a builder
- * that may build there is checking in (null: say nothing); `managed`: whether this person can start one themselves
- * (registering a builder takes an instance operator), else who to ask. */
-export declare function startBuilderHtml(data: {
-    heading: "h1" | "h2";
-    project: string | null;
-    connected: boolean | null;
-    managed: boolean;
-}): Html;
-/**
- * A build's stage as one of three steps — set up, writing, checking and
- * committing — read from the machine's own phase, never a percent. The
- * steps only move forward: evidence and proof checks run both before and
- * after the commit (builder.ts), so everything after the agent's turn is
- * one step, and the stage words say which part. Null for runs that are not
- * builds (planning, review, investigation): those have no honest steps.
- */
-export declare const BUILD_STEPS: readonly ["setting up", "writing", "checking and committing"];
-export declare function buildStepOf(claim: NonNullable<BoardCard["claim"]>): number | null;
-/**
- * The workers a board's strip may show: not retired, bound to at least one
- * project the server's ceiling admits (never a runner serving only projects
- * this server must not speak about), and — on a one-project board — bound to
- * that project.
- */
-export declare function boardWorkers(runners: readonly Runner[], scope: {
-    all: boolean;
-    project: string | null;
-    visible: (repo: string) => boolean;
-}): Runner[];
-/**
- * The board: the pipeline as lanes, position as meaning — attention, then
- * queued, then waiting, then building, then recently done — under a strip
- * of the workers doing it. Read-only by construction (every card is a link,
- * no forms, no nonces), which is what makes it safe to re-render itself
- * while somebody watches; a card that changes lane slides there
- * (regionScript's animate swap, keyed by data-vt).
- */
-export declare function boardBody(data: {
-    cards: BoardCard[];
-    /** The workers this board's work can go to (retired ones left out). */
-    workers: readonly Runner[];
-    done: ReturnType<Store["listCompletedWorkScoped"]>;
-    saturated: boolean;
-    now: Date;
-    /** The rolled-up view: every project inside the ceiling at once. */
-    all: boolean;
-    project: string | null;
-    delta: {
-        agoMinutes: number;
-        built: number;
-        failed: number;
-        questions: number;
-    } | null;
-}, ciRed: (pr: number) => boolean): Html;
-export declare function homePage(chrome: Chrome, data: {
-    csrf: string;
-    taskCount: number;
-    repo: string | null;
-    building: {
-        taskId: string;
-        runner: string;
-        claimedAt: string;
-        expiresAt: string;
-        model: string | null;
-    }[];
-    runners: Runner[];
-    worktrees: WorktreeRow[];
-    episode: {
-        id: number;
-        startedAt: string;
-        endedAt: string | null;
-        ticks: number;
-        built: number;
-        broke: number;
-    } | null;
-    summary: ReturnType<typeof tally<Run & {
-        taskId: string;
-    }>>;
-    decisions: (Decision & {
-        taskId: string;
-    })[];
-    incidents: (Incident & {
-        taskId: string;
-    })[];
-    stranded: {
-        id: string;
-        blockedBy: string[];
-    }[];
-    gaps: Gap[] | null;
-    outboxPending: number;
-    settings: boolean;
-    now: Date;
-}): Screen;
-export type WorkRow = WorkFacts & {
-    assignment?: AssignmentSnapshot | null;
-    assignmentProblem?: boolean;
-    executionId?: string;
-    familyNotice?: string | null;
-    status: WorkStatus;
-    resultRunId: number | null;
-};
-export declare const TASK_GROUP_LABEL: Readonly<Record<WorkIndexGroup, string>>;
-/** A list row's chip (src/design/KIT.md): a waiting row names its ask ("Plan", "Result") in the ask tone, or says
- * Needs you; every other row wears its headline in the tone of the status it belongs to. */
-export declare function workRowChip(row: Pick<WorkIndexItem, 'ask' | 'chip' | 'status' | 'archived'>): {
-    word: string;
-    tone: ChipTone;
-};
-/** The board's four columns: what needs you, what will start on its own, what runs, what finished. */
-export type WorkBoard = {
-    needs: WorkIndexPage;
-    queued: WorkIndexPage;
-    running: WorkIndexPage;
-    finished: WorkIndexPage;
-};
-export declare function workPage(chrome: Chrome, data: {
-    view: WorkView;
-    projectFilter?: string;
-    work: WorkIndexPage;
-    previous: boolean;
-    multiProject: boolean;
-    now: Date;
-    limits?: BrowserLimits | null;
-    state?: TaskState | null;
-    /** An approver in a browser session: rows offer Put away (or Restore, archived), and the page offers Put away old tasks. */
-    canPutAway?: boolean;
-    /** The project this list shows (null: every project in view) and whether All was asked for by name (`all=1`). */
-    lens?: string | null;
-    all?: boolean;
-    /** The Board view's columns, read from the same index as the list; absent for the List view. */
-    board?: WorkBoard | null;
-}): Screen;
-/** The compact completed row shared by both halves of the control room. */
-export type WorkbenchDone = {
-    taskId: string;
-    title: string;
-    outcome: string | null;
-    repo: string | null;
-};
-export type OnboardCardState = {
-    enabled: false;
-    why: string;
-} | {
-    enabled: true;
-    roots: readonly string[]; /** Easy-start: the local owner's own session (no password to type; the prover's local-owner branch proves the clone). */
-    localOwner?: boolean;
-    record: [string, {
-        nameWithOwner: string;
-        rootIndex: number;
-        target: string;
-        diskUsageKib: number | null;
-        large: boolean;
-        mintedAt: number;
-    }] | null;
-};
-export type ProjectPeek = {
-    waiting: number;
-    queued: number;
-    running: number;
-    doneRecently: number;
-};
-/**
- * owner/name from a git remote URL — FULLY ANCHORED https/ssh github.com
- * forms only (ghlist review, finding 2): a foreign host carrying
- * "github.com" in its path, or a non-github host, must never read as a
- * GitHub identity. Everything else is null.
- */
-export declare function githubIdentityOf(remoteUrl: string): string | null;
-/** The no-script "move to the front" sentinel: the form cannot name the
- * front of a partition, so the handler resolves it (slice 1b, fix 1). */
-export declare const QUEUE_FRONT = "__TOP__";
-export type QueueCardTask = ReturnType<Store["queueScoped"]>[number] & {
-    dispatch?: DispatchDiagnosis | null;
-};
-export declare function queueCard(one: QueueCardTask, revision: number, queueRevision: number, workers: {
-    name: string;
-    retired: boolean;
-}[], column: string): Html;
-/** The queue columns fragment — shared queue first, then each worker. */
-export declare function queueBody(tasks: QueueCardTask[], workers: {
-    name: string;
-    retired: boolean;
-    note: string | null;
-    capacity: number;
-    building: number;
-}[], revision: number, queueRevision: number): Html;
-/** The /queue page's one nonce'd script: delegated pointer-event drag (it
- * survives every fragment swap — finding 17) plus a poller that re-checks
- * focus, dirty inputs, and an in-flight drag AT SWAP TIME, never only
- * before the fetch. Select dirtiness compares against data-initial
- * (finding 18); missing that, a select counts clean.
- */
-export declare function queueScript(): string;
-export type PeekAdmission = {
-    run: Run;
-    /** The run's checkout, PROVEN non-null by the guards: a reviewer run
-     * (v29, artifact-only) is refused before admission ever forms. */
-    worktree: string;
-    epoch: string;
-    entries: ReturnType<typeof parseBaseTreeSnapshot>;
-};
-/** Put away old tasks (docs/plans/task-tidy.md): exactly what would be put away, grouped, each with why, every one
- * ticked; one step-up puts away the ticked ones, bound to this preview's digest. The CLI twin is named beside it. */
-export declare function putAwayPage(chrome: Chrome, data: {
-    items: readonly TidyItem[];
-    days: number;
-    digest: string;
-    now: Date;
-    problem: string | null;
-    releasesSkipped: string | null;
-}): Screen;

package/dist/server/render-people.d.ts

@@ -1,102 +0,0 @@
-import { type Html } from "../html.js";
-/** What a live invite grants, said on its join page ("Your access"). Project names only, never paths. */
-export type InviteTerms = {
-    role: "approver" | "viewer";
-    mintedBy: string;
-    expiresAt: string;
-    projects: readonly string[] | null;
-};
-/** Which join field a refusal is about. */
-export type JoinProblem = {
-    field: "name" | "password";
-    text: string;
-};
-/** The invite's front door: cookie-free, script-free, sensitive by shape. Rendered only for a LIVE token — everything
- * dead gets joinDeadPage. A live token's holder reads what it grants before choosing a name and a password. */
-export declare function joinFormPage(token: string, problem: JoinProblem | null, name: string, terms?: InviteTerms | null): Html;
-/** Unknown, expired, revoked, consumed, attempts spent: ONE page (D6). */
-export declare function joinDeadPage(): Html;
-/**
- * v100: for someone signed in with the identity provider, every step-up
- * password field (autocomplete="current-password"; a secret like a bot token
- * is never one) becomes that sign-in: confirmed, when an explicit re-check
- * made on request awaits its one step-up (cockpit B2), or a link to be
- * checked again, then back here. An ordinary sign-in never confirms.
- */
-export declare function ssoStepUps(page: Html, sso: {
-    label: string;
-    fresh: boolean;
-}, returnTo: string): Html;
-/**
- * Easy start: for a local owner who has no password yet, every step-up password field (type=password with
- * autocomplete="current-password", typed-only ones included) becomes "Set a password to do this." and the Set a
- * password link, carrying this page on: there is no password to type. A new password, a secret or a key field is
- * never one. The field's own label and hint go with it.
- */
-export declare function localOwnerStepUps(page: Html, setHref: string): Html;
-export declare function loginPage(problem: string | null, returnTo?: string, sso?: {
-    label: string;
-    operatorsOnly: boolean;
-} | null): Html;
-/**
- * Easy-start C2: reconnect this tab after a restart (or when it lost its key): the password again for a full session, an
- * identity-provider sign-in for one that signs in there, or the terminal for a local owner (no password exists).
- */
-export declare function reconnectPage(problem: string | null, returnTo: string, how: {
-    kind: "password";
-    name: string;
-} | {
-    kind: "sso";
-    label: string;
-} | {
-    kind: "command";
-}): Html;
-/** Which /password/set field a refusal is about (null: the page itself). */
-export type PasswordSetProblem = {
-    field: "password" | "again" | null;
-    text: string;
-};
-/**
- * Easy-start C4: the local owner's first password. Two fields and one button; the form carries the session's CSRF token
- * (render it inside withFormToken) and, through the page's key fill, the browser key and the act that was refused, to continue there. Neither typed
- * password ever comes back on a refusal.
- */
-export declare function passwordSetPage(view: {
-    returnTo: string;
-    problem: PasswordSetProblem | null;
-}): Html;
-/** /password/set once a password exists (set earlier, or just now in another tab): sign in with it, and come back. */
-export declare function passwordAlreadySetPage(title: string, returnTo: string, signedIn?: boolean): Html;
-/**
- * The page for an address the console doesn't answer to (onboarding): what was opened, where it answers, and the exact
- * command that admits this address. It stands alone (styles inline, no script, no font), because every other asset
- * would be refused at this address too; and it holds nothing a stranger's page doesn't already know.
- */
-export declare function wrongHostPage(facts: {
-    opened: string | null;
-    served: string;
-    command: string | null;
-}): Html;
-/** Which field a first-account refusal is about (null: the page itself, as when the tries are spent). */
-export type SignupProblem = {
-    field: "code" | "name" | "password" | null;
-    text: string;
-};
-/** The username rule, said once for the server's check, the input's `pattern` (anchored by the browser; `\-` so the
- * v-flag parse accepts it) and the hint. */
-export declare const SIGNUP_NAME: RegExp;
-export declare const SIGNUP_PASSWORD_MIN = 8;
-/** The first-account page (setup review): shown only while no approver exists. Rules are stated up front and match
- * the inputs' own constraints. On a refusal the typed username comes back; the setup code and the password never do.
- * The message sits under the field it is about, announced (role="alert"), with that field aria-invalid, described by
- * it and focused, so it works without script (this page has none). */
-export declare function signupPage(problem: SignupProblem | string | null, attemptsLeft: number, typedName?: string): Html;
-/** The page a browser sees when answering broke (Wave E): what happened, whether anything changed, a reference for the
- * log, and two ways on. `read`: the request only read, so nothing can have changed. Holds no error text. */
-export declare function serverErrorPage(options: {
-    updating: boolean;
-    read: boolean;
-    reference: string;
-    at: Date;
-    retry: string | null;
-}): Html;

package/dist/server/render-projects.d.ts

@@ -1,104 +0,0 @@
-import { type Html } from "../html.js";
-import { type ListOutcome } from "../onboard.js";
-import { type ProjectOutcomes } from "../project-outcomes.js";
-import { type Chrome, type Screen } from "./chrome.js";
-import { type OnboardCardState, type ProjectPeek } from "./render-pages.js";
-/** A path as a person reads it: the home folder as ~. */
-export declare function shortPathOf(path: string): string;
-/** A project's page address. Names are folder names, so two projects can share one: then the path picks. */
-export declare function projectHref(name: string, path: string, ambiguous: boolean, page?: string): string;
-/** What a project's counts say on one line ("2 need you · 1 running"); null when it wasn't scanned. */
-export declare function peekWords(peek: ProjectPeek | null): string | null;
-/** Where a message belongs: next to the GitHub link, in the clone review, the page's own refusal, or a neutral line
- * (a finished clone). */
-export type ProblemAt = "link" | "clone" | "open" | "said" | null;
-/** The add ways, as the drawer (and the no-script page) shows them: GitHub, then this computer. */
-export declare function addWaysHtml(data: {
-    browsable: boolean;
-    onboard: OnboardCardState | null;
-    returnTo: string;
-    linkProblem: string | null;
-}): Html;
-/** The clone review a preview minted (single use, ten minutes): what lands where, then the step-up. */
-export declare function cloneReviewHtml(onboard: OnboardCardState | null, problem: string | null): Html | null;
-/** The projects list: the React view draws it from `workspace.view`; the body is the same page for a browser
- * without the workspace script (and what the sensitivity check reads). */
-export declare function projectsPage(chrome: Chrome, data: {
-    recent: readonly {
-        path: string;
-        name: string;
-        lastOpenedAt: string;
-    }[];
-    candidates: readonly string[];
-    open: string | null;
-    problem: string | null;
-    problemAt: ProblemAt;
-    browsable: boolean;
-    onboard: OnboardCardState | null;
-    peeks: Readonly<Record<string, ProjectPeek | null>>;
-    returnTo: string;
-}): Screen;
-export type ProjectPageTask = {
-    href: string;
-    title: string;
-    reason: string;
-    needs: boolean;
-    since: string | null;
-};
-/** One project's reading page. Reads only: Open project posts to /projects/select, which switches this session. */
-export declare function projectPage(chrome: Chrome, data: {
-    name: string;
-    path: string;
-    selfHref: string;
-    open: boolean;
-    openedAt: string | null;
-    peek: ProjectPeek | null;
-    tasks: readonly ProjectPageTask[];
-    moreTasks: number;
-    checks: {
-        href: string;
-        level: string;
-    } | null;
-    pullRequests: {
-        href: string;
-        on: boolean;
-    } | null;
-    knowledgeHref: string;
-    flakyHref: string;
-    settingsHref: string | null;
-    activity: {
-        report: ProjectOutcomes | null;
-    } | null;
-    now: Date;
-}): Screen;
-export declare function browsePage(chrome: Chrome, data: {
-    at: string;
-    root: string;
-    roots: readonly string[];
-    parent: string | null;
-    entries: readonly {
-        name: string;
-        path: string;
-        git: boolean;
-    }[];
-    /** Projects already added here: their row says Open, not Add and open. */
-    registered: ReadonlySet<string>;
-}): Screen;
-/** The account's repositories with ONE honest action each: open (already a project here), add and open (a clone
- * under a projects folder), or the existing preview-and-password clone ceremony. */
-export declare function githubReposPage(chrome: Chrome, data: {
-    /** The last listing; null until someone lists (a POST: listing asks GitHub, so a page visit never does). */
-    listed: ListOutcome | null;
-    local: ReadonlyMap<string, string>;
-    registered: ReadonlySet<string>;
-    cloneReady: boolean;
-    openProject: string | null;
-    /** A projects folder didn't answer in time: local copies weren't matched this time. */
-    localUnanswered?: boolean;
-    now: Date;
-}): Screen;
-/** A project name nobody can see answers the same as one that doesn't exist. */
-export declare const unknownProject: (name: string) => {
-    title: string;
-    text: string;
-};

package/dist/server/render-release.d.ts

@@ -1,19 +0,0 @@
-import type { ApprovalFacts } from "../design/kit.js";
-import { type ReleaseApprovalCard } from "../release-approval.js";
-import { type Chrome, type Screen } from "./chrome.js";
-export type ReleaseSheetData = {
-    card: ReleaseApprovalCard;
-    /** The single-use approval nonce for this person, task and card digest ("" when nothing can be approved here). */
-    nonce: string;
-    facts: ApprovalFacts;
-    /** This computer's local owner: releases need a full sign-in first (scope.ts localApprovalEligible). */
-    local: {
-        message: string;
-        action: string;
-        href: string;
-    } | null;
-    problem: string | null;
-    /** An automatic release held after its merge (release-auto.ts): why, and that a person may let it go on. */
-    held?: string | null;
-};
-export declare function releaseSheetPage(chrome: Chrome, data: ReleaseSheetData): Screen;