toolcraft-openapi 0.0.17 → 0.0.19

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

@@ -0,0 +1,39 @@
+export function resolveAction(state, keyEvent) {
+    const target = state.bindings.resolve(keyEvent);
+    if (target?.type !== "action") {
+        return null;
+    }
+    const actionState = state.actionState.get(target.id);
+    if (actionState?.available !== true ||
+        actionState.running === true ||
+        actionState.action === undefined) {
+        return null;
+    }
+    return actionState.action;
+}
+export function buildActionContext(state, _action, source, runtimeHandles, rowsOverride) {
+    const row = rowsOverride?.[0] ?? currentRow(state) ?? { id: "", title: "" };
+    return {
+        row,
+        rows: rowsOverride ?? selectedRows(state, row),
+        item: source === "detail" ? currentDetailItem(state) : undefined,
+        filter: state.filter,
+        refresh: runtimeHandles.refresh,
+        suspendAnd: runtimeHandles.suspendAnd,
+        toast: runtimeHandles.toast,
+        confirm: runtimeHandles.confirm,
+        exit: runtimeHandles.exit
+    };
+}
+function currentRow(state) {
+    return state.rows[state.filtered[state.cursor] ?? -1];
+}
+function currentDetailItem(state) {
+    return state.detail.items?.[state.detail.cursor];
+}
+function selectedRows(state, fallback) {
+    if (state.selected.size === 0) {
+        return fallback.id === "" ? [] : [fallback];
+    }
+    return state.rows.filter((row) => state.selected.has(row.id));
+}

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

@@ -0,0 +1,13 @@
+import type { ExplorerConfig } from "./state.js";
+type ExplorerDemoMode = "single-detail-mode" | "list-detail-mode";
+export interface ExplorerDemoOptions {
+    mode: ExplorerDemoMode;
+    slowDetail: boolean;
+}
+export interface BuildExplorerDemoConfigOptions extends ExplorerDemoOptions {
+    onReorder?: (orderedIds: string[]) => void | Promise<void>;
+}
+export declare function parseExplorerDemoOptions(argv?: string[], env?: NodeJS.ProcessEnv): ExplorerDemoOptions;
+export declare function buildExplorerDemoConfig(options: BuildExplorerDemoConfigOptions): ExplorerConfig<void>;
+export declare function main(): Promise<void>;
+export {};

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

