@zweer/dev 1.2.0 → 2.0.0

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.2.0",
-  "description": "Shared configurations & AI agents for software projects",
+  "version": "2.0.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}!`;
+}

package/templates/single/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/single/tsdown.config.ts

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

package/workflows/base/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  workflow_call:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test & Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: lts/*
+          cache: npm
+
+      - run: npm ci
+      - run: npm run build
+      - run: npm run test:coverage
+      - run: npm run lint

package/workflows/base/dependabot-auto-merge.yml

@@ -0,0 +1,43 @@
+name: Dependabot Auto-Merge
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  check_suite:
+    types: [completed]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  auto-merge:
+    name: Auto-merge Dependabot PRs
+    runs-on: ubuntu-latest
+    if: |
+      github.actor == 'dependabot[bot]' &&
+      (github.event_name == 'pull_request' || github.event.check_suite.conclusion == 'success')
+    steps:
+      - name: Dependabot metadata
+        id: metadata
+        uses: dependabot/fetch-metadata@v2.5.0
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Enable auto-merge for Dependabot PRs
+        if: |
+          steps.metadata.outputs.update-type == 'version-update:semver-patch' ||
+          steps.metadata.outputs.update-type == 'version-update:semver-minor'
+        run: gh pr merge --auto --squash "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Approve PR
+        if: |
+          steps.metadata.outputs.update-type == 'version-update:semver-patch' ||
+          steps.metadata.outputs.update-type == 'version-update:semver-minor'
+        run: gh pr review --approve "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/workflows/base/dependabot-lockfile.yml

@@ -0,0 +1,34 @@
+name: Dependabot Lockfile Fix
+
+on:
+  pull_request:
+    paths:
+      - 'package.json'
+      - 'packages/*/package.json'
+
+permissions:
+  contents: write
+
+jobs:
+  fix-lockfile:
+    if: github.actor == 'dependabot[bot]'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.head_ref }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: lts/*
+
+      - run: npm i --package-lock-only
+
+      - name: Commit updated lockfile
+        run: |
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git config user.name "github-actions[bot]"
+          git add package-lock.json
+          git diff --cached --quiet || git commit -m "fix: :lock: regenerate lockfile with Node 20"
+          git push