onlyhuman 0.2.0 → 0.3.0

package/README.md

@@ -84,13 +84,28 @@ The full rules, including how the robot behaves, are in [SKILL.md](SKILL.md). Th
 
 ## Tools
 
-The parser, linter, go-to-definition and highlighter work on both `.human` and `.bot` files. Requires Node 22.18 or newer.
+The parser, linter, go-to-definition and highlighter work on both `.human` and `.bot` files. Development requires Node 22.18 or newer; the published CLI bundle targets Node 20 or newer.
 
 ```bash
 npm install
 npm test
 ```
 
+For the published CLI:
+
+```bash
+npm install --global onlyhuman
+onlyhuman lint spec/spec.human
+```
+
+Initialize a project skill:
+
+```bash
+onlyhuman skill init
+```
+
+This copies the project's `SKILL.md` into `.onlyhuman/SKILL.md`; add `--force` to overwrite an existing file.
+
 Lint a file. This prints `file:line:col severity rule message` and exits 1 on errors:
 
 ```bash
@@ -128,6 +143,9 @@ code --extensionDevelopmentPath=/path/to/onlyhuman/vscode /path/to/onlyhuman/spe
 | `src/definition.ts` | go-to-definition and `[path][line]` pointers |
 | `src/files.ts` | the only file-system access: sibling file and project root |
 | `src/cli.ts`, `src/lsp/server.ts` | command line and language server |
+| `src/skill.ts` | copies `SKILL.md` into `.onlyhuman/SKILL.md` |
+| `npm.sh` | build, verify and publish the CLI package |
+| `LICENSE` | MIT license |
 | `vscode/` | editor client and highlighting grammars |
 | `tests/` | unit tests |
 | `spec/` | the project's own `spec.human` and `spec.bot` |

package/dist/cli.js

@@ -338,16 +338,51 @@ function checkOperators(node, add) {
   });
 }
 
+// src/skill.ts
+import { copyFileSync, existsSync as existsSync2, mkdirSync } from "node:fs";
+import { dirname as dirname2, join as join2, resolve as resolve2 } from "node:path";
+function initSkill(directory = ".", options = {}) {
+  const root = resolve2(directory);
+  const source = join2(root, "SKILL.md");
+  const target = join2(root, ".onlyhuman", "SKILL.md");
+  if (!existsSync2(source)) {
+    throw new Error(`${source} does not exist; create the project SKILL.md first`);
+  }
+  if (existsSync2(target) && !options.force) {
+    throw new Error(`${target} already exists; use --force to overwrite`);
+  }
+  mkdirSync(dirname2(target), { recursive: true });
+  copyFileSync(source, target);
+  return target;
+}
+
 // src/cli.ts
 var USAGE = `usage:
   onlyhuman lint <file>             *.human or *.bot
   onlyhuman def <name> <file>        e.g. onlyhuman def @Token spec.human
-  onlyhuman def <file>:<line>:<col>  1-based line and col`;
+  onlyhuman def <file>:<line>:<col>  1-based line and col
+  onlyhuman skill init [directory] [--force]  write .onlyhuman/SKILL.md`;
 function load(file) {
   return parseText(readFileSync2(file, "utf8"));
 }
 function main(argv) {
   const [cmd, ...rest] = argv;
+  if (cmd === "skill" && rest[0] === "init") {
+    const args = rest.slice(1);
+    const paths = args.filter((a) => a !== "--force");
+    if (paths.length > 1) {
+      console.error(USAGE);
+      return 2;
+    }
+    try {
+      const target = initSkill(paths[0] ?? ".", { force: args.includes("--force") });
+      console.log(`created ${target}`);
+      return 0;
+    } catch (e) {
+      console.error(e.message);
+      return 1;
+    }
+  }
   if (cmd === "lint" && rest.length === 1) {
     const file = rest[0];
     const diags = lint(load(file), {

package/package.json

@@ -1,18 +1,33 @@
 {
   "name": "onlyhuman",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A descriptive language for writing specs in plain bullets, with a CLI linter and go-to-definition.",
   "license": "MIT",
   "type": "module",
-  "bin": { "onlyhuman": "./dist/cli.js" },
-  "files": ["dist", "README.md", "LICENSE"],
+  "bin": {
+    "onlyhuman": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/Benjit87/onlyhuman.git"
+    "url": "git+https://github.com/Benjit87/onlyhuman.git"
   },
   "homepage": "https://github.com/Benjit87/onlyhuman#readme",
-  "bugs": { "url": "https://github.com/Benjit87/onlyhuman/issues" },
-  "keywords": ["onlyhuman", "spec", "specification", "language", "linter", "cli"],
+  "bugs": {
+    "url": "https://github.com/Benjit87/onlyhuman/issues"
+  },
+  "keywords": [
+    "onlyhuman",
+    "spec",
+    "specification",
+    "language",
+    "linter",
+    "cli"
+  ],
   "author": "Benjit87",
   "scripts": {
     "test": "node --test \"tests/*.test.ts\"",
@@ -22,7 +37,9 @@
     "build:cli": "esbuild src/cli.ts --bundle --platform=node --format=esm --target=node20 --outfile=dist/cli.js",
     "prepublishOnly": "npm test && npm run typecheck && npm run build:cli"
   },
-  "engines": { "node": ">=20" },
+  "engines": {
+    "node": ">=20"
+  },
   "devEngines": {
     "runtime": {
       "name": "node",