toolcraft 0.0.16 → 0.0.18

package/node_modules/@poe-code/design-system/dist/explorer/theme.js

@@ -0,0 +1,97 @@
+export function getExplorerTheme() {
+    return {
+        accent: accent,
+        muted: muted,
+        border: muted,
+        borderFocused: accent,
+        badge: (text, tone) => tonePainter(tone)(` ${text} `),
+        matchHighlight: (text) => accent(`\u001b[4m${text}\u001b[24m`)
+    };
+}
+export function getExplorerStyles() {
+    return resolveThemeName() === "light"
+        ? {
+            accent: { fg: "#006699", bold: true },
+            muted: { fg: "#666666" },
+            border: { fg: "#666666" },
+            borderFocused: { fg: "#006699", bold: true },
+            matchHighlight: { fg: "#006699", bold: true, underline: true },
+            tones: {
+                success: { fg: "#008800" },
+                warning: { fg: "#cc6600" },
+                error: { fg: "#cc0000" },
+                info: { fg: "#a200ff" },
+                muted: { fg: "#666666" }
+            }
+        }
+        : {
+            accent: { fg: "cyan", bold: true },
+            muted: { dim: true },
+            border: { dim: true },
+            borderFocused: { fg: "cyan", bold: true },
+            matchHighlight: { fg: "cyan", bold: true, underline: true },
+            tones: {
+                success: { fg: "green" },
+                warning: { fg: "yellow" },
+                error: { fg: "red" },
+                info: { fg: "magenta" },
+                muted: { dim: true }
+            }
+        };
+}
+function tonePainter(tone) {
+    const light = resolveThemeName() === "light";
+    if (tone === "success") {
+        return light ? hex(0, 136, 0) : ansi(32);
+    }
+    if (tone === "warning") {
+        return light ? hex(204, 102, 0) : ansi(33);
+    }
+    if (tone === "error") {
+        return light ? hex(204, 0, 0) : ansi(31);
+    }
+    if (tone === "info") {
+        return light ? hex(162, 0, 255) : ansi(35);
+    }
+    return muted;
+}
+function accent(text) {
+    return resolveThemeName() === "light" ? ansi(38, 2, 0, 102, 153, 1)(text) : ansi(36)(text);
+}
+function muted(text) {
+    return resolveThemeName() === "light" ? hex(102, 102, 102)(text) : ansi(2)(text);
+}
+function hex(red, green, blue) {
+    return ansi(38, 2, red, green, blue);
+}
+function ansi(...codes) {
+    return (text) => `\u001b[${codes.join(";")}m${text}\u001b[0m`;
+}
+function resolveThemeName(env = process.env) {
+    const raw = (env.POE_CODE_THEME ?? env.POE_THEME)?.toLowerCase();
+    if (raw === "light" || raw === "dark") {
+        return raw;
+    }
+    const apple = env.APPLE_INTERFACE_STYLE;
+    if (typeof apple === "string") {
+        return apple.toLowerCase() === "dark" ? "dark" : "light";
+    }
+    const vscodeKind = env.VSCODE_COLOR_THEME_KIND;
+    if (typeof vscodeKind === "string") {
+        const normalized = vscodeKind.toLowerCase();
+        if (normalized.includes("light")) {
+            return "light";
+        }
+        if (normalized.includes("dark")) {
+            return "dark";
+        }
+    }
+    const colorFGBG = env.COLORFGBG;
+    if (typeof colorFGBG === "string") {
+        const background = Number.parseInt(colorFGBG.split(";").at(-1) ?? "", 10);
+        if (Number.isFinite(background)) {
+            return background >= 8 ? "light" : "dark";
+        }
+    }
+    return "dark";
+}

package/node_modules/@poe-code/design-system/dist/index.d.ts

@@ -19,6 +19,9 @@ export * as acp from "./acp/index.js";
 export * as dashboard from "./dashboard/index.js";
 export { createDashboard, shouldUseInteractiveDashboard } from "./dashboard/index.js";
 export type { Dashboard, DashboardOptions } from "./dashboard/index.js";
