generated from coulomb/repo-seed
Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 07c5cf18ea | |||
| 4976002f9c |
61
README.md
61
README.md
@@ -9,8 +9,41 @@ See `INTENT.md` for direction, `SCOPE.md` for current implementation, and
|
|||||||
and routes every other credential need to its owner — see `wiki/AccessRouting.md`.
|
and routes every other credential need to its owner — see `wiki/AccessRouting.md`.
|
||||||
Latest gap analysis: `history/2026-06-17-post-wp0007-reassessment.md`.
|
Latest gap analysis: `history/2026-06-17-post-wp0007-reassessment.md`.
|
||||||
|
|
||||||
|
## Get the source (Forgejo)
|
||||||
|
|
||||||
|
Canonical repo: `https://forgejo.coulomb.social/coulomb/ops-warden`
|
||||||
|
Releases: `https://forgejo.coulomb.social/coulomb/ops-warden/releases`
|
||||||
|
|
||||||
|
**HTTPS clone:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://forgejo.coulomb.social/coulomb/ops-warden.git ~/ops-warden
|
||||||
|
cd ~/ops-warden
|
||||||
|
```
|
||||||
|
|
||||||
|
**SSH clone** (recommended for push/pull; add to `~/.ssh/config` if missing):
|
||||||
|
|
||||||
|
```sshconfig
|
||||||
|
Host forgejo-remote
|
||||||
|
HostName 92.205.62.239
|
||||||
|
Port 30022
|
||||||
|
User git
|
||||||
|
IdentityFile ~/.ssh/id_gitea
|
||||||
|
StrictHostKeyChecking accept-new
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone forgejo-remote:coulomb/ops-warden.git ~/ops-warden
|
||||||
|
cd ~/ops-warden
|
||||||
|
```
|
||||||
|
|
||||||
|
Legacy Gitea remotes (`gitea-remote`, `gitea.coulomb.social`) still work during
|
||||||
|
migration; new checkouts should use Forgejo.
|
||||||
|
|
||||||
## Install
|
## Install
|
||||||
|
|
||||||
|
From a Forgejo checkout:
|
||||||
|
|
||||||
**Recommended** (warden + experiential memory for route/worker/agent sessions):
|
**Recommended** (warden + experiential memory for route/worker/agent sessions):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@@ -41,6 +74,34 @@ phase-memory must be a sibling checkout at `../phase-memory` by default, or set
|
|||||||
`PHASE_MEMORY_REPO` when running make. Opt out of memory at runtime with
|
`PHASE_MEMORY_REPO` when running make. Opt out of memory at runtime with
|
||||||
`WARDEN_MEMORY=0`.
|
`WARDEN_MEMORY=0`.
|
||||||
|
|
||||||
|
### Upgrade after a release
|
||||||
|
|
||||||
|
When a new tag is published on Forgejo (e.g. `v0.1.2`):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd ~/ops-warden
|
||||||
|
git fetch --tags origin
|
||||||
|
git pull --ff-only
|
||||||
|
make install-all
|
||||||
|
warden route list # sanity check the installed CLI
|
||||||
|
```
|
||||||
|
|
||||||
|
If `warden` still behaves like an older build (same version string but missing
|
||||||
|
recent subcommands or fixes), clear the cached wheel and reinstall:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
uv cache clean ops-warden
|
||||||
|
uv tool install . --with-editable ../phase-memory --reinstall --force
|
||||||
|
```
|
||||||
|
|
||||||
|
Check out a specific release:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git fetch --tags origin
|
||||||
|
git checkout v0.1.2
|
||||||
|
make install-all
|
||||||
|
```
|
||||||
|
|
||||||
## Quick start (local backend)
|
## Quick start (local backend)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|||||||
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
|
|||||||
|
|
||||||
[project]
|
[project]
|
||||||
name = "ops-warden"
|
name = "ops-warden"
|
||||||
version = "0.1.1"
|
version = "0.1.2"
|
||||||
description = "SSH CA and certificate lifecycle manager for ops actors"
|
description = "SSH CA and certificate lifecycle manager for ops actors"
|
||||||
requires-python = ">=3.11"
|
requires-python = ">=3.11"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
|
|||||||
Reference in New Issue
Block a user