feat: productize KataSensei P0 beta

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,5 +1,5 @@
 name: Bug report
-description: Report a reproducible KataSensei problem.
+description: Report a reproducible GoMentor problem.
 title: "[Bug]: "
 labels: ["bug"]
 body:
@@ -23,8 +23,8 @@ body:
   - type: input
     id: version
     attributes:
-      label: KataSensei version
-      placeholder: "0.1.0"
+      label: GoMentor version
+      placeholder: "0.2.0-beta.1"
   - type: dropdown
     id: os
     attributes:

.github/PULL_REQUEST_TEMPLATE/p0-beta.md

@@ -0,0 +1,60 @@
+# GoMentor P0 Beta PR
+
+## Summary
+
+-
+
+## Scope
+
+- [ ] Diagnostics / onboarding
+- [ ] KataGo runtime / asset readiness
+- [ ] SGF import and student binding
+- [ ] Fox nickname import and profile reuse
+- [ ] Teacher runtime
+- [ ] Local knowledge cards
+- [ ] Board UI / teacher UI
+- [ ] Packaging / release readiness
+
+## Verification
+
+- [ ] `pnpm install`
+- [ ] `pnpm typecheck`
+- [ ] `pnpm test`
+- [ ] `pnpm build`
+- [ ] `pnpm check`
+- [ ] `node scripts/check_katago_assets.mjs --mode=dev`
+- [ ] `node scripts/p0_beta_acceptance.mjs`
+- [ ] `node scripts/package_artifact_smoke.mjs --mode=dev`
+- [ ] `node scripts/p0_release_candidate_check.mjs --mode=dev`
+- [ ] `node scripts/verify_release_artifacts.mjs --mode=dev`
+
+## Manual QA
+
+- [ ] macOS app launches
+- [ ] macOS app is signed and notarized before public beta
+- [ ] Windows 11 x64 app launches
+- [ ] Windows installer is signed before public beta, or explicitly marked internal/unsigned beta
+- [ ] SGF import works
+- [ ] Fox nickname sync works
+- [ ] Current move analysis works
+- [ ] Full game analysis works
+- [ ] Recent 10 games analysis works
+- [ ] Student profile updates after analysis
+- [ ] Teacher card output is readable
+- [ ] Candidate tooltip works
+- [ ] Key move navigation works
+- [ ] Winrate timeline click/drag works
+- [ ] Visual QA evidence captured
+
+## Release asset status
+
+- [ ] macOS KataGo binary prepared
+- [ ] Windows x64 KataGo binary prepared
+- [ ] Default b18 model prepared
+- [ ] Asset checksums recorded
+- [ ] Release package smoke test passed
+- [ ] No Windows ARM64 artifact is generated or uploaded for P0 beta
+
+## Risk / Notes
+
+-

.github/workflows/p0-release-candidate.yml

