chamba 0.7.0 → 0.9.0

package/dist/commands/doctor.js

@@ -1,29 +1 @@
-// =========================================================================================================================================
-// src/commands/doctor.ts - Host readiness check for chamba
-// Computes readiness checks and returns any failures; the caller decides what to print.
-// =========================================================================================================================================
-import { spawnSync } from "node:child_process";
-// Returns true if the given CLI tool is resolvable in the system PATH
-function commandExists(cmd) {
-    // Single command string (not an args array) under shell: true sidesteps Node's DEP0190; cmd is a hardcoded internal name.
-    const r = spawnSync(`command -v ${cmd}`, {
-        shell: true,
-        encoding: "utf8",
-    });
-    return r.status === 0;
-}
-export async function run() {
-    const errors = [];
-    function check(label, ok, detail) {
-        if (!ok)
-            errors.push(`${label}${detail ? `: ${detail}` : ""}`);
-    }
-    // --- Docker installed ----------------------------------------------------------------------------------------------------------------
-    const hasDocker = commandExists("docker");
-    check("Docker installed", hasDocker, hasDocker ? undefined : "'docker' not found in PATH");
-    // --- Docker running ------------------------------------------------------------------------------------------------------------------
-    const dockerInfo = spawnSync("docker", ["info"], { encoding: "utf8", stdio: "pipe" });
-    check("Docker running", dockerInfo.status === 0, dockerInfo.status === 0 ? undefined : "Docker daemon not responding");
-    // --- Report --------------------------------------------------------------------------------------------------------------------------
-    return { ok: errors.length === 0, errors };
-}
+import{spawnSync as c}from"node:child_process";function d(n){return c(`command -v ${n}`,{shell:!0,encoding:"utf8"}).status===0}async function f(){const n=[];function o(s,u,r){u||n.push(`${s}${r?`: ${r}`:""}`)}const e=d("docker");o("Docker installed",e,e?void 0:"'docker' not found in PATH");const t=c("docker",["info"],{encoding:"utf8",stdio:"pipe"});return o("Docker running",t.status===0,t.status===0?void 0:"Docker daemon not responding"),{ok:n.length===0,errors:n}}export{f as run};

package/dist/commands/menu.js

