wiki-graph-core 0.4.0 → 0.4.1

package/data/help/commands/library-predicate.jinja

@@ -107,7 +107,7 @@ Usage:
 
 Notes:
   - The status tells whether the library index is current, dirty, missing, or disabled.
-  - Library-wide `--query` and naked scope enumeration require a current library index.
+  - Library-wide object `--query` and object scope enumeration require a current library index.
   - Run `enable` when the status says the index needs to be built or rebuilt.
 {% elif target.kind == "scope" and target.objectUri == "wikg://index" and predicate == "enable" %}
 Purpose:
@@ -133,7 +133,7 @@ Usage:
 
 Notes:
   - This does not delete the library registry, metadata, folder, or managed `.wikg` archives.
-  - Library-wide `--query` and naked scope enumeration will fail until the index is enabled again.
+  - Library-wide object `--query` and object scope enumeration will fail until the index is enabled again.
   - Library indexes do not support archive-style `embed` or `external` modes.
   - Disable holds the library write lock and cannot run concurrently with membership changes or index rebuild for the same library.
 {% elif target.kind == "scope" and predicate == "add" %}

package/data/help/commands/library.jinja

@@ -121,8 +121,9 @@ Predicate commands:
 Library archive membership
 
 Default behavior:
-  - `{{ commandName }} {{ uri }}` reads the registry entry for this library archive member.
-  - The membership entry identifies the archive id, relative path, status, and containing library.
+  - `{{ commandName }} {{ uri }}` reads the archive member page for this managed archive.
+  - The member page shows the member URI, readable label or relative path, status, and business entry URIs for `/chapter`, `/entity`, `/triple`, and `inspect`.
+  - Registry fields such as physical path, size, mtime, and mutation token are diagnostic metadata.
   - `{{ commandName }} {{ uri }} inspect` checks readiness for this managed archive's contents, not the library registry.
   - Add archive object suffixes such as `/chapter`, `/entity`, or `/triple` when you want to query the archive contents.
 
@@ -165,11 +166,12 @@ Related help:
 Library scope
 
 Default behavior:
-  - `{{ commandName }} {{ uri }}` reads this library scope.
+  - `{{ commandName }} {{ uri }}` reads the library-wide scope collection.
   - Use `{{ commandName }} wikg://lib/registry` to list all library registries.
-  - `{{ commandName }} {{ uri }} --query <query>` runs a broad library index search across indexed object types.
+  - `{{ commandName }} {{ uri }} --query <query>` searches library-wide objects through the library index.
   - `{{ commandName }} {{ uri }}/arc scan` reconciles membership with `.wikg` files currently under the library folder.
   - Library-wide object scopes such as `/entity` and `/triple` query one object type through the library index after it is enabled.
+  - Archive object search must use an explicit lens such as `/entity`, `/triple`, `/chapter`, or `/chunk`.
 
 Use when:
   - You need to manage a folder of `.wikg` archives as one library.
@@ -181,15 +183,15 @@ Use when:
 {% endif %}
 
 URI forms:
-  - `{{ commandName }} wikg://lib` addresses the default library.
-  - `{{ commandName }} wikg://lib/<lib-id>` addresses a non-default library.
+  - `{{ commandName }} wikg://lib` addresses the default library root scope.
+  - `{{ commandName }} wikg://lib/<lib-id>` addresses a non-default library root scope.
   - `{{ commandName }} wikg://lib/arc/<archive-id>/` addresses one archive membership in the default library.
   - `{{ commandName }} wikg://lib/<lib-id>/arc/<archive-id>/` addresses one archive membership in a non-default library.
 
 Usage:
 {% if target.isDefault %}
-  {{ commandName }} wikg://lib
-  {{ commandName }} wikg://lib --query <query>
+  {{ commandName }} wikg://lib [--json]
+  {{ commandName }} wikg://lib --query <query> [--limit <n>] [--cursor <cursor>] [--json]
   {{ commandName }} wikg://lib/chapter --query <query>
   {{ commandName }} wikg://lib/chunk --query <query>
   {{ commandName }} wikg://lib/registry add --path <folder> [--json]
@@ -202,8 +204,8 @@ Usage:
   {{ commandName }} wikg://lib/triple --query <query>
   {{ commandName }} wikg://lib/meta [--json]
 {% else %}
-  {{ commandName }} {{ uri }}
-  {{ commandName }} {{ uri }} --query <query>
+  {{ commandName }} {{ uri }} [--json]
+  {{ commandName }} {{ uri }} --query <query> [--limit <n>] [--cursor <cursor>] [--json]
   {{ commandName }} {{ uri }}/chapter --query <query>
   {{ commandName }} {{ uri }}/chunk --query <query>
   {{ commandName }} {{ uri }}/arc scan [--json|--jsonl]

package/data/help/commands/predicate.jinja

@@ -380,7 +380,7 @@ Usage:
 
 Notes:
   - This does not delete the library registry, metadata, folder, or managed `.wikg` archives.
