@ashlr/stack 0.1.1 → 0.2.2

package/src/commands/env.ts

@@ -1,87 +0,0 @@
-import { defineCommand } from "citty";
-import {
-  isPhantomInstalled,
-  listSecrets,
-  readConfig,
-} from "@ashlr/stack-core";
-import { colors, intro, outro, outroError } from "../ui.ts";
-
-/**
- * `stack env show [--env prod]` — pretty-print the effective env-var surface
- * for this stack. For each secret the project declares, show whether it's
- * present in the Phantom vault (masked) or missing. Designed for debugging
- * "why does my app boot without Supabase?" kinds of questions.
- */
-export const envCommand = defineCommand({
-  meta: {
-    name: "env",
-    description: "Inspect the effective env-var map for this stack.",
-  },
-  subCommands: {
-    show: defineCommand({
-      meta: { name: "show", description: "Show which secrets are present in Phantom." },
-      args: {
-        env: { type: "string", default: "dev", description: "Environment overlay to preview." },
-      },
-      async run({ args }) {
-        intro(`stack env show (${args.env})`);
-        const phantomOk = await isPhantomInstalled();
-        if (!phantomOk) {
-          outroError("Phantom not installed.");
-          return;
-        }
-        const config = await readConfig();
-        const vaultKeys = new Set(await listSecrets());
-        console.log();
-        for (const [name, entry] of Object.entries(config.services)) {
-          console.log(`  ${colors.bold(name)}`);
-          for (const slot of entry.secrets) {
-            const present = vaultKeys.has(slot);
-            const dot = present ? colors.green("●") : colors.red("○");
-            const value = present ? colors.dim("(phm_…)") : colors.red("missing");
-            console.log(`    ${dot} ${slot.padEnd(30)} ${value}`);
-          }
-        }
-        const declared = new Set(
-          Object.values(config.services).flatMap((e) => e.secrets),
-        );
-        const orphans = [...vaultKeys].filter((k) => !declared.has(k)).sort();
-        if (orphans.length > 0) {
-          console.log();
-          console.log(colors.dim(`  orphans in vault (not referenced by any service):`));
-          for (const k of orphans) console.log(`    ${colors.yellow("●")} ${k}`);
-        }
-        console.log();
-        outro(
-          colors.dim(
-            `${declared.size} declared · ${vaultKeys.size} in vault · ${orphans.length} orphan(s)`,
-          ),
-        );
-      },
-    }),
-    diff: defineCommand({
-      meta: { name: "diff", description: "Which declared secrets are missing from the vault?" },
-      async run() {
-        intro("stack env diff");
-        if (!(await isPhantomInstalled())) {
-          outroError("Phantom not installed.");
-          return;
-        }
-        const config = await readConfig();
-        const vaultKeys = new Set(await listSecrets());
-        const missing: string[] = [];
-        for (const entry of Object.values(config.services)) {
-          for (const slot of entry.secrets) {
-            if (!vaultKeys.has(slot)) missing.push(slot);
-          }
-        }
-        if (missing.length === 0) {
-          outro(colors.green("All declared secrets present."));
-          return;
-        }
-        for (const s of missing) console.log(`  ${colors.red("○")} ${s}`);
-        outroError(`${missing.length} secret(s) missing from the vault.`);
-      },
-    }),
-  },
-});

package/src/commands/exec.ts

