reffy-cli 1.5.0 → 1.7.0

package/dist/index.d.ts

@@ -4,5 +4,5 @@ export { runDoctor } from "./doctor.js";
 export { createPlanScaffold } from "./plan.js";
 export { loadDotEnvIfPresent, parseDotEnv } from "./env.js";
 export { ensureGitignoreEntries } from "./gitignore.js";
-export { collectWorkspaceDocuments, ensureRemoteInit, extractWorkspaceIdentity, PaseoRemoteClient, readRemoteConfig, resolveRemoteConfigPath, resolveRemoteTarget, resolveSelectedWorkspaceId, toCanonicalRemotePath, writeRemoteConfig, } from "./remote.js";
+export { collectWorkspaceDocuments, ensureManagerInit, ensureWorkspaceTarget, extractWorkspaceSummaryIdentity, PaseoManagerClient, PaseoWorkspaceBackendClient, readRemoteConfig, resolveRemoteConfigPath, resolveRemoteTarget, resolveSelectedWorkspaceId, toCanonicalRemotePath, writeRemoteConfig, } from "./remote.js";
 export { listSpecs, showSpec } from "./spec-runtime.js";

package/dist/index.js

@@ -4,5 +4,5 @@ export { runDoctor } from "./doctor.js";
 export { createPlanScaffold } from "./plan.js";
 export { loadDotEnvIfPresent, parseDotEnv } from "./env.js";
 export { ensureGitignoreEntries } from "./gitignore.js";
-export { collectWorkspaceDocuments, ensureRemoteInit, extractWorkspaceIdentity, PaseoRemoteClient, readRemoteConfig, resolveRemoteConfigPath, resolveRemoteTarget, resolveSelectedWorkspaceId, toCanonicalRemotePath, writeRemoteConfig, } from "./remote.js";
+export { collectWorkspaceDocuments, ensureManagerInit, ensureWorkspaceTarget, extractWorkspaceSummaryIdentity, PaseoManagerClient, PaseoWorkspaceBackendClient, readRemoteConfig, resolveRemoteConfigPath, resolveRemoteTarget, resolveSelectedWorkspaceId, toCanonicalRemotePath, writeRemoteConfig, } from "./remote.js";
 export { listSpecs, showSpec } from "./spec-runtime.js";

package/dist/remote.d.ts

@@ -1,8 +1,10 @@
-import type { RemoteDocument, RemoteImportResult, RemoteLinkConfig, RemoteTarget, RemoteWorkspaceSummary } from "./types.js";
-export declare const REMOTE_CONFIG_VERSION = 2;
+import type { RemoteActorIdentity, RemoteDocument, RemoteImportResult, RemoteLinkConfig, RemoteTarget, RemoteWorkspaceSummary } from "./types.js";
+export declare const REMOTE_CONFIG_VERSION = 4;
 export declare const REMOTE_PROVIDER = "paseo";
 export declare const REMOTE_BACKEND_ACTOR_TYPE = "reffyRemoteBackend";
 export declare const REMOTE_BACKEND_VERSION = "v2";