@@ -0,0 +1,297 @@
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { runExplorer } from "./index.js";
+const detailDelayMs = 500;
+const truthyEnvValues = new Set(["1", "true", "yes", "on"]);
+const singleDetailRows = [
+    {
+        id: "configure-commands",
+        title: "Configure commands",
+        subtitle: "Provider config mutation flow",
+        badge: { text: "ready", tone: "success" },
+        group: "Planning"
+    },
+    {
+        id: "provider-boilerplate",
+        title: "Provider boilerplate audit",
+        subtitle: "Keep providers declarative and minimal",
+        badge: { text: "review", tone: "warning" },
+        group: "Planning"
+    },
+    {
+        id: "markdown-reader",
+        title: "Markdown reader",
+        subtitle: "Terminal-rendered plan preview",
+        badge: { text: "done", tone: "muted" },
+        group: "Docs"
+    },
+    {
+        id: "design-system-prompts",
+        title: "Design system prompts",
+        subtitle: "Prompt primitives owned by the package",
+        badge: { text: "active", tone: "info" },
+        group: "UI"
+    }
+];
+const singleDetailMarkdown = {
+    "configure-commands": [
+        "# Configure commands",
+        "",
+        "Provider configuration should be derived from declarative provider config.",
+        "",
+        "- Parse existing files with structured parsers.",
+        "- Deep merge edits instead of replacing user-owned configuration.",
+        "- Keep CLI and SDK arguments in parity."
+    ].join("\n"),
+    "provider-boilerplate": [
+        "# Provider boilerplate audit",
+        "",
+        "Adding a provider should mean adding one provider file. Everything else should come from the provider config.",
+        "",
+        "Avoid provider-specific branches in shared code paths."
+    ].join("\n"),
+    "markdown-reader": [
+        "# Markdown reader",
+        "",
+        "Render markdown plans with stable wrapping and predictable terminal styling.",
+        "",
+        "The reader is a display surface, not a planning store."
+    ].join("\n"),
+    "design-system-prompts": [
+        "# Design system prompts",
+        "",
+        "Prompt primitives belong in the design-system package so CLI surfaces share one style.",
+        "",
+        "Direct use of unrelated prompt libraries should stay out of consumers."
+    ].join("\n")
+};
+const reviewRows = [
+    {
+        id: "pr-1842",
+        title: "PR #1842 provider config parser",
+        subtitle: "3 unresolved comments by reviewbot",
+        badge: { text: "changes", tone: "warning" },
+        group: "Review queue"
+    },
+    {
+        id: "pr-1847",
+        title: "PR #1847 explorer TUI library",
+        subtitle: "2 comments, one destructive flow question",
+        badge: { text: "ready", tone: "success" },
+        group: "Review queue"
+    },
+    {
+        id: "pr-1851",
+        title: "PR #1851 markdown QA checklist",
+        subtitle: "1 docs-only note",
+        badge: { text: "docs", tone: "info" },
+        group: "Review queue"
+    }
+];
+const reviewComments = {
+    "pr-1842": [
+        {
+            id: "pr-1842-comment-1",
+            title: "Review: provider registry",
+            subtitle: "packages/providers/src/registry.ts:42",
+            body: "The provider data is already present in config. Derive the registry entry instead of repeating provider names here.",
+            tone: "warning"
+        },
+        {
+            id: "pr-1842-comment-2",
+            title: "Review: config merge",
+            subtitle: "packages/config-mutations/src/apply.ts:88",
+            body: "This should deep merge the parsed structure so user-owned fields remain intact.",
+            tone: "error"
+        },
+        {
+            id: "pr-1842-comment-3",
+            title: "Review: parser coverage",
+            subtitle: "packages/config-mutations/src/apply.test.ts:131",
+            body: "Add a fixture that proves comments and unknown keys survive the update path.",
+            tone: "info"
+        }
+    ],
+    "pr-1847": [
+        {
+            id: "pr-1847-comment-1",
+            title: "Review: detail loading",
+            subtitle: "packages/design-system/src/explorer/jobs.ts:19",
+            body: "The 150 ms loading threshold is the right behavior. This demo should make that visible with --slow-detail.",
+            tone: "success"
+        },
+        {
+            id: "pr-1847-comment-2",
+            title: "Review: destructive confirm",
+            subtitle: "packages/design-system/src/explorer/reducer.ts:435",
+            body: "Confirm modal behavior should be reachable from manual QA with a simple keybinding.",
+            tone: "warning"
+        }
+    ],
+    "pr-1851": [
+        {
+            id: "pr-1851-comment-1",
+            title: "Review: QA format",
+            subtitle: "docs/qa/explorer-tui-library.md",
+            body: "Keep this as a markdown checklist. Do not convert manual QA into a script.",
+            tone: "info"
+        }
+    ]
+};
+export function parseExplorerDemoOptions(argv = process.argv.slice(2), env = process.env) {
+    let mode = parseMode(env.EXPLORER_DEMO_MODE) ?? "single-detail-mode";
+    let slowDetail = isTruthy(env.EXPLORER_DEMO_SLOW_DETAIL);
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === "--slow-detail") {
+            slowDetail = true;
+            continue;
+        }
+        if (arg === "--single-detail-mode") {
+            mode = "single-detail-mode";
+            continue;
+        }
+        if (arg === "--list-detail-mode") {
+            mode = "list-detail-mode";
+            continue;
+        }
+        if (arg === "--mode") {
+            const next = argv[index + 1];
+            const parsed = parseMode(next);
+            if (parsed === undefined) {
+                throw new Error(`Unsupported explorer demo mode: ${next ?? ""}`);
+            }
+            mode = parsed;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--mode=")) {
+            const parsed = parseMode(arg.slice("--mode=".length));
+            if (parsed === undefined) {
+                throw new Error(`Unsupported explorer demo mode: ${arg.slice("--mode=".length)}`);
+            }
+            mode = parsed;
+        }
+    }
+    return { mode, slowDetail };
+}
+export function buildExplorerDemoConfig(options) {
+    const rows = options.mode === "single-detail-mode" ? singleDetailRows : reviewRows;
+    const detail = options.mode === "single-detail-mode"
+        ? buildSingleDetail(options.slowDetail)
+        : buildReviewDetail(options.slowDetail);
+    return {
+        title: `Explorer Demo - ${options.mode}`,
+        rows: async () => rows,
+        detail,
+        actions: demoActions(),
+        reorder: {
+            onReorder: options.onReorder ?? (() => undefined)
+        },
+        multiSelect: true,
+        emptyHint: "No rows match the current filter"
+    };
+}
+export async function main() {
+    const options = parseExplorerDemoOptions();
+    await runExplorer(buildExplorerDemoConfig(options));
+}
+function buildSingleDetail(slowDetail) {
+    return {
+        items: async (row, ctx) => {
+            await delayDetailIfNeeded(slowDetail, ctx);
+            const markdown = singleDetailMarkdown[row.id] ?? `# ${row.title}\n\nNo demo detail is available.`;
+            return [{ id: row.id, render: () => markdown }];
+        }
+    };
+}
+function buildReviewDetail(slowDetail) {
+    return {
+        items: async (row, ctx) => {
+            await delayDetailIfNeeded(slowDetail, ctx);
+            const comments = reviewComments[row.id] ?? [];
+            return comments.map((comment) => ({
+                id: comment.id,
+                title: comment.title,
+                subtitle: comment.subtitle,
+                badge: { text: "comment", tone: comment.tone },
+                render: () => comment.body
+            }));
+        },
+        actions: [
+            {
+                id: "resolve-comment",
+                label: "Resolve comment",
+                key: "x",
+                showInFooter: true,
+                handler: (ctx) => {
+                    ctx.toast(`Resolved ${ctx.item?.title ?? ctx.row.title}`, "success");
+                }
+            }
+        ]
+    };
+}
+function demoActions() {
+    return [
+        {
+            id: "open",
+            label: "Open",
+            primary: true,
+            showInFooter: true,
+            handler: (ctx) => {
+                ctx.toast(`Opened ${ctx.row.title}`, "info");
+            }
+        },
+        {
+            id: "refresh",
+            label: "Refresh",
+            key: "r",
+            showInFooter: true,
+            handler: async (ctx) => {
+                await ctx.refresh();
+                ctx.toast("Rows refreshed", "success");
+            }
+        },
+        {
+            id: "archive",
+            label: () => "Archive selected",
+            key: "a",
+            destructive: true,
+            showInFooter: true,
+            handler: (ctx) => {
+                ctx.toast(`Archived ${ctx.rows.length} row${ctx.rows.length === 1 ? "" : "s"}`, "warning");
+            }
+        }
+    ];
+}
+async function delayDetailIfNeeded(slowDetail, ctx) {
+    if (!slowDetail) {
+        return;
+    }
+    await new Promise((resolve) => {
+        const timeout = setTimeout(resolve, detailDelayMs);
+        ctx.signal.addEventListener("abort", () => {
+            clearTimeout(timeout);
+            resolve();
+        }, { once: true });
+    });
+}
+function parseMode(value) {
+    if (value === "single-detail-mode" || value === "list-detail-mode") {
+        return value;
+    }
+    return undefined;
+}
+function isTruthy(value) {
+    return value === undefined ? false : truthyEnvValues.has(value.toLowerCase());
+}
+const entry = process.argv[1];
+const isMain = typeof entry === "string" && path.resolve(entry) === fileURLToPath(import.meta.url);
+if (isMain) {
+    main().catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`${message}\n`);
+        process.exitCode = 1;
+    });
+}

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

