@zweer/dev 1.3.0 → 2.1.0

package/configs/_biome.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.8/schema.json",
+  "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true },
+  "files": { "ignoreUnknown": false },
+  "formatter": { "enabled": true, "useEditorconfig": true, "lineWidth": 100 },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": { "noUnknownAtRules": "off" }
+    },
+    "domains": { "test": "recommended" }
+  },
+  "javascript": { "formatter": { "quoteStyle": "single" } },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": {
+          "level": "on",
+          "options": {
+            "groups": [
+              ":URL:",
+              ":BLANK_LINE:",
+              [":BUN:", ":NODE:"],
+              ":BLANK_LINE:",
+              [":PACKAGE_WITH_PROTOCOL:", ":PACKAGE:"],
+              ":BLANK_LINE:",
+              ":ALIAS:",
+              ":BLANK_LINE:",
+              ":PATH:"
+            ]
+          }
+        }
+      }
+    }
+  }
+}

package/configs/commitlint.config.ts

@@ -0,0 +1 @@
+export default { extends: ['@commitlint/config-conventional'] };

package/configs/editorconfig

@@ -0,0 +1,16 @@
+# http://editorconfig.org/
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

package/configs/lefthook.yml

@@ -0,0 +1,38 @@
+pre-commit:
+  piped: true
+  commands:
+    biome:
+      glob: "*.{ts,json,yaml,md,css,html}"
+      run: npx biome check --write --no-errors-on-unmatched --files-ignore-unknown=true {staged_files}
+      stage_fixed: true
+      priority: 1
+    lockfile:
+      glob: "package-lock.json"
+      run: npx lockfile-lint
+      priority: 1
+    package-lint:
+      glob: "package.json"
+      run: npx npmPkgJsonLint .
+      priority: 1
+    package-sort:
+      glob: "package.json"
+      run: npx sort-package-json "package.json"
+      stage_fixed: true
+      priority: 1
+    build:
+      glob: "*.ts"
+      run: npm run build
+      priority: 2
+    typecheck:
+      glob: "*.ts"
+      run: tsc --noEmit
+      priority: 3
+    test:
+      glob: "*.ts"
+      run: npx vitest run --reporter=dot
+      priority: 3
+
+commit-msg:
+  commands:
+    commitlint:
+      run: npx --no -- commitlint --edit {1}

package/configs/lockfile-lintrc.json

@@ -0,0 +1,6 @@
+{
+  "path": "package-lock.json",
+  "type": "npm",
+  "validate-https": true,
+  "allowed-hosts": ["npm"]
+}

package/configs/npmpackagejsonlintrc.json

@@ -0,0 +1,34 @@
+{
+  "rules": {
+    "require-author": "error",
+    "require-description": "error",
+    "require-engines": "error",
+    "require-license": "error",
+    "require-name": "error",
+    "require-repository": "error",
+    "require-version": "error",
+    "require-bugs": "error",
+    "require-homepage": "error",
+    "require-keywords": "error",
+    "bin-type": "error",
+    "config-type": "error",
+    "description-type": "error",
+    "devDependencies-type": "error",
+    "directories-type": "error",
+    "engines-type": "error",
+    "files-type": "error",
+    "homepage-type": "error",
+    "keywords-type": "error",
+    "license-type": "error",
+    "main-type": "error",
+    "man-type": "error",
+    "name-type": "error",
+    "preferGlobal-type": "error",
+    "private-type": "error",
+    "repository-type": "error",
+    "scripts-type": "error",
+    "version-type": "error",
+    "name-format": "error",
+    "version-format": "error"
+  }
+}

package/configs/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "@tsconfig/node22/tsconfig.json",
+  "compilerOptions": {
+    "declaration": true,
+    "noEmit": true,
+    "isolatedDeclarations": true,
+    "allowImportingTsExtensions": true
+  }
+}

package/configs/tsdown.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'tsdown';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  dts: true,
+  sourcemap: true,
+  format: 'esm',
+});

package/configs/vitest.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'json-summary'],
+      include: ['src/**/*.ts'],
+      exclude: ['**/index.ts', '**/types.ts'],
+    },
+  },
+});