@@ -1,54 +0,0 @@
-import { spawn } from "node:child_process";
-import { defineCommand } from "citty";
-import { assertPhantomInstalled, hasConfig } from "@ashlr/stack-core";
-import { colors, intro, outroError } from "../ui.ts";
-
-/**
- * `stack exec -- <cmd>` — run a command with Phantom's proxy active so env
- * vars with `phm_` tokens get swapped for real secrets at the network layer.
- * Thin wrapper over `phantom exec` so users don't have to context-switch
- * between Stack and Phantom for day-to-day work.
- */
-export const execCommand = defineCommand({
-  meta: {
-    name: "exec",
-    description: "Run a command with Phantom's secret proxy active.",
-  },
-  args: {
-    _: { type: "positional", required: false, description: "Command to run after --" },
-  },
-  async run({ rawArgs }) {
-    intro("stack exec");
-
-    if (!hasConfig()) {
-      outroError("No .stack.toml found. Run `stack init` first.");
-      return;
-    }
-
-    try {
-      await assertPhantomInstalled();
-    } catch (err) {
-      outroError((err as Error).message);
-      return;
-    }
-
-    // Forward everything after `--` (or everything after `exec`) to `phantom exec`.
-    const sep = rawArgs.indexOf("--");
-    const forwarded = sep >= 0 ? rawArgs.slice(sep + 1) : rawArgs;
-    if (forwarded.length === 0) {
-      outroError("Nothing to run. Usage: stack exec -- <command>");
-      return;
-    }
-
-    const child = spawn("phantom", ["exec", "--", ...forwarded], { stdio: "inherit" });
-    child.on("close", (code) => {
-      if (code !== 0) {
-        process.stderr.write(colors.dim(`\n[stack exec] phantom exec exited ${code}\n`));
-      }
-      process.exitCode = code ?? 0;
-    });
-    child.on("error", (err) => {
-      outroError((err as Error).message);
-    });
-  },
-});

package/src/commands/import.ts

@@ -1,120 +0,0 @@
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { defineCommand } from "citty";
-import {
-  addSecret,
-  assertPhantomInstalled,
-  emptyConfig,
-  groupByProvider,
-  hasConfig,
-  listProviderNames,
-  parseEnv,
-  readConfig,
-  toServiceEntry,
-  writeConfig,
-} from "@ashlr/stack-core";
-import { colors, intro, outro, outroError, prompts } from "../ui.ts";
-
-/**
- * `stack import [--from .env]` — inhale an existing .env, route each secret
- * into Phantom, and populate .stack.toml with a best-guess service map.
- *
- * This is the most important migration command: most users arrive at Stack
- * with projects that already have filled-in .env files. They shouldn't have
- * to re-paste 20 keys to try the product.
- */
-export const importCommand = defineCommand({
-  meta: {
-    name: "import",
-    description: "Import an existing .env into Phantom + .stack.toml.",
-  },
-  args: {
-    from: { type: "string", default: ".env", description: "Path to the .env file to import." },
-    dryRun: {
-      type: "boolean",
-      default: false,
-      description: "Print what would happen without writing anything.",
-    },
-  },
-  async run({ args }) {
-    intro("stack import");
-
-    const envPath = join(process.cwd(), String(args.from));
-    if (!existsSync(envPath)) {
-      outroError(`${envPath} not found.`);
-      return;
-    }
-
-    try {
-      await assertPhantomInstalled();
-    } catch (err) {
-      if (!args.dryRun) {
-        outroError((err as Error).message);
-        return;
-      }
-      prompts.log.warn(colors.yellow("Phantom not installed — dry-run mode will still preview."));
-    }
-
-    const raw = await readFile(envPath, "utf-8");
-    const entries = parseEnv(raw);
-    if (entries.length === 0) {
-      outro(colors.dim(`${args.from}: nothing to import.`));
-      return;
-    }
-
-    const grouped = groupByProvider(entries.map((e) => e.key));
-    const registered = new Set(listProviderNames());
-    const detectedProviders = Object.keys(grouped).filter((p) => registered.has(p));
-    const detectedSecretCount = detectedProviders.reduce(
-      (acc, p) => acc + grouped[p].length,
-      0,
-    );
-    const orphanSecrets = entries
-      .map((e) => e.key)
-      .filter((name) => !detectedProviders.some((p) => grouped[p].includes(name)));
-
-    console.log();
-    console.log(
-      `  ${colors.bold(String(entries.length))} env vars · ${colors.bold(String(detectedProviders.length))} providers detected · ${colors.bold(String(orphanSecrets.length))} unattributed`,
-    );
-    for (const provider of detectedProviders) {
-      console.log(
-        `  ${colors.green("●")} ${provider.padEnd(14)} ${colors.dim(grouped[provider].join(", "))}`,
-      );
-    }
-    if (orphanSecrets.length > 0) {
-      console.log(
-        `  ${colors.dim("·")} ${"(orphans)".padEnd(14)} ${colors.dim(orphanSecrets.join(", "))}`,
-      );
-    }
-    console.log();
-
-    if (args.dryRun) {
-      outro(colors.dim("dry-run: nothing written."));
-      return;
-    }
-
-    // 1. Store every secret in Phantom (provider-matched + orphans alike).
-    let stored = 0;
-    for (const { key, value } of entries) {
-      if (value.length === 0) continue;
-      await addSecret(key, value);
-      stored += 1;
-    }
-
-    // 2. Update .stack.toml — create one if missing, then populate service entries.
-    const config = hasConfig() ? await readConfig() : emptyConfig();
-    for (const provider of detectedProviders) {
-      if (config.services[provider]) continue; // don't clobber pre-existing entries
-      config.services[provider] = toServiceEntry(provider, grouped[provider]);
-    }
-    await writeConfig(config);
-
-    outro(
-      colors.green(
-        `Imported ${stored} secret(s); wired ${detectedProviders.length} service(s) in .stack.toml. Run \`stack doctor\` to verify.`,
-      ),
-    );
-  },
-});