+export * as explorer from "./explorer/index.js";
+export { runExplorer, singleDetail } from "./explorer/index.js";
+export type { Row, DetailItem, Detail, DetailCtx, Action, ActionContext, ExplorerConfig, Tone, } from "./explorer/index.js";
 export * as prompts from "./prompts/index.js";
 export { intro, introPlain, outro, note, select, multiselect, text as promptText, confirm, confirmOrCancel, password, spinner, withSpinner, isCancel, cancel, log, PromptCancelledError } from "./prompts/index.js";
 export type { SelectOptions, MultiselectOptions, TextOptions, ConfirmOptions, PasswordOptions, SpinnerOptions, WithSpinnerOptions } from "./prompts/index.js";

package/node_modules/@poe-code/design-system/dist/index.js

@@ -18,6 +18,9 @@ export * as acp from "./acp/index.js";
 // Dashboard
 export * as dashboard from "./dashboard/index.js";
 export { createDashboard, shouldUseInteractiveDashboard } from "./dashboard/index.js";
+// Explorer
+export * as explorer from "./explorer/index.js";
+export { runExplorer, singleDetail } from "./explorer/index.js";
 // Prompts
 export * as prompts from "./prompts/index.js";
 export { intro, introPlain, outro, note, select, multiselect, text as promptText, confirm, confirmOrCancel, password, spinner, withSpinner, isCancel, cancel, log, PromptCancelledError } from "./prompts/index.js";

package/node_modules/@poe-code/design-system/package.json

@@ -6,6 +6,7 @@
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
+    "postbuild": "node scripts/smoke-built-exports.cjs",
     "lint": "cd ../.. && eslint packages/design-system --ext ts && tsc -p packages/design-system/tsconfig.json --noEmit",
     "test": "cd ../.. && vitest run $(rg --files packages/design-system/src -g '*.test.ts' | sort | tr '\\n' ' ')",
     "demo": "tsx scripts/demo.ts",

package/node_modules/@poe-code/task-list/README.md

@@ -140,6 +140,104 @@ await project.move(created.id, { after: "42" });
 
 `gh-issues` exposes one list named `${project.owner}/${project.number}`. `create()` ignores `TaskCreate.id` because GitHub assigns issue numbers. `fire(state)` writes the Project v2 `Status` field to the matching single-select option. `move()` reorders project items.
 
