launch-stackwright 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Per Aspera Sapientia LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# 🚢 launch-stackwright
+
+The fastest way to get started with Stackwright — launch a new project with the otter raft ready to build.
+
+## Quick Start
+
+```bash
+npx launch-stackwright my-awesome-site
+cd my-awesome-site
+pnpm install
+pnpm dev
+```
+
+## What You Get
+
+When you run `launch-stackwright`, you get:
+
+- ✅ A fully configured Next.js + Stackwright project
+- ✅ Theme configuration (`stackwright.yml`)
+- ✅ Example pages in YAML
+- ✅ **The Otter Raft** 🦦🦦🦦🦦 — AI agents ready to build your site
+
+## Using the Otter Raft
+
+After launching your project, invoke the Foreman Otter to orchestrate your entire site build:
+
+```bash
+code-puppy invoke stackwright-foreman-otter
+```
+
+Then say: **"Build me a [law firm / wellness startup / SaaS marketing] website"**
+
+The raft includes four specialized otters:
+- 🦦🏗️ **Foreman Otter** — Coordinates the entire build
+- 🦦🎨 **Brand Otter** — Discovers your brand through conversation
+- 🦦🌈 **Theme Otter** — Designs your visual theme
+- 🦦📄 **Page Otter** — Builds your content pages
+
+## CLI Options
+
+```bash
+launch-stackwright [directory] [options]
+
+Options:
+  --name <name>       Project name (used in package.json)
+  --title <title>     Site title shown in app bar and browser tab
+  --theme <themeId>   Theme ID (corporate, creative, minimal, etc.)
+  --force             Launch even if directory is not empty
+  --skip-otters       Skip copying otter raft configs
+  -y, --yes           Skip all prompts, use defaults
+  -V, --version       Output version number
+  -h, --help          Display help
+```
+
+## Examples
+
+```bash
+# Interactive mode (default)
+npx launch-stackwright my-site
+
+# Specify everything upfront
+npx launch-stackwright my-site --name "my-awesome-app" --title "My Awesome Site" --theme corporate
+
+# Quick start with defaults
+npx launch-stackwright my-site --yes
+
+# Skip otter setup (just scaffold the project)
+npx launch-stackwright my-site --skip-otters
+```
+
+## What Gets Created
+
+```
+my-awesome-site/
+├── .code-puppy.json           # Code Puppy + MCP auto-config
+├── .stackwright/
+│   └── otters/                # The otter raft configs
+│       ├── stackwright-foreman-otter.json
+│       ├── stackwright-brand-otter.json
+│       ├── stackwright-theme-otter.json
+│       └── stackwright-page-otter.json
+├── pages/
+│   ├── content.yml            # Home page
+│   ├── about/content.yml      # About page
+│   ├── [...slug].tsx          # Dynamic page router
+│   └── _app.tsx               # Next.js app wrapper
+├── stackwright.yml            # Theme configuration
+├── next.config.js             # Next.js config
+├── package.json               # Dependencies
+└── tsconfig.json              # TypeScript config
+```
+
+## Prerequisites
+
+- **Node.js** 18+ and **pnpm**
+- **Code Puppy CLI** (optional, for otter raft features)
+
+Install Code Puppy:
+```bash
+npm install -g @peraspera/code-puppy
+```
+
+## Learn More
+
+- [Stackwright Documentation](https://github.com/Per-Aspera-LLC/stackwright)
+- [Otter Raft Architecture](https://github.com/Per-Aspera-LLC/stackwright/blob/main/OTTER_ARCHITECTURE.md)
+- [Code Puppy](https://github.com/Per-Aspera-LLC/code-puppy)
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "launch-stackwright",
+      version: "0.1.0",
+      description: "Launch a new Stackwright project with the otter raft ready to build",
+      license: "MIT",
+      repository: {
+        type: "git",
+        url: "https://github.com/Per-Aspera-LLC/stackwright"
+      },
+      keywords: [
+        "stackwright",
+        "scaffolding",
+        "website-builder",
+        "otters",
+        "ai-agents"
+      ],
+      files: [
+        "dist",
+        "templates"
+      ],
+      bin: {
+        "launch-stackwright": "dist/index.js"
+      },
+      scripts: {
+        build: "tsup",
+        dev: "tsup --watch",
+        test: "vitest run"
+      },
+      dependencies: {
+        "@stackwright/cli": "workspace:*",
+        chalk: "^5.6.2",
+        commander: "^14.0.3",
+        "fs-extra": "^11.3",
+        prompts: "^2.4.2"
+      },
+      devDependencies: {
+        "@types/fs-extra": "^11.0",
+        "@types/node": "^25.4",
+        "@types/prompts": "^2.4.9",
+        typescript: "^5.0",
+        tsup: "^8.5",
+        vitest: "^4.0.18"
+      }
+    };
+  }
+});
+
+// src/index.ts
+var import_commander = require("commander");
+var import_path = __toESM(require("path"));
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_chalk = __toESM(require("chalk"));
+var import_cli = require("@stackwright/cli");
+var { version } = require_package();
+async function copyOtterRaft(targetDir) {
+  const ottersSourceDir = import_path.default.resolve(__dirname, "../templates/otters");
+  const ottersTargetDir = import_path.default.join(targetDir, ".stackwright", "otters");
+  if (!import_fs_extra.default.existsSync(ottersSourceDir)) {
+    console.warn(
+      import_chalk.default.yellow(
+        "\n\u26A0\uFE0F  Could not find otter raft configs. Skipping otter setup.\n   You can add them later from: https://github.com/Per-Aspera-LLC/stackwright/tree/main/otters"
+      )
+    );
+    return;
+  }
+  await import_fs_extra.default.ensureDir(ottersTargetDir);
+  const otterFiles = (await import_fs_extra.default.readdir(ottersSourceDir)).filter((f) => f.endsWith(".json"));
+  for (const file of otterFiles) {
+    await import_fs_extra.default.copy(import_path.default.join(ottersSourceDir, file), import_path.default.join(ottersTargetDir, file));
+  }
+  const codePuppyConfig = {
+    mcp_servers: {
+      stackwright: {
+        command: "node",
+        args: [import_path.default.join(targetDir, "node_modules", "@stackwright", "mcp", "dist", "server.js")],
+        env: {
+          NODE_ENV: "development"
+        }
+      }
+    },
+    agents_path: ".stackwright/otters"
+  };
+  await import_fs_extra.default.writeFile(
+    import_path.default.join(targetDir, ".code-puppy.json"),
+    JSON.stringify(codePuppyConfig, null, 2)
+  );
+  console.log(import_chalk.default.green("\u2705 Otter raft ready! \u{1F9A6}\u{1F9A6}\u{1F9A6}\u{1F9A6}"));
+  console.log(import_chalk.default.dim(`   Configs copied to: ${import_path.default.relative(process.cwd(), ottersTargetDir)}`));
+}
+async function launch(targetDir, options) {
+  const dirName = import_path.default.basename(targetDir);
+  console.log(import_chalk.default.cyan.bold("\n\u{1F6A2} Launching Stackwright...\n"));
+  const scaffoldOptions = {
+    name: options.name || dirName,
+    title: options.title,
+    theme: options.theme,
+    force: options.force,
+    noInteractive: options.yes
+  };
+  try {
+    const result = await (0, import_cli.scaffold)(targetDir, scaffoldOptions);
+    console.log(import_chalk.default.green(`
+\u2705 Project scaffolded successfully!`));
+    console.log(import_chalk.default.dim(`   Location: ${result.path}`));
+    console.log(import_chalk.default.dim(`   Theme: ${result.theme}`));
+    console.log(import_chalk.default.dim(`   Pages: ${result.pages.join(", ")}`));
+    if (!options.skipOtters) {
+      console.log(import_chalk.default.cyan("\n\u{1F9A6} Setting up the otter raft...\n"));
+      await copyOtterRaft(targetDir);
+    }
+    console.log(import_chalk.default.cyan.bold("\n\u{1F389} All set! Here's what to do next:\n"));
+    console.log(import_chalk.default.white(`  1. cd ${import_path.default.relative(process.cwd(), targetDir) || "."}`));
+    console.log(import_chalk.default.white(`  2. pnpm install`));
+    console.log(import_chalk.default.white(`  3. pnpm dev`));
+    if (!options.skipOtters) {
+      console.log(
+        import_chalk.default.cyan.bold("\n\u{1F9A6} Want the otter raft to build your site for you?\n")
+      );
+      console.log(import_chalk.default.white(`  code-puppy invoke stackwright-foreman-otter`));
+      console.log(import_chalk.default.dim(`  Then say: "Build me a [type] website for [name]"
+`));
+    }
+  } catch (err) {
+    console.error(import_chalk.default.red("\n\u274C Launch failed:"), err);
+    process.exit(1);
+  }
+}
+async function main() {
+  const program = new import_commander.Command();
+  program.name("launch-stackwright").description("\u{1F6A2} Launch a new Stackwright project with the otter raft ready to build").version(version).argument("[directory]", "Project directory", ".").option("--name <name>", "Project name (used in package.json)").option("--title <title>", "Site title shown in the app bar and browser tab").option("--theme <themeId>", "Theme ID (e.g., corporate, creative, minimal)").option("--force", "Launch even if the target directory is not empty").option("--skip-otters", "Skip copying otter raft configs").option("-y, --yes", "Skip all prompts, use defaults").action(async (directory, options) => {
+    const targetDir = import_path.default.resolve(directory);
+    await launch(targetDir, options);
+  });
+  await program.parseAsync(process.argv);
+}
+main().catch((err) => {
+  console.error(import_chalk.default.red("Internal error:"), err);
+  process.exit(2);
+});