package/src/commands/info.ts

@@ -1,85 +0,0 @@
-import { defineCommand } from "citty";
-import {
-  type ProviderContext,
-  getProvider,
-  isPhantomInstalled,
-  listSecrets,
-  readConfig,
-} from "@ashlr/stack-core";
-import { colors, intro, logEvent, outro, outroError, prompts } from "../ui.ts";
-
-/**
- * `stack info <service>` — deep-dive on a configured service. Prints its
- * provider, resource id, region, secret slots (with vault presence), MCP
- * wiring, dashboard URL, and runs a fresh healthcheck.
- */
-export const infoCommand = defineCommand({
-  meta: {
-    name: "info",
-    description: "Show everything Stack knows about a configured service.",
-  },
-  args: {
-    service: { type: "positional", required: true, description: "Service name." },
-  },
-  async run({ args }) {
-    intro(`stack info ${args.service}`);
-    const config = await readConfig();
-    const entry = config.services[String(args.service)];
-    if (!entry) {
-      outroError(`${args.service} is not in this stack. Run \`stack list\`.`);
-      return;
-    }
-
-    const provider = await getProvider(entry.provider);
-    const vaultKeys = (await isPhantomInstalled()) ? new Set(await listSecrets()) : new Set();
-
-    console.log();
-    console.log(`  ${colors.bold(provider.displayName)}  ${colors.dim(provider.category)}`);
-    console.log(`    ${colors.dim("resource:")} ${entry.resource_id ?? "(not provisioned)"}`);
-    if (entry.region) console.log(`    ${colors.dim("region:")}   ${entry.region}`);
-    console.log(`    ${colors.dim("auth:")}     ${provider.authKind}`);
-    console.log(`    ${colors.dim("created:")}  ${entry.created_at}${entry.created_by ? colors.dim(` by ${entry.created_by}`) : ""}`);
-    if (provider.docs) console.log(`    ${colors.dim("docs:")}     ${provider.docs}`);
-    const dashboard = provider.dashboardUrl?.(entry);
-    if (dashboard) console.log(`    ${colors.dim("dash:")}     ${dashboard}`);
-    if (entry.mcp) console.log(`    ${colors.dim("mcp:")}      ${entry.mcp}`);
-    if (entry.meta && Object.keys(entry.meta).length > 0) {
-      console.log(`    ${colors.dim("meta:")}     ${JSON.stringify(entry.meta)}`);
-    }
-    console.log();
-
-    console.log(`  ${colors.bold("secrets")}`);
-    for (const slot of entry.secrets) {
-      const present = vaultKeys.has(slot);
-      const dot = present ? colors.green("●") : colors.red("○");
-      const tag = present ? colors.dim("in vault") : colors.red("missing");
-      console.log(`    ${dot} ${slot.padEnd(30)} ${tag}`);
-    }
-    console.log();
-
-    if (provider.healthcheck) {
-      const ctx: ProviderContext = {
-        cwd: process.cwd(),
-        interactive: false,
-        log: logEvent,
-      };
-      const spinner = prompts.spinner();
-      spinner.start("Running healthcheck…");
-      try {
-        const status = await provider.healthcheck(ctx, entry);
-        if (status.kind === "ok") {
-          spinner.stop(
-            `${colors.green("●")} healthy${status.latencyMs ? colors.dim(` (${status.latencyMs}ms)`) : ""}`,
-          );
-        } else if (status.kind === "warn") {
-          spinner.stop(`${colors.yellow("●")} warning: ${status.detail}`);
-        } else {
-          spinner.stop(`${colors.red("●")} error: ${status.detail}`);
-        }
-      } catch (err) {
-        spinner.stop(`${colors.red("●")} healthcheck threw: ${(err as Error).message}`);
-      }
-    }
-    outro("");
-  },
-});

