diff --git a/README.md b/README.md index 92f1f8e0..40361170 100644 --- a/README.md +++ b/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`. diff --git a/docs/EASY_SECOND_COMPUTER_SETUP.md b/docs/EASY_SECOND_COMPUTER_SETUP.md index c7da3370..1cba966a 100644 --- a/docs/EASY_SECOND_COMPUTER_SETUP.md +++ b/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: diff --git a/docs/FLOWCHAIN_SECOND_COMPUTER_SETUP.md b/docs/FLOWCHAIN_SECOND_COMPUTER_SETUP.md index 4b034adc..0ded9bb3 100644 --- a/docs/FLOWCHAIN_SECOND_COMPUTER_SETUP.md +++ b/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 diff --git a/docs/FLOWCHAIN_TROUBLESHOOTING.md b/docs/FLOWCHAIN_TROUBLESHOOTING.md index 1b256d4b..cfea5377 100644 --- a/docs/FLOWCHAIN_TROUBLESHOOTING.md +++ b/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`. |