+export declare const REMOTE_MANAGER_ACTOR_TYPE = "reffyWorkspaceManager";
+export declare const REMOTE_MANAGER_VERSION = "v1";
 export interface WorkspaceIdentity {
     project_id: string;
     workspace_id: string;
@@ -13,24 +15,10 @@ export interface ManifestIdentityLike {
 }
 export interface ResolvedRemoteTarget {
     endpoint: string;
-    pod_name: string;
-    actor_id: string;
+    manager: RemoteActorIdentity;
+    workspace_backend: RemoteActorIdentity;
     last_imported_at?: string;
 }
-export interface EnsureRemoteInitOptions {
-    endpoint: string;
-    podName?: string;
-    actorId?: string;
-    provision: boolean;
-    identity: WorkspaceIdentity;
-    existingConfig: RemoteLinkConfig | null;
-}
-export interface EnsureRemoteInitResult {
-    config: RemoteLinkConfig;
-    target: RemoteTarget;
-    created_pod: boolean;
-    created_actor: boolean;
-}
 export interface ValidatedImportResult {
     imported: number;
     created: number;
@@ -43,50 +31,144 @@ export declare function requireWorkspaceIdentity(identity: ManifestIdentityLike,
 export declare function readRemoteConfig(repoRoot: string): Promise<RemoteLinkConfig | null>;
 export declare function writeRemoteConfig(repoRoot: string, config: RemoteLinkConfig): Promise<string>;
 export declare function updateRemoteConfigMetadata(repoRoot: string, workspaceId: string, patch: Partial<Pick<RemoteTarget, "last_imported_at">>): Promise<RemoteLinkConfig | null>;
-export declare function resolveRemoteTarget(stored: RemoteLinkConfig | null, workspaceId: string, overrides: {
-    endpoint?: string;
-    pod_name?: string;
-    actor_id?: string;
-}): ResolvedRemoteTarget | null;
+export declare function removeWorkspaceTarget(repoRoot: string, existing: RemoteLinkConfig, workspaceId: string): Promise<{
+    config: RemoteLinkConfig;
+    existed: boolean;
+}>;
+export declare function upsertWorkspaceTarget(repoRoot: string, existing: RemoteLinkConfig, workspaceId: string, workspaceBackend: RemoteActorIdentity): Promise<RemoteLinkConfig>;
+export declare function resolveRemoteTarget(stored: RemoteLinkConfig | null, workspaceId: string, endpoint: string): ResolvedRemoteTarget | null;
 export declare function describeRemoteLinkage(linkage: {
     endpoint: string;
-    pod_name: string;
-    actor_id: string;
+    manager: RemoteActorIdentity;
+    workspace_backend: RemoteActorIdentity;
     workspace_id: string;
 }): string;
-export declare class PaseoRemoteClient {
-    private readonly config;
-    constructor(config: {
-        endpoint: string;
-        pod_name: string;
-        actor_id: string;
-    });
+export declare class RemoteHttpError extends Error {
+    readonly status: number;
+    readonly body: string;
+    readonly url: string;
+    readonly method: string;
+    constructor(status: number, statusText: string, body: string, url: string, method: string);
+}
+export interface ManagerWorkspaceResponse {
+    workspace?: {
+        workspace_id?: string;
+        backend?: {
+            pod_name?: string;
+            actor_id?: string;
+        };
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface ManagerProjectListResponse {
+    projects?: Array<{
+        project_id?: string;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+export interface ManagerProjectResponse {
+    project?: {
+        project_id?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface CreateManagerActorResult {
+    actorId: string;
+    managerAuthToken: string;
+}
+export declare class PaseoManagerClient {
+    private readonly endpoint;
+    private readonly identity;
+    private readonly token?;
+    constructor(endpoint: string, identity: RemoteActorIdentity, token?: string);
+    private base;
+    private requireToken;
     createPod(): Promise<string>;
-    createActor(identity: WorkspaceIdentity): Promise<string>;
-    getWorkspace(workspaceId: string): Promise<RemoteWorkspaceSummary>;
-    importWorkspace(workspaceId: string, documents: RemoteDocument[], replaceMissing?: boolean): Promise<RemoteImportResult>;
-    getSnapshot(workspaceId: string, prefix?: string): Promise<{
-        documents?: Array<{
-            path?: string;
-        }>;
+    createManagerActor(podName: string): Promise<CreateManagerActorResult>;
+    createWorkspace(workspaceId: string, metadata?: Record<string, unknown>): Promise<RemoteActorIdentity>;
+    getWorkspace(workspaceId: string): Promise<RemoteActorIdentity>;
+    registerProject(workspaceId: string, projectId: string): Promise<{
+        alreadyRegistered: boolean;
     }>;
-    getDocument(workspaceId: string, documentPath: string): Promise<{
-        document?: {
-            path?: string;
-            content?: string;
-            content_type?: string;
-        };
+    listProjects(workspaceId: string): Promise<ManagerProjectListResponse>;
+    getProject(workspaceId: string, projectId: string): Promise<ManagerProjectResponse>;
+    deleteWorkspace(workspaceId: string): Promise<{
+        alreadyAbsent: boolean;
     }>;
 }
-export declare function ensureRemoteInit(repoRoot: string, options: EnsureRemoteInitOptions): Promise<EnsureRemoteInitResult>;
-export declare function extractWorkspaceIdentity(summary: RemoteWorkspaceSummary): {
-    project_id?: string | null;
+export interface ProjectDocumentListResponse {
+    documents?: Array<{
+        path?: string;
+        content?: string;
+        content_type?: string;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+export interface ProjectDocumentResponse {
+    document?: {
+        path?: string;
+        content?: string;
+        content_type?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface ProjectSnapshotResponse {
+    snapshot?: Record<string, unknown>;
+    documents?: Array<{
+        path?: string;
+    }>;
+}
+export declare class PaseoWorkspaceBackendClient {
+    private readonly endpoint;
+    private readonly identity;
+    private readonly token;
+    constructor(endpoint: string, identity: RemoteActorIdentity, token: string);
+    private base;
+    getWorkspace(): Promise<RemoteWorkspaceSummary>;
+    importProject(projectId: string, documents: RemoteDocument[], replaceMissing?: boolean): Promise<RemoteImportResult>;
+    listProjectDocuments(projectId: string, options?: {
+        prefix?: string;
+    }): Promise<ProjectDocumentListResponse>;
+    getProjectDocument(projectId: string, documentPath: string): Promise<ProjectDocumentResponse>;
+    getProjectSnapshot(projectId: string): Promise<ProjectSnapshotResponse>;
+}
+export interface EnsureManagerInitOptions {
+    endpoint: string;
+    managerPodName?: string;
+    managerActorId?: string;
+    provision: boolean;
+    existingConfig: RemoteLinkConfig | null;
+}
+export interface EnsureManagerInitResult {
+    config: RemoteLinkConfig;
+    created_pod: boolean;
+    created_actor: boolean;
+    /** Bearer token returned by the backend when a fresh manager actor was created. Only set when `created_actor` is true. */
+    manager_auth_token?: string;
+}
+export declare function ensureManagerInit(repoRoot: string, options: EnsureManagerInitOptions): Promise<EnsureManagerInitResult>;
+export type WorkspaceTargetMode = "create" | "resolve" | "auto";
+export interface EnsureWorkspaceTargetOptions {
+    workspaceId: string;
+    mode: WorkspaceTargetMode;
+    endpoint: string;
+    token: string;
+    metadata?: Record<string, unknown>;
+}
+export interface EnsureWorkspaceTargetResult {
+    config: RemoteLinkConfig;
+    workspace_backend: RemoteActorIdentity;
+    outcome: "created" | "resolved" | "reused";
+}
+export declare function ensureWorkspaceTarget(repoRoot: string, config: RemoteLinkConfig, options: EnsureWorkspaceTargetOptions): Promise<EnsureWorkspaceTargetResult>;
+export declare function extractWorkspaceSummaryIdentity(summary: RemoteWorkspaceSummary): {
     workspace_id?: string | null;
     actor_type?: string | null;
     backend_version?: string | null;
     document_count?: number | null;
+    registered_project_count?: number | null;
 };
-export declare function assertRemoteIdentity(summary: RemoteWorkspaceSummary, identity: WorkspaceIdentity): void;
+export declare function assertWorkspaceSummaryIdentity(summary: RemoteWorkspaceSummary, expectedWorkspaceId: string): void;
 export declare function validateImportResult(result: RemoteImportResult): ValidatedImportResult;
 export declare function toCanonicalRemotePath(refsDir: string, filePath: string): string;
 export declare function collectWorkspaceDocuments(repoRoot: string): Promise<RemoteDocument[]>;