@omnitron-dev/omnitron 0.3.1 → 0.3.3

package/dist/shared/dto/nodes.d.ts

@@ -167,8 +167,21 @@ export interface IMeshNodeStatus {
     via: 'direct' | 'ssh-tunnel' | null;
     /** False on a live connection means pings work and no data can be pulled. */
     authenticated: boolean;
+    /** Optional on older peers; no token or signing material is exposed. */
+    credentialExpiresAt?: number | null;
+    credentialRefreshedAt?: number | null;
+    lastCredentialError?: string | null;
     lastHeartbeat: number | null;
     lastError: string | null;
+    /** Absent on older daemons. A transport connection alone does not prove delivery. */
+    reconnectAt?: number | null;
+    reconnectAttempt?: number;
+    cleanupError?: string | null;
+    syncStatus?: import('./project.js').ISyncStatus | null;
+    syncStatusAt?: number | null;
+    lastSyncStatusError?: string | null;
+    lastPullError?: string | null;
+    lastPullAt?: number | null;
 }
 /**
  * What a node's own titan-health reports about it.
@@ -230,37 +243,27 @@ export interface INodeSyncStatus {
     error: string | null;
     sync: import('./project.js').ISyncStatus | null;
 }
-/**
- * A node's telemetry relay, as it reports itself.
- *
- * The companion to `INodeSyncStatus`: that one is the log/metric replication,
- * this one the telemetry relay. It carries the only counter in the fleet that
- * reports LOSS — `relay.buffer.totalDropped`, entries the buffer threw away
- * because it was full. A gap in a chart is otherwise discovered from the chart.
- *
- * `reachable: false` means the node was not asked, and carries why.
- */
+/** A node reports its configured local relay separately from durable fleet replication. */
+export type TelemetryRelayObservation = {
+    state: 'active';
+    stats: ReturnType<import('@omnitron-dev/titan-telemetry-relay').TelemetryRelayService['stats']>;
+} | {
+    state: 'not-applicable';
+    reason: 'worker-uses-durable-replication';
+};
+/** `reachable` describes this read, not the node's general connectivity. */
 export interface INodeRelayStats {
     nodeId: string;
     reachable: boolean;
     error: string | null;
-    /** As `TelemetryRelayService.stats()` returns it; shape owned by that package. */
-    relay: Record<string, unknown> | null;
+    relay: TelemetryRelayObservation | null;
 }
