thomas-agentkit 0.4.0 → 0.4.2

package/README.md

@@ -66,6 +66,37 @@ Install stack-specific agent guidance:
 npx thomas-agentkit init --preset next
 ```
 
+Standardize install defaults with `agentkit.config.json`:
+
+```json
+{
+  "preset": "next",
+  "templateSet": "standard",
+  "aiTools": ["codex", "cursor", "claude"],
+  "personalization": {
+    "projectName": "Acme CRM",
+    "projectDescription": "a customer operations dashboard",
+    "issueTracker": "Linear",
+    "designSystemPath": "docs/design-system.md",
+    "briefsPath": "docs/briefs",
+    "testCommand": "pnpm test",
+    "lintCommand": "pnpm lint",
+    "buildCommand": "pnpm build",
+    "stackSummary": "Next.js, TypeScript, PostgreSQL"
+  }
+}
+```
+
+AgentKit reads `agentkit.config.json` from the target directory first. When installing into another target that does not have a config file, it falls back to the current working directory. Config values are defaults: explicit CLI flags override them.
+
+Create a config file from resolved install choices:
+
+```bash
+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.
+
 List bundled templates:
 
 ```bash
@@ -109,6 +140,8 @@ Generated content
 
 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.
 
+`agentkit.config.json` can set `preset`, `templateSet`, `aiTools`, and `personalization` defaults. `templateSet` may be `minimal`, `standard`, or `full`; `aiTools` may include `codex`, `cursor`, `claude`, and `copilot`. `agentkit update` only uses config `preset` and continues to update all managed bundled templates.
+
 ## Presets
 
 Presets add stack-specific guidance without scaffolding framework app files.
@@ -122,7 +155,7 @@ Presets add stack-specific guidance without scaffolding framework app files.
 ## CLI Reference
 
 ```text
-agentkit init [target] [--force] [--dry-run] [--interactive] [--yes] [--preset <name>]
+agentkit init [target] [--force] [--dry-run] [--interactive] [--yes] [--write-config] [--preset <name>]
 agentkit update [target] [--dry-run] [--preset <name>]
 agentkit --list
 agentkit --list-presets
@@ -136,6 +169,7 @@ Options:
 - `--dry-run`: print planned changes without writing files
 - `-i, --interactive`: explicitly prompt for install options
 - `-y, --yes`: accept defaults without prompts
+- `--write-config`: write resolved install defaults to `agentkit.config.json`
 - `--preset <name>`: install stack-specific guidance (`next`, `sveltekit`, `express`, `convex`, `fullstack`)
 - `--list`: list bundled template files
 - `--list-presets`: list available presets

package/dist/cli.js

@@ -13,6 +13,20 @@ const packageJsonPath = path.join(packageRoot, "package.json");
 const validPresets = ["next", "sveltekit", "express", "convex", "fullstack"];
 const validProjectTypes = ["generic", ...validPresets];
 const validAiTools = ["codex", "cursor", "claude", "copilot"];
