CURRENT-CODE.md

CURRENT-CODE.md

Branch

feature/documentation

Version

v0.11.0

Last session — 2026-03-22

• Completed all 12 documentation feature tasks (TASKS.md)
• Task 2: Updated aliases and configs after engine move to D:\purlshq-dev\scaffolder-engine
  • Fixed ~/.scaffolder-config.json defaultDrive
  • Deduplicated harley alias in ~/.bashrc
  • Fixed execSync(“harley”) → execSync(“claude”) in src/sc.ts
  • Updated .claude/settings.json and settings.local.json paths
• Task 3: Initialized Starlight site at D:\purlshq-dev\projects-purlshq-com
• Task 4: Created GitHub repo purlshq/projects-purlshq-com (private), pushed to main
  • Fixed email privacy issue (rewrote commits to use GitHub noreply email)
  • Set git config user.email for doc site repo
• Task 5: Moved docs/ (60 files) from engine project to doc site repo
• Task 6: Moved ai-sessions/ (23 files) to doc site repo
  • CURRENT-CODE.md and CURRENT-CHAT.md recreated (lost during engine move, never tracked)
• Task 7: Added Starlight frontmatter to all 80 markdown files
• Task 8: Created project.json for scaffolder
• Task 9: Rewrote all reference files to use {config_key} notation
  • Engine root: CLAUDE.md, PROJECT-INSTRUCTIONS.md, TECH-STACK.md, INSTALLED-MCP.md
  • _system/CHAT-REFERENCE.md: full rewrite with config resolution section
  • Project: CLAUDE.md, settings.json, session-end skill
  • Zero literal old paths remain anywhere
• Task 10: Cloudflare Pages connected (operator)
• Task 11: Cloudflare Access configured (operator)
• Task 12: Final verification — all checks pass, site live at projects.purlshq.com
• Committed fix/repo-cleanup path fixes (separate branch, merged via PR #353)
• Created PR #355 feature/documentation → dev (merged by operator)
• Pushed doc site repo to main, confirmed auto-deploy

What is working

• Starlight site live at projects.purlshq.com behind Cloudflare Access
• Auto-deploy on push to main (Cloudflare Pages)
• npm run build succeeds in doc site repo
• sc create —dry-run works from new engine location
• All docs and sessions accessible from doc site repo
• Config resolution: workspace.json → project.json → paths
• Session-end skill resolves paths from workspace.json

What is not working

• Nothing known

Open PRs

• None

Open issues (top)

• #354 — fix: sc start calls harley alias which doesn’t resolve in execSync (bug)
• #352 — fix: stale Plane Integrated reference in STANDARDS.md template (bug)
• #351 — fix: remove tracked ai-sessions files from repo (bug)
• #349 — fix: session-end hook does not generate session state — only commits (bug)
• #338 — feat: automated zip backups via robocopy (enhancement)

Decisions made

• Engine moved from D:\scaffolder-engine to D:\purlshq-dev\scaffolder-engine
• docs/ and ai-sessions/ now live in projects-purlshq-com repo, not engine project
• All reference files use {config_key} notation — workspace.json is the single source of truth
• Session-end hook targets doc site repo, not engine project
• GitHub noreply email (44074021+purlshq@users.noreply.github.com) required for pushes

Next steps

• Close issues #351, #352, #354 (fixes already shipped in fix/repo-cleanup and feature/documentation)
• #349 can be closed (session-end skill replaces the broken hook approach)
• Address #338 (automated zip backups) and #330 (eliminate Chat AI reliance on static Project Instructions)
• Start next feature cycle

Watch out for

• Issues #351, #352, #354 are already fixed but not yet closed on GitHub
• #349 is resolved by the session-end skill but issue is still open
• Doc site repo requires noreply email for all commits (email privacy enabled)
• settings.local.json is tracked and reverts to dev version on branch switch — re-apply path fixes if needed
• Operator root files (CLAUDE.md, PROJECT-INSTRUCTIONS.md, etc.) are gitignored — changes are local only