@sibyllinesoft/arbiter 0.1.0

package/dist/templates/plopfiles/presets/cli-go/templates/config.json.hbs

@@ -0,0 +1,9 @@
+{
+  "preset": "{{presetId}}",
+  "language": "{{language}}",
+  "storage": "markdown",
+  "sync": {
+    "autoDetectPackages": true,
+    "createMarkdownEntities": true
+  }
+}

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

@@ -0,0 +1,45 @@
+/**
+ * CLI Tool Preset - Node.js/TypeScript
+ *
+ * Initializes .arbiter/ directory for a Node.js 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 [
+    // Create .arbiter/README.md
+    {
+      type: "add",
+      path: "{{projectDir}}/.arbiter/README.md",
+      templateFile: `${templatesDir}/README.md.hbs`,
+      data: {
+        ...data,
+        presetId: "cli-node",
+        language: "typescript",
+      },
+    },
+    // Create .arbiter/config.json
+    {
+      type: "add",
+      path: "{{projectDir}}/.arbiter/config.json",
+      templateFile: `${templatesDir}/config.json.hbs`,
+      data: {
+        ...data,
+        presetId: "cli-node",
+        language: "typescript",
+      },
+    },
+  ];
+}
+
+export const id = "cli-node";
+export const name = "CLI Tool (Node.js/TypeScript)";
+export const description = "Command-line tool or library using Node.js/TypeScript/Bun";
+export const language = "typescript";
+export const category = "cli";

package/dist/templates/plopfiles/presets/cli-node/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"
+```

package/dist/templates/plopfiles/presets/cli-node/templates/config.json.hbs

@@ -0,0 +1,9 @@
+{
+  "preset": "{{presetId}}",
+  "language": "{{language}}",
+  "storage": "markdown",
+  "sync": {
+    "autoDetectPackages": true,
+    "createMarkdownEntities": true
+  }
+}

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

@@ -0,0 +1,43 @@
+/**
+ * CLI Tool Preset - Python
+ *
+ * Initializes .arbiter/ directory for a Python 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-python",
+        language: "python",
+      },
+    },
+    {
+      type: "add",
+      path: "{{projectDir}}/.arbiter/config.json",
+      templateFile: `${templatesDir}/config.json.hbs`,
+      data: {
+        ...data,
+        presetId: "cli-python",
+        language: "python",
+      },
+    },
+  ];
+}
+
+export const id = "cli-python";
+export const name = "CLI Tool (Python)";
+export const description = "Command-line tool or library using Python";
+export const language = "python";
+export const category = "cli";

package/dist/templates/plopfiles/presets/cli-python/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"
+```

package/dist/templates/plopfiles/presets/cli-python/templates/config.json.hbs

@@ -0,0 +1,9 @@
+{
+  "preset": "{{presetId}}",
+  "language": "{{language}}",
+  "storage": "markdown",
+  "sync": {
+    "autoDetectPackages": true,
+    "createMarkdownEntities": true
+  }
+}

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

@@ -0,0 +1,43 @@
+/**
+ * CLI Tool Preset - Rust
+ *
+ * Initializes .arbiter/ directory for a Rust 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-rust",
+        language: "rust",
+      },
+    },
+    {
+      type: "add",
+      path: "{{projectDir}}/.arbiter/config.json",
+      templateFile: `${templatesDir}/config.json.hbs`,
+      data: {
+        ...data,
+        presetId: "cli-rust",
+        language: "rust",
+      },
+    },
+  ];
+}
+
+export const id = "cli-rust";
+export const name = "CLI Tool (Rust)";
+export const description = "Command-line tool or library using Rust";
+export const language = "rust";
+export const category = "cli";

package/dist/templates/plopfiles/presets/cli-rust/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"
+```

package/dist/templates/plopfiles/presets/cli-rust/templates/config.json.hbs

@@ -0,0 +1,9 @@
+{
+  "preset": "{{presetId}}",
+  "language": "{{language}}",
+  "storage": "markdown",
+  "sync": {
+    "autoDetectPackages": true,
+    "createMarkdownEntities": true
+  }
+}

package/dist/templates/plopfiles/presets/loader.js

@@ -0,0 +1,125 @@
+/**
+ * Preset Loader
+ *
+ * Discovers and loads init presets from:
+ * 1. Project-level: .arbiter/presets/
+ * 2. User-level: ~/.arbiter/presets/
+ * 3. Built-in: this directory
+ */
+
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { pathExists, readdir } from "fs-extra";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Get search paths for presets (project → user → builtin)
+ */
+export function getPresetSearchPaths(projectDir) {
+  const paths = [];
+
+  // Project-level presets
+  if (projectDir) {
+    paths.push(join(projectDir, ".arbiter", "presets"));
+  }
+
+  // User-level presets
+  paths.push(join(homedir(), ".arbiter", "presets"));
+
+  // Built-in presets
+  paths.push(__dirname);
+
+  return paths;
+}
+
+/**
+ * List all available presets
+ */
+export async function listPresets(projectDir) {
+  const presets = new Map(); // Use Map to handle overrides (first found wins)
+  const searchPaths = getPresetSearchPaths(projectDir);
+
+  for (const basePath of searchPaths) {
+    if (!(await pathExists(basePath))) continue;
+
+    try {
+      const entries = await readdir(basePath, { withFileTypes: true });
+
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        if (entry.name.startsWith("_") || entry.name.startsWith(".")) continue;
+        if (entry.name === "loader.js") continue;
+
+        // Check if module.js exists
+        const modulePath = join(basePath, entry.name, "module.js");
+        if (!(await pathExists(modulePath))) continue;
+
+        // Only add if not already found (project overrides user overrides builtin)
+        if (!presets.has(entry.name)) {
+          try {
+            const mod = await import(modulePath);
+            presets.set(entry.name, {
+              id: mod.id || entry.name,
+              name: mod.name || entry.name,
+              description: mod.description || "",
+              language: mod.language,
+              category: mod.category,
+              path: modulePath,
+              source:
+                basePath === __dirname
+                  ? "builtin"
+                  : basePath.includes(".arbiter/presets")
+                    ? "project"
+                    : "user",
+            });
+          } catch (err) {
+            console.warn(`Warning: Failed to load preset ${entry.name}: ${err.message}`);
+          }
+        }
+      }
+    } catch {
+      // Directory not readable
+    }
+  }
+
+  return Array.from(presets.values());
+}
+
+/**
+ * Load a preset module by ID
+ */
+export async function loadPreset(presetId, projectDir) {
+  const searchPaths = getPresetSearchPaths(projectDir);
+
+  for (const basePath of searchPaths) {
+    const modulePath = join(basePath, presetId, "module.js");
+
+    if (await pathExists(modulePath)) {
+      return import(modulePath);
+    }
+  }
+
+  throw new Error(`Preset not found: ${presetId}`);
+}
+
+/**
+ * Execute a preset with the given context
+ */
+export async function executePreset(presetId, context, projectDir) {
+  const mod = await loadPreset(presetId, projectDir);
+
+  if (typeof mod.default !== "function") {
+    throw new Error(`Preset ${presetId} does not export a default function`);
+  }
+
+  return mod.default(context);
+}
+
+export default {
+  getPresetSearchPaths,
+  listPresets,
+  loadPreset,
+  executePreset,
+};

