@jterrats/open-orchestra 0.3.1 → 0.4.1

package/dist/runtime-execution-adapters.js

@@ -0,0 +1,163 @@
+export const runtimeExecutionAdapters = [
+    {
+        id: "claude-cli",
+        target: "claude",
+        label: "Claude CLI",
+        kind: "cli",
+        summary: "Use the authenticated Claude CLI session as the executor.",
+        execution: {
+            nonInteractive: false,
+            promptInjection: true,
+            structuredOutput: false,
+            fileEdits: true,
+            testExecution: true,
+            evidenceReturn: true,
+            requiresTty: true,
+            requiresUserApproval: true,
+            resumeSession: true,
+        },
+        subagents: {
+            runtimeNative: true,
+            parallel: true,
+            namedRoles: true,
+            forkedContext: true,
+            structuredHandoff: true,
+            fileOwnership: true,
+            requiresParentApproval: true,
+        },
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Render a task brief or delegation packet and let Claude CLI execute with its active auth/session.",
+    },
+    {
+        id: "codex-cli",
+        target: "codex",
+        label: "Codex CLI",
+        kind: "cli",
+        summary: "Use the authenticated Codex CLI session as the executor.",
+        execution: {
+            nonInteractive: false,
+            promptInjection: true,
+            structuredOutput: false,
+            fileEdits: true,
+            testExecution: true,
+            evidenceReturn: true,
+            requiresTty: true,
+            requiresUserApproval: true,
+            resumeSession: true,
+        },
+        subagents: {
+            runtimeNative: true,
+            parallel: true,
+            namedRoles: true,
+            forkedContext: true,
+            structuredHandoff: true,
+            fileOwnership: true,
+            requiresParentApproval: true,
+        },
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Render a task brief or delegation packet for Codex to execute locally without vendor API keys in Orchestra.",
+    },
+    {
+        id: "cursor-cli",
+        target: "cursor",
+        label: "Cursor CLI",
+        kind: "cli",
+        summary: "Use Cursor's agent runtime when available.",
+        execution: runtimeExecutionCapabilities({ resumeSession: false }),
+        subagents: runtimeSubagentCapabilities({ forkedContext: false }),
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Render Cursor-oriented packets and keep execution inside the active Cursor runtime.",
+    },
+    {
+        id: "vscode-agent",
+        target: "vscode",
+        label: "VS Code Agent",
+        kind: "ide",
+        summary: "Use a VS Code agent extension/runtime as the executor.",
+        execution: runtimeExecutionCapabilities({
+            structuredOutput: true,
+            requiresTty: false,
+            resumeSession: false,
+        }),
+        subagents: runtimeSubagentCapabilities({
+            runtimeNative: false,
+            parallel: false,
+            forkedContext: false,
+        }),
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Expose structured delegation packets for VS Code extensions; do not fall back to vendor APIs automatically.",
+    },
+    {
+        id: "windsurf-agent",
+        target: "windsurf",
+        label: "Windsurf Agent",
+        kind: "ide",
+        summary: "Use the active Windsurf agent runtime as the executor.",
+        execution: runtimeExecutionCapabilities({
+            requiresTty: false,
+            resumeSession: false,
+        }),
+        subagents: runtimeSubagentCapabilities({ forkedContext: false }),
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Render Windsurf-oriented runtime packets and keep execution inside Windsurf.",
+    },
+    {
+        id: "generic-runtime",
+        target: "generic",
+        label: "Generic Runtime",
+        kind: "llm",
+        summary: "Produce portable briefs for a runtime with unknown execution hooks.",
+        execution: {
+            nonInteractive: false,
+            promptInjection: false,
+            structuredOutput: false,
+            fileEdits: false,
+            testExecution: false,
+            evidenceReturn: false,
+            requiresTty: false,
+            requiresUserApproval: true,
+            resumeSession: false,
+        },
+        subagents: runtimeSubagentCapabilities({
+            runtimeNative: false,
+            parallel: false,
+            namedRoles: false,
+            forkedContext: false,
+        }),
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Render a portable brief only. Ask the user before any runtime-specific or API-backed execution.",
+    },
+];
+function runtimeExecutionCapabilities(overrides = {}) {
+    return {
+        nonInteractive: false,
+        promptInjection: true,
+        structuredOutput: false,
+        fileEdits: true,
+        testExecution: true,
+        evidenceReturn: true,
+        requiresTty: true,
+        requiresUserApproval: true,
+        resumeSession: true,
+        ...overrides,
+    };
+}
+function runtimeSubagentCapabilities(overrides = {}) {
+    return {
+        runtimeNative: true,
+        parallel: true,
+        namedRoles: true,
+        forkedContext: true,
+        structuredHandoff: true,
+        fileOwnership: true,
+        requiresParentApproval: true,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=runtime-execution-adapters.js.map

package/dist/runtime-execution-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-execution-adapters.js","sourceRoot":"","sources":["../src/runtime-execution-adapters.ts"],"names":[],"mappings":"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"}

package/dist/runtime-execution-renderer.d.ts

@@ -0,0 +1,10 @@
+import type { RuntimeDelegationAssignment, RuntimeDelegationPacket, RuntimeExecutionAdapter, Task, TaskContext } from "./types.js";
+export declare function runtimeBriefContent(context: TaskContext, runtime: RuntimeExecutionAdapter): string;
+export declare function runtimeDelegationContent({ context, runtime, assignments, mode, allowDirectProviderApi, }: {
+    context: TaskContext;
+    runtime: RuntimeExecutionAdapter;
+    assignments: RuntimeDelegationAssignment[];
+    mode: RuntimeDelegationPacket["mode"];
+    allowDirectProviderApi: boolean;
+}): string;
+export declare function delegationAssignment(role: string, task: Task): RuntimeDelegationAssignment;

package/dist/runtime-execution-renderer.js

@@ -0,0 +1,110 @@
+const DEFAULT_ALLOWED_COMMANDS = [
+    "npm run format",
+    "npm run build",
+    "npm run precommit",
+];
+export function runtimeBriefContent(context, runtime) {
+    const task = context.task;
+    return [
+        `# Runtime Execution Brief: ${task.id}`,
+        "",
+        `- Runtime: ${runtime.label} (${runtime.id})`,
+        `- Owner role: ${task.ownerRole}`,
+        "- Mode: brief-only",
+        "- Direct provider API calls: forbidden",
+        "",
+        "## Goal",
+        task.goal ?? task.title,
+        "",
+        "## Scope",
+        task.scope ?? "Use the task paths and acceptance criteria as scope.",
+        "",
+        "## Paths",
+        ...listOrNone(task.paths),
+        "",
+        "## Acceptance Criteria",
+        ...listOrNone(task.acceptanceCriteria),
+        "",
+        "## Required Workflow",
+        "- Load Orchestra context before editing.",
+        "- Respect locks and file ownership.",
+        "- Make code changes locally in this workspace.",
+        "- Run focused tests first, then `npm run precommit` before handoff.",
+        "- Record evidence and handoff back to Orchestra.",
+        "- Use `orchestra commands manifest --json` for supported commands and flags.",
+        "",
+        "## Selected Skills",
+        ...skillLines(context),
+        "",
+        "## Active Locks",
+        ...lockLines(context),
+        "",
+        "## Delegation Decision",
+        ...delegationLines(context),
+        "",
+        "## Runtime Guidance",
+        runtime.guidance,
+    ].join("\n");
+}
+export function runtimeDelegationContent({ context, runtime, assignments, mode, allowDirectProviderApi, }) {
+    return [
+        `# Runtime Subagent Delegation Packet: ${context.task.id}`,
+        "",
+        `- Runtime: ${runtime.label} (${runtime.id})`,
+        `- Delegation mode: ${mode}`,
+        `- Runtime-native subagents supported: ${runtime.subagents.runtimeNative}`,
+        `- Direct provider API calls allowed: ${allowDirectProviderApi}`,
+        "",
+        "## Parent Task",
+        context.task.goal ?? context.task.title,
+        "",
+        "## Subagent Assignments",
+        ...assignments.flatMap((assignment) => [
+            `### ${assignment.role}`,
+            `- Ownership paths: ${assignment.paths.join(", ") || "none declared"}`,
+            `- Allowed commands: ${assignment.allowedCommands.join(", ")}`,
+            `- Expected artifacts: ${assignment.expectedArtifacts.join(", ")}`,
+            "- Handoff must include touched files, evidence, risks, and remaining work.",
+            "",
+        ]),
+        "## Guardrails",
+        "- Do not call OpenAI, Anthropic, or other vendor APIs from Orchestra for this delegation.",
+        "- Use the active runtime's own authenticated agent/subagent mechanism.",
+        "- If runtime-native delegation is unsupported, stop at this packet and ask the user for approval.",
+        "- Avoid overlapping writes; respect ownership paths and active locks.",
+        "- Use `orchestra commands manifest --json` for supported commands and flags.",
+    ].join("\n");
+}
+export function delegationAssignment(role, task) {
+    return {
+        role,
+        paths: task.paths ?? [],
+        allowedCommands: DEFAULT_ALLOWED_COMMANDS,
+        expectedArtifacts: ["code diff", "test evidence", "handoff notes"],
+    };
+}
+function listOrNone(items) {
+    if (!items || items.length === 0)
+        return ["- none declared"];
+    return items.map((item) => `- ${item}`);
+}
+function skillLines(context) {
+    if (context.skills.selected.length === 0)
+        return ["- none selected"];
+    return context.skills.selected.map((item) => `- ${item.skill.id}: ${item.rationale.join("; ")}`);
+}
+function lockLines(context) {
+    if (context.locks.length === 0)
+        return ["- none active"];
+    return context.locks.map((lock) => `- ${lock.id}: ${lock.path} owned by ${lock.ownerRole} for ${lock.taskId}`);
+}
+function delegationLines(context) {
+    if (!context.delegation)
+        return ["- no recorded delegation decision"];
+    return [
+        `- Recommendation: ${context.delegation.recommendation}`,
+        `- Disjoint write scopes: ${context.delegation.disjointWriteScopes}`,
+        ...context.delegation.delegates.map((delegate) => `- ${delegate.role}: ${delegate.mode} over ${delegate.writeScopes.join(", ") || "no declared scope"}`),
+    ];
+}
+//# sourceMappingURL=runtime-execution-renderer.js.map

package/dist/runtime-execution-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-execution-renderer.js","sourceRoot":"","sources":["../src/runtime-execution-renderer.ts"],"names":[],"mappings":"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"}

package/dist/runtime-execution.d.ts

@@ -0,0 +1,27 @@
+import type { RuntimeBrief, RuntimeDelegationPacket, RuntimeSelection } from "./types.js";
+export interface RuntimeSelectionInput {
+    taskId: string;
+    role?: string;
+    runtime?: string;
+    root?: string;
+}
+export declare function selectRuntimeExecutionAdapter({ taskId, role, runtime, root, }: RuntimeSelectionInput): Promise<RuntimeSelection>;
+export declare function renderRuntimeBrief({ taskId, runtime, root, }: {
+    taskId: string;
+    runtime?: string;
+    root?: string;
+}): Promise<RuntimeBrief>;
+export declare function renderRuntimeDelegationPacket({ taskId, runtime, roles, root, }: {
+    taskId: string;
+    runtime?: string;
+    roles: string[];
+    root?: string;
+}): Promise<RuntimeDelegationPacket>;
+export declare function recordRuntimeHandoff({ taskId, runtime, artifact, summary, sessionId, root, }: {
+    taskId: string;
+    runtime: string;
+    artifact?: string;
+    summary?: string;
+    sessionId?: string;
+    root?: string;
+}): Promise<import("./types.js").EventEntry>;

package/dist/runtime-execution.js

@@ -0,0 +1,147 @@
+import path from "node:path";
+import { getRuntimeExecutionAdapter, parseRuntimeExecutionId, } from "./runtime-adapters.js";
+import { appendEvent, writeArtifact } from "./workspace.js";
+import { getTaskContext, getWorkflowConfig } from "./workflow-services.js";
+import { delegationAssignment, runtimeBriefContent, runtimeDelegationContent, } from "./runtime-execution-renderer.js";
+export async function selectRuntimeExecutionAdapter({ taskId, role, runtime, root = process.cwd(), }) {
+    const config = await getWorkflowConfig(root);
+    const policy = normalizedRuntimePolicy(config.runtimePolicy);
+    if (runtime) {
+        return selection(taskId, role ?? "parent", parseRuntimeExecutionId(runtime), "explicit");
+    }
+    const taskExecutor = policy.byTask[taskId]?.executor;
+    if (taskExecutor) {
+        return selection(taskId, role ?? "parent", taskExecutor, "task");
+    }
+    if (role && policy.byRole[role]?.executor) {
+        return selection(taskId, role, policy.byRole[role].executor, "role");
+    }
+    const defaultExecutor = policy.defaults?.executor ?? "generic-runtime";
+    return selection(taskId, role ?? "parent", defaultExecutor, "default");
+}
+export async function renderRuntimeBrief({ taskId, runtime, root = process.cwd(), }) {
+    const context = await getTaskContext(taskId, root);
+    const runtimeOption = runtime ? { runtime } : {};
+    const selected = await selectRuntimeExecutionAdapter({
+        taskId,
+        role: context.task.ownerRole,
+        root,
+        ...runtimeOption,
+    });
+    const content = runtimeBriefContent(context, selected.runtime);
+    const artifact = await writeArtifact(root, "runs", `${taskId}-runtime-${selected.runtime.id}-brief.md`, content);
+    await appendEvent(root, {
+        type: "RUNTIME_EXECUTION_BRIEF_RENDERED",
+        taskId,
+        actor: "parent",
+        summary: `Runtime brief rendered: ${selected.runtime.id}`,
+        artifacts: [artifact],
+        metadata: {
+            runtime: selected.runtime.id,
+            selectionSource: selected.source,
+            directProviderApiAllowed: false,
+        },
+    });
+    return {
+        taskId,
+        runtime: selected.runtime.id,
+        artifact,
+        content,
+        mode: "brief-only",
+        directProviderApiAllowed: false,
+    };
+}
+export async function renderRuntimeDelegationPacket({ taskId, runtime, roles, root = process.cwd(), }) {
+    const context = await getTaskContext(taskId, root);
+    const runtimeOption = runtime ? { runtime } : {};
+    const selected = await selectRuntimeExecutionAdapter({
+        taskId,
+        role: context.task.ownerRole,
+        root,
+        ...runtimeOption,
+    });
+    const config = await getWorkflowConfig(root);
+    const policy = normalizedRuntimePolicy(config.runtimePolicy);
+    const assignments = roles.map((role) => delegationAssignment(role, context.task));
+    const mode = selected.runtime.subagents.runtimeNative
+        ? policy.delegation.mode
+        : "brief-only";
+    const content = runtimeDelegationContent({
+        context,
+        runtime: selected.runtime,
+        assignments,
+        mode,
+        allowDirectProviderApi: policy.delegation.allowDirectProviderApi,
+    });
+    const artifact = await writeArtifact(root, "runs", `${taskId}-runtime-${selected.runtime.id}-delegation.md`, content);
+    await appendEvent(root, {
+        type: "RUNTIME_DELEGATION_PACKET_RENDERED",
+        taskId,
+        actor: "parent",
+        summary: `Runtime delegation packet rendered: ${selected.runtime.id}`,
+        artifacts: [artifact],
+        metadata: {
+            runtime: selected.runtime.id,
+            mode,
+            roles,
+            directProviderApiAllowed: false,
+            runtimeNativeSupported: selected.runtime.subagents.runtimeNative,
+        },
+    });
+    return {
+        taskId,
+        runtime: selected.runtime.id,
+        artifact,
+        content,
+        mode,
+        directProviderApiAllowed: false,
+        assignments,
+        requiresApproval: !selected.runtime.subagents.runtimeNative,
+    };
+}
+export async function recordRuntimeHandoff({ taskId, runtime, artifact, summary, sessionId, root = process.cwd(), }) {
+    const runtimeId = parseRuntimeExecutionId(runtime);
+    if (artifact)
+        assertWorkflowArtifactPath(artifact);
+    return appendEvent(root, {
+        type: "RUNTIME_EXECUTION_HANDOFF_RECORDED",
+        taskId,
+        actor: "parent",
+        summary: summary ?? `Runtime execution handoff recorded: ${runtimeId}`,
+        artifacts: artifact ? [artifact] : [],
+        metadata: {
+            runtime: runtimeId,
+            ...(sessionId ? { sessionId } : {}),
+            directProviderApiAllowed: false,
+        },
+    });
+}
+function selection(taskId, role, runtimeId, source) {
+    return {
+        taskId,
+        role,
+        runtime: getRuntimeExecutionAdapter(runtimeId),
+        source,
+        directProviderApiAllowed: false,
+    };
+}
+function normalizedRuntimePolicy(policy) {
+    return {
+        defaults: policy?.defaults ?? { executor: "generic-runtime" },
+        byRole: policy?.byRole ?? {},
+        byTask: policy?.byTask ?? {},
+        delegation: {
+            mode: policy?.delegation?.mode ?? "runtime-native",
+            allowDirectProviderApi: policy?.delegation?.allowDirectProviderApi ?? false,
+        },
+    };
+}
+function assertWorkflowArtifactPath(artifact) {
+    const normalized = path.normalize(artifact);
+    if (normalized.startsWith("..") ||
+        path.isAbsolute(normalized) ||
+        !normalized.startsWith(".agent-workflow")) {
+        throw new Error("runtime artifact must be workspace workflow-local");
+    }
+}
+//# sourceMappingURL=runtime-execution.js.map

package/dist/runtime-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-execution.js","sourceRoot":"","sources":["../src/runtime-execution.ts"],"names":[],"mappings":"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"}

package/dist/skills-commands.d.ts

@@ -0,0 +1,9 @@
+import type { CliIo, CliOptions } from "./types.js";
+export declare function skillsValidateCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function sourcesListCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function lessonsListCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function lessonsAddCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function lessonsPromoteCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function skillsListCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function skillsPlanCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function skillsRenderCommand(options: CliOptions, io: CliIo): Promise<void>;

package/dist/skills-commands.js

@@ -0,0 +1,130 @@
+import { requireArg } from "./args.js";
+import { parseCsv, removeUndefined, stringOption } from "./command-utils.js";
+import { parseRuntimeTarget } from "./runtime-adapters.js";
+import { addAgentLesson, listAgentLessons, listSkills, planSkillsForTask, promoteAgentLessons, readSourceOfTruth, recordSkillPlan, recordSkillRender, renderSkills, validateSkills, } from "./skills.js";
+export async function skillsValidateCommand(options, io) {
+    const report = await validateSkills();
+    if (options.json) {
+        io.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        io.log(report.valid ? "Skills valid" : "Skills invalid");
+        for (const error of report.errors) {
+            io.log(`ERROR: ${error}`);
+        }
+        for (const warning of report.warnings) {
+            io.log(`WARN: ${warning}`);
+        }
+    }
+    if (!report.valid) {
+        throw new Error("skills validation failed");
+    }
+}
+export async function sourcesListCommand(options, io) {
+    const sources = await readSourceOfTruth();
+    if (options.json) {
+        io.log(JSON.stringify(sources, null, 2));
+        return;
+    }
+    for (const source of sources) {
+        io.log(`${source.id ?? "unknown"} - ${source.name ?? "Unnamed source"}`);
+        io.log(`  ${(source.locations ?? []).join(", ")}`);
+    }
+}
+export async function lessonsListCommand(options, io) {
+    const lessons = await listAgentLessons();
+    if (options.json) {
+        io.log(JSON.stringify(lessons, null, 2));
+        return;
+    }
+    if (lessons.length === 0) {
+        io.log("No lessons");
+        return;
+    }
+    for (const lesson of lessons) {
+        io.log(`${lesson.timestamp} ${lesson.operation}: ${lesson.errorSignature}`);
+    }
+}
+export async function lessonsAddCommand(options, io) {
+    const lesson = await addAgentLesson(removeUndefined({
+        taskId: stringOption(options.task),
+        actor: stringOption(options.actor) ?? "parent",
+        operation: requireArg(options, "operation"),
+        failedAction: requireArg(options, "failed-action"),
+        errorSignature: requireArg(options, "error-signature"),
+        rootCause: requireArg(options, "root-cause"),
+        fix: requireArg(options, "fix"),
+        prevention: requireArg(options, "prevention"),
+        appliesTo: parseCsv(options["applies-to"]),
+        verifiedBy: parseCsv(options["verified-by"]),
+    }));
+    if (options.json) {
+        io.log(JSON.stringify(lesson, null, 2));
+        return;
+    }
+    io.log(`Recorded lesson ${lesson.errorSignature}`);
+}
+export async function lessonsPromoteCommand(options, io) {
+    const result = await promoteAgentLessons(removeUndefined({
+        to: parsePromotionTarget(stringOption(options.to) ?? "doc"),
+        filter: stringOption(options.filter),
+    }));
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    io.log(`Created ${result.artifact}`);
+    io.log(`Promoted lessons: ${result.lessons.length}`);
+}
+export async function skillsListCommand(options, io) {
+    const skills = listSkills();
+    if (options.json) {
+        io.log(JSON.stringify(skills, null, 2));
+        return;
+    }
+    for (const skill of skills) {
+        io.log(`${skill.id} - ${skill.name} (${skill.loadBudget})`);
+        io.log(`  ${skill.summary}`);
+        io.log(`  sources: ${skill.sourceGroups.join(", ")}`);
+    }
+}
+export async function skillsPlanCommand(options, io) {
+    const plan = await planSkillsForTask(requireArg(options, "task"));
+    await recordSkillPlan(plan);
+    if (options.json) {
+        io.log(JSON.stringify(plan, null, 2));
+        return;
+    }
+    io.log(`Skills for ${plan.taskId}:`);
+    for (const item of plan.selected) {
+        io.log(`  ${item.skill.id} (score ${item.score})`);
+        for (const reason of item.rationale) {
+            io.log(`    - ${reason}`);
+        }
+    }
+    io.log(`Source groups: ${plan.sourceGroups.join(", ")}`);
+}
+export async function skillsRenderCommand(options, io) {
+    const target = parseSkillRenderTarget(stringOption(options.target) ?? "generic");
+    const rendered = await renderSkills({
+        target,
+        taskId: stringOption(options.task),
+        skillIds: parseCsv(options.skills),
+    });
+    await recordSkillRender(rendered);
+    if (options.json) {
+        io.log(JSON.stringify(rendered, null, 2));
+        return;
+    }
+    io.log(rendered.content);
+}
+function parsePromotionTarget(value) {
+    if (["skill", "rule", "doc"].includes(value)) {
+        return value;
+    }
+    throw new Error(`unknown promotion target: ${value}`);
+}
+function parseSkillRenderTarget(value) {
+    return parseRuntimeTarget(value);
+}
+//# sourceMappingURL=skills-commands.js.map

package/dist/skills-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-commands.js","sourceRoot":"","sources":["../src/skills-commands.ts"],"names":[],"mappings":"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"}

package/dist/sprint-commands.d.ts

@@ -0,0 +1,5 @@
+import type { CliIo, CliOptions } from "./types.js";
+export declare function velocityCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function sprintCommand(subcommand: string | undefined, options: CliOptions, io: CliIo): Promise<void>;
+export declare function calibrationCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function burndownCommand(options: CliOptions, io: CliIo): Promise<void>;