@arcforge/platform 2.0.214 → 2.0.216

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@arcforge/platform",
3
- "version": "2.0.214",
3
+ "version": "2.0.216",
4
4
  "description": "The Axon developer platform — headless project discovery, blueprint scanning, typegen, agent lifecycle, registry, benches and tests. Shared by the CLI/TUI and the Fleet extension.",
5
5
  "type": "module",
6
6
  "private": false,
@@ -44,26 +44,27 @@
44
44
  "deploy": "echo \"This package is published ONLY by apps/tui/scripts/release.ts, which pins workspace:* deps to concrete versions first. Publishing it directly ships an unresolvable dependency.\" && exit 1"
45
45
  },
46
46
  "dependencies": {
47
- "@arcforge/session": "2.0.214",
48
- "@arcforge/engines": "2.0.214",
49
- "@arcforge/err": "2.0.214",
50
- "@arcforge/types": "2.0.214",
51
- "@arcforge/cloud": "2.0.214",
52
- "@arcforge/capsule": "2.0.214",
53
- "@arcforge/core": "2.0.214",
54
- "@arcforge/vstr": "2.0.214",
47
+ "@arcforge/session": "2.0.216",
48
+ "@arcforge/engines": "2.0.216",
49
+ "@arcforge/err": "2.0.216",
50
+ "@arcforge/types": "2.0.216",
51
+ "@arcforge/cloud": "2.0.216",
52
+ "@arcforge/capsule": "2.0.216",
53
+ "@arcforge/core": "2.0.216",
54
+ "@arcforge/vstr": "2.0.216",
55
55
  "fft.js": "^4.0.4",
56
56
  "h3": "^1.15.11",
57
57
  "semver": "^7.7.4",
58
58
  "sharp": "^0.35.3",
59
59
  "typescript": "5.9.2",
60
- "@arcforge/link": "2.0.214"
60
+ "@arcforge/link": "2.0.216"
61
61
  },
62
62
  "devDependencies": {
63
- "@arcforge/air": "2.0.208",
64
- "@arcforge/cognet": "2.0.208",
63
+ "@arcforge/air": "2.0.215",
64
+ "@arcforge/cognet": "2.0.215",
65
65
  "@arclabs/repo": "1.0.0",
66
66
  "@types/bun": "latest",
67
67
  "@types/semver": "^7.7.1"
68
- }
68
+ },
69
+ "axonRevision": "1142da36e6cfed36fe03f3b5e91a04cc01929d6e"
69
70
  }
@@ -1,6 +1,5 @@
1
1
  import { join } from "node:path"
2
2
  import { err } from "@arcforge/err"
3
- import { KERNEL_ABI_VERSION } from "@arcforge/types"
4
3
  import { readCognetAbi } from "../../blueprint"
5
4
  import { fsx } from "../../../utils/fs"
6
5
  import { KINDS } from "../kinds"
@@ -59,20 +58,31 @@ export function Source(opts: SourceOpts) {
59
58
  ".assets",
60
59
  ])
61
60
 
62
- // A cognet's ABI is the kernel contract it targets, and it is the
63
- // only thing that says which kernels can load it. Lifted out of
64
- // cognet.config.ts HERE so the registry can record it: otherwise
65
- // the value stays sealed in the tarball and the resolve path can
66
- // only offer "latest" and hope.
61
+ // A cognet's ABI pin is the kernel contract it REFUSES to run
62
+ // outside of. Lifted out of cognet.config.ts here so the registry
63
+ // can record it: otherwise the value stays sealed in the tarball
64
+ // and the resolve path can only offer "latest" and hope.
67
65
  //
