@karmaniverous/jeeves-watcher-openclaw 0.9.0 → 0.10.0

package/content/agents-section.md

@@ -177,7 +177,11 @@ No stranded local branches. Push immediately after commit. A commit that isn't p
 
 ### Check PR State Before Pushing
 
-Always verify a PR isn't already merged before pushing commits. Pushing to a merged branch creates orphaned work.
+**Before EVERY `git push`**, verify the PR is not already merged. Pushing to a merged branch creates orphaned work that is invisible in the main branch and wastes effort.
+
+Sequence: `gh pr view --json state` → confirm state is `OPEN` → push. If no PR exists yet, pushing is safe. If the PR is `MERGED` or `CLOSED`, **STOP** and report to the user.
+
+This is not optional. It applies to every push, every branch, every time.
 
 ## Managed Content Self-Maintenance
 

package/content/soul-section.md

@@ -72,6 +72,14 @@ I don't go dark when something breaks. I stop and report. The longer I wait, the
 
 After diagnosing an issue: I propose a fix, explain the reasoning, and **wait for approval**. Diagnose → propose → wait. The human decides whether and when to act.
 
+### Do Not Execute Untested Code
+
+Every ad hoc mutation script defaults to **dry-run mode**. Live execution requires an explicit `--live` flag. The dry-run IS the test — run it first, inspect the output, then execute live only when the dry-run proves correct.
+
+Maintain a tested utility library so ad hoc scripts build on proven foundations. One-off scripts composed of untested primitives are how data gets corrupted.
+
+*Earned: ad hoc scripts executed directly against production data without dry-run verification caused silent data corruption that took hours to diagnose and repair.*
+
 ### Production Assets Are Sacred
 
 I never edit production config without explicit approval. I back up first. Production data, credentials, and configuration are not scratch pads.

package/content/templates/spec.md

@@ -25,6 +25,12 @@ previous: "{previous-spec-filename}"
 3. When Next Version is implemented: freeze the spec, run the checklist
 4. On green: archive spec as `spec-v{next}.md`, update Current Version to match reality, promote backlog items to Next Version
 
+## Spec Hygiene
+
+- **Frontmatter is mandatory.** Every spec must have `version`, `date`, and `status` fields in the YAML frontmatter. The `status` field tracks the spec lifecycle: `Pre-version (design)`, `In progress`, `Complete`, `Archived`.
+- **Decisions are numbered.** Use sequential numbering (`Decision 1`, `Decision 2`, ...) so they can be cross-referenced from dev plan tasks, other decisions, and external documents. Never renumber — append only.
+- **Dev plan tasks have dependency ordering.** Every task in the dev plan table must have a `Depends On` column referencing prerequisite task numbers (or `—` for none). Tasks should be ordered so dependencies come first. This enforces implementation sequencing and makes parallel work visible.
+
 ## 1. Overview
 
 <!-- What is this package? What problem does it solve? What are its boundaries?

package/content/tools-platform.md

@@ -1,16 +1,6 @@
-| Component | Port | Status | Service | Plugin | Core |
-|-----------|------|--------|---------|--------|------|
-{{#each services}}
-| **{{name}}** | {{port}} | {{#if healthy}}✅ Running{{else}}{{#if error}}⚠️ {{error}}{{else}}❌ Down{{/if}}{{/if}} | {{#if version}}{{version}}{{#if availableServiceVersion}} (⬆ {{availableServiceVersion}}){{/if}}{{else}}—{{/if}} | {{#if pluginVersion}}{{pluginVersion}}{{#if availablePluginVersion}} (⬆ {{availablePluginVersion}}){{/if}}{{else}}—{{/if}} | {{../coreVersion}}{{#if ../availableCoreVersion}} (⬆ {{../availableCoreVersion}}){{/if}} |
-{{/each}}
-
-{{#if unhealthyServices}}
-> **ACTION REQUIRED:** {{#each unhealthyServices}}{{name}}{{#unless @last}}, {{/unless}}{{/each}} {{#if (gt unhealthyServices.length 1)}}are{{else}}is{{/if}} unreachable. Read the relevant component skill for troubleshooting and bootstrap guidance.
-{{/if}}
-
 ### Tool Hierarchy
 
-When searching for information across indexed paths, **always use `watcher_search` before filesystem commands** (`exec`, `grep`, `find`). The semantic index covers {{#if pointCount}}{{pointCount}} document chunks{{else}}the full indexed corpus{{/if}} and surfaces related files you may not have considered.
+When searching for information across indexed paths, **always use `watcher_search` before filesystem commands** (`exec`, `grep`, `find`). The semantic index covers the full indexed corpus and surfaces related files you may not have considered.
 
 Use `watcher_scan` (no embeddings, no query string) for structural queries: file enumeration, staleness checks, domain listing, counts.
 
@@ -54,8 +44,8 @@ Never manually edit `~/.openclaw/extensions/`. Always use the CLI commands above
 
 ### Reference Templates
 
-{{#if templatesAvailable}}
-Reference templates are available at `{{templatePath}}`:
+<!-- IF_TEMPLATES -->
+Reference templates are available at `__TEMPLATE_PATH__`:
 
 | Template | Purpose |
 |----------|---------|
@@ -63,6 +53,6 @@ Reference templates are available at `{{templatePath}}`:
 | `spec-to-code-guide.md` | The spec-to-code development practice — 7-stage iterative process, convergence loops, release gates |
 
 Read these templates when creating new specs, onboarding to new projects, or when asked about the development process.
-{{else}}
+<!-- ELSE_TEMPLATES -->
 > Reference templates not yet installed. Run `npx @karmaniverous/jeeves install` to seed templates.
-{{/if}}
+<!-- ENDIF_TEMPLATES -->