package/dist/templates/plopfiles/typescript-service/plopfile.js

@@ -0,0 +1,186 @@
+/**
+ * Plop Generator for TypeScript Services
+ *
+ * Generates a TypeScript service with Express/Hono structure.
+ */
+
+export default function (plop) {
+  // Case helpers
+  plop.setHelper("camelCase", (str) => {
+    if (!str) return "";
+    return str
+      .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ""))
+      .replace(/^(.)/, (c) => c.toLowerCase());
+  });
+
+  plop.setHelper("pascalCase", (str) => {
+    if (!str) return "";
+    return str
+      .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ""))
+      .replace(/^(.)/, (c) => c.toUpperCase());
+  });
+
+  plop.setHelper("kebabCase", (str) => {
+    if (!str) return "";
+    return str
+      .replace(/([a-z])([A-Z])/g, "$1-$2")
+      .replace(/[_\s]+/g, "-")
+      .toLowerCase();
+  });
+
+  plop.setHelper("snakeCase", (str) => {
+    if (!str) return "";
+    return str
+      .replace(/([a-z])([A-Z])/g, "$1_$2")
+      .replace(/[-\s]+/g, "_")
+      .toLowerCase();
+  });
+
+  // Default generator
+  plop.setGenerator("default", {
+    description: "Generate a TypeScript service",
+    prompts: [
+      {
+        type: "input",
+        name: "name",
+        message: "Service name:",
+        when: (answers) => !answers.name,
+      },
+      {
+        type: "list",
+        name: "framework",
+        message: "Framework:",
+        choices: ["hono", "express", "fastify"],
+        default: "hono",
+        when: (answers) => !answers.framework,
+      },
+      {
+        type: "confirm",
+        name: "includeDb",
+        message: "Include database setup?",
+        default: true,
+        when: (answers) => answers.includeDb === undefined,
+      },
+    ],
+    actions: (data) => {
+      const actions = [];
+      const basePath = "{{kebabCase name}}";
+
+      // Package.json
+      actions.push({
+        type: "add",
+        path: `${basePath}/package.json`,
+        templateFile: "templates/package.json.hbs",
+      });
+
+      // Main entry
+      actions.push({
+        type: "add",
+        path: `${basePath}/src/index.ts`,
+        templateFile: "templates/index.ts.hbs",
+      });
+
+      // Routes
+      actions.push({
+        type: "add",
+        path: `${basePath}/src/routes/index.ts`,
+        templateFile: "templates/routes/index.ts.hbs",
+      });
+
+      // Health route
+      actions.push({
+        type: "add",
+        path: `${basePath}/src/routes/health.ts`,
+        templateFile: "templates/routes/health.ts.hbs",
+      });
+
+      // Config
+      actions.push({
+        type: "add",
+        path: `${basePath}/src/config.ts`,
+        templateFile: "templates/config.ts.hbs",
+      });
+
+      // Types
+      actions.push({
+        type: "add",
+        path: `${basePath}/src/types.ts`,
+        templateFile: "templates/types.ts.hbs",
+      });
+
+      // Database setup if requested
+      if (data.includeDb) {
+        actions.push({
+          type: "add",
+          path: `${basePath}/src/db/index.ts`,
+          templateFile: "templates/db/index.ts.hbs",
+        });
+        actions.push({
+          type: "add",
+          path: `${basePath}/src/db/schema.ts`,
+          templateFile: "templates/db/schema.ts.hbs",
+        });
+      }
+
+      // Dockerfile
+      actions.push({
+        type: "add",
+        path: `${basePath}/Dockerfile`,
+        templateFile: "templates/Dockerfile.hbs",
+      });
+
+      // TypeScript config
+      actions.push({
+        type: "add",
+        path: `${basePath}/tsconfig.json`,
+        templateFile: "templates/tsconfig.json.hbs",
+      });
+
+      // README
+      actions.push({
+        type: "add",
+        path: `${basePath}/README.md`,
+        templateFile: "templates/README.md.hbs",
+      });
+
+      return actions;
+    },
+  });
+
+  // Component generator
+  plop.setGenerator("component", {
+    description: "Generate a service component (route, middleware, etc.)",
+    prompts: [
+      {
+        type: "list",
+        name: "type",
+        message: "Component type:",
+        choices: ["route", "middleware", "service", "model"],
+      },
+      {
+        type: "input",
+        name: "name",
+        message: "Component name:",
+      },
+    ],
+    actions: (data) => {
+      const actions = [];
+      const folder =
+        data.type === "route"
+          ? "routes"
+          : data.type === "middleware"
+            ? "middleware"
+            : data.type === "model"
+              ? "db"
+              : "services";
+
+      actions.push({
+        type: "add",
+        path: `src/${folder}/{{kebabCase name}}.ts`,
+        templateFile: `templates/component/${data.type}.ts.hbs`,
+      });
+
+      return actions;
+    },
+  });
+}

package/dist/templates/plopfiles/typescript-service/templates/Dockerfile.hbs

@@ -0,0 +1,29 @@
+FROM oven/bun:1 AS base
+WORKDIR /app
+
+# Install dependencies
+FROM base AS deps
+COPY package.json bun.lockb* ./
+RUN bun install --frozen-lockfile
+
+# Build
+FROM base AS builder
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN bun run build
+
+# Production
+FROM base AS runner
+ENV NODE_ENV=production
+
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 service
+USER service
+
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/package.json ./
+
+EXPOSE 3000
+ENV PORT=3000
+
+CMD ["bun", "run", "start"]