@@ -1,80 +1 @@
-// =========================================================================================================================================
-// src/commands/menu.ts - chamba workspace menu
-// Shows workspace status box with profile, non-git notice, and shadow info.
-// =========================================================================================================================================
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { styleText } from "node:util";
-import { cancel, isCancel, log, select } from "@clack/prompts";
-import { readChambaYaml } from "../lib/chamba-yaml.js";
-import { DEFAULT_PROFILE } from "../lib/constants.js";
-import { readActiveProfile } from "../lib/workspace-identity.js";
-export async function run(args) {
-    const { ctx, activeCount, workspaceRunning, version } = args;
-    // --- Read workspace config -----------------------------------------------------------------------------------------------------------
-    const hasGit = existsSync(join(ctx.workspaceRoot, ".git"));
-    // Profiles come from chamba.yaml (the source of truth). The lock file's active profile can be stale (e.g. a
-    // profile since removed from chamba.yaml), so only trust it when it still exists. Mirror selectProfile() in
-    // dev.ts: a single profile is no real choice, so omit the line entirely rather than show noise.
-    let profileNames = [];
-    try {
-        profileNames = Object.keys(readChambaYaml(ctx.workspaceRoot)?.profiles ?? {});
-    }
-    catch {
-        // chamba.yaml is validated upstream; on any unexpected read error just omit the profile line.
-    }
-    const cachedProfile = readActiveProfile(ctx.workspaceId);
-    // Fall back to a profile that actually exists (default if present, else the first) so the box never
-    // shows a name absent from chamba.yaml. The line only renders when there are >1, so the list is non-empty there.
-    const fallbackProfile = profileNames.includes(DEFAULT_PROFILE) ? DEFAULT_PROFILE : (profileNames[0] ?? DEFAULT_PROFILE);
-    const activeProfile = cachedProfile && profileNames.includes(cachedProfile) ? cachedProfile : fallbackProfile;
-    // --- Status line ---------------------------------------------------------------------------------------------------------------------
-    // A single bold header line: version, then the workspace - with its container state shown only while
-    // running - then an optional profile. Anything else (other containers, git) drops to one quieter
-    // notice line below.
-    const boldSep = styleText(["bold", "gray"], " · ");
-    // Append the running state (green) only when the container is up. A stopped container is the resting
-    // default, so "container down" carries no signal - drop it and just name the workspace.
-    const workspaceSegment = workspaceRunning
-        ? `${styleText("bold", `${ctx.workspaceId} container`)} ${styleText(["bold", "green"], "up")}`
-        : styleText("bold", ctx.workspaceId);
-    const segments = [styleText("bold", `chamba v${version}`), workspaceSegment];
-    if (profileNames.length > 1)
-        segments.push(styleText("bold", `profile: ${activeProfile}`));
-    const header = segments.join(boldSep);
-    // --- Notices -------------------------------------------------------------------------------------------------------------------------
-    // One quieter line under the header, its parts joined by a gray dot separator. Order: other containers,
-    // git. It only renders when at least one part applies, so the common case is just the header.
-    const parts = [];
-    // activeCount includes this workspace's container when it is up, so subtract it to count only the others.
-    // The number always reads as "besides this one", and a lone running workspace shows nothing.
-    const others = activeCount - (workspaceRunning ? 1 : 0);
-    if (others > 0)
-        parts.push(`${others} other container${others === 1 ? "" : "s"} up`);
-    // No git means agent changes are not tracked. dev.ts only feeds this into the agent's context docs, so this
-    // is the only warning a person sees - keep it here when the workspace is not a git repo.
-    if (!hasGit)
-        parts.push("no git");
-    // The whole line is gray so it stays quieter than the bold header above it.
-    const notices = parts.length > 0 ? [styleText("gray", parts.join(" · "))] : [];
-    // Print the header and any notices as clack log lines. log.message already opens with a bar-gutter line, so
-    // it separates itself from whatever precedes it - no extra blank line needed. The gray gutter lines up with
-    // the select menu that follows.
-    log.message([header, ...notices]);
-    const options = [
-        // Two doors into the same container, web first because that is where the work happens. The shell is
-        // the service hatch: it opens no browser, and the greeting inside still names the interface's URL.
-        { value: "web", label: "Web interface", hint: "open this workspace in your browser" },
-        { value: "shell", label: "Container shell", hint: "a shell inside the container, no browser" },
-        ...(workspaceRunning ? [{ value: "stop", label: "Stop container", hint: "stops this workspace's container" }] : []),
-        { value: "settings", label: "Settings", hint: "git mode, shadow paths, web, rebuild" },
-        { value: "advanced", label: "Advanced", hint: "stop, clear, remove, uninstall" },
-        { value: "quit", label: "Quit" },
-    ];
-    const action = await select({ message: "Menu:", options });
-    if (isCancel(action)) {
-        cancel();
-        return "quit";
-    }
-    return action;
-}
+import{existsSync as y}from"node:fs";import{join as $}from"node:path";import{styleText as e}from"node:util";import{cancel as P,isCancel as S,log as j,select as x}from"@clack/prompts";import{readChambaYaml as C}from"../lib/chamba-yaml.js";import{DEFAULT_PROFILE as r}from"../lib/constants.js";import{readActiveProfile as I}from"../lib/workspace-identity.js";async function T(p){const{ctx:o,activeCount:h,workspaceRunning:s,version:u}=p,d=y($(o.workspaceRoot,".git"));let t=[];try{t=Object.keys(C(o.workspaceRoot)?.profiles??{})}catch{}const a=I(o.workspaceId),m=t.includes(r)?r:t[0]??r,b=a&&t.includes(a)?a:m,f=e(["bold","gray"]," \xB7 "),g=s?`${e("bold",`${o.workspaceId} container`)} ${e(["bold","green"],"up")}`:e("bold",o.workspaceId),l=[e("bold",`chamba v${u}`),g];t.length>1&&l.push(e("bold",`profile: ${b}`));const w=l.join(f),n=[],i=h-(s?1:0);i>0&&n.push(`${i} other container${i===1?"":"s"} up`),d||n.push("no git");const v=n.length>0?[e("gray",n.join(" \xB7 "))]:[];j.message([w,...v]);const k=[{value:"web",label:"Web interface",hint:"open this workspace in your browser"},{value:"shell",label:"Container shell",hint:"a shell inside the container, no browser"},...s?[{value:"stop",label:"Stop container",hint:"stops this workspace's container"}]:[],{value:"settings",label:"Settings",hint:"git mode, shadow paths, web, rebuild"},{value:"advanced",label:"Advanced",hint:"stop, clear, remove, uninstall"},{value:"quit",label:"Quit"}],c=await x({message:"Menu:",options:k});return S(c)?(P(),"quit"):c}export{T as run};