package/src/commands/init.ts

@@ -1,93 +0,0 @@
-import { defineCommand } from "citty";
-import {
-  type StackConfig,
-  emptyConfig,
-  hasConfig,
-  isPhantomInstalled,
-  listTemplates,
-  loadTemplate,
-  resolveConfigPath,
-  writeConfig,
-} from "@ashlr/stack-core";
-import { colors, intro, outro, outroError, prompts } from "../ui.ts";
-
-export const initCommand = defineCommand({
-  meta: {
-    name: "init",
-    description: "Scaffold a .stack.toml in the current directory.",
-  },
-  args: {
-    template: {
-      type: "string",
-      description: "Name of a starter template to apply (e.g. nextjs-supabase-posthog).",
-    },
-    force: {
-      type: "boolean",
-      default: false,
-      description: "Overwrite an existing .stack.toml.",
-    },
-    noInteractive: {
-      type: "boolean",
-      default: false,
-      description: "Skip template picker — always creates a blank .stack.toml.",
-    },
-  },
-  async run({ args }) {
-    intro("stack init");
-
-    const cwd = process.cwd();
-    if (hasConfig(cwd) && !args.force) {
-      outroError(
-        `${colors.bold(".stack.toml")} already exists at ${resolveConfigPath(cwd)}. Pass --force to overwrite.`,
-      );
-      return;
-    }
-
-    if (!(await isPhantomInstalled())) {
-      prompts.log.warn(
-        colors.yellow(
-          "Phantom Secrets isn't on your PATH. Stack will create .stack.toml anyway, but `stack add` needs Phantom.",
-        ),
-      );
-      prompts.log.info("  Install: brew install ashlrai/phantom/phantom");
-    }
-
-    let templateName = args.template ? String(args.template) : undefined;
-
-    if (!templateName && !args.noInteractive && process.stdout.isTTY) {
-      const available = listTemplates();
-      if (available.length > 0) {
-        const picked = await prompts.select({
-          message: "Pick a starter template (or blank):",
-          options: [
-            { value: "", label: "Blank — add services later with `stack add`" },
-            ...available.map((name) => ({ value: name, label: name })),
-          ],
-        });
-        if (prompts.isCancel(picked)) {
-          outroError("Cancelled.");
-          return;
-        }
-        if (picked) templateName = String(picked);
-      }
-    }
-
-    let config: StackConfig;
-    if (templateName) {
-      const loaded = await loadTemplate(templateName);
-      if (!loaded) {
-        outroError(`Unknown template: ${templateName}`);
-        return;
-      }
-      config = loaded;
-      config.stack.template = templateName;
-    } else {
-      config = emptyConfig();
-    }
-
-    await writeConfig(config, cwd);
-    outro(
-      `Wrote ${colors.bold(".stack.toml")} (${config.stack.project_id})${templateName ? ` from template ${colors.bold(templateName)}` : ""}.`,
-    );
-  },
-});

