@inixiative/config 0.5.42 → 0.5.44

package/README.md

@@ -52,7 +52,7 @@ One version of `@inixiative/config` names one coherent ecosystem state:
 }
 ```
 
-A lane is a release cascade with its own blessed set. `primitives` (json-rules, permissions, transitions, rules-builder, prisma-map, atlas, gloss, archive) ships first; `agentic` (agent-session → foundry-core → foundry) builds on the primitives' blessed set and never the reverse. `check` holds every repo to the union of all lanes, so a repo that mixes both answers to both.
+A lane is a release cascade with its own blessed set. `primitives` (json-rules, permissions, transitions, rules-builder, prisma-map, atlas, gloss) ships first; `agentic` (archive, agent-session → foundry-core → foundry) builds on the primitives' blessed set and never the reverse. `check` holds every repo to the union of all lanes, so a repo that mixes both answers to both.
 
 TypeScript 6.0 notes, discovered by this repo's fixture suite:
 
@@ -66,8 +66,11 @@ bunx @inixiative/config check [dir] [--preset=base|node|react]
 bunx @inixiative/config sync  [dir] [--preset=...] [--force] [--no-install]
 bunx @inixiative/config scan  [root] [--lane=primitives|agentic]
 bunx @inixiative/config train [root] [--lane=primitives|agentic] [--push]
+bunx @inixiative/config ports [project]
 ```
 
+`ports` prints each project's local ports from `ports.json` (also exported as `@inixiative/config/ports.json`). A project's port for a service is the service's usual default plus 100 times the project's block, so no two projects collide and none sits on a default: Archive (block 7) serves HTTP on 4700 with Postgres on 6132; Kingdom (block 2) has web 3200, API 8200, Postgres 5632, Redis 6579. Reserved ports (macOS AirPlay on 5000 and 7000) are never assigned. Give a new project the next free block, and a new kind of service its usual default; the tests fail on any collision.
+
 `check` is read-only and exits non-zero on drift — run it in CI after a frozen-lockfile install. It verifies toolchain pins — declared once, at the root, pinned exactly: a workspace member declaring one is an error, and `bun.lock` must resolve each only to its pin (no second copy) — toolchain peer ranges (they must admit the pin and no older major; `sync` writes `>=<pin major>.<pin minor>.0`), `"latest"` ranges, `packageManager`/`.bun-version`, legacy `bun.lockb`, a committed (tracked, un-ignored) `bun.lock`, required scripts (`check`/`typecheck`/`lint`/`test`), lefthook (dep + `lefthook.yml` extending the shared hooks + `prepare` script; git repos only), stub `extends`, presence of this package, and for every ecosystem dependency — in the root or any workspace member, of either lane — that the declared range admits the blessed version and the lockfile actually resolves to it (the stale-lockfile class). An npm alias (`"@inixiative/session-archive": "npm:@inixiative/archive@^0.2.1"`) is held to its target's blessed version and rewritten as an alias; `workspace:`, `file:` and `link:` ranges are a repo linking itself and are left alone.
 
 `sync` applies every fix (deleting member toolchain entries and their stale member links), re-locks via `bun install` (`--force` when a second toolchain copy survives), and runs `bun update` on stale ecosystem entries in the directory that declares them. It refuses to run on a dirty working tree without `--force`. The react preset is inferred from a `react` dependency; override with `--preset`. Missing scripts are filled with defaults; existing script bodies are never touched.
@@ -105,7 +108,7 @@ jobs:
 
 Two lanes, each publishing in dependency order, with config last:
 
-- **primitives** — for example json-rules → permissions → transitions → rules-builder, plus prisma-map, atlas, gloss and archive (a standalone MIT package). Consumers: template, kingdom.
-- **agentic** — agent-session → foundry-core → foundry, built on the primitives' blessed set. foundry-core and foundry publish from the foundry monorepo's `packages/core` and `packages/foundry`. Consumers: oracle (a private leaf), kingdom.
+- **primitives** — for example json-rules → permissions → transitions → rules-builder, plus prisma-map, atlas and gloss. Consumers: template, kingdom.
+- **agentic** — archive and agent-session, then foundry-core → foundry (foundry depends on archive), built on the primitives' blessed set. foundry-core and foundry publish from the foundry monorepo's `packages/core` and `packages/foundry`. Consumers: oracle (a private leaf), kingdom.
 
 A release is `train` (or `train --lane=agentic` to leave the primitives alone): bump the package's version on its default branch, then run the train. `train` automates the whole walk, this package and the consumer PRs included. Downstream repos pick up toolchain changes via `sync`.

package/dist/cli.js

@@ -789,6 +789,48 @@ function inspect(dir2, manifest2, presetOverride) {
   };
 }
 
