@shrkcrft/cli 0.1.0-alpha.2

package/dist/commands/dashboard.command.js

@@ -0,0 +1,106 @@
+/**
+ * `shrk dashboard` — start the local read-only dashboard.
+ *
+ * Defaults:
+ *  - host: 127.0.0.1
+ *  - port: 4567
+ *  - open: true when interactive (TTY)
+ *  - serves static UI from packages/dashboard/dist if available
+ *  - GET/HEAD only; POST/PUT/PATCH/DELETE → 405
+ *  - no write endpoints, ever
+ *
+ * Subcommand `shrk dashboard serve` is supported for backwards-compat.
+ */
+import { existsSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
+import { startDashboardApiServer } from "../dashboard/dashboard-api-server.js";
+import { asJson } from "../output/format-output.js";
+const DEFAULT_PORT = 4567;
+export const dashboardCommand = {
+    name: 'dashboard',
+    description: 'Start the local read-only SharkCraft dashboard (web UI + API). GET/HEAD only; 127.0.0.1 by default; no write endpoints.',
+    usage: 'shrk [--cwd <dir>] dashboard [serve] [--host <addr>] [--port <n>] [--open|--no-open] [--api-only] [--static-only] [--dev-assets <path>] [--json]',
+    async run(args) {
+        // `dashboard serve` is the same as `dashboard`.
+        const positional = args.positional[0] === 'serve' ? args.positional.slice(1) : args.positional;
+        const sliced = { ...args, positional };
+        return runServe(sliced);
+    },
+};
+function findStaticDir(args) {
+    const override = flagString(args, 'dev-assets');
+    if (override) {
+        const abs = nodePath.resolve(process.cwd(), override);
+        return existsSync(nodePath.join(abs, 'index.html')) ? abs : null;
+    }
+    // Look near this source file: ../../../dashboard/dist
+    const here = fileURLToPath(import.meta.url);
+    const candidates = [
+        nodePath.resolve(here, '../../../../dashboard/dist'),
+        nodePath.resolve(here, '../../../dashboard/dist'),
+        nodePath.resolve(process.cwd(), 'packages/dashboard/dist'),
+    ];
+    for (const c of candidates) {
+        if (existsSync(nodePath.join(c, 'index.html')))
+            return c;
+    }
+    return null;
+}
+async function runServe(args) {
+    const cwd = resolveCwd(args);
+    const host = flagString(args, 'host') ?? '127.0.0.1';
+    const port = Number(flagString(args, 'port') ?? String(DEFAULT_PORT));
+    const apiOnly = flagBool(args, 'api-only');
+    const staticOnly = flagBool(args, 'static-only');
+    const wantJson = flagBool(args, 'json');
+    const noOpen = flagBool(args, 'no-open');
+    const open = !noOpen && (flagBool(args, 'open') || (!wantJson && process.stdout.isTTY === true));
+    let staticDir = null;
+    if (!apiOnly) {
+        staticDir = findStaticDir(args);
+        if (!staticDir && !staticOnly) {
+            process.stderr.write('Dashboard assets not built. Run `bun run dashboard:build` to build them, or pass --api-only to skip.\n');
+            // Continue API-only — not fatal.
+        }
+        else if (!staticDir && staticOnly) {
+            process.stderr.write('Dashboard assets not built. Run `bun run dashboard:build` first.\n');
+            return 1;
+        }
+    }
+    const handle = await startDashboardApiServer({ cwd, host, port, staticDir: apiOnly ? null : staticDir });
+    if (wantJson) {
+        process.stdout.write(asJson({
+            url: handle.url,
+            host: handle.host,
+            port: handle.port,
+            projectRoot: cwd,
+            staticDir,
+            readOnly: true,
+        }) + '\n');
+    }
+    else {
+        process.stdout.write(`SharkCraft dashboard at ${handle.url}\n` +
+            `  project root: ${cwd}\n` +
+            (staticDir ? `  static assets: ${staticDir}\n` : `  (api-only; no UI assets)\n`) +
+            `  read-only: GET/HEAD only. The dashboard never writes — it shows copyable CLI commands.\n` +
+            `(press Ctrl+C to stop)\n`);
+    }
+    if (open && process.platform === 'darwin') {
+        try {
+            const { spawnSync } = (await import('node:child_process'));
+            spawnSync('open', [handle.url]);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return new Promise((resolve) => {
+        const shutdown = () => {
+            handle.close().finally(() => resolve(0));
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+    });
+}

package/dist/commands/dev.command.d.ts

@@ -0,0 +1,3 @@
+import { type ICommandHandler } from '../command-registry.js';
+export declare const devCommand: ICommandHandler;
+//# sourceMappingURL=dev.command.d.ts.map

package/dist/commands/dev.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.command.d.ts","sourceRoot":"","sources":["../../src/commands/dev.command.ts"],"names":[],"mappings":"AA6CA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA67ChC,eAAO,MAAM,UAAU,EAAE,eAkExB,CAAC"}