@hitslop/cli 0.1.2 → 0.1.4

package/README.md

@@ -15,6 +15,10 @@ The supported v1 scaffold uses Svelte 5 and includes portable
 source-free runtime package; `slop register` adds an immutable local template;
 `slop publish` captures and signs one artifact for the catalog.
 
+Interactive init asks for a required author name and optional URL. For
+non-interactive use, pass `--yes --author-name "Your Name"` and optionally
+`--author-url https://example.com`.
+
 Documentation: [Authoring](https://github.com/hitslop/hitslop/blob/main/docs/authoring.md) ·
 [Package format](https://github.com/hitslop/hitslop/blob/main/docs/package-format.md)
 

package/dist/cli.js

@@ -21,7 +21,7 @@ import { manifestSchemaURL, parseManifest } from "@hitslop/schema";
 // package.json
 var package_default = {
   name: "@hitslop/cli",
-  version: "0.1.2",
+  version: "0.1.4",
   description: "Create, develop, build, register, and publish hitSlop apps.",
   license: "MIT",
   repository: { type: "git", url: "git+https://github.com/hitslop/hitslop.git", directory: "packages/cli" },
@@ -41,7 +41,7 @@ var package_default = {
   },
   dependencies: {
     "@crustjs/core": "^0.0.19",
-    "@hitslop/schema": "^0.1.2",
+    "@hitslop/schema": "^0.1.3",
     "@noble/ed25519": "^3.2.0",
     "fast-png": "^8.0.0",
     fflate: "^0.8.3",
@@ -338,7 +338,7 @@ async function validateSkin(root, manifest) {
   if (png.channels !== 4)
     throw new Error("The window skin must be an RGBA PNG image.");
 }
-async function scaffold(destination, options = {}) {
+async function scaffold(destination, options) {
   const template = options.template ?? "svelte-counter";
   if (!new Set(["svelte", "svelte-counter"]).has(template))
     throw new Error(`Unknown authoring template: ${template}`);
@@ -360,18 +360,20 @@ async function scaffold(destination, options = {}) {
       register: "slop register",
       publish: "slop publish"
     },
-    dependencies: { "@hitslop/runtime": `^${package_default.version}`, "@hitslop/svelte": `^${package_default.version}`, "bits-ui": "^2.19.0", svelte: "^5.0.0", zod: "^4.5.2" },
+    dependencies: { "@hitslop/runtime": "^0.1.2", "@hitslop/svelte": "^0.1.2", "bits-ui": "^2.19.0", svelte: "^5.0.0", zod: "^4.5.2" },
     devDependencies: { "@hitslop/cli": `^${package_default.version}`, "@sveltejs/vite-plugin-svelte": "^7.0.0", "@vanilla-extract/css": "^1.17.4", "@vanilla-extract/vite-plugin": "^5.1.1", vite: "^8.0.0" }
   }, null, 2) + `
 `);
-  await writeFile2(join3(destination, "manifest.json"), JSON.stringify({
+  const manifest = parseManifest({
     $schema: manifestSchemaURL,
     slug,
+    author: options.author,
     title,
     description: options.description || "A small, lovable hitSlop app.",
     categories: options.categories?.length ? options.categories : ["utilities"],
     presentation: { width: 560, height: 420 }
-  }, null, 2) + `
+  });
+  await writeFile2(join3(destination, "manifest.json"), JSON.stringify(manifest, null, 2) + `
 `);
   const appPath = join3(destination, "src/App.svelte");
   await writeFile2(appPath, (await readFile3(appPath, "utf8")).replace("__SLOP_TITLE_LITERAL__", JSON.stringify(title)));
@@ -606,7 +608,7 @@ import { getPublicKeyAsync, keygenAsync, signAsync } from "@noble/ed25519";
 import { createCipheriv, createDecipheriv, randomBytes, scryptSync } from "crypto";
 import { chmod, mkdir as mkdir3, readFile as readFile4, writeFile as writeFile3 } from "fs/promises";
 import { join as join5, resolve as resolve3 } from "path";
-import { homedir, userInfo } from "os";
+import { homedir } from "os";
 var service = "app.hitslop.cli";
 var account = "publisher";
 var fallback = join5(homedir(), ".hitslop", "identity.json");
@@ -637,14 +639,12 @@ async function storeIdentity(identity) {
   }
 }
 async function validated(identity) {
-  if (!identity.displayName.trim() || identity.displayName.length > 80)
-    throw new Error("Publisher name must contain 1\u201380 characters.");
   const derivedPublic = await getPublicKeyAsync(decode(identity.privateKey));
   if (encode(derivedPublic) !== identity.publicKey)
     throw new Error("Identity public and private keys do not match.");
   if (sha256(derivedPublic).slice(0, 32) !== identity.keyId)
     throw new Error("Identity key ID does not match its public key.");
-  return { ...identity, displayName: identity.displayName.trim() };
+  return { privateKey: identity.privateKey, publicKey: identity.publicKey, keyId: identity.keyId };
 }
 async function getIdentity() {
   const stored = await readStored();
@@ -652,16 +652,10 @@ async function getIdentity() {
     return validated(stored);
   const pair = await keygenAsync();
   const publicKey = pair.publicKey ?? await getPublicKeyAsync(pair.secretKey);
-  const identity = await validated({ privateKey: encode(pair.secretKey), publicKey: encode(publicKey), keyId: sha256(publicKey).slice(0, 32), displayName: userInfo().username });
+  const identity = await validated({ privateKey: encode(pair.secretKey), publicKey: encode(publicKey), keyId: sha256(publicKey).slice(0, 32) });
   await storeIdentity(identity);
   return identity;
 }
-async function setIdentityName(displayName) {
-  const identity = await getIdentity();
-  const next = await validated({ ...identity, displayName });
-  await storeIdentity(next);
-  return next;
-}
 async function exportIdentity(path, passphrase) {
   if (passphrase.length < 10)
     throw new Error("Identity export passphrases must contain at least 10 characters.");
@@ -1135,11 +1129,10 @@ async function publishSlop(root, flags) {
   const packed = await packSlop(built.directory);
   const identity = await getIdentity();
   const envelope = {
-    format: "hitslop-publish/2",
+    format: "hitslop-publish/3",
     requestId: crypto.randomUUID(),
     publisherKeyId: identity.keyId,
     publicKey: identity.publicKey,
-    displayName: identity.displayName,
     artifactSha256: packed.sha256,
     artifactBytes: packed.bytes.byteLength,
     timestamp: Date.now()
@@ -1179,9 +1172,14 @@ async function screenshotDocument(path, options, native = runNative) {
 var titleFor = (directory) => directory.split("/").filter(Boolean).at(-1)?.split(/[-_ ]+/).map((part) => part[0]?.toUpperCase() + part.slice(1)).join(" ") || "My Slop";
 var parseCategories = (values) => values.map((value) => SlopCategorySchema.parse(value.trim().toLowerCase()));
 async function initMetadata(directory, flags) {
+  const authorName = flags["author-name"]?.trim();
+  const authorURL = flags["author-url"]?.trim();
   const defaults = { title: flags.title || titleFor(directory), description: flags.description || "A small, lovable hitSlop app.", categories: parseCategories(flags.category?.length ? flags.category : ["utilities"]) };
-  if (flags.yes || !process.stdin.isTTY)
-    return defaults;
+  if (flags.yes || !process.stdin.isTTY) {
+    if (!authorName)
+      throw new Error("--author-name is required with --yes or in a non-interactive terminal.");
+    return { ...defaults, author: { name: authorName, ...authorURL ? { url: authorURL } : {} } };
+  }
   const prompt = createInterface({ input: process.stdin, output: process.stdout });
   try {
     const title = (await prompt.question(`Title (${defaults.title}): `)).trim() || defaults.title;
@@ -1190,7 +1188,11 @@ async function initMetadata(directory, flags) {
     const categories = rawCategories ? parseCategories(rawCategories.split(",").filter(Boolean)) : defaults.categories;
     if (categories.length < 1 || categories.length > 2)
       throw new Error("Choose one or two categories.");
-    return { title, description, categories };
+    const name = authorName || (await prompt.question("Author name: ")).trim();
+    if (!name)
+      throw new Error("Author name is required.");
+    const url = authorURL || (await prompt.question("Author URL (optional): ")).trim();
+    return { title, description, categories, author: { name, ...url ? { url } : {} } };
   } finally {
     prompt.close();
   }
@@ -1210,6 +1212,8 @@ app = app.command("init", (command) => command.meta({ description: "Create a Sve
   template: { type: "string", description: "Svelte authoring template (svelte or svelte-counter)." },
   title: { type: "string", description: "Manifest title." },
   description: { type: "string", description: "Manifest description." },
+  "author-name": { type: "string", description: "Required manifest author name." },
+  "author-url": { type: "string", description: "Optional manifest author URL." },
   category: { type: "string", multiple: true, description: "Manifest category; pass once or twice." },
   yes: { type: "boolean", description: "Accept manifest defaults without prompting." }
 }).run(async ({ args, flags }) => {
@@ -1235,7 +1239,7 @@ app = app.command("register", (command) => command.meta({ description: "Build an
   const result = await installTemplate(args.path, { force: flags.force ?? false, ...flags.preview ? { preview: flags.preview } : {}, ...flags.icon ? { icon: flags.icon } : {}, confirmOverwrite: confirmReplacement });
   console.log(`${result.replaced ? "Updated" : "Installed"} ${result.manifest.title} at ${result.directory}`);
 }));
-app = app.command("publish", (command) => command.args([{ name: "path", type: "path", default: "." }]).flags({ registry: { type: "string", description: "Catalog publish endpoint. Defaults to https://api.hitslop.com/api/publish. Set HITSLOP_REGISTRY_URL=http://localhost:3000/api/publish for a local catalog." }, preview: { type: "path" }, icon: { type: "path", description: "Use this 512x512 PNG as the catalog and Finder icon." } }).run(async ({ args, flags }) => {
+app = app.command("publish", (command) => command.args([{ name: "path", type: "path", default: "." }]).flags({ registry: { type: "string", description: "Catalog publish endpoint. Defaults to https://api.hitslop.com/api/publish. Set HITSLOP_REGISTRY_URL=http://127.0.0.1:5002/api/publish for the local Firebase emulators." }, preview: { type: "path" }, icon: { type: "path", description: "Use this 512x512 PNG as the catalog and Finder icon." } }).run(async ({ args, flags }) => {
   console.log(await publishSlop(args.path, { ...flags.registry ? { registry: flags.registry } : {}, ...flags.preview ? { preview: flags.preview } : {}, ...flags.icon ? { icon: flags.icon } : {} }));
 }));
 app = app.command("export", (command) => command.meta({ description: "Export a built .slop document as a full-height PNG or PDF." }).args([{ name: "path", type: "path", default: "." }]).flags({
@@ -1303,15 +1307,7 @@ async function runIdentity(arguments_) {
   const action = arguments_[1] ?? "show";
   if (action === "show") {
     const identity = await getIdentity();
-    console.log(`${identity.keyId}	${identity.displayName}`);
-    return true;
-  }
-  if (action === "set-name") {
-    const name = arguments_.slice(2).join(" ").trim();
-    if (!name)
-      throw new Error("Usage: slop identity set-name <name>");
-    const identity = await setIdentityName(name);
-    console.log(`${identity.keyId}	${identity.displayName}`);
+    console.log(identity.keyId);
     return true;
   }
   if (action === "export") {
@@ -1331,7 +1327,7 @@ async function runIdentity(arguments_) {
     if (!path)
       throw new Error("Usage: slop identity import <file> [--force]");
     const identity = await importIdentity(path, await secret("Import passphrase: "), arguments_.includes("--force"));
-    console.log(`${identity.keyId}	${identity.displayName}`);
+    console.log(identity.keyId);
     return true;
   }
   throw new Error(`Unknown identity command: ${action}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hitslop/cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Create, develop, build, register, and publish hitSlop apps.",
   "license": "MIT",
   "repository": { "type": "git", "url": "git+https://github.com/hitslop/hitslop.git", "directory": "packages/cli" },
@@ -20,7 +20,7 @@
   },
   "dependencies": {
     "@crustjs/core": "^0.0.19",
-    "@hitslop/schema": "^0.1.2",
+    "@hitslop/schema": "^0.1.3",
     "@noble/ed25519": "^3.2.0",
     "fast-png": "^8.0.0",
     "fflate": "^0.8.3",

package/templates/svelte/AGENTS.md

@@ -1,6 +1,7 @@
 # hitSlop authoring
 
-Read `manifest.json` first. Use the local `hitslop-authoring` skill for package,
+Read `manifest.json` first. Keep its required author name and optional HTTP(S)
+author URL accurate. Use the local `hitslop-authoring` skill for package,
 storage, capture, install, and publish work. Use `hitslop-design` when creating
 or revising the interface. Treat the host window as the outer object boundary
 and size it for realistic default content. Use Bits UI (`bits-ui`) for interactive