+// ports.json
+var ports_default = {
+  $comment: "Local port registry. A project's port for a service is the service's default plus 100 times the project's block, so projects never collide and none uses a default. Add a project at the next free block; add a service with its usual default.",
+  blockSize: 100,
+  reserved: {
+    "5000": "macOS AirPlay Receiver",
+    "7000": "macOS AirPlay Receiver"
+  },
+  services: {
+    web: 3e3,
+    admin: 3001,
+    superadmin: 3002,
+    http: 4e3,
+    postgres: 5432,
+    redis: 6379,
+    api: 8e3,
+    muninn: 8475,
+    muninnUi: 8476,
+    minio: 9e3,
+    minioConsole: 9001
+  },
+  projects: {
+    template: 1,
+    kingdom: 2,
+    tribe: 3,
+    zealot: 4,
+    foundry: 5,
+    oracle: 6,
+    archive: 7
+  }
+};
+
+// src/ports.ts
+var projects = Object.keys(ports_default.projects);
+var services = Object.keys(ports_default.services);
+function portsFor(project) {
+  const offset = ports_default.projects[project] * ports_default.blockSize;
+  return Object.fromEntries(
+    services.map((service) => [service, ports_default.services[service] + offset])
+  );
+}
+
 // src/cli.ts
 var args = process.argv.slice(2);
 var command = args[0];
@@ -799,10 +841,19 @@ var positional = args.slice(1).filter((arg) => !arg.startsWith("--"));
 var dir = resolve(positional[0] ?? ".");
 var usage = () => {
   console.log(
-    "Usage: inixiative-config <check|sync|scan|train> [dir] [--preset=base|node|react] [--lane=primitives|agentic] [--force] [--no-install] [--push]"
+    "Usage: inixiative-config <check|sync|scan|train> [dir] [--preset=base|node|react] [--lane=primitives|agentic] [--force] [--no-install] [--push]\n       inixiative-config ports [project]"
   );
   process.exit(2);
 };
+if (command === "ports") {
+  const project = positional[0];
+  if (project !== void 0 && !projects.includes(project)) usage();
+  for (const name of project ? [project] : projects)
+    console.log(
+      `${name}: ${Object.entries(portsFor(name)).map(([service, port]) => `${service}=${port}`).join(" ")}`
+    );
+  process.exit(0);
+}
 if (!["check", "sync", "scan", "train"].includes(command)) usage();
 if (presetFlag && !["base", "node", "react"].includes(presetFlag)) usage();
 if (laneFlag !== void 0 && !isLane(laneFlag)) usage();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inixiative/config",
-  "version": "0.5.42",
+  "version": "0.5.44",
   "description": "Shared toolchain for the inixiative ecosystem: tsconfig/biome/tsup presets, a version manifest (BOM), and a sync/check CLI",
   "type": "module",
   "license": "MIT",
@@ -21,7 +21,8 @@
     "biome",
     "lefthook",
     "versions.json",
-    "README.md"
+    "README.md",
+    "ports.json"
   ],
   "exports": {
     "./versions.json": "./versions.json",
@@ -34,7 +35,8 @@
     "./tsup": {
       "types": "./dist/tsup.d.ts",
       "import": "./dist/tsup.js"
-    }
+    },
+    "./ports.json": "./ports.json"
   },
   "scripts": {
     "prepare": "lefthook install",

package/ports.json

@@ -0,0 +1,30 @@
+{
+  "$comment": "Local port registry. A project's port for a service is the service's default plus 100 times the project's block, so projects never collide and none uses a default. Add a project at the next free block; add a service with its usual default.",
+  "blockSize": 100,
+  "reserved": {
+    "5000": "macOS AirPlay Receiver",
+    "7000": "macOS AirPlay Receiver"
+  },
+  "services": {
+    "web": 3000,
+    "admin": 3001,
+    "superadmin": 3002,
+    "http": 4000,
+    "postgres": 5432,
+    "redis": 6379,
+    "api": 8000,
+    "muninn": 8475,
+    "muninnUi": 8476,
+    "minio": 9000,
+    "minioConsole": 9001
+  },
+  "projects": {
+    "template": 1,
+    "kingdom": 2,
+    "tribe": 3,
+    "zealot": 4,
+    "foundry": 5,
+    "oracle": 6,
+    "archive": 7
+  }
+}

package/versions.json

@@ -13,17 +13,17 @@
     "@types/bun"
   ],
   "ecosystem": {
-    "@inixiative/config": "0.5.42",
-    "@inixiative/json-rules": "2.25.0",
-    "@inixiative/permissions": "0.3.2",
+    "@inixiative/config": "0.5.44",
+    "@inixiative/json-rules": "2.26.0",
+    "@inixiative/permissions": "0.3.3",
     "@inixiative/transitions": "0.1.0",
     "@inixiative/rules-builder": "0.28.0",
     "@inixiative/prisma-map": "0.2.0",
     "@inixiative/atlas": "0.1.1",
-    "@inixiative/gloss": "0.0.4",
-    "@inixiative/archive": "0.5.1"
+    "@inixiative/gloss": "0.0.4"
   },
   "agentic": {
+    "@inixiative/archive": "0.6.0",
     "@inixiative/agent-session": "0.3.1",
     "@inixiative/foundry-core": "0.2.0",
     "@inixiative/foundry": "0.2.0"