@sibyllinesoft/arbiter 0.1.0

package/dist/templates/plopfiles/_modules/storybook/react-storybook/module.js

@@ -0,0 +1,54 @@
+/**
+ * Storybook for React Module
+ *
+ * Sets up Storybook for React component development and documentation.
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatesDir = resolve(__dirname, "templates");
+
+export default function (data) {
+  const frontendDir = data.frontendDir || "frontend";
+
+  return [
+    {
+      type: "addMany",
+      destination: `{{projectDir}}/${frontendDir}`,
+      base: templatesDir,
+      templateFiles: `${templatesDir}/**/*.hbs`,
+      stripExtensions: ["hbs"],
+      data,
+    },
+  ];
+}
+
+export const description = "Storybook - Component development and documentation for React";
+
+export const dependencies = {};
+
+export const devDependencies = {
+  "@storybook/addon-essentials": "^8.4.0",
+  "@storybook/addon-interactions": "^8.4.0",
+  "@storybook/addon-links": "^8.4.0",
+  "@storybook/addon-onboarding": "^8.4.0",
+  "@storybook/addon-docs": "^8.4.0",
+  "@storybook/addon-a11y": "^8.4.0",
+  "@storybook/blocks": "^8.4.0",
+  "@storybook/react": "^8.4.0",
+  "@storybook/react-vite": "^8.4.0",
+  "@storybook/test": "^8.4.0",
+  "@storybook/manager-api": "^8.4.0",
+  "@storybook/theming": "^8.4.0",
+  storybook: "^8.4.0",
+};
+
+export const scripts = {
+  storybook: "storybook dev -p 6006",
+  "build-storybook": "storybook build",
+  "test-storybook": "test-storybook",
+};
+
+export const envVars = {};

package/dist/templates/plopfiles/_modules/storybook/react-storybook/templates/.storybook/main.ts.hbs

@@ -0,0 +1,44 @@
+import type { StorybookConfig } from "@storybook/react-vite";
+
+const config: StorybookConfig = {
+  stories: [
+    "../src/**/*.mdx",
+    "../src/**/*.stories.@(js|jsx|mjs|ts|tsx)",
+  ],
+  addons: [
+    "@storybook/addon-onboarding",
+    "@storybook/addon-links",
+    "@storybook/addon-essentials",
+    "@storybook/addon-interactions",
+    "@storybook/addon-a11y",
+    "@storybook/addon-docs",
+  ],
+  framework: {
+    name: "@storybook/react-vite",
+    options: {},
+  },
+  docs: {
+    autodocs: "tag",
+    defaultName: "Documentation",
+  },
+  staticDirs: ["../public"],
+  typescript: {
+    reactDocgen: "react-docgen-typescript",
+    reactDocgenTypescriptOptions: {
+      shouldExtractLiteralValuesFromEnum: true,
+      shouldRemoveUndefinedFromOptional: true,
+      propFilter: (prop) =>
+        prop.parent ? !/node_modules/.test(prop.parent.fileName) : true,
+    },
+  },
+  viteFinal: async (config) => {
+    return {
+      ...config,
+      define: {
+        "process.env": {},
+      },
+    };
+  },
+};
+
+export default config;

package/dist/templates/plopfiles/_modules/storybook/react-storybook/templates/.storybook/preview.ts.hbs

@@ -0,0 +1,68 @@
+import type { Preview } from "@storybook/react";
+import "../src/index.css";
+
+const preview: Preview = {
+  parameters: {
+    actions: { argTypesRegex: "^on[A-Z].*" },
+    controls: {
+      matchers: {
+        color: /(background|color)$/i,
+        date: /Date$/i,
+      },
+      expanded: true,
+      sort: "requiredFirst",
+    },
+    docs: {
+      toc: true,
+    },
+    layout: "centered",
+    backgrounds: {
+      default: "light",
+      values: [
+        { name: "light", value: "#ffffff" },
+        { name: "dark", value: "#1a1a1a" },
+        { name: "gray", value: "#f5f5f5" },
+      ],
+    },
+    viewport: {
+      viewports: {
+        mobile: {
+          name: "Mobile",
+          styles: { width: "375px", height: "667px" },
+        },
+        tablet: {
+          name: "Tablet",
+          styles: { width: "768px", height: "1024px" },
+        },
+        desktop: {
+          name: "Desktop",
+          styles: { width: "1440px", height: "900px" },
+        },
+      },
+    },
+  },
+  globalTypes: {
+    theme: {
+      name: "Theme",
+      description: "Global theme for components",
+      defaultValue: "light",
+      toolbar: {
+        icon: "circlehollow",
+        items: [
+          { value: "light", icon: "sun", title: "Light" },
+          { value: "dark", icon: "moon", title: "Dark" },
+        ],
+        showName: true,
+      },
+    },
+  },
+  decorators: [
+    (Story, context) => {
+      const theme = context.globals.theme;
+      document.documentElement.classList.toggle("dark", theme === "dark");
+      return <Story />;
+    },
+  ],
+};
+
+export default preview;

package/dist/templates/plopfiles/_modules/storybook/react-storybook/templates/src/stories/Button.stories.tsx.hbs

@@ -0,0 +1,158 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { fn } from "@storybook/test";
+import { Button } from "../components/Button";
+
+/**
+ * Primary UI component for user interaction.
+ *
+ * ## Usage
+ *
+ * ```tsx
+ * import { Button } from "./components/Button";
+ *
+ * <Button variant="primary" onClick={() => {}}>
+ *   Click me
+ * </Button>
+ * ```
+ */
+const meta = {
+  title: "Components/Button",
+  component: Button,
+  parameters: {
+    layout: "centered",
+    docs: {
+      description: {
+        component: "A versatile button component with multiple variants and sizes.",
+      },
+    },
+  },
+  tags: ["autodocs"],
+  argTypes: {
+    variant: {
+      control: "select",
+      options: ["primary", "secondary", "outline", "ghost", "destructive"],
+      description: "The visual style of the button",
+      table: {
+        type: { summary: "string" },
+        defaultValue: { summary: "primary" },
+      },
+    },
+    size: {
+      control: "select",
+      options: ["sm", "md", "lg"],
+      description: "The size of the button",
+      table: {
+        type: { summary: "string" },
+        defaultValue: { summary: "md" },
+      },
+    },
+    disabled: {
+      control: "boolean",
+      description: "Whether the button is disabled",
+    },
+    loading: {
+      control: "boolean",
+      description: "Whether to show a loading spinner",
+    },
+    onClick: {
+      action: "clicked",
+      description: "Click handler",
+    },
+  },
+  args: {
+    onClick: fn(),
+  },
+} satisfies Meta<typeof Button>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+/**
+ * The default button style.
+ */
+export const Primary: Story = {
+  args: {
+    variant: "primary",
+    children: "Primary Button",
+  },
+};
+
+/**
+ * Secondary buttons are used for less prominent actions.
+ */
+export const Secondary: Story = {
+  args: {
+    variant: "secondary",
+    children: "Secondary Button",
+  },
+};
+
+/**
+ * Outline buttons have a transparent background.
+ */
+export const Outline: Story = {
+  args: {
+    variant: "outline",
+    children: "Outline Button",
+  },
+};
+
+/**
+ * Ghost buttons are minimal and blend with the background.
+ */
+export const Ghost: Story = {
+  args: {
+    variant: "ghost",
+    children: "Ghost Button",
+  },
+};
+
+/**
+ * Destructive buttons indicate dangerous actions.
+ */
+export const Destructive: Story = {
+  args: {
+    variant: "destructive",
+    children: "Delete",
+  },
+};
+
+/**
+ * Small buttons for compact UIs.
+ */
+export const Small: Story = {
+  args: {
+    size: "sm",
+    children: "Small",
+  },
+};
+
+/**
+ * Large buttons for prominent CTAs.
+ */
+export const Large: Story = {
+  args: {
+    size: "lg",
+    children: "Large Button",
+  },
+};
+
+/**
+ * Disabled state prevents interaction.
+ */
+export const Disabled: Story = {
+  args: {
+    disabled: true,
+    children: "Disabled",
+  },
+};
+
+/**
+ * Loading state shows a spinner.
+ */
+export const Loading: Story = {
+  args: {
+    loading: true,
+    children: "Loading...",
+  },
+};

package/dist/templates/plopfiles/_modules/types.ts

@@ -0,0 +1,98 @@
+/**
+ * Module Types for Composable Templates
+ *
+ * Each module exports a function that returns plop actions,
+ * plus metadata about dependencies and scripts.
+ */
+
+import type { ActionType } from "node-plop";
+
+/**
+ * Context passed from Arbiter CUE spec to template modules
+ */
+export interface ModuleContext {
+  // From CUE spec
+  name: string;
+  language?: string;
+  framework?: string;
+  sourceDirectory?: string;
+
+  // Service-specific
+  serviceType?: string;
+  platform?: string;
+  ports?: Array<{ name: string; port: number; targetPort?: number }>;
+
+  // Database-specific
+  infrastructureType?: string;
+  image?: string;
+  attachTo?: string;
+
+  // Computed paths
+  projectDir: string;
+  backendDir?: string;
+  frontendDir?: string;
+
+  // User selections for composition
+  backend?: string;
+  frontend?: string;
+  database?: string;
+  infra?: string[];
+
+  // Additional impl options
+  impl?: Record<string, unknown>;
+
+  // Allow arbitrary additional fields from spec
+  [key: string]: unknown;
+}
+
+/**
+ * Package.json dependency entries
+ */
+export interface Dependencies {
+  [packageName: string]: string;
+}
+
+/**
+ * Package.json script entries
+ */
+export interface Scripts {
+  [scriptName: string]: string;
+}
+
+/**
+ * Module definition - what each module.js exports
+ */
+export interface TemplateModule {
+  /** Returns plop actions for this module */
+  default: (data: ModuleContext) => ActionType[];
+
+  /** Runtime dependencies to merge into package.json */
+  dependencies?: Dependencies;
+
+  /** Dev dependencies to merge into package.json */
+  devDependencies?: Dependencies;
+
+  /** Scripts to merge into package.json */
+  scripts?: Scripts;
+
+  /** Environment variables this module needs */
+  envVars?: Record<string, string>;
+
+  /** Other modules this depends on (for ordering) */
+  requires?: string[];
+
+  /** Human-readable description */
+  description?: string;
+}
+
+/**
+ * Manifest for a composed project
+ */
+export interface ComposedManifest {
+  name: string;
+  modules: string[];
+  dependencies: Dependencies;
+  devDependencies: Dependencies;
+  scripts: Scripts;
+  envVars: Record<string, string>;
+}

package/dist/templates/plopfiles/full-stack/plopfile.js

@@ -0,0 +1,132 @@
+/**
+ * Full-Stack Project Composer
+ *
+ * Interactive plopfile that composes multiple modules (backend, frontend, database, infra)
+ * into a complete project scaffold.
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { composeModules, getModuleChoices } from "../_modules/composer.js";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatesDir = resolve(__dirname, "templates");
+
+export default function (plop) {
+  plop.setGenerator("full-stack", {
+    description: "Create a full-stack project with customizable tech stack",
+    prompts: async (inquirer) => {
+      const choices = await getModuleChoices();
+
+      return inquirer.prompt([
+        {
+          type: "input",
+          name: "name",
+          message: "Project name:",
+          validate: (input) => (input ? true : "Project name is required"),
+        },
+        {
+          type: "list",
+          name: "backend",
+          message: "Backend framework:",
+          choices: choices.backends.length > 0 ? choices.backends : ["none"],
+          default: choices.backends[0] || "none",
+        },
+        {
+          type: "list",
+          name: "frontend",
+          message: "Frontend framework:",
+          choices: choices.frontends,
+          default: "none",
+        },
+        {
+          type: "list",
+          name: "database",
+          message: "Database:",
+          choices: choices.databases,
+          default: "none",
+        },
+        {
+          type: "checkbox",
+          name: "infra",
+          message: "Infrastructure (select multiple):",
+          choices: choices.infra.length > 0 ? choices.infra : [],
+        },
+        {
+          type: "input",
+          name: "backendDir",
+          message: "Backend directory name:",
+          default: "backend",
+          when: (answers) => answers.backend !== "none",
+        },
+        {
+          type: "input",
+          name: "frontendDir",
+          message: "Frontend directory name:",
+          default: "frontend",
+          when: (answers) => answers.frontend !== "none",
+        },
+      ]);
+    },
+    actions: async (data) => {
+      const context = {
+        ...data,
+        projectDir: process.cwd(),
+      };
+
+      const { actions, manifest } = await composeModules(
+        {
+          backend: data.backend,
+          frontend: data.frontend,
+          database: data.database,
+          infra: data.infra || [],
+        },
+        context,
+      );
+
+      // Add root package.json
+      actions.push({
+        type: "add",
+        path: "{{projectDir}}/package.json",
+        templateFile: `${templatesDir}/package.json.hbs`,
+        data: { ...context, manifest },
+        skipIfExists: true,
+      });
+
+      // Add root .env.example
+      if (Object.keys(manifest.envVars).length > 0) {
+        actions.push({
+          type: "add",
+          path: "{{projectDir}}/.env.example",
+          template:
+            Object.entries(manifest.envVars)
+              .map(([k, v]) => `${k}=${v}`)
+              .join("\n") + "\n",
+          skipIfExists: true,
+        });
+      }
+
+      // Add .gitignore
+      actions.push({
+        type: "add",
+        path: "{{projectDir}}/.gitignore",
+        templateFile: `${templatesDir}/gitignore.hbs`,
+        skipIfExists: true,
+      });
+
+      // Log the composed modules
+      actions.push({
+        type: "log",
+        message: `\n✓ Created project "${data.name}" with modules:\n  ${manifest.modules.join("\n  ")}\n`,
+      });
+
+      return actions;
+    },
+  });
+
+  // Custom log action type
+  plop.setActionType("log", (answers, config) => {
+    console.log(config.message);
+    return config.message;
+  });
+}

package/dist/templates/plopfiles/full-stack/templates/gitignore.hbs

@@ -0,0 +1,44 @@
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Build outputs
+dist/
+build/
+.next/
+out/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Testing
+coverage/
+.nyc_output/
+
+# Database
+*.sqlite
+*.db
+
+# Misc
+.cache/
+tmp/

package/dist/templates/plopfiles/full-stack/templates/package.json.hbs

@@ -0,0 +1,21 @@
+{
+  "name": "{{kebabCase name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    {{#each manifest.scripts}}
+    "{{@key}}": "{{this}}"{{#unless @last}},{{/unless}}
+    {{/each}}
+  },
+  "dependencies": {
+    {{#each manifest.dependencies}}
+    "{{@key}}": "{{this}}"{{#unless @last}},{{/unless}}
+    {{/each}}
+  },
+  "devDependencies": {
+    {{#each manifest.devDependencies}}
+    "{{@key}}": "{{this}}"{{#unless @last}},{{/unless}}
+    {{/each}}
+  }
+}

package/dist/templates/plopfiles/presets/cli-go/module.js

@@ -0,0 +1,43 @@
+/**
+ * CLI Tool Preset - Go
+ *
+ * Initializes .arbiter/ directory for a Go CLI tool or library.
+ * Creates minimal structure - use `arbiter sync` to detect packages.
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatesDir = resolve(__dirname, "templates");
+
+export default function (data) {
+  return [
+    {
+      type: "add",
+      path: "{{projectDir}}/.arbiter/README.md",
+      templateFile: `${templatesDir}/README.md.hbs`,
+      data: {
+        ...data,
+        presetId: "cli-go",
+        language: "go",
+      },
+    },
+    {
+      type: "add",
+      path: "{{projectDir}}/.arbiter/config.json",
+      templateFile: `${templatesDir}/config.json.hbs`,
+      data: {
+        ...data,
+        presetId: "cli-go",
+        language: "go",
+      },
+    },
+  ];
+}
+
+export const id = "cli-go";
+export const name = "CLI Tool (Go)";
+export const description = "Command-line tool or library using Go";
+export const language = "go";
+export const category = "cli";

package/dist/templates/plopfiles/presets/cli-go/templates/README.md.hbs

@@ -0,0 +1,42 @@
+---
+type: project
+entityId: {{uuid}}
+createdAt: {{timestamp}}
+updatedAt: {{timestamp}}
+preset: {{presetId}}
+language: {{language}}
+tags:
+  - cli
+  - {{language}}
+---
+
+# {{name}}
+
+Command-line tool built with {{language}}.
+
+## Getting Started
+
+Run `arbiter sync` to detect packages and create service entities.
+
+```bash
+arbiter sync
+```
+
+## Viewing Your Spec
+
+- **CLI**: `arbiter list service`, `arbiter list package`
+- **Browser**: `arbiter view` to start documentation server
+- **Obsidian**: Open `.arbiter/` folder as a vault
+
+## Adding Entities
+
+```bash
+# Add a service
+arbiter add service my-service --language {{language}}
+
+# Add a task
+arbiter add task "Implement feature X"
+
+# Add a group (milestone)
+arbiter add group "v1.0 Release"
+```