@sjawhar/pi-legion-envoy 7.10.0 → 7.10.1

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/dist/legion.js CHANGED
@@ -18042,7 +18042,7 @@ function endInjectedUserTurns(sessionID) {
18042
18042
  // package.json
18043
18043
  var package_default = {
18044
18044
  name: "@sjawhar/pi-legion-envoy",
18045
- version: "7.10.0",
18045
+ version: "7.10.1",
18046
18046
  license: "Apache-2.0",
18047
18047
  type: "module",
18048
18048
  omp: {
@@ -50,6 +50,11 @@ judgment across many files). Do not name any other agent.
50
50
  | 3. Framework docs | `read` the library's documentation URL | [library] [topic] |
51
51
  | 4. External practices | `web_search`, then `read` the primary source | Current best practices for [topic] |
52
52
 
53
+ Before relying on a step 1 hit, also search for `supersedes: docs/solutions/<its-path>` and
54
+ `Extends docs/solutions/<its-path>` naming it: a newer file may extend or supersede what you
55
+ found, and Legion runs no pass that reconciles these links, so following them is the only way to
56
+ know the hit is still current.
57
+
53
58
  ## Output
54
59
 
55
60
  **Found:** Answer with source (file:line or URL)
@@ -67,13 +67,26 @@ Do not start retro before step 2 or skip it because the change seems mechanical;
67
67
  ## Durable outputs
68
68
 
69
69
  Write the integrated learning as one or more discoverable documents under `docs/solutions/`.
70
- Organize by reusable topic rather than by pull request. Search `docs/solutions/` for the topic
71
- first: when a document already states the rule, update it in place (sharpen the rule, add this
72
- issue and pull request to `related_issues`) rather than writing a sibling; when the new learning
73
- replaces an old document, set the old one's `status: superseded` and add
74
- `superseded_by: docs/solutions/<path>.md`. Open each document with the rule in a few imperative
75
- lines; the incident that taught it goes in an Evidence section below, never in the rule. Each
76
- document uses this front matter:
70
+ Organize by reusable topic rather than by pull request, but never edit a document you did not
71
+ write this retro — not its frontmatter, not its body. Two trees' retros can land within the same
72
+ hour, and an in-place edit (another `related_issues` entry, a sharpened sentence, a `status`
73
+ flip) conflicts with any other tree's edit to the same lines of the same file. Search
74
+ `docs/solutions/` for the topic first; before relying on a hit, also search for
75
+ `supersedes: docs/solutions/<its-path>` and `Extends docs/solutions/<its-path>` naming it —
76
+ Legion runs no pass that reconciles these links, so a newer file that extends or supersedes the
77
+ one you found is discoverable only by following them. Then write a new file of your own, named
78
+ `docs/solutions/<category>/<slug>-<LEGION_ISSUE>.md` so two trees never choose the same path:
79
+
80
+ - **A fresh topic:** state the rule in a few imperative lines; the incident goes in an Evidence
81
+ section below, never in the rule.
82
+ - **A topic an existing document already covers:** underneath its own H1 heading, the first line
83
+ reads `Extends docs/solutions/<existing-path>.md.`; the rule states only the delta.
84
+ - **A topic an existing document states wrongly:** frontmatter adds
85
+ `supersedes: docs/solutions/<existing-path>.md`; the first line under the H1 says why. Leave
86
+ the old file's frontmatter and body untouched: Legion runs no pass that reconciles it, so the
87
+ `supersedes:` link is the only thing that makes the correction discoverable from the old file.
88
+
89
+ Each document uses this front matter:
77
90
 
78
91
  ```yaml
79
92
  ---
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sjawhar/pi-legion-envoy",
3
- "version": "7.10.0",
3
+ "version": "7.10.1",
4
4
  "license": "Apache-2.0",
5
5
  "type": "module",
6
6
  "omp": {