@timothyrusso/config-presets 0.1.0

package/dist/kitConfig.schema.json

@@ -0,0 +1,163 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "https://github.com/timothyrusso/agentic-kit/schema/kit.config.schema.json",
+    "title": "kit.config.json",
+    "description": "Per-app configuration read by every agentic-kit package and by the Claude Code plugin.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["projectName"],
+    "properties": {
+        "$schema": { "type": "string" },
+        "projectName": {
+            "description": "Human name of the app, used in agent prompts and run markers.",
+            "type": "string",
+            "minLength": 1
+        },
+        "featuresRoot": {
+            "description": "Folder that holds the feature modules.",
+            "enum": ["features", "src/features"],
+            "default": "features"
+        },
+        "appRoot": {
+            "description": "expo-router app folder.",
+            "type": "string",
+            "minLength": 1,
+            "default": "app"
+        },
+        "github": {
+            "description": "GitHub Projects board the agents move issues on.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["projectNumber", "projectId", "statusFieldId", "statusOptions"],
+            "properties": {
+                "projectNumber": { "type": "integer", "minimum": 1 },
+                "projectId": { "type": "string", "minLength": 1 },
+                "statusFieldId": { "type": "string", "minLength": 1 },
+                "statusOptions": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["todo", "inProgress", "done"],
+                    "properties": {
+                        "todo": { "type": "string", "minLength": 1 },
+                        "inProgress": { "type": "string", "minLength": 1 },
+                        "done": { "type": "string", "minLength": 1 }
+                    }
+                },
+                "labels": {
+                    "description": "Labels the agents may apply to issues they write.",
+                    "type": "array",
+                    "items": { "type": "string", "minLength": 1 },
+                    "uniqueItems": true,
+                    "default": []
+                }
+            }
+        },
+        "qa": {
+            "description": "Where the QA agents run the app.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["targets"],
+            "properties": {
+                "targets": {
+                    "type": "array",
+                    "items": { "enum": ["mobile", "web"] },
+                    "minItems": 1,
+                    "uniqueItems": true
+                },
+                "simulator": {
+                    "description": "Simulator or device name, e.g. iPhone 17 Pro.",
+                    "type": "string",
+                    "minLength": 1
+                },
+                "metroPort": { "type": "integer", "minimum": 1024, "maximum": 65535 },
+                "baseline": {
+                    "description": "App-specific steps of the baseline QA checks that run for every feature.",
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "setup": {
+                            "description": "What to do before the checks, e.g. how to sign in with the test account.",
+                            "type": "string",
+                            "minLength": 1
+                        },
+                        "launch": {
+                            "description": "What a healthy cold launch reaches, e.g. the Home tab with the greeting.",
+                            "type": "string",
+                            "minLength": 1
+                        },
+                        "firstScreens": {
+                            "description": "Screens that must render right after launch.",
+                            "type": "array",
+                            "items": { "type": "string", "minLength": 1 },
+                            "uniqueItems": true
+                        },
+                        "navigation": {
+                            "description": "Primary navigation steps to exercise, one per entry.",
+                            "type": "array",
+                            "items": { "type": "string", "minLength": 1 },
+                            "uniqueItems": true
+                        }
+                    }
+                }
+            }
+        },
+        "lint": {
+            "description": "Options for the kit's lint rules.",
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "allowedHooksInViews": {
+                    "description": "Hooks a view may call besides its own ViewModel hook.",
+                    "type": "array",
+                    "items": { "type": "string", "minLength": 1 },
+                    "uniqueItems": true,
+                    "default": []
+                },
+                "dashes": {
+                    "description": "Whether em and en dashes are forbidden in code, comments and copy.",
+                    "enum": ["forbid", "allow"],
+                    "default": "forbid"
+                },
+                "layoutTokens": {
+                    "description": "Horizontal spacing tokens checked by the layout rule.",
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["gutterToken", "spacingImport", "allowlistFile"],
+                    "properties": {
+                        "gutterToken": {
+                            "description": "Name of the only horizontal edge token.",
+                            "type": "string",
+                            "minLength": 1
+                        },
+                        "spacingImport": { "description": "Import path of the spacing tokens.", "type": "string", "minLength": 1 },
+                        "allowlistFile": {
+                            "description": "File listing paths exempt from the rule.",
+                            "type": "string",
+                            "minLength": 1
+                        }
+                    }
+                },
+                "singleSpinner": {
+                    "description": "Forbid ActivityIndicator in favour of the design system spinner.",
+                    "type": "boolean",
+                    "default": false
+                }
+            }
+        },
+        "i18n": {
+            "description": "Translation catalog checked by the parity and unused-key scripts.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["catalogPath", "languages"],
+            "properties": {
+                "catalogPath": { "type": "string", "minLength": 1 },
+                "languages": {
+                    "type": "array",
+                    "items": { "type": "string", "minLength": 2 },
+                    "minItems": 1,
+                    "uniqueItems": true
+                }
+            }
+        }
+    }
+}