package/dist/index.mjs

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports, module) {
+    module.exports = {
+      name: "launch-stackwright",
+      version: "0.1.0",
+      description: "Launch a new Stackwright project with the otter raft ready to build",
+      license: "MIT",
+      repository: {
+        type: "git",
+        url: "https://github.com/Per-Aspera-LLC/stackwright"
+      },
+      keywords: [
+        "stackwright",
+        "scaffolding",
+        "website-builder",
+        "otters",
+        "ai-agents"
+      ],
+      files: [
+        "dist",
+        "templates"
+      ],
+      bin: {
+        "launch-stackwright": "dist/index.js"
+      },
+      scripts: {
+        build: "tsup",
+        dev: "tsup --watch",
+        test: "vitest run"
+      },
+      dependencies: {
+        "@stackwright/cli": "workspace:*",
+        chalk: "^5.6.2",
+        commander: "^14.0.3",
+        "fs-extra": "^11.3",
+        prompts: "^2.4.2"
+      },
+      devDependencies: {
+        "@types/fs-extra": "^11.0",
+        "@types/node": "^25.4",
+        "@types/prompts": "^2.4.9",
+        typescript: "^5.0",
+        tsup: "^8.5",
+        vitest: "^4.0.18"
+      }
+    };
+  }
+});
+
+// src/index.ts
+import { Command } from "commander";
+import path from "path";
+import fs from "fs-extra";
+import chalk from "chalk";
+import { scaffold } from "@stackwright/cli";
+var { version } = require_package();
+async function copyOtterRaft(targetDir) {
+  const ottersSourceDir = path.resolve(__dirname, "../templates/otters");
+  const ottersTargetDir = path.join(targetDir, ".stackwright", "otters");
+  if (!fs.existsSync(ottersSourceDir)) {
+    console.warn(
+      chalk.yellow(
+        "\n\u26A0\uFE0F  Could not find otter raft configs. Skipping otter setup.\n   You can add them later from: https://github.com/Per-Aspera-LLC/stackwright/tree/main/otters"
+      )
+    );
+    return;
+  }
+  await fs.ensureDir(ottersTargetDir);
+  const otterFiles = (await fs.readdir(ottersSourceDir)).filter((f) => f.endsWith(".json"));
+  for (const file of otterFiles) {
+    await fs.copy(path.join(ottersSourceDir, file), path.join(ottersTargetDir, file));
+  }
+  const codePuppyConfig = {
+    mcp_servers: {
+      stackwright: {
+        command: "node",
+        args: [path.join(targetDir, "node_modules", "@stackwright", "mcp", "dist", "server.js")],
+        env: {
+          NODE_ENV: "development"
+        }
+      }
+    },
+    agents_path: ".stackwright/otters"
+  };
+  await fs.writeFile(
+    path.join(targetDir, ".code-puppy.json"),
+    JSON.stringify(codePuppyConfig, null, 2)
+  );
+  console.log(chalk.green("\u2705 Otter raft ready! \u{1F9A6}\u{1F9A6}\u{1F9A6}\u{1F9A6}"));
+  console.log(chalk.dim(`   Configs copied to: ${path.relative(process.cwd(), ottersTargetDir)}`));
+}
+async function launch(targetDir, options) {
+  const dirName = path.basename(targetDir);
+  console.log(chalk.cyan.bold("\n\u{1F6A2} Launching Stackwright...\n"));
+  const scaffoldOptions = {
+    name: options.name || dirName,
+    title: options.title,
+    theme: options.theme,
+    force: options.force,
+    noInteractive: options.yes
+  };
+  try {
+    const result = await scaffold(targetDir, scaffoldOptions);
+    console.log(chalk.green(`
+\u2705 Project scaffolded successfully!`));
+    console.log(chalk.dim(`   Location: ${result.path}`));
+    console.log(chalk.dim(`   Theme: ${result.theme}`));
+    console.log(chalk.dim(`   Pages: ${result.pages.join(", ")}`));
+    if (!options.skipOtters) {
+      console.log(chalk.cyan("\n\u{1F9A6} Setting up the otter raft...\n"));
+      await copyOtterRaft(targetDir);
+    }
+    console.log(chalk.cyan.bold("\n\u{1F389} All set! Here's what to do next:\n"));
+    console.log(chalk.white(`  1. cd ${path.relative(process.cwd(), targetDir) || "."}`));
+    console.log(chalk.white(`  2. pnpm install`));
+    console.log(chalk.white(`  3. pnpm dev`));
+    if (!options.skipOtters) {
+      console.log(
+        chalk.cyan.bold("\n\u{1F9A6} Want the otter raft to build your site for you?\n")
+      );
+      console.log(chalk.white(`  code-puppy invoke stackwright-foreman-otter`));
+      console.log(chalk.dim(`  Then say: "Build me a [type] website for [name]"
+`));
+    }
+  } catch (err) {
+    console.error(chalk.red("\n\u274C Launch failed:"), err);
+    process.exit(1);
+  }
+}
+async function main() {
+  const program = new Command();
+  program.name("launch-stackwright").description("\u{1F6A2} Launch a new Stackwright project with the otter raft ready to build").version(version).argument("[directory]", "Project directory", ".").option("--name <name>", "Project name (used in package.json)").option("--title <title>", "Site title shown in the app bar and browser tab").option("--theme <themeId>", "Theme ID (e.g., corporate, creative, minimal)").option("--force", "Launch even if the target directory is not empty").option("--skip-otters", "Skip copying otter raft configs").option("-y, --yes", "Skip all prompts, use defaults").action(async (directory, options) => {
+    const targetDir = path.resolve(directory);
+    await launch(targetDir, options);
+  });
+  await program.parseAsync(process.argv);
+}
+main().catch((err) => {
+  console.error(chalk.red("Internal error:"), err);
+  process.exit(2);
+});

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "launch-stackwright",
+  "version": "0.1.0",
+  "description": "Launch a new Stackwright project with the otter raft ready to build",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Per-Aspera-LLC/stackwright"
+  },
+  "keywords": [
+    "stackwright",
+    "scaffolding",
+    "website-builder",
+    "otters",
+    "ai-agents"
+  ],
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "bin": {
+    "launch-stackwright": "dist/index.js"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "fs-extra": "^11.3",
+    "prompts": "^2.4.2",
+    "@stackwright/cli": "0.7.0-alpha.3"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0",
+    "@types/node": "^25.4",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.0",
+    "tsup": "^8.5",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run"
+  }
+}