+If the GitHub Project v2 board has not been set up manually, run `poe-code tasks sync <list>` before opening the backend. `openTaskList({ type: "gh-issues" })` no longer requires manual board setup when the board was provisioned with `tasks sync` first.
+
+## Verifying and provisioning the GitHub Project v2 board
+
+Use `verifyGhProject` to check whether a GitHub Project v2 board has the required Project and `Status` single-select options:
+
+```ts
+import { verifyGhProject } from "@poe-code/task-list";
+
+const report = await verifyGhProject({
+  owner: "octo-org",
+  number: 7,
+  requiredStates: ["queued", "agent-running", "human-review", "done", "failed", "archived"],
+  auth: { token: "github-token" }
+});
+```
+
+`VerifyGhProjectOptions` has this shape:
+
+```ts
+interface VerifyGhProjectOptions {
+  owner: string;
+  number: number;
+  requiredStates: readonly string[];
+  client?: GhClient;
+  fetch?: typeof fetch;
+  auth?: { token: string };
+}
+```
+
+`verifyGhProject` returns `Promise<VerifyGhProjectReport>`:
+
+```ts
+interface VerifyGhProjectReport {
+  ok: boolean;
+  project: { id: string; number: number; owner: string } | null;
+  statusField: { id: string; options: readonly string[] } | null;
+  missingProject: boolean;
+  missingStatusField: boolean;
+  missingOptions: readonly string[];
+}
+```
+
+Use `syncGhProject` to provision anything missing:
+
+```ts
+import { syncGhProject } from "@poe-code/task-list";
+
+const report = await syncGhProject({
+  owner: "octo-org",
+  number: 7,
+  requiredStates: ["queued", "agent-running", "human-review", "done", "failed", "archived"],
+  title: "Delivery Board",
+  yes: true,
+  auth: { token: "github-token" }
+});
+```
+
+`SyncGhProjectOptions` extends `VerifyGhProjectOptions`:
+
+```ts
+interface SyncGhProjectOptions extends VerifyGhProjectOptions {
+  title?: string;
+  yes?: boolean;
+}
+```
+
+`syncGhProject` returns `Promise<SyncGhProjectReport>`:
+
+```ts
+interface SyncGhProjectReport extends VerifyGhProjectReport {
+  created: readonly string[];
+  updated: readonly string[];
+}
+```
+
+The CLI exposes the same verification and provisioning flow:
+
+```sh
+poe-code tasks verify <list> --workflow ./WORKFLOW.md --repo octo-org/octo-repo --project octo-org/7 --states queued,agent-running,human-review,done,failed,archived --json
+poe-code tasks sync <list> --workflow ./WORKFLOW.md --repo octo-org/octo-repo --project octo-org/7 --states queued,agent-running,human-review,done,failed,archived --json --yes
+```
+
+`<list>` and `--project` both use `<owner>/<number>` project syntax. `--workflow` defaults to `./WORKFLOW.md`. `--repo` overrides the task repository from workflow frontmatter. `--states` overrides the required state list from workflow frontmatter. `--json` prints the report object as JSON. `--yes` confirms non-interactive sync; it is only used by `poe-code tasks sync`.
+
+| Option | Commands | Behavior |
+| --- | --- | --- |
+| `--workflow <path>` | `verify`, `sync` | Workflow file path. Defaults to `./WORKFLOW.md`. |
+| `--repo <owner/name>` | `verify`, `sync` | GitHub repository owner/name. |
+| `--project <owner/number>` | `verify`, `sync` | GitHub Project v2 owner/number. Overrides `<list>`. |
+| `--states <csv>` | `verify`, `sync` | Required task state names. |
+| `--json` | `verify`, `sync` | Prints the report as JSON. |
+| `--yes` | `sync` | Confirms non-interactive provisioning. |
+
+The `Status` field name and option names are matched case-sensitively. The field must be named `Status`, and required option names must match exactly. For example, `status` is treated as a missing field, and `Done` is treated as missing when the required state is `done`.
+
+In v1, if sync creates a new GitHub Project v2 board, the CLI prints the new project number and does not rewrite `WORKFLOW.md`. The operator must update `WORKFLOW.md` by hand with the printed `<owner>/<number>`.
+
 ## Notes
 
 The package never overwrites existing task files or store files. `defaults.metadata` is applied only when creating new tasks and does not retroactively update existing tasks.

package/node_modules/@poe-code/task-list/dist/backends/gh-issues-sync.d.ts

@@ -0,0 +1,46 @@
+import { type GhClient } from "./gh-issues-client.js";
+export interface VerifyGhProjectOptions {
+    owner: string;
+    number: number;
+    requiredStates: readonly string[];
+    client?: GhClient;
+    fetch?: typeof fetch;
+    auth?: {
+        token: string;
+    };
+}
+export interface VerifyGhProjectReport {
+    ok: boolean;
+    project: {
+        id: string;
+        number: number;
+        owner: string;
+    } | null;
+    statusField: {
+        id: string;
+        options: readonly string[];
+    } | null;
+    missingProject: boolean;
+    missingStatusField: boolean;
+    missingOptions: readonly string[];
+}
+export interface SyncGhProjectOptions extends VerifyGhProjectOptions {
+    title?: string;
+    yes?: boolean;
+}
+export interface SyncGhProjectReport extends VerifyGhProjectReport {
+    created: readonly string[];
+    updated: readonly string[];
+}
+export declare class GhProjectSyncError extends Error {
+    readonly op: "lookup" | "createProject" | "createField" | "createOption";
+    readonly target: string;
+    constructor(options: {
+        op: "lookup" | "createProject" | "createField" | "createOption";
+        target: string;
+        cause?: unknown;
+        message: string;
+    });
+}
+export declare function verifyGhProject(opts: VerifyGhProjectOptions): Promise<VerifyGhProjectReport>;
+export declare function syncGhProject(opts: SyncGhProjectOptions): Promise<SyncGhProjectReport>;

