@agilemonster/mcp-server 1.0.15 → 1.0.21

package/dist/deploy-runner.d.ts

@@ -0,0 +1,144 @@
+import { BoundProfile, DeployMethod, DeployProfile } from './deploy-profile.js';
+import { PendingVerification } from './deploy-memory.js';
+/**
+ * Runs a project's deployment and proves it worked.
+ *
+ * Differences from the previous inline pipeline:
+ *  - commits ONLY the files the agent changed (never `git add -A`, which swept up unrelated work and local API keys),
+ *  - never blocks the event loop, so the worker heartbeat stays alive during long builds,
+ *  - classifies failures, heals the ones it can (Docker not running, remote moved ahead, flaky network)
+ *    and falls back to the next-best route when the chosen one plainly does not apply,
+ *  - treats a still-running CI pipeline as "pending" to be re-checked later instead of a failure,
+ *  - only lets an unreachable URL fail the deploy when a human told us that URL (guesses are informational),
+ *  - records every outcome in the project's deployment memory.
+ */
+export interface DeployRequest {
+    projectPath: string;
+    title: string;
+    cardId: string;
+    /** Project-relative paths the agent modified. Only these are committed. */
+    files?: string[];
+    /** The human asked for a (re)deploy even though there is nothing new to commit. */
+    redeploy?: boolean;
+    bound?: BoundProfile | null;
+    /** A deploy route the human just gave us for this card. */
+    override?: {
+        method: DeployMethod;
+        command?: string | null;
+    } | null;
+    ciWaitMs?: number;
+}
+export interface DeployResult {
+    ok: boolean;
+    /** Pushed and triggered, but the pipeline had not finished when we stopped waiting. */
+    pending: boolean;
+    /** The change was saved/pushed, but no deployment could be confirmed (never reported as "Deployed"). */
+    unverified: boolean;
+    method: DeployMethod;
+    command: string | null;
+    commitHash: string;
+    fullSha: string;
+    branch: string;
+    deployedNote: string;
+    errorDetail: string;
+    errorKind: string | null;
+    hint: string;
+    actions: string[];
+    healed: string[];
+    profile: DeployProfile;
+    pendingVerification?: PendingVerification;
+}
+export interface FailureClass {
+    kind: string;
+    hint: string;
+    healable: boolean;
+}
+export declare function classifyFailure(text: string): FailureClass;
+export interface DeployDirective {
+    retry: boolean;
+    method: DeployMethod | null;
+    command: string | null;
+    liveUrl: string | null;
+}
+/**
+ * Parse a human reply to a "deployment failed / may I deploy with X?" question.
+ * Returns null when the comment is not about deploying (it is then ordinary feedback on the code).
+ */
+export declare function parseDeployDirective(text: string): DeployDirective | null;
+/** Agent-modified paths that are safe to commit: inside the project, and never local config that carries secrets. */
+export declare function committablePaths(projectPath: string, files: string[]): string[];
+/**
+ * Keep Agile Monster's local files (which contain the personal API key) out of every commit, by anyone,
+ * via the repository's `info/exclude` — a per-clone ignore list that is itself never committed.
+ * Works for worktrees and for a bound folder that is a sub-directory of a larger repository.
+ */
+export declare function ensureLocalGitExcludes(projectPath: string): void;
+export interface CiRun {
+    databaseId?: number;
+    status: string;
+    conclusion: string | null;
+    name?: string;
+    workflowName?: string;
+    url?: string;
+    event?: string;
+    createdAt?: string;
+}
+export interface CiVerdict {
+    verdict: 'success' | 'failure' | 'pending' | 'none' | 'no_deploy_run';
+    failed?: CiRun;
+    reason?: string;
+    warnings: string[];
+    url?: string;
+}
+/**
+ * Decide what a commit's workflow runs say about the DEPLOYMENT.
+ * A failing lint/test workflow does not mean the deploy failed (unless the deploy is chained behind it),
+ * a deploy that has not finished is "pending", and a run cancelled by a newer one is neither success nor failure.
+ *
+ * `deployNames` may hold workflow names and/or workflow file paths (GitHub reports a workflow without a
+ * `name:` by its path).
+ */
+export declare function judgeCiRuns(runs: CiRun[], deployNames: string[], chainedDeploy?: boolean): CiVerdict;
+/** Names GitHub may report for a workflow: its `name:`, or its path when it has none. */
+export declare function workflowMatchNames(workflows: Array<{
+    name: string;
+    file: string;
+}>): string[];
+/** Re-check a commit's runs once (used both inline and for deferred verification on later pulses). */
+export declare function checkCiOnce(cwd: string, sha: string, deployNames: string[], chained: boolean): Promise<CiVerdict & {
+    ghError?: string;
+    logTail?: string;
+}>;
+export interface ComposePsEntry {
+    Service?: string;
+    Name?: string;
+    State?: string;
+    Health?: string;
+    ExitCode?: number;
+    ID?: string;
+    Publishers?: Array<{
+        PublishedPort?: number;
+        TargetPort?: number;
+    }> | null;
+}
+/** `docker compose ps --format json` prints either one JSON array or one object per line, depending on the version. */
+export declare function parseComposePsJson(text: string): ComposePsEntry[];
+export declare function evaluateComposePs(entries: ComposePsEntry[]): {
+    ok: boolean;
+    settling: boolean;
+    bad: ComposePsEntry[];
+    running: number;
+};
+export interface ComposeRefreshPlan {
+    /** Services built from a directory containing a changed file: rebuild + recreate. */
+    rebuild: string[];
+    /** Services that bind-mount a changed file (no image rebuild needed): restart. */
+    restart: string[];
+    /** Could not map the change to specific services: refresh the whole stack. */
+    all: boolean;
+}
+/** Map changed files to the Compose services that must be rebuilt or restarted (from `docker compose config --format json`). */
+export declare function planComposeRefresh(config: any, composeDir: string, changedAbs: string[]): ComposeRefreshPlan;
+export declare function runDeployment(req: DeployRequest): Promise<DeployResult>;
+/** Plain-English failure message for the card, including how to answer so the next attempt can succeed. */
+export declare function describeFailureForHuman(res: DeployResult): string;