@zweer/dev 1.3.0 → 2.1.0

package/kiro/steering/build-tooling.md

@@ -0,0 +1,62 @@
+# Build & Tooling
+
+## Build System
+
+### tsdown
+- **tsdown** for building all packages (NOT tsc, esbuild, rollup)
+- Configuration: `tsdown.config.ts` at root
+- Workspace mode for monorepos
+- Outputs: `.mjs` + `.d.ts` + sourcemaps
+- tsc is only used for type-checking (`tsc --noEmit`)
+
+### Build Commands
+```bash
+npm run build              # Build with tsdown
+npm run clean              # Remove dist/
+npm run lint:typecheck     # Type-check only (tsc --noEmit)
+```
+
+## Linting & Formatting
+
+### Biome
+- **Biome** for linting and formatting (NOT ESLint/Prettier)
+- Single quotes, 100 line width
+- Uses `.editorconfig` for indent settings
+- Import sorting with grouped blank lines
+
+### Commands
+```bash
+npm run lint               # All linters in parallel
+npm run lint:format        # Biome check + fix
+npm run lint:typecheck     # TypeScript check
+npm run lint:lockfile      # Lockfile security
+npm run lint:package       # package.json validation
+npm run lint:sort_package  # Sort package.json keys
+npm run lint:engines       # Validate engine compatibility
+```
+
+## Git Hooks
+
+### Lefthook
+- **Lefthook** for git hooks (NOT husky + lint-staged)
+- Configuration: `lefthook.yml` at root
+- Pre-commit: biome → lockfile → package-lint → sort → build → typecheck → test
+- Commit-msg: commitlint validation
+- Built-in staging support (`stage_fixed: true`)
+
+## Package Manager
+
+### npm
+- Use **npm** (NOT pnpm or yarn)
+- Lock file: `package-lock.json`
+- Workspaces enabled in root `package.json` for monorepos
+
+## Scripts Reference
+
+| Script | Description |
+|--------|-------------|
+| `npm run build` | Build with tsdown |
+| `npm run clean` | Remove dist/ |
+| `npm run lint` | All linters in parallel |
+| `npm test` | Run tests |
+| `npm run test:coverage` | Tests with coverage |

package/kiro/steering/code-style.md

@@ -0,0 +1,83 @@
+# Code Style & Best Practices
+
+## TypeScript
+
+### Strict Mode
+- Always use strict mode (enabled in `tsconfig.json`)
+- No `any` types — use `unknown` or proper types
+- Explicit return types on all exported functions
+- Explicit parameter types always
+
+### Module System
+- ES modules only (`"type": "module"` in package.json)
+- Use `.js` extensions in imports (TypeScript requirement for ES modules)
+- Example: `import { foo } from './bar.js'` (not `./bar` or `./bar.ts`)
+
+### Naming Conventions
+- **camelCase** for variables, functions, methods
+- **PascalCase** for classes, interfaces, types
+- **UPPER_SNAKE_CASE** for constants
+- **kebab-case** for file names
+
+### Code Organization
+```typescript
+// 1. Imports (external first, then internal)
+import { execa } from 'execa';
+import type { Config } from './types.js';
+
+// 2. Types/Interfaces
+export interface MyConfig {
+  option: string;
+}
+
+// 3. Constants
+const DEFAULT_TIMEOUT = 5000;
+
+// 4. Classes/Functions
+export class MyClass {}
+```
+
+### Type Definitions
+- Prefer `interface` over `type` for object shapes
+- Use `type` for unions, intersections, mapped types
+- Export all public types
+- Use `readonly` for immutable properties
+
+## Code Quality
+
+### Minimal Code
+- Write only what's necessary
+- No premature abstractions
+- No unused code or imports
+- No commented-out code in commits
+
+### Error Handling
+- Always throw typed errors with clear messages
+- Include context in error messages
+- Use `try/catch` for async operations
+
+### Async/Await
+- Prefer `async/await` over `.then()/.catch()`
+- Always handle errors in async functions
+- Use `Promise.all()` for parallel operations
+
+## Dependencies
+
+### Minimal Dependencies
+- Only add dependencies when absolutely necessary
+- Prefer native Node.js APIs when possible
+- Use `^` for dependencies (allow minor/patch updates)
+- Keep dependencies up to date — run `npm outdated` regularly
+- Security updates must be applied immediately
+
+## Comments & Documentation
+
+### When to Comment
+- Complex algorithms or non-obvious logic
+- Public APIs (JSDoc)
+- Workarounds or hacks (with explanation)
+
+### When NOT to Comment
+- Obvious code
+- Redundant information
+- Commented-out code (delete it)