68
- // Unpinned falls back to THIS CLI's kernel rather than throwing.
69
- // Publish compiles the candidate from source with this CLI to
70
- // prove a consumer could, so an unpinned cognet genuinely was
71
- // validated against this ABI — recording it is a fact, and the
72
- // row must carry one either way or the resolver cannot place it.
73
- const abi = kind === "cognet"
74
- ? (await readCognetAbi(root)) ?? KERNEL_ABI_VERSION
75
- : undefined
66
+ // Unpinned stays NULL — it must not fall back to this CLI's kernel.
67
+ // What ships here is SOURCE (see `entries` below: the config, the
68
+ // src tree, package.json — no compiled bundle), and the consumer
69
+ // compiles it against THEIR kernel at prepare time. So the ABI this
70
+ // machine happens to run is not a property of the artifact, and
71
+ // stamping it writes a pin the author deliberately did not write:
72
+ // an assertion opted into, per cognetAbi(), turned into one every
73
+ // cognet is forced to restate.
74
+ //
75
+ // It was `?? KERNEL_ABI_VERSION`, and the cost was total. Publish
76
+ // compiling the candidate proves a consumer COULD build it on this
77
+ // ABI; it says nothing about the next one. So @axon/zero — which
78
+ // pins nothing and cares about nothing — went out stamped "11",
79
+ // the kernel moved to 12, and `axon init` broke for every new user
80
+ // against an artifact that would have compiled fine.
81
+ // null for both "not a cognet" and "a cognet that pins nothing" —
82
+ // neither declares a kernel contract, and the field is omitted for
83
+ // both, so the registry row stays NULL rather than carrying a
84
+ // number nobody asserted.
85
+ const abi = kind === "cognet" ? await readCognetAbi(root) : null
76
86
 
77
87
  const image: SourceImage = {
78
88
  kind,
@@ -81,7 +91,7 @@ export function Source(opts: SourceOpts) {
81
91
  public: pkg.public,
82
92
  builtAt: new Date().toISOString(),
83
93
  ...(pkg.description ? { description: pkg.description } : {}),
84
- ...(abi !== undefined ? { abi } : {}),
94
+ ...(abi !== null ? { abi: abi } : {}),
85
95
  }
86
96
  await artifacts.image(bundleDir, image)
87
97
  // package.json rides along — publish reads name/version/visibility from it.
@@ -5,7 +5,7 @@ import type { EngineType } from "@arcforge/types"
5
5
 
6
6
  /**
7
7
  * The ambient authoring surface for cognet source — what the compile step's
8
- * host installs at runtime (defineCognet, loop, kernel, phase, system), typed
8
+ * host installs at runtime (defineCognet, loop, kernel, phase, system, ecs), typed
9
9
  * here for the editor. Written into the owning project's `types/` area by
10
10
  * `axon prepare`: a standalone cognet's own frame, or the AGENT's frame when
11
11
  * the brain is inline at `<agent>/cognet/`.
@@ -23,6 +23,7 @@ import type {
23
23
  KernelAbi,
24
24
  EngineType,
25
25
  } from "@arcforge/types"
26
+ import type { EcsT } from "@arcforge/cognet/ecs"
26
27
 
27
28
  declare global {
28
29
  /** what this brain declares (mode, wakeOn, engines) — cognet.config.ts only.
@@ -66,6 +67,20 @@ __COGNET_ENGINE_ROLES__
66
67
 
67
68
  /** a unit of work within a phase — timed for the flame graph */
68
69
  function system<T>(name: string, fn: () => Promise<T>): Promise<T>
70
+
71
+ /**
72
+ * The world — entities, components, and queries over both.
73
+ *
74
+ * The brain's short-term memory: it lives as long as the cognet does, not
75
+ * as long as a wake, so a decaying drive or a remembered place survives
76
+ * from one tick to the next. Every write commits to the session log with
77
+ * its value, which is what makes the world reconstructible afterwards.
78
+ *
79
+ * Built on first touch — a cognet that never reaches for it carries no
80
+ * entity store. Declare a component's shape once with \`ecs.declare()\` so
81
+ * readers can render it honestly.
82
+ */
83
+ const ecs: EcsT
69
84
  }
70
85
 
71
86
  export {}
package/src/index.ts CHANGED
@@ -1,5 +1,9 @@
1
1
  export { Platform, type PlatformT } from "./platform"
2
2
  export type { ProjectKind, ProjectT } from "./build/project"
3
+ // Promoted deliberately: the name of the default brain is a public fact about
4
+ // the platform, and `arc`'s release preflight now asks the registry whether a
5
+ // version of it exists for this kernel's ABI. Two consumers, one constant.
6
+ export { DEFAULT_COGNET } from "./build/blueprint"
3
7
  // The `@` palette renders these rows, so the shape is part of the platform's
4
8
  // public surface rather than an internal of the walk that produces it.
5
9
  export type { FileEntry, FilesT } from "./services/files"