poe-code 3.0.196 → 3.0.198

package/packages/superintendent/dist/commands/superintendent-group.d.ts

@@ -0,0 +1,325 @@
+import { type BuilderGroupRunners } from "./builder-group.js";
+import { type InspectorGroupRunners } from "./inspector-group.js";
+import { type RunMcpCommandRunners } from "./run.js";
+export type ValidationProblem = {
+    level: "error" | "warning";
+    message: string;
+};
+export type ValidationResult = {
+    valid: boolean;
+    problems: ValidationProblem[];
+};
+export declare const validateCommand: import("toolcraft").Command<{
+    [x: string]: never;
+}, import("toolcraft-schema").ObjectSchema<{
+    readonly path: import("toolcraft-schema").StringSchema;
+}>, undefined, ValidationResult> & {
+    readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"validate", import("toolcraft-schema").ObjectSchema<{
+        readonly path: import("toolcraft-schema").StringSchema;
+    }>, ValidationResult, ("mcp" | "cli" | "sdk")[], undefined>;
+};
+export declare const superintendentGroup: import("toolcraft").Group<{
+    [x: string]: never;
+}> & {
+    readonly __agentKitGroupTypeInfo: import("toolcraft").GroupTypeInfo<{
+        [x: string]: never;
+    }, "superintendent", ((import("toolcraft").Group<{
+        [x: string]: never;
+    }> & {
+        readonly __agentKitGroupTypeInfo: import("toolcraft").GroupTypeInfo<{
+            [x: string]: never;
+        }, "builder", (import("toolcraft").Command<{
+            [x: string]: never;
+        }, import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+        }>, undefined, import("../index.js").BuilderResult> & {
+            readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
+                readonly path: import("toolcraft-schema").StringSchema;
+            }>, import("../index.js").BuilderResult, ("mcp" | "cli" | "sdk")[], undefined>;
+        })[], ("mcp" | "cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{
+        readonly agent: import("toolcraft-schema").StringSchema;
+        readonly scope: import("toolcraft-schema").EnumSchema<readonly ["local", "global"]>;
+    }>, undefined, {
+        agent: string;
+        scope: import("@poe-code/agent-skill-config").SkillScope;
+        skillPath: string;
+        planDirectory: string;
+        planDirectoryCreated: boolean;
+    }> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"install", import("toolcraft-schema").ObjectSchema<{
+            readonly agent: import("toolcraft-schema").StringSchema;
+            readonly scope: import("toolcraft-schema").EnumSchema<readonly ["local", "global"]>;
+        }>, {
+            agent: string;
+            scope: import("@poe-code/agent-skill-config").SkillScope;
+            skillPath: string;
+            planDirectory: string;
+            planDirectoryCreated: boolean;
+        }, ("cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Group<{
+        [x: string]: never;
+    }> & {
+        readonly __agentKitGroupTypeInfo: import("toolcraft").GroupTypeInfo<{
+            [x: string]: never;
+        }, "inspector", ((import("toolcraft").Command<{
+            [x: string]: never;
+        }, import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+        }>, undefined, {
+            name: string;
+            agent: string;
+            mode: string | undefined;
+        }[]> & {
+            readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"list", import("toolcraft-schema").ObjectSchema<{
+                readonly path: import("toolcraft-schema").StringSchema;
+            }>, {
+                name: string;
+                agent: string;
+                mode: string | undefined;
+            }[], ("mcp" | "cli" | "sdk")[], undefined>;
+        }) | (import("toolcraft").Command<{
+            [x: string]: never;
+        }, import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+            readonly name: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        }>, undefined, import("../index.js").InspectorResult[]> & {
+            readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
+                readonly path: import("toolcraft-schema").StringSchema;
+                readonly name: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            }>, import("../index.js").InspectorResult[], ("mcp" | "cli" | "sdk")[], undefined>;
+        }))[], ("mcp" | "cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{
+        readonly path: import("toolcraft-schema").StringSchema;
+        readonly reason: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    }>, undefined, {
+        path: string;
+        state: "completed";
+        reason: string | undefined;
+    }> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"complete", import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+            readonly reason: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        }>, {
+            path: string;
+            state: "completed";
+            reason: string | undefined;
+        }, ("mcp" | "cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{}>, undefined, {
+        planDirectory: string;
+    }> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"plan-path", import("toolcraft-schema").ObjectSchema<{}>, {
+            planDirectory: string;
+        }, ("cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{
+        readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+    }>, undefined, import("./run.js").SuperintendentRunCommandResult> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
+            readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+        }>, import("./run.js").SuperintendentRunCommandResult, ("cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{
+        readonly path: import("toolcraft-schema").StringSchema;
+    }>, undefined, ValidationResult> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"validate", import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+        }>, ValidationResult, ("mcp" | "cli" | "sdk")[], undefined>;
+    }))[], ("mcp" | "cli" | "sdk")[], undefined>;
+};
+export type SuperintendentMcpGroupRunners = RunMcpCommandRunners & BuilderGroupRunners & InspectorGroupRunners;
+export declare function createSuperintendentMcpGroup(runners?: SuperintendentMcpGroupRunners): import("toolcraft").Group<{
+    [x: string]: never;
+}> & {
+    readonly __agentKitGroupTypeInfo: import("toolcraft").GroupTypeInfo<{
+        [x: string]: never;
+    }, "superintendent", ((import("toolcraft").Group<{
+        [x: string]: never;
+    }> & {
+        readonly __agentKitGroupTypeInfo: import("toolcraft").GroupTypeInfo<{
+            [x: string]: never;
+        }, "builder", (import("toolcraft").Command<{
+            [x: string]: never;
+        }, import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+        }>, undefined, import("../index.js").BuilderResult> & {
+            readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
+                readonly path: import("toolcraft-schema").StringSchema;
+            }>, import("../index.js").BuilderResult, ("mcp" | "cli" | "sdk")[], undefined>;
+        })[], ("mcp" | "cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Group<{
+        [x: string]: never;
+    }> & {
+        readonly __agentKitGroupTypeInfo: import("toolcraft").GroupTypeInfo<{
+            [x: string]: never;
+        }, "inspector", ((import("toolcraft").Command<{
+            [x: string]: never;
+        }, import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+        }>, undefined, {
+            name: string;
+            agent: string;
+            mode: string | undefined;
+        }[]> & {
+            readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"list", import("toolcraft-schema").ObjectSchema<{
+                readonly path: import("toolcraft-schema").StringSchema;
+            }>, {
+                name: string;
+                agent: string;
+                mode: string | undefined;
+            }[], ("mcp" | "cli" | "sdk")[], undefined>;
+        }) | (import("toolcraft").Command<{
+            [x: string]: never;
+        }, import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+            readonly name: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        }>, undefined, import("../index.js").InspectorResult[]> & {
+            readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
+                readonly path: import("toolcraft-schema").StringSchema;
+                readonly name: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            }>, import("../index.js").InspectorResult[], ("mcp" | "cli" | "sdk")[], undefined>;
+        }))[], ("mcp" | "cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{
+        readonly path: import("toolcraft-schema").StringSchema;
+        readonly reason: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    }>, undefined, {
+        path: string;
+        state: "completed";
+        reason: string | undefined;
+    }> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"complete", import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+            readonly reason: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        }>, {
+            path: string;
+            state: "completed";
+            reason: string | undefined;
+        }, ("mcp" | "cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{
+        readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+    }>, undefined, import("./run.js").SuperintendentRunCommandResult> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
+            readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+        }>, import("./run.js").SuperintendentRunCommandResult, "mcp"[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{
+        readonly path: import("toolcraft-schema").StringSchema;
+    }>, undefined, ValidationResult> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"validate", import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+        }>, ValidationResult, ("mcp" | "cli" | "sdk")[], undefined>;
+    }))[], "mcp"[], undefined>;
+};
+export declare const superintendentMcpGroup: import("toolcraft").Group<{
+    [x: string]: never;
+}> & {
+    readonly __agentKitGroupTypeInfo: import("toolcraft").GroupTypeInfo<{
+        [x: string]: never;
+    }, "superintendent", ((import("toolcraft").Group<{
+        [x: string]: never;
+    }> & {
+        readonly __agentKitGroupTypeInfo: import("toolcraft").GroupTypeInfo<{
+            [x: string]: never;
+        }, "builder", (import("toolcraft").Command<{
+            [x: string]: never;
+        }, import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+        }>, undefined, import("../index.js").BuilderResult> & {
+            readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
+                readonly path: import("toolcraft-schema").StringSchema;
+            }>, import("../index.js").BuilderResult, ("mcp" | "cli" | "sdk")[], undefined>;
+        })[], ("mcp" | "cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Group<{
+        [x: string]: never;
+    }> & {
+        readonly __agentKitGroupTypeInfo: import("toolcraft").GroupTypeInfo<{
+            [x: string]: never;
+        }, "inspector", ((import("toolcraft").Command<{
+            [x: string]: never;
+        }, import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+        }>, undefined, {
+            name: string;
+            agent: string;
+            mode: string | undefined;
+        }[]> & {
+            readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"list", import("toolcraft-schema").ObjectSchema<{
+                readonly path: import("toolcraft-schema").StringSchema;
+            }>, {
+                name: string;
+                agent: string;
+                mode: string | undefined;
+            }[], ("mcp" | "cli" | "sdk")[], undefined>;
+        }) | (import("toolcraft").Command<{
+            [x: string]: never;
+        }, import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+            readonly name: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        }>, undefined, import("../index.js").InspectorResult[]> & {
+            readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
+                readonly path: import("toolcraft-schema").StringSchema;
+                readonly name: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            }>, import("../index.js").InspectorResult[], ("mcp" | "cli" | "sdk")[], undefined>;
+        }))[], ("mcp" | "cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{
+        readonly path: import("toolcraft-schema").StringSchema;
+        readonly reason: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    }>, undefined, {
+        path: string;
+        state: "completed";
+        reason: string | undefined;
+    }> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"complete", import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+            readonly reason: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        }>, {
+            path: string;
+            state: "completed";
+            reason: string | undefined;
+        }, ("mcp" | "cli" | "sdk")[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{
+        readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+    }>, undefined, import("./run.js").SuperintendentRunCommandResult> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
+            readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+        }>, import("./run.js").SuperintendentRunCommandResult, "mcp"[], undefined>;
+    }) | (import("toolcraft").Command<{
+        [x: string]: never;
+    }, import("toolcraft-schema").ObjectSchema<{
+        readonly path: import("toolcraft-schema").StringSchema;
+    }>, undefined, ValidationResult> & {
+        readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"validate", import("toolcraft-schema").ObjectSchema<{
+            readonly path: import("toolcraft-schema").StringSchema;
+        }>, ValidationResult, ("mcp" | "cli" | "sdk")[], undefined>;
+    }))[], "mcp"[], undefined>;
+};
+export declare function validateSuperintendentDocument(filePath: string, content: string): ValidationResult;