package/dist/commands/onboard.js

@@ -1,230 +1,6 @@
-// =========================================================================================================================================
-// src/commands/onboard.ts - First-time workspace setup
-// Creates chamba.yaml, registers the workspace, and returns WorkspaceContext (or null if cancelled).
-// =========================================================================================================================================
-import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { homedir } from "node:os";
-import { basename, join } from "node:path";
-import { cancel, confirm, intro, isCancel, log, outro, select, text } from "@clack/prompts";
-import { buildDefaultChambaYaml, readChambaYaml, slugifyForWorkspaceId, validateWorkspaceId, writeChambaYaml, } from "../lib/chamba-yaml.js";
-import { CHAMBA_YAML } from "../lib/constants.js";
-import { gitEnv } from "../lib/git-env.js";
-import { readWebRange } from "../lib/global-config.js";
-import { safeRmSync } from "../lib/safe-rm.js";
-import { ensureWebPort } from "../lib/webterm.js";
-import { checkCollision, deriveContainerName, findChambaYamlDir, findOrphanWorkspaceDir, getWorkspaceDir, initWorkspaceDir, readLockFile, } from "../lib/workspace-identity.js";
-/** Derive a unique workspace_id, appending -2, -3, etc. if the base collides with another workspace. */
-function deriveUniqueWorkspaceId(baseId, workspaceRoot) {
-    if (checkCollision(baseId, workspaceRoot) === "ok")
-        return baseId;
-    for (let i = 2; i <= 99; i++) {
-        const candidate = `${baseId}-${i}`;
-        if (checkCollision(candidate, workspaceRoot) === "ok")
-            return candidate;
-    }
-    return baseId; // fallback (collision handled later in onboarding)
-}
-function tryGetGitRoot(cwd) {
-    try {
-        return execSync("git rev-parse --show-toplevel", { encoding: "utf8", cwd, stdio: "pipe", env: gitEnv() }).trim();
-    }
-    catch {
-        return null;
-    }
-}
-// Public entry point. Wraps the interactive setup so an aborted run (the user cancels a prompt, or an
-// unexpected error) rolls back a chamba.yaml we created this session, leaving the directory as we found it.
-export async function run(cwd) {
-    // Records a chamba.yaml this run creates (never a pre-existing one) so the finally can remove it.
-    const created = { yamlPath: null };
-    let result = null;
-    try {
-        result = await runSetup(cwd, created);
-        return result;
-    }
-    finally {
-        // Non-completion means cancelled (result stays null) or threw (also null). Success assigns result,
-        // so a created config survives only when setup actually finished.
-        if (!result && created.yamlPath)
-            safeRmSync(created.yamlPath, { force: true });
-    }
-}
-async function runSetup(cwd, created) {
-    const toTildePath = (p) => (p.startsWith(homedir()) ? p.replace(homedir(), "~") : p);
-    // --- Detect context ------------------------------------------------------------------------------------------------------------------
-    const gitRoot = tryGetGitRoot(cwd);
-    const searchRoot = gitRoot ?? cwd;
-    const yamlDir = findChambaYamlDir(searchRoot);
-    // --- Intro ---------------------------------------------------------------------------------------------------------------------------
-    process.stdout.write("\n");
-    intro("chamba · new workspace");
-    process.stdout.write("\n");
-    let workspaceRoot;
-    let yaml;
-    if (yamlDir) {
-        // --- chamba.yaml found: read and validate ----------------------------------------------------------------------------------------
-        let existing;
-        try {
-            existing = readChambaYaml(yamlDir);
-        }
-        catch (err) {
-            log.error(`Found ${join(yamlDir, CHAMBA_YAML)} but it is invalid: ${err instanceof Error ? err.message : err}`);
-            cancel("Setup cancelled.");
-            return null;
-        }
-        if (!existing) {
-            log.error(`Could not read ${join(yamlDir, CHAMBA_YAML)}.`);
-            cancel("Setup cancelled.");
-            return null;
-        }
-        workspaceRoot = yamlDir;
-        yaml = existing;
-        const ok = await confirm({ message: `Set up chamba for: ${toTildePath(workspaceRoot)}?` });
-        if (isCancel(ok) || !ok) {
-            cancel("Setup cancelled.");
-            return null;
-        }
-    }
-    else {
-        // --- No chamba.yaml: create one interactively ------------------------------------------------------------------------------------
-        // Choose workspace root
-        const suggestedRoot = gitRoot ?? cwd;
-        const options = [
-            { value: suggestedRoot, label: toTildePath(suggestedRoot), hint: gitRoot ? "git root" : "current directory" },
-        ];
-        if (gitRoot !== null && gitRoot !== cwd) {
-            options.push({ value: cwd, label: toTildePath(cwd), hint: "current directory" });
-        }
-        options.push({ value: "__custom__", label: "Enter a different path…" });
-        const rootChoice = await select({ message: "Workspace root:", options });
-        if (isCancel(rootChoice)) {
-            cancel("Setup cancelled.");
-            return null;
-        }
-        if (rootChoice === "__custom__") {
-            const customPath = await text({
-                message: "Workspace root path:",
-                placeholder: `e.g. ${suggestedRoot}`,
-                validate: (v) => {
-                    const p = (v ?? "").trim();
-                    if (p.length === 0)
-                        return "Path cannot be empty";
-                    if (!existsSync(p))
-                        return `Directory not found: ${p}`;
-                    return undefined;
-                },
-            });
-            if (isCancel(customPath)) {
-                cancel("Setup cancelled.");
-                return null;
-            }
-            workspaceRoot = customPath.trim();
-        }
-        else {
-            workspaceRoot = rootChoice;
-        }
-        // Ask for workspace ID
-        const defaultId = slugifyForWorkspaceId(basename(workspaceRoot));
-        const idInput = await text({
-            message: "Workspace ID:",
-            placeholder: defaultId,
-            defaultValue: defaultId,
-            validate: (v) => validateWorkspaceId((v ?? "").trim() || defaultId),
-        });
-        if (isCancel(idInput)) {
-            cancel("Setup cancelled.");
-            return null;
-        }
-        const inputId = idInput.trim() || defaultId;
-        // Auto-resolve collisions with numeric suffix
-        const workspaceId = deriveUniqueWorkspaceId(inputId, workspaceRoot);
-        // Build and write chamba.yaml
-        yaml = buildDefaultChambaYaml(workspaceId);
-        writeChambaYaml(workspaceRoot, yaml);
-        created.yamlPath = join(workspaceRoot, CHAMBA_YAML);
-        log.success(`Created ${toTildePath(created.yamlPath)}`);
-    }
-    // --- Non-git warning -----------------------------------------------------------------------------------------------------------------
-    const isNonGit = tryGetGitRoot(workspaceRoot) === null;
-    if (isNonGit) {
-        log.warn("No version control detected. Agent changes won't be tracked.");
-        const ack = await confirm({ message: "Continue without git?" });
-        if (isCancel(ack) || !ack) {
-            cancel("Setup cancelled.");
-            return null;
-        }
-    }
-    // --- Collision / orphan check --------------------------------------------------------------------------------------------------------
-    const workspaceId = yaml.workspace_id;
-    const collision = checkCollision(workspaceId, workspaceRoot);
-    if (collision === "collision") {
-        const existingLock = readLockFile(workspaceId);
-        log.error(`Workspace ID "${workspaceId}" is already used by another workspace:\n` +
-            `  ${existingLock}\n\n` +
-            `Choose a different workspace_id in chamba.yaml.`);
-        const newId = await text({
-            message: "New workspace ID:",
-            validate: (v) => {
-                const id = (v ?? "").trim();
-                const err = validateWorkspaceId(id);
-                if (err)
-                    return err;
-                const c = checkCollision(id, workspaceRoot);
-                if (c === "collision")
-                    return `"${id}" is also taken`;
-                return undefined;
-            },
-        });
-        if (isCancel(newId)) {
-            cancel("Setup cancelled.");
-            return null;
-        }
-        yaml.workspace_id = newId.trim();
-        writeChambaYaml(workspaceRoot, yaml);
-        log.info(`Updated workspace_id to "${yaml.workspace_id}"`);
-    }
-    else {
-        // Check for orphan (workspace_id changed in yaml but old dir still points here)
-        const orphanId = findOrphanWorkspaceDir(workspaceRoot);
-        if (orphanId && orphanId !== workspaceId) {
-            log.warn(`Found orphaned workspace cache "${orphanId}" pointing to this workspace.`);
-            const action = await select({
-                message: "How to handle the orphaned cache?",
-                options: [
-                    { value: "realign", label: `Revert workspace_id to "${orphanId}"`, hint: "keeps existing cache" },
-                    { value: "clean", label: `Use "${workspaceId}" (clean slate)`, hint: "deletes old cache" },
-                ],
-            });
-            if (isCancel(action)) {
-                cancel("Setup cancelled.");
-                return null;
-            }
-            if (action === "realign") {
-                yaml.workspace_id = orphanId;
-                writeChambaYaml(workspaceRoot, yaml);
-                log.info(`Reverted workspace_id to "${orphanId}"`);
-            }
-            else {
-                // Clean slate - remove orphaned dir
-                safeRmSync(getWorkspaceDir(orphanId), { recursive: true, force: true });
-                log.info(`Removed orphaned cache for "${orphanId}"`);
-            }
-        }
-    }
-    // --- Initialize workspace dir --------------------------------------------------------------------------------------------------------
-    const finalId = yaml.workspace_id;
-    initWorkspaceDir(finalId, workspaceRoot);
-    // A new workspace takes its sticky web port at creation time (the spec's second calm moment).
-    const assignedWebPort = ensureWebPort(finalId, readWebRange());
-    if (assignedWebPort.ok)
-        log.info(`Web agent interface port: ${assignedWebPort.port} (sticky for this workspace)`);
-    log.success(`Config written to ${toTildePath(getWorkspaceDir(finalId))}`);
-    outro("Setup complete.");
-    return {
-        workspaceId: finalId,
-        workspaceRoot,
-        containerName: deriveContainerName(finalId),
-        workspaceDir: getWorkspaceDir(finalId),
-    };
-}
+import{execSync as F}from"node:child_process";import{existsSync as G}from"node:fs";import{homedir as P}from"node:os";import{basename as E,join as b}from"node:path";import{cancel as c,confirm as _,intro as L,isCancel as p,log as a,outro as U,select as R,text as S}from"@clack/prompts";import{buildDefaultChambaYaml as H,readChambaYaml as M,slugifyForWorkspaceId as j,validateWorkspaceId as x,writeChambaYaml as W}from"../lib/chamba-yaml.js";import{CHAMBA_YAML as C}from"../lib/constants.js";import{gitEnv as q}from"../lib/git-env.js";import{readWebRange as B}from"../lib/global-config.js";import{safeRmSync as N}from"../lib/safe-rm.js";import{ensureWebPort as O}from"../lib/webterm.js";import{checkCollision as g,deriveContainerName as T,findChambaYamlDir as V,findOrphanWorkspaceDir as z,getWorkspaceDir as I,initWorkspaceDir as J,readLockFile as K}from"../lib/workspace-identity.js";function Q(r,s){if(g(r,s)==="ok")return r;for(let o=2;o<=99;o++){const u=`${r}-${o}`;if(g(u,s)==="ok")return u}return r}function Y(r){try{return F("git rev-parse --show-toplevel",{encoding:"utf8",cwd:r,stdio:"pipe",env:q()}).trim()}catch{return null}}async function me(r){const s={yamlPath:null};let o=null;try{return o=await X(r,s),o}finally{!o&&s.yamlPath&&N(s.yamlPath,{force:!0})}}async function X(r,s){const o=e=>e.startsWith(P())?e.replace(P(),"~"):e,u=Y(r),m=V(u??r);process.stdout.write(`
+`),L("chamba \xB7 new workspace"),process.stdout.write(`
+`);let t,i;if(m){let e;try{e=M(m)}catch(l){return a.error(`Found ${b(m,C)} but it is invalid: ${l instanceof Error?l.message:l}`),c("Setup cancelled."),null}if(!e)return a.error(`Could not read ${b(m,C)}.`),c("Setup cancelled."),null;t=m,i=e;const n=await _({message:`Set up chamba for: ${o(t)}?`});if(p(n)||!n)return c("Setup cancelled."),null}else{const e=u??r,n=[{value:e,label:o(e),hint:u?"git root":"current directory"}];u!==null&&u!==r&&n.push({value:r,label:o(r),hint:"current directory"}),n.push({value:"__custom__",label:"Enter a different path\u2026"});const l=await R({message:"Workspace root:",options:n});if(p(l))return c("Setup cancelled."),null;if(l==="__custom__"){const w=await S({message:"Workspace root path:",placeholder:`e.g. ${e}`,validate:v=>{const $=(v??"").trim();if($.length===0)return"Path cannot be empty";if(!G($))return`Directory not found: ${$}`}});if(p(w))return c("Setup cancelled."),null;t=w.trim()}else t=l;const d=j(E(t)),k=await _({message:`Workspace ID "${d}"?`,initialValue:!0});if(p(k))return c("Setup cancelled."),null;let y=d;if(!k){const w=await S({message:"Workspace ID:",placeholder:d,validate:v=>x((v??"").trim())});if(p(w))return c("Setup cancelled."),null;y=w.trim()}const A=Q(y,t);i=H(A),W(t,i),s.yamlPath=b(t,C),a.success(`Created ${o(s.yamlPath)}`)}if(Y(t)===null){a.warn("No version control detected. Agent changes won't be tracked.");const e=await _({message:"Continue without git?"});if(p(e)||!e)return c("Setup cancelled."),null}const h=i.workspace_id;if(g(h,t)==="collision"){const e=K(h);a.error(`Workspace ID "${h}" is already used by another workspace:
+  ${e}
+
+Choose a different workspace_id in chamba.yaml.`);const n=await S({message:"New workspace ID:",validate:l=>{const d=(l??"").trim(),k=x(d);if(k)return k;if(g(d,t)==="collision")return`"${d}" is also taken`}});if(p(n))return c("Setup cancelled."),null;i.workspace_id=n.trim(),W(t,i),a.info(`Updated workspace_id to "${i.workspace_id}"`)}else{const e=z(t);if(e&&e!==h){a.warn(`Found orphaned workspace cache "${e}" pointing to this workspace.`);const n=await R({message:"How to handle the orphaned cache?",options:[{value:"realign",label:`Revert workspace_id to "${e}"`,hint:"keeps existing cache"},{value:"clean",label:`Use "${h}" (clean slate)`,hint:"deletes old cache"}]});if(p(n))return c("Setup cancelled."),null;n==="realign"?(i.workspace_id=e,W(t,i),a.info(`Reverted workspace_id to "${e}"`)):(N(I(e),{recursive:!0,force:!0}),a.info(`Removed orphaned cache for "${e}"`))}}const f=i.workspace_id;J(f,t);const D=O(f,B());return D.ok&&a.info(`Web agent interface port: ${D.port} (sticky for this workspace)`),a.success(`Config written to ${o(I(f))}`),U("Setup complete."),{workspaceId:f,workspaceRoot:t,containerName:T(f),workspaceDir:I(f)}}export{me as run};