@@ -0,0 +1,61 @@
+import type { KeypressEvent } from "../dashboard/terminal.js";
+import type { Action, DetailItem, Row } from "./state.js";
+export type Effect = {
+    type: "renderDetail";
+    rowId: string;
+    token: number;
+} | {
+    type: "exit";
+    result: unknown;
+    after?: () => Promise<void>;
+} | {
+    type: "suspend";
+    fn: () => Promise<unknown>;
+    resumeWith: (value: unknown) => ExplorerEvent;
+} | {
+    type: "persistOrder";
+    orderedIds: string[];
+};
+export type ExplorerEvent = {
+    type: "key";
+    key: KeypressEvent;
+} | {
+    type: "resize";
+    cols: number;
+    rows: number;
+} | {
+    type: "rowsLoaded";
+    rows: Row[];
+} | {
+    type: "detailLoading";
+    rowId: string;
+    token: number;
+} | {
+    type: "detailLoaded";
+    rowId: string;
+    token: number;
+    items: DetailItem[];
+} | {
+    type: "detailError";
+    rowId: string;
+    token: number;
+    error: Error;
+} | {
+    type: "actionResolved";
+    actionId: string;
+} | {
+    type: "toastExpired";
+} | {
+    type: "suspendResumed";
+    value: unknown;
+    emit: ExplorerEvent;
+} | {
+    type: "modalDismissed";
+    result: unknown;
+};
+export type ConfirmModal = {
+    kind: "confirm";
+    action: Action<unknown>;
+    rows: Row[];
+    resolver: (ok: boolean) => void;
+};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,10 @@
+import type { Row } from "./state.js";
+export interface FilterMatch {
+    index: number;
+    score: number;
+    positions: number[];
+}
+export interface FilterRowsOptions {
+    caseSensitive?: boolean;
+}
+export declare function filterRows(query: string, rows: readonly Row[], opts?: FilterRowsOptions): FilterMatch[];

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