@@ -0,0 +1,92 @@
+name: P0 Release Candidate
+
+on:
+  pull_request:
+    branches:
+      - main
+      - develop
+  push:
+    branches:
+      - feature/p0-productization
+  workflow_dispatch:
+    inputs:
+      mode:
+        description: "Readiness mode"
+        required: true
+        default: "dev"
+        type: choice
+        options:
+          - dev
+          - release
+
+concurrency:
+  group: p0-rc-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  readiness:
+    name: P0 RC readiness (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - macos-latest
+          - windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.30.3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Typecheck
+        run: pnpm typecheck
+
+      - name: Test
+        run: pnpm test
+
+      - name: Build
+        run: pnpm build
+
+      - name: Project check
+        run: pnpm check
+
+      - name: KataGo assets check
+        run: node scripts/check_katago_assets.mjs --mode=${{ inputs.mode || 'dev' }}
+
+      - name: P0 beta acceptance
+        run: node scripts/p0_beta_acceptance.mjs
+
+      - name: Package artifact smoke
+        run: node scripts/package_artifact_smoke.mjs --mode=dev
+
+      - name: P0 release candidate check
+        run: node scripts/p0_release_candidate_check.mjs --mode=${{ inputs.mode || 'dev' }}
+
+      - name: Verify release artifacts
+        run: node scripts/verify_release_artifacts.mjs --mode=dev
+
+      - name: Collect release evidence
+        if: always()
+        run: node scripts/collect_release_evidence.mjs --mode=dev
+
+      - name: Upload release evidence
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-evidence-${{ matrix.os }}
+          path: release-evidence/**
+          if-no-files-found: ignore

.github/workflows/release.yml

@@ -14,8 +14,33 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
+  release-preflight:
+    name: Release preflight
+    runs-on: ubuntu-latest
+    outputs:
+      can-package: ${{ steps.katago-assets.outputs.can-package }}
+
+    steps:
+      - name: Check KataGo asset sources
+        id: katago-assets
+        shell: bash
+        env:
+          GOMENTOR_KATAGO_ASSET_DIR: ${{ secrets.GOMENTOR_KATAGO_ASSET_DIR }}
+          GOMENTOR_KATAGO_BINARY: ${{ secrets.GOMENTOR_KATAGO_BINARY }}
+          GOMENTOR_KATAGO_MODEL: ${{ secrets.GOMENTOR_KATAGO_MODEL }}
+        run: |
+          if [[ -n "${GOMENTOR_KATAGO_ASSET_DIR}" || ( -n "${GOMENTOR_KATAGO_BINARY}" && -n "${GOMENTOR_KATAGO_MODEL}" ) ]]; then
+            echo "can-package=true" >> "${GITHUB_OUTPUT}"
+            echo "KataGo release asset source is configured."
+          else
+            echo "can-package=false" >> "${GITHUB_OUTPUT}"
+            echo "::notice title=Release packaging skipped::KataGo release assets are not configured. Set GOMENTOR_KATAGO_ASSET_DIR or both GOMENTOR_KATAGO_BINARY and GOMENTOR_KATAGO_MODEL to enable automated packaging."
+          fi
+
   package:
     name: Package ${{ matrix.name }}
+    needs: release-preflight
+    if: needs.release-preflight.outputs.can-package == 'true'
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
@@ -27,9 +52,6 @@ jobs:
           - name: Windows
             os: windows-latest
             command: pnpm dist:win
-          - name: Linux
-            os: ubuntu-latest
-            command: pnpm dist:linux
 
     steps:
       - name: Checkout
@@ -58,15 +80,36 @@ jobs:
       - name: Typecheck
         run: pnpm typecheck
 
+      - name: Prepare KataGo assets
+        shell: bash
+        env:
+          GOMENTOR_KATAGO_ASSET_DIR: ${{ secrets.GOMENTOR_KATAGO_ASSET_DIR }}
+          GOMENTOR_KATAGO_BINARY: ${{ secrets.GOMENTOR_KATAGO_BINARY }}
+          GOMENTOR_KATAGO_MODEL: ${{ secrets.GOMENTOR_KATAGO_MODEL }}
+        run: |
+          node scripts/prepare_katago_assets.mjs
+          node scripts/check_katago_assets.mjs --mode=release
+
       - name: Package desktop app
         env:
-          CSC_IDENTITY_AUTO_DISCOVERY: "false"
+          CSC_LINK: ${{ secrets.CSC_LINK }}
+          CSC_KEY_PASSWORD: ${{ secrets.CSC_KEY_PASSWORD }}
+          WIN_CSC_LINK: ${{ secrets.WIN_CSC_LINK }}
+          WIN_CSC_KEY_PASSWORD: ${{ secrets.WIN_CSC_KEY_PASSWORD }}
+          APPLE_API_KEY: ${{ secrets.APPLE_API_KEY }}
+          APPLE_API_KEY_ID: ${{ secrets.APPLE_API_KEY_ID }}
+          APPLE_API_ISSUER: ${{ secrets.APPLE_API_ISSUER }}
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+          APPLE_KEYCHAIN: ${{ secrets.APPLE_KEYCHAIN }}
+          APPLE_KEYCHAIN_PROFILE: ${{ secrets.APPLE_KEYCHAIN_PROFILE }}
         run: ${{ matrix.command }}
 
       - name: Upload packaged artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: katasensei-${{ matrix.name }}
+          name: GoMentor-${{ matrix.name }}
           path: |
             release/**/*.AppImage
             release/**/*.deb
@@ -79,9 +122,11 @@ jobs:
 
   github-release:
     name: Publish GitHub Release
-    needs: package
+    needs:
+      - release-preflight
+      - package
     runs-on: ubuntu-latest
-    if: startsWith(github.ref, 'refs/tags/')
+    if: needs.release-preflight.outputs.can-package == 'true' && startsWith(github.ref, 'refs/tags/')
 
     steps:
       - name: Download artifacts

.gitignore

@@ -4,10 +4,12 @@ dist
 release
 .DS_Store
 *.log
-.katasensei
+.gomentor
 __pycache__
 *.pyc
 coverage
+release-evidence
+.playwright-cli
 
 *.tsbuildinfo
 

CHANGELOG.md

@@ -1,10 +1,10 @@
 # Changelog
 
-All notable changes to KataSensei will be documented here.
+All notable changes to GoMentor will be documented here.
 
 This project follows semantic versioning once public releases begin.
 
-## 0.1.0 - Unreleased
+## 0.2.0-beta.1 - P0 Beta Candidate
 
 ### Added
 
@@ -22,10 +22,19 @@ This project follows semantic versioning once public releases begin.
 - Markdown and JSON report output.
 - Cross-platform CI for macOS, Windows, and Linux.
 - GitHub Release workflow for macOS, Windows, and Linux artifacts.
+- P0 release readiness checks for automation, assets, installers, signing, Windows smoke, and visual QA.
+- Local release evidence collection under `release-evidence/`.
 
 ### Fixed
 
 - GPT/reasoning model response parsing when no plain `content` field is returned.
 - Fox-style SGF komi values such as `KM[375]`.
 - SGF parser incorrectly reading comments and variations as mainline moves.
 - Board and winrate graph layout overlap in the center workspace.
+
+### Known Issues
+
+- Windows ARM64 is not supported in the P0 beta because the bundled KataGo manifest only supports Windows x64.
+- macOS public distribution requires Developer ID signing and notarization before tagging.
+- Windows public distribution should use an EV/OV certificate or Microsoft Trusted Signing; unsigned installers are internal beta only.
+- Windows 11 x64 real-machine smoke and visual QA evidence are required before creating `v0.2.0-beta.1`.

CONTRIBUTING.md

@@ -1,6 +1,6 @@
-# Contributing to KataSensei
+# Contributing to GoMentor
 
-Thanks for helping build KataSensei. This project sits at the intersection of Go education, local desktop engineering, KataGo analysis, and LLM agent design, so changes should be careful and grounded.
+Thanks for helping build GoMentor. This project sits at the intersection of Go education, local desktop engineering, KataGo analysis, and LLM agent design, so changes should be careful and grounded.
 
 ## Development Setup
 
@@ -59,7 +59,7 @@ When adding a tool:
 - TypeScript for Electron and React code.
 - Keep IPC boundaries explicit and typed in `src/main/lib/types.ts`.
 - Prefer structured SGF/KataGo parsing over string heuristics.
-- Keep local file access inside KataSensei-managed directories unless the user explicitly chooses files.
+- Keep local file access inside GoMentor-managed directories unless the user explicitly chooses files.
 
 ## Release Process