@omnitron-dev/omnitron 0.3.0 → 0.3.2

package/dist/infrastructure/config-payload.d.ts

@@ -7,14 +7,14 @@
  * container runs on the master.
  *
  * On a node it cannot. The node has no copy of the project: measured on the
- * test server, `ls -d /root/daos /opt/daos` finds nothing, and
- * `daos-test-gateway` came up with an empty `Mounts` array, a null entrypoint,
+ * test server, `ls -d /root/sample /opt/sample` finds nothing, and
+ * `sample-test-gateway` came up with an empty `Mounts` array, a null entrypoint,
  * zero `UPSTREAM_*` variables and the stock `default.conf` baked into the
  * image. Its onion answered HTTP 200 with `Welcome to OpenResty!` — the
  * gateway's own page, because the gateway had never been told what to proxy.
  *
  * So the files travel with the request that asks for the container. They are
- * small — the daos gateway's six files are 65 KB — and they are text that
+ * small — the sample gateway's six files are 65 KB — and they are text that
  * already crosses the wire as part of a config; carrying them is cheaper than
  * the alternatives (a git checkout on every node, a second image per stack, a
  * shared filesystem) and has no state to drift.
@@ -82,7 +82,7 @@ export declare function payloadBytes(payload: ConfigPayload): number;
  * Config files are text and few. A directory that grew a build output, a log
  * or a data file is not a config directory any more, and shipping it through
  * an RPC call would turn one provisioning request into a transfer nobody
- * budgeted for. The daos gateway, the largest real one, is 65 KB.
+ * budgeted for. The sample gateway, the largest real one, is 65 KB.
  */
 export declare const MAX_PAYLOAD_BYTES: number;
 /**

package/dist/infrastructure/config-payload.js

@@ -7,14 +7,14 @@
  * container runs on the master.
  *
  * On a node it cannot. The node has no copy of the project: measured on the
- * test server, `ls -d /root/daos /opt/daos` finds nothing, and
- * `daos-test-gateway` came up with an empty `Mounts` array, a null entrypoint,
+ * test server, `ls -d /root/sample /opt/sample` finds nothing, and
+ * `sample-test-gateway` came up with an empty `Mounts` array, a null entrypoint,
  * zero `UPSTREAM_*` variables and the stock `default.conf` baked into the
  * image. Its onion answered HTTP 200 with `Welcome to OpenResty!` — the
  * gateway's own page, because the gateway had never been told what to proxy.
  *
  * So the files travel with the request that asks for the container. They are
- * small — the daos gateway's six files are 65 KB — and they are text that
+ * small — the sample gateway's six files are 65 KB — and they are text that
  * already crosses the wire as part of a config; carrying them is cheaper than
  * the alternatives (a git checkout on every node, a second image per stack, a
  * shared filesystem) and has no state to drift.
@@ -108,7 +108,7 @@ export function payloadBytes(payload) {
  * Config files are text and few. A directory that grew a build output, a log
  * or a data file is not a config directory any more, and shipping it through
  * an RPC call would turn one provisioning request into a transfer nobody
- * budgeted for. The daos gateway, the largest real one, is 65 KB.
+ * budgeted for. The sample gateway, the largest real one, is 65 KB.
  */
 export const MAX_PAYLOAD_BYTES = 2 * 1024 * 1024;
 /**

package/dist/infrastructure/container-runtime.d.ts

@@ -8,6 +8,11 @@
  * All Omnitron-managed containers are labeled with `omnitron.managed=true`.
  */
 import type { ContainerState, ResolvedContainer } from './types.js';
+type NativeResources = NonNullable<ContainerState['resources']>;
+/** Pure validation: called before network, volume, image or container mutations. */
+export declare function containerResources(config: ResolvedContainer): Partial<NativeResources>;
+/** Labels record intent; Docker HostConfig records the actual enforced limits. */
+export declare function containerResourcesMatch(config: ResolvedContainer, actual: ContainerState): boolean;
 /** Label carrying the desired-spec fingerprint, used for config-drift detection. */
 export declare const SPEC_HASH_LABEL = "omnitron.spec-hash";
 /**
@@ -52,11 +57,23 @@ export declare function isDockerAvailable(): Promise<boolean>;
  */
 export declare function listManagedContainers(options?: {
     orThrow?: boolean;
+    checkNames?: ReadonlySet<string>;
 }): Promise<ContainerState[]>;
+/** Native IDs are the authority for destructive operations. Never follow a reused name. */
+export declare function inspectStackContainers(scope: {
+    project: string;
+    stack: string;
+}, names?: readonly string[]): Promise<{
+    id: string;
+    name: string;
+}[]>;
 /**
  * Get state of a specific container by name.
  */
-export declare function getContainerState(name: string): Promise<ContainerState | null>;
+export declare function getContainerState(name: string, options?: {
+    orThrow?: boolean;
+    fullId?: boolean;
+}): Promise<ContainerState | null>;
 /**
  * One `-p` value.
  *
@@ -75,7 +92,7 @@ export declare function getContainerState(name: string): Promise<ContainerState
  * default that every resolver must remember is a default that one of them
  * will not: `resolveGateway` was the one return of four that did not call it,
  * and the gateway is the container that faces outward. Measured on the dev
- * stand: `daos-dev-gateway` published on 0.0.0.0:80 while the other ten
+ * stand: `sample-dev-gateway` published on 0.0.0.0:80 while the other ten
  * managed containers were all on 127.0.0.1, and a browser on the LAN could
  * sign in. Defence in depth, because the resolver-side default is the one
  * that can be forgotten and this one cannot.
@@ -154,11 +171,13 @@ export declare function startContainer(nameOrId: string): Promise<void>;
 /**
  * Stop a running container gracefully.
  */
-export declare function stopContainer(nameOrId: string, _timeout?: number): Promise<void>;
+export declare function stopContainer(nameOrId: string, timeout?: number): Promise<void>;
 /**
  * Remove a container (force if running).
  */
-export declare function removeContainer(nameOrId: string): Promise<void>;
+export declare function removeContainer(nameOrId: string, options?: {
+    graceful?: boolean;
+}): Promise<void>;
 /**
  * Pull an image if not present locally.
  */
@@ -171,15 +190,7 @@ export declare function execInContainer(nameOrId: string, command: string[]): Pr
  * Wait for container health check to pass.
  */
 export declare function waitForHealthy(name: string, timeoutMs?: number): Promise<boolean>;
-/**
- * Create a Docker bridge network if it doesn't exist.
- *
- * Idempotent — `docker network create` exits non-zero with a recognisable
- * "already exists" message when the network is present; we swallow that
- * specific case and propagate everything else. Done via execFile rather
- * than the adapter because the adapter doesn't expose network APIs and
- * the call is rare (once per daemon startup per network).
- */
+/** Reuse existing Docker networks; create only an explicitly absent named bridge. */
 export declare function ensureNetwork(name: string): Promise<void>;
 /**
  * Create a Docker volume if it doesn't exist.
@@ -237,5 +248,20 @@ export declare const __test__: {
     describeContainerFailure: typeof describeContainerFailure;
     portArg: typeof portArg;
 };
+export interface DockerInventory {
+    containers: Array<{
+        name: string;
+        running: boolean;
+        health?: string;
+        labels: Record<string, string>;
+        ports: Array<{
+            host: number;
+            bindHost?: string;
+        }>;
+    }>;
+    images: string[];
+    volumes: string[];
+}
+export declare function readDockerInventory(): Promise<DockerInventory>;
 export {};
 //# sourceMappingURL=container-runtime.d.ts.map

package/dist/infrastructure/container-runtime.d.ts.map

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