fix: improve startup reliability, repo validation, and toasts

.mise/tasks/format

@@ -1,3 +1,3 @@
 #!/usr/bin/env bash
-#MISE description="Format code with Prettier"
-prettier --write "src/**/*.ts"
+#MISE description="Format code with Biome"
+biome format --write .

.mise/tasks/lint

@@ -1,3 +1,3 @@
 #!/usr/bin/env bash
-#MISE description="Run ESLint"
-eslint . --ext .ts
+#MISE description="Run Biome lint"
+biome lint .

.mise/tasks/lint:fix

@@ -1,3 +1,3 @@
 #!/usr/bin/env bash
-#MISE description="Run ESLint with auto-fix"
-eslint . --ext .ts --fix
+#MISE description="Run Biome lint with auto-fix"
+biome lint --write .

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
   ".": "0.1.0"
-}
+}

AGENTS.md

@@ -6,9 +6,16 @@
 - **Test**: `mise run test` or `bun test`
 - **Single Test**: `bun test BackgroundTask.test.ts` (use file glob pattern)
 - **Watch Mode**: `bun test --watch`
-- **Lint**: `mise run lint` (eslint)
-- **Fix Lint**: `mise run lint:fix` (eslint --fix)
-- **Format**: `mise run format` (prettier)
+- **Lint**: `mise run lint` or `bun run lint` (biome)
+- **Fix Lint**: `mise run lint:fix` or `bun run lint:fix` (biome --write)
+- **Format**: `mise run format` or `bun run format` (biome format --write)
+- **Check (Lint + Format)**: `bun run check` (biome check --write)
+
+## PR & Commit Guidelines
+
+- **Conventional Commits**: Use conventional commit messages (e.g., `fix:`, `feat:`, `chore:`, `docs:`, `refactor:`, `test:`, `revert:`).
+- **PR Titles**: PR titles MUST follow conventional commit format (e.g., `fix: descriptive title`). This is enforced by GitHub checks.
+- **Workflow**: Run `bun run check` and `bun run test` before creating a PR.
 
 ## Code Style Guidelines
 
@@ -18,11 +25,11 @@
 - Group imports: external libraries first, then internal modules
 - Use explicit file extensions (`.ts`) for internal imports
 
-### Formatting (Prettier)
+### Formatting (Biome)
 
-- **Single quotes** (`singleQuote: true`)
+- **Single quotes** (`quoteStyle: 'single'`)
 - **Line width**: 100 characters
-- **Tab width**: 2 spaces
+- **Tab width**: 2 spaces (indentStyle: 'space')
 - **Trailing commas**: ES5 (no trailing commas in function parameters)
 - **Semicolons**: enabled
 

README.md

@@ -182,3 +182,4 @@ Then re-run `/sync-pull` or `/sync-push`.
 - `bun run build`
 - `bun run test`
 - `bun run lint`
+

biome.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.10/schema.json",
+  "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true },
+  "files": { "includes": ["**", "!!**/dist"] },
+  "formatter": {
+    "enabled": true,
+    "formatWithErrors": false,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 100,
+    "attributePosition": "auto",
+    "bracketSameLine": false,
+    "bracketSpacing": true,
+    "expand": "auto",
+    "useEditorconfig": true
+  },
+  "linter": { "enabled": true, "rules": { "recommended": true } },
+  "javascript": {
+    "formatter": {
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "trailingCommas": "es5",
+      "semicolons": "always",
+      "arrowParentheses": "always",
+      "bracketSameLine": false,
+      "quoteStyle": "single",
+      "attributePosition": "auto",
+      "bracketSpacing": true
+    }
+  },
+  "html": {
+    "formatter": {
+      "indentScriptAndStyle": false,
+      "selfCloseVoidElements": "always"
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": { "source": { "organizeImports": "on" } }
+  }
+}