@kitelev/exocortex-cli 16.254.1 → 16.254.2
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/README.md +12 -1
- package/dist/index.js +238 -238
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -124,7 +124,7 @@ npx @kitelev/exocortex-cli apply <cmd> [path] [options]
|
|
|
124
124
|
| `--vault <path>` | cwd | Path to Obsidian vault |
|
|
125
125
|
| `--dry-run` | off | Evaluate precondition and preview; do not write |
|
|
126
126
|
| `--yes` | off | Skip destructive-command confirmation |
|
|
127
|
-
| `--input <json>` | — | JSON object forwarded to
|
|
127
|
+
| `--input <json>` | — | JSON object forwarded to the grounding as `userInput`; its declared REQUIRED keys are checked before the grounding runs (see below) |
|
|
128
128
|
| `--seed <uuid>` | — | Deterministic UID seed for test/replay |
|
|
129
129
|
| `--frozen-clock <iso>` | — | Freeze clock to an ISO timestamp for test/replay |
|
|
130
130
|
| `--json` | off | Emit a machine-readable `{command,target,created:[…]}` envelope |
|
|
@@ -134,6 +134,17 @@ npx @kitelev/exocortex-cli apply <cmd> [path] [options]
|
|
|
134
134
|
**Behavior:**
|
|
135
135
|
|
|
136
136
|
- The precondition is evaluated per target; a non-passing ASK aborts before the grounding runs.
|
|
137
|
+
- When the command's grounding declares an `exocmd__Grounding_inputSchema`, a REQUIRED key it
|
|
138
|
+
declares is checked **after the command resolves and its precondition passes, but before the
|
|
139
|
+
grounding runs** — on the dry-run and the executing path alike (req `656bd2d9`). The refusal
|
|
140
|
+
names the key, and fires only when nothing declared supplies it: the schema's own non-blank
|
|
141
|
+
`defaultValue`, a `propertyDefault` / `inheritanceRule` / `serviceCallPayload` /
|
|
142
|
+
`Grounding_isDefinedBy` anywhere in the grounding tree, or — for the engine-reserved `label` —
|
|
143
|
+
a `labelTemplate` / `omitLabel`. A grounding that declares no schema is not checked at all.
|
|
144
|
+
- ⛤ A key the schema does NOT declare is **accepted**, by design: passing an extra property key
|
|
145
|
+
through `--input` is a supported way to populate the asset a `create_instance` grounding builds
|
|
146
|
+
(`--input '{"label":"…","ems__Effort_blocker":"[[uid]]"}'`). Only `label`, `body` and
|
|
147
|
+
`plannedDate` are consumed by the engine itself rather than written as properties.
|
|
137
148
|
- Commands marked `exocmd__Command_destructive: true` refuse to run without `--dry-run` or `--yes`.
|
|
138
149
|
- Multi-target runs (stdin) use continue-on-error semantics and print a `N/M` summary; the exit code is `5` if any target failed.
|
|
139
150
|
- `--use-cache` (#4264): the triple store comes from `<vault>/.exocortex/cache/triples.json`
|