package/src/commands/list.ts

@@ -1,27 +0,0 @@
-import { defineCommand } from "citty";
-import { readConfig } from "@ashlr/stack-core";
-import { colors } from "../ui.ts";
-
-export const listCommand = defineCommand({
-  meta: { name: "list", description: "List services configured in this stack." },
-  async run() {
-    const config = await readConfig();
-    const entries = Object.entries(config.services);
-    if (entries.length === 0) {
-      console.log(colors.dim("No services yet. Try `stack add supabase`."));
-      return;
-    }
-    console.log();
-    console.log(colors.bold(`  ${config.stack.project_id}  `) + colors.dim(`(${entries.length} services)`));
-    console.log();
-    for (const [name, entry] of entries) {
-      const mcp = entry.mcp ? colors.cyan(` mcp:${entry.mcp}`) : "";
-      const region = entry.region ? colors.dim(` @${entry.region}`) : "";
-      console.log(`  ${colors.green("●")} ${colors.bold(name)}${region}${mcp}`);
-      console.log(
-        `    ${colors.dim("resource:")} ${entry.resource_id ?? "-"}   ${colors.dim("secrets:")} ${entry.secrets.join(", ") || "-"}`,
-      );
-    }
-    console.log();
-  },
-});

package/src/commands/login.ts

@@ -1,28 +0,0 @@
-import { defineCommand } from "citty";
-import { type ProviderContext, getProvider } from "@ashlr/stack-core";
-import { colors, intro, logEvent, outro, outroError } from "../ui.ts";
-
-export const loginCommand = defineCommand({
-  meta: {
-    name: "login",
-    description: "Refresh OAuth / PAT credentials for a specific provider.",
-  },
-  args: {
-    service: { type: "positional", required: true, description: "Provider name." },
-  },
-  async run({ args }) {
-    intro(`stack login ${args.service}`);
-    try {
-      const provider = await getProvider(args.service);
-      const ctx: ProviderContext = {
-        cwd: process.cwd(),
-        interactive: process.stdout.isTTY === true,
-        log: logEvent,
-      };
-      await provider.login(ctx);
-      outro(colors.green(`${provider.displayName}: signed in.`));
-    } catch (err) {
-      outroError((err as Error).message);
-    }
-  },
-});

package/src/commands/open.ts

@@ -1,32 +0,0 @@
-import { spawn } from "node:child_process";
-import { platform } from "node:os";
-import { defineCommand } from "citty";
-import { getProvider, readConfig } from "@ashlr/stack-core";
-import { colors, intro, outro, outroError } from "../ui.ts";
-
-export const openCommand = defineCommand({
-  meta: { name: "open", description: "Open a service's dashboard in your browser." },
-  args: {
-    service: { type: "positional", required: true, description: "Service name." },
-  },
-  async run({ args }) {
-    intro(`stack open ${args.service}`);
-    const config = await readConfig();
-    const entry = config.services[args.service];
-    if (!entry) {
-      outroError(`${args.service} is not in this stack.`);
-      return;
-    }
-    const provider = await getProvider(args.service);
-    const url = provider.dashboardUrl?.(entry);
-    if (!url) {
-      outroError(`${provider.displayName} has no dashboard URL configured.`);
-      return;
-    }
-
-    const opener =
-      platform() === "darwin" ? "open" : platform() === "win32" ? "start" : "xdg-open";
-    spawn(opener, [url], { stdio: "ignore", detached: true }).unref();
-    outro(colors.green(`Opening ${url}`));
-  },
-});

package/src/commands/projects.ts

