ninekit-cli 1.1.0-dev.3 → 1.1.0-dev.5

package/README.md

@@ -9,6 +9,7 @@ Command-line tool and web dashboard for managing NineKit projects.
 NineKit Config UI (`nk`) provides both CLI and web dashboard for managing NineKit projects. It is built with Bun, TypeScript, and React for development, while the published CLI runs on plain Node.js so end users do not need Bun installed.
 
 **Key Features:**
+
 - **CLI Commands (16)**: new, init, config, projects, setup, skills, agents, commands, migrate, doctor, versions, update, uninstall, watch, content, easter-egg
 - **Web Dashboard**: Interactive React UI via `nk config ui` for configuration and project management
 - **Hook Diagnostics Dashboard**: Inspect recent Claude hook activity and failures from `nk config` across global and project scopes
@@ -36,11 +37,21 @@ Comprehensive documentation in `/docs`:
 - **[nk watch](./docs/nk-watch.md)** - GitHub issue monitoring daemon
 - **[nk content](./docs/nk-content.md)** - Automated content generation from git activity
 
+## Prerequisites
+
+Before using NineKit CLI, you need to:
+
+1. **Purchase a NineKit Starter Kit** from [NineKit.cc](https://ninekit.cc)
+2. **Get Repository Access**: After purchase, you'll receive access to the private GitHub repository containing your kit
+3. **Create a GitHub Personal Access Token** (PAT) with `repo` scope to download releases
+
+Without a purchased kit and repository access, the CLI will not be able to download any project templates.
+
 ## Installation
 
 The NineKit CLI is published on npm at [npmjs.com/package/ninekit-cli](https://www.npmjs.com/package/ninekit-cli).
 
-End-user runtime note: global installs from `npm`, `pnpm`, `yarn`, or `bun` all execute the packaged Node.js CLI. Bun is optional for users and only needed for local NineKit CLI development workflows.
+End-user runtime note: global installs from `npm`, `pnpm`, `yarn`, or `bun` all execute the packaged Node.js CLI. Bun is optional for users and only needed for local NineKit CLI development workflows. Most commands do not require native build tools; `nk content` uses an optional SQLite driver and shows remediation steps if that driver is unavailable.
 
 ### Using npm (Recommended)
 
@@ -145,6 +156,7 @@ nk new --kit-path ~/downloads/ninekit-engineer-main/
 ```
 
 **Flags:**
+
 - `--install-skills`: Auto-install Python packages, system tools (FFmpeg, ImageMagick), Node.js packages
 - `--prefix`: Move commands to /nk: namespace (/plan → /nk:plan)
 - `--beta`: Show pre-release versions in selection
@@ -191,6 +203,7 @@ nk init --kit-path ~/downloads/ninekit-engineer-main/
 ```
 
 **Flags:**
+
 - `--yes/-y`: Non-interactive mode with sensible defaults (skip all prompts)
 - `--global/-g`: Use platform-specific config (macOS/Linux: ~/.claude, Windows: %USERPROFILE%\.claude)
 - `--fresh`: Clean reinstall, removes .claude directory (requires "yes" confirmation)
@@ -233,6 +246,7 @@ nk update --yes
 The CLI notifies you when updates are available via `nk --version`.
 
 **Skills Migration:**
+
 - Auto-detects structure changes (flat → categorized)
 - Preserves customizations (SHA-256 hashing)
 - Creates backup before migration
@@ -282,6 +296,7 @@ nk doctor --verbose --fix
 ```
 
 **Health Checks:**
+
 - **System**: Node.js, npm, Python, pip, Claude CLI, git, gh CLI
 - **NineKit**: Global/project installation, versions, skills, skill listing budget, duplicate skill inventory
 - **Auth**: GitHub CLI authentication, repository access
@@ -289,6 +304,7 @@ nk doctor --verbose --fix
 - **Modules**: Dynamic skill dependency resolution
 
 **Auto-Fix Capabilities:**
+
 | Issue | Fix Action |
 |-------|------------|
 | Missing dependencies | Install via package manager |
@@ -301,6 +317,7 @@ nk doctor --verbose --fix
 `nk doctor` never writes `skillOverrides`, hides skills, or deletes duplicate skills automatically. It reports existing `skillOverrides` and inventory issues so all active project/global skills can stay user-invocable while listing pressure is managed through 200k-context-floor project settings and bounded descriptions.
 
 **Exit Codes:**
+
 - `0`: All checks pass or issues fixed
 - `1`: Failures detected (only with `--check-only`)
 
@@ -321,6 +338,7 @@ nk uninstall --yes        # Non-interactive - skip confirmation (for scripts)
 ```
 
 **Scope Selection:**
+
 - When both local and global installations exist, you'll be prompted to choose:
   - **Local only**: Remove from current project (`.claude/`)
   - **Global only**: Remove from user directory (`~/.claude/`)
@@ -332,6 +350,7 @@ nk uninstall --yes        # Non-interactive - skip confirmation (for scripts)
 - Use `--kit engineer` or `--kit marketing` to skip the kit prompt
 
 **What it does:**
+
 - Detects local `.claude` directory in current project
 - Detects global `~/.claude` NineKit installation
 - Shows paths before deletion
@@ -397,6 +416,8 @@ nk content start --verbose
 
 **Features:** 11-phase pipeline (scan → filter → classify → context → create → validate → review → photo → publish → engage → analyze), noise filtering, context caching (24h TTL), content validation, photo generation, 3 review modes (auto/manual/hybrid), quiet hours scheduling, engagement tracking, SQLite database, platform-specific adapters.
 
+**Runtime dependency:** `nk content` uses the optional native SQLite driver `better-sqlite3`. If the driver is unavailable, other CLI commands still work and `nk content` prints reinstall/build-tool guidance.
+
 **Config:** `.nk.json` under `content` key. See [docs/nk-content.md](./docs/nk-content.md) for full configuration reference.
 
 ### Other Commands
@@ -445,6 +466,7 @@ export NK_CACHE_TTL=1800         # 30 minutes
 The `nk --version` command checks for newer versions of your installed NineKit and displays a notification if an update is available. The check is cached for 7 days to minimize API calls.
 
 **Disable Update Notifications:**
+
 ```bash
 # Set environment variable to disable
 NO_UPDATE_NOTIFIER=1 nk --version
@@ -483,6 +505,7 @@ The CLI requires GitHub authentication to download releases from private reposit
 ### Quick Setup
 
 **Step 1: Install GitHub CLI**
+
 ```bash
 # Windows
 winget install GitHub.cli
@@ -495,11 +518,13 @@ sudo apt install gh
 ```
 
 **Step 2: Authenticate with GitHub CLI**
+
 ```bash
 gh auth login
 ```
 
 When prompted, follow these steps:
+
 1. Select **GitHub.com**
 2. Select **HTTPS** (or SSH if preferred)
 3. Authenticate Git? → **Yes**
@@ -530,6 +555,7 @@ nk init --verbose
 ```
 
 **Common Issues:**
+
 - **"Access denied"**: Run `nk doctor` to check auth, use `--fix` to auto-repair
 - **"Authentication failed"**: Run `nk doctor --fix` to re-authenticate, or manually run `gh auth login` (select 'Login with a web browser')
 - **"GitHub CLI not authenticated"**: Run `gh auth login` and select 'Login with a web browser' (NOT 'Paste token')
@@ -538,7 +564,7 @@ nk init --verbose
 
 ## Available Kits
 
-NineKit offers premium starter kits available for purchase at [NineKit.cc](https://ninekit.chiendt.io.vn):
+NineKit offers premium starter kits available for purchase at [NineKit.cc](https://ninekit.cc):
 
 - **engineer**: NineKit Engineer - Engineering toolkit for building with Claude (v1.0.0+)
 - **marketing**: NineKit Marketing - Content automation toolkit (v1.0.0 available)
@@ -603,6 +629,7 @@ Automatic migration when structure changes (flat → categorized):
 - **Interactive**: Prompts for confirmation (can skip in CI/CD)
 
 **Example Migration:**
+
 ```
 Before (flat):
   .claude/skills/
@@ -625,18 +652,21 @@ Customizations in any skill are detected and preserved automatically.
 ## Development
 
 See [Development Guide](./docs/codebase-summary.md) for:
+
 - Project structure (modular domain-driven architecture)
 - Build & compilation (`bun run build`, `bun run compile`)
 - Testing & type checking
 - Code standards & linting
 
 **Architecture Highlights:**
+
 - **Modular design**: 122 focused modules (target: <100 lines each)
 - **Facade pattern**: Each domain exposes public API via facade
 - **Phase handlers**: Complex commands use orchestrator + phase handlers
 - **Self-documenting names**: kebab-case file names describe purpose
 
 **Quick Start:**
+
 ```bash
 bun install
 bun run dev new --kit engineer

package/bin/postinstall-hook-restore.cjs

@@ -59,7 +59,7 @@ function collectHookCommands(settings) {
 	return commands;
 }
 
-function extractCkHookName(command) {
+function extractNkHookName(command) {
 	if (!String(command || "").trim().startsWith("node ")) return null;
 	const normalized = String(command).replace(/\\/g, "/");
 	const match = normalized.match(/\/hooks\/([^/"'\s]+)\.(?:cjs|mjs|js)(?:["'\s]|$)/);
@@ -81,7 +81,7 @@ function hasLegacySparseCkHooks(settings, config) {
 
 	const hookNames = new Set();
 	for (const command of collectHookCommands(settings)) {
-		const hookName = extractCkHookName(command);
+		const hookName = extractNkHookName(command);
 		if (hookName) hookNames.add(hookName);
 	}
 
@@ -101,7 +101,7 @@ function hasLegacySparseCkHooks(settings, config) {
 	);
 }
 
-function countMissingCkHookRegistrations(claudeDir) {
+function countMissingNkHookRegistrations(claudeDir) {
 	const settings = readJsonFile(path.join(claudeDir, "settings.json"));
 	const config = readJsonFile(path.join(claudeDir, ".nk.json"));
 	if (!settings || !config) return 0;
@@ -115,7 +115,7 @@ function countMissingCkHookRegistrations(claudeDir) {
 
 	let missing = 0;
 	for (const command of installedHookCommands(config)) {
-		const hookName = extractCkHookName(command);
+		const hookName = extractNkHookName(command);
 		if (hookName && disabledHooks.has(hookName)) continue;
 		if (!existingCommands.has(normalizeCommand(command))) missing++;
 	}
@@ -162,7 +162,7 @@ function restoreMissingHookRegistrations(settingsFiles) {
 
 	let restored = 0;
 	for (const claudeDir of collectCandidateClaudeDirs(settingsFiles)) {
-		const missing = countMissingCkHookRegistrations(claudeDir);
+		const missing = countMissingNkHookRegistrations(claudeDir);
 		if (missing <= 0) continue;
 
 		const installedKit = getInstalledKit(claudeDir);
@@ -187,6 +187,6 @@ function restoreMissingHookRegistrations(settingsFiles) {
 }
 
 module.exports = {
-	countMissingCkHookRegistrations,
+	countMissingNkHookRegistrations,
 	restoreMissingHookRegistrations,
 };

package/bin/postinstall-self-heal.cjs

@@ -5,7 +5,7 @@ const fs = require("node:fs");
 const os = require("node:os");
 const path = require("node:path");
 const {
-	countMissingCkHookRegistrations,
+	countMissingNkHookRegistrations,
 	restoreMissingHookRegistrations,
 } = require("./postinstall-hook-restore.cjs");
 
@@ -147,7 +147,7 @@ main();
 
 module.exports = {
 	collectCandidateSettingsFiles,
-	countMissingCkHookRegistrations,
+	countMissingNkHookRegistrations,
 	isLegacyDescriptiveNamePrompt,
 	pruneHooks,
 	pruneSettingsFile,

package/cli-manifest.json

@@ -1,6 +1,6 @@
 {
-	"version": "1.1.0-dev.3",
-	"generatedAt": "2026-06-16T04:34:28.297Z",
+	"version": "1.1.0-dev.5",
+	"generatedAt": "2026-06-19T08:38:55.367Z",
 	"commands": {
 		"agents": {
 			"name": "agents",
@@ -1214,7 +1214,7 @@
 		},
 		"migrate": {
 			"name": "migrate",
-			"description": "Migrate Claude Code agents, commands, skills, config, rules, and hooks to other providers",
+			"description": "Migrate Claude Code agents, commands, skills, config, rules, and hooks to other providers (e.g. Codex). Set updatePipeline.autoMigrateAfterUpdate to keep targets in sync with Claude Code on each `nk update`.",
 			"usage": "nk migrate [options]",
 			"examples": [
 				{
@@ -1342,7 +1342,7 @@
 			"sections": [
 				{
 					"title": "Gotchas",
-					"content": "  --install and --reconcile are mutually exclusive — pass only one\n  --reinstall-empty-dirs and --respect-deletions are mutually exclusive — pass only one\n  Default mode is smart-detected: no/stale registry → install, valid registry → reconcile\n  --respect-deletions disables the auto-reinstall heuristic for empty directories\n  --force overrides skip decisions per item; --reinstall-empty-dirs is a per-directory heuristic\n  Codex commands migrate as skills: project scope writes .agents/skills, global scope writes ~/.agents/skills"
+					"content": "  --install and --reconcile are mutually exclusive — pass only one\n  --reinstall-empty-dirs and --respect-deletions are mutually exclusive — pass only one\n  Default mode is smart-detected: no/stale registry → install, valid registry → reconcile\n  --respect-deletions disables the auto-reinstall heuristic for empty directories\n  --force overrides skip decisions per item; --reinstall-empty-dirs is a per-directory heuristic\n  Codex commands migrate as skills: project scope writes .agents/skills, global scope writes ~/.agents/skills\n  Antigravity 2.0 agents migrate to .agents/agents.md; skills remain .agents/skills/<name>/SKILL.md\n  Kiro agents migrate as custom subagents; rules/config migrate as steering files; skills copy to .kiro/skills; commands/hooks are skipped"
 				}
 			]
 		},
@@ -1867,7 +1867,7 @@
 						},
 						{
 							"flags": "-a, --agent <agent>",
-							"description": "Target agent(s) - can be specified multiple times. Valid: claude-code, cursor, codex, opencode, goose, gemini-cli, antigravity, github-copilot, amp, kilo, roo, windsurf, cline, openhands"
+							"description": "Target agent(s) - can be specified multiple times. Valid: claude-code, cursor, codex, opencode, goose, gemini-cli, antigravity, github-copilot, amp, kilo, kiro, roo, windsurf, cline, openhands"
 						},
 						{
 							"flags": "-g, --global",
@@ -1925,7 +1925,7 @@
 			"sections": [
 				{
 					"title": "Supported Agents",
-					"content": "  claude-code     Claude Code CLI\n  cursor          Cursor IDE\n  codex           Codex CLI\n  opencode        OpenCode\n  goose           Goose AI\n  gemini-cli      Gemini CLI\n  antigravity     Antigravity Agent\n  github-copilot  GitHub Copilot\n  amp             Amp\n  kilo            Kilo Code\n  roo             Roo Code\n  windsurf        Windsurf IDE\n  cline           Cline\n  openhands       OpenHands"
+					"content": "  claude-code     Claude Code CLI\n  cursor          Cursor IDE\n  codex           Codex CLI\n  opencode        OpenCode\n  goose           Goose AI\n  gemini-cli      Gemini CLI\n  antigravity     Antigravity Agent\n  github-copilot  GitHub Copilot\n  amp             Amp\n  kilo            Kilo Code\n  kiro            Kiro\n  roo             Roo Code\n  windsurf        Windsurf IDE\n  cline           Cline\n  openhands       OpenHands"
 				},
 				{
 					"title": "Notes",