@ricsam/r5d-worker 0.0.74 → 0.0.76

package/dist/types/workspace-convergence.d.ts

@@ -1,93 +0,0 @@
-export declare const WORKSPACE_PUBLICATION_QUIET_MS = 5000;
-export declare const WORKSPACE_IDLE_SAFETY_SCAN_MS = 60000;
-export type WorkspacePublicationState = "idle" | "scheduled" | "preparing" | "submitting" | "blocked";
-export type WorkspaceConvergenceSnapshot = {
-    localHead: string | null;
-    desiredCanonicalHead: string | null;
-    dirtyGeneration: number;
-    publishedGeneration: number;
-    publicationState: WorkspacePublicationState;
-};
-export type ExplicitWorkspacePublication<TTrigger> = {
-    requestId: string;
-    trigger: TTrigger;
-};
-export type WorkspaceManifestRevisionToken = {
-    sequence: number;
-    revision: string;
-};
-export declare class WorkspaceManifestRevisionFence {
-    private sequence;
-    private requestedRevision;
-    private completedRevision;
-    begin(revision: string): WorkspaceManifestRevisionToken;
-    isCurrent(token: WorkspaceManifestRevisionToken): boolean;
-    complete(token: WorkspaceManifestRevisionToken): boolean;
-    readyRevision(): string | null;
-}
-export declare function workspacePublicationTelemetry(input: {
-    requestedAt: number;
-    prepareStartedAt: number;
-    synchronizeStartedAt: number;
-    finishedAt: number;
-}): {
-    totalMs: number;
-    queueMs: number;
-    prepareMs: number;
-    synchronizeMs: number;
-};
-export declare function workspacePublicationIncidentAction(requestId: string | undefined): "defer_automatic" | "request_terminal_authority";
-export declare class ExplicitWorkspacePublicationQueue<TTrigger> {
-    private scheduled;
-    private readonly queued;
-    schedule(publication: ExplicitWorkspacePublication<TTrigger>, pendingRequestId?: string): boolean;
-    hasScheduled(): boolean;
-    consumeScheduled(requestId: string): void;
-    enqueue(publication: ExplicitWorkspacePublication<TTrigger>, pendingRequestId?: string): void;
-    next(): ExplicitWorkspacePublication<TTrigger> | undefined;
-}
-type PersistedWorkspaceConvergenceState = Omit<WorkspaceConvergenceSnapshot, "publicationState"> & {
-    visibleBaselineHead: string | null;
-};
-export declare function readWorkspaceConvergenceState(statePath: string): PersistedWorkspaceConvergenceState;
-export declare class WorkspaceConvergenceState {
-    private readonly statePath;
-    private state;
-    private publicationState;
-    constructor(statePath: string);
-    snapshot(): WorkspaceConvergenceSnapshot;
-    visibleBaselineHead(): string | null;
-    setLocalHead(localHead: string | null): void;
-    setVisibleBaselineHead(visibleBaselineHead: string | null): void;
-    observeCanonicalHead(canonicalHead: string | null): boolean;
-    markDirty(): number;
-    schedule(): void;
-    beginPreparing(): void;
-    beginSubmitting(): void;
-    defer(): void;
-    block(): void;
-    releaseBlock(): void;
-    observeIncidentState(blocked: boolean): void;
-    resetTransientPublicationState(): void;
-    complete(input: {
-        generation: number;
-        canonicalHead: string | null;
-        published: boolean;
-    }): void;
-    private persist;
-}
-export declare function processWorkspaceConvergenceState(statePath: string): WorkspaceConvergenceState;
-export declare function workspaceBootstrapEstablishesVisibleBaseline(input: {
-    hydrated: boolean;
-    firstBootstrap: boolean;
-    incidentActive: boolean;
-    currentLocalHead: string | null;
-    currentVisibleBaselineHead: string | null;
-}): boolean;
-export declare function waitForWorkspacePublicationOnShutdown(input: {
-    snapshot: () => WorkspaceConvergenceSnapshot;
-    forcePublication: () => void;
-    timeoutMs?: number;
-    pollMs?: number;
-}): Promise<"settled" | "blocked" | "timed_out">;
-export {};

package/dist/types/workspace-manifest-admission.d.ts

