openxiangda-cli 2.0.0-alpha.76 → 2.0.0-alpha.78

package/README.md

@@ -4,4 +4,10 @@ OpenXiangda 2.0 installs one developer CLI with exactly eight top-level commands
 
 The CLI disables user, development and JIT plugin loading. A clean build removes orphaned command output before TypeScript compilation. `--json` emits one stable result envelope and never mixes progress logs into machine output.
 
+AI-native development clients use the same pinned executable in pre-command
+stdio mode: `pnpm exec openxiangda --mcp-stdio --cwd <workspace>`. They can read
+`openxiangda://workspace/contracts` or call `contract_describe` to obtain the
+compiler-owned `aiCatalog` and `aiCatalogDigest`. This transport does not add a
+ninth Oclif command and applications must not implement a second MCP server.
+
 `dev` starts local Web/Nest hot reload and a loopback connected proxy. `deploy` defaults to test; production explicitly reuses a successful test AppVersion. Application binding, initialization, generation, tests and builds are internal stages rather than separate commands.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-cli",
-  "version": "2.0.0-alpha.76",
+  "version": "2.0.0-alpha.78",
   "description": "Thin application-level CLI for OpenXiangda 2.0.",
   "type": "module",
   "main": "./dist/index.js",

package/template/AGENTS.md

@@ -12,3 +12,4 @@
 - A single directory user reference uses a `string` field; a single department or same-app resource reference uses `uuid`; every `multiple: true` reference uses `json`. Roles that consume directory-backed fields explicitly include `app:<app-code>:directory:read`.
 - Do not add compatibility aliases, migration branches or silent fallbacks for an earlier 2.0 alpha contract. Replace an incorrect contract and regenerate the application.
 - Run `pnpm openxiangda check` after contract changes. Deploy with `pnpm openxiangda deploy`, inspect with `pnpm openxiangda status` and `pnpm openxiangda logs`, and use the platform rollback command rather than mutating K3s directly.
+- AI-native clients start the workspace protocol through the same pinned binary: `pnpm exec openxiangda --mcp-stdio --cwd <workspace>`. Read `openxiangda://workspace/contracts` or call `contract_describe`, and require its `aiCatalog` and `aiCatalogDigest` to match the normal compiler output. This is a stdio transport mode, not a ninth CLI command. Never write an application MCP server, Catalog file, preview store or second authorization path.

package/template/apps/web/playwright.config.ts

@@ -1,7 +1,8 @@
 import { defineConfig } from '@playwright/test';
 
+const e2ePort = resolveE2ePort();
 const baseURL =
-  process.env.OPENXIANGDA_E2E_BASE_URL || 'http://127.0.0.1:4173';
+  process.env.OPENXIANGDA_E2E_BASE_URL || `http://127.0.0.1:${e2ePort}`;
 
 export default defineConfig({
   testDir: './e2e',
@@ -13,9 +14,28 @@ export default defineConfig({
         url: baseURL,
         reuseExistingServer: false,
         env: {
-          OPENXIANGDA_WEB_PORT: '4173',
+          OPENXIANGDA_WEB_PORT: String(e2ePort),
           OPENXIANGDA_ENVIRONMENT_KEY: 'production',
           OPENXIANGDA_DEV_PROXY: 'http://127.0.0.1:7001',
         },
       },
 });
+
+function resolveE2ePort() {
+  const configured = process.env.OPENXIANGDA_E2E_PORT;
+  if (configured !== undefined) {
+    const port = Number(configured);
+    if (!Number.isInteger(port) || port < 1024 || port > 65535) {
+      throw new Error(
+        'OPENXIANGDA_E2E_PORT must be an integer between 1024 and 65535'
+      );
+    }
+    return port;
+  }
+
+  let hash = 2166136261;
+  for (const character of process.cwd()) {
+    hash = Math.imul(hash ^ character.charCodeAt(0), 16777619);
+  }
+  return 30_000 + ((hash >>> 0) % 30_000);
+}

package/template/package.json

@@ -22,7 +22,7 @@
     "build": "pnpm --recursive build"
   },
   "devDependencies": {
-    "openxiangda-cli": "2.0.0-alpha.76",
+    "openxiangda-cli": "2.0.0-alpha.78",
     "openxiangda-contracts": "2.0.0-alpha.35",
     "openxiangda-devkit-core": "2.0.0-alpha.46",
     "typescript": "5.9.3"