package/packages/superintendent/dist/commands/superintendent-group.js

@@ -0,0 +1,238 @@
+import { S, UserError, defineCommand, defineGroup } from "toolcraft";
+import { text } from "@poe-code/design-system";
+import { parseSuperintendentDoc } from "../document/parse.js";
+import { hasTaskBoard, parseTaskBoard } from "../document/tasks.js";
+import { builderGroup, createBuilderGroup } from "./builder-group.js";
+import { completeCommand } from "./complete.js";
+import { installCommand } from "./install.js";
+import { inspectorGroup, createInspectorGroup } from "./inspector-group.js";
+import { planPathCommand } from "./plan-path.js";
+import { runCommand, createRunMcpCommand } from "./run.js";
+const validateParams = S.Object({
+    path: S.String({ description: "Path to the superintendent markdown document" })
+});
+export const validateCommand = defineCommand({
+    name: "validate",
+    description: "Validate a superintendent markdown document.",
+    positional: ["path"],
+    params: validateParams,
+    scope: ["cli", "mcp", "sdk"],
+    handler: async ({ params, fs }) => {
+        const content = await readDocument(params.path, fs);
+        return validateSuperintendentDocument(params.path, content);
+    },
+    render: {
+        rich: (result, { logger }) => {
+            const errors = result.problems.filter((problem) => problem.level === "error");
+            const warnings = result.problems.filter((problem) => problem.level === "warning");
+            if (result.valid) {
+                logger.success("Superintendent document is valid.");
+            }
+            else {
+                logger.error(`Superintendent document is invalid (${errors.length} error${errors.length === 1 ? "" : "s"}).`);
+            }
+            if (warnings.length > 0) {
+                logger.warn(`${warnings.length} warning${warnings.length === 1 ? "" : "s"} found.`);
+            }
+            if (result.problems.length === 0) {
+                return;
+            }
+            logger.message(text.section("Problems:"));
+            for (const problem of result.problems) {
+                logger.message(`- ${capitalize(problem.level)}: ${problem.message}`);
+            }
+        },
+        markdown: (result) => renderValidationMarkdown(result),
+        json: (result) => result
+    }
+});
+export const superintendentGroup = defineGroup({
+    name: "superintendent",
+    description: "Superintendent workflow commands.",
+    scope: ["cli", "mcp", "sdk"],
+    children: [runCommand, validateCommand, completeCommand, installCommand, planPathCommand, builderGroup, inspectorGroup]
+});
+export function createSuperintendentMcpGroup(runners) {
+    return defineGroup({
+        name: "superintendent",
+        description: "Superintendent workflow commands.",
+        scope: ["mcp"],
+        children: [
+            createRunMcpCommand(runners),
+            validateCommand,
+            completeCommand,
+            createBuilderGroup(runners),
+            createInspectorGroup(runners)
+        ]
+    });
+}
+export const superintendentMcpGroup = createSuperintendentMcpGroup();
+export function validateSuperintendentDocument(filePath, content) {
+    const problems = [];
+    let document;
+    try {
+        document = parseSuperintendentDoc(filePath, content);
+    }
+    catch (error) {
+        problems.push({
+            level: "error",
+            message: readErrorMessage(error)
+        });
+        return toValidationResult(problems);
+    }
+    if (!hasTaskBoard(document.body)) {
+        problems.push({
+            level: "error",
+            message: 'Missing "## Task Board" section'
+        });
+    }
+    else {
+        try {
+            const taskBoard = parseTaskBoard(document.body);
+            if (taskBoard.tasks.length === 0) {
+                problems.push({
+                    level: "error",
+                    message: "Task Board must contain markdown checkbox items"
+                });
+            }
+        }
+        catch (error) {
+            problems.push({
+                level: "error",
+                message: readErrorMessage(error)
+            });
+        }
+    }
+    problems.push(...validatePromptVariables(document));
+    return toValidationResult(problems);
+}
+async function readDocument(filePath, fs) {
+    try {
+        return await fs.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (hasCode(error, "ENOENT")) {
+            throw new UserError(`Superintendent document not found: ${filePath}`);
+        }
+        throw error;
+    }
+}
+function validatePromptVariables(document) {
+    const allowedVariables = new Set([
+        "plan.path",
+        "builder.summary",
+        "builder.log",
+        "builder.log_path",
+        "superintendent.summary",
+        "superintendent.log_path",
+        "owner.feedback",
+        "owner.log_path"
+    ]);
+    for (const inspectorName of Object.keys(document.frontmatter.inspectors ?? {})) {
+        allowedVariables.add(`inspectors.${inspectorName}`);
+        allowedVariables.add(`inspector_logs.${inspectorName}`);
+    }
+    const problems = [];
+    for (const prompt of collectPrompts(document)) {
+        const seenUnknownVariables = new Set();
+        for (const variableName of scanPromptVariables(prompt.value)) {
+            if (allowedVariables.has(variableName) || seenUnknownVariables.has(variableName)) {
+                continue;
+            }
+            seenUnknownVariables.add(variableName);
+            problems.push({
+                level: "warning",
+                message: `Unknown prompt variable "${variableName}" in ${prompt.path}`
+            });
+        }
+    }
+    return problems;
+}
+function collectPrompts(document) {
+    const prompts = [
+        { path: "builder.prompt", value: document.frontmatter.builder.prompt },
+        {
+            path: "superintendent.prompt",
+            value: document.frontmatter.superintendent.prompt
+        },
+        { path: "owner.prompt", value: document.frontmatter.owner.prompt }
+    ];
+    for (const [name, inspector] of Object.entries(document.frontmatter.inspectors ?? {})) {
+        prompts.push({
+            path: `inspectors.${name}.prompt`,
+            value: inspector.prompt
+        });
+    }
+    return prompts;
+}
+function scanPromptVariables(prompt) {
+    const variables = [];
+    let index = 0;
+    while (index < prompt.length) {
+        const opening = prompt.indexOf("{{", index);
+        if (opening === -1) {
+            break;
+        }
+        const triple = prompt[opening + 2] === "{";
+        const closing = prompt.indexOf(triple ? "}}}" : "}}", opening + (triple ? 3 : 2));
+        if (closing === -1) {
+            break;
+        }
+        const rawToken = prompt.slice(opening + (triple ? 3 : 2), closing);
+        const variableName = normalizeMustacheToken(rawToken);
+        if (variableName !== undefined) {
+            variables.push(variableName);
+        }
+        index = closing + (triple ? 3 : 2);
+    }
+    return variables;
+}
+function normalizeMustacheToken(token) {
+    const trimmed = token.trim();
+    if (trimmed.length === 0) {
+        return undefined;
+    }
+    const prefix = trimmed[0];
+    if (prefix === undefined ||
+        prefix === "!" ||
+        prefix === "#" ||
+        prefix === "/" ||
+        prefix === ">" ||
+        prefix === "^" ||
+        prefix === "&") {
+        return undefined;
+    }
+    return trimmed;
+}
+function toValidationResult(problems) {
+    return {
+        valid: !problems.some((problem) => problem.level === "error"),
+        problems
+    };
+}
+function renderValidationMarkdown(result) {
+    const lines = [
+        "## Validation result",
+        "",
+        `- Status: ${result.valid ? "valid" : "invalid"}`,
+        `- Problems: ${result.problems.length}`
+    ];
+    if (result.problems.length === 0) {
+        return lines.join("\n");
+    }
+    lines.push("", "### Problems", "");
+    for (const problem of result.problems) {
+        lines.push(`- **${capitalize(problem.level)}:** ${problem.message}`);
+    }
+    return lines.join("\n");
+}
+function readErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function hasCode(error, code) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+function capitalize(value) {
+    const firstCharacter = value[0] ?? "";
+    return `${firstCharacter.toUpperCase()}${value.slice(1)}`;
+}

