nomoreide 0.1.44 → 0.1.46

package/dist/core/github-manager.d.ts

@@ -0,0 +1,149 @@
+export interface GitHubPR {
+    number: number;
+    title: string;
+    state: "open" | "closed" | "merged";
+    body: string | null;
+    html_url: string;
+    head: {
+        ref: string;
+        sha: string;
+    };
+    base: {
+        ref: string;
+    };
+    user: {
+        login: string;
+    };
+    created_at: string;
+    updated_at: string;
+    merged_at: string | null;
+    draft: boolean;
+    mergeable: boolean | null;
+}
+export interface GitHubIssue {
+    number: number;
+    title: string;
+    state: "open" | "closed";
+    body: string | null;
+    html_url: string;
+    user: {
+        login: string;
+    };
+    labels: Array<{
+        name: string;
+        color: string;
+    }>;
+    created_at: string;
+    updated_at: string;
+    comments: number;
+    pull_request?: object;
+}
+export interface GitHubComment {
+    id: number;
+    body: string;
+    user: {
+        login: string;
+    };
+    created_at: string;
+    html_url: string;
+}
+export interface GitHubCheckRun {
+    id: number;
+    name: string;
+    status: string;
+    conclusion: string | null;
+    html_url: string;
+    started_at: string | null;
+    completed_at: string | null;
+}
+export interface CommitCIStatus {
+    sha: string;
+    state: "pending" | "success" | "failure" | "error" | "unknown";
+    totalCount: number;
+    runs: GitHubCheckRun[];
+}
+export interface GitHubWorkflowRun {
+    id: number;
+    name: string;
+    status: string;
+    conclusion: string | null;
+    html_url: string;
+    head_sha: string;
+    head_branch: string;
+    created_at: string;
+    updated_at: string;
+    run_number: number;
+    event: string;
+}
+export interface GitHubWorkflowJobStep {
+    name: string;
+    status: string;
+    conclusion: string | null;
+    number: number;
+    started_at: string | null;
+    completed_at: string | null;
+}
+export interface GitHubWorkflowJob {
+    id: number;
+    run_id: number;
+    html_url: string;
+    status: string;
+    conclusion: string | null;
+    started_at: string | null;
+    completed_at: string | null;
+    name: string;
+    steps: GitHubWorkflowJobStep[];
+}
+export declare class GitHubApiError extends Error {
+    readonly status: number;
+    readonly path: string;
+    constructor(message: string, status: number, path: string);
+}
+export declare class GitHubManager {
+    private readonly token;
+    private readonly owner;
+    private readonly repo;
+    private readonly baseUrl;
+    constructor(token: string, owner: string, repo: string, baseUrl?: string);
+    static parseRemoteUrl(remoteUrl: string): {
+        owner: string;
+        repo: string;
+    } | null;
+    listPRs(state?: "open" | "closed" | "all", page?: number): Promise<GitHubPR[]>;
+    getPR(number: number): Promise<GitHubPR>;
+    getPRDiff(number: number): Promise<string>;
+    createPR(opts: {
+        title: string;
+        body?: string;
+        head: string;
+        base: string;
+        draft?: boolean;
+    }): Promise<GitHubPR>;
+    /**
+     * Merge a pull request via the GitHub API. Defaults to a squash merge — the
+     * common "Squash & merge" button behavior. GitHub rejects the call (405) if
+     * the PR isn't mergeable (conflicts, failing required checks, branch
+     * protection), and that message is surfaced to the caller.
+     */
+    mergePR(number: number, opts?: {
+        method?: "merge" | "squash" | "rebase";
+        commitTitle?: string;
+        commitMessage?: string;
+    }): Promise<{
+        merged: boolean;
+        sha: string;
+        message: string;
+    }>;
+    listIssues(state?: "open" | "closed" | "all", page?: number): Promise<GitHubIssue[]>;
+    getIssue(number: number): Promise<GitHubIssue>;
+    createIssue(opts: {
+        title: string;
+        body?: string;
+    }): Promise<GitHubIssue>;
+    listIssueComments(number: number): Promise<GitHubComment[]>;
+    addIssueComment(number: number, body: string): Promise<GitHubComment>;
+    getCommitChecks(sha: string): Promise<CommitCIStatus>;
+    listWorkflowRuns(branch?: string, page?: number): Promise<GitHubWorkflowRun[]>;
+    listWorkflowRunJobs(runId: number): Promise<GitHubWorkflowJob[]>;
+    private request;
+}