package/dist/index.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/index.mjs

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command } from "@commander-js/extra-typings";
+import { exec } from "node:child_process";
+import { access, copyFile, cp, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { promisify } from "node:util";
+import { homedir } from "node:os";
+//#region cli/utils/paths.ts
+const __dirname$1 = dirname(fileURLToPath(import.meta.url));
+const paths = {
+	root: join(__dirname$1, "../.."),
+	configs: join(__dirname$1, "../../configs"),
+	kiro: join(__dirname$1, "../../kiro"),
+	workflows: join(__dirname$1, "../../workflows")
+};
+//#endregion
+//#region cli/utils/configs.ts
+async function fileExists(path) {
+	try {
+		await access(path);
+		return true;
+	} catch {
+		return false;
+	}
+}
+const CONFIG_FILES = [
+	{
+		src: "_biome.json",
+		dest: "biome.json"
+	},
+	{
+		src: "editorconfig",
+		dest: ".editorconfig"
+	},
+	{
+		src: "commitlint.config.ts",
+		dest: "commitlint.config.ts"
+	},
+	{
+		src: "lefthook.yml",
+		dest: "lefthook.yml"
+	},
+	{
+		src: "lockfile-lintrc.json",
+		dest: ".lockfile-lintrc.json"
+	},
+	{
+		src: "npmpackagejsonlintrc.json",
+		dest: ".npmpackagejsonlintrc.json"
+	},
+	{
+		src: "tsconfig.json",
+		dest: "tsconfig.json"
+	},
+	{
+		src: "tsdown.config.ts",
+		dest: "tsdown.config.ts"
+	},
+	{
+		src: "vitest.config.ts",
+		dest: "vitest.config.ts"
+	}
+];
+async function copyConfig(file, targetDir) {
+	const dest = join(targetDir, file.dest);
+	if (await fileExists(dest)) return false;
+	await copyFile(join(paths.configs, file.src), dest);
+	return true;
+}
+async function copyWorkflows(tier, targetDir) {
+	const srcDir = join(paths.workflows, tier);
+	const destDir = join(targetDir, ".github/workflows");
+	await mkdir(destDir, { recursive: true });
+	for (const file of await readdir(srcDir)) {
+		const destFile = file === "dependabot.yml" ? join(targetDir, ".github", file) : join(destDir, file);
+		if (!await fileExists(destFile)) await copyFile(join(srcDir, file), destFile);
+	}
+}
+//#endregion
+//#region cli/utils/templates.ts
+async function copyTemplate(templateDir, targetDir, vars) {
+	const entries = await readdir(templateDir, { withFileTypes: true });
+	for (const entry of entries) {
+		const src = join(templateDir, entry.name);
+		const dest = join(targetDir, entry.name);
+		if (entry.isDirectory()) {
+			await mkdir(dest, { recursive: true });
+			await copyTemplate(src, dest, vars);
+		} else {
+			let content = await readFile(src, "utf-8");
+			for (const [key, value] of Object.entries(vars)) content = content.replaceAll(`{{${key}}}`, value);
+			await writeFile(dest, content);
+		}
+	}
+}
+//#endregion
+//#region cli/commands/bootstrap.ts
+const execAsync = promisify(exec);
+const DEV_DEPENDENCIES$1 = {
+	"@biomejs/biome": "^2.4.8",
+	bonvoy: "^0.13.1",
+	"@commitlint/cli": "^20.5.0",
+	"@commitlint/config-conventional": "^20.5.0",
+	"@tsconfig/node22": "^22.0.5",
+	"@types/node": "^25.5.0",
+	"@vitest/coverage-v8": "^4.1.0",
+	concurrently: "^9.2.1",
+	lefthook: "^2.1.4",
+	"lockfile-lint": "^5.0.0",
+	"ls-engines": "^0.10.0",
+	"npm-package-json-lint": "^9.1.0",
+	rimraf: "^6.1.3",
+	"sort-package-json": "^3.6.1",
+	tsdown: "^0.21.4",
+	typescript: "^5.9.3",
+	vitest: "^4.1.0"
+};
+const bootstrap = new Command().name("bootstrap").description("Bootstrap a new project with standard configuration").argument("[name]", "Package name", "@zweer/new-package").option("-t, --type <type>", "Project type: monorepo or single", "single").action(async (name, options) => {
+	const scope = name.includes("/") ? name.split("/")[0] : "";
+	const repoName = name.includes("/") ? name.split("/")[1] : name;
+	const templateDir = join(paths.root, "templates", options.type);
+	const vars = {
+		name,
+		scope,
+		description: "",
+		author: "Zweer <n.olivieriachille@gmail.com>",
+		homepage: `https://github.com/Zweer/${repoName}#readme`,
+		bugs: `https://github.com/Zweer/${repoName}/issues`,
+		repository: `git+https://github.com/Zweer/${repoName}.git`
+	};
+	const cwd = process.cwd();
+	await copyTemplate(templateDir, cwd, vars);
+	const pkgPath = join(cwd, "package.json");
+	const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
+	pkg.devDependencies = DEV_DEPENDENCIES$1;
+	pkg.homepage = vars.homepage;
+	pkg.bugs = { url: vars.bugs };
+	pkg.repository = {
+		type: "git",
+		url: vars.repository
+	};
+	await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+	for (const file of CONFIG_FILES) await copyConfig(file, cwd);
+	await copyWorkflows("base", cwd);
+	await writeFile(join(cwd, ".gitignore"), "dist/\nnode_modules/\ncoverage/\n*.lcov\n*.tsbuildinfo\n*.log\n.env\n.env.*\n!.env.example\n");
+	console.log("Installing dependencies...");
+	await execAsync("npm install");
+	console.log("Initializing git...");
+	await execAsync("git init && git add . && git commit -m \"chore: initial commit\"");
+	console.log(`\n✓ Project bootstrapped! (${options.type})`);
+	console.log("\nNext: run `dev init-kiro` to set up AI-assisted development.");
+});
+//#endregion
+//#region cli/commands/init-kiro.ts
+const initKiro = new Command().name("init-kiro").description("Install the zweer-setup agent globally for Kiro-powered project configuration").action(async () => {
+	const kiroDir = join(homedir(), ".kiro");
+	await mkdir(join(kiroDir, "agents"), { recursive: true });
+	await cp(join(paths.kiro, "agents/zweer-setup.json"), join(kiroDir, "agents/zweer-setup.json"));
+	await mkdir(join(kiroDir, "prompts"), { recursive: true });
+	await cp(join(paths.kiro, "prompts/zweer-setup.md"), join(kiroDir, "prompts/zweer-setup.md"));
+	const skillsDest = join(kiroDir, "skills/zweer-dev");
+	await cp(join(paths.kiro, "skills"), skillsDest, { recursive: true });
+	console.log("✓ zweer-setup agent installed globally");
+	console.log(`\n  Agent:  ${join(kiroDir, "agents/zweer-setup.json")}`);
+	console.log(`  Prompt: ${join(kiroDir, "prompts/zweer-setup.md")}`);
+	console.log(`  Skills: ${skillsDest}/`);
+	console.log("\nTo configure this project:");
+	console.log("  1. Run: kiro-cli chat");
+	console.log("  2. Use: /agent swap zweer-setup");
+});
+//#endregion
+//#region cli/commands/setup.ts
+const DEV_DEPENDENCIES = {
+	"@biomejs/biome": "^2.4.8",
+	bonvoy: "^0.13.1",
+	"@commitlint/cli": "^20.5.0",
+	"@commitlint/config-conventional": "^20.5.0",
+	"@tsconfig/node22": "^22.0.5",
+	"@types/node": "^25.5.0",
+	"@vitest/coverage-v8": "^4.1.0",
+	concurrently: "^9.2.1",
+	lefthook: "^2.1.4",
+	"lockfile-lint": "^5.0.0",
+	"ls-engines": "^0.10.0",
+	"npm-package-json-lint": "^9.1.0",
+	rimraf: "^6.1.3",
+	"sort-package-json": "^3.6.1",
+	tsdown: "^0.21.4",
+	typescript: "^5.9.3",
+	vitest: "^4.1.0"
+};
+const SCRIPTS = {
+	build: "tsdown",
+	clean: "rimraf dist",
+	lint: "concurrently npm:lint:* --prefixColors auto",
+	"lint:engines": "ls-engines",
+	"lint:format": "biome check --write",
+	"lint:lockfile": "lockfile-lint",
+	"lint:package": "npmPkgJsonLint .",
+	"lint:sort_package": "sort-package-json \"package.json\"",
+	"lint:typecheck": "tsc --noEmit",
+	prepare: "lefthook install",
+	test: "vitest run",
+	"test:coverage": "vitest run --coverage"
+};
+const setup = new Command().name("setup").description("Add standard configuration to an existing project").option("-y, --yes", "Skip prompts and add all configurations").action(async () => {
+	const cwd = process.cwd();
+	if (!await fileExists("package.json")) {
+		console.error("package.json not found. Run this in a project directory.");
+		process.exit(1);
+	}
+	for (const file of CONFIG_FILES) {
+		const copied = await copyConfig(file, cwd);
+		console.log(copied ? `  ✓ ${file.dest}` : `  · ${file.dest} (exists)`);
+	}
+	const pkg = JSON.parse(await readFile("package.json", "utf-8"));
+	pkg.devDependencies = {
+		...pkg.devDependencies,
+		...DEV_DEPENDENCIES
+	};
+	pkg.scripts = {
+		...pkg.scripts,
+		...SCRIPTS
+	};
+	if (!pkg.engines) pkg.engines = { node: ">= 22" };
+	await writeFile("package.json", `${JSON.stringify(pkg, null, 2)}\n`);
+	console.log("  ✓ package.json (deps + scripts merged)");
+	await copyWorkflows("base", cwd);
+	console.log("  ✓ .github/workflows/ (base)");
+	console.log("\n✓ Setup complete!");
+	console.log("\nNext: run `dev init-kiro` to set up AI-assisted development.");
+});
+//#endregion
+//#region cli/index.ts
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(resolve(__dirname, "..", "package.json"), "utf-8"));
+const program = new Command().name(pkg.name).description(pkg.description).version(pkg.version);
+program.addCommand(bootstrap);
+program.addCommand(setup);
+program.addCommand(initKiro);
+program.parse();
+//#endregion
+export {};
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["__dirname","DEV_DEPENDENCIES"],"sources":["../cli/utils/paths.ts","../cli/utils/configs.ts","../cli/utils/templates.ts","../cli/commands/bootstrap.ts","../cli/commands/init-kiro.ts","../cli/commands/setup.ts","../cli/index.ts"],"sourcesContent":["import { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst __filename: string = fileURLToPath(import.meta.url);\nconst __dirname: string = dirname(__filename);\n\nexport const paths: { root: string; configs: string; kiro: string; workflows: string } = {\n  root: join(__dirname, '../..'),\n  configs: join(__dirname, '../../configs'),\n  kiro: join(__dirname, '../../kiro'),\n  workflows: join(__dirname, '../../workflows'),\n};\n","import { access, copyFile, mkdir, readdir, readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { paths } from './paths.js';\n\nexport async function fileExists(path: string): Promise<boolean> {\n  try {\n    await access(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport interface ConfigFile {\n  src: string;\n  dest: string;\n}\n\nexport const CONFIG_FILES: ConfigFile[] = [\n  { src: '_biome.json', dest: 'biome.json' },\n  { src: 'editorconfig', dest: '.editorconfig' },\n  { src: 'commitlint.config.ts', dest: 'commitlint.config.ts' },\n  { src: 'lefthook.yml', dest: 'lefthook.yml' },\n  { src: 'lockfile-lintrc.json', dest: '.lockfile-lintrc.json' },\n  { src: 'npmpackagejsonlintrc.json', dest: '.npmpackagejsonlintrc.json' },\n  { src: 'tsconfig.json', dest: 'tsconfig.json' },\n  { src: 'tsdown.config.ts', dest: 'tsdown.config.ts' },\n  { src: 'vitest.config.ts', dest: 'vitest.config.ts' },\n];\n\nexport async function copyConfig(file: ConfigFile, targetDir: string): Promise<boolean> {\n  const dest = join(targetDir, file.dest);\n  if (await fileExists(dest)) return false;\n  await copyFile(join(paths.configs, file.src), dest);\n  return true;\n}\n\nexport async function copyWorkflows(\n  tier: 'base' | 'library' | 'docs',\n  targetDir: string,\n): Promise<void> {\n  const srcDir = join(paths.workflows, tier);\n  const destDir = join(targetDir, '.github/workflows');\n  await mkdir(destDir, { recursive: true });\n\n  for (const file of await readdir(srcDir)) {\n    // dependabot.yml goes to .github/, not .github/workflows/\n    const destFile =\n      file === 'dependabot.yml' ? join(targetDir, '.github', file) : join(destDir, file);\n    if (!(await fileExists(destFile))) {\n      await copyFile(join(srcDir, file), destFile);\n    }\n  }\n}\n\nexport async function mergePackageJson(\n  targetDir: string,\n  overrides: { scripts?: Record<string, string>; devDependencies?: Record<string, string> },\n): Promise<void> {\n  const pkgPath = join(targetDir, 'package.json');\n  const pkg = JSON.parse(await readFile(pkgPath, 'utf-8'));\n\n  if (overrides.scripts) {\n    pkg.scripts = { ...pkg.scripts, ...overrides.scripts };\n  }\n  if (overrides.devDependencies) {\n    pkg.devDependencies = { ...pkg.devDependencies, ...overrides.devDependencies };\n  }\n\n  await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}\\n`);\n}\n","import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nexport async function copyTemplate(\n  templateDir: string,\n  targetDir: string,\n  vars: Record<string, string>,\n): Promise<void> {\n  const entries = await readdir(templateDir, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const src = join(templateDir, entry.name);\n    const dest = join(targetDir, entry.name);\n\n    if (entry.isDirectory()) {\n      await mkdir(dest, { recursive: true });\n      await copyTemplate(src, dest, vars);\n    } else {\n      let content = await readFile(src, 'utf-8');\n      for (const [key, value] of Object.entries(vars)) {\n        content = content.replaceAll(`{{${key}}}`, value);\n      }\n      await writeFile(dest, content);\n    }\n  }\n}\n","import { exec } from 'node:child_process';\nimport { readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { promisify } from 'node:util';\n\nimport { Command } from '@commander-js/extra-typings';\n\nimport { CONFIG_FILES, copyConfig, copyWorkflows } from '../utils/configs.js';\nimport { paths } from '../utils/paths.js';\nimport { copyTemplate } from '../utils/templates.js';\n\nconst execAsync = promisify(exec);\n\nconst DEV_DEPENDENCIES: Record<string, string> = {\n  '@biomejs/biome': '^2.4.8',\n  bonvoy: '^0.13.1',\n  '@commitlint/cli': '^20.5.0',\n  '@commitlint/config-conventional': '^20.5.0',\n  '@tsconfig/node22': '^22.0.5',\n  '@types/node': '^25.5.0',\n  '@vitest/coverage-v8': '^4.1.0',\n  concurrently: '^9.2.1',\n  lefthook: '^2.1.4',\n  'lockfile-lint': '^5.0.0',\n  'ls-engines': '^0.10.0',\n  'npm-package-json-lint': '^9.1.0',\n  rimraf: '^6.1.3',\n  'sort-package-json': '^3.6.1',\n  tsdown: '^0.21.4',\n  typescript: '^5.9.3',\n  vitest: '^4.1.0',\n};\n\nexport const bootstrap = new Command()\n  .name('bootstrap')\n  .description('Bootstrap a new project with standard configuration')\n  .argument('[name]', 'Package name', '@zweer/new-package')\n  .option('-t, --type <type>', 'Project type: monorepo or single', 'single')\n  .action(async (name, options) => {\n    const scope = name.includes('/') ? name.split('/')[0] : '';\n    const repoName = name.includes('/') ? name.split('/')[1] : name;\n    const templateDir = join(paths.root, 'templates', options.type);\n\n    const vars: Record<string, string> = {\n      name,\n      scope,\n      description: '',\n      author: 'Zweer <n.olivieriachille@gmail.com>',\n      homepage: `https://github.com/Zweer/${repoName}#readme`,\n      bugs: `https://github.com/Zweer/${repoName}/issues`,\n      repository: `git+https://github.com/Zweer/${repoName}.git`,\n    };\n\n    // Copy template with variable substitution\n    const cwd = process.cwd();\n    await copyTemplate(templateDir, cwd, vars);\n\n    // Inject devDependencies into the generated package.json\n    const pkgPath = join(cwd, 'package.json');\n    const pkg = JSON.parse(await readFile(pkgPath, 'utf-8'));\n    pkg.devDependencies = DEV_DEPENDENCIES;\n    pkg.homepage = vars.homepage;\n    pkg.bugs = { url: vars.bugs };\n    pkg.repository = { type: 'git', url: vars.repository };\n    await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}\\n`);\n\n    // Copy golden configs (biome, editorconfig, lefthook, etc.)\n    for (const file of CONFIG_FILES) {\n      await copyConfig(file, cwd);\n    }\n\n    // Copy base workflows\n    await copyWorkflows('base', cwd);\n\n    // Create .gitignore\n    await writeFile(\n      join(cwd, '.gitignore'),\n      'dist/\\nnode_modules/\\ncoverage/\\n*.lcov\\n*.tsbuildinfo\\n*.log\\n.env\\n.env.*\\n!.env.example\\n',\n    );\n\n    // Install deps + init git\n    console.log('Installing dependencies...');\n    await execAsync('npm install');\n\n    console.log('Initializing git...');\n    await execAsync('git init && git add . && git commit -m \"chore: initial commit\"');\n\n    console.log(`\\n✓ Project bootstrapped! (${options.type})`);\n    console.log('\\nNext: run `dev init-kiro` to set up AI-assisted development.');\n  });\n","import { cp, mkdir } from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\n\nimport { Command } from '@commander-js/extra-typings';\n\nimport { paths } from '../utils/paths.js';\n\nexport const initKiro = new Command()\n  .name('init-kiro')\n  .description('Install the zweer-setup agent globally for Kiro-powered project configuration')\n  .action(async () => {\n    const home = homedir();\n    const kiroDir = join(home, '.kiro');\n\n    // Copy agent\n    await mkdir(join(kiroDir, 'agents'), { recursive: true });\n    await cp(join(paths.kiro, 'agents/zweer-setup.json'), join(kiroDir, 'agents/zweer-setup.json'));\n\n    // Copy prompt\n    await mkdir(join(kiroDir, 'prompts'), { recursive: true });\n    await cp(join(paths.kiro, 'prompts/zweer-setup.md'), join(kiroDir, 'prompts/zweer-setup.md'));\n\n    // Copy skills\n    const skillsDest = join(kiroDir, 'skills/zweer-dev');\n    await cp(join(paths.kiro, 'skills'), skillsDest, { recursive: true });\n\n    console.log('✓ zweer-setup agent installed globally');\n    console.log(`\\n  Agent:  ${join(kiroDir, 'agents/zweer-setup.json')}`);\n    console.log(`  Prompt: ${join(kiroDir, 'prompts/zweer-setup.md')}`);\n    console.log(`  Skills: ${skillsDest}/`);\n    console.log('\\nTo configure this project:');\n    console.log('  1. Run: kiro-cli chat');\n    console.log('  2. Use: /agent swap zweer-setup');\n  });\n","import { readFile, writeFile } from 'node:fs/promises';\n\nimport { Command } from '@commander-js/extra-typings';\n\nimport { CONFIG_FILES, copyConfig, copyWorkflows, fileExists } from '../utils/configs.js';\n\nconst DEV_DEPENDENCIES: Record<string, string> = {\n  '@biomejs/biome': '^2.4.8',\n  bonvoy: '^0.13.1',\n  '@commitlint/cli': '^20.5.0',\n  '@commitlint/config-conventional': '^20.5.0',\n  '@tsconfig/node22': '^22.0.5',\n  '@types/node': '^25.5.0',\n  '@vitest/coverage-v8': '^4.1.0',\n  concurrently: '^9.2.1',\n  lefthook: '^2.1.4',\n  'lockfile-lint': '^5.0.0',\n  'ls-engines': '^0.10.0',\n  'npm-package-json-lint': '^9.1.0',\n  rimraf: '^6.1.3',\n  'sort-package-json': '^3.6.1',\n  tsdown: '^0.21.4',\n  typescript: '^5.9.3',\n  vitest: '^4.1.0',\n};\n\nconst SCRIPTS: Record<string, string> = {\n  build: 'tsdown',\n  clean: 'rimraf dist',\n  lint: 'concurrently npm:lint:* --prefixColors auto',\n  'lint:engines': 'ls-engines',\n  'lint:format': 'biome check --write',\n  'lint:lockfile': 'lockfile-lint',\n  'lint:package': 'npmPkgJsonLint .',\n  'lint:sort_package': 'sort-package-json \"package.json\"',\n  'lint:typecheck': 'tsc --noEmit',\n  prepare: 'lefthook install',\n  test: 'vitest run',\n  'test:coverage': 'vitest run --coverage',\n};\n\nexport const setup = new Command()\n  .name('setup')\n  .description('Add standard configuration to an existing project')\n  .option('-y, --yes', 'Skip prompts and add all configurations')\n  .action(async () => {\n    const cwd = process.cwd();\n\n    if (!(await fileExists('package.json'))) {\n      console.error('package.json not found. Run this in a project directory.');\n      process.exit(1);\n    }\n\n    // Copy config files (skip existing)\n    for (const file of CONFIG_FILES) {\n      const copied = await copyConfig(file, cwd);\n      console.log(copied ? `  ✓ ${file.dest}` : `  · ${file.dest} (exists)`);\n    }\n\n    // Merge deps and scripts into package.json\n    const pkg = JSON.parse(await readFile('package.json', 'utf-8'));\n    pkg.devDependencies = { ...pkg.devDependencies, ...DEV_DEPENDENCIES };\n    pkg.scripts = { ...pkg.scripts, ...SCRIPTS };\n    if (!pkg.engines) pkg.engines = { node: '>= 22' };\n    await writeFile('package.json', `${JSON.stringify(pkg, null, 2)}\\n`);\n    console.log('  ✓ package.json (deps + scripts merged)');\n\n    // Copy base workflows\n    await copyWorkflows('base', cwd);\n    console.log('  ✓ .github/workflows/ (base)');\n\n    console.log('\\n✓ Setup complete!');\n    console.log('\\nNext: run `dev init-kiro` to set up AI-assisted development.');\n  });\n","#!/usr/bin/env node\n\nimport { readFileSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { Command } from '@commander-js/extra-typings';\n\nimport { bootstrap } from './commands/bootstrap.js';\nimport { initKiro } from './commands/init-kiro.js';\nimport { setup } from './commands/setup.js';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8')) as {\n  name: string;\n  description: string;\n  version: string;\n};\n\nconst program = new Command().name(pkg.name).description(pkg.description).version(pkg.version);\n\nprogram.addCommand(bootstrap);\nprogram.addCommand(setup);\nprogram.addCommand(initKiro);\n\nprogram.parse();\n"],"mappings":"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"}

