@fapost/jig-ui 0.0.0-stage → 0.1.0-next.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexander Zinchenko
+
+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/dist/args.js

@@ -0,0 +1,32 @@
+import { parseArgs } from 'node:util';
+export const DEFAULT_PORT = 4870;
+/** Parses the command line (without the node and script entries). Pure: it never exits or prints. */
+export function parseCliArgs(argv) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args: argv,
+            strict: true,
+            allowPositionals: false,
+            options: {
+                port: { type: 'string' },
+                help: { type: 'boolean', short: 'h' },
+                version: { type: 'boolean', short: 'v' },
+            },
+        }));
+    }
+    catch (error) {
+        return { kind: 'error', message: error instanceof Error ? error.message : String(error) };
+    }
+    if (values.help)
+        return { kind: 'help' };
+    if (values.version)
+        return { kind: 'version' };
+    if (values.port === undefined)
+        return { kind: 'run', port: DEFAULT_PORT };
+    const port = /^\d+$/.test(values.port) ? Number(values.port) : Number.NaN;
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        return { kind: 'error', message: `Invalid --port value: ${values.port}. Use a number from 1 to 65535.` };
+    }
+    return { kind: 'run', port };
+}

package/dist/cli.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+// Entry point. It must parse and run on any Node.js, so that an old one gets a clear message
+// instead of a syntax error: no dependencies are imported here, and the real program is loaded
+// only after the version check.
+import { checkNodeVersion } from './node-version.js';
+const nodeCheck = checkNodeVersion(process.versions.node);
+if (!nodeCheck.ok) {
+    console.error(nodeCheck.message);
+    process.exit(1);
+}
+else {
+    import('./main.js')
+        .then((m) => m.main())
+        .catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    });
+}

package/dist/http/app.js

@@ -0,0 +1,45 @@
+import { readFileSync } from 'node:fs';
+import { Hono } from 'hono';
+/**
+ * Reads the version from the package's own package.json. The relative path is the same from
+ * `server/http/` (tests) and `dist/http/` (published), as both sit two levels below the root.
+ */
+export function readPackageVersion() {
+    const url = new URL('../../package.json', import.meta.url);
+    const pkg = JSON.parse(readFileSync(url, 'utf8'));
+    return pkg.version;
+}
+/** Refuses requests whose `Host` or `Origin` is not this server's own loopback address. */
+export function localOnly(port) {
+    const hosts = new Set([`127.0.0.1:${port}`, `localhost:${port}`]);
+    const origins = new Set([`http://127.0.0.1:${port}`, `http://localhost:${port}`]);
+    return async (c, next) => {
+        const host = c.req.header('host');
+        const origin = c.req.header('origin');
+        if (host === undefined || !hosts.has(host.toLowerCase())) {
+            return c.text('Forbidden', 403);
+        }
+        if (origin !== undefined && !origins.has(origin.toLowerCase())) {
+            return c.text('Forbidden', 403);
+        }
+        await next();
+    };
+}
+export function createApp({ port, version = readPackageVersion() }) {
+    const app = new Hono();
+    app.use(localOnly(port));
+    app.get('/', (c) => c.html(`<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Jig UI</title>
+  </head>
+  <body>
+    <h1>Jig UI &mdash; not built yet</h1>
+    <p>Version ${version}</p>
+  </body>
+</html>
+`));
+    return app;
+}

package/dist/main.js

@@ -0,0 +1,47 @@
+import { serve } from '@hono/node-server';
+import { parseCliArgs } from './args.js';
+import { createApp, readPackageVersion } from './http/app.js';
+const HOST = '127.0.0.1';
+const HELP = `Usage: jig-ui [options]
+
+Options:
+  --port <n>     Port to listen on (default 4870)
+  -v, --version  Print the version and exit
+  -h, --help     Print this help and exit
+`;
+function fail(message) {
+    console.error(message);
+    process.exit(1);
+}
+export function main() {
+    const command = parseCliArgs(process.argv.slice(2));
+    if (command.kind === 'error')
+        fail(command.message);
+    if (command.kind === 'help') {
+        process.stdout.write(HELP);
+        return;
+    }
+    if (command.kind === 'version') {
+        console.log(readPackageVersion());
+        return;
+    }
+    const { port } = command;
+    const version = readPackageVersion();
+    const server = serve({ fetch: createApp({ port, version }).fetch, hostname: HOST, port }, () => {
+        console.log(`Jig UI ${version} is running at http://${HOST}:${port}/`);
+        console.log('Press Ctrl+C to stop.');
+    });
+    server.on('error', (error) => {
+        if (error.code === 'EADDRINUSE') {
+            fail(`Port ${port} is already in use. Stop the other process or choose another port with --port.`);
+        }
+        fail(`Could not start the server: ${error.message}`);
+    });
+    const shutdown = () => {
+        server.close(() => process.exit(0));
+        if ('closeAllConnections' in server)
+            server.closeAllConnections();
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}

package/dist/node-version.js

@@ -0,0 +1,14 @@
+// This module is imported by the CLI entry before anything else, so it must parse on old Node.js.
+export const MINIMUM_NODE_MAJOR = 24;
+/** Checks a Node.js version string such as `v24.1.0` or `24.1.0` against the supported minimum. */
+export function checkNodeVersion(version) {
+    const major = Number.parseInt(version.replace(/^v/, '').split('.')[0] || '', 10);
+    if (Number.isInteger(major) && major >= MINIMUM_NODE_MAJOR) {
+        return { ok: true };
+    }
+    return {
+        ok: false,
+        message: 'Jig UI needs Node.js ' + MINIMUM_NODE_MAJOR + ' or later, but this is ' + version +
+            '. Install a newer Node.js and run it again.',
+    };
+}

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@fapost/jig-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-next.1",
+  "description": "A local web interface for Jig, the agent SDLC framework.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "jig-ui": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fapost-lab/jig-ui.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@hono/node-server": "^2.1.5",
+    "hono": "^4.13.13"
+  },
+  "devDependencies": {
+    "@types/node": "^24.19.2",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.4"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.