From f9439f4519bed9dd4d007aebf4b2729dd4a90b24 Mon Sep 17 00:00:00 2001 From: saravanakumardb1 Date: Thu, 5 Mar 2026 14:37:31 -0800 Subject: [PATCH] chore(docs): regenerate AI agent config files --- .aider.conf.yml | 14 ++++++++++++ .clinerules | 24 ++++++++++++++++++++ .cursorrules | 33 +++++++++++++++++++-------- .editorconfig | 12 ++++++++++ .github/copilot-instructions.md | 40 +++++++++++++++++++++++++++++++++ .windsurfrules | 38 +++++++++++-------------------- 6 files changed, 127 insertions(+), 34 deletions(-) create mode 100644 .aider.conf.yml create mode 100644 .clinerules create mode 100644 .editorconfig create mode 100644 .github/copilot-instructions.md diff --git a/.aider.conf.yml b/.aider.conf.yml new file mode 100644 index 0000000..3224e19 --- /dev/null +++ b/.aider.conf.yml @@ -0,0 +1,14 @@ +# .aider.conf.yml — Aider Configuration for ChronoMind +# Helps Aider understand the project structure and conventions. + +read: + - AGENTS.md + - docs/PRD.md + +conventions: AGENTS.md + +lint-cmd: + - 'cd web && npm test 2>&1 | tail -10' + - 'cd web && npm run typecheck 2>&1 | tail -10' + +auto-commits: false diff --git a/.clinerules b/.clinerules new file mode 100644 index 0000000..201895e --- /dev/null +++ b/.clinerules @@ -0,0 +1,24 @@ +# .clinerules — Cline / Roo Code Rules for ChronoMind +# Read AGENTS.md for the complete onboarding guide. + +## Project: ChronoMind — AI-Powered Contextual Clock & Timer +Architecture: Next.js 16 (web) + SwiftUI (iOS/Watch/Mac) + Jetpack Compose (Android) + Fastify 5 (backend) + +## Mandatory Rules +- Web engine logic in web/src/lib/ — pure TS, no React imports +- Components in web/src/components/ — React UI only +- iOS shared logic in ios/ChronoMind/Shared/ — consumed by all Apple targets +- Android engine in android/.../engine/ — pure Kotlin, no Android framework deps +- Web build: must use --webpack flag (Serwist incompatible with Turbopack) +- Every Cosmos doc: productId: "chronomind" +- Theme: --cm-* CSS custom properties (web), ChronoMindTheme (native) +- Commits: `type(scope): description` +- After changes, verify: `cd web && npm test && npm run typecheck && npm run build` + +## Key File Locations +- web/src/lib/ — Pure TS engine modules (timer, cascade, urgency, nl-parser, etc.) +- web/src/components/ — React UI components +- ios/ChronoMind/Shared/ — Shared Swift code (iOS + Watch + Mac + Widgets) +- android/app/.../engine/ — Pure Kotlin engine +- backend/ — Fastify 5 + TypeScript backend (port 4011) +- Full guide: `AGENTS.md` diff --git a/.cursorrules b/.cursorrules index e222e6d..37288cb 100644 --- a/.cursorrules +++ b/.cursorrules @@ -3,15 +3,30 @@ Project: ChronoMind — AI-Powered Contextual Clock & Timer Product ID: chronomind -Stack: Next.js 16 (web) + SwiftUI (iOS) + Jetpack Compose (Android) + Fastify 5 (backend) +Stack: Next.js 16 (web) + SwiftUI (iOS/Watch/Mac) + Jetpack Compose (Android) + Fastify 5 (backend) -Rules: -- Web engine in web/src/lib/ — pure TS, no React +## Architecture +- web/src/lib/ — Pure TS engine modules (timer, cascade, urgency, nl-parser, etc.) +- web/src/components/ — React UI components +- ios/ChronoMind/Shared/ — Shared Swift code (iOS + Watch + Mac + Widgets) +- android/app/.../engine/ — Pure Kotlin engine +- backend/ — Fastify 5 + TypeScript backend (port 4011) + +## Rules +- Web engine logic in web/src/lib/ — pure TS, no React imports - Components in web/src/components/ — React UI only -- iOS shared in ios/ChronoMind/Shared/ -- Android engine in android/.../engine/ — pure Kotlin -- Theme: --cm-* CSS props (web), ChronoMindTheme (native) -- Commits: type(scope): description -- Build web with --webpack flag -- Never console.log, never hardcode colors/URLs +- iOS shared logic in ios/ChronoMind/Shared/ — consumed by all Apple targets +- Android engine in android/.../engine/ — pure Kotlin, no Android framework deps +- Web build: must use --webpack flag (Serwist incompatible with Turbopack) - Every Cosmos doc: productId: "chronomind" +- Theme: --cm-* CSS custom properties (web), ChronoMindTheme (native) +- Commits: feat(scope): description / fix(scope): description +- Never delete existing comments/documentation unless asked +- Never add emojis unless asked +- Never hardcode secrets, colors, or API URLs + +## Build Verification +- cd web && npm test && npm run typecheck && npm run build + +## Key Documents +- AGENTS.md — Full AI agent instructions (read this first) diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..4a7ea30 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,12 @@ +root = true + +[*] +indent_style = space +indent_size = 2 +end_of_line = lf +charset = utf-8 +trim_trailing_whitespace = true +insert_final_newline = true + +[*.md] +trim_trailing_whitespace = false diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 0000000..f06b76a --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1,40 @@ +# GitHub Copilot Instructions — ChronoMind + +> For full agent instructions, read [`AGENTS.md`](../AGENTS.md) at the repo root. + +## Project Context + +**ChronoMind** — AI-Powered Contextual Clock & Timer. +Stack: Next.js 16 (web) + SwiftUI (iOS/Watch/Mac) + Jetpack Compose (Android) + Fastify 5 (backend) + +## Code Generation Rules + +### Always +- Web engine logic in web/src/lib/ — pure TS, no React imports +- Components in web/src/components/ — React UI only +- iOS shared logic in ios/ChronoMind/Shared/ — consumed by all Apple targets +- Android engine in android/.../engine/ — pure Kotlin, no Android framework deps +- Web build: must use --webpack flag (Serwist incompatible with Turbopack) +- Every Cosmos doc: productId: "chronomind" +- Theme: --cm-* CSS custom properties (web), ChronoMindTheme (native) +- Include `productId: "chronomind"` in every Cosmos DB document +- Use `type(scope): description` commit message format +- Fix source code, not tests (unless the test itself is wrong) + +### Never +- `console.log` or `print()` in production code +- Hardcoded secrets, API keys, colors, or URLs +- Delete existing comments or documentation unless explicitly asked +- Add emojis unless asked + +## Key Paths +- web/src/lib/ — Pure TS engine modules (timer, cascade, urgency, nl-parser, etc.) +- web/src/components/ — React UI components +- ios/ChronoMind/Shared/ — Shared Swift code (iOS + Watch + Mac + Widgets) +- android/app/.../engine/ — Pure Kotlin engine +- backend/ — Fastify 5 + TypeScript backend (port 4011) + +## Build Verification +```bash +cd web && npm test && npm run typecheck && npm run build +``` diff --git a/.windsurfrules b/.windsurfrules index 1576837..d6c0b18 100644 --- a/.windsurfrules +++ b/.windsurfrules @@ -2,36 +2,24 @@ # Read AGENTS.md for full context. These are the critical rules. Project: ChronoMind — AI-Powered Contextual Clock & Timer -Stack: Next.js 16 (web) + SwiftUI (iOS/Watch/Mac) + Jetpack Compose (Android) + Platform-service (Fastify 5) +Stack: Next.js 16 (web) + SwiftUI (iOS/Watch/Mac) + Jetpack Compose (Android) + Fastify 5 (backend) ## Architecture Rules +- web/src/lib/ — Pure TS engine modules (timer, cascade, urgency, nl-parser, etc.) +- web/src/components/ — React UI components +- ios/ChronoMind/Shared/ — Shared Swift code (iOS + Watch + Mac + Widgets) +- android/app/.../engine/ — Pure Kotlin engine +- backend/ — Fastify 5 + TypeScript backend (port 4011) + +## Conventions - Web engine logic in web/src/lib/ — pure TS, no React imports - Components in web/src/components/ — React UI only - iOS shared logic in ios/ChronoMind/Shared/ — consumed by all Apple targets -- Android engine in android/app/.../engine/ — pure Kotlin, no Android framework deps -- Backend: platform-service in sibling repo learning_ai_common_plat (port 4003) -- Product ID: chronomind — every Cosmos document MUST include productId field - -## Key Paths -- Web: web/src/ (Next.js 16, App Router) -- iOS: ios/ChronoMind/ (SwiftUI, iOS 17+) -- Watch: ios/ChronoMindWatch/ (watchOS 10+) -- Mac: ios/ChronoMindMac/ (macOS 14+) -- Widgets: ios/ChronoMindWidgets/ (WidgetKit) -- Android: android/app/src/main/java/com/chronomind/app/ -- Wear OS: android/wear/ -- Docs: docs/ (PRD.md, roadmap.md, INDUSTRY_RESEARCH.md) -- Backend modules: ../learning_ai_common_plat/services/platform-service/src/modules/{timers,routines,households,shared-timers}/ - -## Conventions -- Theme tokens: --cm-* CSS custom properties (web), ChronoMindTheme (native) -- Commits: feat(scope): description / fix(scope): description +- Android engine in android/.../engine/ — pure Kotlin, no Android framework deps - Web build: must use --webpack flag (Serwist incompatible with Turbopack) -- Never use console.log — use analytics.ts stub or req.log in Fastify -- Never hardcode colors — use theme tokens -- Never hardcode API URLs — use env vars +- Every Cosmos doc: productId: "chronomind" +- Theme: --cm-* CSS custom properties (web), ChronoMindTheme (native) +- Commits: feat(scope): description / fix(scope): description ## Build Verification -- Web: cd web && npm test && npm run typecheck && npm run build -- iOS: Open ChronoMind.xcodeproj, Cmd+B -- Android: cd android && ./gradlew :app:compileDebugKotlin +- cd web && npm test && npm run typecheck && npm run build