@@ -0,0 +1,95 @@
+const MATCH_SCORE = 10;
+const CONSECUTIVE_BONUS = 14;
+const WORD_START_BONUS = 10;
+const EARLY_MATCH_BONUS = 3;
+export function filterRows(query, rows, opts = {}) {
+    if (query.length === 0) {
+        return rows.map((_, index) => ({ index, score: 0, positions: [] }));
+    }
+    const preparedQuery = opts.caseSensitive === true ? query : query.toLocaleLowerCase();
+    const matches = [];
+    rows.forEach((row, index) => {
+        const text = searchableText(row);
+        const preparedText = opts.caseSensitive === true ? text : text.toLocaleLowerCase();
+        const match = matchSubsequence(preparedQuery, preparedText);
+        if (match !== undefined) {
+            matches.push({ index, ...match });
+        }
+    });
+    return matches.sort((left, right) => right.score - left.score || left.index - right.index);
+}
+function searchableText(row) {
+    return [row.title, row.subtitle]
+        .filter((value) => value !== undefined)
+        .map(stripAnsi)
+        .join(" ");
+}
+function stripAnsi(value) {
+    return value.replace(/\u001b\[[0-9;]*m/g, "");
+}
+function matchSubsequence(query, text) {
+    let previousStates = [];
+    for (let queryIndex = 0; queryIndex < query.length; queryIndex += 1) {
+        const states = [];
+        for (let textIndex = 0; textIndex < text.length; textIndex += 1) {
+            if (text[textIndex] !== query[queryIndex]) {
+                continue;
+            }
+            if (queryIndex === 0) {
+                states[textIndex] = {
+                    score: characterScore(text, textIndex, undefined) + Math.max(0, EARLY_MATCH_BONUS - textIndex),
+                    positions: [textIndex]
+                };
+                continue;
+            }
+            for (let previousIndex = 0; previousIndex < textIndex; previousIndex += 1) {
+                const previous = previousStates[previousIndex];
+                if (previous === undefined) {
+                    continue;
+                }
+                const next = {
+                    score: previous.score + characterScore(text, textIndex, previousIndex),
+                    positions: [...previous.positions, textIndex]
+                };
+                if (isBetterMatch(next, states[textIndex])) {
+                    states[textIndex] = next;
+                }
+            }
+        }
+        previousStates = states;
+        if (!previousStates.some((state) => state !== undefined)) {
+            return undefined;
+        }
+    }
+    return previousStates.reduce((best, state) => (state !== undefined && isBetterMatch(state, best) ? state : best), undefined);
+}
+function characterScore(text, index, previousIndex) {
+    let score = MATCH_SCORE;
+    if (previousIndex !== undefined && index === previousIndex + 1) {
+        score += CONSECUTIVE_BONUS;
+    }
+    if (isWordStart(text, index)) {
+        score += WORD_START_BONUS;
+    }
+    return score;
+}
+function isBetterMatch(candidate, current) {
+    if (current === undefined || candidate.score !== current.score) {
+        return current === undefined || candidate.score > current.score;
+    }
+    for (let index = 0; index < candidate.positions.length; index += 1) {
+        const position = candidate.positions[index];
+        const currentPosition = current.positions[index] ?? Number.POSITIVE_INFINITY;
+        if (position !== currentPosition) {
+            return position < currentPosition;
+        }
+    }
+    return false;
+}
+function isWordStart(text, index) {
+    if (index === 0) {
+        return true;
+    }
+    const previous = text[index - 1];
+    return (previous === " " || previous === "-" || previous === "_" || previous === "/" || previous === ".");
+}

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

@@ -0,0 +1,8 @@
+import type { Detail, DetailCtx, Row } from "./state.js";
+export { runExplorer } from "./runtime.js";
+export { createInitialState } from "./state.js";
+export { resolveBindings } from "./keymap.js";
+export type { Effect, ExplorerEvent } from "./events.js";
+export type { BindingTarget, ExplorerBindingDefaults, ExplorerBuiltinCommand, ResolvedBindings } from "./keymap.js";
+export type { Action, ActionContext, Detail, DetailCtx, DetailItem, Dirty, ExplorerConfig, ExplorerLayoutMode, ExplorerSize, ExplorerState, Row, Tone } from "./state.js";
+export declare function singleDetail<R>(fn: (row: Row, ctx: DetailCtx) => string | Promise<string>): Detail<R>;

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

@@ -0,0 +1,8 @@
+export { runExplorer } from "./runtime.js";
+export { createInitialState } from "./state.js";
+export { resolveBindings } from "./keymap.js";
+export function singleDetail(fn) {
+    return {
+        items: async (row) => [{ id: row.id, render: ctx => fn(row, ctx) }]
+    };
+}

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

@@ -0,0 +1,7 @@
+import type { ExplorerEvent } from "./events.js";
+import type { DetailCtx, DetailItem } from "./state.js";
+export declare const LOADING_INDICATOR_MS = 150;
+export declare function createDetailJobs(emit: (event: ExplorerEvent) => void): {
+    schedule: (rowId: string, items: (ctx: DetailCtx) => Promise<DetailItem[]>, ctx: DetailCtx) => Promise<void>;
+    abort: () => void;
+};

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

@@ -0,0 +1,59 @@
+export const LOADING_INDICATOR_MS = 150;
+export function createDetailJobs(emit) {
+    let token = 0;
+    let current = null;
+    const abortedTokens = new Set();
+    return {
+        async schedule(rowId, items, ctx) {
+            if (current !== null) {
+                current.controller.abort();
+                clearTimeout(current.loadingTimer);
+            }
+            const nextToken = ++token;
+            const controller = new AbortController();
+            let finished = false;
+            const loadingTimer = setTimeout(() => {
+                if (!finished && !abortedTokens.has(nextToken)) {
+                    emit({ type: "detailLoading", rowId, token: nextToken });
+                }
+            }, LOADING_INDICATOR_MS);
+            current = { controller, loadingTimer, token: nextToken };
+            try {
+                const loadedItems = await items({ ...ctx, signal: controller.signal });
+                finished = true;
+                if (!abortedTokens.has(nextToken)) {
+                    emit({ type: "detailLoaded", rowId, token: nextToken, items: loadedItems });
+                }
+            }
+            catch (error) {
+                finished = true;
+                if (!abortedTokens.has(nextToken)) {
+                    emit({ type: "detailError", rowId, token: nextToken, error: toError(error) });
+                }
+            }
+            finally {
+                finished = true;
+                clearTimeout(loadingTimer);
+                abortedTokens.delete(nextToken);
+                if (current?.controller === controller) {
+                    current = null;
+                }
+            }
+        },
+        abort() {
+            if (current === null) {
+                return;
+            }
+            current.controller.abort();
+            clearTimeout(current.loadingTimer);
+            abortedTokens.add(current.token);
+            current = null;
+        }
+    };
+}
+function toError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    return new Error(String(error));
+}

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

