heximon 0.1.1 → 0.2.0

package/README.md

@@ -69,7 +69,7 @@ const main = defineCommand({
 | Command | What it does |
 | :-- | :-- |
 | `heximon create` | Scaffolds a new app from a starter template. Also reachable as `pnpm create heximon`. |
-| `heximon check` | Compiles the app, reports every diagnostic, and refreshes the editor's type hints. `--emit` also writes the generated wiring to `.heximon/`; `--verify-baseline` names every durable record the committed `heximon.upgrade.json` has not acknowledged. |
+| `heximon check` | Compiles the app, reports every diagnostic, and refreshes the editor's type hints. `--emit` also writes the generated app wiring to `.heximon/`; `--verify-baseline` names every durable record the committed `heximon.upgrade.json` has not acknowledged. |
 | `heximon routes` | Prints one table for every path the app answers — routes, SSE streams, and WebSocket upgrades — read from the compiler, with no boot required. |
 | `heximon graph` | Prints the resolved module dependency graph: modules, providers, and dependencies. |
 | `heximon doctor` | Reports a package installed twice, an untraced deploy target, and a stale published module. |
@@ -127,7 +127,9 @@ the fix instructions plus a non-zero exit code.
   provider on its own. `heximon check` reports that error with the line that is wrong.
 - **`heximon check` writes no wiring unless you ask.** Pass `--emit`, or set `debug: true` in
   `heximon.config.ts`, and the generated files land in `.heximon/` — prettified in place, and the command
-  prints where.
+  prints where. This applies to an app. In a published module package, `--emit` and `debug: true` write
+  nothing, and the pretty output prints a notice (`--format json` omits the notice and `emittedTo`). `vp pack` regenerates the `create<Module>` factory in
+  `.heximon/library/`.
 - **`heximon skills add` records only what it installed.** A source it could not fetch stays out of
   `heximon.skills`, so `heximon skills sync` never retries a URL that never worked.
 - **Adding a durable record is silent until you look for it.** A new queue channel, saga slot, workflow, or

package/dist/bin.mjs

@@ -431,7 +431,7 @@ var UpgradeBaseline = class UpgradeBaseline {
 *
 * Two opt-in passes ride the same compile. `--emit` (and the sidecar's own `debug: true`) writes the generated
 * wiring to `.heximon/` and reformats it in place, so what the compiler produced can be read; a bare run writes
-* only the verdict mirror. `--verify-baseline` makes every durable concept ALSO report the records the
+* only the verdict mirror. Both apply to the app leg only: a library run writes no wiring and says so. `--verify-baseline` makes every durable concept ALSO report the records the
 * committed `heximon.upgrade.json` never acknowledged — the direction the diff does not walk, since adding a
 * record is safe to deploy. It writes nothing, and is refused alongside `--update`, which acknowledges exactly
 * what it exists to show.
@@ -487,7 +487,7 @@ const checkCommand = defineCommand({
 		},
 		emit: {
 			type: "boolean",
-			description: "Write the generated wiring to `.heximon/` and prettify it, for inspection. The sidecar's `debug: true` turns this on for every run.",
+			description: "Write the generated app wiring to `.heximon/` and prettify it, for inspection. A library compile writes nothing: run `vp pack` to regenerate its factory. The sidecar's `debug: true` turns this on for every app-mode run.",
 			default: false
 		}
 	},
@@ -563,6 +563,7 @@ const checkCommand = defineCommand({
 		} else {
 			if (checked.emittedTo !== void 0) log.info(`Wrote the generated wiring to ${checked.emittedTo}`);
 			if (checked.prunedVerdicts !== void 0) log.info(`Removed the stale DI verdict mirror ${checked.prunedVerdicts} — it was written by an app-mode compile of this package, and a library compile emits none to replace it.`);
+			if (mode === CompileMode.Library && (args.emit === true || session.config?.debug === true)) log.warn(`${args.emit === true ? "`--emit`" : "`debug: true`"} writes app wiring only. A library's generated factory is written by \`vp pack\`.`);
 			if (mode === CompileMode.Library && verifyBaseline) log.warn(`${UpgradeBaselineFile.fileName} is an app-level artifact — a library's durable surface is verified by each app that composes it, so there is nothing here to verify.`);
 			if (mode === CompileMode.Library && args.update === true) log.warn(`${UpgradeBaselineFile.fileName} is an app-level artifact — a library's durable surface is baselined by each app that composes it, so there is nothing here to update.`);
 			else if (rebaselined !== void 0) log.success(rebaselined.changed ? `Updated ${UpgradeBaselineFile.fileName} — commit it to acknowledge the durable-surface changes.` : `${UpgradeBaselineFile.fileName} already up to date.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "heximon",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "The Heximon CLI: create, develop, build, migrate, and deploy Heximon apps.",
   "keywords": [
     "cli",
@@ -38,12 +38,12 @@
   "dependencies": {
     "@bomb.sh/tab": "^0.0.22",
     "@clack/prompts": "^1.8.0",
-    "@heximon/compiler": "0.1.1",
-    "@heximon/cqrs": "0.1.1",
-    "@heximon/deploy": "0.1.1",
-    "@heximon/http": "0.1.1",
-    "@heximon/node": "0.1.1",
-    "@heximon/testing": "0.1.1",
+    "@heximon/compiler": "0.2.0",
+    "@heximon/cqrs": "0.2.0",
+    "@heximon/deploy": "0.2.0",
+    "@heximon/http": "0.2.0",
+    "@heximon/node": "0.2.0",
+    "@heximon/testing": "0.2.0",
     "citty": "^0.2.2",
     "giget": "^3.3.1",
     "pathe": "^2.0.3"