package/node_modules/@poe-code/task-list/dist/backends/gh-issues-sync.js

@@ -0,0 +1,309 @@
+import { PROJECT_ORGANIZATION_QUERY, PROJECT_USER_QUERY } from "./gh-issues.js";
+import { createGhClient } from "./gh-issues-client.js";
+const OWNER_ORGANIZATION_QUERY = `query ProjectOwner($owner: String!) {
+  organization(login: $owner) {
+    id
+  }
+}`;
+const OWNER_USER_QUERY = `query ProjectOwner($owner: String!) {
+  user(login: $owner) {
+    id
+  }
+}`;
+const CREATE_PROJECT_MUTATION = `mutation CreateProject($input: CreateProjectV2Input!) {
+  createProjectV2(input: $input) {
+    projectV2 {
+      id
+      number
+    }
+  }
+}`;
+const CREATE_STATUS_FIELD_MUTATION = `mutation CreateStatusField($input: CreateProjectV2FieldInput!) {
+  createProjectV2Field(input: $input) {
+    projectV2Field {
+      ... on ProjectV2SingleSelectField {
+        id
+        name
+        options { id name }
+      }
+    }
+  }
+}`;
+const CREATE_STATUS_OPTION_MUTATION = `mutation CreateStatusOption($input: CreateProjectV2SingleSelectFieldOptionInput!) {
+  createProjectV2SingleSelectFieldOption(input: $input) {
+    singleSelectFieldOption {
+      id
+      name
+    }
+  }
+}`;
+export class GhProjectSyncError extends Error {
+    op;
+    target;
+    constructor(options) {
+        super(options.message, { cause: options.cause });
+        this.name = "GhProjectSyncError";
+        this.op = options.op;
+        this.target = options.target;
+    }
+}
+export async function verifyGhProject(opts) {
+    const client = resolveGhClient(opts);
+    const target = `project:${opts.owner}/${opts.number}`;
+    const variables = {
+        owner: opts.owner,
+        number: opts.number
+    };
+    let project;
+    try {
+        const organizationResult = await client.graphql(PROJECT_ORGANIZATION_QUERY, variables);
+        project = organizationResult.organization?.projectV2 ?? null;
+        if (project === null) {
+            const userResult = await client.graphql(PROJECT_USER_QUERY, variables);
+            project = userResult.user?.projectV2 ?? null;
+        }
+    }
+    catch (error) {
+        throw new GhProjectSyncError({
+            op: "lookup",
+            target,
+            cause: error,
+            message: "lookup_failed"
+        });
+    }
+    if (project === null) {
+        return {
+            ok: false,
+            project: null,
+            statusField: null,
+            missingProject: true,
+            missingStatusField: true,
+            missingOptions: opts.requiredStates
+        };
+    }
+    const statusField = selectStatusField(project);
+    if (statusField === null) {
+        return {
+            ok: false,
+            project: {
+                id: project.id,
+                number: opts.number,
+                owner: opts.owner
+            },
+            statusField: null,
+            missingProject: false,
+            missingStatusField: true,
+            missingOptions: opts.requiredStates
+        };
+    }
+    const options = statusField.options.map((option) => option.name);
+    const missingOptions = opts.requiredStates.filter((state) => !options.includes(state));
+    return {
+        ok: missingOptions.length === 0,
+        project: {
+            id: project.id,
+            number: opts.number,
+            owner: opts.owner
+        },
+        statusField: {
+            id: statusField.id,
+            options
+        },
+        missingProject: false,
+        missingStatusField: false,
+        missingOptions
+    };
+}
+export async function syncGhProject(opts) {
+    const client = resolveGhClient(opts);
+    const verified = await verifyGhProject({ ...opts, client });
+    const created = [];
+    if (verified.ok) {
+        return {
+            ...verified,
+            created,
+            updated: []
+        };
+    }
+    let project = verified.project;
+    let statusField = verified.statusField;
+    let missingOptions = [...verified.missingOptions];
+    if (project === null) {
+        project = await createProject(client, opts);
+        created.push("project");
+        statusField = null;
+        missingOptions = [...opts.requiredStates];
+    }
+    if (statusField === null) {
+        const createdStatusField = await createStatusField(client, project.id);
+        statusField = createdStatusField;
+        created.push("field");
+        missingOptions = opts.requiredStates.filter((state) => !createdStatusField.options.includes(state));
+    }
+    if (missingOptions.length > 0) {
+        for (const optionName of missingOptions) {
+            await createStatusOption(client, statusField.id, optionName);
+            created.push(`option:${optionName}`);
+        }
+        statusField = {
+            id: statusField.id,
+            options: [...statusField.options, ...missingOptions]
+        };
+        missingOptions = [];
+    }
+    return {
+        ok: statusField !== null && missingOptions.length === 0,
+        project,
+        statusField,
+        missingProject: false,
+        missingStatusField: statusField === null,
+        missingOptions,
+        created,
+        updated: []
+    };
+}
+async function createProject(client, opts) {
+    const target = `${opts.owner}/${opts.number}`;
+    try {
+        const ownerId = await lookupOwnerId(client, opts.owner);
+        const result = await client.graphql(CREATE_PROJECT_MUTATION, {
+            input: {
+                ownerId,
+                title: opts.title ?? `${opts.owner}/${opts.number}`
+            }
+        });
+        const project = result.createProjectV2?.projectV2;
+        if (project === undefined || project === null) {
+            throw new Error("createProjectV2 returned no project");
+        }
+        return {
+            id: project.id,
+            number: project.number,
+            owner: opts.owner
+        };
+    }
+    catch (error) {
+        throw new GhProjectSyncError({
+            op: "createProject",
+            target,
+            cause: error,
+            message: errorMessage(error)
+        });
+    }
+}
+async function lookupOwnerId(client, owner) {
+    const organizationResult = await client.graphql(OWNER_ORGANIZATION_QUERY, {
+        owner
+    });
+    const organizationId = organizationResult.organization?.id;
+    if (organizationId !== undefined) {
+        return organizationId;
+    }
+    const userResult = await client.graphql(OWNER_USER_QUERY, {
+        owner
+    });
+    const userId = userResult.user?.id;
+    if (userId !== undefined) {
+        return userId;
+    }
+    throw new Error(`GitHub owner not found: ${owner}`);
+}
+async function createStatusField(client, projectId) {
+    try {
+        const result = await client.graphql(CREATE_STATUS_FIELD_MUTATION, {
+            input: {
+                projectId,
+                dataType: "SINGLE_SELECT",
+                name: "Status",
+                singleSelectOptions: []
+            }
+        });
+        const field = result.createProjectV2Field?.projectV2Field;
+        if (!isStatusField(field)) {
+            throw new Error("createProjectV2Field returned no Status field");
+        }
+        return {
+            id: field.id,
+            options: field.options.map((option) => option.name)
+        };
+    }
+    catch (error) {
+        throw new GhProjectSyncError({
+            op: "createField",
+            target: "Status",
+            cause: error,
+            message: errorMessage(error)
+        });
+    }
+}
+async function createStatusOption(client, fieldId, name) {
+    try {
+        await client.graphql(CREATE_STATUS_OPTION_MUTATION, {
+            input: {
+                fieldId,
+                name,
+                color: "GRAY"
+            }
+        });
+    }
+    catch (error) {
+        throw new GhProjectSyncError({
+            op: "createOption",
+            target: name,
+            cause: error,
+            message: errorMessage(error)
+        });
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function resolveGhClient(opts) {
+    if (opts.client !== undefined) {
+        return opts.client;
+    }
+    const token = opts.auth?.token;
+    if (token === undefined || token.length === 0) {
+        throw new GhProjectSyncError({
+            op: "lookup",
+            target: "auth",
+            message: "missing_auth"
+        });
+    }
+    return createGhClient({
+        token,
+        fetch: opts.fetch
+    });
+}
+function selectStatusField(project) {
+    const fields = project.fields?.nodes?.filter(isStatusField) ?? [];
+    const exactStatusField = fields.find((field) => field.name === "Status");
+    if (exactStatusField !== undefined) {
+        return exactStatusField;
+    }
+    if (isStatusField(project.field) && isExactStatusField(project.field)) {
+        return project.field;
+    }
+    return null;
+}
+function isExactStatusField(field) {
+    return field.name === undefined || field.name === "Status";
+}
+function isStatusOption(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "id" in value &&
+        typeof value.id === "string" &&
+        "name" in value &&
+        typeof value.name === "string");
+}
+function isStatusField(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "id" in value &&
+        typeof value.id === "string" &&
+        (!("name" in value) || typeof value.name === "string") &&
+        "options" in value &&
+        Array.isArray(value.options) &&
+        value.options.every(isStatusOption));
+}

