@vibecontrols/vibe-plugin-tool-git 2026.508.3

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @burdenoff/vibe-plugin-git v1.0.0
+ *
+ * Visual Git Client via Ungit — reverse-proxied through the VibeControls
+ * agent. Manages the Ungit child process lifecycle (install, start, stop)
+ * and proxies all traffic at /ungit/* with session cookie auth.
+ *
+ * Registers:
+ *   - Elysia routes: /api/ungit/*  (REST API)
+ *   - Proxy routes:  /ungit/*      (reverse proxy to ungit)
+ *   - CLI command:   vibe ungit {status,install,start,stop}
+ *
+ * Install: vibe plugin install @burdenoff/vibe-plugin-git
+ */
+import type { VibePlugin } from "./types.js";
+export type { VibePlugin, HostServices, StorageProvider, EventBus, ServiceRegistry, UngitStatus, } from "./types.js";
+export declare const vibePlugin: VibePlugin;
+export default vibePlugin;

package/dist/index.js

@@ -0,0 +1,6 @@
+// @bun
+var __defProp=Object.defineProperty;var __returnValue=(v)=>v;function __exportSetter(name,newValue){this[name]=__returnValue.bind(null,newValue)}var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0,configurable:!0,set:__exportSetter.bind(all,name)})};var __esm=(fn,res)=>()=>(fn&&(res=fn(fn=0)),res);var __require=import.meta.require;async function isPortAvailable(port){try{return Bun.serve({port,hostname:"127.0.0.1",fetch(){return new Response}}).stop(!0),!0}catch{return!1}}async function findAvailablePort(preferred){let start=preferred??DEFAULT_PORT;if(await isPortAvailable(start))return start;for(let port=DEFAULT_PORT;port<=PORT_RANGE_END;port++){if(port===start)continue;if(await isPortAvailable(port))return port}throw Error(`No available port in range ${DEFAULT_PORT}-${PORT_RANGE_END}`)}async function checkInstallation(){try{let localPath=new URL("../../node_modules/.bin/ungit",import.meta.url).pathname;if(await Bun.file(localPath).exists())return{installed:!0,binaryPath:localPath}}catch{}try{let path=Bun.which("ungit");if(path)return{installed:!0,binaryPath:path}}catch{}return{installed:!1}}async function installUngit(){try{let proc=Bun.spawn(["npm","install","-g","ungit"],{stdout:"pipe",stderr:"pipe"}),exitCode=await proc.exited;if(exitCode!==0){let stderr=await new Response(proc.stderr).text();return{success:!1,error:`npm install -g ungit failed (exit ${exitCode}): ${stderr}`}}return{success:!0}}catch(err){return{success:!1,error:err instanceof Error?err.message:"Installation failed"}}}async function startUngit(options){if(childProcess&&currentPid){if(isProcessAlive(currentPid))return{pid:currentPid,port:currentPort};childProcess=null,currentPid=null}if(isStarting)throw Error("Ungit is already starting");isStarting=!0,lastError=null;try{let port=await findAvailablePort(options?.port),workingDir=options?.workingDir||process.env.HOME||"/",install=await checkInstallation();if(!install.installed||!install.binaryPath)throw Error("Ungit is not installed");let args=[install.binaryPath,"--port",String(port),"--no-b","--ungitBindIp","127.0.0.1","--rootPath","/ungit"],proc=Bun.spawn(args,{stdout:"pipe",stderr:"pipe",cwd:workingDir,env:{...process.env,PORT:void 0}});if(childProcess=proc,currentPort=port,currentWorkingDir=workingDir,currentPid=proc.pid,proc.exited.then((code)=>{if(childProcess===proc){if(childProcess=null,currentPid=null,code!==0&&code!==null)lastError=`Ungit exited with code ${code}`}}),await new Promise((resolve)=>setTimeout(resolve,2000)),!isProcessAlive(proc.pid)){let stderr=await new Response(proc.stderr).text();throw Error(`Ungit failed to start: ${stderr}`)}return{pid:proc.pid,port}}catch(err){throw lastError=err instanceof Error?err.message:"Failed to start",err}finally{isStarting=!1}}async function stopUngit(){if(!childProcess||!currentPid){childProcess=null,currentPid=null;return}let proc=childProcess,pid=currentPid;childProcess=null,currentPid=null,currentPort=null,currentWorkingDir=null,lastError=null;try{process.kill(pid,"SIGTERM")}catch{return}let deadline=Date.now()+5000;while(Date.now()<deadline&&isProcessAlive(pid))await new Promise((resolve)=>setTimeout(resolve,200));if(isProcessAlive(pid))try{process.kill(pid,"SIGKILL")}catch{}try{await proc.exited}catch{}}function getStatus(){let running=Boolean(currentPid&&isProcessAlive(currentPid));if(!running&&childProcess)childProcess=null,currentPid=null;return{installed:!0,running,pid:running?currentPid??void 0:void 0,port:running?currentPort??void 0:void 0,workingDir:running?currentWorkingDir??void 0:void 0,error:lastError??void 0}}function getRunningPort(){if(!currentPid||!isProcessAlive(currentPid))return null;return currentPort}function isProcessAlive(pid){try{return process.kill(pid,0),!0}catch{return!1}}var childProcess=null,currentPort=null,currentWorkingDir=null,currentPid=null,lastError=null,isStarting=!1,DEFAULT_PORT=8448,PORT_RANGE_END=8458;var exports_routes={};__export(exports_routes,{createUngitRoutes:()=>createUngitRoutes});import{Elysia}from"elysia";function createUngitRoutes(_hostServices){return new Elysia({prefix:"/api/ungit"}).get("/status",async()=>{let installInfo=await checkInstallation(),processStatus=getStatus();return{installed:installInfo.installed,installing:isInstalling,running:processStatus.running,pid:processStatus.pid,port:processStatus.port,workingDir:processStatus.workingDir,error:installError||processStatus.error||void 0}}).post("/install",async({set})=>{if(isInstalling)return set.status=409,{error:"Installation already in progress"};let check=await checkInstallation();if(check.installed)return{message:"Ungit is already installed",binaryPath:check.binaryPath};return isInstalling=!0,installError=null,(async()=>{try{let result=await installUngit();if(!result.success)installError=result.error||"Installation failed"}catch(err){installError=err instanceof Error?err.message:"Installation failed"}finally{isInstalling=!1}})(),{message:"Installation started -- poll GET /api/ungit/status"}}).post("/start",async({body,set})=>{let{workingDir,port}=body||{};if(!(await checkInstallation()).installed)return set.status=400,{error:"Ungit is not installed. POST /api/ungit/install first"};try{let result=await startUngit({workingDir,port});return{message:"Ungit started",pid:result.pid,port:result.port,workingDir:workingDir||process.env.HOME||"/"}}catch(err){return set.status=500,{error:err instanceof Error?err.message:"Failed to start"}}}).post("/stop",async()=>{return await stopUngit(),{message:"Ungit stopped"}}).post("/restart",async({body,set})=>{let{workingDir}=body||{};if(!(await checkInstallation()).installed)return set.status=400,{error:"Ungit is not installed"};await stopUngit();try{let result=await startUngit({workingDir});return{message:"Ungit restarted",pid:result.pid,port:result.port,workingDir:workingDir||process.env.HOME||"/"}}catch(err){return set.status=500,{error:err instanceof Error?err.message:"Failed to restart"}}})}var isInstalling=!1,installError=null;var init_routes=()=>{};var exports_proxy={};__export(exports_proxy,{default:()=>proxy_default,createUngitProxy:()=>createUngitProxy});import{Elysia as Elysia2}from"elysia";function generateSessionToken(){let bytes=new Uint8Array(32);return crypto.getRandomValues(bytes),Buffer.from(bytes).toString("base64url")}function createSession(){let token=generateSessionToken(),now=Date.now(),session={token,createdAt:now,expiresAt:now+SESSION_TTL_MS};return sessions.set(token,session),session}function validateSessionToken(token){let session=sessions.get(token);if(!session)return!1;if(Date.now()>session.expiresAt)return sessions.delete(token),!1;return!0}function cleanupSessions(){let now=Date.now();for(let[token,session]of sessions)if(now>session.expiresAt)sessions.delete(token)}function getCookie(cookieHeader,name){if(!cookieHeader)return null;let match=cookieHeader.match(new RegExp(`(?:^|;\\s*)${name}=([^;]*)`));return match?match[1]:null}function isAuthed(request,validateApiKey){let cookieHeader=request.headers.get("cookie"),sessionToken=getCookie(cookieHeader,COOKIE_NAME),apiKeyHeader=request.headers.get("x-agent-api-key"),apiKeyParam=new URL(request.url).searchParams.get("apiKey"),hasValidSession=sessionToken?validateSessionToken(sessionToken):!1,hasValidApiKey=apiKeyHeader!=null&&validateApiKey(apiKeyHeader)||apiKeyParam!=null&&validateApiKey(apiKeyParam);if(!hasValidApiKey&&!hasValidSession){let referer=request.headers.get("referer");if(referer)try{let refKey=new URL(referer).searchParams.get("apiKey");if(refKey&&validateApiKey(refKey))hasValidApiKey=!0}catch{}}return{hasValidSession,hasValidApiKey}}function stripPrefix(pathname){return pathname||"/"}function createUngitProxy(getPort,validateApiKey){return new Elysia2({prefix:"/ungit"}).all("/*",async({request})=>{return handleProxyRequest(request,getPort,validateApiKey)}).all("/",async({request})=>{return handleProxyRequest(request,getPort,validateApiKey)})}async function handleProxyRequest(request,getPort,validateApiKey){let{hasValidSession,hasValidApiKey}=isAuthed(request,validateApiKey);if(!hasValidSession&&!hasValidApiKey)return new Response(JSON.stringify({error:"Unauthorized -- provide a valid API key or session"}),{status:401,headers:{"Content-Type":"application/json"}});let sessionCookieHeader=null;if(!hasValidSession&&hasValidApiKey){let session=createSession();sessionCookieHeader=`${COOKIE_NAME}=${session.token}; Path=/ungit/; HttpOnly; SameSite=None; Secure; Max-Age=${Math.floor(SESSION_TTL_MS/1000)}`}let port=getPort();if(!port)return new Response(JSON.stringify({error:"Ungit is not running"}),{status:503,headers:{"Content-Type":"application/json"}});let response=await handleHttpProxy(request,port);if(sessionCookieHeader){let headers=new Headers(response.headers);return headers.set("Set-Cookie",sessionCookieHeader),new Response(response.body,{status:response.status,statusText:response.statusText,headers})}return response}async function handleHttpProxy(request,port){let url=new URL(request.url),strippedPath=stripPrefix(url.pathname),upstreamUrl=`http://127.0.0.1:${port}${strippedPath}${url.search}`,upstreamHeaders=new Headers,hopByHopHeaders=new Set(["connection","keep-alive","transfer-encoding","te","trailer","upgrade","proxy-authorization","proxy-authenticate"]);request.headers.forEach((value,key)=>{if(!hopByHopHeaders.has(key.toLowerCase()))upstreamHeaders.set(key,value)}),upstreamHeaders.set("Host",`127.0.0.1:${port}`);try{let upstreamResponse=await fetch(upstreamUrl,{method:request.method,headers:upstreamHeaders,body:request.method!=="GET"&&request.method!=="HEAD"?request.body:void 0,redirect:"manual"}),responseHeaders=new Headers;upstreamResponse.headers.forEach((value,key)=>{if(!STRIP_RESPONSE_HEADERS.has(key.toLowerCase()))responseHeaders.set(key,value)});let contentType=upstreamResponse.headers.get("content-type")||"";if(strippedPath==="/ungit/"&&!contentType.includes("text/html")){let body=await upstreamResponse.text();if(body.trimStart().startsWith("<!DOCTYPE")||body.trimStart().startsWith("<html"))return responseHeaders.set("content-type","text/html; charset=utf-8"),responseHeaders.delete("content-length"),new Response(body,{status:upstreamResponse.status,statusText:upstreamResponse.statusText,headers:responseHeaders});return new Response(body,{status:upstreamResponse.status,statusText:upstreamResponse.statusText,headers:responseHeaders})}return new Response(upstreamResponse.body,{status:upstreamResponse.status,statusText:upstreamResponse.statusText,headers:responseHeaders})}catch(err){return new Response(JSON.stringify({error:"Failed to proxy to Ungit",details:err instanceof Error?err.message:"Unknown error"}),{status:502,headers:{"Content-Type":"application/json"}})}}var SESSION_TTL_MS=86400000,COOKIE_NAME="__vibe_ungit_session",sessions,STRIP_RESPONSE_HEADERS,proxy_default;var init_proxy=__esm(()=>{sessions=new Map;setInterval(cleanupSessions,600000);STRIP_RESPONSE_HEADERS=new Set(["x-frame-options","content-security-policy","x-content-type-options"]);proxy_default=createUngitProxy});function isInteractive(){return!!process.stdout.isTTY&&!!process.stdin.isTTY}function pickOutputMode(flags){if(flags.json)return"json";if(flags.plain)return"plain";if(flags.interactive)return"interactive";return"auto"}function isCi(){return!!process.env.CI||!!process.env.NO_COLOR||process.env.TERM==="dumb"}async function runMultimode(opts){let data=await opts.fetchData(),mode=opts.mode??"auto";if(mode==="json"){let shaped=opts.json?opts.json(data):data;process.stdout.write(`${JSON.stringify(shaped,null,2)}
+`);return}if(mode==="plain"){await opts.plain(data);return}if((mode==="interactive"||isInteractive()&&!isCi())&&!!opts.interactive&&opts.interactive)try{await opts.interactive(data);return}catch{}await opts.plain(data)}function maybePrintJson(flags,data){if(!flags.json)return!1;return process.stdout.write(`${JSON.stringify(data,null,2)}
+`),!0}async function loadCore(){return await import("@opentui/core")}async function interactiveDetail(opts){let core=await loadCore(),{createCliRenderer,BoxRenderable,TextRenderable}=core,renderer=await createCliRenderer({exitOnCtrlC:!0,targetFps:30}),ctx=renderer.root.ctx,root=new BoxRenderable(ctx,{width:"100%",height:"100%",flexDirection:"column",backgroundColor:"#0b0d12"}),title=new TextRenderable(ctx,{content:`  ${opts.title}`,fg:"#8be9fd",height:1}),bodyBox=new BoxRenderable(ctx,{width:"100%",flexGrow:1,paddingLeft:2,paddingRight:2,backgroundColor:"#11141c"}),bodyText=new TextRenderable(ctx,{content:`
+${opts.body}
+`,fg:"#cdd6f4"}),footer=new TextRenderable(ctx,{content:`  ${opts.footer??"q to quit"}`,fg:"#6c7086",height:1});bodyBox.add(bodyText),root.add(title),root.add(bodyBox),root.add(footer),renderer.root.add(root),await new Promise((resolve)=>{let cleanup=()=>{try{renderer.destroy()}catch{}resolve()};renderer.keyInput.on("keypress",(key)=>{if(key.name==="escape"||key.name==="q"||key.name==="return")cleanup()})})}var SECRET_RX=/(token|secret|password|apikey|api_key)/i;function redact(value){if(value===null||value===void 0)return value;if(Array.isArray(value))return value.map(redact);if(typeof value!=="object")return value;let out={};for(let[k,v]of Object.entries(value))out[k]=SECRET_RX.test(k)?"[redacted]":redact(v);return out}var AGENT_BASE_URL=process.env.VIBE_AGENT_URL??"http://localhost:3005",API_KEY=process.env.VIBE_AGENT_API_KEY??"";async function apiFetch(urlPath,options){return fetch(`${AGENT_BASE_URL}${urlPath}`,{...options,headers:{"Content-Type":"application/json","x-agent-api-key":API_KEY,...options?.headers}})}var agentApiKey=null,vibePlugin={capabilities:{storage:"rw",subprocess:!0,audit:!0,telemetry:!0},name:"ungit",version:"1.0.0",description:"Visual Git Client (Ungit)",tags:["frontend","integration"],hasUI:!0,cliCommand:"ungit",apiPrefix:"/api/ungit",publicPaths:["/ungit/"],async onServerStart(app,hostServices){hostServices?.telemetry?.emit("tool.ready",{provider:"git"});let{createUngitRoutes:createUngitRoutes2}=await Promise.resolve().then(() => (init_routes(),exports_routes));app.use(createUngitRoutes2(hostServices));try{agentApiKey=app.decorator?.apiKey??null}catch{agentApiKey=process.env.AGENT_API_KEY??null}let{createUngitProxy:createUngitProxy2}=await Promise.resolve().then(() => (init_proxy(),exports_proxy));app.use(createUngitProxy2(()=>getRunningPort(),(key)=>{if(!agentApiKey)return!1;return key===agentApiKey})),console.log("  Plugin 'ungit' registered routes: /api/ungit, /ungit")},async onServerStop(){await stopUngit(),console.log("  Plugin 'ungit' stopped")},onCliSetup(program){let cmd=program.command("ungit").description("Visual Git Client (Ungit)");cmd.command("status").description("Show Ungit status").option("--json","Emit JSON").option("--plain","Force plain text output").action(async(opts)=>{await runMultimode({mode:pickOutputMode(opts),fetchData:async()=>{return await(await apiFetch("/api/ungit/status")).json()},plain:(data)=>{console.log(JSON.stringify(data,null,2))},interactive:async(data)=>{await interactiveDetail({title:"ungit \u2014 status",body:JSON.stringify(data,null,2)})},json:(data)=>redact(data)})}),cmd.command("install").description("Install Ungit globally via npm").option("--json","Emit JSON").action(async(opts)=>{if(!opts.json)console.log("Installing Ungit...");let data=await(await apiFetch("/api/ungit/install",{method:"POST"})).json();if(maybePrintJson(opts,{ok:!0,action:"install",result:data}))return;console.log(JSON.stringify(data,null,2))}),cmd.command("start").description("Start Ungit").option("--dir <dir>","Working directory for git operations").option("--port <port>","Port to bind to").option("--json","Emit JSON").action(async(opts)=>{let body={};if(opts.dir)body.workingDir=opts.dir;if(opts.port)body.port=parseInt(opts.port,10);let data=await(await apiFetch("/api/ungit/start",{method:"POST",body:JSON.stringify(body)})).json();if(maybePrintJson(opts,{ok:!0,action:"start",result:data}))return;console.log(JSON.stringify(data,null,2))}),cmd.command("stop").description("Stop Ungit").option("--json","Emit JSON").action(async(opts)=>{let data=await(await apiFetch("/api/ungit/stop",{method:"POST"})).json();if(maybePrintJson(opts,{ok:!0,action:"stop",result:data}))return;console.log(JSON.stringify(data,null,2))}),cmd.command("restart").description("Restart Ungit with optional new working directory").option("--dir <dir>","New working directory").option("--json","Emit JSON").action(async(opts)=>{let body={};if(opts.dir)body.workingDir=opts.dir;let data=await(await apiFetch("/api/ungit/restart",{method:"POST",body:JSON.stringify(body)})).json();if(maybePrintJson(opts,{ok:!0,action:"restart",result:data}))return;console.log(JSON.stringify(data,null,2))})}},src_default=vibePlugin;export{vibePlugin,src_default as default};

