Skip to content

docs: update CLAUDE.md for the super-app + signed-desktop reality#267

Open
vakovalskii wants to merge 1 commit into
mainfrom
docs/claude-md-superapp
Open

docs: update CLAUDE.md for the super-app + signed-desktop reality#267
vakovalskii wants to merge 1 commit into
mainfrom
docs/claude-md-superapp

Conversation

@vakovalskii

Copy link
Copy Markdown
Owner

Ports the important changes from this release cycle into the project guide so the next agent picks up the current reality instead of the pre-signing one.

What changed in CLAUDE.md

  • Framing — codbash is now a super-app (Overview landing + in-browser Workspace/Terminal) shipping in two channels from one codebase: npm CLI and a signed + notarized macOS desktop app. Latest: 7.14.7.
  • Source map — added terminal.js, workspace-layouts.js, workspace-commands.js, shell-path.js, agents-detect.js, projects.js, the overview/workspace/calendar frontend, and the desktop/ Electron shell + preload IPC.
  • Architecture decisions — crash-safe route dispatch, prototype-safe findSessionFile, thin desktop shell (server stays desktop-agnostic; capabilities via window.codbashDesktop), view-aware chrome (body[data-view]), running-agents tree from activeSessions, full-pane layout round-trip (cmd/prefill/cwd), no window.prompt in Electron.
  • API routes — browser-terminal WS, workspace layouts/commands, projects launcher, and the auth/cloud/github/leaderboard groups.
  • Publishing — npm publish is now manual (workflow_dispatch); added the signed-DMG runbook pointer with the codesign timestamp/proxy gotcha (build over VPN, env -u HTTPS_PROXY …, --arm64 --x64, staple + regenerate latest-mac.yml). No Apple/npm secrets in the repo — keychain profile codbash-notary only.
  • Versioning — examples bumped from 6.x to 7.x.

Docs-only; full suite green (201 pass, 2 skipped).

🤖 Generated with Claude Code

Bring the project guide in line with this release cycle:
- super-app framing (Overview landing + in-browser Workspace/Terminal) and
  two-channel shipping (npm CLI + signed/notarized macOS DMG)
- current source map (terminal.js, workspace-layouts/commands.js, shell-path.js,
  overview/workspace/calendar frontend, desktop/ shell + preload IPC)
- architecture decisions: crash-safe route dispatch, prototype-safe
  findSessionFile, thin desktop shell, view-aware chrome, running-agents tree
  from activeSessions, full-pane layout round-trip, no window.prompt in Electron
- new API/WS route groups (browser terminal, workspace layouts/commands, projects)
- Publishing: manual npm workflow_dispatch + signed-DMG runbook with the
  codesign timestamp/proxy gotcha; versioning examples bumped to 7.x

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant