bytelyst/learning_ai_common_plat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(chat-history): refresh WINDSURF archive artifacts (workflows, env audit, repos)

Browse Source
This commit is contained in:
saravanakumardb1 2026-05-29 20:07:00 -07:00
parent 305d3d7eaa
commit 1846201364
6 changed files with 132 additions and 59 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/.last-refresh.log
View File

@ -1,9 +1,9 @@
Last refresh: 2026-05-23T06:00:12Z (2026-05-22 23:00:12 PDT) Last refresh: 2026-05-29T17:09:25Z (2026-05-29 10:09:25 PDT)
Cascade conversations: 50 (438M) Cascade conversations: 50 (502M)
Memories: 137 Memories: 138
Implicit context: 20 Implicit context: 20
Code tracker dirs: 14 Code tracker dirs: 43
File edit history: 5093 entries File edit history: 5395 entries
Workspace storage: 49 workspaces Workspace storage: 52 workspaces
Repo docs: 7 files across 2 repos Repo docs: 7 files across 2 repos
Repo workflows: 56 files across 13 repos Repo workflows: 56 files across 13 repos

3
__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/refresh-chat-history.md
View File

@ -21,8 +21,7 @@ Auto-discovers new repos, updates symlinks, and re-copies docs + workflows.
| `learning_ai_notes` | NoteLett | ✅ | — | | `learning_ai_notes` | NoteLett | ✅ | — |
| `learning_ai_flowmonk` | FlowMonk | ✅ | — | | `learning_ai_flowmonk` | FlowMonk | ✅ | — |
| `learning_ai_trails` | ActionTrail | ✅ | — | | `learning_ai_trails` | ActionTrail | ✅ | — |
| `learning_ai_smart_auth` | SmartAuth | ✅ | — | | `learning_ai_auth_app` | ByteLyst SmartAuth | ✅ | — |
| `learning_ai_auth_app` | ByteLyst Auth | ✅ | — |
| `learning_ai_productivity_web` | Productivity Tools | ✅ | — | | `learning_ai_productivity_web` | Productivity Tools | ✅ | — |
## Steps ## Steps

112
__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/repo_update-agent-docs.md
View File

