hollware 0.0.0 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Sergio Azócar and Hollware 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/README.md

@@ -1,3 +1,25 @@
 # hollware
 
-This name is reserved for [Hollware](https://github.com/hollware/hollware), a headless CMS for the agent era. The first release is coming soon.
+The command line of [Hollware](https://github.com/hollware/hollware), an open-source headless
+CMS for the agent era, native to Cloudflare Workers.
+
+> **Status: pre-alpha, not usable yet.** The binary answers `--help` and `--version`; every
+> command prints "not implemented yet" and exits with code 1.
+
+## What it will be
+
+The `hollware` command, with these planned commands:
+
+| Command   | Purpose                               |
+| --------- | ------------------------------------- |
+| `init`    | Set up Hollware in a project          |
+| `migrate` | Apply D1 migrations                   |
+| `token`   | Create, list and revoke access tokens |
+| `import`  | Import Markdown files over MCP        |
+| `export`  | Export entries as Markdown files      |
+
+## Links
+
+- Repository: <https://github.com/hollware/hollware>
+- Issues: <https://github.com/hollware/hollware/issues>
+- License: MIT

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+//#region src/index.d.ts
+/**
+ * Runs the CLI and returns its exit code. Each call to `io.out` or `io.err` is one
+ * message; whoever owns the streams adds the trailing newline. Only the first
+ * argument is looked at.
+ */
+export declare function main(argv: string[], io: {
+  out: (s: string) => void;
+  err: (s: string) => void;
+}): number;
+//#endregion

package/dist/index.mjs

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import { readFileSync, realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+//#region src/index.ts
+const COMMANDS = [
+	{
+		name: "init",
+		summary: "Set up Hollware in a project"
+	},
+	{
+		name: "migrate",
+		summary: "Apply D1 migrations"
+	},
+	{
+		name: "token",
+		summary: "Create, list and revoke access tokens"
+	},
+	{
+		name: "import",
+		summary: "Import Markdown files over MCP"
+	},
+	{
+		name: "export",
+		summary: "Export entries as Markdown files"
+	}
+];
+const NAME_WIDTH = Math.max(...COMMANDS.map((command) => command.name.length));
+const USAGE = [
+	"Usage: hollware <command>",
+	"",
+	"Pre-alpha: no command is implemented yet.",
+	"",
+	"Commands:",
+	...COMMANDS.map(({ name, summary }) => `  ${name.padEnd(NAME_WIDTH)}  ${summary} (not implemented yet)`),
+	"",
+	"Options:",
+	"  --help     Show this help",
+	"  --version  Print the version"
+].join("\n");
+function readVersion() {
+	const manifest = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+	if (typeof manifest.version !== "string") throw new Error("package.json has no version");
+	return manifest.version;
+}
+/**
+* Runs the CLI and returns its exit code. Each call to `io.out` or `io.err` is one
+* message; whoever owns the streams adds the trailing newline. Only the first
+* argument is looked at.
+*/
+function main(argv, io) {
+	const [first] = argv;
+	if (first === void 0 || first === "--help") {
+		io.out(USAGE);
+		return 0;
+	}
+	if (first === "--version") {
+		io.out(`hollware ${readVersion()}`);
+		return 0;
+	}
+	if (COMMANDS.some((command) => command.name === first)) {
+		io.err(`hollware ${first}: not implemented yet`);
+		return 1;
+	}
+	io.err(`hollware: unknown command or flag "${first}"\n\n${USAGE}`);
+	return 1;
+}
+function isEntryPoint() {
+	const entry = process.argv[1];
+	if (entry === void 0) return false;
+	try {
+		return pathToFileURL(realpathSync(entry)).href === import.meta.url;
+	} catch {
+		return false;
+	}
+}
+if (isEntryPoint()) process.exitCode = main(process.argv.slice(2), {
+	out: (s) => process.stdout.write(`${s}\n`),
+	err: (s) => process.stderr.write(`${s}\n`)
+});
+//#endregion
+export { main };

package/package.json

@@ -1,15 +1,47 @@
 {
   "name": "hollware",
-  "version": "0.0.0",
-  "description": "Reserved for Hollware, a headless CMS for the agent era. First release coming soon.",
-  "license": "MIT",
+  "version": "0.0.2",
+  "description": "The Hollware CLI: init, migrate, token, import and export.",
   "homepage": "https://hollware.com",
+  "bugs": {
+    "url": "https://github.com/hollware/hollware/issues"
+  },
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/hollware/hollware.git",
     "directory": "packages/cli"
   },
+  "bin": {
+    "hollware": "./dist/index.mjs"
+  },
   "files": [
-    "README.md"
-  ]
-}
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@types/node": "24.19.2",
+    "publint": "0.3.25",
+    "typescript": "7.0.2",
+    "vite-plus": "1.1.0"
+  },
+  "engines": {
+    "node": ">=24.11.0"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "test": "vp test",
+    "publint": "publint --strict"
+  }
+}