@xemahq/xema 0.13.0 → 0.15.0

package/dist/runtime/waves.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.bootGraphHardClosure = bootGraphHardClosure;
 exports.deriveWaves = deriveWaves;
 exports.findWaveOrderViolations = findWaveOrderViolations;
+const distribution_1 = require("@xemahq/kernel-contracts/distribution");
+const boot_graph_loader_1 = require("./boot-graph-loader");
 function bootGraphHardClosure(seed, bootGraph, exists) {
     const out = new Set(seed.filter(exists));
     const queue = [...out];
@@ -21,25 +23,89 @@ function bootGraphHardClosure(seed, bootGraph, exists) {
     }
     return [...out];
 }
-const DEFAULT_TIER_RANK = {
-    kernel: 0,
-    system: 1,
-    base: 2,
-    platform: 3,
-    edge: 4,
-};
+const CANONICAL_TIER_RANK = distribution_1.PLATFORM_SERVICE_TIER_RANK;
 function deriveWaves(roster, bootGraph) {
+    if (bootGraph === undefined) {
+        return deriveTierWaves(roster);
+    }
+    (0, boot_graph_loader_1.assertBootGraphIntegrity)(bootGraph);
+    const entries = new Map();
+    for (const entry of roster) {
+        if (entries.has(entry.name)) {
+            throw new Error(`Cannot compile boot waves: duplicate roster service "${entry.name}".`);
+        }
+        entries.set(entry.name, entry);
+    }
+    const prerequisites = new Map();
+    const dependents = new Map();
+    for (const name of entries.keys()) {
+        prerequisites.set(name, new Set());
+        dependents.set(name, new Set());
+    }
+    for (const [name] of entries) {
+        const node = bootGraph.services.get(name);
+        for (const dependency of node?.startupRequires ?? []) {
+            if (bootGraph.infraServices.has(dependency)) {
+                continue;
+            }
+            if (!entries.has(dependency)) {
+                throw new Error(`Cannot compile boot waves: service "${name}" hard-requires "${dependency}", ` +
+                    `but that dependency is absent from the resolved roster.`);
+            }
+            prerequisites.get(name)?.add(dependency);
+            dependents.get(dependency)?.add(name);
+        }
+    }
+    const effectiveTier = (name) => bootGraph.services.get(name)?.tier ?? entries.get(name)?.tier ?? '';
     const rank = (tier) => {
-        const fromGraph = bootGraph?.tiers[tier];
+        const fromGraph = bootGraph.tiers[tier];
         if (typeof fromGraph === 'number') {
             return fromGraph;
         }
-        const fromDefault = DEFAULT_TIER_RANK[tier];
-        if (typeof fromDefault === 'number') {
-            return fromDefault;
+        const fromCanonical = CANONICAL_TIER_RANK[tier];
+        if (typeof fromCanonical === 'number') {
+            return fromCanonical;
         }
         return Number.MAX_SAFE_INTEGER;
     };
+    const remaining = new Set(entries.keys());
+    const waves = [];
+    while (remaining.size > 0) {
+        const ready = [...remaining].filter((name) => (prerequisites.get(name)?.size ?? 0) === 0);
+        if (ready.length === 0) {
+            throw new Error(`Cannot compile boot waves: no dependency-free service remains among ${[
+                ...remaining,
+            ]
+                .sort()
+                .join(', ')}.`);
+        }
+        const orderedTiers = [...new Set(ready.map(effectiveTier))].sort((left, right) => rank(left) - rank(right) || left.localeCompare(right));
+        const tier = orderedTiers[0];
+        if (tier === undefined) {
+            throw new Error('Cannot compile boot waves: ready service set has no tier.');
+        }
+        const members = ready
+            .filter((name) => effectiveTier(name) === tier)
+            .sort()
+            .map((name) => entries.get(name))
+            .filter((entry) => entry !== undefined);
+        waves.push({ index: waves.length, tier, members });
+        for (const member of members) {
+            remaining.delete(member.name);
+            for (const dependent of dependents.get(member.name) ?? []) {
+                prerequisites.get(dependent)?.delete(member.name);
+            }
+        }
+    }
+    return waves;
+}
+function deriveTierWaves(roster) {
+    const rank = (tier) => {
+        const fromCanonical = CANONICAL_TIER_RANK[tier];
+        return typeof fromCanonical === 'number'
+            ? fromCanonical
+            : Number.MAX_SAFE_INTEGER;
+    };
     const byTier = new Map();
     for (const entry of roster) {
         const bucket = byTier.get(entry.tier);
@@ -54,17 +120,18 @@ function deriveWaves(roster, bootGraph) {
     return orderedTiers.map((tier, index) => ({
         index,
         tier,
-        members: (byTier.get(tier) ?? []).slice().sort((a, b) => a.name.localeCompare(b.name)),
+        members: (byTier.get(tier) ?? [])
+            .slice()
+            .sort((a, b) => a.name.localeCompare(b.name)),
     }));
 }
 function findWaveOrderViolations(waves, bootGraph) {
-    const tierOfService = new Map();
+    const waveOfService = new Map();
     for (const wave of waves) {
         for (const m of wave.members) {
-            tierOfService.set(m.name, wave.tier);
+            waveOfService.set(m.name, { index: wave.index, tier: wave.tier });
         }
     }
-    const rank = (tier) => typeof bootGraph.tiers[tier] === 'number' ? bootGraph.tiers[tier] : Number.MAX_SAFE_INTEGER;
     const violations = [];
     for (const wave of waves) {
         for (const m of wave.members) {
@@ -76,16 +143,16 @@ function findWaveOrderViolations(waves, bootGraph) {
                 if (bootGraph.infraServices.has(req)) {
                     continue;
                 }
-                const reqTier = tierOfService.get(req);
-                if (reqTier === undefined) {
+                const required = waveOfService.get(req);
+                if (required === undefined) {
                     continue;
                 }
-                if (rank(reqTier) >= rank(wave.tier)) {
+                if (required.index >= wave.index) {
                     violations.push({
                         service: m.name,
                         requires: req,
                         serviceTier: wave.tier,
-                        requiresTier: reqTier,
+                        requiresTier: required.tier,
                     });
                 }
             }

package/dist/runtime/waves.js.map

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

package/examples/01-local-native.yaml

@@ -14,7 +14,10 @@ infra:
   # etcd is REQUIRED — it backs cross-process service discovery.
   # If you want the launcher to manage infra too, use the container substrate
   # (see 02-local-container-full.yaml).
-  postgres: { mode: external, url: postgresql://postgres:postgres@127.0.0.1:5432 }
+  postgres:
+    { mode: external, url: postgresql://xema@127.0.0.1:5432, secretRef: postgres-password }
   redis:    { mode: external, url: redis://127.0.0.1:6379 }
   etcd:     { mode: external, url: http://127.0.0.1:2379 }
   keycloak: { mode: external, url: http://127.0.0.1:8180, realm: xema }
+secrets:
+  postgres-password: { from: env, env: XEMA_POSTGRES_PASSWORD }

package/examples/03-byo-infra.yaml

@@ -8,10 +8,20 @@ app:
   substrate: container
   include: all
 infra:
-  postgres:    { mode: external, url: postgresql://app:secret@db.corp.internal:5432 }
-  keycloak:    { mode: external, url: https://sso.corp/realms/xema, realm: xema }
-  objectStore: { mode: external, url: https://s3.corp.internal, bucketPrefix: xema-, secretRef: corp-s3 }
-  redis:       { mode: managed }
-  etcd:        { mode: managed }
-  search:      { mode: managed }
-  temporal:    { mode: disabled }   # this install doesn't use durable workflows
+  postgres:
+    {
+      mode: external,
+      url: postgresql://app@db.corp.internal:5432,
+      secretRef: corp-postgres-password,
+    }
+  keycloak: { mode: external, url: https://sso.corp/realms/xema, realm: xema }
+  objectStore:
+    { mode: external, url: https://s3.corp.internal, bucketPrefix: xema- }
+  redis: { mode: managed }
+  etcd: { mode: managed }
+  search: { mode: managed }
+  temporal: { mode: disabled } # this install doesn't use durable workflows
+secrets:
+  corp-postgres-password: { from: env, env: XEMA_POSTGRES_PASSWORD }
+  S3_ACCESS_KEY_ID: { from: env }
+  S3_SECRET_ACCESS_KEY: { from: env }

package/examples/05-appliance-helm.yaml

@@ -2,7 +2,7 @@
 # `helm upgrade --install` per service; Kubernetes owns lifecycle (rollout,
 # restart, scaling). Infra (Postgres/etcd/...) is a cluster prerequisite, not
 # managed by the launcher here. Env: XEMA_CHART_REPO, XEMA_NAMESPACE, KUBECONFIG.
-#   Equivalent CLI: xema serve --profile appliance
+#   Equivalent CLI: xema serve --substrate appliance
 edition: oss
 app:
   substrate: helm

package/examples/06-biome-sources.yaml

@@ -46,6 +46,9 @@ sources:
     authTokenEnv: NPM_TOKEN_ACME
 
 infra:
-  postgres: { mode: external, url: postgresql://postgres:postgres@127.0.0.1:5432 }
+  postgres:
+    { mode: external, url: postgresql://xema@127.0.0.1:5432, secretRef: postgres-password }
   redis:    { mode: external, url: redis://127.0.0.1:6379 }
   keycloak: { mode: external, url: http://127.0.0.1:8180, realm: xema }
+secrets:
+  postgres-password: { from: env, env: XEMA_POSTGRES_PASSWORD }

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@xemahq/xema",
-  "version": "0.13.0",
+  "version": "0.15.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xema-dev/xema-cli.git",
+    "directory": "apps/xema-cli"
+  },
   "license": "Apache-2.0",
   "description": "Xema OS global CLI (plan v4.3 §6 Phase J). Single binary day-0 onboarding: `npm i -g @xemahq/xema && xema dev` boots the whole stack; `xema biome scaffold` / `install` / `publish` / `lint` author and ship biomes; `xema run <capability>` invokes through the local capability-router. Multi-platform: works without pnpm or any monorepo clone.",
   "type": "commonjs",
@@ -9,7 +14,7 @@
     "xema": "./dist/cli.js"
   },
   "files": [
-    "dist/**/*",
+    "dist",
     "xema.config.example.yaml",
     "examples/**/*"
   ],
@@ -21,10 +26,14 @@
     "@nestjs/common": "11.1.13",
     "@nestjs/core": "11.1.13",
     "@nestjs/platform-express": "11.1.13",
-    "@xemahq/distribution-resolver": "^0.1.1",
-    "@xemahq/kernel-contracts": "^0.22.0",
-    "@xemahq/kernel-state-runtime": "^0.2.0",
-    "@xemahq/service-registry-nest": "^0.2.0",
+    "@xemahq/biome-supply-chain": "^0.1.1",
+    "@xemahq/distribution-resolver": "^0.1.3",
+    "@xemahq/dsl": "0.8.1",
+    "@xemahq/identity-client": "0.9.5",
+    "@xemahq/kernel-contracts": "^8.0.0",
+    "@xemahq/kernel-state-runtime": "^0.3.0",
+    "@xemahq/license-verifier": "^0.1.1",
+    "@xemahq/service-registry-nest": "^0.7.0",
     "commander": "^12.1.0",
     "reflect-metadata": "0.2.2",
     "rxjs": "7.8.2",
@@ -36,7 +45,6 @@
     "@eslint/js": "^9.39.4",
     "@types/jest": "^30.0.0",
     "@types/node": "25.2.3",
-    "@yao-pkg/pkg": "^6.6.0",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
@@ -48,31 +56,15 @@
     "typescript": "5.9.3",
     "typescript-eslint": "^8.56.1"
   },
-  "pkg": {
-    "scripts": [
-      "dist/**/*.js"
-    ],
-    "assets": [
-      "dist/**/*.json",
-      "package.json"
-    ],
-    "targets": [
-      "node20-macos-arm64",
-      "node20-macos-x64",
-      "node20-linux-arm64",
-      "node20-linux-x64",
-      "node20-win-x64"
-    ],
-    "outputPath": "dist/bin"
-  },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "tsc -p tsconfig.json && node ./scripts/post-build.cjs",
-    "build:binary": "node ./scripts/build-binaries.cjs",
+    "build": "tsc -p tsconfig.build.json && node ./scripts/post-build.cjs",
+    "sync:assets": "node ./scripts/sync-distribution-assets.cjs",
+    "verify:pack": "node ./scripts/verify-packed-assets.cjs",
     "format": "prettier --write \"src/**/*.ts\"",
     "start": "node ./dist/cli.js",
-    "lint": "eslint \"src/**/*.ts\"",
-    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "test": "jest --config jest.config.cjs",
     "typecheck": "tsc --noEmit"
   }

package/xema.config.example.yaml

@@ -3,7 +3,7 @@
 #
 # Every value shown is the default; delete what you don't override.
 
-edition: oss                     # which distribution edition to launch
+edition: oss # which distribution edition to launch
 
 # ── backing infrastructure (BYO model) ───────────────────────────────────────
 # mode ∈ managed | external | disabled
@@ -11,36 +11,40 @@ edition: oss                     # which distribution edition to launch
 #   external — you already run it; give the URL (launcher health-probes it)
 #   disabled — not run (only allowed for optional components)
 infra:
-  postgres:    { mode: managed }                 # mandatory
-  redis:       { mode: managed }                 # mandatory
-  etcd:        { mode: managed }                 # mandatory (service discovery)
-  keycloak:    { mode: managed }                 # mandatory (identity)
-  objectStore: { mode: managed }                 # mandatory (blobs/artifacts)
-  search:      { mode: managed }                 # optional (full-text / vectors)
-  fga:         { mode: managed }                 # optional (authorization ReBAC)
-  git:         { mode: disabled }                # optional (SCM integration)
-  temporal:    { mode: managed }                 # optional (durable workflows)
+  postgres: { mode: managed } # mandatory
+  redis: { mode: managed } # mandatory
+  etcd: { mode: managed } # mandatory (service discovery)
+  keycloak: { mode: managed } # mandatory (identity)
+  objectStore: { mode: managed } # mandatory (blobs/artifacts)
+  search: { mode: managed } # optional (full-text / vectors)
+  fga: { mode: managed } # optional (authorization ReBAC)
+  git: { mode: disabled } # optional (SCM integration)
+  temporal: { mode: managed } # optional (durable workflows)
   # Example BYO:
+  # postgres: { mode: external, url: postgresql://xema@db.example.com:5432, secretRef: postgres-password }
   # keycloak: { mode: external, url: https://sso.example.com/realms/xema, realm: xema }
-  # objectStore: { mode: external, url: https://s3.example.com, secretRef: my-s3 }
+  # objectStore: { mode: external, url: https://s3.example.com }
 
 # ── application services ─────────────────────────────────────────────────────
 app:
-  substrate: container           # container | native | helm
-  processModel: distributed      # distributed (microservices, etcd discovery) — the only supported model
-  include: [ all ]               # all | tier names (kernel/system/base/platform) | service names
-  exclude: []                    # service names to drop
-  features: []                   # curated capability bundles (union with include)
+  substrate: container # container | native | helm
+  processModel: distributed # distributed (microservices, etcd discovery) — the only supported model
+  include: default # default (skips distribution-optional biomes) | all | list of tier names (kernel/system/base/platform/edge) and/or service names
+  exclude: [] # service names to drop
+  features: [] # curated capability bundles (union with include)
   web:
-    enabled: false               # start the host-shell frontend (or use `xema up --web`)
+    enabled: false # start the host-shell frontend (or use `xema up --web`)
 
 # ── persistence ──────────────────────────────────────────────────────────────
 state:
   workspaces:
-    driver: docker_local         # docker_local (container) | host_path (native)
+    driver: docker_local # docker_local (container) | host_path (native)
 
 # ── secrets the launcher must obtain (never dev-defaulted in production) ──────
 secrets:
   OPENCODE_SERVER_PASSWORD: { from: prompt }
+  # postgres-password: { from: env, env: XEMA_POSTGRES_PASSWORD }
+  # S3_ACCESS_KEY_ID: { from: env }
+  # S3_SECRET_ACCESS_KEY: { from: env }
   # DELEGATED_SESSION_JWT_PRIVATE_KEY: { from: file, path: ./keys/session.pem }
   # LLM_PROVIDER_ANTHROPIC_API_KEY: { from: env }

package/LICENSE

@@ -1,176 +0,0 @@
-Apache License
-Version 2.0, January 2004
-http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-"License" shall mean the terms and conditions for use, reproduction,
-and distribution as defined by Sections 1 through 9 of this document.
-
-"Licensor" shall mean the copyright owner or entity authorized by
-the copyright owner that is granting the License.
-
-"Legal Entity" shall mean the union of the acting entity and all
-other entities that control, are controlled by, or are under common
-control with that entity. For the purposes of this definition,
-"control" means (i) the power, direct or indirect, to cause the
-direction or management of such entity, whether by contract or
-otherwise, or (ii) ownership of fifty percent (50%) or more of the
-outstanding shares, or (iii) beneficial ownership of such entity.
-
-"You" (or "Your") shall mean an individual or Legal Entity
-exercising permissions granted by this License.
-
-"Source" form shall mean the preferred form for making modifications,
-including but not limited to software source code, documentation
-source, and configuration files.
-
-"Object" form shall mean any form resulting from mechanical
-transformation or translation of a Source form, including but
-not limited to compiled object code, generated documentation,
-and conversions to other media types.
-
-"Work" shall mean the work of authorship, whether in Source or
-Object form, made available under the License, as indicated by a
-copyright notice that is included in or attached to the work
-(an example is provided in the Appendix below).
-
-"Derivative Works" shall mean any work, whether in Source or Object
-form, that is based on (or derived from) the Work and for which the
-editorial revisions, annotations, elaborations, or other modifications
-represent, as a whole, an original work of authorship. For the purposes
-of this License, Derivative Works shall not include works that remain
-separable from, or merely link (or bind by name) to the interfaces of,
-the Work and Derivative Works thereof.
-
-"Contribution" shall mean any work of authorship, including
-the original version of the Work and any modifications or additions
-to that Work or Derivative Works thereof, that is intentionally
-submitted to Licensor for inclusion in the Work by the copyright owner
-or by an individual or Legal Entity authorized to submit on behalf of
-the copyright owner. For the purposes of this definition, "submitted"
-means any form of electronic, verbal, or written communication sent
-to the Licensor or its representatives, including but not limited to
-communication on electronic mailing lists, source code control systems,
-and issue tracking systems that are managed by, or on behalf of, the
-Licensor for the purpose of discussing and improving the Work, but
-excluding communication that is conspicuously marked or otherwise
-designated in writing by the copyright owner as "Not a Contribution."
-
-"Contributor" shall mean Licensor and any individual or Legal Entity
-on behalf of whom a Contribution has been received by Licensor and
-subsequently incorporated within the Work.
-
-2. Grant of Copyright License. Subject to the terms and conditions of
-this License, each Contributor hereby grants to You a perpetual,
-worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-copyright license to reproduce, prepare Derivative Works of,
-publicly display, publicly perform, sublicense, and distribute the
-Work and such Derivative Works in Source or Object form.
-
-3. Grant of Patent License. Subject to the terms and conditions of
-this License, each Contributor hereby grants to You a perpetual,
-worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-(except as stated in this section) patent license to make, have made,
-use, offer to sell, sell, import, and otherwise transfer the Work,
-where such license applies only to those patent claims licensable
-by such Contributor that are necessarily infringed by their
-Contribution(s) alone or by combination of their Contribution(s)
-with the Work to which such Contribution(s) was submitted. If You
-institute patent litigation against any entity (including a
-cross-claim or counterclaim in a lawsuit) alleging that the Work
-or a Contribution incorporated within the Work constitutes direct
-or contributory patent infringement, then any patent licenses
-granted to You under this License for that Work shall terminate
-as of the date such litigation is filed.
-
-4. Redistribution. You may reproduce and distribute copies of the
-Work or Derivative Works thereof in any medium, with or without
-modifications, and in Source or Object form, provided that You
-meet the following conditions:
-
-(a) You must give any other recipients of the Work or
-Derivative Works a copy of this License; and
-
-(b) You must cause any modified files to carry prominent notices
-stating that You changed the files; and
-
-(c) You must retain, in the Source form of any Derivative Works
-that You distribute, all copyright, patent, trademark, and
-attribution notices from the Source form of the Work,
-excluding those notices that do not pertain to any part of
-the Derivative Works; and
-
-(d) If the Work includes a "NOTICE" text file as part of its
-distribution, then any Derivative Works that You distribute must
-include a readable copy of the attribution notices contained
-within such NOTICE file, excluding those notices that do not
-pertain to any part of the Derivative Works, in at least one
-of the following places: within a NOTICE text file distributed
-as part of the Derivative Works; within the Source form or
-documentation, if provided along with the Derivative Works; or,
-within a display generated by the Derivative Works, if and
-wherever such third-party notices normally appear. The contents
-of the NOTICE file are for informational purposes only and
-do not modify the License. You may add Your own attribution
-notices within Derivative Works that You distribute, alongside
-or as an addendum to the NOTICE text from the Work, provided
-that such additional attribution notices cannot be construed
-as modifying the License.
-
-You may add Your own copyright statement to Your modifications and
-may provide additional or different license terms and conditions
-for use, reproduction, or distribution of Your modifications, or
-for any such Derivative Works as a whole, provided Your use,
-reproduction, and distribution of the Work otherwise complies with
-the conditions stated in this License.
-
-5. Submission of Contributions. Unless You explicitly state otherwise,
-any Contribution intentionally submitted for inclusion in the Work
-by You to the Licensor shall be under the terms and conditions of
-this License, without any additional terms or conditions.
-Notwithstanding the above, nothing herein shall supersede or modify
-the terms of any separate license agreement you may have executed
-with Licensor regarding such Contributions.
-
-6. Trademarks. This License does not grant permission to use the trade
-names, trademarks, service marks, or product names of the Licensor,
-except as required for reasonable and customary use in describing the
-origin of the Work and reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty. Unless required by applicable law or
-agreed to in writing, Licensor provides the Work (and each
-Contributor provides its Contributions) on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-implied, including, without limitation, any warranties or conditions
-of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-PARTICULAR PURPOSE. You are solely responsible for determining the
-appropriateness of using or redistributing the Work and assume any
-risks associated with Your exercise of permissions under this License.
-
-8. Limitation of Liability. In no event and under no legal theory,
-whether in tort (including negligence), contract, or otherwise,
-unless required by applicable law (such as deliberate and grossly
-negligent acts) or agreed to in writing, shall any Contributor be
-liable to You for damages, including any direct, indirect, special,
-incidental, or consequential damages of any character arising as a
-result of this License or out of the use or inability to use the
-Work (including but not limited to damages for loss of goodwill,
-work stoppage, computer failure or malfunction, or any and all
-other commercial damages or losses), even if such Contributor
-has been advised of the possibility of such damages.
-
-9. Accepting Warranty or Additional Liability. While redistributing
-the Work or Derivative Works thereof, You may choose to offer,
-and charge a fee for, acceptance of support, warranty, indemnity,
-or other liability obligations and/or rights consistent with this
-License. However, in accepting such obligations, You may act only
-on Your own behalf and on Your sole responsibility, not on behalf
-of any other Contributor, and only if You agree to indemnify,
-defend, and hold each Contributor harmless for any liability
-incurred by, or claims asserted against, such Contributor by reason
-of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS

package/dist/lib/command-registry.d.ts

@@ -1,5 +0,0 @@
-import type { Command } from 'commander';
-export type RegisterCommand = (program: Command) => void;
-export declare const XEMA_CLI_COMMAND_NAMES: readonly ["up", "down", "status", "logs", "dev", "serve", "biome", "run", "shell", "objects", "doctor"];
-export type XemaCliCommandName = (typeof XEMA_CLI_COMMAND_NAMES)[number];
-//# sourceMappingURL=command-registry.d.ts.map

package/dist/lib/command-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/lib/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAYzD,eAAO,MAAM,sBAAsB,yGAYzB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/lib/command-registry.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.XEMA_CLI_COMMAND_NAMES = void 0;
-exports.XEMA_CLI_COMMAND_NAMES = [
-    'up',
-    'down',
-    'status',
-    'logs',
-    'dev',
-    'serve',
-    'biome',
-    'run',
-    'shell',
-    'objects',
-    'doctor',
-];
-//# sourceMappingURL=command-registry.js.map

package/dist/lib/command-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../../src/lib/command-registry.ts"],"names":[],"mappings":";;;AAqBa,QAAA,sBAAsB,GAAG;IACpC,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,MAAM;IACN,KAAK;IACL,OAAO;IACP,OAAO;IACP,KAAK;IACL,OAAO;IACP,SAAS;IACT,QAAQ;CACA,CAAC"}