@nebularstreams/statify 3.0.8 → 3.0.9

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nebularstreams/statify",
-  "version": "3.0.8",
-  "description": "Generate Cool Landing and Documentation Pages",
+  "version": "3.0.9",
+  "description": "Agent-friendly Cool Landing Page and Documentation generator",
   "scripts": {
     "build:app": "node tool/cli.js app",
     "pack:check": "npm pack --dry-run"

package/readme.md

@@ -28,10 +28,38 @@ statify folder <source> [destination]
 statify file <file> [destination] <source>
 statify list <list-file> <source> [destination] [filter-id]
 statify app [simple|software|worlds]
+statify skill install [--force]
 ```
 
 Run `statify --help` for the same reference at the command line.
 
+### Install the Codex skill
+
+Install the packaged website-authoring skill directly from npm:
+
+```sh
+npx @nebularstreams/statify@3.0.9 skill install
+```
+
+Or install it from a project-local Statify dependency without downloading a
+different version:
+
+```sh
+npx --no-install statify skill install
+```
+
+The command copies the skill into
+`$CODEX_HOME/skills/statify-site`, or `~/.codex/skills/statify-site` when
+`CODEX_HOME` is not set. It refuses to replace an existing installation by
+default. To deliberately update it:
+
+```sh
+npx @nebularstreams/statify@3.0.9 skill install --force
+```
+
+Restart or refresh Codex after installation, then invoke the skill as
+`$statify-site`.
+
 ### Initialize a website
 
 ```sh

package/tool/cli.js

@@ -3,12 +3,13 @@
 "use strict";
 
 const fs = require("node:fs");
+const os = require("node:os");
 const path = require("node:path");
 const { spawnSync } = require("node:child_process");
 const publish = require("../src/publisher-lib");
 
 const PACKAGE_ROOT = path.resolve(__dirname, "..");
-const COMMANDS = new Set(["init", "app", "list", "folder", "file"]);
+const COMMANDS = new Set(["init", "app", "list", "folder", "file", "skill"]);
 
 function fail(message, code = 1) {
 	const error = new Error(message);
@@ -22,7 +23,8 @@ function usage() {
   statify folder <source> [destination]
   statify file <file> [destination] <source>
   statify list <list-file> <source> [destination] [filter-id]
-  statify app [simple|software|worlds]`;
+  statify app [simple|software|worlds]
+  statify skill install [--force]`;
 }
 
 function existingDirectory(value, label) {
@@ -162,6 +164,54 @@ function app(application = "simple") {
 	if (result.status !== 0) fail(`Application build failed with exit code ${result.status}`, result.status || 1);
 }
 
+function installSkill(options) {
+	const unknown = options.filter((option) => option !== "--force");
+	if (unknown.length) fail(`Unknown skill install option: ${unknown[0]}`);
+
+	const
+		force = options.includes("--force"),
+		source = path.join(PACKAGE_ROOT, "skill", "statify-site"),
+		codexHome = process.env.CODEX_HOME
+			? path.resolve(process.env.CODEX_HOME)
+			: path.join(os.homedir(), ".codex"),
+		skillsDirectory = path.join(codexHome, "skills"),
+		target = path.join(skillsDirectory, "statify-site");
+
+	if (!fs.existsSync(path.join(source, "SKILL.md"))) {
+		fail(`Packaged skill is missing: ${source}`);
+	}
+	if (fs.existsSync(target) && !force) {
+		fail(`Skill is already installed at ${target}\nRun again with --force to replace it.`);
+	}
+
+	fs.mkdirSync(skillsDirectory, { recursive: true });
+	const temporary = path.join(skillsDirectory, `.statify-site-install-${process.pid}-${Date.now()}`);
+	fs.cpSync(source, temporary, { recursive: true, errorOnExist: true });
+
+	if (!fs.existsSync(target)) {
+		fs.renameSync(temporary, target);
+	} else {
+		const backup = path.join(skillsDirectory, `.statify-site-backup-${process.pid}-${Date.now()}`);
+		fs.renameSync(target, backup);
+		try {
+			fs.renameSync(temporary, target);
+			fs.rmSync(backup, { recursive: true, force: true });
+		} catch (error) {
+			if (fs.existsSync(temporary)) fs.rmSync(temporary, { recursive: true, force: true });
+			if (!fs.existsSync(target)) fs.renameSync(backup, target);
+			throw error;
+		}
+	}
+
+	console.log(`Installed statify-site skill in ${target}`);
+	console.log("Restart or refresh Codex, then invoke it with $statify-site.");
+}
+
+function skill(action, ...options) {
+	if (action !== "install") fail("Usage: statify skill install [--force]");
+	installSkill(options);
+}
+
 function invocation(argv) {
 	if (COMMANDS.has(argv[0])) return [argv[0], argv.slice(1)];
 	fail(`Unknown command: ${argv[0]}\n\n${usage()}`);
@@ -174,7 +224,7 @@ async function main(argv) {
 	}
 
 	const [command, args] = invocation(argv);
-	await { init, folder, file, list, app }[command](...args);
+	await { init, folder, file, list, app, skill }[command](...args);
 }
 
 main(process.argv.slice(2)).catch((error) => {