@kitelev/exocortex-cli 16.116.0 → 16.116.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/README.md +51 -69
- package/dist/index.js +203 -363
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -42,30 +42,29 @@ The following v15 verbs were **removed**: `batch`, `batch-repair`, `command`, `d
|
|
|
42
42
|
|
|
43
43
|
## Command Overview
|
|
44
44
|
|
|
45
|
-
| Command
|
|
46
|
-
|
|
|
47
|
-
| [`find`](#find)
|
|
48
|
-
| [`apply`](#apply)
|
|
49
|
-
| [`query`](#query)
|
|
50
|
-
| [`index`](#index)
|
|
51
|
-
| [`validate`](#validate)
|
|
52
|
-
| [`
|
|
53
|
-
| [`
|
|
54
|
-
| [`
|
|
55
|
-
| [`
|
|
56
|
-
| [`
|
|
57
|
-
| [`
|
|
58
|
-
| [`
|
|
59
|
-
| [`
|
|
60
|
-
| [`
|
|
61
|
-
| [`
|
|
62
|
-
| [`
|
|
63
|
-
| [`assetspace-
|
|
64
|
-
| [`
|
|
65
|
-
| [`exosync`](#exosync)
|
|
66
|
-
| [`
|
|
67
|
-
| [`
|
|
68
|
-
| [`experimental`](#experimental) | Opt-in experimental features (`rest-push`) |
|
|
45
|
+
| Command | Purpose |
|
|
46
|
+
| ----------------------------------------- | ---------------------------------------------------------------------------------- |
|
|
47
|
+
| [`find`](#find) | Select vault assets via SPARQL or class filter; prints file paths one per line |
|
|
48
|
+
| [`apply`](#apply) | Apply a vault-defined `exocmd__Command` to one or more assets |
|
|
49
|
+
| [`query`](#query) | Execute a SPARQL query against the vault |
|
|
50
|
+
| [`index`](#index) | Build or refresh the persistent triple cache |
|
|
51
|
+
| [`validate`](#validate) | Validate vault files: `iri`, `schema`, `frontmatter` |
|
|
52
|
+
| [`classes`](#classes) | List vault classes or describe one class |
|
|
53
|
+
| [`create`](#create) | Create a new vault asset with auto-generated UUID and frontmatter |
|
|
54
|
+
| [`resolve`](#resolve) | Resolve a UUID (full or partial) to a file path |
|
|
55
|
+
| [`watch`](#watch) | Watch the vault for file changes; emit NDJSON events |
|
|
56
|
+
| [`workflow`](#workflow) | List / show / validate workflow definitions |
|
|
57
|
+
| [`recover`](#recover) | Detect and recover orphaned claude-child tmux sessions |
|
|
58
|
+
| [`daemon`](#daemon) | Manage the ValidatorDaemon background process |
|
|
59
|
+
| [`audit`](#audit) | Regression-pattern audits (`co-location`, `ontology-imports`) |
|
|
60
|
+
| [`apply-profile`](#apply-profile) | Apply an `exo__Profile` (mount-state filesystem mutation) |
|
|
61
|
+
| [`bootstrap`](#bootstrap) | Bootstrap a vault with the SDK floor AssetSpace |
|
|
62
|
+
| [`assetspace-add`](#assetspace-add) | Add a single AssetSpace to a vault by GitHub URL |
|
|
63
|
+
| [`assetspace-remove`](#assetspace-remove) | Unmount a single AssetSpace from a vault (inverse of `assetspace-add`) |
|
|
64
|
+
| [`exosync`](#exosync) | Sync / pull / push the materialized AssetSpace set over the GitHub REST API |
|
|
65
|
+
| [`exosync-parity`](#exosync-parity) | Read-only ExoSync divergence report (M1/M2 parity check) |
|
|
66
|
+
| [`resolve-deps`](#resolve-deps) | Resolve an AssetSpace's transitive `dependsOn` closure from the registry (CI gate) |
|
|
67
|
+
| [`experimental`](#experimental) | Opt-in experimental features (`rest-push`) |
|
|
69
68
|
|
|
70
69
|
---
|
|
71
70
|
|
|
@@ -290,23 +289,6 @@ Check vault frontmatter for missing/empty properties and malformed IRIs.
|
|
|
290
289
|
|
|
291
290
|
## Auxiliary Commands
|
|
292
291
|
|
|
293
|
-
### ask
|
|
294
|
-
|
|
295
|
-
Ask a question in natural language (Russian or English) about your vault. Converts the question to SPARQL and executes it.
|
|
296
|
-
|
|
297
|
-
```bash
|
|
298
|
-
npx @kitelev/exocortex-cli ask "активные проекты" --vault ~/vault
|
|
299
|
-
npx @kitelev/exocortex-cli ask "what tasks are due today" --show-query --vault ~/vault
|
|
300
|
-
```
|
|
301
|
-
|
|
302
|
-
| Option | Default | Description |
|
|
303
|
-
| ----------------- | ------- | ------------------------------------------------- |
|
|
304
|
-
| `--vault <path>` | cwd | Path to Obsidian vault |
|
|
305
|
-
| `--format <type>` | `table` | Output format: `table` or `json` |
|
|
306
|
-
| `--output <type>` | `text` | Response format: `text` or `json` (for MCP tools) |
|
|
307
|
-
| `--show-query` | off | Show the generated SPARQL query |
|
|
308
|
-
| `--explain` | off | Show an explanation of the query conversion |
|
|
309
|
-
|
|
310
292
|
### classes
|
|
311
293
|
|
|
312
294
|
List all classes in the vault, or show details of one class. Alias: `describe-class`.
|
|
@@ -522,12 +504,12 @@ npx @kitelev/exocortex-cli assetspace-remove \
|
|
|
522
504
|
--folder assetspaces/kitelev/exoas-pmbok-ontology
|
|
523
505
|
```
|
|
524
506
|
|
|
525
|
-
| Option | Default | Description
|
|
526
|
-
| ----------------- | ------------ |
|
|
527
|
-
| `--vault <path>` | **required** | Path to the target vault
|
|
507
|
+
| Option | Default | Description |
|
|
508
|
+
| ----------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------- |
|
|
509
|
+
| `--vault <path>` | **required** | Path to the target vault |
|
|
528
510
|
| `--folder <path>` | — | Vault-relative mount path to unmount (e.g. `assetspaces/kitelev/exoas-pmbok-ontology`). Takes precedence over `--url`. |
|
|
529
|
-
| `--url <url>` | — | Public GitHub URL of the AssetSpace — derives the canonical mount path (parity with `assetspace-add`).
|
|
530
|
-
| `--json` | off | Emit result as JSON
|
|
511
|
+
| `--url <url>` | — | Public GitHub URL of the AssetSpace — derives the canonical mount path (parity with `assetspace-add`). |
|
|
512
|
+
| `--json` | off | Emit result as JSON |
|
|
531
513
|
|
|
532
514
|
Provide exactly one of `--folder` or `--url`.
|
|
533
515
|
|
|
@@ -549,15 +531,15 @@ npx @kitelev/exocortex-cli exosync push --vault ~/vault --token-from-gh # send
|
|
|
549
531
|
|
|
550
532
|
All three accept:
|
|
551
533
|
|
|
552
|
-
| Option | Default
|
|
553
|
-
| ------------------------- |
|
|
554
|
-
| `--vault <path>` | **required** | Vault root path
|
|
555
|
-
| `--config-dir <name>` | `.obsidian`
|
|
556
|
-
| `--quarantine-repo <url>` | —
|
|
557
|
-
| `--token <pat>` | —
|
|
558
|
-
| `--token-from-gh` | off
|
|
559
|
-
| `--json` | off
|
|
560
|
-
| `--api-base <url>` | —
|
|
534
|
+
| Option | Default | Description |
|
|
535
|
+
| ------------------------- | ------------ | --------------------------------------------------------------------------------------- |
|
|
536
|
+
| `--vault <path>` | **required** | Vault root path |
|
|
537
|
+
| `--config-dir <name>` | `.obsidian` | Obsidian config dir name (watermark location) |
|
|
538
|
+
| `--quarantine-repo <url>` | — | Quarantine repo URL (`https://github.com/<owner>/<repo>`) — **required for FileSpaces** |
|
|
539
|
+
| `--token <pat>` | — | GitHub PAT (or env `GITHUB_TOKEN` / `GH_TOKEN`). Prefer `--token-from-gh`. |
|
|
540
|
+
| `--token-from-gh` | off | Resolve the PAT via `gh auth token` |
|
|
541
|
+
| `--json` | off | Print the full per-repo result array as JSON |
|
|
542
|
+
| `--api-base <url>` | — | GitHub API base (testing) |
|
|
561
543
|
|
|
562
544
|
Exit codes: `0` all clean · `1` at least one repo unresolved/errored · `2` vacuous (no materialized AssetSpaces found).
|
|
563
545
|
|
|
@@ -571,14 +553,14 @@ Read-only ExoSync divergence report (RFC `4e4dc453` Phase E, M1/M2). Compares th
|
|
|
571
553
|
npx @kitelev/exocortex-cli exosync-parity --vault ~/vault --token-from-gh
|
|
572
554
|
```
|
|
573
555
|
|
|
574
|
-
| Option | Default
|
|
575
|
-
| --------------------- |
|
|
576
|
-
| `--vault <path>` | **required** | Vault root path
|
|
577
|
-
| `--config-dir <name>` | `.obsidian`
|
|
578
|
-
| `--token <pat>` | —
|
|
579
|
-
| `--token-from-gh` | off
|
|
580
|
-
| `--json` | off
|
|
581
|
-
| `--api-base <url>` | —
|
|
556
|
+
| Option | Default | Description |
|
|
557
|
+
| --------------------- | ------------ | -------------------------------------------------------------------------- |
|
|
558
|
+
| `--vault <path>` | **required** | Vault root path |
|
|
559
|
+
| `--config-dir <name>` | `.obsidian` | Obsidian config dir name (watermark location) |
|
|
560
|
+
| `--token <pat>` | — | GitHub PAT (or env `GITHUB_TOKEN` / `GH_TOKEN`). Prefer `--token-from-gh`. |
|
|
561
|
+
| `--token-from-gh` | off | Resolve the PAT via `gh auth token` |
|
|
562
|
+
| `--json` | off | Print the full round record as JSON |
|
|
563
|
+
| `--api-base <url>` | — | GitHub API base (testing) |
|
|
582
564
|
|
|
583
565
|
Exit codes: `0` in parity · `1` divergence found · `2` vacuous (no materialized sync units).
|
|
584
566
|
|
|
@@ -592,12 +574,12 @@ npx @kitelev/exocortex-cli resolve-deps \
|
|
|
592
574
|
--self kitelev/exoas-ems-ontology
|
|
593
575
|
```
|
|
594
576
|
|
|
595
|
-
| Option | Default | Description
|
|
596
|
-
| ------------------- | ------------ |
|
|
597
|
-
| `--registry <path>` | **required** | Path to a checked-out central registry (`kitelev/exoas-registry`)
|
|
577
|
+
| Option | Default | Description |
|
|
578
|
+
| ------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------ |
|
|
579
|
+
| `--registry <path>` | **required** | Path to a checked-out central registry (`kitelev/exoas-registry`) |
|
|
598
580
|
| `--self <id>` | **required** | Identity of the calling repo: an `owner/repo` slug (matches GitHub's `github.repository`), a full git URL, or a bare namespace |
|
|
599
|
-
| `--format <type>` | `urls` | Output format: `urls` (one clone URL per line) or `json` (full diagnostics)
|
|
600
|
-
| `--strict` | off | Exit non-zero (`2`) when `self` is not registered, instead of validating standalone
|
|
581
|
+
| `--format <type>` | `urls` | Output format: `urls` (one clone URL per line) or `json` (full diagnostics) |
|
|
582
|
+
| `--strict` | off | Exit non-zero (`2`) when `self` is not registered, instead of validating standalone |
|
|
601
583
|
|
|
602
584
|
### experimental
|
|
603
585
|
|
|
@@ -652,7 +634,7 @@ Validation commands (`validate iri`, `validate schema`, `audit co-location`, `ar
|
|
|
652
634
|
|
|
653
635
|
## Structured JSON Responses
|
|
654
636
|
|
|
655
|
-
Commands that accept `--output json` (e.g. `query`, `
|
|
637
|
+
Commands that accept `--output json` (e.g. `query`, `classes`, `resolve`, `index`, `validate`, `workflow`, `audit`) emit a structured response envelope for MCP tools and automation:
|
|
656
638
|
|
|
657
639
|
```json
|
|
658
640
|
{
|