Aspegio/nelson v2.4.0

v2.4.0 — Dynamic Workflows & Standing Goals

on GitHub

This release makes Nelson suitable to two Claude Code features so power users can drive both from the framework: dynamic workflows (deterministic multi-agent orchestration) and /goal (session-scoped Stop hooks that keep a session working until a completion condition is met). Nelson wraps each with doctrine, gates, and verification — it governs these features, it does not auto-invoke them.

Features

• Dynamic workflow alignment (v1) — Two new execution modes, workflow (one approved autonomous run for large fan-out, audits, migrations, or cross-checked research) and hybrid-workflow (a Nelson-gated sequence of runs with human approval between stages, for Station 2/3 work). Adds references/workflow-doctrine.md (suitability, Sounding-the-Channel probes, cost guardrails, verification contracts, telemetry), battle-plan Workflow Charter fields, a charter-to-runnable-script bridge so the approved charter maps onto a real Workflow script, and workflow_* telemetry events. Saved workflows live in .claude/workflows/*.js and run as /<name>.
• Goal alignment — Nelson now aligns with Claude Code's /goal. New references/goal-alignment.md doctrine, built on the load-bearing fact that the /goal evaluator judges only the conversation transcript — so completion evidence must be surfaced into chat, not left on disk. New nelson-data.py goal-condition composes a transcript-verifiable /goal string from the sailing orders (outcome + metric + stop criteria, plus a scuttle-and-reform escape), with --max-turns, --record (persists the condition + logs a goal_set event for resumption), and --json. Wired into SKILL.md at Sailing Orders (offer/reconcile), Stand Down (surface evidence so the goal auto-clears), and session resumption (re-establish on a fresh session). Adds goal_set / goal_cleared events and an optional persisted goal_condition field. The standing goal and the Mission Complete Gate reinforce each other.

Maintainability & docs

• Backlog triage (#124) — admiralty-decision documentation, mission session-marker sidecar cleanup, and an incremental (per-module) strict-mypy sensor rollout.
• New test_nelson_data_goal.py (composer purity/immutability, CLI output/JSON/record/limit, event validity, schema preservation); tool-mapping.md, structured-data.md, README.md, and docs/project_structure.md updated. All sensors green: Ruff, formatter, pytest, pre-commit, markdownlint, typos, and the doc cross-reference check.

Commits since v2.3.0

• `0b78726` feat: align Nelson with Claude Code dynamic workflows and /goal (#126)
• `be54ded` chore: backlog triage delivery — admiralty-decision docs, sidecar cleanup, incremental mypy sensor (#124)