@@ -1,22 +0,0 @@
-export type WorkspaceManifestCheckout = {
-    projectId: string;
-    checkoutPathSegments: [namespace: string, project: string];
-    branches: string[];
-};
-export type WorkspaceManifestFilesystemState = {
-    firstBootstrap: boolean;
-    missingCheckouts: Array<{
-        projectId: string;
-        branchName: string;
-    }>;
-};
-/**
- * Inspects manifest-related filesystem state without reserving visible paths.
- * Missing checkouts are target-specific pending work and hydrate
- * opportunistically without delaying unrelated targets or running commands.
- */
-export declare function inspectWorkspaceManifestFilesystem(input: {
-    projectsRoot: string;
-    workspaceShadowRoot: string;
-    projects: WorkspaceManifestCheckout[];
-}): WorkspaceManifestFilesystemState;

package/dist/types/workspace-sync.d.ts

@@ -1,167 +0,0 @@
-import { type CheckoutPathSegments } from "./managed-paths";
-import { type WorkspaceMutationLease } from "./workspace-mutation-gate";
-export declare const WORKSPACE_BRANCH = "main";
-export declare const WORKSPACE_INTENT_REF_PREFIX = "refs/r5d/workspace-intents/";
-export declare const WORKSPACE_PUBLICATION_REF_PREFIX = "refs/r5d/workspace-publications/";
-export declare const MAX_WORKSPACE_SYNC_DIFF_BYTES: number;
-export type WorkspaceProjectManifestEntry = {
-    projectId: string;
-    checkoutPathSegments: CheckoutPathSegments;
-    projectPath: string;
-    repoHttpUrl: string | null;
-    repoAuthHeader: string | null;
-    defaultBranch: string;
-    branches: string[];
-    canonicalCheckouts: Array<{
-        branchName: string;
-        scaffoldCommitHash: string;
-    }>;
-};
-export type WorkspaceSyncTrigger = {
-    type: "connect" | "inbound_head" | "write" | "edit" | "shell_inline" | "process_terminal" | "process_cancel" | "periodic" | "manual" | "remediation" | "remediation_confirm" | "remediation_reset";
-    sessionId?: string;
-    processRunId?: string;
-    toolCallId?: string;
-    projectId?: string;
-    branchName?: string;
-    /**
-     * Restricts this synchronization to the exact canonical resolver checkout
-     * identified by projectId/branchName. Ordinary synchronization never reads
-     * or writes canonical resolver checkout subtrees.
-     */
-    canonicalCheckoutOnly?: boolean;
-    detail?: string;
-};
-export type WorkspaceSyncOutcome = "no_change" | "candidate_ready" | "published" | "updated" | "conflict_reset" | "large_diff_blocked" | "conflict_blocked" | "reset" | "failed";
-export type WorkspaceSyncResult = {
-    type: "workspace_sync";
-    attemptId: string;
-    workerLabel: string;
-    trigger: WorkspaceSyncTrigger;
-    outcome: WorkspaceSyncOutcome;
-    startingHead: string | null;
-    expectedHead?: string | null;
-    candidateHead?: string;
-    quarantineRef?: string;
-    publishedHead?: string;
-    rebaseCount: number;
-    diffSizeBytes: number;
-    gitStatus: string;
-    affectedProjects: string[];
-    affectedPaths: string[];
-    discardedPaths: string[];
-    localChangesDiscarded: boolean;
-    dirtyGeneration?: number;
-    sampledCanonicalCheckoutTreeHash?: string;
-    telemetry?: {
-        totalMs: number;
-        queueMs: number;
-        prepareMs: number;
-        synchronizeMs: number;
-    };
-    error?: string;
-};
-export type WorkspaceSyncInput = {
-    attemptId?: string;
-    workerLabel: string;
-    remoteUrl: string;
-    authHeader?: string;
-    projectsRoot: string;
-    plansRoot: string;
-    shadowRoot: string;
-    projects: WorkspaceProjectManifestEntry[];
-    trigger: WorkspaceSyncTrigger;
-    /**
-     * Server-issued, attempt-scoped destination for candidate object uploads.
-     * Workers never publish the canonical workspace branch directly.
-     */
-    quarantineRef?: string;
-    /** Exact canonical head fenced by publication authority. */
-    expectedCanonicalHead?: string | null;
-    /** Elected incident candidate pinned only while preparing remediation. */
-    expectedIncidentCandidateHead?: string;
-    /**
-     * Commit whose tree the visible workspace most recently reflected.
-     * Exact remediation may advance the disposable shadow checkout without
-     * hydrating visible files. A later visible snapshot must therefore rebuild
-     * its delta from this durable baseline before rebasing onto canonical main.
-     */
-    visibleBaselineHead?: string | null;
-    confirmedLargeDiff?: boolean;
-    confirmationReason?: string;
-    resetToCanonical?: boolean;
-    skipVisibleMirror?: boolean;
-    newVisibleCheckouts?: Array<{
-        projectId: string;
-        branchName: string;
-    }>;
-};
-export declare function encodeWorkspaceBranch(branchName: string): string;
-/**
- * Treat canonical resolver checkouts as a separate synchronization authority.
- * Generic workspace scans omit them; an explicitly scoped request contains
- * exactly one resolver checkout and no sibling branches.
- */
-export declare function workspaceProjectsForSync(projects: readonly WorkspaceProjectManifestEntry[], trigger: WorkspaceSyncTrigger): WorkspaceProjectManifestEntry[];
-export declare function workspaceProjectBranchRelativePath(projectId: string, branchName: string): string;
-export declare function workspacePlansRelativePath(projectId: string, branchName: string): string;
-export declare const WORKSPACE_NATIVE_PLANS_RELATIVE_PATH = "workspace-plans";
-export declare function visibleProjectBranchPath(projectsRoot: string, manifest: WorkspaceProjectManifestEntry, branchName: string): string;
-type GitlinkEntry = {
-    filePath: string;
-    objectId: string;
-};
-type VisibleHydrationEntry = {
-    kind: "blob";
-    mode: "100644" | "100755" | "120000";
-    objectId: string;
-} | {
-    kind: "gitlink";
-    objectId: string;
-};
-type VisibleHydrationPreimage = Map<string, VisibleHydrationEntry>;
-type VisibleHydrationPreimages = Map<string, VisibleHydrationPreimage | null>;
-type GitlinkProjection = {
-    entries: GitlinkEntry[];
-    opaqueRoots: string[];
-    visiblePreimages?: VisibleHydrationPreimages;
-};
-export declare function assertCanonicalCheckoutIndexMatchesWorktree(checkoutPath: string): void;
-export declare function mirrorVisibleWorkspaceToShadow(input: WorkspaceSyncInput, excludedCheckouts?: ReadonlySet<string>): GitlinkProjection;
-export declare function mirrorShadowWorkspaceToVisible(input: WorkspaceSyncInput, opaqueWorkspaceRoots?: readonly string[], hydrationPreimages?: VisibleHydrationPreimages): void;
-export declare function assertWorkspaceQuarantineRef(quarantineRef: string): void;
-export declare function synchronizeWorkspace(rawInput: WorkspaceSyncInput): Promise<WorkspaceSyncResult>;
-export type WorkspaceHeadConvergenceResult = {
-    localHead: string | null;
-    canonicalHead: string | null;
-    localChanges: boolean;
-    hydrated: boolean;
-    hydrationConflicts: string[];
-};
-/**
- * Fetches the newest canonical head without treating an inbound overlap as an
- * incident. A busy caller passes hydrateVisible=false, which updates only the
- * remote-tracking ref. An idle caller may hydrate only after proving that its
- * visible tree still matches the local workspace head.
- */
-export declare function convergeWorkspaceHead(rawInput: WorkspaceSyncInput, options: {
-    hydrateVisible: boolean;
-}): Promise<WorkspaceHeadConvergenceResult>;
-/** Returns a local-only fingerprint. Unlike the legacy periodic observation it
- * deliberately ignores whether origin/main has advanced. */
-export declare function calculateWorkspaceLocalDiffFingerprint(rawInput: WorkspaceSyncInput): string;
-export declare function calculateWorkspaceDiffFingerprint(rawInput: WorkspaceSyncInput): string;
-export declare class WorkspaceSyncSingleFlight {
-    private readonly mutationGate;
-    private queue;
-    private enqueue;
-    run(input: WorkspaceSyncInput): Promise<WorkspaceSyncResult>;
-    runPrepared(prepare: () => WorkspaceSyncInput): Promise<WorkspaceSyncResult>;
-    fingerprint(input: WorkspaceSyncInput): Promise<string>;
-    fingerprintPrepared(prepare: () => WorkspaceSyncInput): Promise<string>;
-    runExclusive<T>(operation: () => Promise<T> | T): Promise<T>;
-    runMutation<T>(operation: () => Promise<T> | T): Promise<T>;
-    acquireMutation(): Promise<WorkspaceMutationLease>;
-    afterCurrent(): Promise<void>;
-}
-export {};