@resourcexjs/registry 2.1.0 → 2.2.0

package/README.md

@@ -66,7 +66,7 @@ const rxr = await loadResource("./my-prompt");
 
 // Link to registry
 const registry = createRegistry();
-await registry.link(rxr);
+await registry.add(rxr);
 
 // Now available at: ~/.resourcex/localhost/my-prompt.text@1.0.0/
 ```
@@ -135,7 +135,7 @@ Link a resource to local registry.
 - `resource: RXR` - Complete resource object
 
 ```typescript
-await registry.link(rxr);
+await registry.add(rxr);
 ```
 
 #### `resolve(locator: string): Promise<RXR>`
@@ -358,7 +358,7 @@ const rxr = await loadResource("./my-prompts/assistant");
 const registry = createRegistry();
 
 // 3. Link to local registry
-await registry.link(rxr);
+await registry.add(rxr);
 
 // 4. Resolve later
 const resolved = await registry.resolve("localhost/assistant.prompt@1.0.0");
@@ -374,9 +374,9 @@ console.log(text);
 const registry = createRegistry();
 
 // Link multiple versions
-await registry.link(promptV1); // v1.0.0
-await registry.link(promptV2); // v2.0.0
-await registry.link(promptV3); // v3.0.0
+await registry.add(promptV1); // v1.0.0
+await registry.add(promptV2); // v2.0.0
+await registry.add(promptV3); // v3.0.0
 
 // Resolve specific version
 const v1 = await registry.resolve("localhost/prompt.text@1.0.0");
@@ -392,7 +392,7 @@ const registry = createRegistry({
   path: "./project-registry",
 });
 
-await registry.link(rxr);
+await registry.add(rxr);
 // Stored at: ./project-registry/localhost/...
 ```
 
@@ -406,9 +406,9 @@ const registry = createRegistry({
 });
 
 // Now can handle these custom types
