You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit de3068e
Browse filesBrowse the repository at this point in the historyBrowse files
🎯 Describe a document's targets in its own run help (#478)
* 🎯 Describe a document's targets in its own run help (#463)
Discovery moves from the standalone `xmd targets` command into
`xmd run <document> --help`, which already inspects the document once to
describe its properties. The same inspection now also supplies a catalog
of targets, each named by the reference that selects it and described by
the first static paragraph its section states.
`DocumentInfo` gains an additive `targetCatalog`; `targets` stays the
canonical identity surface, byte-for-byte and order-for-order unchanged,
and mapping the catalog back to its `target` members reproduces it.
Descriptions come from the same masked Remark parse that discovers the
headings, so no document is parsed twice, and a paragraph that is not
wholly static is omitted whole rather than as a static prefix.
* 🏷️ Name the additive inspection field targetInfo (#463)
The field is one name, and it runs from the outline through the parsed
root document to the public inspection result.
* 🧪 Ask CT19 for the journal it proves help never creates (#463)
The case asserted `trace.jsonl` was absent without ever requesting a
journal, so it could not tell help apart from any run. It now passes
`--journal` and asserts that exact path stays absent.
---------
Co-authored-by: Taras Mankovski <[email protected]>
Copy file name to clipboardExpand all lines: architecture.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2084,7 +2084,7 @@ Status is measured against main.
2084
2084
|`<Output>` rendering selection | chooses which regions of a body render, and buffers a root that declares one; it decides nothing about failure | built on main |
2085
2085
|`Expansion` / `getExpansion()`| describes the current logical element expansion | built on main |
2086
2086
| document targets | catalogs a root document's addressable static headings, resolves one selector to one exact target, and projects the document to it before expansion | built on the #412 stack |
2087
-
|`xmd targets`|prints one document's catalog as full document references, by inspection alone | built on the #412 stack |
2087
+
|document-aware `xmd run … --help`|describes what one document declares and every target it addresses, each as a full document reference with the description its section states, by inspection alone | built on the #463 stack |
2088
2088
| targeted `xmd run`| reads a file argument as a document reference and executes the one exact target its selector resolved to, replacing the selector before execution rereads the file | built on the #412 stack |
2089
2089
| targeted workflow definition | the V1 workflow definition optionally carries the exact canonical document target, which takes part in definition identity and in compatible reuse | built on the #412 stack; the workflow CLI does not supply one yet |
2090
2090
|`workflowInstallation()` / `getWorkflowRun()`| associates one document execution with a workflow run, through an `ExecutionInstallation` the trusted host passes to `executeInstalled()`| built on the #366 stack |
0 commit comments