@h-rig/contracts 0.0.6-alpha.176 → 0.0.6-alpha.178

package/dist/src/task-state-store.d.ts

@@ -1,6 +1,19 @@
 import type { CapabilityId } from "./capability-id";
-import type { TaskConfigEntry } from "./task-source";
+import type { TaskConfigEntry } from "./task-config";
+import type { TaskTerminalStateInput } from "./task-source";
 import type { TaskStateMetadataEnvelope } from "./task-state-metadata";
+export type TaskFailedApproachRecordInput = {
+    readonly projectRoot: string;
+    readonly taskId?: string;
+    readonly text: string;
+    readonly timestamp?: string;
+};
+export type TaskFailedApproachRecordResult = {
+    readonly taskId: string;
+    readonly attempts: number;
+    readonly path: string;
+    readonly message: string;
+};
 /** Local `.rig` task state/config/metadata only; no runtime/provider guidance. */
 export interface TaskStateStoreService {
     readCurrentTaskId(projectRoot: string): string | null;
@@ -11,6 +24,13 @@ export interface TaskStateStoreService {
     writeSourceTaskConfig(projectRoot: string, entries: Record<string, TaskConfigEntry>): void;
     readTaskStateMetadata(projectRoot: string): TaskStateMetadataEnvelope | null;
     writeTaskStateMetadata(projectRoot: string, envelope: TaskStateMetadataEnvelope): void;
+    recordFailedApproach(input: TaskFailedApproachRecordInput): TaskFailedApproachRecordResult;
 }
 export declare const TASK_STATE_STORE_CAPABILITY_ID = "task-state.store";
 export declare const TASK_STATE_STORE: CapabilityId<TaskStateStoreService>;
+/** Local task-state-owned terminal-state check over `.rig/task-config.json`. */
+export interface TaskStateTerminalStateService {
+    isTaskTerminal(input: TaskTerminalStateInput): Promise<boolean>;
+}
+export declare const TASK_STATE_TERMINAL_STATE_CAPABILITY_ID = "task-state.terminal-state";
+export declare const TASK_STATE_TERMINAL_STATE: CapabilityId<TaskStateTerminalStateService>;

package/dist/src/task-state-store.js

@@ -7,7 +7,11 @@ function makeCapabilityId(id) {
 // packages/contracts/src/task-state-store.ts
 var TASK_STATE_STORE_CAPABILITY_ID = "task-state.store";
 var TASK_STATE_STORE = makeCapabilityId(TASK_STATE_STORE_CAPABILITY_ID);
+var TASK_STATE_TERMINAL_STATE_CAPABILITY_ID = "task-state.terminal-state";
+var TASK_STATE_TERMINAL_STATE = makeCapabilityId(TASK_STATE_TERMINAL_STATE_CAPABILITY_ID);
 export {
+  TASK_STATE_TERMINAL_STATE_CAPABILITY_ID,
+  TASK_STATE_TERMINAL_STATE,
   TASK_STATE_STORE_CAPABILITY_ID,
   TASK_STATE_STORE
 };

package/dist/src/task-tracker-state.d.ts

@@ -7,6 +7,8 @@ export type TaskTrackerPolicyDecision = {
     readonly allowed: boolean;
     readonly code?: "claim-conflict" | "status-conflict";
     readonly reason?: string;
+    /** Owner-supplied compare-and-set precondition for tracker persistence. */
+    readonly expectedLifecycleStatus?: CanonicalTaskLifecycleStatus | readonly CanonicalTaskLifecycleStatus[];
 };
 export type TrackerPullRequestEvidence = {
     readonly branchName?: string | null;
@@ -65,8 +67,9 @@ export type TaskTrackerStateUpdateInput = {
     readonly taskId: string;
     readonly lifecycleStatus: CanonicalTaskLifecycleStatus;
     readonly metadata?: TaskStateMetadata | null;
-    /** @deprecated OWNER-TODO: remove when callers pass reconciliation evidence only to TASK_TRACKER_RECONCILIATION_POLICY. */
-    readonly evidence?: TrackerReconcileEvidence;
+    /** Lifecycle-owner supplied transition precondition. Required by the legacy task-state wrapper. */
+    readonly allowedFrom?: readonly CanonicalTaskLifecycleStatus[];
+    readonly reason?: string;
 };
 export type TaskTrackerStateClaimInput = {
     readonly projectRoot: string;
@@ -90,15 +93,7 @@ export declare const TASK_TRACKER_REPO_LOCATOR: CapabilityId<TaskTrackerRepoLoca
 /** Tracker snapshot/persistence API. Keep this shape stable for legacy callers. */
 export interface TaskTrackerStateService {
     readSnapshot(projectRoot: string, options?: ReadSyncedTrackerOptions): SyncedTrackerSnapshot;
-    /** @deprecated Use TASK_TRACKER_READINESS_POLICY. OWNER-TODO: remove after scheduler queue consumers switch seams. */
-    listReadyTaskIds(snapshot: SyncedTrackerSnapshot): readonly string[];
     normalizeStatus(status: unknown): CanonicalTaskLifecycleStatus | null;
-    /** @deprecated Use TASK_TRACKER_RECONCILIATION_POLICY. OWNER-TODO: remove after lifecycle consumers switch seams. */
-    projectReconciliation(input: {
-        readonly lifecycleStatus: CanonicalTaskLifecycleStatus;
-        readonly metadata: TaskStateMetadata | null;
-        readonly evidence?: TrackerReconcileEvidence;
-    }): TaskReconciliationProjection;
     claimTask(input: TaskTrackerStateClaimInput): TaskStateMetadataEnvelope | Promise<TaskStateMetadataEnvelope>;
     updateLifecycle(input: TaskTrackerStateUpdateInput): TaskStateMetadataEnvelope | Promise<TaskStateMetadataEnvelope>;
 }

package/dist/src/toolchain-sources.d.ts

@@ -42,7 +42,7 @@ export interface ToolchainSourceContribution {
 }
 /** Stable id for @rig/guard-plugin's toolchain-source contribution. */
 export declare const GUARD_TOOLCHAIN_SOURCES_CAPABILITY_ID = "rig.toolchain.sources.guard";
-/** Stable id for @rig/bundle-default-lifecycle's toolchain-source contribution. */
+/** Stable id for @rig/lifecycle-plugin's toolchain-source contribution. */
 export declare const LIFECYCLE_TOOLCHAIN_SOURCES_CAPABILITY_ID = "rig.toolchain.sources.lifecycle";
 /**
  * The guard-plugin toolchain-source capability id. `defineCapability(...)` (the

package/dist/src/transport-config.d.ts

@@ -0,0 +1,161 @@
+import type { CapabilityId } from "./capability-id";
+export type TransportConfigEnv = Readonly<Record<string, string | undefined>>;
+export declare const DEFAULT_REMOTE_PORT = 7890;
+export type RemoteConfigEntry = {
+    host?: string;
+    port?: number;
+    token?: string;
+    addedAt?: string;
+    lastConnected?: string;
+};
+export type RemotesToml = {
+    version?: number;
+    remotes?: Record<string, RemoteConfigEntry>;
+};
+export type AuthorityRemoteEndpointRecord = {
+    id: string;
+    alias: string;
+    host: string;
+    port: number;
+    transport: string;
+    auto_connect: boolean;
+    labels: string[];
+    capabilities: string[];
+    secret_ref: string;
+    created_at: string;
+    updated_at: string;
+    last_connected_at?: string | null;
+};
+export type AuthorityRemoteEndpointsToml = {
+    version?: number;
+    endpoints?: Record<string, AuthorityRemoteEndpointRecord>;
+};
+export type AuthorityRemoteSecretsToml = {
+    version?: number;
+    secrets?: Record<string, string>;
+};
+export type AuthorityMaterializedRemoteEndpoint = {
+    id: string;
+    alias: string;
+    host: string;
+    port: number;
+    token: string;
+    autoConnect: boolean;
+    addedAt: string;
+    updatedAt: string;
+    lastConnectedAt: string | null;
+    labels: string[];
+    capabilities: string[];
+    transport: string;
+    secretRef: string;
+};
+export type ManagedRemoteEndpoint = {
+    id: string;
+    alias: string;
+    host: string;
+    port: number;
+    token: string;
+    addedAt: string | null;
+    lastConnected: string | null;
+};
+export type RemoteEndpointMigrationResult = {
+    readonly imported: number;
+    readonly skipped: number;
+    readonly sourcePath: string;
+};
+export type RemoteEndpointDoctorResult = {
+    readonly manifestPath: string;
+    readonly secretsPath: string;
+    readonly endpointCount: number;
+    readonly missingSecrets: readonly string[];
+    readonly warnings: readonly string[];
+};
+export type SelectedRemote = {
+    alias: string;
+    host: string;
+    port: number;
+    sshTarget: string;
+    checkout: string | null;
+    registryBaseUrl: string | null;
+    secretRef: string | null;
+};
+export type DispatchTransportPlacement = {
+    readonly kind: "local";
+    readonly alias: "local";
+    readonly sshTarget: null;
+    readonly selected: null;
+} | {
+    readonly kind: "remote";
+    readonly alias: string;
+    readonly sshTarget: string;
+    readonly selected: SelectedRemote | null;
+};
+export interface TransportConfigService {
+    readonly resolveRelayUrl: (input?: {
+        readonly env?: TransportConfigEnv;
+    }) => string;
+    readonly resolveSshTarget: (input?: {
+        readonly env?: TransportConfigEnv;
+    }) => string;
+    readonly listManagedRemoteEndpoints: (input?: {
+        readonly configPath?: string;
+        readonly projectRoot?: string;
+    }) => readonly ManagedRemoteEndpoint[];
+    readonly upsertManagedRemoteEndpoint: (input: {
+        readonly endpoint: {
+            readonly alias: string;
+            readonly host: string;
+            readonly port: number;
+            readonly token?: string;
+        };
+        readonly configPath?: string;
+        readonly projectRoot?: string;
+    }) => ManagedRemoteEndpoint;
+    readonly updateAuthorityRemoteEndpoint: (input: {
+        readonly projectRoot: string;
+        readonly endpoint: {
+            readonly endpointId?: string;
+            readonly alias?: string;
+            readonly host?: string;
+            readonly port?: number;
+            readonly token?: string;
+            readonly autoConnect?: boolean;
+            readonly transport?: string;
+            readonly labels?: readonly string[];
+            readonly capabilities?: readonly string[];
+        };
+    }) => AuthorityMaterializedRemoteEndpoint | null;
+    readonly removeManagedRemoteEndpoint: (input: {
+        readonly alias: string;
+        readonly configPath?: string;
+        readonly projectRoot?: string;
+    }) => boolean;
+    readonly migrateManagedRemoteEndpoints: (input: {
+        readonly projectRoot: string;
+        readonly legacyPath?: string;
+    }) => RemoteEndpointMigrationResult;
+    readonly doctorManagedRemoteEndpoints: (input: {
+        readonly projectRoot: string;
+    }) => RemoteEndpointDoctorResult;
+    readonly resolveSelectedRemote: (input: {
+        readonly projectRoot: string;
+        readonly env?: TransportConfigEnv;
+    }) => SelectedRemote | null;
+    readonly resolveDispatchTransportPlacement: (input: {
+        readonly projectRoot: string;
+        readonly env?: TransportConfigEnv;
+    }) => DispatchTransportPlacement;
+    readonly resolveRegistryBaseUrl: (input: {
+        readonly projectRoot: string;
+        readonly env?: TransportConfigEnv;
+    }) => string;
+    readonly resolveOwnerNamespaceKey: (input: {
+        readonly projectRoot: string;
+        readonly env?: TransportConfigEnv;
+    }) => string | null;
+    readonly resolveRigOmpConfigOverlayPath: (input: {
+        readonly projectRoot: string;
+    }) => string;
+}
+export declare const TRANSPORT_CONFIG_CAPABILITY_ID = "rig.transport.config";
+export declare const TRANSPORT_CONFIG: CapabilityId<TransportConfigService>;

package/dist/src/transport-config.js

@@ -0,0 +1,15 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/transport-config.ts
+var DEFAULT_REMOTE_PORT = 7890;
+var TRANSPORT_CONFIG_CAPABILITY_ID = "rig.transport.config";
+var TRANSPORT_CONFIG = makeCapabilityId(TRANSPORT_CONFIG_CAPABILITY_ID);
+export {
+  TRANSPORT_CONFIG_CAPABILITY_ID,
+  TRANSPORT_CONFIG,
+  DEFAULT_REMOTE_PORT
+};

package/dist/src/workflow-journal.d.ts

@@ -1,3 +1,4 @@
+import type { CapabilityId } from "./capability-id";
 export declare const RIG_WORKFLOW_STARTED: "rig.workflow.started";
 export declare const RIG_WORKFLOW_TARGET_SELECTED: "rig.workflow.target.selected";
 export declare const RIG_WORKFLOW_TASK_SELECTED: "rig.workflow.task.selected";
@@ -45,6 +46,38 @@ export type RigWorkflowOperatorNote = {
     note: string;
     notedAt: string;
 };
+export type RigWorkflowStartedInput = Omit<RigWorkflowStarted, "schemaVersion" | "createdAt"> & {
+    createdAt?: string;
+};
+export type RigWorkflowTargetSelectedInput = Omit<RigWorkflowTargetSelected, "schemaVersion" | "selectedAt"> & {
+    selectedAt?: string;
+};
+export type RigWorkflowTaskSelectedInput = Omit<RigWorkflowTaskSelected, "schemaVersion" | "selectedAt"> & {
+    selectedAt?: string;
+};
+export type RigWorkflowStatusChangedInput = Omit<RigWorkflowStatusChanged, "schemaVersion" | "changedAt"> & {
+    changedAt?: string;
+};
+export type RigWorkflowOperatorNoteInput = Omit<RigWorkflowOperatorNote, "schemaVersion" | "notedAt"> & {
+    notedAt?: string;
+};
+/** Minimal writable session/custom-entry surface for workflow fact writers. */
+export interface RigWorkflowEntryAppender {
+    appendEntry<T = unknown>(customType: string, data?: T): void;
+}
+/**
+ * Owner-side workflow journal writer. Consumers pass an OMP/custom-entry appender
+ * and unversioned fact inputs; the owner mints wire entries and appends them.
+ */
+export interface RigWorkflowJournalWriterService {
+    appendStarted(appender: RigWorkflowEntryAppender, input: RigWorkflowStartedInput): void;
+    appendTargetSelected(appender: RigWorkflowEntryAppender, input: RigWorkflowTargetSelectedInput): void;
+    appendTaskSelected(appender: RigWorkflowEntryAppender, input: RigWorkflowTaskSelectedInput): void;
+    appendStatusChanged(appender: RigWorkflowEntryAppender, input: RigWorkflowStatusChangedInput): void;
+    appendOperatorNote(appender: RigWorkflowEntryAppender, input: RigWorkflowOperatorNoteInput): void;
+}
+export declare const RIG_WORKFLOW_JOURNAL_WRITER_CAPABILITY_ID = "rig.workflow.journal-writer";
+export declare const RIG_WORKFLOW_JOURNAL_WRITER: CapabilityId<RigWorkflowJournalWriterService>;
 export type RigWorkflowInboxRequested = {
     schemaVersion: 1;
     requestId: string;

package/dist/src/workflow-journal.js

@@ -1,4 +1,9 @@
 // @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
 // packages/contracts/src/workflow-journal.ts
 var RIG_WORKFLOW_STARTED = "rig.workflow.started";
 var RIG_WORKFLOW_TARGET_SELECTED = "rig.workflow.target.selected";
@@ -7,12 +12,16 @@ var RIG_WORKFLOW_STATUS_CHANGED = "rig.workflow.status.changed";
 var RIG_WORKFLOW_OPERATOR_NOTE = "rig.workflow.operator.note";
 var RIG_WORKFLOW_INBOX_REQUESTED = "rig.workflow.inbox.requested";
 var RIG_WORKFLOW_INBOX_RESOLVED = "rig.workflow.inbox.resolved";
+var RIG_WORKFLOW_JOURNAL_WRITER_CAPABILITY_ID = "rig.workflow.journal-writer";
+var RIG_WORKFLOW_JOURNAL_WRITER = makeCapabilityId(RIG_WORKFLOW_JOURNAL_WRITER_CAPABILITY_ID);
 export {
   RIG_WORKFLOW_TASK_SELECTED,
   RIG_WORKFLOW_TARGET_SELECTED,
   RIG_WORKFLOW_STATUS_CHANGED,
   RIG_WORKFLOW_STARTED,
   RIG_WORKFLOW_OPERATOR_NOTE,
+  RIG_WORKFLOW_JOURNAL_WRITER_CAPABILITY_ID,
+  RIG_WORKFLOW_JOURNAL_WRITER,
   RIG_WORKFLOW_INBOX_RESOLVED,
   RIG_WORKFLOW_INBOX_REQUESTED
 };

package/dist/src/workspace-service.d.ts

@@ -0,0 +1,16 @@
+/** Typed workspace-domain service seam owned by @rig/workspace-plugin. */
+import type { CapabilityId } from "./capability-id";
+export interface WorkspaceServiceFabricMutationInput {
+    readonly projectRoot: string;
+    readonly command: "up" | "verify" | "down";
+    readonly services?: readonly string[];
+}
+export interface WorkspaceService {
+    readonly readSummary: (projectRoot: string) => Promise<unknown>;
+    readonly readTopology: (projectRoot: string) => unknown;
+    readonly readRemoteFleet: (projectRoot: string) => unknown;
+    readonly readServiceFabric: (projectRoot: string) => Promise<unknown>;
+    readonly mutateServiceFabric: (input: WorkspaceServiceFabricMutationInput) => Promise<unknown>;
+}
+export declare const WORKSPACE_SERVICE_CAPABILITY_ID = "rig.workspace.service";
+export declare const WORKSPACE_SERVICE: CapabilityId<WorkspaceService>;

package/dist/src/workspace-service.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/workspace-service.ts
+var WORKSPACE_SERVICE_CAPABILITY_ID = "rig.workspace.service";
+var WORKSPACE_SERVICE = makeCapabilityId(WORKSPACE_SERVICE_CAPABILITY_ID);
+export {
+  WORKSPACE_SERVICE_CAPABILITY_ID,
+  WORKSPACE_SERVICE
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/contracts",
-  "version": "0.0.6-alpha.176",
+  "version": "0.0.6-alpha.178",
   "type": "module",
   "description": "Rig package",
   "license": "UNLICENSED",
@@ -61,6 +61,10 @@
     "./plugin-hooks": {
       "types": "./dist/src/plugin-hooks.d.ts",
       "import": "./dist/src/plugin-hooks.js"
+    },
+    "./session-hook-materializer": {
+      "types": "./dist/src/session-hook-materializer.d.ts",
+      "import": "./dist/src/session-hook-materializer.js"
     }
   },
   "engines": {