docs: add roadmap, ADRs, and initial HOUSEBOT specs

docs/specs/HOUSEBOT-001-monorepo-bootstrap.md

@@ -0,0 +1,78 @@
+# HOUSEBOT-001: Monorepo Bootstrap and Quality Gates
+
+## Summary
+Initialize the repository as a Bun workspace monorepo with strict TypeScript, Oxlint, CI quality gates, and architecture-oriented package layout.
+
+## Goals
+- Establish baseline folder structure for hexagonal architecture.
+- Add root scripts for lint, typecheck, test, and build.
+- Enforce no-semicolon formatting style and strict linting.
+- Ensure CI runs on every push/PR.
+
+## Non-goals
+- Implement business logic.
+- Implement Telegram handlers.
+- Create production cloud resources.
+
+## Scope
+- In: repo skeleton, workspace config, root tooling config, CI workflow.
+- Out: feature code, database schema, external service integration.
+
+## Interfaces and Contracts
+- Root scripts exposed via `package.json`:
+  - `lint`
+  - `typecheck`
+  - `test`
+  - `build`
+- Workspace packages must compile under shared TS config.
+
+## Architecture Constraints
+- Workspace must include:
+  - `apps/bot`
+  - `apps/miniapp`
+  - `packages/domain`
+  - `packages/application`
+  - `packages/ports`
+  - `packages/contracts`
+  - `packages/observability`
+- No cross-import from domain to adapters/apps.
+
+## File Plan
+- Root:
+  - `package.json`
+  - `bunfig.toml`
+  - `tsconfig.base.json`
+  - `oxlint.json`
+  - `.editorconfig`
+  - `.gitignore`
+- CI:
+  - `.github/workflows/ci.yml`
+- Workspace placeholders:
+  - `apps/bot/src/index.ts`
+  - `apps/miniapp/src/main.tsx`
+  - `packages/*/src/index.ts`
+
+## Security and Safety
+- No secrets in repo.
+- Add `.env.example` templates only.
+- CI must fail on type/lint/test failure.
+
+## Test Plan
+- Unit: not applicable in this ticket.
+- Integration: not applicable.
+- Validation checks:
+  - Workspace install succeeds.
+  - All root scripts run locally.
+  - CI workflow executes all checks.
+
+## Acceptance Criteria
+- [ ] Bun workspace initialized with declared workspaces.
+- [ ] Oxlint config present and root lint script works.
+- [ ] TypeScript strict base config is shared across workspaces.
+- [ ] CI workflow runs lint, typecheck, test, build.
+- [ ] Placeholder apps/packages compile.
+- [ ] Docs updated with local bootstrap commands.
+
+## Rollout Plan
+- Merge to default branch.
+- Use as mandatory baseline for all subsequent tickets.