-await registry.link(promptResource);
-await registry.link(toolResource);
-await registry.link(agentResource);
+await registry.add(promptResource);
+await registry.add(toolResource);
+await registry.add(agentResource);
 ```
 
 ## Resolution Strategy

package/dist/index.d.ts

@@ -136,6 +136,18 @@ interface Registry {
 	*/
 	supportType(type: ResourceType): void;
 	/**
+	* Link a development directory to local registry.
+	* Creates a symlink so changes are reflected immediately.
+	* @param path - Path to resource directory (must contain resource.json)
+	*/
+	link(path: string): Promise<void>;
+	/**
+	* Add resource to local registry.
+	* Copies resource content to local storage.
+	* @param source - Resource directory path or RXR object
+	*/
+	add(source: string | RXR): Promise<void>;
+	/**
 	* Pull resource from remote registry to local cache.
 	* Discovers remote registry via well-known and caches locally.
 	* @param locator - Resource locator (must include domain)
@@ -144,15 +156,10 @@ interface Registry {
 	pull(locator: string, options?: PullOptions): Promise<void>;
 	/**
 	* Publish resource to remote registry.
-	* Resource must exist in local first.
-	* @param resource - Resource to publish
-	* @param options - Publish target configuration
-	*/
-	publish(resource: RXR, options: PublishOptions): Promise<void>;
-	/**
-	* Link resource to local registry (for development/caching).
+	* @param source - Resource directory path or RXR object
+	* @param options - Publish target configuration (required)
 	*/
-	link(resource: RXR): Promise<void>;
+	publish(source: string | RXR, options: PublishOptions): Promise<void>;
 	/**
 	* Get raw resource by locator string.
 	* Returns the RXR (locator + manifest + content) without resolving.
@@ -231,12 +238,18 @@ declare class LocalRegistry implements Registry {
 	*/
 	private findArea;
 	/**
+	* Check if a path is a symlink.
+	*/
+	private isSymlink;
+	/**
 	* Load resource from a specific path.
+	* If path is a symlink, loads from the linked directory using FolderLoader.
 	*/
 	private loadFrom;
+	link(path: string): Promise<void>;
+	add(source: string | RXR2): Promise<void>;
 	pull(_locator: string, _options?: PullOptions): Promise<void>;
-	publish(_resource: RXR2, _options: PublishOptions): Promise<void>;
-	link(resource: RXR2): Promise<void>;
+	publish(_source: string | RXR2, _options: PublishOptions): Promise<void>;
 	get(locator: string): Promise<RXR2>;
 	resolve<
 		TArgs = void,
@@ -271,9 +284,10 @@ declare class RemoteRegistry implements Registry {
 	private readonly typeHandler;
 	constructor(config: RemoteRegistryConfig);
 	supportType(type: ResourceType3): void;
+	link(_path: string): Promise<void>;
+	add(_source: string | RXR3): Promise<void>;
 	pull(_locator: string, _options?: PullOptions): Promise<void>;
-	publish(_resource: RXR3, _options: PublishOptions): Promise<void>;
-	link(_resource: RXR3): Promise<void>;
+	publish(_source: string | RXR3, _options: PublishOptions): Promise<void>;
 	get(locator: string): Promise<RXR3>;
 	resolve<
 		TArgs = void,
@@ -291,10 +305,6 @@ declare class RemoteRegistry implements Registry {
 declare function discoverRegistry(domain: string): Promise<DiscoveryResult>;
 import { RXR as RXR4, RXL as RXL4 } from "@resourcexjs/core";
 import { ResourceType as ResourceType4, ResolvedResource as ResolvedResource4 } from "@resourcexjs/type";
-/**
-* Git-based registry implementation.
-* Clones a git repository and reads resources from it.
-*/
 declare class GitRegistry implements Registry {
 	private readonly url;
 	private readonly ref;
@@ -302,6 +312,7 @@ declare class GitRegistry implements Registry {
 	private readonly cacheDir;
 	private readonly typeHandler;
 	private readonly arp;
+	private readonly isLocal;
 	constructor(config: GitRegistryConfig);
 	/**
 	* Build cache directory name from git URL.
@@ -315,6 +326,8 @@ declare class GitRegistry implements Registry {
 	private toArpUrl;
 	/**
 	* Ensure the repository is cloned and up to date.
+	* For local paths, just verify the .git directory exists.
+	* For remote URLs, includes retry logic for transient network errors.
 	*/
 	private ensureCloned;
 	/**
@@ -322,10 +335,6 @@ declare class GitRegistry implements Registry {
 	*/
 	private getDefaultBranch;
 	/**
-	* Execute git command in the cache directory.
-	*/
-	private gitExec;
-	/**
 	* Build filesystem path for a resource in the cloned repo.
 	* Path structure: {cacheDir}/{basePath}/{domain}/{path}/{name}.{type}/{version}
 	*/
@@ -338,9 +347,10 @@ declare class GitRegistry implements Registry {
 	exists(locator: string): Promise<boolean>;
 	search(options?: SearchOptions): Promise<RXL4[]>;
 	private parseEntryToRXL;
+	link(_path: string): Promise<void>;
+	add(_source: string | RXR4): Promise<void>;
 	pull(_locator: string, _options?: PullOptions): Promise<void>;
-	publish(_resource: RXR4, _options: PublishOptions): Promise<void>;
-	link(_resource: RXR4): Promise<void>;
+	publish(_source: string | RXR4, _options: PublishOptions): Promise<void>;
 	delete(_locator: string): Promise<void>;
 }
 /**
@@ -381,9 +391,10 @@ declare abstract class RegistryMiddleware implements Registry {
 	protected readonly inner: Registry;
 	constructor(inner: Registry);
 	supportType(type: ResourceType5): void;
+	link(path: string): Promise<void>;
+	add(source: string | RXR5): Promise<void>;
 	pull(locator: string, options?: PullOptions): Promise<void>;
-	publish(resource: RXR5, options: PublishOptions): Promise<void>;
-	link(resource: RXR5): Promise<void>;
+	publish(source: string | RXR5, options: PublishOptions): Promise<void>;
 	get(locator: string): Promise<RXR5>;
 	resolve<
 		TArgs = void,