-  - Library-wide `--query` and naked scope enumeration will fail until the index is enabled again.
+  - Library-wide object `--query` and object scope enumeration will fail until the index is enabled again.
   - Library indexes do not support archive-style `embed` or `external` modes.
   - Disable holds the library write lock and cannot run concurrently with membership changes or index rebuild for the same library.
 {% else %}

package/data/help/topics/library.jinja

@@ -12,7 +12,8 @@ Core model:
   - The default library is addressed as `wikg://lib`.
   - A non-default library is addressed as `wikg://lib/<lib-id>`.
   - The `arc` reserved segment keeps library ids distinct from archive member ids.
-  - `{{ commandName }} wikg://lib` reads the default library scope; it does not list all library registries or archive memberships.
+  - `{{ commandName }} wikg://lib` reads the default library root scope.
+  - `{{ commandName }} wikg://lib --query <query>` searches library-wide objects through the library index.
 
 Registry discovery:
   - `{{ commandName }} wikg://lib/registry add --path <folder>` prints the new non-default library URI.
@@ -30,15 +31,16 @@ Library folders:
 Archive memberships:
   - `{{ commandName }} wikg://lib/arc scan` recursively discovers `.wikg` files under the default library folder and reconciles registry state.
   - `{{ commandName }} wikg://lib/arc add --input <path> [--to <relative-wikg-path>]` copies one `.wikg` file into the default library folder and registers it.
-  - `{{ commandName }} wikg://lib/arc/tree` shows the archive member file tree; use this instead of naked `wikg://lib` or `wikg://lib/arc` when you want to see archive members.
+  - `{{ commandName }} wikg://lib` and `{{ commandName }} wikg://lib/arc` separate the library root scope from archive membership management; use `{{ commandName }} wikg://lib/arc/tree` when you want a file tree visualization.
   - For a non-default library, replace `wikg://lib` with `wikg://lib/<lib-id>` in those `arc` commands.
   - `{{ commandName }} <library-archive-uri>/path set <relative-wikg-path>` moves or renames one managed archive inside the same folder.
   - `{{ commandName }} <library-archive-uri> remove --confirm` deletes one managed archive file and unregisters it.
   - Missing registered files remain visible as missing or stale until `arc scan`, archive `path set`, archive `remove`, or library `path set` resolves them.
 
 Library archive shortcuts:
-  - `wikg://lib/arc/<archive-id>/` addresses one archive membership in the default library.
-  - `wikg://lib/<lib-id>/arc/<archive-id>/` addresses one archive membership in a non-default library.
+  - `wikg://lib/arc/<archive-id>/` addresses one archive member page in the default library.
+  - `wikg://lib/<lib-id>/arc/<archive-id>/` addresses one archive member page in a non-default library.
+  - The archive member page exposes the managed archive's business entry URIs (`/chapter`, `/entity`, `/triple`, and `inspect`) and keeps registry fields as diagnostic metadata.
   - Add normal archive object suffixes after the trailing slash to query that archive's contents:
     {{ commandName }} wikg://lib/arc/<archive-id>/chapter
     {{ commandName }} wikg://lib/arc/<archive-id>/entity --query "term"
@@ -48,6 +50,7 @@ Library archive shortcuts:
   - `{{ commandName }} <library-archive-uri>/entity --help` explains the archive object scope reached through that library shortcut.
 
 Library-wide query:
+  - `{{ commandName }} wikg://lib --query <archive-term>` searches library-wide objects through the library index.
   - `{{ commandName }} wikg://lib/entity --query <query>` searches across present archive members through the library index.
   - `{{ commandName }} wikg://lib/triple --query <query>` searches library-wide Knowledge Graph triples.
   - `{{ commandName }} wikg://lib/chunk --query <query>` searches library-wide Reading Graph chunks.
@@ -68,7 +71,7 @@ Library index lifecycle:
 Concurrency:
   - Library registry and membership writes hold the library write lock.
   - `arc scan`, `arc add`, library `path set`, library archive `path set`, library archive `remove`, and library index `enable` or `disable` cannot run concurrently for the same library.
-  - Library-wide `--query`, naked scope enumeration, evidence, related, and pack commands read the current aggregate index.
+  - Library-wide object `--query`, object scope enumeration, evidence, related, and pack commands read the current aggregate index.
   - If a write marks the aggregate index dirty, rebuild it with `{{ commandName }} <library-uri>/index enable` before relying on library-wide query results.
 
 Upgrade and cleanup:

package/data/help/topics/uri.jinja

@@ -23,6 +23,8 @@ Archive locator:
 Library locators:
   - `wikg://lib` addresses the default library.
   - `wikg://lib/<lib-id>` addresses a non-default library.
+  - Naked library scopes enumerate library-wide objects; `--query` on a naked library scope searches library-wide objects through the library index.
+  - Use explicit object lenses such as `/entity`, `/triple`, `/chapter`, or `/chunk` for archive object search.
   - `wikg://lib/arc/<archive-id>/` addresses one archive membership in the default library.
   - `wikg://lib/<lib-id>/arc/<archive-id>/` addresses one archive membership in a non-default library.
   - Add ordinary archive object suffixes after the trailing slash to query a managed archive: