@lambdacurry/review-signals

Workflow-first CLI for Review Signals' durable control plane. It runs under Bun 1.3.1+ and Node/npm.

Use @latest together with Bun's --no-cache --force flags so every invocation refreshes registry metadata and reinstalls the selected executable instead of trusting a stale shared-cache entry. Verify the selected binary with bunx --no-cache --force @lambdacurry/review-signals@latest --version.

Start with:

bunx --no-cache --force @lambdacurry/review-signals@latest workflows help --json
bunx --no-cache --force @lambdacurry/review-signals@latest workflows list --json
bunx --no-cache --force @lambdacurry/review-signals@latest workflows show <workflow-id> --json

Read-only, code-owned workflows define required work and expose prose guidance about relevant command areas. Exact commands and options are discovered from live CLI help at runtime. Source groups are reusable collection briefs with immutable IDs, mutable keys, detailed instructions, enabled state, and independent pull freshness. Start with source-groups guidance --json when authoring one. Source identity is global by source type and external ID; associating an existing source with another source group adds provenance rather than changing ownership.

Goals use one durable lifecycle: proposed, approved, dismissed, or archived. goals list returns approved goals by default; use --status and --source-group to inspect proposal history. Goal-discovery workflows create proposals with source-group and origin-run provenance. Human review uses goals approve, goals dismiss, goals archive, and goals activate. New signals may reference approved goals only.

Signals move proposed → approved → archived or proposed → dismissed; recommendations move proposed → accepted → archived or proposed → dismissed. Use signals archive and recommendations archive for the final transition. Dismissed and archived records are immutable. Recommendation execution status is separate and remains the source of truth for whether implementation succeeded, failed, was blocked, or was cancelled.

goals archive is a guarded atomic cascade. It rejects queued or running goal batches and linked recommendation implementations, includes recommendations linked indirectly through the goal's signals, terminalizes active children, then archives the goal. goals activate restores only the goal; its dismissed and archived children remain historical.

Before authoring or updating durable fields, load the selected code-owned workflow and follow its embedded template. Goal, signal, and recommendation detail output includes chronological append-only history; lifecycle history belongs there, not in mutable descriptions or bodies.

The CLI stores stable source identity, source-group provenance, signals, recommendations, goals, and execution outcomes. Command execution tracking is automatic and internal; agents use the main domain commands and inspect status --json for failed or interrupted attempts. Interrupted attempts have an unknown outcome and require durable-state verification before retrying. Agents fetch current source content at least once per relevant workflow; raw content and transient snapshots are not stored. A successful source-group pull advances the cursor for the workflow ID recorded on that run (while retaining the aggregate timestamp for compatibility); goal and signal discovery never consume each other's freshness. Failed and blocked pulls do not advance freshness. Goal-level implementation batches freeze eligible recommendation IDs, and real workers atomically claim compatible subsets before recording per-recommendation execution outcomes.

Use npx @lambdacurry/review-signals@latest when Bun is unavailable. Use --env-file <path> to explicitly load one environment file; process variables win. .env* files are read-only, and connection failures must not trigger a database fallback.