@karmaniverous/jeeves-meta 0.14.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -5,9 +5,10 @@ HTTP service for the Jeeves knowledge synthesis engine. Provides a Fastify API,
5
5
  ## Features
6
6
 
7
7
  - **Fastify HTTP API** — `/status`, `/metas`, `/preview`, `/synthesize`, `/synthesize/abort`, `/seed`, `/unlock`, `/config`, `/config/apply`, `/queue`, `/queue/clear`
8
- - **Built-in scheduler** — croner-based cron with adaptive backoff
9
- - **Synthesis queue** — single-threaded, priority-aware, deduplicated
10
- - **Three-step orchestration** — architect, builder, critic with conditional re-architecture
8
+ - **Phase-state machine** — per-meta `_phaseState` tracking `{ architect, builder, critic }` × `{ fresh, stale, pending, running, failed }`
9
+ - **Built-in scheduler** — croner-based cron with adaptive backoff; picks one phase per tick across entire corpus
10
+ - **Three-layer synthesis queue** — `current` (running phase) + `overrides` (explicit triggers) + `automatic` (scheduler candidates)
11
+ - **Three-phase orchestration** — architect, builder, critic with surgical retry of failed phases
11
12
  - **Discovery via watcher** — filesystem-based meta discovery via `/walk` endpoint (no Qdrant dependency)
12
13
  - **Ownership tree** — hierarchical scoping with child meta rollup
13
14
  - **Cross-meta references** — `_crossRefs` declares relationships to other metas; referenced `_content` included as architect/builder context
@@ -53,7 +54,7 @@ jeeves-meta service install --config /path/to/jeeves-meta/config.json
53
54
 
54
55
  | Method | Path | Description |
55
56
  |--------|------|-------------|
56
- | GET | `/status` | Service health, queue state, dependency checks |
57
+ | GET | `/status` | Service health, queue state, dependency checks, phase-state summary |
57
58
  | GET | `/metas` | List metas with filtering and field projection |
58
59
  | GET | `/metas/:path` | Single meta detail with optional archive |
59
60
  | GET | `/preview` | Dry-run: preview inputs for next synthesis |
@@ -63,8 +64,8 @@ jeeves-meta service install --config /path/to/jeeves-meta/config.json
63
64
  | POST | `/unlock` | Remove `.lock` file from a meta entity |
64
65
  | GET | `/config` | Query sanitized config with optional JSONPath (`?path=$.schedule`) |
65
66
  | POST | `/config/apply` | Apply a config patch (merge or replace) |
66
- | GET | `/queue` | Current queue state (current, pending, stats) |
67
- | POST | `/queue/clear` | Remove all pending queue items |
67
+ | GET | `/queue` | Queue state: current (with phase), overrides, automatic, pending |
68
+ | POST | `/queue/clear` | Remove all override queue entries |
68
69
  | PATCH | `/metas/:path` | Update user-settable reserved properties (`_steer`, `_emphasis`, `_depth`, `_crossRefs`, `_disabled`) |
69
70
 
70
71
  ## Configuration