package/dist/core/github-manager.js

@@ -0,0 +1,181 @@
+export class GitHubApiError extends Error {
+    status;
+    path;
+    constructor(message, status, path) {
+        super(message);
+        this.status = status;
+        this.path = path;
+        this.name = "GitHubApiError";
+    }
+}
+export class GitHubManager {
+    token;
+    owner;
+    repo;
+    baseUrl;
+    constructor(token, owner, repo, baseUrl = "https://api.github.com") {
+        this.token = token;
+        this.owner = owner;
+        this.repo = repo;
+        this.baseUrl = baseUrl;
+    }
+    static parseRemoteUrl(remoteUrl) {
+        const trimmed = remoteUrl.trim();
+        // https://github.com/owner/repo[.git]
+        const httpsMatch = /^https?:\/\/(?:[^@]+@)?github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:\/)?$/.exec(trimmed);
+        if (httpsMatch) {
+            return { owner: httpsMatch[1], repo: httpsMatch[2] };
+        }
+        // git@github.com:owner/repo[.git]
+        const sshMatch = /^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/.exec(trimmed);
+        if (sshMatch) {
+            return { owner: sshMatch[1], repo: sshMatch[2] };
+        }
+        return null;
+    }
+    async listPRs(state = "open", page = 1) {
+        const data = await this.request(`/repos/${this.owner}/${this.repo}/pulls?state=${state}&per_page=30&page=${page}`);
+        return data.map(normalizePR);
+    }
+    async getPR(number) {
+        const data = await this.request(`/repos/${this.owner}/${this.repo}/pulls/${number}`);
+        return normalizePR(data);
+    }
+    async getPRDiff(number) {
+        return this.request(`/repos/${this.owner}/${this.repo}/pulls/${number}`, { accept: "application/vnd.github.diff" });
+    }
+    async createPR(opts) {
+        const data = await this.request(`/repos/${this.owner}/${this.repo}/pulls`, { method: "POST", body: opts });
+        return normalizePR(data);
+    }
+    /**
+     * Merge a pull request via the GitHub API. Defaults to a squash merge — the
+     * common "Squash & merge" button behavior. GitHub rejects the call (405) if
+     * the PR isn't mergeable (conflicts, failing required checks, branch
+     * protection), and that message is surfaced to the caller.
+     */
+    async mergePR(number, opts = {}) {
+        return this.request(`/repos/${this.owner}/${this.repo}/pulls/${number}/merge`, {
+            method: "PUT",
+            body: {
+                merge_method: opts.method ?? "squash",
+                ...(opts.commitTitle ? { commit_title: opts.commitTitle } : {}),
+                ...(opts.commitMessage ? { commit_message: opts.commitMessage } : {}),
+            },
+        });
+    }
+    async listIssues(state = "open", page = 1) {
+        const data = await this.request(`/repos/${this.owner}/${this.repo}/issues?state=${state}&per_page=30&page=${page}`);
+        // Filter out PRs (issues endpoint includes them)
+        return data.filter((issue) => !issue.pull_request);
+    }
+    async getIssue(number) {
+        return this.request(`/repos/${this.owner}/${this.repo}/issues/${number}`);
+    }
+    async createIssue(opts) {
+        return this.request(`/repos/${this.owner}/${this.repo}/issues`, { method: "POST", body: opts });
+    }
+    async listIssueComments(number) {
+        return this.request(`/repos/${this.owner}/${this.repo}/issues/${number}/comments?per_page=100`);
+    }
+    async addIssueComment(number, body) {
+        return this.request(`/repos/${this.owner}/${this.repo}/issues/${number}/comments`, { method: "POST", body: { body } });
+    }
+    async getCommitChecks(sha) {
+        try {
+            const data = await this.request(`/repos/${this.owner}/${this.repo}/commits/${sha}/check-runs?per_page=100`);
+            return {
+                sha,
+                state: deriveState(data.check_runs),
+                totalCount: data.total_count,
+                runs: data.check_runs,
+            };
+        }
+        catch (error) {
+            if (error instanceof GitHubApiError && error.status === 404) {
+                return { sha, state: "unknown", totalCount: 0, runs: [] };
+            }
+            throw error;
+        }
+    }
+    async listWorkflowRuns(branch, page = 1) {
+        const params = new URLSearchParams({ per_page: "30", page: String(page) });
+        if (branch)
+            params.set("branch", branch);
+        const data = await this.request(`/repos/${this.owner}/${this.repo}/actions/runs?${params}`);
+        return data.workflow_runs;
+    }
+    async listWorkflowRunJobs(runId) {
+        const data = await this.request(`/repos/${this.owner}/${this.repo}/actions/runs/${runId}/jobs?per_page=100`);
+        return data.jobs;
+    }
+    async request(path, opts) {
+        const url = path.startsWith("http") ? path : `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            Accept: opts?.accept ?? "application/vnd.github+json",
+            "X-GitHub-Api-Version": "2022-11-28",
+        };
+        const init = {
+            method: opts?.method ?? "GET",
+            headers,
+        };
+        if (opts?.body !== undefined) {
+            if (opts.accept === "application/vnd.github.diff") {
+                // diff requests don't send a body
+            }
+            else {
+                headers["Content-Type"] = "application/json";
+                init.body = JSON.stringify(opts.body);
+            }
+        }
+        const response = await fetch(url, init);
+        if (opts?.accept === "application/vnd.github.diff") {
+            if (!response.ok) {
+                const text = await response.text().catch(() => response.statusText);
+                throw new GitHubApiError(text, response.status, path);
+            }
+            return response.text();
+        }
+        if (!response.ok) {
+            let message = response.statusText;
+            try {
+                const body = await response.json();
+                if (body.message)
+                    message = body.message;
+            }
+            catch { /* ignore */ }
+            throw new GitHubApiError(message, response.status, path);
+        }
+        return response.json();
+    }
+}
+function normalizePR(pr) {
+    return {
+        number: pr.number,
+        title: pr.title,
+        state: pr.merged_at ? "merged" : pr.state,
+        body: pr.body,
+        html_url: pr.html_url,
+        head: pr.head,
+        base: pr.base,
+        user: pr.user,
+        created_at: pr.created_at,
+        updated_at: pr.updated_at,
+        merged_at: pr.merged_at,
+        draft: pr.draft ?? false,
+        mergeable: pr.mergeable ?? null,
+    };
+}
+function deriveState(runs) {
+    if (runs.length === 0)
+        return "unknown";
+    if (runs.some((r) => r.status === "in_progress" || r.status === "queued"))
+        return "pending";
+    if (runs.every((r) => r.conclusion === "success" || r.conclusion === "skipped" || r.conclusion === "neutral"))
+        return "success";
+    if (runs.some((r) => r.conclusion === "failure" || r.conclusion === "timed_out"))
+        return "failure";
+    return "error";
+}
+//# sourceMappingURL=github-manager.js.map

package/dist/core/github-manager.js.map

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

package/dist/core/repo-onboard.d.ts

@@ -213,8 +213,8 @@ export declare const proposedServiceSchema: z.ZodObject<{
     confidence: z.ZodEnum<["high", "medium", "low"]>;
     reason: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    name: string;
     kind: "local" | "docker-compose";
+    name: string;
     cwd: string;
     confidence: "high" | "medium" | "low";
     reason: string;
@@ -226,8 +226,8 @@ export declare const proposedServiceSchema: z.ZodObject<{
     composeService?: string | undefined;
     installCommand?: string | undefined;
 }, {
-    name: string;
     kind: "local" | "docker-compose";
+    name: string;
     cwd: string;
     confidence: "high" | "medium" | "low";
     reason: string;

package/dist/core/types.d.ts

@@ -1,5 +1,6 @@
 import type { ProcessTreeSummary } from "./process-tree.js";
 import type { PortBindingStatus } from "./port-utils.js";
+import type { Workflow } from "./workflows.js";
 export type ServiceKind = "local" | "docker-compose" | "ssh";
 export interface ServiceDefinition {
     name: string;
@@ -90,6 +91,10 @@ export interface LogQuery {
     /** journald cursor to page *older* than — returns the `lines` entries before it. */
     before?: string;
 }
+export interface GitHubToken {
+    host: string;
+    token: string;
+}
 export interface NoMoreIdeConfig {
     version: 1;
     services: ServiceDefinition[];
@@ -98,6 +103,9 @@ export interface NoMoreIdeConfig {
     selectedGitRepository?: string;
     databases: DatabaseConnection[];
     logSources: LogSourceDefinition[];
+    githubTokens: GitHubToken[];
+    /** User-saved git/GitHub workflows (forks/edits of the built-in templates). */
+    workflows: Workflow[];
 }
 export type ServiceState = "stopped" | "starting" | "running" | "exited";
 export interface ServiceStatus {

package/dist/core/workflows.d.ts

@@ -0,0 +1,204 @@
+import { z } from "zod";
+/**
+ * User-owned git/GitHub workflows — the AI-native answer to fixed IDE buttons.
+ *
+ * A workflow is an ordered list of steps the runner walks one at a time. A step
+ * is one of three kinds:
+ *
+ * - **action** — deterministic, no inputs needed (e.g. `push`). Runs via the
+ *   REST API and its result tells us pass/fail. Predictable, no tokens spent.
+ * - **agent** — a scoped natural-language task handed to the dock agent, which
+ *   does the fuzzy work (review a diff, group commits, draft + file a PR/issue)
+ *   using its own git/GitHub tools. Optionally `verify`-d against real git state.
+ * - **gate** — a hard stop that waits for the human (Approve / Skip / Stop).
+ *
+ * The runner itself lives client-side (agent steps execute through the dock
+ * conversation); this module owns the *shape* and the built-in templates, and is
+ * persisted through {@link ConfigStore} so a user can fork/edit them later.
+ */
+export declare const workflowStepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"action">;
+    id: z.ZodString;
+    title: z.ZodString;
+    /**
+     * Deterministic op with no inputs — runs straight through the REST API with
+     * zero agent tokens. `commit` stages everything and commits with a generated
+     * message (no diff reading, no quality analysis); `push` pushes the branch.
+     */
+    op: z.ZodEnum<["push", "commit"]>;
+}, "strip", z.ZodTypeAny, {
+    kind: "action";
+    id: string;
+    title: string;
+    op: "push" | "commit";
+}, {
+    kind: "action";
+    id: string;
+    title: string;
+    op: "push" | "commit";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"agent">;
+    id: z.ZodString;
+    title: z.ZodString;
+    /** The instruction handed to the dock agent. */
+    prompt: z.ZodString;
+    /**
+     * Real-state check run after the agent's turn before advancing:
+     * - `committed` — the working tree is clean (changes were committed).
+     * - `pushed` — the branch is no longer ahead of its upstream.
+     */
+    verify: z.ZodOptional<z.ZodEnum<["committed", "pushed"]>>;
+}, "strip", z.ZodTypeAny, {
+    kind: "agent";
+    id: string;
+    title: string;
+    prompt: string;
+    verify?: "committed" | "pushed" | undefined;
+}, {
+    kind: "agent";
+    id: string;
+    title: string;
+    prompt: string;
+    verify?: "committed" | "pushed" | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"gate">;
+    id: z.ZodString;
+    title: z.ZodString;
+    /** Shown at the pause so the user knows what they're approving. */
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "gate";
+    message: string;
+    id: string;
+    title: string;
+}, {
+    kind: "gate";
+    message: string;
+    id: string;
+    title: string;
+}>]>;
+export declare const workflowSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    /** True for the shipped templates; false/absent for user-saved workflows. */
+    builtin: z.ZodOptional<z.ZodBoolean>;
+    steps: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"action">;
+        id: z.ZodString;
+        title: z.ZodString;
+        /**
+         * Deterministic op with no inputs — runs straight through the REST API with
+         * zero agent tokens. `commit` stages everything and commits with a generated
+         * message (no diff reading, no quality analysis); `push` pushes the branch.
+         */
+        op: z.ZodEnum<["push", "commit"]>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "action";
+        id: string;
+        title: string;
+        op: "push" | "commit";
+    }, {
+        kind: "action";
+        id: string;
+        title: string;
+        op: "push" | "commit";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"agent">;
+        id: z.ZodString;
+        title: z.ZodString;
+        /** The instruction handed to the dock agent. */
+        prompt: z.ZodString;
+        /**
+         * Real-state check run after the agent's turn before advancing:
+         * - `committed` — the working tree is clean (changes were committed).
+         * - `pushed` — the branch is no longer ahead of its upstream.
+         */
+        verify: z.ZodOptional<z.ZodEnum<["committed", "pushed"]>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "agent";
+        id: string;
+        title: string;
+        prompt: string;
+        verify?: "committed" | "pushed" | undefined;
+    }, {
+        kind: "agent";
+        id: string;
+        title: string;
+        prompt: string;
+        verify?: "committed" | "pushed" | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"gate">;
+        id: z.ZodString;
+        title: z.ZodString;
+        /** Shown at the pause so the user knows what they're approving. */
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "gate";
+        message: string;
+        id: string;
+        title: string;
+    }, {
+        kind: "gate";
+        message: string;
+        id: string;
+        title: string;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    steps: ({
+        kind: "action";
+        id: string;
+        title: string;
+        op: "push" | "commit";
+    } | {
+        kind: "agent";
+        id: string;
+        title: string;
+        prompt: string;
+        verify?: "committed" | "pushed" | undefined;
+    } | {
+        kind: "gate";
+        message: string;
+        id: string;
+        title: string;
+    })[];
+    description?: string | undefined;
+    builtin?: boolean | undefined;
+}, {
+    id: string;
+    name: string;
+    steps: ({
+        kind: "action";
+        id: string;
+        title: string;
+        op: "push" | "commit";
+    } | {
+        kind: "agent";
+        id: string;
+        title: string;
+        prompt: string;
+        verify?: "committed" | "pushed" | undefined;
+    } | {
+        kind: "gate";
+        message: string;
+        id: string;
+        title: string;
+    })[];
+    description?: string | undefined;
+    builtin?: boolean | undefined;
+}>;
+export type WorkflowStep = z.infer<typeof workflowStepSchema>;
+export type Workflow = z.infer<typeof workflowSchema>;
+/**
+ * The Phase-1 starter set. These are plain data (not hardcoded UI), so the same
+ * structure a user authors later can be forked from one of these.
+ */
+export declare const BUILTIN_WORKFLOWS: Workflow[];
+/**
+ * Merge the built-in templates with the user's saved workflows. A stored
+ * workflow whose id matches a built-in *replaces* it (that's a fork/edit);
+ * everything else is appended. Built-ins come first.
+ */
+export declare function listWorkflows(stored: Workflow[]): Workflow[];