[docs] document private repo second-computer bootstrap

README.md

@@ -32,12 +32,18 @@ This repository contains the FlowMemory V0 foundation: project operating docs, l
 
 ## Start Here
 
-For a second computer or a non-technical local test, use the beginner Windows
-installer. It installs missing tools, clones the repo, installs dependencies,
-runs the local setup, and opens the local control plane and dashboard:
+For a second computer or a non-technical local test, use the private-repo
+Windows bootstrap path. It installs Git and GitHub CLI, signs into GitHub,
+clones the repo, then runs the beginner installer:
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command '$p=Join-Path $env:TEMP "INSTALL_FLOWCHAIN_WINDOWS.ps1"; Invoke-WebRequest "https://raw.githubusercontent.com/FlowmemoryAI/FlowMemory/main/INSTALL_FLOWCHAIN_WINDOWS.ps1" -OutFile $p; & powershell -NoProfile -ExecutionPolicy Bypass -File $p'
+winget install --id Git.Git --exact --source winget --accept-package-agreements --accept-source-agreements
+winget install --id GitHub.cli --exact --source winget --accept-package-agreements --accept-source-agreements
+$env:Path = [Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [Environment]::GetEnvironmentVariable("Path","User")
+gh auth login
+gh repo clone FlowmemoryAI/FlowMemory "$env:USERPROFILE\FlowMemory\FlowMemory"
+cd "$env:USERPROFILE\FlowMemory\FlowMemory"
+powershell -ExecutionPolicy Bypass -File .\INSTALL_FLOWCHAIN_WINDOWS.ps1
 ```
 
 Detailed guide: `docs/EASY_SECOND_COMPUTER_SETUP.md`.

docs/EASY_SECOND_COMPUTER_SETUP.md

@@ -20,21 +20,31 @@ The root installer installs or verifies:
 Foundry is installed through Git Bash because Foundry's Windows installer does
 not support PowerShell directly.
 
-## Beginner Setup
+## Beginner Setup For This Private Repo
 
-Open PowerShell and run:
+This repo is private. A clean second computer cannot download the installer
+from the public raw GitHub URL until it has signed into GitHub.
+
+Open PowerShell and run these lines:
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command '$p=Join-Path $env:TEMP "INSTALL_FLOWCHAIN_WINDOWS.ps1"; Invoke-WebRequest "https://raw.githubusercontent.com/FlowmemoryAI/FlowMemory/main/INSTALL_FLOWCHAIN_WINDOWS.ps1" -OutFile $p; & powershell -NoProfile -ExecutionPolicy Bypass -File $p'
+winget install --id Git.Git --exact --source winget --accept-package-agreements --accept-source-agreements
+winget install --id GitHub.cli --exact --source winget --accept-package-agreements --accept-source-agreements
+$env:Path = [Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [Environment]::GetEnvironmentVariable("Path","User")
+gh auth login
+gh repo clone FlowmemoryAI/FlowMemory "$env:USERPROFILE\FlowMemory\FlowMemory"
+cd "$env:USERPROFILE\FlowMemory\FlowMemory"
+powershell -ExecutionPolicy Bypass -File .\INSTALL_FLOWCHAIN_WINDOWS.ps1
 ```
 
+When `gh auth login` asks questions, use GitHub.com, HTTPS, and browser login.
+Windows may ask for permission while tools install. Click **Yes** if prompted.
+
 The installer downloads this repo, installs dependencies, checks prerequisites,
 initializes local state, runs the deterministic local chain demo, runs the smoke
 path, exports a local bundle, runs the bridge mock, and opens the control plane
 and dashboard in separate PowerShell windows.
 
-Windows may ask for permission while tools install. Click **Yes** if prompted.
-
 ## Already Cloned Setup
 
 If the repo is already cloned:

docs/FLOWCHAIN_SECOND_COMPUTER_SETUP.md

@@ -32,16 +32,25 @@ URLs in committed files.
 
 ## Current Merged Setup Path
 
-The beginner setup path is:
+This repo is private, so a clean second computer needs GitHub authentication
+before it can clone the code. The beginner setup path is:
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command '$p=Join-Path $env:TEMP "INSTALL_FLOWCHAIN_WINDOWS.ps1"; Invoke-WebRequest "https://raw.githubusercontent.com/FlowmemoryAI/FlowMemory/main/INSTALL_FLOWCHAIN_WINDOWS.ps1" -OutFile $p; & powershell -NoProfile -ExecutionPolicy Bypass -File $p'
+winget install --id Git.Git --exact --source winget --accept-package-agreements --accept-source-agreements
+winget install --id GitHub.cli --exact --source winget --accept-package-agreements --accept-source-agreements
+$env:Path = [Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [Environment]::GetEnvironmentVariable("Path","User")
+gh auth login
+gh repo clone FlowmemoryAI/FlowMemory "$env:USERPROFILE\FlowMemory\FlowMemory"
+cd "$env:USERPROFILE\FlowMemory\FlowMemory"
+powershell -ExecutionPolicy Bypass -File .\INSTALL_FLOWCHAIN_WINDOWS.ps1
 ```
 
 This installs missing tools, clones or updates the repo, wraps the manual
 commands below, and opens the control plane and workbench in separate
 PowerShell windows.
 
+When `gh auth login` asks questions, use GitHub.com, HTTPS, and browser login.
+
 Use this path today on a clean second computer. It validates the merged V0
 launch-core, no-value local devnet prototype, dashboard workbench, hardware
 simulator fixture, and Windows wrapper layer. It does not yet prove the full

docs/FLOWCHAIN_TROUBLESHOOTING.md

@@ -7,10 +7,17 @@ path from `docs/FLOWCHAIN_SECOND_COMPUTER_SETUP.md`.
 
 ## First Command
 
-On a clean Windows computer, the first command should be the beginner installer:
+On a clean Windows computer, the first path should be the private-repo bootstrap
+commands:
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command '$p=Join-Path $env:TEMP "INSTALL_FLOWCHAIN_WINDOWS.ps1"; Invoke-WebRequest "https://raw.githubusercontent.com/FlowmemoryAI/FlowMemory/main/INSTALL_FLOWCHAIN_WINDOWS.ps1" -OutFile $p; & powershell -NoProfile -ExecutionPolicy Bypass -File $p'
+winget install --id Git.Git --exact --source winget --accept-package-agreements --accept-source-agreements
+winget install --id GitHub.cli --exact --source winget --accept-package-agreements --accept-source-agreements
+$env:Path = [Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [Environment]::GetEnvironmentVariable("Path","User")
+gh auth login
+gh repo clone FlowmemoryAI/FlowMemory "$env:USERPROFILE\FlowMemory\FlowMemory"
+cd "$env:USERPROFILE\FlowMemory\FlowMemory"
+powershell -ExecutionPolicy Bypass -File .\INSTALL_FLOWCHAIN_WINDOWS.ps1
 ```
 
 If the repo is already cloned, run from the repo root:
@@ -41,6 +48,9 @@ or workbench commands.
 | Symptom | Likely cause | Fix |
 | --- | --- | --- |
 | `winget is missing` | Windows App Installer is missing or outdated. | Install or update **App Installer** from the Microsoft Store, then rerun `INSTALL_FLOWCHAIN_WINDOWS.ps1`. |
+| Raw GitHub installer URL returns `404` | The repo is private, so unauthenticated raw GitHub download is blocked. | Use the private-repo bootstrap commands above or sign into GitHub and download the repo ZIP. |
+| `gh` is not recognized | GitHub CLI is missing or PATH is stale after install. | Run the GitHub CLI `winget install` command above, then reopen PowerShell if needed. |
+| `gh repo clone` asks for login | The second computer is not authenticated with GitHub. | Run `gh auth login` and choose GitHub.com, HTTPS, and browser login. |
 | `git was not found on PATH` | Git for Windows is missing or PowerShell was opened before install. | Install Git for Windows, reopen PowerShell, rerun `npm run flowchain:prereq`. |
 | `node` or `npm` missing | Node.js LTS is missing or PATH is stale. | Install Node.js LTS, reopen PowerShell, run `npm install`. |
 | `cargo` or `rustc` missing | Rust toolchain is missing. | Install Rust with rustup, reopen PowerShell, run `cargo test --manifest-path crates/flowmemory-devnet/Cargo.toml`. |