# Bootstrap Repos

Status: VERIFIED BY LOCAL SELF-TEST

## Rule

Use one bootstrap command for generated repos.

It performs:

- clean export;
- fresh `git init`;
- `git add .`;
- optional initial commit;
- optional `origin` remote configuration;
- generated repo preflight;
- no network push.

## Public SDK

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\New-H8GeneratedRepo.ps1 `
  -Target public-sdk `
  -DestinationRoot C:\hades\Hecton8_PublicationWorkspace\Hecton8-PublicSDK `
  -TrustedOutputRoot C:\hades\Hecton8_PublicationWorkspace `
  -InitialCommit `
  -Force
```

## Contributor Sandbox

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\New-H8GeneratedRepo.ps1 `
  -Target contributor-sandbox `
  -DestinationRoot C:\hades\Hecton8_PublicationWorkspace\Hecton8-ContribSandbox `
  -TrustedOutputRoot C:\hades\Hecton8_PublicationWorkspace `
  -InitialCommit `
  -Force
```

## Private Slice

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\New-H8GeneratedRepo.ps1 `
  -Target private-slice `
  -DestinationRoot C:\hades\Hecton8_PublicationWorkspace\Hecton8-PrivateSlice `
  -TrustedOutputRoot C:\hades\Hecton8_PublicationWorkspace `
  -InitialCommit `
  -Force
```

## Publish Plan

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\Publish-H8GeneratedRepo.ps1 `
  -Root C:\hades\Hecton8_PublicSDK_Export `
  -Target public-sdk `
  -AllowedRemoteUrl https://github.com/OWNER/Hecton8-PublicSDK.git
```

This validates preflight, requires a configured remote, requires a clean committed
index with no ignored handoff files, targets `main` by default, and prints the
exact push command. `-Push` additionally requires `-AllowedRemoteUrl` so wildcard
repo-name checks cannot send to the wrong remote.