package/github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

package/github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,63 @@
+name: Feature
+description: Describe a feature to be implemented, with clear, testable acceptance criteria.
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please complete every required section and keep the structure intact.
+        A clear description and testable acceptance criteria make the feature faster to
+        build and easier to verify.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Everything needed to build the feature - what it does, expected behaviour, and any constraints. Be specific and self-contained.
+      placeholder: |
+        As a user, I want ...
+        The feature should ...
+        Constraints / edge cases: ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance-criteria
+    attributes:
+      label: Acceptance criteria
+      description: A checklist of observable, verifiable outcomes. Each item should be independently testable on the device.
+      placeholder: |
+        - [ ] Given ... when ... then ...
+        - [ ] The <screen> shows ...
+        - [ ] Tapping <element> navigates to ...
+    validations:
+      required: true
+
+  - type: input
+    id: screens-affected
+    attributes:
+      label: Screens affected
+      description: Which screens or features this touches.
+      placeholder: e.g. Home, Settings
+    validations:
+      required: false
+
+  - type: textarea
+    id: out-of-scope
+    attributes:
+      label: Out of scope
+      description: Anything explicitly NOT part of this issue, to keep the change focused.
+      placeholder: |
+        - ...
+    validations:
+      required: false
+
+  - type: input
+    id: design-link
+    attributes:
+      label: Design link
+      description: Link to the design (Figma, Claude design, Notion, etc.), if any.
+      placeholder: https://...
+    validations:
+      required: false

package/github/pr-checks.yml