@@ -1,92 +0,0 @@
-import { defineCommand } from "citty";
-import {
-  findProjectByName,
-  listProjects,
-  registerProject,
-  unregisterProject,
-} from "@ashlr/stack-core";
-import { colors, intro, outro, outroError } from "../ui.ts";
-
-/**
- * `stack projects` — work across every Stack-enabled project on this machine.
- *
- *   stack projects list
- *   stack projects register   (register the current cwd)
- *   stack projects remove <name|path>
- *   stack projects where <name>
- */
-export const projectsCommand = defineCommand({
-  meta: {
-    name: "projects",
-    description: "Manage the cross-project registry at ~/.stack/projects.json.",
-  },
-  subCommands: {
-    list: defineCommand({
-      meta: { name: "list", description: "List every Stack-enabled project on this machine." },
-      async run() {
-        intro("stack projects");
-        const projects = await listProjects();
-        if (projects.length === 0) {
-          outro(colors.dim("No projects registered yet. Run `stack init` in one to start."));
-          return;
-        }
-        console.log();
-        for (const p of projects) {
-          const template = p.template ? colors.dim(` [${p.template}]`) : "";
-          const services = p.services.length
-            ? colors.dim(` · ${p.services.join(", ")}`)
-            : colors.dim(" · no services");
-          console.log(
-            `  ${colors.green("●")} ${colors.bold(p.name)}${template}  ${colors.dim(p.project_id)}`,
-          );
-          console.log(`    ${colors.dim(p.path)}${services}`);
-        }
-        console.log();
-      },
-    }),
-    register: defineCommand({
-      meta: { name: "register", description: "Register the current directory in the registry." },
-      async run() {
-        intro("stack projects register");
-        const entry = await registerProject(process.cwd());
-        if (!entry) {
-          outroError("No .stack.toml in the current directory — run `stack init` first.");
-          return;
-        }
-        outro(colors.green(`Registered ${entry.name} (${entry.project_id}).`));
-      },
-    }),
-    remove: defineCommand({
-      meta: { name: "remove", description: "Remove a project from the registry (does not delete files)." },
-      args: {
-        target: { type: "positional", required: true, description: "Project name or absolute path." },
-      },
-      async run({ args }) {
-        intro("stack projects remove");
-        const target = String(args.target);
-        const match = target.startsWith("/") ? target : (await findProjectByName(target))?.path;
-        if (!match) {
-          outroError(`No registered project matches "${target}".`);
-          return;
-        }
-        await unregisterProject(match);
-        outro(colors.green(`Removed ${target} from registry.`));
-      },
-    }),
-    where: defineCommand({
-      meta: { name: "where", description: "Print the path of a registered project." },
-      args: {
-        name: { type: "positional", required: true, description: "Project name." },
-      },
-      async run({ args }) {
-        const project = await findProjectByName(String(args.name));
-        if (!project) {
-          process.exitCode = 1;
-          console.error(`No registered project named "${args.name}".`);
-          return;
-        }
-        console.log(project.path);
-      },
-    }),
-  },
-});

package/src/commands/providers.ts

@@ -1,38 +0,0 @@
-import { defineCommand } from "citty";
-import { getProvider, listProviderNames } from "@ashlr/stack-core";
-import { colors, intro } from "../ui.ts";
-
-export const providersCommand = defineCommand({
-  meta: { name: "providers", description: "List every curated provider Stack can wire up." },
-  async run() {
-    intro("stack providers");
-    const names = listProviderNames();
-    const byCategory: Record<string, Array<{ name: string; displayName: string; auth: string }>> = {};
-    for (const name of names) {
-      try {
-        const p = await getProvider(name);
-        (byCategory[p.category] ??= []).push({
-          name: p.name,
-          displayName: p.displayName,
-          auth: p.authKind,
-        });
-      } catch {
-        /* ignore load failures — the registry is authoritative */
-      }
-    }
-
-    const categories = Object.keys(byCategory).sort();
-    console.log();
-    for (const cat of categories) {
-      console.log(`  ${colors.bold(cat)}`);
-      for (const p of byCategory[cat]) {
-        console.log(
-          `    ${colors.cyan("·")} ${p.name.padEnd(12)} ${colors.dim(`(${p.auth})`)}  ${p.displayName}`,
-        );
-      }
-      console.log();
-    }
-    console.log(colors.dim(`  ${names.length} providers total. Add one with: stack add <name>`));
-    console.log();
-  },
-});