-/**
- * Which node a node believes is the leader.
- *
- * Only meaningful ACROSS nodes: one node's answer is unremarkable, and two
- * nodes naming different leaders — or sitting in different terms — is a split
- * brain, the state in which every node is individually healthy and the fleet
- * is not.
- */
+/** Latest cluster participation or legacy election observation reported by the selected node. */
 export interface INodeClusterState {
     nodeId: string;
     reachable: boolean;
     error: string | null;
-    /** As `LeaderElection.getClusterState()` returns it. */
-    cluster: Record<string, unknown> | null;
+    cluster: import('./cluster.js').NodeClusterObservation | null;
 }
 /**
  * What a rollout will do to one node, decided BEFORE anything is shipped.
@@ -344,4 +347,75 @@ export interface INodeRolloutStart {
         because: string;
     }>;
 }
+export type UpgradePhase = 
+/**
+ * Accepted by the rollout and waiting for a slot.
+ *
+ * Without this, a queued node is indistinguishable from a node nobody
+ * asked about: both have no progress record, and the console can only
+ * show «nothing is happening». On a fleet rolled out at concurrency 2,
+ * waiting is the state MOST nodes are in for MOST of the run, so it is
+ * the one that has to be nameable.
+ */
+'queued' | 'building' | 'transferring' | 'activating' | 'done' | 'failed' | 'refused';
+export interface NodeUpgradeProgress {
+    readonly nodeId: string;
+    readonly phase: UpgradePhase;
+    /** 0-100, for a bar that means something rather than a spinner. */
+    readonly percent: number;
+    readonly message: string;
+    /** The version being installed, once the build has named one. */
+    readonly version: string | null;
+    readonly at: string;
+    /**
+     * Place in the queue, 1-based, while `phase` is `queued`.
+     *
+     * Absent once the node starts: a number that keeps its old value after the
+     * wait is over says something false about the present.
+     */
+    readonly position?: number;
+}
+/** One bounded historical metrics inspection/repair; reuse the cursor after success. */
+export interface INodeReconciliationRequest {
+    nodeId: string;
+    restore?: boolean;
+    after?: string;
+    through?: string;
+    epoch?: string;
+}
+export interface INodeReconciliationResult {
+    nodeId: string;
+    epoch: string;
+    through: string;
+    next: string | null;
+    examined: number;
+    present: number;
+    missing: number;
+    alreadyReconciled: number;
+    reconciled: number;
+    unresolvedSourceRows: number;
+    restored: boolean;
+}
+/** A transition of a sealed backend under its existing execution owner. */
+export interface KernelRolloutTarget {
+    nodeId: string;
+    name: string;
+    state: 'pending' | 'ready' | 'blocked' | 'current' | 'running' | 'succeeded' | 'failed' | 'rolled-back' | 'uncertain';
+    previous: string | null;
+    candidate: string | null;
+    ownerId: string | null;
+    ownerPid: number | null;
+    reason: string | null;
+}
+export interface KernelRollout {
+    id: string;
+    commit: string;
+    /** May copy a sealed artifact during preflight. Selection still requires an explicit start. */
+    stage?: boolean;
+    createdAt: string;
+    updatedAt: string;
+    state: 'planning' | 'planned' | 'blocked' | 'running' | 'succeeded' | 'failed' | 'uncertain';
+    reason: string | null;
+    targets: KernelRolloutTarget[];
+}
 //# sourceMappingURL=nodes.d.ts.map

package/dist/shared/dto/nodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/shared/dto/nodes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/shared/dto/nodes.ts"],"names":[],"mappings":"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"}

package/dist/shared/dto/pipelines.d.ts