package/dist/lib/process.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Ungit Process Lifecycle Manager
+ *
+ * Manages starting, stopping, and monitoring the Ungit child process.
+ * Ungit binds to 127.0.0.1 only -- access is via the agent reverse proxy.
+ */
+import type { UngitStatus } from "../types.js";
+/**
+ * Find an available port in the range [DEFAULT_PORT, PORT_RANGE_END].
+ */
+export declare function findAvailablePort(preferred?: number): Promise<number>;
+/**
+ * Check whether Ungit is installed (globally or locally).
+ */
+export declare function checkInstallation(): Promise<{
+    installed: boolean;
+    binaryPath?: string;
+}>;
+/**
+ * Install Ungit globally via npm.
+ */
+export declare function installUngit(): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Start Ungit as a child process.
+ */
+export declare function startUngit(options?: {
+    workingDir?: string;
+    port?: number;
+}): Promise<{
+    pid: number;
+    port: number;
+}>;
+/**
+ * Stop the Ungit process.
+ */
+export declare function stopUngit(): Promise<void>;
+/**
+ * Get the current status of Ungit.
+ */
+export declare function getStatus(): UngitStatus;
+/**
+ * Get the port Ungit is currently running on.
+ */
+export declare function getRunningPort(): number | null;

package/dist/lib/proxy.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Ungit Reverse Proxy
+ *
+ * Proxies all requests from /ungit/* to the local Ungit instance.
+ * Handles:
+ *   - Session cookie authentication (Ungit internal requests can't send API key headers)
+ *   - HTTP reverse proxying with streaming
+ *   - WebSocket bridging for socket.io (Ungit uses socket.io for real-time updates)
+ *   - Header stripping (X-Frame-Options, CSP) to allow iframe embedding
+ */
+/**
+ * Create the reverse proxy Elysia instance.
+ *
+ * @param getPort - Returns the port Ungit is running on, or null if not running
+ * @param validateApiKey - Validates an API key string against the agent's key
+ */
+export declare function createUngitProxy(getPort: () => number | null, validateApiKey: (key: string) => boolean): any;
+export default createUngitProxy;

