@janux/cli 0.1.0

package/README.md

@@ -0,0 +1,3 @@
+# @janux/cli
+
+CLI for [Janux](https://github.com/aralroca/Janux): `janux dev` (Vite + HMR), `janux build` (client bundle), `janux start` (production server on Bun).

package/bin.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env bun
+import { runCli } from './src/index';
+
+runCli(process.argv.slice(2)).catch((error) => {
+  console.error(String(error));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@janux/cli",
+  "version": "0.1.0",
+  "description": "Janux CLI: dev (Vite), build (client bundle) and start (production server on Bun).",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aralroca/Janux.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Aral Roca Gomez",
+    "email": "contact@aralroca.com"
+  },
+  "type": "module",
+  "bin": {
+    "janux": "./bin.ts"
+  },
+  "main": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "janux": "0.1.0",
+    "@janux/server": "0.1.0",
+    "@janux/agent": "0.1.0",
+    "@janux/vite": "0.1.0",
+    "vite": "^7.3.0"
+  },
+  "homepage": "https://github.com/aralroca/Janux#readme",
+  "bugs": "https://github.com/aralroca/Janux/issues",
+  "keywords": [
+    "janux",
+    "agentic-ui",
+    "mcp",
+    "webmcp",
+    "ai-agents",
+    "fullstack",
+    "framework",
+    "bun",
+    "vite",
+    "resumability",
+    "copilot"
+  ],
+  "files": [
+    "src",
+    "bin.ts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.0"
+  }
+}

package/src/args.test.ts

@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'bun:test';
+import { HELP_TEXT, parseArgs } from './args';
+
+describe('janux CLI args', () => {
+  it('parses commands and the port flag', () => {
+    expect(parseArgs(['dev', '--port', '4000'], '/app')).toEqual({
+      command: 'dev',
+      port: 4000,
+      root: '/app',
+    });
+    expect(parseArgs(['build'], '/app').command).toBe('build');
+    expect(parseArgs(['start'], '/app').command).toBe('start');
+  });
+
+  it('falls back to help on unknown commands', () => {
+    expect(parseArgs(['nope'], '/app').command).toBe('help');
+    expect(parseArgs([], '/app').command).toBe('help');
+    expect(HELP_TEXT).toContain('janux dev');
+  });
+
+  it('rejects non-numeric ports', () => {
+    expect(() => parseArgs(['dev', '--port', 'abc'], '/app')).toThrow(/--port/);
+  });
+});

package/src/args.ts

@@ -0,0 +1,25 @@
+export interface CliCommand {
+  command: 'dev' | 'build' | 'start' | 'help';
+  port: number;
+  root: string;
+}
+
+const COMMANDS = new Set(['dev', 'build', 'start', 'help']);
+
+export const HELP_TEXT = `janux — the agent-native fullstack UI framework
+
+Usage:
+  janux dev    [--port 3000]   Start the dev server (Vite + HMR)
+  janux build                  Bundle client assets for production
+  janux start  [--port 3000]   Run the production server (Bun)
+`;
+
+export function parseArgs(argv: string[], cwd: string): CliCommand {
+  const command = COMMANDS.has(argv[0] ?? '') ? (argv[0] as CliCommand['command']) : 'help';
+  const portFlag = argv.indexOf('--port');
+  const port = portFlag >= 0 ? Number(argv[portFlag + 1]) : Number(process.env.PORT ?? 3000);
+
+  if (Number.isNaN(port)) throw new Error('janux: --port must be a number');
+
+  return { command, port, root: cwd };
+}

package/src/commands.ts

@@ -0,0 +1,84 @@
+import { cpSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { createJanuxServer, type ServerOptions } from '@janux/server';
+import { defineAgent } from '@janux/agent';
+import { apiFiles, apiModuleName, janux, resolveAppConfig } from '@janux/vite';
+import type { CliCommand } from './args';
+
+export async function dev({ root, port }: CliCommand): Promise<void> {
+  const { createServer } = await import('vite');
+  const server = await createServer({ root, plugins: [janux()], server: { port } });
+
+  await server.listen();
+  console.log(`\n  janux dev ready\n  → app:      http://localhost:${port}/`);
+  console.log(`  → manifest: http://localhost:${port}/_janux/manifest`);
+  console.log(`  → agent:    http://localhost:${port}/_janux/agent\n`);
+}
+
+export async function build({ root }: CliCommand): Promise<void> {
+  const app = resolveAppConfig(root);
+
+  if (app.clientEntry) {
+    const { build: viteBuild } = await import('vite');
+
+    await viteBuild({
+      root,
+      plugins: [janux()],
+      build: {
+        outDir: 'dist/client',
+        rollupOptions: { input: app.clientEntry, output: { entryFileNames: 'client.js' } },
+      },
+    });
+  } else {
+    console.log('janux build: no src/client.ts — fully static app, nothing to bundle (0 KB JS).');
+  }
+  copyStylesheet(app.stylesheet, root);
+}
+
+function copyStylesheet(stylesheet: string | undefined, root: string): void {
+  if (!stylesheet) return;
+  const outDir = join(root, 'dist/client');
+
+  mkdirSync(outDir, { recursive: true });
+  cpSync(stylesheet, join(outDir, 'styles.css'));
+}
+
+async function prodServerOptions(root: string): Promise<ServerOptions> {
+  const app = resolveAppConfig(root);
+  const apiModules = Object.fromEntries(
+    await Promise.all(
+      apiFiles(app.serverDir).map(async (file) => [apiModuleName(file), await import(file)]),
+    ),
+  );
+  const agentModule = app.agentModule ? await import(app.agentModule) : undefined;
+  const storesModule = app.storesModule ? await import(app.storesModule) : undefined;
+
+  return {
+    routesDir: app.routesDir,
+    apis: apiModules,
+    agent: agentModule?.default ?? defineAgent(),
+    storeDefs: storesModule ?? {},
+    runtimeUrl: existsSync(join(root, 'dist/client/client.js')) ? '/client.js' : undefined,
+    stylesheets: app.stylesheet ? ['/styles.css'] : [],
+    title: app.title,
+  };
+}
+
+export async function start({ root, port }: CliCommand): Promise<void> {
+  const options = await prodServerOptions(root);
+  const server = createJanuxServer(options);
+  const staticDir = join(root, 'dist/client');
+
+  Bun.serve({
+    port,
+    fetch: async (req) => {
+      const { pathname } = new URL(req.url);
+      const staticFile = Bun.file(join(staticDir, pathname.slice(1)));
+
+      if (pathname !== '/' && (await staticFile.exists())) return new Response(staticFile);
+
+      return server.fetch(req);
+    },
+  });
+  console.log(`janux start: production server on http://localhost:${port}/ (Bun)`);
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+import { HELP_TEXT, parseArgs } from './args';
+import { build, dev, start } from './commands';
+
+export { parseArgs, HELP_TEXT } from './args';
+
+export async function runCli(argv: string[]): Promise<void> {
+  const parsed = parseArgs(argv, process.cwd());
+
+  if (parsed.command === 'dev') return dev(parsed);
+  if (parsed.command === 'build') return build(parsed);
+  if (parsed.command === 'start') return start(parsed);
+  console.log(HELP_TEXT);
+}