triad-plus 1.10.0 → 1.12.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/CHANGELOG.md +19 -0
- package/README.md +41 -0
- package/bin/triad-plus.js +565 -20
- package/docs/configuration.md +31 -0
- package/docs/human-readable-reports.md +52 -0
- package/docs/npx-installation.md +61 -4
- package/docs/operating-guide.it.md +9 -0
- package/docs/operating-guide.md +9 -0
- package/docs/troubleshooting.md +41 -0
- package/package.json +2 -2
- package/runtime/lib/evidence.mjs +11 -0
- package/runtime/lib/fingerprint.mjs +63 -0
- package/runtime/lib/human-reports.mjs +513 -0
- package/runtime/lib/installation-manifest.mjs +269 -0
- package/runtime/triad-human-report.mjs +50 -0
- package/skills/triad-loop-bootstrap/SKILL.md +4 -1
- package/skills/triad-loop-bootstrap/assets/loop-template/card-report.template.md +32 -0
- package/skills/triad-loop-bootstrap/assets/loop-template/handoff-report.template.md +14 -0
- package/skills/triad-loop-bootstrap/assets/loop-template/runtime/report-context/card.template.json +28 -0
- package/skills/triad-loop-bootstrap/assets/loop-template/runtime/report-context/delivery.template.json +16 -0
- package/skills/triad-loop-orchestrator/SKILL.md +48 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,24 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## Unreleased
|
|
4
|
+
|
|
5
|
+
## 1.12.0 — 2026-09-23
|
|
6
|
+
|
|
7
|
+
- Add deterministic human-readable Markdown views for terminal Cards and the
|
|
8
|
+
final delivery handoff, derived from canonical evidence with baseline-based
|
|
9
|
+
changed-path attribution and truthful blocked/not-delivered reporting.
|
|
10
|
+
|
|
11
|
+
## 1.11.0 — 2026-09-17
|
|
12
|
+
|
|
13
|
+
- Add an installation manifest that records Triad-owned assets, materialized
|
|
14
|
+
version, adapter scopes, hashes, and deterministic ownership fingerprint.
|
|
15
|
+
- Add CLI/workspace version visibility, legacy manifest migration through
|
|
16
|
+
`upgrade --apply`, and conservative dry-run/apply uninstall for all adapters.
|
|
17
|
+
- Preserve modified or unknown assets and all project-control state during
|
|
18
|
+
uninstall; report version skew and manifest integrity through `doctor`.
|
|
19
|
+
- Preserve shared global assets by default, remove only exact managed
|
|
20
|
+
`AGENTS.md` blocks, and leave generic host directories untouched.
|
|
21
|
+
|
|
3
22
|
## 1.10.0 — 2026-09-16
|
|
4
23
|
|
|
5
24
|
- Improve TUI and doctor output with terminal-native summaries, sober color
|
package/README.md
CHANGED
|
@@ -107,6 +107,38 @@ The Orchestrator first shows the feature cards, then delegates the bounded work.
|
|
|
107
107
|
If a tutorial step is unclear, see the [OpenCode guide](docs/runtimes.md#opencode)
|
|
108
108
|
and [troubleshooting](docs/troubleshooting.md).
|
|
109
109
|
|
|
110
|
+
## Installation version and safe uninstall
|
|
111
|
+
|
|
112
|
+
The CLI version and the version materialized in a control workspace are
|
|
113
|
+
reported independently:
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
npx triad-plus --version
|
|
117
|
+
npx triad-plus version --control /absolute/path/to/triad-control
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
Successful `init` and `upgrade --apply` operations record exact Triad-owned
|
|
121
|
+
files in `.triad-plus/installation.json`. This manifest does not own
|
|
122
|
+
`.triad-plus/team.json`, `.loop/`, product files, or evidence.
|
|
123
|
+
`init` is the first-install path; `upgrade --apply` is also the managed
|
|
124
|
+
update/repair/restore path for a registered workspace, including one left
|
|
125
|
+
`uninstalled` or `partial` by safe uninstall.
|
|
126
|
+
|
|
127
|
+
Uninstall is conservative and dry-run by default:
|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
npx triad-plus uninstall --host opencode --control /absolute/path/to/triad-control
|
|
131
|
+
npx triad-plus uninstall --host opencode --control /absolute/path/to/triad-control --apply
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
Only unchanged files recorded by the manifest are removed. Modified or
|
|
135
|
+
unknown files are preserved and reported; user state remains available for a
|
|
136
|
+
future installation or review. Generic host directories are never pruned. A
|
|
137
|
+
managed `AGENTS.md` role-run block is removed only when its markers and hash
|
|
138
|
+
are exact; surrounding user content is preserved. Global assets are shown but
|
|
139
|
+
preserved by default with `--global` because another control workspace may
|
|
140
|
+
share them.
|
|
141
|
+
|
|
110
142
|
## Optional immutable quality target
|
|
111
143
|
|
|
112
144
|
An initialized project may bind an immutable JSON Quality Baseline through
|
|
@@ -135,6 +167,15 @@ planning; Triad owns execution, verification, review, and delivery.
|
|
|
135
167
|
ready-for-dev Stories, debugging, and automation. It is no longer the primary
|
|
136
168
|
BMAD workflow. See the [BMAD integration guide](docs/bmad-integration.md).
|
|
137
169
|
|
|
170
|
+
## Human-readable delivery reports
|
|
171
|
+
|
|
172
|
+
Triad+ can materialize deterministic Markdown views from canonical control-plane
|
|
173
|
+
records: one report for each terminal Card and a human-first final handoff. The
|
|
174
|
+
views include baseline-attributed changed paths, attempts, verifier gates,
|
|
175
|
+
independent review, provenance, residual risks, and practical-test links. They
|
|
176
|
+
never replace the JSON/YAML evidence or add an LLM reporting call. See the
|
|
177
|
+
[human-readable reports guide](docs/human-readable-reports.md).
|
|
178
|
+
|
|
138
179
|
## Quick start for every runtime
|
|
139
180
|
|
|
140
181
|
Requirements: Node.js 20+ and one supported coding-agent host.
|