package/packages/superintendent/dist/config-scope.d.ts

@@ -0,0 +1,8 @@
+export declare const superintendentConfigScope: import("@poe-code/poe-code-config").ScopeDefinition<{
+    readonly tui: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly env: "POE_SUPERINTENDENT_TUI";
+        readonly doc: "Enable the Superintendent dashboard by default for terminal TTY runs";
+    };
+}>;

package/packages/superintendent/dist/config-scope.js

@@ -0,0 +1,9 @@
+import { defineScope } from "@poe-code/poe-code-config";
+export const superintendentConfigScope = defineScope("superintendent", {
+    tui: {
+        type: "boolean",
+        default: false,
+        env: "POE_SUPERINTENDENT_TUI",
+        doc: "Enable the Superintendent dashboard by default for terminal TTY runs"
+    }
+});

package/packages/superintendent/dist/direct-execution.d.ts

@@ -0,0 +1 @@
+export declare function isDirectExecution(moduleUrl: string, argv: string[]): Promise<boolean>;

package/packages/superintendent/dist/direct-execution.js

@@ -0,0 +1,20 @@
+import { realpath } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export async function isDirectExecution(moduleUrl, argv) {
+    const entryPoint = argv[1];
+    if (typeof entryPoint !== "string" || entryPoint.length === 0) {
+        return false;
+    }
+    try {
+        const modulePath = fileURLToPath(moduleUrl);
+        const [resolvedEntryPoint, resolvedModulePath] = await Promise.all([
+            realpath(path.resolve(entryPoint)),
+            realpath(modulePath)
+        ]);
+        return resolvedEntryPoint === resolvedModulePath;
+    }
+    catch {
+        return false;
+    }
+}