@@ -0,0 +1,153 @@
+name: PR checks
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+concurrency:
+  group: pr-checks-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v7
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+
+      - run: npm ci
+
+      - name: Commit messages
+        if: github.event_name == 'pull_request'
+        run: npx commitlint --from ${{ github.event.pull_request.base.sha }} --to ${{ github.event.pull_request.head.sha }} --verbose
+
+      # NOTE: the report goes to a file, not a step output, so the comment script reads it as data
+      # and a backtick or `${` in a violation cannot break or inject into the script.
+      - name: Architecture
+        id: arch
+        run: |
+          set +e
+          npm run --silent check:arch > "$RUNNER_TEMP/arch-report.txt" 2>&1
+          code=$?
+          cat "$RUNNER_TEMP/arch-report.txt"
+          echo "exit_code=$code" >> "$GITHUB_OUTPUT"
+          exit $code
+
+      # NOTE: one marker comment per PR, updated in place and deleted once the violations are fixed.
+      # Fork PRs get no write token, so they are skipped rather than failing.
+      - name: Architecture violations comment
+        if: always() && github.event_name == 'pull_request' && github.event.pull_request.head.repo.fork == false && steps.arch.outcome != 'skipped'
+        uses: actions/github-script@v9
+        env:
+          ARCH_EXIT_CODE: ${{ steps.arch.outputs.exit_code }}
+          ARCH_REPORT: ${{ runner.temp }}/arch-report.txt
+        with:
+          script: |
+            const fs = require('node:fs');
+            const marker = '<!-- arch-violations -->';
+            const failed = process.env.ARCH_EXIT_CODE !== '0';
+            const report = fs.existsSync(process.env.ARCH_REPORT) ? fs.readFileSync(process.env.ARCH_REPORT, 'utf8') : '';
+
+            const comments = await github.paginate(github.rest.issues.listComments, {
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              per_page: 100,
+            });
+            const existing = comments.find(c => (c.body ?? '').startsWith(marker));
+
+            if (!failed) {
+              if (existing) {
+                await github.rest.issues.deleteComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  comment_id: existing.id,
+                });
+              }
+              return;
+            }
+
+            const fence = '`'.repeat(Math.max(3, ...[...report.matchAll(/`+/g)].map(m => m[0].length + 1)));
+            const body = [
+              marker,
+              '## Architecture violations found',
+              '',
+              'The following dependency-cruiser rules were violated. Fix them before merging.',
+              '',
+              fence,
+              report.slice(-60000),
+              fence,
+            ].join('\n');
+
+            if (existing) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: existing.id,
+                body,
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                body,
+              });
+            }
+
+      - run: npm run check
+
+      - name: Bundle for iOS (JavaScript only, no native build)
+        run: npx expo export --platform ios --output-dir "$RUNNER_TEMP/expo-export"
+
+  native-changes:
+    runs-on: ubuntu-latest
+    outputs:
+      native: ${{ steps.filter.outputs.native }}
+    steps:
+      - uses: actions/checkout@v7
+      - uses: dorny/paths-filter@v4
+        id: filter
+        with:
+          filters: |
+            native:
+              - 'ios/**'
+              - 'android/**'
+              - 'targets/**'
+              - 'modules/**'
+              - 'plugins/**'
+              - 'app.json'
+              - 'app.config.*'
+              - 'package-lock.json'
+
+  # NOTE: a template. It builds the iOS app for the simulator only when native code, config
+  # plugins, native targets (such as a watch app in `targets/`) or dependencies change. Add a step
+  # per extra scheme (a watch target) with its own `-scheme`.
+  native:
+    needs: native-changes
+    if: needs.native-changes.outputs.native == 'true'
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+      - run: npm ci
+      - run: npx expo prebuild --platform ios --clean
+      - name: Build for the simulator
+        run: |
+          workspace=$(ls -d ios/*.xcworkspace | head -n 1)
+          scheme=$(basename "$workspace" .xcworkspace)
+          xcodebuild -workspace "$workspace" -scheme "$scheme" -configuration Debug \
+            -sdk iphonesimulator -destination 'generic/platform=iOS Simulator' \
+            CODE_SIGNING_ALLOWED=NO build

package/jest/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/jest/preset.js

@@ -0,0 +1,18 @@
+/**
+ * Jest for an Expo app: `jest-expo`, the `@/` alias mapped to the app root, and tests in
+ * `__tests__` folders. Use it as the whole config (`jest.config.cjs`):
+ *
+ *   module.exports = require('@timothyrusso/config-presets/jest');
+ *
+ * `preset` is resolved from the app's root, so `jest-expo` comes from the app's own
+ * `node_modules` at the version `npx expo install jest-expo` picked for its SDK. An app whose alias
+ * points somewhere else overrides `moduleNameMapper` in its own config.
+ */
+const preset = {
+  preset: 'jest-expo',
+  testMatch: ['<rootDir>/**/__tests__/**/*.test.{ts,tsx,js,jsx}'],
+  testPathIgnorePatterns: ['/node_modules/', '<rootDir>/(ios|android|dist|coverage|\\.expo)/'],
+  moduleNameMapper: { '^@/(.*)$': '<rootDir>/$1' },
+};
+
+module.exports = preset;

package/lefthook.yml

@@ -0,0 +1,30 @@
+# NOTE: installed by the app's `prepare` script (`lefthook install`). There is no bypass: agents
+# are denied `--no-verify` in .claude/settings.json, and CI runs the same checks on every pull
+# request, so a hook skipped locally only moves the failure to the PR.
+# NOTE: relative imports are caught by ESLint (`arch/no-relative-imports`), so there is no grep.
+
+pre-commit:
+  parallel: true
+  commands:
+    biome:
+      glob: "*.{js,jsx,mjs,cjs,ts,tsx,json,jsonc}"
+      run: npx --no-install biome check --write --no-errors-on-unmatched --files-ignore-unknown=true {staged_files}
+      stage_fixed: true
+    eslint:
+      glob: "*.{js,jsx,mjs,cjs,ts,tsx}"
+      run: npx --no-install eslint --no-warn-ignored {staged_files}
+    text:
+      run: npx --no-install config-presets check-text {staged_files}
+
+commit-msg:
+  commands:
+    commitlint:
+      run: npx --no-install commitlint --edit {1}
+    issue-number:
+      run: |
+        if ! head -n 1 {1} | grep -qE '^(Merge |Revert |fixup! |squash! )|^[a-z]+\([0-9]+\)!?: .+'; then
+          echo "Commit message must be type(issue): message, e.g. feat(12): add the settings screen"
+          exit 1
+        fi
+    text:
+      run: npx --no-install config-presets check-text --message {1}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@timothyrusso/config-presets",
+  "version": "0.1.0",
+  "description": "Biome, commitlint, lefthook, tsconfig, Jest and CI presets, the kit.config.json loader, the check scripts and the init command.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/timothyrusso/agentic-kit.git",
+    "directory": "packages/config-presets"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./kit.config.schema.json": "./dist/kitConfig.schema.json",
+    "./biome": "./biome/base.json",
+    "./commitlint": "./commitlint.config.cjs",
+    "./tsconfig/expo.json": "./tsconfig/expo.json",
+    "./jest": "./jest/preset.js",
+    "./lefthook.yml": "./lefthook.yml",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "config-presets": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "biome",
+    "jest",
+    "tsconfig",
+    "github",
+    "templates",
+    ".claude",
+    "commitlint.config.cjs",
+    "lefthook.yml"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "NODE_OPTIONS=\"--experimental-vm-modules --no-warnings=ExperimentalWarning\" jest"
+  },
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "jiti": "^2.7.0"
+  },
+  "peerDependencies": {
+    "@timothyrusso/arch-rules": "0.1.0",
+    "@timothyrusso/eslint-plugin-arch": "0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@timothyrusso/arch-rules": {
+      "optional": true
+    },
+    "@timothyrusso/eslint-plugin-arch": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^21.2.3",
+    "@commitlint/lint": "^21.2.3",
+    "@commitlint/load": "^21.2.3"
+  }
+}

package/templates/dependency-cruiser.template.mjs

@@ -0,0 +1,13 @@
+import { createDependencyCruiserConfig } from '@timothyrusso/arch-rules';
+import { loadKitConfig } from '@timothyrusso/config-presets';
+
+/**
+ * Architecture rules generated from each feature's `FEATURE_TIER` and `kit.config.json`: tiers,
+ * public API boundaries, layers and Effect placement. Run by `npm run check:arch`. Written by
+ * `config-presets init`.
+ *
+ * @type {import('dependency-cruiser').IConfiguration}
+ */
+export default createDependencyCruiserConfig(loadKitConfig({ cwd: import.meta.dirname }), {
+  rootDir: import.meta.dirname,
+});

package/templates/eslint.config.template.mjs

@@ -0,0 +1,11 @@
+import { loadKitConfig } from '@timothyrusso/config-presets';
+import arch from '@timothyrusso/eslint-plugin-arch';
+
+/**
+ * ESLint covers only what Biome does not: the kit's architecture rules and `no-restricted-syntax`
+ * (no `enum`, no `as Error`), driven by `kit.config.json`. Written by `config-presets init`.
+ */
+export default [
+  { ignores: ['**/node_modules/**', '**/dist/**', '**/coverage/**', '**/.expo/**', 'ios/**', 'android/**'] },
+  ...arch.configs.recommended(loadKitConfig({ cwd: import.meta.dirname })),
+];

package/tsconfig/expo.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "verbatimModuleSyntax": true,
+    "paths": { "@/*": ["${configDir}/*"] }
+  }
+}