Skip to content

chore: setup workspace governance, docs, and fix webview test OOM - #1

Merged
hacker-b2k merged 2 commits into
mainfrom
chore/setup-workspace-governance
Jun 24, 2026
Merged

chore: setup workspace governance, docs, and fix webview test OOM#1
hacker-b2k merged 2 commits into
mainfrom
chore/setup-workspace-governance

Conversation

@hacker-b2k

Copy link
Copy Markdown
Owner

Summary

This PR establishes professional development standards for Zoo Code and fixes a build environment issue on Windows.

Changes

Fix (1 file)

  • webview-ui/vitest.config.ts: Increase vitest heap memory (--max-old-space-size=4096) using forks pool to prevent OOM crashes on Windows during webview test suite execution

Documentation (11 files)

  • WORKSPACE_GOVERNANCE.md: Absolute rules, tech stack, build commands, branch strategy, commit conventions
  • PLANNING_REQUIRED.md: Mandatory 5-stage pipeline (Research → Design → Plan → Review → Execute)
  • docs/README.md: Master index with golden workflow and core principles
  • docs/ARCHITECTURE.md: Deep technical reference (monorepo build order, task execution, key classes, IPC protocol, AI providers, state management)
  • docs/REQUIREMENTS.md: Standing/project requirements and Definition of Done checklist
  • docs/DEV_SETUP.md: Zero-to-running setup guide
  • docs/research/README.md: Research log template
  • docs/plans/README.md: Implementation plan template
  • docs/decisions/: Architecture Decision Records (ADR-001, ADR-002, ADR-003)

Verification

  • check-types: 11/11 ✅
  • build: 4/4 ✅
  • lint: 11/11 ✅
  • test: 404 files, 6427 passed, 0 failed ✅
  • .vsix packaged: 33.03 MB, 1899 files ✅

CodeKing added 2 commits June 24, 2026 08:09
Set vitest pool to 'forks' with --max-old-space-size=4096 to fix
JavaScript heap out of memory errors when running webview test suite
on Windows. The default worker pool (threads) was causing node to
exceed its available memory under the large test suite.

Refs: Zoo-Code-Org#443 (Vitest 4 upgrade)
…re documentation

Establishes professional development standards for the Zoo Code project:

- WORKSPACE_GOVERNANCE.md: Absolute rules, tech stack, build commands,
  branch strategy, and commit message conventions
- PLANNING_REQUIRED.md: Mandatory 5-stage pipeline (Research → Design →
  Plan → Review → Execute) before any code change
- docs/README.md: Master index with golden workflow and core principles
- docs/ARCHITECTURE.md: Deep technical reference — monorepo build order,
  task execution, key classes, IPC protocol, AI providers, state mgmt
- docs/REQUIREMENTS.md: Standing/project requirements and DoD checklist
- docs/DEV_SETUP.md: Zero-to-running setup guide
- docs/research/: Research log template
- docs/plans/: Implementation plan template
- docs/decisions/: Architecture Decision Records (ADRs 1-3)
  - ADR-001: SettingsView cached state pattern
  - ADR-002: Monorepo with Turborepo
  - ADR-003: types package build first
@hacker-b2k
hacker-b2k merged commit b02392b into main Jun 24, 2026
@hacker-b2k
hacker-b2k deleted the chore/setup-workspace-governance branch June 24, 2026 03:45
hacker-b2k pushed a commit that referenced this pull request Jul 31, 2026
…tory, dry_run, batch replace, enhanced rename

Issue #1: search_replace error now shows closest matching text with line number
Issue #2: read_spec mode='headings' returns only heading lines with line numbers
Issue #3: read_spec mode='history' returns revision list; revision=N reads specific version
Issue #4: renameWorkspace enhanced heading patterns (suffix, contains, case-insensitive)
Issue Zoo-Code-Org#5: write_spec dry_run=true previews changes without applying
Issue Zoo-Code-Org#6: write_spec replacements=[] for atomic batch search_replace operations

Files: specMerge.ts, ReadSpecTool.ts, WriteSpecTool.ts, SpecService.ts, read_spec.ts, write_spec.ts
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