package/kiro/steering/commit-conventions.md

@@ -0,0 +1,58 @@
+# Commit Conventions
+
+**IMPORTANT**: The agent NEVER commits, pushes, or creates tags. The developer handles all git operations manually.
+
+## Format
+
+Use conventional commits with gitmoji as text (not emoji):
+
+```
+type(scope): :emoji_code: short description
+
+Detailed explanation of what changed and why.
+Include multiple lines if needed to fully describe:
+- What was changed
+- Why it was changed
+- Any breaking changes or important notes
+```
+
+## Types
+
+- `feat` — New feature (`:sparkles:`)
+- `fix` — Bug fix (`:bug:`)
+- `perf` — Performance improvement (`:zap:`)
+- `docs` — Documentation (`:memo:`)
+- `chore` — Maintenance tasks (`:wrench:`, `:arrow_up:`, `:bookmark:`)
+- `refactor` — Code refactoring (`:recycle:`)
+- `test` — Tests (`:white_check_mark:`)
+- `style` — Code formatting (`:art:`)
+- `ci` — CI/CD changes (`:construction_worker:`)
+- `build` — Build system (`:hammer:`)
+
+## Scope
+
+Use only ONE scope per commit — typically the package, module, or component affected.
+
+If `.vscode/settings.json` exists with `conventionalCommits.scopes`, use those values.
+Scope is optional for cross-cutting changes.
+
+## Gitmoji
+
+**Always use text codes** (`:sparkles:`), **never actual emoji** (✨).
+
+## Body
+
+**Always include a detailed body** explaining:
+1. What was changed
+2. Why it was changed
+3. Any important context or side effects
+
+## Breaking Changes
+
+Add `!` after the type/scope and include `BREAKING CHANGE:` in the body:
+
+```
+feat(api)!: :boom: remove deprecated methods
+
+BREAKING CHANGE: Removed old API methods deprecated in v0.5.
+```

package/kiro/steering/interaction.md