package/kiro/agents/zweer-setup.json

@@ -0,0 +1,38 @@
+{
+  "name": "zweer-setup",
+  "description": "Agent that analyzes a project and generates optimal .kiro/ configuration (steering, agent, prompt, skills)",
+  "prompt": "file://../prompts/zweer-setup.md",
+  "resources": ["skill://.kiro/skills/**/SKILL.md"],
+  "tools": [
+    "read",
+    "write",
+    "shell",
+    "grep",
+    "glob",
+    "web_search",
+    "web_fetch",
+    "introspect",
+    "thinking",
+    "code"
+  ],
+  "allowedTools": [
+    "read",
+    "shell",
+    "grep",
+    "glob",
+    "web_search",
+    "web_fetch",
+    "introspect",
+    "thinking",
+    "code"
+  ],
+  "toolsSettings": {
+    "write": {
+      "allowedPaths": [".kiro/**"]
+    },
+    "shell": {
+      "autoAllowReadonly": true,
+      "deniedCommands": [".*git commit.*", ".*git push.*", ".*git tag .*", ".*npm publish.*"]
+    }
+  }
+}

package/kiro/prompts/zweer-setup.md

@@ -0,0 +1,55 @@
+# zweer-setup — Kiro Configuration Agent
+
+You are the **zweer-setup agent**. Your job is to analyze a project and generate the optimal `.kiro/` configuration for it.
+
+## What You Do
+
+1. **Analyze the project**: Read `package.json`, directory structure, README, existing configs
+2. **Ask clarifying questions**: Project type, deploy target, special needs
+3. **Generate `.kiro/` config**: Agent, prompt, steering files, skills — all tailored to the project
+
+## Workflow
+
+### Step 1: Analyze
+Read these files (if they exist):
+- `package.json` (name, scripts, deps, workspaces)
+- `README.md` (project description, architecture)
+- `tsconfig.json`, `biome.json`, `vitest.config.ts` (tooling)
+- Directory structure (monorepo? apps? packages?)
+
+### Step 2: Classify
+Determine the project type:
+- **Monorepo library** (npm packages, like bonvoy/FlowRAG)
+- **Web app** (SvelteKit/Next.js/Nuxt, like drop-coop)
+- **CLI tool** (like @zweer/dev itself)
+- **Infrastructure** (CDK/Terraform)
+- **Other** (ask the user)
+
+### Step 3: Generate
+Create these files under `.kiro/`:
+
+```
+.kiro/
+├── agents/
+│   └── dev.json          # Agent config
+├── prompts/
+│   └── dev.md            # Agent prompt
+├── steering/
+│   ├── code-style.md     # Always
+│   ├── build-tooling.md  # Always
+│   ├── testing.md        # Always
+│   ├── interaction.md    # Always
+│   └── commit-conventions.md  # Always
+└── skills/
+    └── (project-specific)
+```
+
+Use the templates in your skills' `references/` folders. Adapt them to the specific project.
+
+## Rules
+
+- **NEVER commit or push** — the developer handles git
+- **Ask before generating** — confirm project type and any assumptions
+- **Use real project details** — don't use placeholder names
+- **Keep steering files under 200 lines** — split if needed
+- **Write paths** are restricted to `.kiro/**` only

