@frontman-ai/astro 0.1.0

package/src/cli/FrontmanAstro__Cli__Install.res.mjs

@@ -0,0 +1,194 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Nodepath from "node:path";
+import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
+import * as ChildProcess$FrontmanBindings from "@frontman/bindings/src/ChildProcess.res.mjs";
+import * as FrontmanAstro__Cli__Files$FrontmanAiAstro from "./FrontmanAstro__Cli__Files.res.mjs";
+import * as FrontmanAstro__Cli__Style$FrontmanAiAstro from "./FrontmanAstro__Cli__Style.res.mjs";
+import * as FrontmanAstro__Cli__Detect$FrontmanAiAstro from "./FrontmanAstro__Cli__Detect.res.mjs";
+import * as FrontmanAstro__Cli__AutoEdit$FrontmanAiAstro from "./FrontmanAstro__Cli__AutoEdit.res.mjs";
+import * as FrontmanAstro__Cli__Templates$FrontmanAiAstro from "./FrontmanAstro__Cli__Templates.res.mjs";
+
+async function installDependencies(projectDir, packageManager, dryRun) {
+  let pm = FrontmanAstro__Cli__Detect$FrontmanAiAstro.getPackageManagerCommand(packageManager);
+  let args = FrontmanAstro__Cli__Detect$FrontmanAiAstro.getInstallArgs(packageManager, undefined);
+  let packages = [
+    "@frontman-ai/astro",
+    "@astrojs/node"
+  ];
+  let packages$1;
+  packages$1 = packageManager === "Deno" ? packages.map(p => "npm:" + p) : packages;
+  let cmd = pm + ` ` + args.join(" ") + ` ` + packages$1.join(" ");
+  if (dryRun) {
+    console.log(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.dim(`Would run: ` + cmd));
+    return {
+      TAG: "Ok",
+      _0: undefined
+    };
+  }
+  console.log(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.purple("Installing dependencies with " + pm + "..."));
+  let err = await ChildProcess$FrontmanBindings.execWithOptions(cmd, {
+    cwd: projectDir
+  });
+  if (err.TAG === "Ok") {
+    console.log(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.check + ` Dependencies installed`);
+    return {
+      TAG: "Ok",
+      _0: undefined
+    };
+  }
+  let err$1 = err._0;
+  let stderr = err$1.stderr === "" ? "Unknown error" : err$1.stderr;
+  return {
+    TAG: "Error",
+    _0: `Failed to install dependencies: ` + stderr
+  };
+}
+
+function processFileResult(result, manualSteps) {
+  if (result.TAG === "Ok") {
+    let fileResult = result._0;
+    console.log(FrontmanAstro__Cli__Files$FrontmanAiAstro.formatResult(fileResult));
+    if (fileResult.TAG === "ManualEditRequired") {
+      manualSteps.push(fileResult.details);
+    }
+    return {
+      TAG: "Ok",
+      _0: undefined
+    };
+  }
+  let msg = result._0;
+  console.error(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.warn + `  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.bold("Error:") + ` ` + msg);
+  return {
+    TAG: "Error",
+    _0: msg
+  };
+}
+
+function collectPendingAutoEdits(projectDir, host, info) {
+  let pending = [];
+  let p = FrontmanAstro__Cli__Files$FrontmanAiAstro.getPendingAutoEdit(info.config, Nodepath.join(projectDir, info.configFileName), info.configFileName, "Config", FrontmanAstro__Cli__Templates$FrontmanAiAstro.ManualInstructions.config(info.configFileName, host));
+  if (p !== undefined) {
+    pending.push(p);
+  }
+  let p$1 = FrontmanAstro__Cli__Files$FrontmanAiAstro.getPendingAutoEdit(info.middleware, Nodepath.join(projectDir, info.middlewareFileName), info.middlewareFileName, "Middleware", FrontmanAstro__Cli__Templates$FrontmanAiAstro.ManualInstructions.middleware(info.middlewareFileName, host));
+  if (p$1 !== undefined) {
+    pending.push(p$1);
+  }
+  return pending;
+}
+
+async function run(options) {
+  let projectDir = Stdlib_Option.getOr(options.prefix, process.cwd());
+  let host = options.server;
+  console.log(FrontmanAstro__Cli__Templates$FrontmanAiAstro.banner());
+  console.log(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.bullet + ` ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.bold("Server:") + `   ` + host);
+  if (options.dryRun) {
+    console.log("");
+    console.log(FrontmanAstro__Cli__Templates$FrontmanAiAstro.SuccessMessages.dryRunHeader);
+  }
+  let msg = await FrontmanAstro__Cli__Detect$FrontmanAiAstro.detect(projectDir);
+  if (msg.TAG === "Ok") {
+    let info = msg._0;
+    let version = Stdlib_Option.getOrThrow(info.astroVersion, undefined).raw;
+    console.log(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.bullet + ` ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.bold("Detected:") + ` Astro ` + version);
+    console.log("");
+    if (!options.skipDeps) {
+      let msg$1 = await installDependencies(projectDir, info.packageManager, options.dryRun);
+      if (msg$1.TAG !== "Ok") {
+        console.error(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.warn + `  ` + msg$1._0);
+      }
+      console.log("");
+    }
+    let pendingEdits = collectPendingAutoEdits(projectDir, host, info);
+    let match = pendingEdits.length !== 0;
+    let match$1 = options.dryRun;
+    let shouldAutoEdit;
+    if (match && !match$1) {
+      let fileNames = pendingEdits.map(p => p.fileName);
+      shouldAutoEdit = await FrontmanAstro__Cli__AutoEdit$FrontmanAiAstro.promptUserForAutoEdit(fileNames);
+    } else {
+      shouldAutoEdit = false;
+    }
+    let manualSteps = [];
+    let configResult = await FrontmanAstro__Cli__Files$FrontmanAiAstro.handleConfig(projectDir, host, info.configFileName, info.config, options.dryRun, shouldAutoEdit);
+    let msg$2 = processFileResult(configResult, manualSteps);
+    if (msg$2.TAG !== "Ok") {
+      return {
+        TAG: "Failure",
+        _0: msg$2._0
+      };
+    }
+    let middlewareResult = await FrontmanAstro__Cli__Files$FrontmanAiAstro.handleMiddleware(projectDir, host, info.middlewareFileName, info.middleware, options.dryRun, shouldAutoEdit);
+    let msg$3 = processFileResult(middlewareResult, manualSteps);
+    if (msg$3.TAG !== "Ok") {
+      return {
+        TAG: "Failure",
+        _0: msg$3._0
+      };
+    }
+    if (manualSteps.length !== 0) {
+      console.log("");
+      console.log(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.divider);
+      console.log("");
+      console.log(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.yellowBold("Manual steps required:"));
+      console.log("");
+      manualSteps.forEach(step => {
+        console.log(step);
+      });
+      console.log("");
+      return {
+        TAG: "PartialSuccess",
+        manualStepsRequired: manualSteps
+      };
+    }
+    if (!options.dryRun) {
+      let devCommand = FrontmanAstro__Cli__Detect$FrontmanAiAstro.getDevCommand(info.packageManager);
+      console.log("");
+      console.log(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.divider);
+      console.log(FrontmanAstro__Cli__Templates$FrontmanAiAstro.SuccessMessages.installComplete(devCommand));
+    }
+    return "Success";
+  }
+  let msg$4 = msg._0;
+  console.error(`  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.warn + `  ` + FrontmanAstro__Cli__Style$FrontmanAiAstro.bold("Error:") + ` ` + msg$4);
+  return {
+    TAG: "Failure",
+    _0: msg$4
+  };
+}
+
+let Bindings;
+
+let ChildProcess;
+
+let Path;
+
+let Process;
+
+let AutoEdit;
+
+let Detect;
+
+let Files;
+
+let Templates;
+
+let Style;
+
+export {
+  Bindings,
+  ChildProcess,
+  Path,
+  Process,
+  AutoEdit,
+  Detect,
+  Files,
+  Templates,
+  Style,
+  installDependencies,
+  processFileResult,
+  collectPendingAutoEdits,
+  run,
+}
+/* node:path Not a pure module */

package/src/cli/FrontmanAstro__Cli__Style.res

@@ -0,0 +1,22 @@
+// ANSI terminal styling for CLI output
+// Brand purple: #985DF7 (primary), #8051CD (secondary)
+
+let esc = "\x1b"
+
+// Color functions — wrap text with ANSI codes
+let purple = text => `${esc}[38;2;152;93;247m${text}${esc}[0m`
+let purpleBold = text => `${esc}[1;38;2;152;93;247m${text}${esc}[0m`
+let purpleDim = text => `${esc}[38;2;128;81;205m${text}${esc}[0m`
+let green = text => `${esc}[32m${text}${esc}[0m`
+let yellow = text => `${esc}[33m${text}${esc}[0m`
+let yellowBold = text => `${esc}[1;33m${text}${esc}[0m`
+let bold = text => `${esc}[1m${text}${esc}[0m`
+let dim = text => `${esc}[2m${text}${esc}[0m`
+
+// Symbols
+let check = green("✔")
+let warn = yellow("⚠")
+let bullet = purple("▸")
+
+// Decorative
+let divider = purple("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")

package/src/cli/FrontmanAstro__Cli__Style.res.mjs

@@ -0,0 +1,61 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+
+let esc = "\x1b";
+
+function purple(text) {
+  return esc + `[38;2;152;93;247m` + text + esc + `[0m`;
+}
+
+function purpleBold(text) {
+  return esc + `[1;38;2;152;93;247m` + text + esc + `[0m`;
+}
+
+function purpleDim(text) {
+  return esc + `[38;2;128;81;205m` + text + esc + `[0m`;
+}
+
+function green(text) {
+  return esc + `[32m` + text + esc + `[0m`;
+}
+
+function yellow(text) {
+  return esc + `[33m` + text + esc + `[0m`;
+}
+
+function yellowBold(text) {
+  return esc + `[1;33m` + text + esc + `[0m`;
+}
+
+function bold(text) {
+  return esc + `[1m` + text + esc + `[0m`;
+}
+
+function dim(text) {
+  return esc + `[2m` + text + esc + `[0m`;
+}
+
+let check = green("✔");
+
+let warn = yellow("⚠");
+
+let bullet = purple("▸");
+
+let divider = purple("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+
+export {
+  esc,
+  purple,
+  purpleBold,
+  purpleDim,
+  green,
+  yellow,
+  yellowBold,
+  bold,
+  dim,
+  check,
+  warn,
+  bullet,
+  divider,
+}
+/* check Not a pure module */

package/src/cli/FrontmanAstro__Cli__Templates.res

@@ -0,0 +1,226 @@
+// Templates for generated files
+module Style = FrontmanAstro__Cli__Style
+
+// ASCII art banner for the installer
+let banner = () => {
+  let l1 = Style.purpleBold("   ___              _                       ")
+  let l2 = Style.purpleBold("  | __| _ ___ _ _ | |_ _ __  __ _ _ _  ")
+  // Use double-quoted string for the backtick line
+  let l3 = Style.purpleBold("  | _| '_/ _ \\ ' \\|  _| '  \\/ _` | ' \\ ")
+  let l4 = Style.purpleBold("  |_||_| \\___/_||_|\\__|_|_|_\\__,_|_||_|")
+  let tagline = Style.purpleDim("  AI that sees your DOM and edits your frontend")
+
+  `
+${l1}
+${l2}
+${l3}
+${l4}
+
+${tagline}
+`
+}
+
+// src/middleware.ts template
+let middlewareTemplate = (host: string) =>
+  `import { createMiddleware, makeConfig } from '@frontman-ai/astro';
+import { defineMiddleware } from 'astro:middleware';
+
+const config = makeConfig({ host: '${host}' });
+const frontman = createMiddleware(config);
+
+export const onRequest = defineMiddleware(async (context, next) => {
+  return frontman(context, next);
+});
+`
+
+// astro.config.mjs template (for clean projects with no existing config)
+let configTemplate = (host: string) => {
+  // host is unused in the config template (it's used via makeConfig in middleware),
+  // but we accept it to keep the API consistent and for future use
+  ignore(host)
+  `import { defineConfig } from 'astro/config';
+import node from '@astrojs/node';
+import { frontmanIntegration } from '@frontman-ai/astro/integration';
+
+const isProd = process.env.NODE_ENV === 'production';
+
+export default defineConfig({
+  // SSR needed in dev for Frontman middleware routes
+  ...(isProd ? {} : { output: 'server', adapter: node({ mode: 'standalone' }) }),
+  integrations: [frontmanIntegration()],
+});
+`
+}
+
+// Manual setup instructions (shown in summary when auto-edit is skipped)
+module ManualInstructions = {
+  let config = (fileName: string, _host: string) => {
+    let h = Style.yellowBold
+    let s = Style.purple
+    let d = Style.dim
+    let b = Style.bold
+    let bar = Style.yellow("|")
+
+    `  ${bar}
+  ${bar}  ${h(fileName)} needs manual modification.
+  ${bar}
+  ${bar}  ${s("1.")} Add imports at the top of the file:
+  ${bar}
+  ${bar}     ${d("import node from '@astrojs/node';")}
+  ${bar}     ${d("import { frontmanIntegration } from '@frontman-ai/astro/integration';")}
+  ${bar}
+  ${bar}  ${s("2.")} Add SSR config for dev mode ${d("(needed for middleware routes)")}:
+  ${bar}
+  ${bar}     ${d("const isProd = process.env.NODE_ENV === 'production';")}
+  ${bar}
+  ${bar}     ${d("export default defineConfig({")}
+  ${bar}     ${d("  ...(isProd ? {} : { output: 'server', adapter: node({ mode: 'standalone' }) }),")}
+  ${bar}     ${d("  // ... your existing config")}
+  ${bar}     ${d("});")}
+  ${bar}
+  ${bar}  ${s("3.")} Add ${b("frontmanIntegration()")} to your integrations array:
+  ${bar}
+  ${bar}     ${d("integrations: [frontmanIntegration(), ...yourExistingIntegrations]")}
+  ${bar}
+  ${bar}  ${b("Docs:")} ${d("https://frontman.sh/docs/astro")}
+  ${bar}`
+  }
+
+  let middleware = (fileName: string, host: string) => {
+    let h = Style.yellowBold
+    let s = Style.purple
+    let d = Style.dim
+    let b = Style.bold
+    let bar = Style.yellow("|")
+
+    `  ${bar}
+  ${bar}  ${h(fileName)} needs manual modification.
+  ${bar}
+  ${bar}  ${s("1.")} Add imports at the top of the file:
+  ${bar}
+  ${bar}     ${d("import { createMiddleware, makeConfig } from '@frontman-ai/astro';")}
+  ${bar}     ${d("import { defineMiddleware, sequence } from 'astro:middleware';")}
+  ${bar}
+  ${bar}  ${s("2.")} Create the Frontman middleware instance ${d("(after imports)")}:
+  ${bar}
+  ${bar}     ${d(`const frontmanConfig = makeConfig({ host: '${host}' });`)}
+  ${bar}     ${d("const frontman = createMiddleware(frontmanConfig);")}
+  ${bar}
+  ${bar}  ${s("3.")} Combine with your existing middleware using ${b("sequence()")}:
+  ${bar}
+  ${bar}     ${d("const frontmanMiddleware = defineMiddleware(async (context, next) => {")}
+  ${bar}     ${d("  return frontman(context, next);")}
+  ${bar}     ${d("});")}
+  ${bar}
+  ${bar}     ${d("export const onRequest = sequence(frontmanMiddleware, yourExistingMiddleware);")}
+  ${bar}
+  ${bar}  ${b("Docs:")} ${d("https://frontman.sh/docs/astro")}
+  ${bar}`
+  }
+}
+
+// Keep plain-text versions for the LLM system prompt (no ANSI codes)
+module ErrorMessages = {
+  let configManualSetup = (fileName: string, _host: string) =>
+    `
+${fileName} already exists and requires manual modification.
+
+Add the following to your ${fileName}:
+
+  1. Add imports at the top of the file:
+
+     import node from '@astrojs/node';
+     import { frontmanIntegration } from '@frontman-ai/astro/integration';
+
+  2. Add SSR config for dev mode (needed for middleware routes):
+
+     const isProd = process.env.NODE_ENV === 'production';
+
+     export default defineConfig({
+       ...(isProd ? {} : { output: 'server', adapter: node({ mode: 'standalone' }) }),
+       // ... your existing config
+     });
+
+  3. Add frontmanIntegration() to your integrations array:
+
+     integrations: [frontmanIntegration(), ...yourExistingIntegrations],
+
+For full documentation, see: https://frontman.sh/docs/astro
+`
+
+  let middlewareManualSetup = (fileName: string, host: string) =>
+    `
+${fileName} already exists and requires manual modification.
+
+Add the following to your ${fileName}:
+
+  1. Add imports at the top of the file:
+
+     import { createMiddleware, makeConfig } from '@frontman-ai/astro';
+     import { defineMiddleware, sequence } from 'astro:middleware';
+
+  2. Create the Frontman middleware instance (after imports):
+
+     const frontmanConfig = makeConfig({ host: '${host}' });
+     const frontman = createMiddleware(frontmanConfig);
+
+  3. Combine with your existing middleware using sequence():
+
+     const frontmanMiddleware = defineMiddleware(async (context, next) => {
+       return frontman(context, next);
+     });
+
+     export const onRequest = sequence(frontmanMiddleware, yourExistingMiddleware);
+
+For full documentation, see: https://frontman.sh/docs/astro
+`
+}
+
+// Success messages
+module SuccessMessages = {
+  let fileCreated = (fileName: string) =>
+    `  ${Style.check} Created ${Style.bold(fileName)}`
+
+  let fileSkipped = (fileName: string) =>
+    `  ${Style.purple("–")} Skipped ${Style.bold(fileName)} ${Style.dim("(already configured)")}`
+
+  let hostUpdated = (fileName: string, oldHost: string, newHost: string) =>
+    `  ${Style.check} Updated ${Style.bold(fileName)} ${Style.dim(`(host: '${oldHost}' -> '${newHost}')`)}`
+
+  let fileAutoEdited = (fileName: string) =>
+    `  ${Style.check} Auto-edited ${Style.bold(fileName)} ${Style.dim("(Frontman integrated via AI)")}`
+
+  let autoEditFailed = (fileName: string, error: string) =>
+    `  ${Style.warn}  Auto-edit failed for ${Style.bold(fileName)}: ${Style.dim(error)}`
+
+  let manualEditRequired = (fileName: string) =>
+    `  ${Style.warn}  ${Style.bold(fileName)} requires manual setup ${Style.dim("(see details below)")}`
+
+  let installComplete = (~devCommand: string) => {
+    let p = Style.purple
+    let pb = Style.purpleBold
+    let d = Style.dim
+    let pd = Style.purpleDim
+
+    `
+  ${pb("Frontman setup complete!")}
+
+  ${pb("Next steps:")}
+    ${p("1.")} Start your dev server   ${d(devCommand)}
+    ${p("2.")} Open your browser to    ${d("http://localhost:4321/frontman")}
+
+  ${p("┌───────────────────────────────────────────────┐")}
+  ${p("│")}                                               ${p("│")}
+  ${p("│")}   Questions? Comments? Need support?          ${p("│")}
+  ${p("│")}                                               ${p("│")}
+  ${p("│")}       Join us on Discord:                     ${p("│")}
+  ${p("│")}       ${pd("https://discord.gg/J77jBzMM")}             ${p("│")}
+  ${p("│")}                                               ${p("│")}
+  ${p("└───────────────────────────────────────────────┘")}
+`
+  }
+
+  let dryRunHeader =
+    `  ${Style.warn}  ${Style.yellowBold("DRY RUN MODE")} ${Style.dim("— No files will be created")}
+`
+}