@@ -0,0 +1,41 @@
+# Interaction Patterns
+
+## Interview Before Implementing
+
+For ambiguous or complex requests, ask clarifying questions BEFORE writing code:
+- What's the expected behavior?
+- Are there edge cases to consider?
+- Does this affect existing features?
+- What's the priority (quick fix vs proper solution)?
+
+Skip the interview for clear, well-defined tasks.
+
+## Plan Mode
+
+For multi-step tasks (new features, refactors, architecture changes):
+1. Write a short numbered plan first
+2. Wait for approval before implementing
+3. Adapt the plan if requirements change mid-execution
+
+Skip planning for single-file fixes, small bug fixes, or simple questions.
+
+## ASCII Diagrams
+
+Use ASCII diagrams when discussing:
+- Architecture decisions
+- Data flow between components
+- New feature design involving multiple files
+- Database schema relationships
+
+## Context Hygiene
+
+- Keep each steering/spec file under ~200 lines
+- Split files when they grow beyond that
+- One concern per file (don't mix code style with testing rules)
+- Update specs when features are completed or changed
+
+## Git Rules
+
+- **NEVER commit, push, or create tags** — the developer handles all git operations
+- Prepare changes and suggest a commit message
+- The developer reviews and commits manually

package/kiro/steering/testing.md

@@ -0,0 +1,61 @@
+# Testing Strategy
+
+## Test Framework
+
+### Vitest
+- All tests use **Vitest** (NOT Jest, Mocha, or others)
+- Configuration in `vitest.config.ts` at root
+- v8 coverage provider
+- Coverage reporters: text, json, json-summary
+
+## Test Structure
+
+### File Organization
+```
+src/
+└── feature.ts
+test/
+└── feature.test.ts
+```
+
+### Test Pattern (AAA)
+```typescript
+import { describe, it, expect } from 'vitest';
+
+describe('FeatureName', () => {
+  it('should do something specific', () => {
+    // Arrange
+    const input = 'test';
+
+    // Act
+    const result = doSomething(input);
+
+    // Assert
+    expect(result).toBe('expected');
+  });
+});
+```
+
+## Mocking
+
+### When to Mock
+- External APIs, file system, git commands, network requests
+
+### When NOT to Mock
+- Internal functions, simple utilities, pure functions
+
+## Best Practices
+
+### Test Naming
+- Use `should` in test names: "should throw error when input is invalid"
+
+### Independence
+- Each test must be independent — no shared state
+- Use `beforeEach` for setup
+
+### Edge Cases
+- Empty arrays/strings, null/undefined, invalid input, boundary values
+
+### Coverage
+- Exclude barrel re-exports (`index.ts`) and type files (`types.ts`)
+- Include all source files in coverage

package/package.json

@@ -1,87 +1,72 @@
 {
   "name": "@zweer/dev",
-  "version": "1.3.0",
-  "description": "Shared configurations & AI agents for software projects",
+  "version": "2.1.0",
+  "description": "Shared configurations, golden configs & Kiro AI templates for software projects",
   "keywords": [
-    "ai",
-    "agents",
-    "cao",
     "cli",
-    "development"
+    "development",
+    "kiro",
+    "configs",
+    "tooling"
   ],
   "homepage": "https://github.com/Zweer/dev#readme",
   "bugs": {
     "url": "https://github.com/Zweer/dev/issues"
   },
-  "license": "MIT",
-  "author": "Zweer <n.olivieriachille@gmail.com>",
-  "files": [
-    "cli/**/*.js",
-    "cli/**/*.d.ts",
-    "agents",
-    "templates"
-  ],
-  "bin": "./cli/index.js",
-  "release": {
-    "plugins": [
-      "@semantic-release/commit-analyzer",
-      "@semantic-release/release-notes-generator",
-      "@semantic-release/changelog",
-      "@semantic-release/npm",
-      "@semantic-release/github",
-      "@semantic-release/git"
-    ]
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Zweer/dev.git"
   },
+  "license": "MIT",
+  "author": "Zweer <n.olivieriachille@gmail.com>",
   "type": "module",
+  "bin": "./dist/index.js",
+  "files": [
+    "dist/**/*",
+    "configs/**/*",
+    "kiro/**/*",
+    "workflows/**/*",
+    "templates/**/*"
+  ],
   "scripts": {
+    "build": "tsdown",
+    "clean": "rimraf dist",
     "lint": "concurrently npm:lint:* --prefixColors auto",
-    "lint:format": "biome check --write",
-    "lint:lockfile": "lockfile-lint --path package-lock.json",
     "lint:engines": "ls-engines",
+    "lint:format": "biome check --write",
+    "lint:lockfile": "lockfile-lint",
     "lint:package": "npmPkgJsonLint .",
-    "lint:publish": "publint --strict",
+    "lint:sort_package": "sort-package-json \"package.json\"",
+    "lint:typecheck": "tsc --noEmit",
+    "prepare": "lefthook install",
     "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "check": "npm run clean && npm run test:coverage && npm run build && npm run lint && npm run clean",
-    "prepare": "[ \"$CI\" = \"true\" ] || [ \"$GITHUB_ACTIONS\" = \"true\" ] && echo 'Skipping husky' && exit 0 || husky",
-    "clean": "rimraf --glob ./{cli,test}/**/*.{d.ts,js} ./vitest*.{d.ts,js}",
-    "prebuild": "npm run clean",
-    "build": "tsc",
-    "release": "semantic-release"
+    "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@commander-js/extra-typings": "^12.1.0",
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "inquirer": "^12.0.0",
-    "ora": "^8.1.1"
+    "@commander-js/extra-typings": "^14.0.0",
+    "commander": "^14.0.3"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.4",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/git": "^10.0.1",
-    "@tsconfig/node22": "^22.0.2",
-    "@types/node": "^24.10.0",
-    "@vitest/coverage-v8": "^4.0.8",
+    "@biomejs/biome": "^2.4.8",
+    "@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",
+    "bonvoy": "^0.13.1",
     "concurrently": "^9.2.1",
-    "husky": "^9.1.7",
-    "lint-staged": "^16.2.6",
-    "lockfile-lint": "^4.14.1",
-    "ls-engines": "^0.9.3",
-    "npm-package-json-lint": "^9.0.0",
-    "npm-package-json-lint-config-default": "^8.0.1",
-    "publint": "^0.3.15",
-    "rimraf": "^6.1.0",
-    "semantic-release": "^25.0.2",
+    "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.0.8"
+    "vitest": "^4.1.0"
   },
   "engines": {
-    "node": ">= 20.17"
+    "node": ">= 22"
   },
   "publishConfig": {
     "access": "public",

package/templates/monorepo/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]

package/templates/monorepo/README.md

@@ -0,0 +1,22 @@
+# {{name}}
+
+{{description}}
+
+## Packages
+
+| Package | Description |
+|---------|-------------|
+| `{{scope}}/core` | Core package |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run lint
+```
+
+## License
+
+MIT

package/templates/monorepo/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "{{name}}",
+  "version": "0.0.0",
+  "description": "{{description}}",
+  "type": "module",
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rimraf packages/*/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\" \"packages/*/package.json\"",
+    "lint:typecheck": "tsc --noEmit",
+    "prepare": "lefthook install",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [],
+  "author": "{{author}}",
+  "license": "MIT",
+  "engines": {
+    "node": ">= 22"
+  },
+  "devDependencies": {}
+}

package/templates/monorepo/packages/core/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]

package/templates/monorepo/packages/core/README.md

@@ -0,0 +1,21 @@
+# {{scope}}/core
+
+> Core package
+
+## Installation
+
+```bash
+npm install {{scope}}/core
+```
+
+## Usage
+
+```typescript
+import { hello } from '{{scope}}/core';
+
+hello('World');
+```
+
+## License
+
+MIT

package/templates/monorepo/packages/core/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "{{scope}}/core",
+  "version": "0.0.0",
+  "description": "Core package",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [],
+  "author": "{{author}}",
+  "license": "MIT",
+  "homepage": "{{homepage}}",
+  "bugs": {
+    "url": "{{bugs}}"
+  },
+  "repository": {
+    "type": "git",
+    "url": "{{repository}}",
+    "directory": "packages/core"
+  },
+  "engines": {
+    "node": ">= 22"
+  }
+}

package/templates/monorepo/packages/core/src/index.ts

@@ -0,0 +1,3 @@
+export function hello(name: string): string {
+  return `Hello, ${name}!`;
+}

package/templates/monorepo/packages/core/test/index.test.ts

@@ -0,0 +1,9 @@
+import { describe, expect, it } from 'vitest';
+
+import { hello } from '../src/index.js';
+
+describe('hello', () => {
+  it('should greet by name', () => {
+    expect(hello('World')).toBe('Hello, World!');
+  });
+});

package/templates/monorepo/tsdown.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'tsdown';
+
+export default defineConfig({
+  workspace: true,
+  entry: ['src/index.ts'],
+  dts: true,
+  sourcemap: true,
+  format: 'esm',
+  exports: true,
+  publint: 'ci-only',
+  attw: { enabled: 'ci-only', profile: 'esm-only' },
+});

package/templates/monorepo/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: ['packages/**/src/**/*.ts'],
+      exclude: ['**/index.ts', '**/types.ts'],
+    },
+  },
+});

package/templates/single/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]

package/templates/single/README.md

@@ -0,0 +1,30 @@
+# {{name}}
+
+{{description}}
+
+## Installation
+
+```bash
+npm install {{name}}
+```
+
+## Usage
+
+```typescript
+import { hello } from '{{name}}';
+
+hello('World');
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run lint
+```
+
+## License
+
+MIT

package/templates/single/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "{{name}}",
+  "version": "0.0.0",
+  "description": "{{description}}",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "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"
+  },
+  "keywords": [],
+  "author": "{{author}}",
+  "license": "MIT",
+  "engines": {
+    "node": ">= 22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {}
+}

package/templates/single/src/index.ts

@@ -0,0 +1,3 @@
+export function hello(name: string): string {
+  return `Hello, ${name}!`;
+}