Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -44,9 +44,10 @@ jobs:
shell: pwsh
run: |
$env:PYTHONPATH = "src"
python -m acgm_recover guide --no-default-sources
python -m claude_code_recover guide --no-default-sources
if ($LASTEXITCODE -ne 1) { throw "Windows guide must report core runtime unsupported" }
$global:LASTEXITCODE = 0
python -m acgm_recover --version
- name: Bootstrap dry run
run: python scripts/bootstrap.py --dry-run --json
- name: Bootstrap install and idempotent verification
Expand Down
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,5 @@ __pycache__/
build/
dist/
*.egg-info/
.acgm-recover-staging-*
.claude-code-recover-staging-*
recovery-bundle*/
7 changes: 4 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,15 @@
# Agent operating contract

ACGM Recover is an offline, evidence-first recovery tool. Agents working in this repository must preserve these boundaries:
Claude Code Recover is an independent, offline, evidence-first Claude Code project continuity recovery tool. Agents working in this repository must preserve these boundaries:

- Verify the repository root and current Git state before editing or installing.
- Clone and run `scripts/bootstrap.py` only after the user explicitly authorizes the named official repository and local user installation.
- Clone and run `scripts/bootstrap.py` only after the user explicitly authorizes the named repository and local user installation.
- Treat installation as installation only. It does not authorize `discover`, `inspect`, `build`, reading transcript bodies, or modifying a surviving project.
- Never inspect tokens, cookies, OAuth state, account caches, provider identity, or displayed model names to choose a route.
- A `--route` argument records an explicit CLI input; the agent must still show it to the user and obtain confirmation before recovery work.
- Do not add runtime networking, telemetry, update checks, dependency downloads, or shell-based command construction.
- Keep bootstrap version behavior explicit: the same version is force-reinstalled from the newly verified snapshot, older installs require `--upgrade`, newer installs are never silently downgraded, and active virtual environments must not receive `--user`.
- Keep bootstrap version behavior explicit: the same canonical version is force-reinstalled from the newly verified snapshot, older canonical installs require `--upgrade`, newer installs are never silently downgraded, active virtual environments must not receive `--user`, and an RC1 `acgm-recover` distribution must return `MIGRATION_REQUIRED` before any mutation.
- Use `claude-code-recover` / `python -m claude_code_recover` as canonical RC2 entrypoints. Keep `acgm-recover` / `python -m acgm_recover` working only as the documented one-RC compatibility aliases.
- Use only synthetic fixtures in tests. Never commit real transcripts, credentials, account identifiers, or private absolute paths.
- On Windows, only bootstrap, installation, `--version`, `doctor`, and `guide` are currently in scope. Do not run or claim support for core `discover`, `inspect`, `build`, or `verify` until the Windows filesystem and Git safety port is complete.

Expand Down
13 changes: 11 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,17 @@
# Changelog

## 0.1.0-rc.1 — Unreleased
## 0.1.0-rc.2 — Unreleased

- Added the cross-platform `python -m acgm_recover` entrypoint.
- Renamed the product to Claude Code Recover so the recovery target is explicit: Claude Code project continuity, not an ACGM installation.
- Moved the canonical repository contract to `johnrucnapier-sketch/Claude-Code-Recover`.
- Added canonical `claude-code-recover`, `python -m claude_code_recover`, and `bin/claude-code-recover` entrypoints.
- Renamed the distribution to `claude-code-recover`; bootstrap detects RC1 `acgm-recover` metadata and returns a non-executable `MIGRATION_REQUIRED` plan before any mutation.
- Retained `acgm-recover` and `python -m acgm_recover` as documented legacy aliases for one RC cycle.
- Added independent-project and no-Anthropic-affiliation notices without changing evidence, privacy, or recovery-readiness semantics.

## 0.1.0-rc.1 — Development preview

- Added the original cross-platform `python -m acgm_recover` entrypoint, now retained as an RC2 legacy alias.
- Added an offline `guide` command that reports observable capabilities, requires explicit route input, and never inspects account/provider/model identity.
- Added an offline, user-scoped `scripts/bootstrap.py` installer with dry-run, source-manifest validation, post-install verification, and failure cleanup guidance.
- Added Agent-assisted clone/install instructions while keeping evidence discovery and route confirmation as separate authorizations.
Expand Down
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
@AGENTS.md

## Claude Code entrypoint
## Claude Code Recover entrypoint

After explicit user authorization, clone, dry-run, bootstrap, and installation
verification may run continuously. Stop at `selection_required`. Do not choose a
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Contributing

ACGM Recover handles private local history. A change that improves convenience but weakens evidence boundaries or privacy is not acceptable.
Claude Code Recover handles private local history. A change that improves convenience but weakens evidence boundaries or privacy is not acceptable.

Before proposing a change:

Expand Down
4 changes: 3 additions & 1 deletion LICENSING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Licensing — dual track / 双轨

ACGM Recover combines mechanical code with evidence and recovery methodology prose.
Claude Code Recover combines mechanical code with evidence and recovery methodology prose.

Claude Code Recover is an independent open-source project. It is not affiliated with, endorsed by, or an official product of Anthropic. “Claude” and “Claude Code” identify the external platform whose surviving local project evidence this tool can analyze; they do not imply sponsorship.

| Paths | License |
|---|---|
Expand Down
Loading
Loading