kotonoha 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] - 2026-09-28
+
+### Added
+
+- Add the `kotonoha install` CLI for installing `tech-writer` into a
+  project or user skill directory.
+- Add `--target` for selecting a skill directory and `--force` for
+  explicitly replacing an existing installation.
+- Add automated tests for default installation, overwrite protection,
+  forced replacement, and installation from the packed npm artifact.
+
+### Changed
+
+- Document separate npm and source-checkout installation workflows in the
+  README.
+
+## [0.1.0] - 2026-09-28
+
+### Added
+
+- Publish the initial `tech-writer` skill for structuring README files,
+  design documents, API references, PR and issue text, release notes,
+  user manuals, code comments, and Qiita and Zenn articles.
+- Add structural linting for headings, code fences, placeholders, and
+  suspicious links.
+
+[0.1.1]: https://github.com/nahisaho/kotonoha/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/nahisaho/kotonoha/releases/tag/v0.1.0

package/README.md

@@ -39,7 +39,34 @@ Japanese prose with natural-japanese.
 - Python 3.9+ if you want to run the lint script (standard library only,
   no extra install needed)
 
-### Install
+### Install from npm
+
+Install the package, then copy `tech-writer` into a skill directory with
+the included CLI:
+
+```bash
+npm install --save-dev kotonoha
+npx kotonoha install
+```
+
+The default destination is `.github/skills/tech-writer` in the current
+project. To install into another supported skill directory, pass its parent
+directory:
+
+```bash
+npx kotonoha install --target .claude/skills
+npx kotonoha install --target ~/.copilot/skills
+```
+
+The command refuses to overwrite an existing `tech-writer` directory. Review
+or back up the existing installation, then pass `--force` only when you
+intend to replace it:
+
+```bash
+npx kotonoha install --force
+```
+
+### Install from a source checkout
 
 Inside this repository, the skill is already placed at
 `.github/skills/tech-writer`, so no extra setup is needed to use it with

package/bin/kotonoha.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const packageJson = require("../package.json");
+
+function printUsage() {
+  console.log(`Usage:
+  kotonoha install [--target <directory>] [--force]
+
+Options:
+  --target <directory>  Skill directory root (default: .github/skills)
+  --force               Replace an existing tech-writer installation
+  --help                 Show this help
+  --version              Show the installed kotonoha version`);
+}
+
+function fail(message) {
+  console.error(`kotonoha: ${message}`);
+  process.exitCode = 1;
+}
+
+function parseInstallOptions(args) {
+  let target = ".github/skills";
+  let force = false;
+
+  for (let index = 0; index < args.length; index += 1) {
+    const argument = args[index];
+
+    if (argument === "--force") {
+      force = true;
+      continue;
+    }
+
+    if (argument === "--target") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new Error("--target requires a directory");
+      }
+      target = value;
+      index += 1;
+      continue;
+    }
+
+    if (argument.startsWith("--target=")) {
+      const value = argument.slice("--target=".length);
+      if (!value) {
+        throw new Error("--target requires a directory");
+      }
+      target = value;
+      continue;
+    }
+
+    throw new Error(`unknown option: ${argument}`);
+  }
+
+  return { target, force };
+}
+
+function install(args) {
+  let options;
+  try {
+    options = parseInstallOptions(args);
+  } catch (error) {
+    fail(error.message);
+    return;
+  }
+
+  const source = path.resolve(__dirname, "..", "skills", "tech-writer");
+  const targetRoot = path.resolve(process.cwd(), options.target);
+  const destination = path.join(targetRoot, "tech-writer");
+
+  if (!fs.existsSync(source)) {
+    fail(`packaged skill not found at ${source}`);
+    return;
+  }
+
+  if (fs.existsSync(destination)) {
+    if (!options.force) {
+      fail(
+        `${destination} already exists; rerun with --force to replace it`,
+      );
+      return;
+    }
+    fs.rmSync(destination, { recursive: true, force: true });
+  }
+
+  fs.mkdirSync(targetRoot, { recursive: true });
+  fs.cpSync(source, destination, { recursive: true });
+  console.log(`Installed tech-writer to ${destination}`);
+}
+
+const [command, ...args] = process.argv.slice(2);
+
+if (command === "install") {
+  install(args);
+} else if (command === "--version" || command === "-v") {
+  console.log(packageJson.version);
+} else if (command === "--help" || command === "-h" || command === undefined) {
+  printUsage();
+} else {
+  fail(`unknown command: ${command}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kotonoha",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A GitHub Copilot CLI skill for structuring and polishing technical documents.",
   "license": "MIT",
   "author": "nahisaho",
@@ -12,6 +12,15 @@
     "url": "https://github.com/nahisaho/kotonoha/issues"
   },
   "homepage": "https://github.com/nahisaho/kotonoha#readme",
+  "bin": {
+    "kotonoha": "bin/kotonoha.js"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "keywords": [
     "copilot",
     "github-copilot",
@@ -21,6 +30,8 @@
     "markdown"
   ],
   "files": [
+    "CHANGELOG.md",
+    "bin/",
     "skills/"
   ]
 }