@ipul-labs/forge 1.13.0

package/dist-lib/views/Forge/phases/shared/ResolutionCheckPanel.d.ts

@@ -0,0 +1,6 @@
+interface Props {
+    /** Show a "Try Again" button when unresolved. Monitoring view sets this. */
+    showTryAgain?: boolean;
+}
+export declare function ResolutionCheckPanel({ showTryAgain }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/views/Forge/settings/ConnectionRow.d.ts

@@ -0,0 +1,16 @@
+import { PublicConnection } from '../hooks/useConfig';
+export type ProviderKey = "gitlab" | "github" | "azuredevops";
+interface Props {
+    provider: ProviderKey;
+    connection: PublicConnection & {
+        baseUrl?: string;
+    };
+    newToken: string;
+    setNewToken: (v: string) => void;
+    clearToken: boolean;
+    setClearToken: (v: boolean) => void;
+    baseUrl?: string;
+    setBaseUrl?: (v: string) => void;
+}
+export declare function ConnectionRow({ provider, connection, newToken, setNewToken, clearToken, setClearToken, baseUrl, setBaseUrl, }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/views/Forge/settings/ConnectionsSection.d.ts

@@ -0,0 +1,7 @@
+import { ConfigPatch, ForgeConfig } from '../hooks/useConfig';
+interface Props {
+    connections: ForgeConfig["connections"];
+    onSave: (patch: ConfigPatch["connections"]) => Promise<void>;
+}
+export declare function ConnectionsSection({ connections, onSave }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/views/Forge/settings/DefaultsSection.d.ts

@@ -0,0 +1,7 @@
+import { ForgeConfig } from '../hooks/useConfig';
+interface Props {
+    defaults: ForgeConfig["defaults"];
+    onSave: (defaults: ForgeConfig["defaults"]) => Promise<void>;
+}
+export declare function DefaultsSection({ defaults, onSave }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/views/Forge/settings/ReposSection.d.ts

@@ -0,0 +1,7 @@
+import { ForgeRepo } from '../types';
+interface Props {
+    repos: ForgeRepo[];
+    onSave: (repos: ForgeRepo[]) => Promise<void>;
+}
+export declare function ReposSection({ repos, onSave }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/views/Forge/settings/SettingsView.d.ts

@@ -0,0 +1 @@
+export declare function SettingsView(): import("react/jsx-runtime").JSX.Element | null;

package/dist-lib/views/Forge/shell/ConfigBar.d.ts

@@ -0,0 +1 @@
+export declare function ConfigBar(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/views/Forge/shell/ForgeRouter.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Headless component that keeps the URL and the dashboard phase in sync.
+ *
+ * - activeDetailTab ← URL (issue | mr)
+ * - phase → URL (push new history entries for major transitions)
+ * - URL → phase (back/forward swaps restore the correct phase)
+ * - URL → issue (initial mount with a deep link fetches + restores analysis)
+ */
+export declare function ForgeRouter(): null;

package/dist-lib/views/Forge/shell/ForgeShell.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+interface Props {
+    popoutUrl?: string;
+    children: ReactNode;
+}
+export declare function ForgeShell({ popoutUrl, children }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/views/Forge/shell/Sidebar.d.ts

@@ -0,0 +1 @@
+export declare function Sidebar(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/views/Forge/shell/SidebarFooterMenu.d.ts

@@ -0,0 +1 @@
+export declare function SidebarFooterMenu(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/views/Forge/shell/SidebarNav.d.ts

@@ -0,0 +1 @@
+export declare function SidebarNav(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/views/Forge/shell/SidebarNavItem.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+interface Props {
+    label: string;
+    icon?: ReactNode;
+    active: boolean;
+    onClick: () => void;
+    badgeCount?: number;
+}
+export declare function SidebarNavItem({ label, icon, active, onClick, badgeCount }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/views/Forge/shell/TopBar.d.ts

@@ -0,0 +1,5 @@
+interface Props {
+    popoutUrl?: string;
+}
+export declare function TopBar({ popoutUrl }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/views/Forge/types.d.ts

@@ -0,0 +1,235 @@
+export interface GitLabIssue {
+    iid: number;
+    title: string;
+    description: string | null;
+    labels: string[];
+    author: {
+        name: string;
+    };
+    created_at: string;
+    web_url: string;
+    /** Forge branch attached to this issue, if one exists on the remote. */
+    forgeBranch?: string;
+    /** Commits on `forgeBranch` not yet on main. `0` = stale / no pending changes.
+     *  `null` = could not be computed. `undefined` = no forgeBranch. */
+    branchAhead?: number | null;
+    /** Recently merged MR whose description closes this issue (`Closes #N` /
+     *  `Fixes #N` / `Resolves #N`). Present → the fix almost certainly shipped. */
+    likelyFixedByMr?: {
+        iid: number;
+        webUrl: string;
+    };
+}
+/**
+ * Ephemeral review-app environment attached to a forge branch. Shape comes
+ * from the SCM provider's normalised `NormalEnvironment` plus the branch
+ * name we matched on (server-side) so the UI can colocate it with the
+ * branch's pipeline. `external_url` is the preview URL (null while the
+ * deploy is still in-flight).
+ */
+export interface ForgeEnvironment {
+    id: number;
+    name: string;
+    state: "available" | "stopping" | "stopped" | string;
+    external_url: string | null;
+    ref: string | null;
+    updated_at: string | null;
+    web_url: string | null;
+    branchName: string;
+}
+export interface ForgeChange {
+    /** Repo id this change belongs to. Optional for backward compat with single-repo analyses. */
+    repo?: string;
+    file: string;
+    action: "create" | "modify" | "delete";
+    proposed: string;
+    original: string | null;
+    summary: string;
+}
+export interface AnalysisResult {
+    issue: GitLabIssue;
+    mrTitle?: string;
+    explanation: string;
+    reasoning: string;
+    changes: ForgeChange[];
+    /** The set of repos the analysis was run against (primary first). */
+    repos?: string[];
+}
+export interface ApplicationResult {
+    repo: string;
+    branchName: string;
+    mr: {
+        iid: number;
+        web_url: string;
+        title: string;
+    } | null;
+    pipelineUrl: string | null;
+}
+export interface ApplyResult {
+    applications: ApplicationResult[];
+}
+export interface OpenMRDetail {
+    iid: number;
+    title: string;
+    web_url: string;
+    source_branch: string;
+    target_branch: string;
+    state: string;
+    has_conflicts: boolean;
+    rebase_in_progress: boolean;
+    merge_status: string;
+    detailed_merge_status: string | null;
+}
+export interface MRDiff {
+    old_path: string;
+    new_path: string;
+    diff: string;
+    new_file: boolean;
+    renamed_file: boolean;
+    deleted_file: boolean;
+}
+export type ForgeMRState = "open" | "merged" | "closed";
+export interface ForgeMRSummary {
+    iid: number;
+    title: string;
+    web_url: string;
+    source_branch: string;
+    target_branch: string;
+    state?: string;
+    created_at: string;
+    merged_at?: string | null;
+    author: {
+        name: string;
+    };
+    has_conflicts: boolean;
+    merge_status: string;
+    pipeline: {
+        status: string;
+        web_url: string;
+    } | null;
+}
+export interface MergedMR {
+    iid: number;
+    web_url: string;
+    title: string;
+    merged_at: string;
+    branchName: string;
+    merge_commit_sha?: string | null;
+    /** The post-merge pipeline that ran on the merge commit, if any. */
+    pipeline?: {
+        id: number;
+        status: string;
+        web_url: string;
+    } | null;
+}
+export interface ProgressStep {
+    step: string;
+    message: string;
+}
+export interface ForgeModel {
+    id: string;
+    label: string;
+    provider: string;
+    rates?: {
+        input: number;
+        output: number;
+    };
+}
+export type ForgeProjectType = "auto" | "node" | "go";
+export interface ForgeRepo {
+    id: string;
+    label: string;
+    projectType?: ForgeProjectType;
+}
+export interface ForgeAgentBackend {
+    id: "claude" | "openclaw";
+    label: string;
+    configured: boolean;
+}
+export interface ResolutionCheck {
+    resolved: boolean;
+    reasoning: string;
+    cost?: number;
+    serviceTier?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+}
+export interface ForgeUsage {
+    sessionCost: number;
+    serviceTier: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+}
+export interface ForgeRateLimit {
+    tokensLimit: number | null;
+    tokensRemaining: number | null;
+    tokensReset: string | null;
+    requestsLimit: number | null;
+    requestsRemaining: number | null;
+    requestsReset: string | null;
+}
+export interface CILogEntry {
+    ts: string;
+    message: string;
+    level?: "info" | "warn" | "error" | "debug" | "success";
+}
+export type ValidationStepKey = string;
+export type ValidationStatus = "idle" | "running" | "passed" | "failed" | "skipped";
+export interface ValidationStepState {
+    status: ValidationStatus;
+    passed?: boolean;
+    skipped?: boolean;
+    exitCode?: number;
+    durationMs?: number;
+    tail?: string;
+    logs: CILogEntry[];
+}
+export interface RepoValidationState {
+    repo: string;
+    projectType?: ForgeProjectType;
+    /** Per-step status, keyed by ValidationStepKey. Only populated for steps
+     * the runner actually emitted — missing entries are hidden in the UI. */
+    steps: Record<string, ValidationStepState>;
+    /** Canonical step order declared by the runner (e.g. fmt/vet/build/test
+     * for Go). Drives row order; falls back to event-arrival order when the
+     * backend hasn't sent one. */
+    stepOrder?: ValidationStepKey[];
+    /** Steps that get a "Fix with AI" button when they fail. Runner-specific. */
+    fixableSteps?: ValidationStepKey[];
+    /** Per-repo summary; set when the backend emits `repo_result`. */
+    result?: {
+        allPassed: boolean;
+        checkedAt: string;
+    };
+    /** True when the validator skipped this repo (e.g. misattributed change).
+     * Renders an explainer instead of the per-step rows. */
+    skipped?: boolean;
+    skipReason?: string;
+}
+export interface ValidationState {
+    /** Aggregate result across every repo — drives the headline + auto-push. */
+    result: null | {
+        repo: string;
+        allPassed: boolean;
+        checkedAt: string;
+    };
+    /** Per-repo state. One block is rendered for each entry, in `repoOrder`. */
+    byRepo: Record<string, RepoValidationState>;
+    /** Insertion order of repos (primary first). */
+    repoOrder: string[];
+    /** Top-level log lines emitted before any per-repo block is open
+     * (candidate cloning, attribution plan, drop reasons). Renders as a
+     * compact strip at the top of the panel. */
+    aggregateLogs: {
+        ts: string;
+        message: string;
+    }[];
+    /** True when the proposal has changed since the last validation ran — the
+     * rows stay visible but get an "outdated" banner so scroll position is
+     * preserved instead of the panel collapsing. */
+    stale: boolean;
+}
+export type { StoredAnalysis } from './analysisCache';
+export type Phase = "connect" | "idle" | "selected" | "analyzing" | "reviewing" | "applying" | "monitoring";

package/dist-lib/views/Forge/utils.d.ts

@@ -0,0 +1,11 @@
+import { ProgressStep } from './types';
+/**
+ * Opens an EventSource, parses each message as JSON, and calls onMessage.
+ * Returns the EventSource so the caller can close it.
+ */
+export declare function openSSE(url: string, onMessage: (event: Record<string, unknown>) => void, onError: () => void): EventSource;
+/**
+ * Replaces an existing step with the same key or appends a new one.
+ * Keeps the list ordered by arrival so the latest step is always last.
+ */
+export declare function upsertProgressStep(prev: ProgressStep[], step: string, message: string): ProgressStep[];

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@ipul-labs/forge",
+  "version": "1.13.0",
+  "description": "AI-powered code change & deploy control panel — connects Claude, GitLab, and Kubernetes",
+  "type": "module",
+  "main": "server/forge/routes.js",
+  "bin": {
+    "forge": "./bin/forge-agent.js"
+  },
+  "exports": {
+    ".": "./server/forge/routes.js",
+    "./agent": "./server/forge/core/ForgeAgent.js",
+    "./gitlab": "./server/forge/core/gitlabClient.js",
+    "./ui": {
+      "import": "./dist-lib/ui.js",
+      "types": "./dist-lib/ui.d.ts"
+    },
+    "./style.css": "./dist-lib/style.css"
+  },
+  "files": [
+    "bin",
+    "server/forge",
+    "dist",
+    "dist-lib"
+  ],
+  "scripts": {
+    "dev": "trap 'kill 0' EXIT INT TERM; FORGE_NO_VITE=1 node --watch-path=./server --watch-path=./server.js server.js & vite; wait",
+    "build": "vite build --mode lib",
+    "build:app": "vite build",
+    "prepare": "npm run build",
+    "start": "NODE_ENV=production node server.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@kubernetes/client-node": "^1.0.0",
+    "diff": "^9.0.0",
+    "dotenv": "^16.6.1",
+    "express": "^4.21.0",
+    "htm": "^3.1.1",
+    "ink": "^7.0.1",
+    "ink-select-input": "^6.2.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "react-router-dom": "^7.14.1"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/gitlab": "^13.3.2",
+    "@semantic-release/npm": "^13.1.5",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/express": "^5.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.4.47",
+    "semantic-release": "^25.0.3",
+    "tailwindcss": "^3.4.14",
+    "typescript": "^5.6.0",
+    "vite": "^5.4.0",
+    "vite-plugin-dts": "^4.3.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "forge",
+    "claude",
+    "ai",
+    "gitlab",
+    "kubernetes",
+    "devops"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/ipul-labs/forge.git"
+  },
+  "license": "MIT"
+}