package/packages/superintendent/dist/document/parse.d.ts

@@ -0,0 +1,59 @@
+export type { TaskBoard, TaskItem } from "./tasks.js";
+type JsonSchemaType = "string" | "number" | "integer" | "boolean" | "array" | "object" | "null";
+type JsonSchema = {
+    $schema?: string;
+    $id?: string;
+    title?: string;
+    description?: string;
+    type?: JsonSchemaType | readonly JsonSchemaType[];
+    const?: unknown;
+    default?: unknown;
+    enum?: readonly unknown[];
+    minimum?: number;
+    exclusiveMinimum?: number;
+    minLength?: number;
+    minItems?: number;
+    items?: JsonSchema;
+    properties?: Record<string, JsonSchema>;
+    required?: readonly string[];
+    additionalProperties?: boolean | JsonSchema;
+};
+export type SuperintendentDoc = {
+    frontmatter: SuperintendentFrontmatter;
+    body: string;
+    filePath: string;
+};
+export type SuperintendentFrontmatter = {
+    kind: "superintendent";
+    version: number;
+    mcp?: Record<string, McpConfig>;
+    builder: AgentRoleConfig;
+    inspectors?: Record<string, AgentRoleConfig>;
+    superintendent: AgentRoleConfig;
+    owner: AgentRoleConfig;
+    max_rounds?: number;
+    status: StatusBlock;
+};
+export type AgentRoleConfig = {
+    agent: string;
+    mode?: string;
+    cwd?: string;
+    mcp?: Record<string, McpConfig>;
+    prompt: string;
+};
+export type McpConfig = {
+    command: string;
+    args?: string[];
+    timeout?: number;
+};
+export type StatusBlock = {
+    state: "in_progress" | "review" | "completed";
+    round: number;
+    review_turn: number;
+};
+export declare const superintendentDocumentSchemaId = "https://poe-platform.github.io/poe-code/schemas/plans/superintendent.schema.json";
+export declare const superintendentBaseDocumentSchemaId = "https://poe-platform.github.io/poe-code/schemas/plans/superintendent-base.schema.json";
+export declare const superintendentDocumentSchema: JsonSchema;
+export declare const superintendentBaseDocumentSchema: JsonSchema;
+export declare function parseSuperintendentDoc(filePath: string, content: string): SuperintendentDoc;
+export declare function readExplicitBuilderAgent(filePath: string, content: string): string | undefined;