diff --git a/.governance/manifest.json b/.governance/manifest.json index 76c2b13..297f292 100644 --- a/.governance/manifest.json +++ b/.governance/manifest.json @@ -58,7 +58,8 @@ ".github/workflows/multi-system-tests.yml", "VERSION", "wellmanifest_governance.py", - "setup.py" + "setup.py", + "errors/**" ] }, "infrastructure": { diff --git a/errors/README.md b/errors/README.md new file mode 100644 index 0000000..848a6d9 --- /dev/null +++ b/errors/README.md @@ -0,0 +1,9 @@ +# Error Runbooks (`fixos`) + +Index of error runbooks and diagnostic remediation guides for `semcod/fixos` in accordance with `wellmanifest/logs`. + +| Code | Component | Summary | Remediation | +| --- | --- | --- | --- | +| `FIXOS-LLM-001` | `fixos.cli.fix_cmd` / `fixos.agent` | LLM provider unavailable or `--no-llm` active during autonomous repair | Automatic fallback to deterministic heuristic diagnostics and safe cleanup (`fixos auto --no-llm`) | +| `FIXOS-DISK-001` | `fixos.cli._cleanup_space` | Low disk space on `/` or `/tmp` | Run `fixos auto --no-llm --yes` or `fixos cleanup-space --yes` | +| `FIXOS-SNAP-001` | `fixos.agent.autonomous_session` | Disabled Snap revisions consuming root disk space | Remove disabled Snap revisions via `snap list --all` and `sudo -n snap remove --revision=` | diff --git a/project/TICKETS.md b/project/TICKETS.md index 410bb9e..a989752 100644 --- a/project/TICKETS.md +++ b/project/TICKETS.md @@ -89,4 +89,6 @@ This file indexes governance tickets without taking ownership of | **ticket-083** | [`README.md`](./ticket-083/README.md) | - | - | - | - | - | | **ticket-084** | [`README.md`](./ticket-084/README.md) | - | - | - | - | - | | **ticket-086** | [`README.md`](./ticket-086/README.md) | - | - | - | - | - | +| **ticket-088** | [`README.md`](./ticket-088/README.md) | - | - | - | - | - | +| **ticket-089** | [`README.md`](./ticket-089/README.md) | - | - | - | - | - | diff --git a/project/ticket-089/README.md b/project/ticket-089/README.md new file mode 100644 index 0000000..51c0b75 --- /dev/null +++ b/project/ticket-089/README.md @@ -0,0 +1,24 @@ +# Ticket 089: Add errors runbook index for Wellmanifest logs compliance + +- **ID**: ticket-089 +- **Owner**: agent:antigravity +- **Status**: IN_PROGRESS +- **Workflow state**: EDIT +- **Created**: 2026-10-18 + +## Goal and scope + +Add `errors/README.md` and declare `errors/**` under the `governance` workstream in `.governance/manifest.json` so `wellman check` (`wellmanifest/logs` standard pack) passes with 0 errors. + +## Acceptance criteria + +- [x] AC-01: `errors/README.md` exists and `wellman check` reports `0 errors`. +- [x] AC-02: `./project/governance-check.sh` passes (`GOV-PASS`). + +## Tracking boundary + +This directory contains the minimal reviewed intent. Optional participant prose +and raw command logs are not required delivery output. + +## Execution Authorization +- SESSION_EXECUTION_AUTHORIZATION: Authorized by user to satisfy Wellmanifest governance and `wellman check` standards. diff --git a/project/ticket-089/intent.json b/project/ticket-089/intent.json new file mode 100644 index 0000000..a950014 --- /dev/null +++ b/project/ticket-089/intent.json @@ -0,0 +1,84 @@ +{ + "schema": "new-project.intent/v3", + "ticket": "ticket-089", + "summary": "Add errors runbook index for Wellmanifest logs compliance", + "workstream": "governance", + "classification": { + "kind": "SERVICE", + "priority": "P2", + "origin": "health" + }, + "allowedPaths": [ + "project/ticket-089/**", + "TODO.md", + "project/TICKETS.md", + ".governance/manifest.json", + ".governance/standard-adoption.json", + "errors/README.md" + ], + "forbiddenPaths": [ + "project/ticket-*/user-*.md" + ], + "stacks": [ + "python" + ], + "dependsOn": [], + "conflictsWith": [], + "integrationTicket": null, + "delivery": { + "acceptedBaseSha": "d8709725c77e93337e9b69b7dcaf03b946bd4a55", + "targetBranch": "main", + "outcome": "Add errors/README.md runbook index and register errors/** in .governance/manifest.json so wellman check passes with 0 errors.", + "nonGoals": [ + "No runtime behavior changes." + ], + "complexity": "XS", + "estimatedMinutes": 10, + "budgets": { + "maxImplementationFiles": 3, + "maxAffectedComponents": 1, + "maxPublicInterfaceChanges": 0, + "maxRuntimeDependencies": 0 + }, + "architecture": { + "status": "accepted", + "decision": "Register errors/** in governance workstream ownedPaths and add errors/README.md index per wellmanifest/logs.", + "components": [ + { + "name": "governance", + "paths": [ + ".governance/manifest.json", + ".governance/standard-adoption.json", + "errors/README.md" + ] + } + ], + "responsibilityChanges": false, + "interfaceChanges": [], + "dataChanges": [], + "ui": { + "impact": "none", + "states": [], + "evidence": [] + }, + "rollback": "Revert the ticket commit." + }, + "runtimeDependencies": [], + "validation": [ + { + "criterion": "AC-01", + "commands": [ + "wellman check ." + ], + "expected": "0 errors." + }, + { + "criterion": "AC-02", + "commands": [ + "./project/governance-check.sh" + ], + "expected": "GOV-PASS: passed (0 errors, 0 warnings)." + } + ] + } +}