@cheezmil/coraek 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,60 @@
-# Temporary Holding Version
+---
+description: "AEK base identity layer — rebrands the dsh web UI sidebar and startup announcement for AEK deployments."
+kind: "package-reference"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @cheezmil/coraek
+
+The AEK base identity layer. It rebrands two user-visible surfaces of a dsh web
+profile so they read as AEK instead of DeepSeek Harness:
+
+- the **sidebar brand** — fills the `sidebar.brand.mark` and `sidebar.brand.name`
+  slots with the AEK orange-slice mark and the `AEK` name, replacing the shell's
+  fish-mark and `brand.localBuild` fallback;
+- the **startup announcement** — prints the `aek web: <url>` readiness line,
+  replacing the dsh web-app bundle's own `dsh web:` line (which the web profile
+  suppresses with `printUrl: false`).
+
+The document title is rebranded separately through the `DSH_CLIENT_TITLE` build
+environment value, which `AppFrame` already reads. This package has no runtime
+state and does not affect model requests.
+
+## Use this package
+
+Install it into a dsh web profile and register it in the profile's coraek patch:
+
+```yaml
+- id: coraek
+  name: '@cheezmil/coraek'
+```
+
+Suppress the dsh bundle's own URL line so only the AEK line prints:
+
+```yaml
+- id: web-app
+  name: '@deepseek-ai/dsh-web-app'
+  config:
+    printUrl: false
+```
+
+## Understand the implementation
+
+The host half (`src/index.ts`) injects the `connection` service and prints
+`aek web: <authenticatedUrl>` once, mirroring the web-app bundle's readiness
+line. The client half (`src/client/index.ts`) injects the `slots` service and
+registers the AEK mark and name into the sidebar brand slots as one
+declaration-aware set, the same pattern as `@deepseek-ai/dsh-client-ui-brand-official`.
+
+## Model Experience
+
+No effect on model requests, token usage, or KV-cache behavior. The package
+changes only browser presentation and process stdout.
+
+## Known Limitations and Deferred Work
+
+- The AEK name is plain localized text, not an SVG wordmark; a designed
+  wordmark can replace `AekBrandName` later.
+- The host half prints as soon as the `connection` service mounts; it does not
+  wait for the full Loader tree to settle (sufficient for a human-readable
+  readiness line; a supervisor that RPCs on seeing the line should wait for
+  the dsh bundle's own loader-gated signal).

package/lib/client.js

@@ -0,0 +1,19 @@
+window.__ModuleLoader__.load({
+	id: "@cheezmil/coraek",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		//#region src/client/index.ts
+		/** aek-home owns the surface; aek-base contributes no client UI. */
+		const inject = [];
+		/** Identity no-op: the AEK brand now lives in aek-home's own surface. */
+		function apply(_ctx) {}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,28 @@
+//#region lib/types/index.js
+/**
+* AEK base identity layer. Prints the `aek web:` readiness line.
+* @module @cheezmil/aek-base
+*/
+/** Stable Coraek plugin name. */
+const name = "coraek";
+/** Services required before the AEK URL line can print. */
+const inject = ["webServer"];
+const ANNOUNCED_ROOTS = /* @__PURE__ */ new WeakSet();
+/**
+* Print the `aek web:` readiness line.
+*/
+function apply(ctx) {
+	ctx.inject(["connection"], (connectionCtx) => {
+		if (ANNOUNCED_ROOTS.has(connectionCtx.root)) return;
+		const url = connectionCtx.connection.authenticatedUrl(ctx.webServer.getOrigin());
+		ANNOUNCED_ROOTS.add(connectionCtx.root);
+		console.log(`aek web: ${url}`);
+	});
+}
+const CORAEK_VERSION = "1.0.0";
+const CORAEK_NAME = "coraek";
+function announceCoraek() {
+	console.log(`coraek ${CORAEK_VERSION}`);
+}
+//#endregion
+export { CORAEK_NAME, CORAEK_VERSION, announceCoraek, apply, inject, name };

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@cheezmil/coraek",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "AEK base identity layer: pins the AEK home dir and prints the `aek web:` startup line; the client half is an identity no-op (aek-home owns the surface)",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./types": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch",
+    "build": "tsdown",
+    "build:cli": "tsdown -c tsdown.cli.config.ts",
+    "prepack": "pnpm run build && pnpm run build:cli"
+  },
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0",
+    "@deepseek-ai/cosmokit": ">=1.8.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/cosmokit": "^1.8.6",
+    "@deepseek-ai/dsh-client-connection": "workspace:*",
+    "@deepseek-ai/dsh-client-ui-primitives": "workspace:*",
+    "@deepseek-ai/dsh-client-ui-renderer": "workspace:*",
+    "@deepseek-ai/dsh-client-ui-sidebar": "workspace:*",
+    "@deepseek-ai/dsh-host-webserver": "workspace:*",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "aek": {
+    "type": "dsh-bundle",
+    "description": "AEK identity layer: re-exports Context/Volatile/ClientContext types and prints the aek web: readiness line"
+  },
+  "dependencies": {
+    "@oclif/core": "^5.1.11"
+  }
 }