From 18462013648b45622a6069048b10179b8c85e76d Mon Sep 17 00:00:00 2001 From: saravanakumardb1 Date: Fri, 29 May 2026 20:07:00 -0700 Subject: [PATCH] chore(chat-history): refresh WINDSURF archive artifacts (workflows, env audit, repos) --- .../WINDSURF/.last-refresh.log | 12 +- .../refresh-chat-history.md | 3 +- .../repo_update-agent-docs.md | 132 +++++++++++++----- .../learning_ai_common_plat/repos.txt | 9 +- .../run-code-review.md | 3 +- .../w1-scaffold-and-cleanup.md | 32 +++-- 6 files changed, 132 insertions(+), 59 deletions(-) diff --git a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/.last-refresh.log b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/.last-refresh.log index 00464809..182ab371 100644 --- a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/.last-refresh.log +++ b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/.last-refresh.log @@ -1,9 +1,9 @@ -Last refresh: 2026-05-23T06:00:12Z (2026-05-22 23:00:12 PDT) -Cascade conversations: 50 (438M) -Memories: 137 +Last refresh: 2026-05-29T17:09:25Z (2026-05-29 10:09:25 PDT) +Cascade conversations: 50 (502M) +Memories: 138 Implicit context: 20 -Code tracker dirs: 14 -File edit history: 5093 entries -Workspace storage: 49 workspaces +Code tracker dirs: 43 +File edit history: 5395 entries +Workspace storage: 52 workspaces Repo docs: 7 files across 2 repos Repo workflows: 56 files across 13 repos diff --git a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/refresh-chat-history.md b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/refresh-chat-history.md index 37bacaca..af70448d 100644 --- a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/refresh-chat-history.md +++ b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/refresh-chat-history.md @@ -21,8 +21,7 @@ Auto-discovers new repos, updates symlinks, and re-copies docs + workflows. | `learning_ai_notes` | NoteLett | ✅ | — | | `learning_ai_flowmonk` | FlowMonk | ✅ | — | | `learning_ai_trails` | ActionTrail | ✅ | — | -| `learning_ai_smart_auth` | SmartAuth | ✅ | — | -| `learning_ai_auth_app` | ByteLyst Auth | ✅ | — | +| `learning_ai_auth_app` | ByteLyst SmartAuth | ✅ | — | | `learning_ai_productivity_web` | Productivity Tools | ✅ | — | ## Steps diff --git a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/repo_update-agent-docs.md b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/repo_update-agent-docs.md index 4d9dde76..32fbf807 100644 --- a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/repo_update-agent-docs.md +++ b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/repo_update-agent-docs.md @@ -1,54 +1,116 @@ --- -description: Regenerate AI agent docs (AGENTS.md, CLAUDE.md, .cursorrules, etc.) across all repos +description: Regenerate AI agent docs across all repos (single source of truth pattern) --- # Update Agent Docs Across Workspace -Regenerates all 8 AI agent configuration files across all repos in the workspace. +Maintains AI agent docs across the ByteLyst workspace using a +**single source of truth** pattern with **zero duplication**. -## Files Generated Per Repo +## Architecture -| File | Tool | -| --------------------------------- | ----------------------------------------------- | -| `AGENTS.md` | Universal (OpenAI Codex, Claude, Copilot, etc.) | -| `CLAUDE.md` | Claude Code | -| `.cursorrules` | Cursor AI | -| `.github/copilot-instructions.md` | GitHub Copilot | -| `.windsurfrules` | Windsurf / Cascade | -| `.clinerules` | Cline / Roo Code | -| `.aider.conf.yml` | Aider | -| `.editorconfig` | All editors | +``` +learning_ai_common_plat/AI.dev/SKILLS/ +├── agent-behavior-guidelines.md ← SINGLE source of truth for behavior rules +└── agent-onboarding.md ← Read-order index for agents + +/ +├── AGENTS.md ← Repo-specific only. Auto-prepended with +│ "Read first" pointer to canonical file. +├── .github/copilot-instructions.md ← Thin pointer (no rules). Auto-generated. +├── .aider.conf.yml ← Aider config pointing to AGENTS.md. Auto-generated. +└── .editorconfig ← Editor config. Auto-generated. + +DELETED across all repos (content was duplicated AGENTS.md): +├── CLAUDE.md +├── .cursorrules +├── .windsurfrules +└── .clinerules +``` ## Steps -1. Run the update script: +1. **Edit the canonical sources** when behavior rules change: -```bash -cd /Users/sd9235/code/mygh/learning_ai_common_plat -./scripts/update-agent-docs.sh -``` + ```bash + # ecosystem-wide agent behavior (Karpathy + ByteLyst) + open learning_ai_common_plat/AI.dev/SKILLS/agent-behavior-guidelines.md -The script reads `learning_ai_common_plat/.windsurf/workflows/repos.txt` as the canonical list of managed workspace repositories. + # read-order index + open learning_ai_common_plat/AI.dev/SKILLS/agent-onboarding.md + ``` -2. Review changes per repo: + These are referenced (not copied) by every repo's AGENTS.md, so changes + take effect immediately — no regeneration needed when only behavior rules change. -```bash -while IFS= read -r repo; do - [[ -z "$repo" || "$repo" =~ ^# ]] && continue - cd /Users/sd9235/code/mygh/$repo && git diff --stat -done < /Users/sd9235/code/mygh/learning_ai_common_plat/.windsurf/workflows/repos.txt -``` +2. **Run the generator** to delete legacy files / refresh pointers / sync configs: -3. Commit changes (if any): + ```bash + cd /Users/sd9235/code/mygh/learning_ai_common_plat + ./scripts/update-agent-docs.sh --dry-run # preview + ./scripts/update-agent-docs.sh # apply + commit per repo + ./scripts/update-agent-docs.sh --no-commit # apply without committing + ``` -```bash -cd /Users/sd9235/code/mygh/learning_voice_ai_agent -[ -n "$(git status --porcelain)" ] && git add -A && git commit -m "chore(docs): update agent configuration files" -``` + Reads `learning_ai_common_plat/.windsurf/workflows/repos.txt` as the + canonical list of managed repos. + +3. **Verify no drift**: + + ```bash + bash scripts/check-agent-docs-drift.sh + ``` + + Exits 1 if any repo has drifted from the canonical generator output. + Suitable for CI. + +4. **Review changes per repo**: + + ```bash + while IFS= read -r repo; do + [[ -z "$repo" || "$repo" =~ ^# ]] && continue + echo "── $repo ──" + git -C /Users/sd9235/code/mygh/"$repo" log -1 --oneline + done < /Users/sd9235/code/mygh/learning_ai_common_plat/.windsurf/workflows/repos.txt + ``` + +5. **Push (when ready)**: + + ```bash + while IFS= read -r repo; do + [[ -z "$repo" || "$repo" =~ ^# ]] && continue + git -C /Users/sd9235/code/mygh/"$repo" push + done < /Users/sd9235/code/mygh/learning_ai_common_plat/.windsurf/workflows/repos.txt + ``` + +## Files generated per repo + +| File | Type | Tool(s) | +| --------------------------------- | ------- | -------------------------------------- | +| `AGENTS.md` | Hybrid | Codex, Claude, Cursor, Windsurf, Cline | +| `.github/copilot-instructions.md` | Pointer | GitHub Copilot | +| `.aider.conf.yml` | Config | Aider | +| `.editorconfig` | Config | All editors | + +`AGENTS.md` is hybrid: the body is hand-maintained (repo-specific content), +but the generator idempotently prepends a `` +block at the top. The block is the only auto-managed region; everything else +is left alone. + +## Files deleted by the generator + +| File | Reason | +| ---------------- | ------------------------------------------------------------- | +| `CLAUDE.md` | Duplicated AGENTS.md. Claude Code reads AGENTS.md by default. | +| `.cursorrules` | Duplicated AGENTS.md. Cursor reads AGENTS.md. | +| `.windsurfrules` | Duplicated AGENTS.md. Windsurf reads AGENTS.md. | +| `.clinerules` | Duplicated AGENTS.md. Cline reads AGENTS.md. | ## Notes -- The script scans each repo's structure and regenerates docs based on current state -- Only commits if there are actual changes -- Safe to run repeatedly (idempotent) -- Requires `learning_ai_common_plat` to be the source of truth for templates +- Safe to run repeatedly (idempotent). +- Only commits when actual changes exist in the repo. +- The script never touches the body of AGENTS.md outside the marker block. +- For workspaces that include `learning_ai_common_plat` as a sibling + (default for Windsurf/Cascade), the canonical guidelines file resolves + via the relative path written into each AGENTS.md pointer. diff --git a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/repos.txt b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/repos.txt index e7e4e11a..9cfdce98 100644 --- a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/repos.txt +++ b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/repos.txt @@ -19,16 +19,21 @@ learning_ai_trails learning_ai_local_memory_gpt learning_ai_efforise learning_ai_local_llms +learning_ai_talk2obsidian # --- Auth & identity --- -learning_ai_smart_auth learning_ai_auth_app # --- Web & misc --- learning_ai_productivity_web # --- OSS (subdirectory repos under oss/) --- -oss/learning_ai_claw-code-oss +# NOTE: oss/learning_ai_claw-code-oss is intentionally OMITTED. It is an +# upstream Anthropic Claude Code OSS clone with its own CLAUDE.md convention +# (auto-generated by Claude Code's bootstrap, not the deprecated ByteLyst +# per-product CLAUDE.md pattern). We do not manage its agent docs; deleting +# CLAUDE.md or forcing the ByteLyst canonical pointer block would diverge +# from upstream alignment for no benefit. oss/learning_ai_claw-cowork # -- tooling -- diff --git a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/run-code-review.md b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/run-code-review.md index 6631b2d3..08f44af8 100644 --- a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/run-code-review.md +++ b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/run-code-review.md @@ -46,8 +46,7 @@ All code across the ByteLyst workspace repos: - learning_ai_peakpulse (PeakPulse) - learning_ai_notes (NoteLett) - learning_ai_trails (ActionTrail) - - learning_ai_smart_auth (SmartAuth) - - learning_ai_auth_app (ByteLyst Auth) + - learning_ai_auth_app (ByteLyst SmartAuth — companion app + PRD/roadmap) - learning_ai_productivity_web (Productivity Tools) ## Domain Context diff --git a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_efforise/w1-scaffold-and-cleanup.md b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_efforise/w1-scaffold-and-cleanup.md index e816a6ae..8c1fde26 100644 --- a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_efforise/w1-scaffold-and-cleanup.md +++ b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_efforise/w1-scaffold-and-cleanup.md @@ -1,5 +1,5 @@ --- -description: "Window 1: Phase 0 scaffolding + Manus cleanup (RUN FIRST — other windows depend on this)" +description: 'Window 1: Phase 0 scaffolding + Manus cleanup (RUN FIRST — other windows depend on this)' --- # Window 1: Phase 0 Scaffolding + Manus Cleanup @@ -38,18 +38,20 @@ Create `shared/product.json` following the ecosystem pattern. Use NoteLett (`../ } ``` -## Step 2: Create Agent Config Files (8 files) +## Step 2: Create Agent Config Files (single-source-of-truth pattern) -Create all 8 agent config files matching ecosystem standard. Copy structure from `../learning_ai_notes/` or `../learning_ai_trails/`: +Hand-write `AGENTS.md` only. All other agent files are generated by the +canonical script. Legacy files (`CLAUDE.md`, `.cursorrules`, `.windsurfrules`, +`.clinerules`) are **deprecated** and must NOT be created — they used to +duplicate AGENTS.md content and drifted. -1. `AGENTS.md` — AI agent onboarding guide (customize for efforise: Vite SPA + Fastify backend, productId efforise, port 4020, --er-* tokens) -2. `CLAUDE.md` — Claude Code instructions (short version pointing to AGENTS.md) -3. `.windsurfrules` — Windsurf rules (short version pointing to AGENTS.md) -4. `.cursorrules` — Cursor rules (short version pointing to AGENTS.md) -5. `.clinerules` — Cline rules (short version pointing to AGENTS.md) -6. `.aider.conf.yml` — Aider config -7. `.editorconfig` — Copy from any ecosystem repo -8. `.github/copilot-instructions.md` — GitHub Copilot rules +1. `AGENTS.md` — AI agent onboarding guide (customize for efforise: Vite SPA + Fastify backend, productId efforise, port 4020, --er-\* tokens). Copy structure from `../learning_ai_notes/AGENTS.md` or `../learning_ai_trails/AGENTS.md`. +2. Add this repo to `../learning_ai_common_plat/.windsurf/workflows/repos.txt` if not already present. +3. Run `bash ../learning_ai_common_plat/scripts/update-agent-docs.sh`. This will: + - Prepend the canonical-behavior-pointer block to `AGENTS.md` + - Generate `.editorconfig`, `.aider.conf.yml`, `.github/copilot-instructions.md` + - Verify no legacy files exist (deletes them if present) +4. Verify with `bash ../learning_ai_common_plat/scripts/check-agent-docs-drift.sh`. ## Step 3: Create Root Config Files @@ -70,12 +72,14 @@ Create all 8 agent config files matching ecosystem standard. Copy structure from ## Step 4: Manus Artifact Cleanup ### 4a. Clean `vite.config.ts` + - Remove `vite-plugin-manus-runtime` plugin - Remove `vite-plugin-manus-debug-collector` plugin + all LOG_DIR code - Remove `@builder.io/vite-plugin-jsx-loc` plugin - Replace `allowedHosts: [".manuspre.computer", ...]` with `allowedHosts: ["localhost"]` ### 4b. Delete Manus Files + - Delete `client/src/components/ManusDialog.tsx` - Delete `client/src/components/Map.tsx` (Google Maps boilerplate, 156 lines) - Delete `client/public/__manus__/` directory (contains `debug-collector.js`) @@ -86,21 +90,25 @@ Create all 8 agent config files matching ecosystem standard. Copy structure from - Delete `patches/wouter@3.7.1.patch` (evaluate first — remove if not critical) ### 4c. Clean `client/index.html` + - Remove `VITE_ANALYTICS_ENDPOINT` / `VITE_ANALYTICS_WEBSITE_ID` script references ### 4d. Dependency Cleanup in `package.json` -- **Downgrade** `zod` from `^4.1.12` → `^3.24.2` (CRITICAL — Zod 4 breaks @bytelyst/* integration) + +- **Downgrade** `zod` from `^4.1.12` → `^3.24.2` (CRITICAL — Zod 4 breaks @bytelyst/\* integration) - **Upgrade** `typescript` from `5.6.3` → `^5.7.3` - **Remove:** `streamdown`, `cmdk`, `add` (devDep), `@types/google.maps` (devDep), `next-themes` - **Remove:** `express`, `@types/express` (server/ is deleted) - **Remove** Manus vite plugins from devDeps: `vite-plugin-manus-runtime`, `@builder.io/vite-plugin-jsx-loc` ### 4e. Move Files + - Move `ideas.md` → `docs/ideas.md` ## Step 5: Create README.md Write a proper README.md with: + - Product name + description - Tech stack (Vite + React 19 SPA, Fastify 5 backend planned) - Setup instructions (`pnpm install`, `pnpm dev`)