@@ -0,0 +1,21 @@
+import type { ExplorerEvent } from "./events.js";
+import type { ExplorerConfig } from "./state.js";
+export type ExplorerBuiltinCommand = "quit" | "filter" | "help" | "palette" | "cursorUp" | "cursorDown" | "top" | "bottom" | "pageUp" | "pageDown" | "focusNext" | "escape" | "confirm" | "toggleSelect" | "selectAll" | "clearSelection" | "detailScrollDown" | "detailScrollUp" | "extendSelectionUp" | "extendSelectionDown" | "reorderUp" | "reorderDown";
+export type BindingTarget = {
+    type: "builtin";
+    id: ExplorerBuiltinCommand;
+} | {
+    type: "action";
+    id: string;
+};
+type ExplorerKeypressEvent = Extract<ExplorerEvent, {
+    type: "key";
+}>["key"];
+export interface ResolvedBindings {
+    bindings: ReadonlyMap<string, BindingTarget>;
+    keysByTarget: ReadonlyMap<string, readonly string[]>;
+    resolve: (event: ExplorerKeypressEvent) => BindingTarget | undefined;
+}
+export type ExplorerBindingDefaults = Partial<Record<ExplorerBuiltinCommand, string[]>>;
+export declare function resolveBindings<R>(config: ExplorerConfig<R>, defaults?: ExplorerBindingDefaults): ResolvedBindings;
+export {};