package/dist/routes.d.ts

@@ -0,0 +1,168 @@
+/**
+ * REST API routes for the Ungit plugin.
+ *
+ * Prefix: /api/ungit
+ *
+ * Routes:
+ *   GET  /status   - Current Ungit status (installed, running, port, pid)
+ *   POST /install  - Install Ungit globally via npm
+ *   POST /start    - Start Ungit with optional working directory and port
+ *   POST /stop     - Stop the Ungit process
+ *   POST /restart  - Restart Ungit with optional new working directory
+ */
+import { Elysia } from "elysia";
+import type { HostServices } from "./types.js";
+export declare function createUngitRoutes(_hostServices: HostServices): Elysia<"/api/ungit", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    api: {
+        ungit: {
+            status: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: {
+                            installed: boolean;
+                            installing: boolean;
+                            running: boolean;
+                            pid: number | undefined;
+                            port: number | undefined;
+                            workingDir: string | undefined;
+                            error: string | undefined;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        ungit: {
+            install: {
+                post: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: {
+                            error: string;
+                            message?: undefined;
+                            binaryPath?: undefined;
+                        } | {
+                            message: string;
+                            binaryPath: string | undefined;
+                            error?: undefined;
+                        } | {
+                            message: string;
+                            error?: undefined;
+                            binaryPath?: undefined;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        ungit: {
+            start: {
+                post: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: {
+                            error: string;
+                            message?: undefined;
+                            pid?: undefined;
+                            port?: undefined;
+                            workingDir?: undefined;
+                        } | {
+                            message: string;
+                            pid: number;
+                            port: number;
+                            workingDir: string;
+                            error?: undefined;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        ungit: {
+            stop: {
+                post: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: {
+                            message: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        ungit: {
+            restart: {
+                post: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: {
+                            error: string;
+                            message?: undefined;
+                            pid?: undefined;
+                            port?: undefined;
+                            workingDir?: undefined;
+                        } | {
+                            message: string;
+                            pid: number;
+                            port: number;
+                            workingDir: string;
+                            error?: undefined;
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Type declarations for the vibe-plugin-git (Ungit) plugin.
+ *
+ * All interfaces are defined locally so the plugin does not hard-import
+ * from the core agent package.  At runtime the host agent injects concrete
+ * implementations via HostServices.
+ */
+import type { Elysia } from "elysia";
+import type { Command } from "commander";
+export interface StorageProvider {
+    get(namespace: string, key: string): Promise<string | null>;
+    set(namespace: string, key: string, value: string): Promise<void>;
+    delete(namespace: string, key: string): Promise<boolean>;
+    keys(namespace: string): Promise<string[]>;
+}
+export interface EventBus {
+    emit(event: string, payload: unknown): void;
+    on(event: string, handler: (payload: unknown) => void): void;
+    off(event: string, handler: (payload: unknown) => void): void;
+}
+export interface ServiceRegistry {
+    get<T = unknown>(name: string): T | undefined;
+}
+export interface HostServices {
+    telemetry?: {
+        emit: (name: string, payload?: Record<string, unknown>) => void;
+    };
+    storage: StorageProvider;
+    eventBus?: EventBus;
+    serviceRegistry?: ServiceRegistry;
+}
+export interface PluginCapabilities {
+    storage?: "none" | "read" | "rw";
+    secrets?: "none" | "read" | "rw";
+    gateway?: boolean;
+    broadcast?: boolean;
+    subprocess?: boolean;
+    audit?: boolean;
+    telemetry?: boolean;
+}
+export interface VibePlugin {
+    capabilities?: PluginCapabilities;
+    name: string;
+    version: string;
+    description?: string;
+    tags?: string[];
+    hasUI?: boolean;
+    cliCommand?: string;
+    apiPrefix?: string;
+    publicPaths?: string[];
+    onCliSetup?: (program: Command) => void | Promise<void>;
+    onServerStart?: (app: Elysia, hostServices: HostServices) => void | Promise<void>;
+    onServerStop?: () => void | Promise<void>;
+}
+export interface UngitStatus {
+    installed: boolean;
+    running: boolean;
+    pid?: number;
+    port?: number;
+    workingDir?: string;
+    error?: string;
+}
+export interface StartBody {
+    workingDir?: string;
+    port?: number;
+}

package/dist/utils/interactive.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Reusable opentui primitives for read-style commands.
+ *
+ *   • interactiveTable — a focusable single-column list with a detail pane
+ *     on the right. The user picks rows with ↑/↓; we render the detail of
+ *     the focused row in a fixed-width panel. Enter exits and runs an
+ *     optional callback (e.g. print full detail to stdout). q/Esc cancels.
+ *
+ *   • interactiveDetail — a static key/value panel (great for `vibe profile
+ *     show`, `vibe info`, etc.). Mostly identical to plain output but inside
+ *     the alternate screen so it's pretty.
+ *
+ * Both helpers throw if @opentui/core fails to import — callers should pair
+ * them with a plain fallback through `runMultimode`.
+ */
+export interface TableRow {
+    /** Stable identifier — exposed to onSelect. */
+    id: string;
+    /** Short label rendered in the left pane. */
+    label: string;
+    /** Optional one-line muted hint shown below the label. */
+    hint?: string;
+    /** Detail rendered in the right pane (multiline, ANSI ok). */
+    detail: string;
+}
+export interface InteractiveTableOptions {
+    title: string;
+    rows: TableRow[];
+    /** Footer hint — overrides the default `↑/↓ navigate · Enter select · q quit`. */
+    footer?: string;
+    /** Width of the left list pane in columns. Default: 28. */
+    listWidth?: number;
+    /**
+     * Called when the user hits Enter on a row. If omitted, Enter quits.
+     * The handler runs AFTER the renderer is destroyed, so it's free to
+     * write to stdout.
+     */
+    onSelect?: (row: TableRow) => void | Promise<void>;
+}
+/**
+ * Render a focusable list with a live detail pane. Resolves once the user
+ * hits Enter or quits.
+ */
+export declare function interactiveTable(opts: InteractiveTableOptions): Promise<TableRow | null>;
+export interface InteractiveDetailOptions {
+    title: string;
+    /** Pre-rendered ANSI body (may be multiline). */
+    body: string;
+    /** Footer hint. Default: `q to quit`. */
+    footer?: string;
+}
+/**
+ * Static key-value detail screen. Mostly used for `show` style commands
+ * when the user wants the alt-screen polish; equivalent content is
+ * available via the plain renderer.
+ */
+export declare function interactiveDetail(opts: InteractiveDetailOptions): Promise<void>;

package/dist/utils/multimode.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Multi-mode output dispatcher.
+ *
+ * Every read-style command (list/show/status/dashboard) should funnel its
+ * output through `runMultimode`. The data is fetched ONCE by `fetchData`,
+ * then handed to one of three renderers:
+ *
+ *   • interactive — opentui UI (default in TTY when an interactive renderer
+ *     is provided AND @opentui/core imports cleanly)
+ *   • plain       — ANSI text written to stdout (the legacy / pipe-friendly
+ *     output)
+ *   • json        — `JSON.stringify(data, null, 2)` to stdout (or a
+ *     custom shaper) — friendly for jq/scripting
+ *
+ * Mutating commands (start/stop/install/...) typically don't need this —
+ * they print progress and exit. They MAY still call `runMultimode` to emit
+ * a result object in JSON when `--json` is set; see `pickOutputMode`.
+ *
+ * The selection rules:
+ *
+ *   ┌─────────────────────┬──────────────────────────────────────────────┐
+ *   │ explicit --json     │ json renderer (or default JSON.stringify)    │
+ *   │ explicit --plain    │ plain renderer                               │
+ *   │ stdout is not a TTY │ plain renderer                               │
+ *   │ NO_COLOR, CI=true   │ plain renderer                               │
+ *   │ no interactive fn   │ plain renderer                               │
+ *   │ otherwise           │ interactive renderer (falls back to plain    │
+ *   │                     │ if @opentui/core fails to import)            │
+ *   └─────────────────────┴──────────────────────────────────────────────┘
+ */
+export type OutputMode = "auto" | "interactive" | "plain" | "json";
+export interface OutputFlags {
+    json?: boolean;
+    plain?: boolean;
+    interactive?: boolean;
+}
+export interface MultimodeOptions<T> {
+    /** Pure data fetcher. Called once. */
+    fetchData: () => Promise<T> | T;
+    /** Plain-text renderer. Required — every command needs a pipe-friendly fallback. */
+    plain: (data: T) => void | Promise<void>;
+    /**
+     * Optional opentui renderer. Only used when stdout is a TTY and opentui
+     * imports cleanly. If omitted or it fails, we fall back to `plain`.
+     */
+    interactive?: (data: T) => Promise<void>;
+    /**
+     * Optional JSON shaper. Defaults to `JSON.stringify(data, null, 2)`.
+     * Override when you need to redact secrets or reshape for scripting.
+     */
+    json?: (data: T) => unknown;
+    /** Output mode (resolved from CLI flags by `pickOutputMode`). */
+    mode?: OutputMode;
+}
+/**
+ * Resolve the desired output mode from CLI flags. The caller should pass the
+ * merged opts of the local command + the global program (since `--json`
+ * lives on the program level too).
+ */
+export declare function pickOutputMode(flags: OutputFlags): OutputMode;
+export declare function runMultimode<T>(opts: MultimodeOptions<T>): Promise<void>;
+/**
+ * Convenience: emit the data shape as JSON (used by mutating commands that
+ * still want a `--json` opt-in for scripting). Returns true if it printed.
+ */
+export declare function maybePrintJson(flags: OutputFlags, data: unknown): boolean;

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@vibecontrols/vibe-plugin-tool-git",
+  "version": "2026.508.3",
+  "main": "./dist/index.js",
+  "type": "module",
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --minify-syntax --minify-whitespace --external elysia --external @opentui/core && tsc --emitDeclarationOnly --declaration --outDir ./dist",
+    "dev": "tsc --watch",
+    "lint": "eslint ./src",
+    "format": "bunx prettier . --write",
+    "format:check": "bunx prettier . --check",
+    "type:check": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "prebuild": "bun run clean",
+    "prepublishOnly": "bun run build",
+    "sanity": "bun run format:check && bun run lint && bun run type:check && bun run build"
+  },
+  "keywords": [
+    "vibecontrols",
+    "vibe",
+    "vibe-plugin",
+    "ungit",
+    "git",
+    "visual-git",
+    "bun"
+  ],
+  "author": {
+    "name": "Vignesh T.V",
+    "email": "vignesh@burdenoff.com",
+    "url": "https://github.com/tvvignesh"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "description": "Visual Git Client (Ungit) — reverse-proxied through the VibeControls agent",
+  "dependencies": {
+    "ungit": "^1.5.28"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/bun": "^1.2.10",
+    "commander": "^14.0.3",
+    "elysia": "^1.3.0",
+    "eslint": "^9.30.1",
+    "globals": "^17.3.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.56.0"
+  },
+  "peerDependencies": {
+    "elysia": ">=1.3.0"
+  },
+  "peerDependenciesMeta": {
+    "elysia": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/algoshred/vibe-plugin-tool-git.git"
+  },
+  "bugs": {
+    "url": "https://github.com/algoshred/vibe-plugin-tool-git/issues"
+  },
+  "homepage": "https://vibecontrols.com",
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://verdaccio.tooling.internal.burdenoff.com/"
+  },
+  "files": [
+    "dist/**/*",
+    "!dist/**/*.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "overrides": {
+    "lodash": "4.18.1",
+    "lodash-es": ">=4.17.21",
+    "dompurify": ">=3.3.4",
+    "fast-xml-parser": ">=4.5.5",
+    "@xmldom/xmldom": ">=0.8.12",
+    "swiper": ">=12.1.2",
+    "brace-expansion": ">=1.1.13",
+    "follow-redirects": ">=1.15.12",
+    "smol-toml": ">=1.6.1",
+    "axios": ">=1.15.0",
+    "flatted": ">=3.4.1",
+    "yaml": ">=2.8.3",
+    "picomatch": ">=2.3.2",
+    "immutable": ">=3.8.3",
+    "minimatch": ">=3.1.3"
+  }
+}