@divlet/cli 0.0.0-stage → 0.0.1

package/README.md

@@ -1,3 +1,13 @@
-# Temporary Holding Version
+# @divlet/cli
 
-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.
+The command-line adapter for divlet. This package owns its implementation and depends on the exact matching `@divlet/core` product version; the core does not contain another copy.
+
+Install:
+
+```bash
+npx -y @divlet/cli@0.0.1 ./my-project
+```
+
+The installed binary is `divlet`. Importing the package exposes `runCli` without starting a service; the executable starts it explicitly. Checkout commands use `node scripts/source.mjs cli/index.js` from the repository root.
+
+Shared development, release notes and publication guidance live in the [divlet repository](https://github.com/llblab/divlet).

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 divlet contributors
+
+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/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export function runCli(argv?: string[]): Promise<void>;

package/dist/index.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { openRuntime, launch, makeHost } from '@divlet/core';
+export async function runCli(argv = process.argv.slice(2)) {
+    const args = argv;
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`divlet [path] [--port <0..65535>] [--no-demo] [--no-watch]
+
+  Opens the project at <path> (default: the current directory):
+    <path>.divlet                  open that project (created if absent)
+    <path>.pen or <path>.html      convert once into the <name>.divlet beside it and open that; the imported file is kept as it was
+    <folder>/project.divlet        default when the folder has no projects
+    <folder>/*.{divlet,pen}        one opens directly; several show a launcher (.html files open only by path)
+  Local resources are resolved automatically, including files outside the project folder; no approval flags are needed.
+  Grants require one selected project, never extend to siblings, and remain fixed until restart.
+  Generated pages default to .divlet/<filename stem>/; set project outputDir to change it.
+  Set { "projects": "folder" } in <path>/divlet.config.json to use another collection folder.
+  Port 0 chooses a free port. Install in Pi with: pi install npm:@divlet/pi (after npm publication) or pi install /absolute/path/to/divlet/pi (after building a checkout)`);
+        process.exit(0);
+    }
+    let target = process.cwd();
+    let port = 0;
+    let createDemo = true;
+    let watch = true;
+    const externalFiles = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if ((arg === '--cwd' || arg === '--dir') && args[i + 1])
+            target = path.resolve(args[++i]);
+        else if (arg === '--port' && args[i + 1])
+            port = Number(args[++i]);
+        else if (arg === '--asset-file' && args[i + 1] && !args[i + 1].startsWith('-'))
+            externalFiles.push(path.resolve(args[++i]));
+        else if (arg === '--no-demo')
+            createDemo = false;
+        else if (arg === '--no-watch')
+            watch = false;
+        else if (!arg.startsWith('-'))
+            target = path.resolve(arg);
+        else {
+            console.error(`Unknown or incomplete argument: ${arg}`);
+            process.exit(1);
+        }
+    }
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        console.error('Port must be an integer from 0 to 65535.');
+        process.exit(1);
+    }
+    try {
+        const runtimes = new Map();
+        const hubs = new Map();
+        const openBoard = async (location) => {
+            const key = path.resolve(location.file);
+            if (!runtimes.has(key)) {
+                const runtime = await openRuntime({ ...location, port: runtimes.size ? 0 : port, createDemo, watch });
+                runtime.host = host;
+                runtimes.set(key, runtime);
+            }
+            return runtimes.get(key);
+        };
+        const host = makeHost({ openBoard: (location) => openBoard(location), hubs });
+        const opened = await launch(target, { openBoard, hubs, ...(externalFiles.length ? { externalFiles } : {}) });
+        if (opened.kind === 'project') {
+            const info = opened.runtime.info();
+            const imported = opened.imported ? `Imported ${path.basename(opened.imported.from)} → ${path.basename(opened.imported.to)} (${opened.imported.frames} frames as HTML + Tailwind: ${opened.imported.utilities} utility and ${opened.imported.arbitrary} arbitrary-property classes; the source is kept as ${path.basename(opened.imported.from)})\n` : '';
+            console.log(`divlet ${info.url}\nProject: ${info.project.file} · ${info.documents.length} frame${info.documents.length === 1 ? '' : 's'}\n${imported}The Agent tab works when the board is opened from Pi (/divlet) or by an MCP client. Press Ctrl+C to stop.`);
+        }
+        else {
+            console.log(`divlet ${opened.hub.url}\n${opened.projects.length} project${opened.projects.length === 1 ? '' : 's'} in ${opened.collection} — pick one in the browser, or name a new one. Press Ctrl+C to stop.`);
+        }
+        let stopping = false;
+        const stop = async () => {
+            if (stopping)
+                return;
+            stopping = true;
+            for (const hub of hubs.values())
+                await hub.close();
+            for (const runtime of runtimes.values())
+                await runtime.close();
+        };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    }
+    catch (error) {
+        console.error(`divlet: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+if (import.meta.main)
+    await runCli();

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@divlet/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "The divlet command-line adapter",
+  "type": "module",
+  "main": "./dist/index.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/llblab/divlet.git",
+    "directory": "cli"
+  },
+  "homepage": "https://github.com/llblab/divlet#readme",
+  "bugs": {
+    "url": "https://github.com/llblab/divlet/issues"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "exports": {
+    ".": {
+      "divlet-source": "./index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "divlet": "./dist/index.js"
+  },
+  "dependencies": {
+    "@divlet/core": "0.0.1"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "prepack": "node ../scripts/build.mjs"
+  }
+}