Prepare Base v1.0.2 release

## Summary

- Move the current changelog entries from `Unreleased` into `1.0.2`
dated 2026-06-16.
- Update `VERSION`, README release examples/badge/status text, and AI
context release metadata to `1.0.2`.
- Keep issue #751 open for the post-merge publish and Homebrew tap
handoff steps.

## Release Notes Preview

### Added

- `basectl repo clone` for workspace-aware GitHub checkout.
- `--pr` support for generated repo helper files.
- `basectl workspace clone --manifest <path>`.
- Generated Project intake workflow support.
- Explicit uv-managed Python project support.

### Changed

- `basectl update` can now target an optional project name.

### Fixed

- `basectl gh` avoids false failures when `gh auth status` is
transiently unavailable.

## Validation

- `git diff --check`
- `env -u BASE_HOME ./bin/base-test`
- `BASE_CACHE_DIR=/private/tmp/base-release-cache basectl release check
--version 1.0.2`
- `BASE_CACHE_DIR=/private/tmp/base-release-cache basectl release notes
--version 1.0.2`

Refs #751

Author: codeforester

.ai-context/PROJECT.md

@@ -4,7 +4,7 @@
 
 - Name: Base
 - Repository: `github.com/codeforester/base`
-- Current release: `1.0.1`
+- Current release: `1.0.2`
 - Primary platform: macOS
 - Future platform direction: Linux support is a design target; Windows is not
   currently in scope.

.ai-context/STATUS.md

@@ -2,7 +2,7 @@
 
 ## Current Release
 
-Base `1.0.1` is the current release. The repo-root `VERSION` file is updated
+Base `1.0.2` is the current release. The repo-root `VERSION` file is updated
 only during release-prep PRs, not on every ordinary PR.
 
 ## Current Implemented Areas
@@ -56,6 +56,8 @@ Recent released work includes:
 - Homebrew `basectl update` handoff and package-aware `basectl test base`
 - Base `1.0.1` AGPL license cleanup and release artifacts
 - explicit uv-managed Python setup and command runner support
+- workspace-aware repo clone, manifest-driven workspace clone, Project intake
+  workflow generation, and resilient `basectl gh` command execution
 
 ## Recent Merged Changes
 

CHANGELOG.md

@@ -7,6 +7,8 @@ and Base versions are tracked in the repo-root `VERSION` file.
 
 ## [Unreleased]
 
+## [1.0.2] - 2026-06-16
+
 ### Added
 
 - Added `basectl repo clone` for workspace-aware cloning of one GitHub

README.md

@@ -3,7 +3,7 @@
 ![Tests](https://github.com/codeforester/base/actions/workflows/tests.yml/badge.svg)
 ![Lint](https://github.com/codeforester/base/actions/workflows/pylint.yml/badge.svg)
 ![Platform: macOS](https://img.shields.io/badge/platform-macOS-lightgrey)
-![Version](https://img.shields.io/badge/version-1.0.1-blue)
+![Version](https://img.shields.io/badge/version-1.0.2-blue)
 
 Base is a workspace control plane for developers who keep multiple repositories
 checked out side by side.
@@ -704,11 +704,11 @@ that file, but users own how it is edited, backed up, or synced. See
 Inspect release readiness for a Base-managed repository with:
 
 ```bash
-basectl release check --version 1.0.1
-basectl release plan --version 1.0.1
-basectl release notes --version 1.0.1
-basectl release publish --version 1.0.1 --dry-run
-basectl release publish --version 1.0.1 --yes
+basectl release check --version 1.0.2
+basectl release plan --version 1.0.2
+basectl release notes --version 1.0.2
+basectl release publish --version 1.0.2 --dry-run
+basectl release publish --version 1.0.2 --yes
 ```
 
 `basectl release check|plan|notes` are read-only. They validate the manifest
@@ -1325,7 +1325,7 @@ Base follows a few simple principles.
 
 ## Current Status
 
-Base `1.0.1` is the current release. The implemented command surface covers
+Base `1.0.2` is the current release. The implemented command surface covers
 setup, checks, diagnostics, project discovery, project activation, project test
 execution, mise integration, cleanup, updates, onboarding, repository baseline
 creation, CI-safe setup/check/doctor entry points, release readiness inspection,

VERSION

@@ -1 +1 @@
-1.0.1
+1.0.2