thomas-agentkit 0.5.2 → 0.6.0

package/README.md

@@ -14,7 +14,14 @@ Install templates into the current directory:
 npx thomas-agentkit init
 ```
 
-By default, `init` opens a short interactive setup flow in terminals. After choosing install options, you can optionally personalize repository-level template placeholders such as project name, description, issue tracker, docs paths, stack summary, and project commands.
+If the package is installed in a project, use the local `agentkit` binary:
+
+```bash
+npm install -D thomas-agentkit
+npx agentkit init
+```
+
+By default, `init` opens a short interactive setup flow in terminals. It asks where to install files, what project type or preset to use, which AI tools you use, which template set to install, how to handle existing files, and whether to personalize repository-level placeholders such as project name, description, issue tracker, docs paths, stack summary, and project commands.
 
 Install into another directory:
 
@@ -98,6 +105,8 @@ npx thomas-agentkit init --write-config
 
 `--write-config` writes `agentkit.config.json` in the target directory. Existing config files are skipped by default; use `--force` to overwrite one intentionally.
 
+Config values are validated when loaded. Unknown config keys, invalid preset/template/design-system names, invalid AI tool names, and non-string personalization values exit with an error.
+
 List bundled templates:
 
 ```bash
@@ -145,12 +154,25 @@ Generated content
 <!-- agentkit:end agents -->
 ```
 
-`agentkit update` only replaces content inside matching managed blocks. User edits before or after those blocks are preserved. Existing legacy files without managed blocks are reported as unmanaged and left untouched.
+`agentkit update` creates missing managed files. For existing files, it only replaces content inside matching managed blocks. User edits before or after those blocks are preserved. Existing legacy files without managed blocks are reported as unmanaged and left untouched. Files with malformed managed block markers are skipped.
 
-Interactive personalization only applies during `agentkit init` when files are created or overwritten. It does not write a config file, and `agentkit update` does not reapply personalized values.
+Interactive personalization only applies during `agentkit init` when files are created or overwritten. It does not write a config file unless `--write-config` is passed, and `agentkit update` does not reapply personalized values.
 
 `agentkit.config.json` can set `preset`, `templateSet`, `designSystem`, `aiTools`, and `personalization` defaults. `templateSet` may be `minimal`, `standard`, or `full`; `designSystem` selects which bundled design-system variant fills `DESIGN-SYSTEM.md` (`linear` or `apple`); `aiTools` may include `codex`, `cursor`, `claude`, and `copilot`. `agentkit update` uses config `preset` and `designSystem` and continues to update all managed bundled templates.
 
+Template set mappings:
+
+- `minimal`: `AGENTS.md`
+- `standard`: `AGENTS.md`, `CODE-QUALITY.md`, `DESIGN-SYSTEM.md`, `WORKFLOWS.md`
+- `full`: all bundled templates
+
+AI tool mappings:
+
+- `codex`: `AGENTS.md`
+- `cursor`: `.cursor/rules/agentkit.md`
+- `claude`: `CLAUDE.md`
+- `copilot`: `.github/copilot-instructions.md`
+
 ## Presets
 
 Presets add stack-specific guidance without scaffolding framework app files.

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { confirm, intro, isCancel, multiselect, select, text } from "@clack/prompts";
 import { Command } from "commander";
-import { constants as fsConstants } from "node:fs";
+import { constants as fsConstants, realpathSync } from "node:fs";
 import { access, mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -483,6 +483,18 @@ export function personalizeTemplateContent(file, content, values) {
     }
     return personalized;
 }
+export function shouldPromptForInit(options, streams) {
+    if (options.yes) {
+        return false;
+    }
+    if (options.interactive) {
+        return true;
+    }
+    if (options.dryRun) {
+        return false;
+    }
+    return Boolean(streams.stdin?.isTTY || streams.stdout?.isTTY);
+}
 async function promptForPersonalization(defaults) {
     const shouldPersonalize = await confirm({
         message: "Personalize template placeholders?",
@@ -760,7 +772,7 @@ function printUpdateResult(result, dryRun = false) {
 }
 async function resolveInteractiveTarget(target, options) {
     const providedPreset = resolvePreset(options.preset);
-    const shouldPrompt = !options.yes && (options.interactive || process.stdin.isTTY);
+    const shouldPrompt = shouldPromptForInit(options, process);
     if (!shouldPrompt) {
         return target;
     }
@@ -932,7 +944,18 @@ Examples:
     });
     await program.parseAsync(process.argv);
 }
-if (process.argv[1] && path.resolve(process.argv[1]) === __filename) {
+function resolveCliPath(filePath) {
+    try {
+        return realpathSync(filePath);
+    }
+    catch {
+        return path.resolve(filePath);
+    }
+}
+function isDirectCliInvocation(argvPath) {
+    return Boolean(argvPath && resolveCliPath(argvPath) === resolveCliPath(__filename));
+}
+if (isDirectCliInvocation(process.argv[1])) {
     main().catch((error) => {
         const message = error instanceof Error ? error.message : String(error);
         console.error(message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thomas-agentkit",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Install AI-agent-ready development templates into a project.",
   "license": "MIT",
   "repository": {