soturail 0.4.1 → 0.7.0

package/docs/workflow-rail.md

@@ -1,15 +1,25 @@
 # Workflow Rail
 
-Workflow Rail is a local task state system for SotuRail. It stores auditable workflow artifacts under `.soturail/workflows/` and can optionally plan or create local Git worktrees.
+Workflow Rail is SotuRail's local task state system. It stores auditable workflow artifacts under `.soturail/workflows/` and can optionally plan local Git worktree isolation.
+
+## Commands
+
+v0.7.0 adds phase-oriented Workflow Rail 2.0 commands while keeping the older v0.4 workflow commands:
 
 ```bash
+soturail workflow setup
+soturail workflow plan "Implement feature"
+soturail workflow work --note "Implemented the first slice"
+soturail workflow review --all
+soturail workflow verify
+soturail workflow evidence <id>
+soturail workflow diagram <id>
+
 soturail workflow new "Implement feature"
 soturail workflow list
 soturail workflow show <id>
-soturail workflow plan <id>
 soturail workflow start <id> --worktree --dry-run
 soturail workflow status <id>
-soturail workflow verify <id>
 soturail workflow close <id>
 soturail workflow cleanup --closed --dry-run
 ```
@@ -28,17 +38,83 @@ Workflows use explicit states:
 
 ## Storage
 
-Each workflow uses:
+Workflow Rail writes local JSON, YAML and Markdown only:
+
+```txt
+.soturail/workflows/
+  index.json
+  current.json
+  templates/
+  <id>/
+    workflow.yml
+    plan.md
+    plan.json
+    tasks.md
+    verification.md
+    work.md
+    review.md
+    review.json
+    verify.md
+    verify.json
+    logs/
+```
+
+## Workflow Rail 2.0 Phases
+
+The v0.7.0 loop is:
 
 ```txt
-.soturail/workflows/<id>/
-├── workflow.yml
-├── plan.md
-├── tasks.md
-├── verification.md
-└── logs/
+setup -> plan -> work -> review -> verify -> evidence
 ```
 
+`workflow setup` creates the local scaffold and template folder.
+
+`workflow plan "title"` creates a workflow, marks it planned and writes a machine-readable `plan.json` with tasks, acceptance gates, role packs, context routes, linked run workspace if available and evidence path.
+
+`workflow work` marks the active phase and appends a progress note to `work.md`. It links current changed-file counts, raw IDs and harness failures where available.
+
+`workflow review --all` writes deterministic review reports without requiring an LLM:
+
+```txt
+security
+docs
+tests
+release
+context
+agent-readiness
+```
+
+`workflow verify` aggregates safe local evidence. It does not publish, release, run destructive commands or invent pass/fail claims for checks that were not recorded.
+
+`workflow evidence <id>` writes a Markdown evidence pack under `.soturail/reports/`.
+
+## Verification And Evidence
+
+Verification connects:
+
+- harness contract status;
+- policy queue and decision status;
+- evidence completeness;
+- Diagram Rail validation status;
+- evaluation report status;
+- release notes path when package metadata is present.
+
+Evidence packs include:
+
+- workflow metadata and state;
+- plan, task, review and verify paths;
+- run workspace pointers where available;
+- command raw IDs and offload IDs;
+- changed files and filesystem evidence pointers;
+- policy decisions;
+- harness failures and contract status;
+- diagram validation result;
+- evaluation report result;
+- release notes path under `docs/releases/`;
+- release gates and publish checklist notes.
+
+SotuRail does not claim build, test, audit, npm pack, publish or GitHub release success unless those results exist as local evidence.
+
 ## Worktrees
 
 `soturail workflow start <id> --worktree --dry-run` prints a local worktree plan. If run without `--dry-run` inside a Git repository, SotuRail may create a local worktree under `.soturail/worktrees/<id>/`.
@@ -50,10 +126,18 @@ Safety rules:
 - SotuRail does not delete user work without explicit confirmation.
 - Rollback instructions are printed when worktrees are planned.
 
-## Verification
+## Diagram Integration
+
+Diagram Rail adds visual contracts to Workflow Rail:
+
+```bash
+soturail workflow diagram <id>
+soturail diagram from-workflow <id>
+soturail diagram validate
+```
 
-`soturail workflow verify <id>` only runs configured safe checks when they are explicit. Without configured checks, it prints a checklist instead of inventing commands.
+Generated workflow diagrams live under `docs/diagrams/` and have matching `.spec.md` visual contracts. They make state transitions explicit; they do not replace tests or review.
 
-## Cleanup
+## Future Directions
 
-`soturail workflow cleanup --closed --dry-run` previews closed workflow records that could be removed. It does not delete anything unless rerun with `--closed --yes` after review.
+Future Workflow Rail work can add richer trace/report commands, deeper task generation, issue integration and release-specific templates. The boundary stays the same: SotuRail prepares local context, evidence and safety rails, while the agent host owns the editing runtime.

package/examples/agents/README.md

@@ -4,8 +4,21 @@ These examples show how to use SotuRail exports without modifying global agent c
 
 ```bash
 soturail agents doctor
+soturail agents doctor --verbose
+soturail agents capabilities
+soturail agents status
 soturail agents export --agent all
+soturail agents install --agent claude --dry-run
+soturail agents install --agent cursor --dry-run
+soturail agents install --agent gemini --dry-run
 soturail mcp config --agent generic
 ```
 
 Review generated files under `.soturail/exports/agents/` before enabling them in any agent host.
+
+Deep Agents-style exports are context/config artifacts only:
+
+```bash
+soturail agents export --agent deepagents
+soturail agents export --agent deepagents-js
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soturail",
-  "version": "0.4.1",
+  "version": "0.7.0",
   "description": "Local-first context rails for AI coding agents: reversible terminal compression, progressive repo reading, SDD workflows, hooks, benchmarks, memory and cache-friendly payloads.",
   "type": "module",
   "bin": {
@@ -55,7 +55,7 @@
     "soturail"
   ],
   "author": "Rafael Ryan Ramos de Souza",
-  "license": "MIT",
+  "license": "UNLICENSED",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Soturine/soturail.git"