+const validTemplateSets = ["minimal", "standard", "full"];
+const configFileName = "agentkit.config.json";
+const configKeys = ["preset", "templateSet", "aiTools", "personalization"];
+const personalizationKeys = [
+    "projectName",
+    "projectDescription",
+    "issueTracker",
+    "designSystemPath",
+    "briefsPath",
+    "testCommand",
+    "lintCommand",
+    "buildCommand",
+    "stackSummary",
+];
 const presetLabels = {
     next: "Next.js",
     sveltekit: "SvelteKit",
@@ -120,9 +134,15 @@ function isProjectTypeName(value) {
 function isAiToolName(value) {
     return validAiTools.includes(value);
 }
+function isTemplateSetName(value) {
+    return validTemplateSets.includes(value);
+}
 function formatPresetList() {
     return validPresets.join(", ");
 }
+function formatTemplateSetList() {
+    return validTemplateSets.join(", ");
+}
 function resolvePreset(preset) {
     if (!preset) {
         return undefined;
@@ -133,6 +153,115 @@ function resolvePreset(preset) {
     }
     return normalizedPreset;
 }
+function resolveTemplateSet(templateSet) {
+    if (!templateSet) {
+        return undefined;
+    }
+    const normalizedTemplateSet = templateSet.toLowerCase();
+    if (!isTemplateSetName(normalizedTemplateSet)) {
+        throw new Error(`Unknown template set "${templateSet}". Valid template sets: ${formatTemplateSetList()}.`);
+    }
+    return normalizedTemplateSet;
+}
+function assertPlainObject(value, name) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${name} must be an object.`);
+    }
+}
+function assertKnownKeys(value, validKeys, name) {
+    for (const key of Object.keys(value)) {
+        if (!validKeys.includes(key)) {
+            throw new Error(`Unknown ${name} key "${key}". Valid keys: ${validKeys.join(", ")}.`);
+        }
+    }
+}
+function parseConfig(rawConfig, configPath) {
+    assertPlainObject(rawConfig, configFileName);
+    assertKnownKeys(rawConfig, configKeys, configFileName);
+    const config = {};
+    if (rawConfig.preset !== undefined) {
+        if (typeof rawConfig.preset !== "string") {
+            throw new Error(`${configFileName} preset must be a string.`);
+        }
+        config.preset = resolvePreset(rawConfig.preset);
+    }
+    if (rawConfig.templateSet !== undefined) {
+        if (typeof rawConfig.templateSet !== "string") {
+            throw new Error(`${configFileName} templateSet must be a string.`);
+        }
+        config.templateSet = resolveTemplateSet(rawConfig.templateSet);
+    }
+    if (rawConfig.aiTools !== undefined) {
+        if (!Array.isArray(rawConfig.aiTools)) {
+            throw new Error(`${configFileName} aiTools must be an array.`);
+        }
+        config.aiTools = rawConfig.aiTools.map((aiTool) => {
+            if (typeof aiTool !== "string" || !isAiToolName(aiTool)) {
+                throw new Error(`Unknown AI tool "${String(aiTool)}". Valid AI tools: ${validAiTools.join(", ")}.`);
+            }
+            return aiTool;
+        });
+    }
+    if (rawConfig.personalization !== undefined) {
+        assertPlainObject(rawConfig.personalization, `${configFileName} personalization`);
+        assertKnownKeys(rawConfig.personalization, personalizationKeys, `${configFileName} personalization`);
+        config.personalization = {};
+        for (const [key, value] of Object.entries(rawConfig.personalization)) {
+            if (typeof value !== "string") {
+                throw new Error(`${configFileName} personalization.${key} must be a string.`);
+            }
+            config.personalization[key] = value;
+        }
+    }
+    if (config.preset === undefined && rawConfig.preset !== undefined) {
+        throw new Error(`Invalid preset in ${configPath}.`);
+    }
+    return config;
+}
+async function readConfig(configPath) {
+    let rawContent;
+    try {
+        rawContent = await readFile(configPath, "utf8");
+    }
+    catch {
+        throw new Error(`Unable to read ${configPath}.`);
+    }
+    try {
+        return parseConfig(JSON.parse(rawContent), configPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid ${configPath}: ${message}`);
+    }
+}
+async function loadConfigForTarget(targetArg) {
+    const cwd = process.cwd();
+    const targetDir = path.resolve(cwd, targetArg || ".");
+    const targetConfigPath = path.join(targetDir, configFileName);
+    if (await exists(targetConfigPath)) {
+        return readConfig(targetConfigPath);
+    }
+    const cwdConfigPath = path.join(cwd, configFileName);
+    if (targetDir !== cwd && (await exists(cwdConfigPath))) {
+        return readConfig(cwdConfigPath);
+    }
+    return undefined;
+}
+async function applyInitConfig(options, config) {
+    if (!config) {
+        return;
+    }
+    options.preset ??= config.preset;
+    options.personalization ??= config.personalization;
+    options.templateSet ??= config.templateSet;
+    options.aiTools ??= config.aiTools;
+}
+function applyUpdateConfig(options, config) {
+    if (!config) {
+        return;
+    }
+    options.preset ??= config.preset;
+}
 export function resolveProjectPreset(projectType) {
     if (!projectType) {
         return undefined;
@@ -195,6 +324,32 @@ function cleanPersonalizationValue(value) {
     const trimmed = value?.trim();
     return trimmed ? trimmed : undefined;
 }
+function getResolvedConfig(options) {
+    const config = {
+        templateSet: options.templateSet ?? "full",
+        aiTools: options.aiTools ?? [],
+    };
+    const preset = resolvePreset(options.preset);
+    if (preset) {
+        config.preset = preset;
+    }
+    if (options.personalization) {
+        const personalization = {};
+        for (const key of personalizationKeys) {
+            const value = cleanPersonalizationValue(options.personalization[key]);
+            if (value) {
+                personalization[key] = value;
+            }
+        }
+        if (Object.keys(personalization).length > 0) {
+            config.personalization = personalization;
+        }
+    }
+    return config;
+}
+function serializeConfig(config) {
+    return `${JSON.stringify(config, null, 2)}\n`;
+}
 function replaceIfProvided(content, placeholder, value) {
     const replacement = cleanPersonalizationValue(value);
     return replacement ? content.replaceAll(placeholder, replacement) : content;
@@ -282,10 +437,10 @@ export function personalizeTemplateContent(file, content, values) {
     }
     return personalized;
 }
-async function promptForPersonalization() {
+async function promptForPersonalization(defaults) {
     const shouldPersonalize = await confirm({
         message: "Personalize template placeholders?",
-        initialValue: false,
+        initialValue: Boolean(defaults),
     });
     if (isCancel(shouldPersonalize)) {
         process.exit(130);
@@ -296,6 +451,7 @@ async function promptForPersonalization() {
     const projectName = await text({
         message: "Project name",
         placeholder: "[Project Name]",
+        defaultValue: defaults?.projectName,
     });
     if (isCancel(projectName)) {
         process.exit(130);
@@ -303,6 +459,7 @@ async function promptForPersonalization() {
     const projectDescription = await text({
         message: "Short project description",
         placeholder: "[short project description]",
+        defaultValue: defaults?.projectDescription,
     });
     if (isCancel(projectDescription)) {
         process.exit(130);
@@ -310,6 +467,7 @@ async function promptForPersonalization() {
     const issueTracker = await text({
         message: "Issue tracker name",
         placeholder: "Linear or GitHub Issues",
+        defaultValue: defaults?.issueTracker,
     });
     if (isCancel(issueTracker)) {
         process.exit(130);
@@ -317,6 +475,7 @@ async function promptForPersonalization() {
     const designSystemPath = await text({
         message: "Design system path",
         placeholder: "docs/design-system.md",
+        defaultValue: defaults?.designSystemPath,
     });
     if (isCancel(designSystemPath)) {
         process.exit(130);
@@ -324,6 +483,7 @@ async function promptForPersonalization() {
     const briefsPath = await text({
         message: "Briefs path",
         placeholder: "docs/briefs",
+        defaultValue: defaults?.briefsPath,
     });
     if (isCancel(briefsPath)) {
         process.exit(130);
@@ -331,6 +491,7 @@ async function promptForPersonalization() {
     const testCommand = await text({
         message: "Test command",
         placeholder: "npm test",
+        defaultValue: defaults?.testCommand,
     });
     if (isCancel(testCommand)) {
         process.exit(130);
@@ -338,6 +499,7 @@ async function promptForPersonalization() {
     const lintCommand = await text({
         message: "Lint command",
         placeholder: "npm run lint",
+        defaultValue: defaults?.lintCommand,
     });
     if (isCancel(lintCommand)) {
         process.exit(130);
@@ -345,6 +507,7 @@ async function promptForPersonalization() {
     const buildCommand = await text({
         message: "Build/check command",
         placeholder: "npm run build",
+        defaultValue: defaults?.buildCommand,
     });
     if (isCancel(buildCommand)) {
         process.exit(130);
@@ -352,6 +515,7 @@ async function promptForPersonalization() {
     const stackSummary = await text({
         message: "Stack summary",
         placeholder: "Next.js, TypeScript, Tailwind CSS, Vitest",
+        defaultValue: defaults?.stackSummary,
     });
     if (isCancel(stackSummary)) {
         process.exit(130);
@@ -374,13 +538,30 @@ async function buildInitTemplateContent(file, preset, personalization) {
 }
 async function installTemplates(targetArg, options) {
     const targetDir = path.resolve(process.cwd(), targetArg || ".");
-    const files = options.files ?? (await getTemplateFiles());
+    const allTemplateFiles = await getTemplateFiles();
+    const files = options.files ??
+        (options.templateSet || options.aiTools
+            ? getSelectedTemplateFiles(options.templateSet ?? "full", options.aiTools ?? [], allTemplateFiles)
+            : allTemplateFiles);
     const preset = resolvePreset(options.preset);
     const created = [];
     const skipped = [];
     if (!options.dryRun) {
         await mkdir(targetDir, { recursive: true });
     }
+    if (options.writeConfig) {
+        const destination = path.join(targetDir, configFileName);
+        const destinationExists = await exists(destination);
+        if (destinationExists && !options.force) {
+            skipped.push(configFileName);
+        }
+        else {
+            created.push(configFileName);
+            if (!options.dryRun) {
+                await writeFile(destination, serializeConfig(getResolvedConfig(options)));
+            }
+        }
+    }
     for (const file of files) {
         const destination = path.join(targetDir, file);
         const destinationExists = await exists(destination);
@@ -569,7 +750,7 @@ async function resolveInteractiveTarget(target, options) {
     }
     const aiToolResponse = await multiselect({
         message: "Which AI tools do you use?",
-        initialValues: ["codex", "cursor", "claude"],
+        initialValues: options.aiTools ?? ["codex", "cursor", "claude"],
         options: [
             { label: "Codex", value: "codex" },
             { label: "Cursor", value: "cursor" },
@@ -582,7 +763,7 @@ async function resolveInteractiveTarget(target, options) {
     }
     const templateSetResponse = await select({
         message: "Which template set do you want?",
-        initialValue: "standard",
+        initialValue: options.templateSet ?? "standard",
         options: [
             { label: "Minimal", value: "minimal" },
             { label: "Standard", value: "standard" },
@@ -593,6 +774,8 @@ async function resolveInteractiveTarget(target, options) {
         process.exit(130);
     }
     const templateFiles = await getTemplateFiles();
+    options.templateSet = templateSetResponse;
+    options.aiTools = aiToolResponse;
     options.files = getSelectedTemplateFiles(templateSetResponse, aiToolResponse, templateFiles);
     if (!options.force) {
         const preset = resolvePreset(options.preset);
@@ -619,7 +802,7 @@ async function resolveInteractiveTarget(target, options) {
             options.force = conflictResponse === "overwrite";
         }
     }
-    options.personalization = await promptForPersonalization();
+    options.personalization = await promptForPersonalization(options.personalization);
     return resolvedTarget || ".";
 }
 async function main() {
@@ -660,8 +843,10 @@ Examples:
         .option("--dry-run", "print planned changes without writing files")
         .option("-i, --interactive", "prompt for install options")
         .option("-y, --yes", "accept defaults for non-interactive runs")
+        .option("--write-config", "write resolved install defaults to agentkit.config.json")
         .option("--preset <name>", `install stack-specific guidance (${formatPresetList()})`)
         .action(async (target, options) => {
+        await applyInitConfig(options, await loadConfigForTarget(target));
         const resolvedTarget = await resolveInteractiveTarget(target, options);
         const result = await installTemplates(resolvedTarget, options);
         printInstallResult(result, Boolean(options.dryRun));
@@ -673,6 +858,7 @@ Examples:
         .option("--dry-run", "print planned changes without writing files")
         .option("--preset <name>", `update stack-specific guidance (${formatPresetList()})`)
         .action(async (target, options) => {
+        applyUpdateConfig(options, await loadConfigForTarget(target));
         const result = await updateTemplates(target, options);
         printUpdateResult(result, Boolean(options.dryRun));
     });

package/package.json

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