package/node_modules/@poe-code/task-list/dist/backends/gh-issues.d.ts

@@ -1,4 +1,6 @@
 import type { TaskDefaults, TaskList } from "../types.js";
+export declare const PROJECT_ORGANIZATION_QUERY = "query Project($owner: String!, $number: Int!) {\n  organization(login: $owner) {\n    projectV2(number: $number) {\n      id\n      title\n      field(name: \"Status\") {\n        ... on ProjectV2SingleSelectField {\n          id\n          name\n          options { id name }\n        }\n      }\n      fields(first: 100) {\n        nodes {\n          ... on ProjectV2SingleSelectField {\n            id\n            name\n            options { id name }\n          }\n        }\n      }\n    }\n  }\n}";
+export declare const PROJECT_USER_QUERY = "query Project($owner: String!, $number: Int!) {\n  user(login: $owner) {\n    projectV2(number: $number) {\n      id\n      title\n      field(name: \"Status\") {\n        ... on ProjectV2SingleSelectField {\n          id\n          name\n          options { id name }\n        }\n      }\n      fields(first: 100) {\n        nodes {\n          ... on ProjectV2SingleSelectField {\n            id\n            name\n            options { id name }\n          }\n        }\n      }\n    }\n  }\n}";
 export interface GhIssuesBackendDeps {
     repo: string;
     project: {

package/node_modules/@poe-code/task-list/dist/backends/gh-issues.js

@@ -2,7 +2,7 @@ import { eventsFromState, findEvent } from "../state-machine.js";
 import { AnchorNotFoundError, InvalidTransitionError, OrderMismatchError, TaskNotFoundError } from "../types.js";
 import { createGhClient } from "./gh-issues-client.js";
 import { applyOrder, sortTasks } from "./utils.js";
-const PROJECT_ORGANIZATION_QUERY = `query Project($owner: String!, $number: Int!) {
+export const PROJECT_ORGANIZATION_QUERY = `query Project($owner: String!, $number: Int!) {
   organization(login: $owner) {
     projectV2(number: $number) {
       id
@@ -10,13 +10,23 @@ const PROJECT_ORGANIZATION_QUERY = `query Project($owner: String!, $number: Int!
       field(name: "Status") {
         ... on ProjectV2SingleSelectField {
           id
+          name
           options { id name }
         }
       }
+      fields(first: 100) {
+        nodes {
+          ... on ProjectV2SingleSelectField {
+            id
+            name
+            options { id name }
+          }
+        }
+      }
     }
   }
 }`;
-const PROJECT_USER_QUERY = `query Project($owner: String!, $number: Int!) {
+export const PROJECT_USER_QUERY = `query Project($owner: String!, $number: Int!) {
   user(login: $owner) {
     projectV2(number: $number) {
       id
@@ -24,9 +34,19 @@ const PROJECT_USER_QUERY = `query Project($owner: String!, $number: Int!) {
       field(name: "Status") {
         ... on ProjectV2SingleSelectField {
           id
+          name
           options { id name }
         }
       }
+      fields(first: 100) {
+        nodes {
+          ... on ProjectV2SingleSelectField {
+            id
+            name
+            options { id name }
+          }
+        }
+      }
     }
   }
 }`;