teleo-infrastructure/.agents/skills/teleo-vps-runtime-ops/SKILL.md
twentyOne2x fed5cb0805 Add guarded canonical claim application
- Normalize rich proposals into atomic reviewed canonical graph bundles with exact row verification.
- Harden reviewer/apply roles, upgrade ACLs, and prove generic plus Helmer lifecycles in isolated PostgreSQL.
- Publish repo-native VPS/GCP/Cory skills and live-readonly GCP inventory without changing the live VPS runtime.

`.agents/skills/crabbox/SKILL.md`
`.agents/skills/teleo-gcp-parity-ops/SKILL.md`
`.agents/skills/teleo-kb-db-change-workflow/SKILL.md`
`.agents/skills/teleo-leo-onboarding/SKILL.md`
`.agents/skills/teleo-vps-runtime-ops/SKILL.md`
`.agents/skills/working-leo-cory-outcomes/SKILL.md`
`docs/reports/leo-working-state-20260709/approve-claim-clone-canary-current.json`
`docs/reports/leo-working-state-20260709/approve-claim-clone-canary-current.md`
`docs/reports/leo-working-state-20260709/current-truth-index.md`
`docs/reports/leo-working-state-20260709/gcp-cloud-sql-t3-live-readonly-current.json`
`docs/reports/leo-working-state-20260709/gcp-cloud-sql-t3-live-readonly-current.md`
`docs/reports/leo-working-state-20260709/gcp-cloudsql-studio-parity-gate-current.json`
`docs/reports/leo-working-state-20260709/gcp-cloudsql-studio-parity-gate-current.md`
`docs/reports/leo-working-state-20260709/gcp-parallel-delegation-current.json`
`docs/reports/leo-working-state-20260709/helmer-approve-claim-clone-canary-current.json`
`docs/reports/leo-working-state-20260709/helmer-approve-claim-normalization-current.json`
`docs/reports/leo-working-state-20260709/skill-pack-manifest.json`
`docs/reports/leo-working-state-20260709/skill-pack-readme.md`
`docs/reports/leo-working-state-20260709/working-leo-current-state-20260709.md`
`docs/reports/leo-working-state-20260709/working-leo-definition-20260709.md`
`docs/reports/leo-working-state-20260709/working-leo-execution-plan-current.md`
`scripts/apply_proposal.py`
`scripts/apply_worker.py`
`scripts/approve_proposal.py`
`scripts/kb_apply_prereqs.sql`
`scripts/kb_proposal_normalize.py`
`scripts/probe_gcp_db_parity.py`
`scripts/run_approve_claim_clone_canary.py`
`scripts/run_approve_claim_isolated_container_canary.sh`
`tests/test_apply_proposal.py`
`tests/test_apply_worker.py`
`tests/test_approve_proposal.py`
`tests/test_kb_apply_prereqs.py`
`tests/test_kb_proposal_normalize.py`
`tests/test_kb_proposal_routes.py`
`tests/test_probe_gcp_db_parity.py`
`tests/test_repo_skill_pack.py`
2026-07-10 17:49:37 +02:00

3.1 KiB

name description
teleo-vps-runtime-ops Use for Leo VPS navigation, service health, Docker/Postgres readbacks, clone DB rehearsals, report sync, and runtime stability verification without changing live Leo behavior.

Teleo VPS Runtime Ops

Job

Navigate and verify the VPS safely, with exact readbacks and no surprise live-runtime changes.

Trigger Phrases

  • "Leo on VPS"
  • "check VPS stability"
  • "navigate Teleo VPS"
  • "leoclean service"
  • "run DB rehearsal on VPS"
  • "sync reports to VPS"

Known Surfaces

  • Host: 77.42.65.182
  • SSH user: root
  • Local key path is available; never print private key contents.
  • Service: leoclean-gateway.service
  • DB container: teleo-pg
  • DB: teleo
  • Last retained count endpoints: claims 1837, sources 4145, evidence 4670, edges 4916, reasoning tools 17, proposals 26. Treat these as stale until refreshed.
  • Profile reports: /home/teleo/.hermes/profiles/leoclean/kb_stage/reports/
  • Deploy/source area: /opt/teleo-eval/workspaces/deploy-infra

Required Fresh Readbacks

Before claiming runtime state, read:

systemctl show leoclean-gateway.service -p ActiveState -p SubState -p MainPID -p NRestarts -p ExecMainStartTimestamp -p User -p WorkingDirectory

Before claiming DB state, use docker exec teleo-pg psql -U postgres -d teleo and query exact tables/rows. Wrap verification queries in begin transaction read only; ... rollback;.

Before claiming cleanup, query disposable DBs:

select datname from pg_database where datname like 'teleo%rehearsal%20260709' or datname like 'teleo%packet%20260709';

Mutating Boundaries

Allowed when needed:

  • read-only service/DB inspection,
  • disposable clone DB creation and drop for rehearsal,
  • SQL rollback transactions,
  • syncing report artifacts to the report directory,
  • no-secret file checks.

Not allowed from this skill alone:

  • restarting or changing the live Leo service,
  • changing live runtime config,
  • production DB commit/apply,
  • exposing secret contents,
  • deleting non-disposable data.

Rehearsal Rules

For DB rehearsals:

  1. Capture production preflight counts.
  2. Create a disposable DB from live state.
  3. Run commit SQL only in the disposable DB.
  4. Run postflight counts.
  5. Run delete rollback if applicable.
  6. Drop the disposable DB.
  7. Verify production counts stayed unchanged.
  8. Verify the disposable DB no longer exists.

For the guarded claim-bundle lifecycle, prefer the retained isolated wrapper:

scripts/run_approve_claim_isolated_container_canary.sh \
  --output docs/reports/leo-working-state-20260709/approve-claim-clone-canary-current.json

It must use a disposable unexposed PostgreSQL container, bind its receipt to current source hashes, compare exact payload projections and table deltas, read live count/service endpoints without writing them, and independently prove the container/workdir are absent afterward. Do not install the candidate code into the live Leo deploy merely to run this canary.

Blocker Format

Do not say "blocked" without:

  • current_canary
  • attempted_routes
  • exact_gate
  • clear_CTA
  • next_non_user_action