package/kiro/skills/agent-template/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: agent-template
+description: Generate .kiro/agents/dev.json for a project. Use when setting up a new project's Kiro agent configuration.
+---
+
+# Agent Template
+
+Generate a `.kiro/agents/dev.json` file tailored to the project.
+
+## Rules
+
+1. Always deny `git commit`, `git push`, `git tag`, `npm publish` in shell
+2. Set `autoAllowReadonly: true` on shell
+3. `allowedTools` should include everything EXCEPT `write` (write needs approval)
+4. `write.allowedPaths` should be project-specific (source dirs, configs, .kiro)
+5. Prompt should reference `file://../prompts/dev.md`
+6. Resources should include README, steering, and skills
+
+## References
+- Review `references/base.json` for the common agent structure
+- Review `references/example-monorepo-library.json` for npm library projects
+- Review `references/example-webapp-vercel.json` for web app projects

package/kiro/skills/agent-template/references/base.json

@@ -0,0 +1,38 @@
+{
+  "name": "dev",
+  "description": "Development agent for __PROJECT_NAME__",
+  "prompt": "file://../prompts/dev.md",
+  "resources": ["file://README.md", "file://.kiro/specs/**/*.md", "file://.kiro/steering/**/*.md"],
+  "tools": [
+    "read",
+    "write",
+    "shell",
+    "grep",
+    "glob",
+    "web_search",
+    "web_fetch",
+    "introspect",
+    "thinking",
+    "code"
+  ],
+  "allowedTools": [
+    "read",
+    "shell",
+    "grep",
+    "glob",
+    "web_search",
+    "web_fetch",
+    "introspect",
+    "thinking",
+    "code"
+  ],
+  "toolsSettings": {
+    "write": {
+      "allowedPaths": ["__PROJECT_SPECIFIC__"]
+    },
+    "shell": {
+      "autoAllowReadonly": true,
+      "deniedCommands": [".*git commit.*", ".*git push.*", ".*git tag .*", ".*npm publish.*"]
+    }
+  }
+}