@ -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 # 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 | ```
| --------------------------------- | ----------------------------------------------- | learning_ai_common_plat/AI.dev/SKILLS/
| `AGENTS.md` | Universal (OpenAI Codex, Claude, Copilot, etc.) | ├── agent-behavior-guidelines.md ← SINGLE source of truth for behavior rules
| `CLAUDE.md` | Claude Code | └── agent-onboarding.md ← Read-order index for agents
| `.cursorrules` | Cursor AI |
| `.github/copilot-instructions.md` | GitHub Copilot | <each repo>/
| `.windsurfrules` | Windsurf / Cascade | ├── AGENTS.md ← Repo-specific only. Auto-prepended with
| `.clinerules` | Cline / Roo Code | │ "Read first" pointer to canonical file.
| `.aider.conf.yml` | Aider | ├── .github/copilot-instructions.md ← Thin pointer (no rules). Auto-generated.
| `.editorconfig` | All editors | ├── .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 ## Steps
1. Run the update script: 1. **Edit the canonical sources** when behavior rules change:
```bash
# ecosystem-wide agent behavior (Karpathy + ByteLyst)
open learning_ai_common_plat/AI.dev/SKILLS/agent-behavior-guidelines.md
# read-order index
open learning_ai_common_plat/AI.dev/SKILLS/agent-onboarding.md
```
These are referenced (not copied) by every repo's AGENTS.md, so changes
take effect immediately — no regeneration needed when only behavior rules change.
2. **Run the generator** to delete legacy files / refresh pointers / sync configs:
```bash ```bash
cd /Users/sd9235/code/mygh/learning_ai_common_plat cd /Users/sd9235/code/mygh/learning_ai_common_plat
./scripts/update-agent-docs.sh ./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
``` ```
The script reads `learning_ai_common_plat/.windsurf/workflows/repos.txt` as the canonical list of managed workspace repositories. Reads `learning_ai_common_plat/.windsurf/workflows/repos.txt` as the
canonical list of managed repos.
2. Review changes per repo: 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 ```bash
while IFS= read -r repo; do while IFS= read -r repo; do
[[ -z "$repo" || "$repo" =~ ^# ]] && continue [[ -z "$repo" || "$repo" =~ ^# ]] && continue
cd /Users/sd9235/code/mygh/$repo && git diff --stat 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 done < /Users/sd9235/code/mygh/learning_ai_common_plat/.windsurf/workflows/repos.txt
``` ```
3. Commit changes (if any): 5. **Push (when ready)**:
```bash ```bash
cd /Users/sd9235/code/mygh/learning_voice_ai_agent while IFS= read -r repo; do
[ -n "$(git status --porcelain)" ] && git add -A && git commit -m "chore(docs): update agent configuration files" [[ -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 `<!-- BEGIN: canonical-behavior-pointer -->`
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 ## Notes
- The script scans each repo's structure and regenerates docs based on current state - Safe to run repeatedly (idempotent).
- Only commits if there are actual changes - Only commits when actual changes exist in the repo.
- Safe to run repeatedly (idempotent) - The script never touches the body of AGENTS.md outside the marker block.
- Requires `learning_ai_common_plat` to be the source of truth for templates - 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.

9
__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/repos.txt
View File

@ -19,16 +19,21 @@ learning_ai_trails
learning_ai_local_memory_gpt learning_ai_local_memory_gpt
learning_ai_efforise learning_ai_efforise
learning_ai_local_llms learning_ai_local_llms
learning_ai_talk2obsidian
# --- Auth & identity --- # --- Auth & identity ---
learning_ai_smart_auth
learning_ai_auth_app learning_ai_auth_app
# --- Web & misc --- # --- Web & misc ---
learning_ai_productivity_web learning_ai_productivity_web
# --- OSS (subdirectory repos under oss/) --- # --- 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 oss/learning_ai_claw-cowork
# -- tooling -- # -- tooling --

3
__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/run-code-review.md
View File

@ -46,8 +46,7 @@ All code across the ByteLyst workspace repos:
- learning_ai_peakpulse (PeakPulse) - learning_ai_peakpulse (PeakPulse)
- learning_ai_notes (NoteLett) - learning_ai_notes (NoteLett)
- learning_ai_trails (ActionTrail) - learning_ai_trails (ActionTrail)
- learning_ai_smart_auth (SmartAuth) - learning_ai_auth_app (ByteLyst SmartAuth — companion app + PRD/roadmap)
- learning_ai_auth_app (ByteLyst Auth)
- learning_ai_productivity_web (Productivity Tools) - learning_ai_productivity_web (Productivity Tools)
## Domain Context ## Domain Context

32
__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_efforise/w1-scaffold-and-cleanup.md
View File

@ -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 # 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) 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. `CLAUDE.md` — Claude Code instructions (short version pointing to AGENTS.md) 2. Add this repo to `../learning_ai_common_plat/.windsurf/workflows/repos.txt` if not already present.
3. `.windsurfrules` — Windsurf rules (short version pointing to AGENTS.md) 3. Run `bash ../learning_ai_common_plat/scripts/update-agent-docs.sh`. This will:
4. `.cursorrules` — Cursor rules (short version pointing to AGENTS.md) - Prepend the canonical-behavior-pointer block to `AGENTS.md`
5. `.clinerules` — Cline rules (short version pointing to AGENTS.md) - Generate `.editorconfig`, `.aider.conf.yml`, `.github/copilot-instructions.md`
6. `.aider.conf.yml` — Aider config - Verify no legacy files exist (deletes them if present)
7. `.editorconfig` — Copy from any ecosystem repo 4. Verify with `bash ../learning_ai_common_plat/scripts/check-agent-docs-drift.sh`.
8. `.github/copilot-instructions.md` — GitHub Copilot rules
## Step 3: Create Root Config Files ## 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 ## Step 4: Manus Artifact Cleanup
### 4a. Clean `vite.config.ts` ### 4a. Clean `vite.config.ts`
- Remove `vite-plugin-manus-runtime` plugin - Remove `vite-plugin-manus-runtime` plugin
- Remove `vite-plugin-manus-debug-collector` plugin + all LOG_DIR code - Remove `vite-plugin-manus-debug-collector` plugin + all LOG_DIR code
- Remove `@builder.io/vite-plugin-jsx-loc` plugin - Remove `@builder.io/vite-plugin-jsx-loc` plugin
- Replace `allowedHosts: [".manuspre.computer", ...]` with `allowedHosts: ["localhost"]` - Replace `allowedHosts: [".manuspre.computer", ...]` with `allowedHosts: ["localhost"]`
### 4b. Delete Manus Files ### 4b. Delete Manus Files
- Delete `client/src/components/ManusDialog.tsx` - Delete `client/src/components/ManusDialog.tsx`
- Delete `client/src/components/Map.tsx` (Google Maps boilerplate, 156 lines) - Delete `client/src/components/Map.tsx` (Google Maps boilerplate, 156 lines)
- Delete `client/public/__manus__/` directory (contains `debug-collector.js`) - 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) - Delete `patches/wouter@3.7.1.patch` (evaluate first — remove if not critical)
### 4c. Clean `client/index.html` ### 4c. Clean `client/index.html`
- Remove `VITE_ANALYTICS_ENDPOINT` / `VITE_ANALYTICS_WEBSITE_ID` script references - Remove `VITE_ANALYTICS_ENDPOINT` / `VITE_ANALYTICS_WEBSITE_ID` script references
### 4d. Dependency Cleanup in `package.json` ### 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` - **Upgrade** `typescript` from `5.6.3` → `^5.7.3`
- **Remove:** `streamdown`, `cmdk`, `add` (devDep), `@types/google.maps` (devDep), `next-themes` - **Remove:** `streamdown`, `cmdk`, `add` (devDep), `@types/google.maps` (devDep), `next-themes`
- **Remove:** `express`, `@types/express` (server/ is deleted) - **Remove:** `express`, `@types/express` (server/ is deleted)
- **Remove** Manus vite plugins from devDeps: `vite-plugin-manus-runtime`, `@builder.io/vite-plugin-jsx-loc` - **Remove** Manus vite plugins from devDeps: `vite-plugin-manus-runtime`, `@builder.io/vite-plugin-jsx-loc`
### 4e. Move Files ### 4e. Move Files
- Move `ideas.md` → `docs/ideas.md` - Move `ideas.md` → `docs/ideas.md`
## Step 5: Create README.md ## Step 5: Create README.md
Write a proper README.md with: Write a proper README.md with:
- Product name + description - Product name + description
- Tech stack (Vite + React 19 SPA, Fastify 5 backend planned) - Tech stack (Vite + React 19 SPA, Fastify 5 backend planned)
- Setup instructions (`pnpm install`, `pnpm dev`) - Setup instructions (`pnpm install`, `pnpm dev`)