@@ -13,7 +13,12 @@ export interface PipelineDef {
 }
 export interface PipelineStep {
     name: string;
+    /** shell commands or a TypeScript script with $, $target and params. */
+    kind?: 'shell' | 'xec';
     run: string;
+    cwd?: string;
+    /** Registered node ID. Omission or local executes locally. */
+    nodeId?: string;
     dependsOn?: string[];
     env?: Record<string, string>;
     timeout?: number;
@@ -26,6 +31,10 @@ export interface PipelineTrigger {
 }
 export interface Pipeline {
     id: string;
+    /** Content revision required when admitting the reviewed definition. */
+    revision: string;
+    /** Older daemons silently ignore update preconditions. Require this before sending an update. */
+    conditionalUpdates?: true;
     name: string;
     description: string | null;
     steps: PipelineStep[];
@@ -35,19 +44,31 @@ export interface Pipeline {
 }
 export interface PipelineRunStepResult {
     name: string;
+    /** Digest of the exact admitted step definition, including its target. */
+    sourceHash?: string;
     status: string;
     duration: number;
     output?: string;
     error?: string;
+    startedAt?: string;
+    completedAt?: string;
+    attempts?: number;
+    exitCode?: number;
+    stderr?: string;
+    outputTruncated?: boolean;
+    nodeId?: string;
+    kind?: 'shell' | 'xec';
 }
 export interface PipelineRun {
     id: string;
     pipelineId: string;
-    status: 'pending' | 'running' | 'success' | 'failed' | 'cancelled';
+    status: 'pending' | 'running' | 'cancelling' | 'success' | 'failed' | 'cancelled' | 'interrupted';
     steps: PipelineRunStepResult[];
     startedAt: string;
     completedAt: string | null;
     triggeredBy: string;
     params: Record<string, unknown> | null;
 }
+/** History rows exclude potentially large step output; retrieve details only for the selected run. */
+export type PipelineRunSummary = Omit<PipelineRun, 'steps' | 'params'>;
 //# sourceMappingURL=pipelines.d.ts.map

package/dist/shared/dto/pipelines.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipelines.d.ts","sourceRoot":"","sources":["../../../src/shared/dto/pipelines.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IACnE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACxC"}
+{"version":3,"file":"pipelines.d.ts","sourceRoot":"","sources":["../../../src/shared/dto/pipelines.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,kBAAkB,CAAC,EAAE,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;IAClG,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACxC;AAED,sGAAsG;AACtG,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC"}

package/dist/shared/dto/project.d.ts

@@ -5,6 +5,26 @@
  * and the daemon's ProjectService.
  */
 import type { DaemonRole, IStackConfig, AppStatus } from '../../config/types.js';
+export interface ConfigurationImport {
+    project: string;
+    name: string;
+    path: string;
+    /** Existing namespace for migration; new imports receive a stable generated namespace. */
+    registration?: string;
+    /** Source stack name -> public stack name within the owning project. */
+    stacks: Record<string, string>;
+    expectedRevision: string;
+}
+export interface ProjectConfigurationInfo {
+    name: string;
+    path: string;
+    runtimeProject: string;
+    stacks: Record<string, string>;
+}
+export interface RuntimeStackScope {
+    project: string;
+    stack: string;
+}
 export interface IProjectInfo {
     /** Registry name (directory-based, e.g. 'omni') */
     name: string;
@@ -20,6 +40,9 @@ export interface IProjectInfo {
     runningStacks: number;
     /** Total number of configured stacks */
     totalStacks: number;
+    /** Configuration sources belong to this project; runtime namespaces are retained for history and recovery. */
+    configurations?: ProjectConfigurationInfo[];
+    catalogRevision?: string;
     /**
      * Set only on the answer to an add of a project already registered at that
      * path: its config was read again, and this many running apps took the new
@@ -83,8 +106,111 @@ export interface IStackAccountRemoved {
     /** The vault key of its password, removed with it — `null` when the vault kept none. */
     vaultKeyRemoved: string | null;
 }
-export type StackStatus = 'stopped' | 'starting' | 'running' | 'stopping' | 'degraded' | 'error';
+export type StackStatus = 'stopped' | 'starting' | 'running' | 'stopping' | 'degraded' | 'error' | 'unknown';
+export interface StackStopReview {
+    project: string;
+    stack: string;
+    /** Explicit acknowledgement: applications stop while infrastructure keeps running. */
+    keepInfrastructure?: true;
+    checkedAt: string;
+    /** Present only when every target was inspected. Changes invalidate this review. */
+    digest: string | null;
+    targets: Array<{
+        node: string;
+        runtime?: RuntimeStackScope;
+        applications?: string[];
+        containers?: string[];
+        reason?: string;
+    }>;
+}
+export interface InstalledStackResumeResult {
+    project: string;
+    stack: string;
+    operationId: string;
+    stopOperationId: string;
+    outcome: 'running' | 'partial' | 'unconfirmed';
+    nodes: Array<{
+        node: string;
+        outcome: 'running' | 'failed' | 'unconfirmed' | 'skipped';
+        apps?: string[];
+        reason?: string;
+        observedAt?: string;
+    }>;
+}
+export interface StackStopProgress {
+    keepInfrastructure?: true;
+    intentCommitted?: boolean;
+    supersededAt?: string;
+    id: string;
+    phase: 'preparing' | 'stopping' | 'stopped' | 'failed';
+    startedAt: string;
+    completedAt?: string;
+    error?: string;
+    nodes: Array<{
+        node: string;
+        outcome: 'checking' | 'prepared' | 'stopping' | 'stopped' | 'unknown';
+        operationId?: string;
+        observedAt?: string;
+        reason?: string;
+        authority?: {
+            clusterId: string;
+            nodeId: string;
+            epoch: string;
+        };
+    }>;
+}
+/** Fresh operator evidence about a host-local prepared payload, not gateway publication. */
+export interface PreparedArtifactVolume {
+    binding: string;
+    service: string;
+    app: string;
+    directory: string;
+    /** Physical source returned by the verified installer on this execution node. */
+    source: string;
+    target: string;
+    readonly: true;
+    releaseId: string;
+    manifestSha256: string;
+    artifactSha256: string;
+}
+export interface ReleaseAdmission {
+    /** Only a successful prepare inspection supplies paths. Requires-stop may retain this
+     * evidence so an operator can publish immutable assets before quiescing applications.
+     * It does not select a release, update a gateway, or authorize any filesystem mutation. */
+    preparedArtifactVolumes?: PreparedArtifactVolume[];
+    ok: boolean;
+    because: string;
+    state?: 'unprepared' | 'requires-stop';
+}
+export interface SelectedRelease {
+    id: string;
+    manifestSha256: string;
+}
+/** Application health is an observation, separate from process lifecycle and start prerequisites. */
+export interface StackHealthObservation {
+    status: 'healthy' | 'degraded' | 'unhealthy' | 'unknown' | 'not-running';
+    observedAt: string | null;
+    apps: Array<{
+        name: string;
+        node: string;
+        status: StackHealthObservation['status'];
+        checks: Array<{
+            name: string;
+            status: string;
+            message?: string;
+        }>;
+    }>;
+}
 export interface IStackInfo {
+    health?: StackHealthObservation;
+    /** Desired release for the next local launch. Runtime evidence is reported separately. */
+    selectedRelease?: SelectedRelease;
+    /** Last explicit recovery of the applications retained by their process owners. */
+    resumeOperation?: InstalledStackResumeResult | undefined;
+    /** Last durable stop operation; failures and unreachable peers remain visible. */
+    stopOperation?: StackStopProgress | undefined;
+    /** Execution/history identity, which can predate this stack's public project/name. */
+    runtimeScope?: RuntimeStackScope;
     /** Stack name (e.g., 'dev', 'test', 'prod') */
     name: string;
     /** Stack deployment type */
@@ -99,6 +225,8 @@ export interface IStackInfo {
     apps: IStackAppStatus[];
     /** Infrastructure services provisioned for this stack */
     infrastructure: IStackInfraStatus;
+    /** Node-qualified observations. Missing peers are retained as unknown placements. */
+    placements?: IStackPlacement[];
     /** Port range allocated to this stack */
     portRange: {
         start: number;
@@ -122,10 +250,9 @@ export interface IStackInfo {
      */
     attachedAt: string | null;
     /**
-     * Set only on the answer to a start of a remote or cluster stack: what the
-     * start did not bring up beyond its app list — `node <host:port>` it could
-     * not reach, `infrastructure on <host:port>: <the node's words>` not up.
-     * Absent when everything came up.
+     * Unavailable resources and observed causes. Local observations include app
+     * launch failures, blocked dependencies and stack-owned infrastructure.
+     * Remote start replies include skipped nodes and unavailable infrastructure.
      */
     notUp?: string[];
 }
@@ -151,47 +278,100 @@ export interface IStackNodeStatus {
  * Sync status for a slave daemon.
  * Tracks local buffer state and last successful sync to master.
  */
+export interface ReplicationEvidence {
+    /** Scope of the durable evidence. No guarantee is inferred before this epoch. */
+    epoch: string;
+    since: string;
+    firstTrackedId: string;
+    producedThrough: string;
+    /** Includes discards and evictions; this is not proof of delivery. */
+    releasedThrough: string;
+    /** Contiguous, durable master receipts starting at firstTrackedId. */
+    committedThrough: string;
+    committedRows: number;
+    discardedRows: number;
+    unverifiedRows: number;
+    evictedRows: number;
+    lastCommittedAt: number | null;
+    lastLossAt: number | null;
+    /** Later verification/restoration, distinct from the original delivery acknowledgement. */
+    reconciliation?: {
+        verifiedRows: number;
+        restoredRows: number;
+        lastReconciledAt: string | null;
+        scope: 'source' | 'master';
+    };
+}
+/** A bounded audit of retained sources; never implies coverage before firstAt. */
+export interface HistoryCoverage {
+    sourceId: string;
+    category: 'metrics' | 'logs';
+    status: 'partial' | 'verified';
+    expectedRows: number;
+    processedRows: number;
+    presentRows: number;
+    restoredRows: number;
+    /** Missing from the live table after configured retention; source archive remains. */
+    expiredRows: number;
+    firstAt: string;
+    lastAt: string;
+    verifiedAt: string | null;
+    precision: 'original' | 'millisecond';
+    gaps: Array<{
+        reason: string;
+        from: string | null;
+        to: string | null;
+        rows: number | null;
+        /** A separate committed source proof; the original audit is retained. */
+        resolution?: {
+            sourceId: string;
+            explanation: string;
+            verifiedAt: string;
+        };
+    }>;
+}
 export interface ISyncStatus {
-    /**
-     * Whether the slave holds a PUSH channel to the master.
-     *
-     * FALSE ON EVERY NODE TODAY, and not a health signal. It is
-     * `SyncService.masterInvoke !== null`, and `setMasterConnection()` has no
-     * production caller — `sync.rpc-service.ts` says so beside `receiveBatch`,
-     * the other end of the same unfinished path. Replication runs the other
-     * way: the master PULLS, with `drainBuffer`/`ackDrained`.
-     *
-     * Do not build «is this node up to date?» on this field. It was done once,
-     * in `summariseSync` and in the `stack status` column, and made «synced» a
-     * state neither could ever print. `pendingItems === 0` is the question
-     * being asked.
-     */
+    /** Legacy reverse-channel indicator. Pull connectivity is observed by the controller. */
     connected: boolean;
     /** Last successful sync timestamp. Advanced by `ackDrained` — the pull path. */
     lastSyncAt: number | null;
     /** Number of buffered items pending sync. Counted from `sync_buffer`. */
     pendingItems: number;
-    /** Local buffer size in bytes, estimated from `pendingItems`. */
+    /** Age of the oldest pending row, measured on the node (no clock skew). Absent on older nodes. */
+    oldestPendingAgeMs?: number | null;
+    /** Age of the last actual acknowledgement, measured on the node. */
+    lastSyncAgeMs?: number | null;
+    /** Actual rows acknowledged per second over the last 60 seconds, including idle time. */
+    deliveryRatePerSecond?: number;
+    /** Pending payload bytes (UTF-8), measured on new nodes; older nodes estimate it. */
     bufferSize: number;
-    /**
-     * Last sync error. ALWAYS NULL today: written only by `noteSyncFailure()`,
-     * which belongs to the push cycle that has no caller.
-     */
+    bufferSizeAccuracy?: 'measured';
+    /** All retained payload bytes, including released records awaiting cleanup. */
+    retainedBufferSize?: number;
+    /** Durable receipts and explicit gaps; absent on peers without evidence tracking. */
+    evidence?: ReplicationEvidence;
+    /** A failed reconciliation-history read must not disappear behind healthy transport. */
+    reconciliationError?: string;
+    /** Earlier source coverage is independent of the current receipt frontier. */
+    history?: HistoryCoverage[];
+    /** Legacy reverse-channel error. The master exposes pull failures through mesh diagnostics. */
     lastError: string | null;
-    /**
-     * Consecutive failed sync attempts. ALWAYS 0 today, for the same reason as
-     * `lastError` — `backoff.attempt` is advanced only on the push path.
-     */
+    /** Legacy reverse-channel retry count. */
     failedAttempts: number;
 }
 export interface IStackAppStatus {
+    /** Observed health of all physical replicas, independent of process status. */
+    health?: StackHealthObservation['status'];
+    release?: import('../../config/types.js').RuntimeReleaseEvidence;
+    /** Owner's launch generation for a single observed replica; absent on older owners. */
+    generation?: string;
     /** App name */
     name: string;
     /** Namespaced handle key: project/stack/app */
     handleKey: string;
     /** Current status */
-    status: AppStatus;
-    /** PID (null if not running) */
+    status: AppStatus | 'degraded' | 'unknown';
+    /** Main PID, or null when stopped or no single process represents the application. */
     pid: number | null;
     /** Number of instances */
     instances: number;
@@ -224,15 +404,46 @@ export interface IStackInfraStatus {
         status: 'running' | 'stopped' | 'error';
         containerName: string;
         port: number | null;
+        service?: string;
+        nodeKey?: string;
+        containerId?: string;
+        image?: string;
+        health?: 'healthy' | 'unhealthy' | 'starting' | 'none';
+        provisioning?: 'pending' | 'ready' | 'failed';
+        error?: string;
+        ports?: Record<string, number>;
+        app?: string;
     }>;
 }
+/** One node's observations, distinct from the desired placement in config.nodes. */
+export interface IStackPlacement {
+    nodeKey: string;
+    host: string;
+    port: number;
+    label: string | null;
+    observedAt: string | null;
+    appsObserved: boolean;
+    infrastructureObserved: boolean;
+    apps: Array<{
+        name: string;
+        expected: boolean;
+        /** Null means absent on an answering node, unknown on a non-answering node. */
+        process: import('../../config/types.js').ProcessInfoDto | null;
+    }>;
+    infrastructure: IStackInfraStatus | null;
+    /** Safe source-level reasons, with no credentials or launch environment. */
+    errors: string[];
+}
 export interface StackRuntime {
+    health?: StackHealthObservation;
     /** Stack name */
     name: string;
     /** Stack type */
     type: 'local' | 'remote' | 'cluster';
     /** Current status */
     status: StackStatus;
+    /** Current unavailable applications and bounded evidence from the last start, as in IStackInfo. */
+    notUp?: string[];
     /** Total apps */
     totalApps: number;
     /** Online apps */
@@ -287,4 +498,52 @@ export interface IStackMaintenance {
         message: string | null;
     } | null;
 }
+/** Configured dependencies, never a claim that a live socket is connected. */
+export interface ProjectDependency {
+    project: string;
+    stack: string;
+    app: string;
+    targetApp?: string;
+    service?: string;
+    host?: string;
+    port?: number;
+    /** Configuration key establishing this relationship, without its value. */
+    via: string;
+    evidence: 'configuration' | 'declaration';
+}
+export interface ProjectTopology {
+    version: 1;
+    generatedAt: string;
+    dependencies: ProjectDependency[];
+    /** Snapshot provenance. Captured declarations do not assert live traffic or connection health. */
+    coverage?: Array<{
+        project: string;
+        stack: string;
+        app: string;
+        source: 'entry' | 'launch' | 'snapshot' | 'memory' | 'missing';
+        capturedAt?: string;
+    }>;
+    /** Canonical ownership of unchanged runtime/history namespaces. */
+    scopes?: Array<{
+        project: string;
+        stack: string;
+        runtimeProject: string;
+        runtimeStack: string;
+    }>;
+    /** Missing definitions/configuration are explicit; a partial graph is not a complete census. */
+    warnings: Array<{
+        project: string;
+        stack?: string;
+        app?: string;
+        reason: string;
+    }>;
+}
+export interface TopologyMetadataRefresh {
+    refreshed: number;
+    failures: Array<{
+        project: string;
+        app: string;
+        reason: string;
+    }>;
+}
 //# sourceMappingURL=project.d.ts.map