개선: package engine 기본 진입 확정

Machine profile initializer가 설치본의 owned CPython을 기본 선택하고 명시 경로는 override로 보존한다.
도움말과 사용 문서, 설치 tarball 및 제품 계약 게이트를 짧아진 진입 명령에 맞췄다.
검증: npm test, npm run test:contracts, npm run test:package, npm run test:mcp-product GREEN.

Author: eddmpython

mainPlan/9-agentComputerStandardReadiness/README.md

@@ -1,6 +1,6 @@
 # Initiative 9: agent computer와 웹 표준 후보 준비도
 
-상태: **진행 중, M0 완료, M1 대기**
+상태: **진행 중, M0 완료, M1 첫 하위 계약 완료**
 
 이 문서는 agent가 pyproc에 들어와 보고, 행동하고, 계산하고, 세션을 넘겨 계속 일하는 전 과정을
 제품 기준으로 끌어올리는 실행 원장이다. 기존 능력 점수와 증거의 정본은
@@ -14,7 +14,7 @@
 
 | 질문 | 현재 판정 | 실사용 증거 | 완성까지 남은 것 |
 |---|---|---|---|
-| agent 진입점 | 강함, 완성 아님 | exact install, `pythonOnly` init, effect-free doctor, CPython 실행이 공개 명령으로 완결 | 성공한 startup timeout timer가 Node를 기본 30초까지 붙잡는 수명주기 결함 제거 |
+| agent 진입점 | 강함, 완성 아님 | exact install 뒤 `pythonOnly` init, effect-free doctor, CPython 실행이 공개 명령으로 완결되고 현재 main은 package engine을 자동 선택 | 첫 문서 교체 자동 수렴과 client별 다음 명령 의미 통일 |
 | 눈과 팔 | 강함, 완성 아님 | APX Situation이 링크를 식별하고 proof-carrying click 뒤 `Smallest start` 출현을 confirmed로 봉인 | 첫 문서 교체 복구 여정, 장기 반복 수명주기, 실제 GPU visual oracle 확대 |
 | 비-agent 컴퓨팅 몸체 | 훌륭한 브라우저 컴퓨터, 로컬 OS 완전 대체는 아님 | owned CPython, worker process, OPFS disk, checkpoint, Machine image, Python과 x86 guest gate | 임의 native wheel, shared-memory thread, wasm 도구층, Node guest, quota 축출 계약 |
 | 단독 자립성 | Python 기본 Machine은 높음, 전체 WebComputer는 미완성 | source-built CPython과 stdlib가 npm에 포함되고 기본 부팅의 제3자 요청은 0 | x86 emulator와 firmware의 독립 재현, GPU 실기 CI, 브라우저 범위 확대 |
@@ -69,12 +69,19 @@ implementation experience는 독립적이고 상호운용 가능한 구현, 저
 
 ### M1. Machine Entrance 첫 결과 수렴
 
-판정: **다음 작업**
+판정: **진행 중**
 
-- exact version 설치 뒤 engine 경로를 사람이 조립하지 않아도 되는 공개 recipe를 확정한다.
+- 완료: exact version 설치 뒤 engine 경로를 사람이 조립하지 않아도 package-owned CPython을 선택한다.
+  명시한 `--engine-root`만 override로 사용하며 결과와 생성 README에 선택 출처와 절대 경로를 남긴다.
 - COI bootstrap의 첫 문서 교체를 관찰, 재발급, bounded retry 계약으로 한 번에 수렴시킨다.
 - doctor의 다음 명령이 shell, JavaScript, Python, MCP에서 같은 의미를 가진다.
 
+첫 하위 계약 증거:
+
+- `pyproc-mcp init --recipe pythonOnly`가 설치 tarball 내부 owned engine으로 manifest를 만든다.
+- 순수 parser는 package 경로를 추측하지 않고 initializer만 설치 경계를 해석한다.
+- contract 36 suites, package gate, 전체 12개 게이트, 설치 MCP 제품 20개가 GREEN이다.
+
 ### M2. Eyes와 Arms 장기 수명주기
 
 - 반복 Situation, screenshot, proof-carrying action, artifact cleanup에서 handle과 process 잔류 0을 증명한다.

scripts/machineEntrance/profileInitializer.js

@@ -7,6 +7,9 @@ import { compileMachineProfile } from "./machineProfile.js";
 
 export const MACHINE_PROFILE_DIRECTORY = ".pyproc";
 export const MACHINE_PROFILE_FILES = Object.freeze(["manifest.json", "client.json", "README.md"]);
+export const MACHINE_PROFILE_ENGINE_RELATIVE_PATH = Object.freeze([
+  "src", "runtime", "engines", "wasi", "owned", "core",
+]);
 
 async function exists(path) {
   try { await access(path, constants.F_OK); return true; } catch (error) { return false; }
@@ -47,10 +50,11 @@ function clientSource(manifestPath) {
   }, null, 2)}\n`;
 }
 
-function readmeSource({ recipe, manifestPath, output }) {
+function readmeSource({ recipe, manifestPath, output, engine }) {
   return `# pyproc Machine profile
 
 Recipe: \`${recipe}\`
+Engine: \`${engine.root}\` (${engine.source === "packageDefault" ? "installed package default" : "explicit override"})
 
 This directory contains a fully expanded authority manifest. The recipe name is descriptive and does not
 grant authority at runtime. The manifest remains subject to the strict product validator.
@@ -82,14 +86,15 @@ async function packageVersion(packageRoot) {
   return version;
 }
 
-function sourcesFor({ profile, output }) {
+function sourcesFor({ profile, output, engineSource }) {
   const manifestPath = join(output, "manifest.json");
-  const manifest = `${JSON.stringify(compileMachineProfile(profile), null, 2)}\n`;
-  return new Map([
-    [manifestPath, manifest],
+  const compiled = compileMachineProfile(profile);
+  const engine = Object.freeze({ source: engineSource, root: compiled.engine.root });
+  return Object.freeze({ engine, files: new Map([
+    [manifestPath, `${JSON.stringify(compiled, null, 2)}\n`],
     [join(output, "client.json"), clientSource(manifestPath)],
-    [join(output, "README.md"), readmeSource({ recipe: profile.recipe, manifestPath, output })],
-  ]);
+    [join(output, "README.md"), readmeSource({ recipe: profile.recipe, manifestPath, output, engine })],
+  ]) });
 }
 
 async function writeAtomically(files, { overwrite }) {
@@ -144,7 +149,13 @@ export async function initializeMachineProfile({
     throw new TypeError("Machine profile overwrite and dryRun must be boolean");
   }
   const paths = await normalizedOutput(projectRoot, outputDir);
-  const files = sourcesFor({ profile, output: paths.output });
+  const usesPackageEngine = profile?.engineRoot === undefined;
+  const resolvedProfile = usesPackageEngine && profile && typeof profile === "object" && !Array.isArray(profile)
+    ? { ...profile, engineRoot: join(resolve(packageRoot), ...MACHINE_PROFILE_ENGINE_RELATIVE_PATH) }
+    : profile;
+  const generated = sourcesFor({ profile: resolvedProfile, output: paths.output,
+    engineSource: usesPackageEngine ? "packageDefault" : "explicit" });
+  const files = generated.files;
   const present = [];
   for (const path of files.keys()) if (await exists(path)) present.push(path);
   if (present.length && !overwrite) {
@@ -163,8 +174,9 @@ export async function initializeMachineProfile({
   }
   return Object.freeze({
     ok: true,
-    recipe: profile.recipe,
+    recipe: resolvedProfile.recipe,
     package: Object.freeze({ name: "pyproc", version }),
+    engine: generated.engine,
     projectRoot: paths.root,
     output: paths.output,
     manifestPath: join(paths.output, "manifest.json"),

scripts/pyprocMcp.mjs

@@ -10,7 +10,7 @@ import { parseMachineProfileInitArguments } from "./machineEntrance/entranceCli.
 import { initializeMachineProfile } from "./machineEntrance/profileInitializer.js";
 
 const HELP = `Usage:
-  pyproc-mcp init --recipe <name> --engine-root <directory> [options]
+  pyproc-mcp init --recipe <name> [options]
   pyproc-mcp --config <file> [--check]
 
 Options:
@@ -31,12 +31,13 @@ existing generated profile explicitly.
 `;
 
 const INIT_HELP = `Usage:
-  pyproc-mcp init --recipe <name> --engine-root <directory> [options]
+  pyproc-mcp init --recipe <name> [options]
 
 Profile:
   --project-root <directory>  Existing project root, defaults to the current directory
   --out <directory>           Project-relative output, defaults to .pyproc
   --recipe <name>             pythonOnly, observeLocal, authorizedBrowser, replayPinned, or transactionalApp
+  --engine-root <directory>   Override the installed package's owned CPython engine
   --timeout-ms <n>            Product operation timeout
   --dry-run                   Compile and report paths without writing
   --overwrite                 Explicitly replace an existing generated profile

skills/automate-browser-with-pyproc/references/browser-automation.md

@@ -42,7 +42,6 @@ Compile the common authorized profile without hand-editing JSON:
 ```sh
 npx pyproc-mcp init \
   --recipe authorizedBrowser \
-  --engine-root /absolute/path/to/cpython-wasi \
   --origin https://example.test \
   --action snapshot --action screenshot --action waitFor \
   --action hydrateLazy --action navigate --action fill --action click \

skills/catalog.json

@@ -1,8 +1,8 @@
 {
   "format": "pyproc-skill-catalog",
   "version": 1,
-  "generatedFromDigest": "sha256:73d00e9b3bbfc2ac4ef12dbaef447ff58f26006c5b4f221a69244fca14271a05",
-  "catalogDigest": "sha256:e8ea587cf3d39528009491509b46e4f6b48e85ac92784a34bbcfd48093b5b790",
+  "generatedFromDigest": "sha256:9c06919dd70f238862b63ebad7cbee841a1a729b4ef6e8fad7bb8f7c89c7b752",
+  "catalogDigest": "sha256:891dd216f8d13753cefd65d64000e0974ece48da29315938b2dc3874be2d3cc6",
   "skills": [
     {
       "name": "automate-browser-with-pyproc",
@@ -259,8 +259,8 @@
     },
     {
       "path": "skills/automate-browser-with-pyproc/references/browser-automation.md",
-      "bytes": 24898,
-      "sha256": "sha256:e4d1521aa7e437d9518b8a70f688d5df74dbd27a72f5acd65d9a249240ff1e84"
+      "bytes": 24849,
+      "sha256": "sha256:2e227a6abdab284468f73d640935f2de3ecc3bbb260eb8c657648a480f646812"
     },
     {
       "path": "skills/automate-browser-with-pyproc/references/frame-space.md",
@@ -279,23 +279,23 @@
     },
     {
       "path": "skills/commit-pyproc-effects/references/rehearse-commit.md",
-      "bytes": 23161,
-      "sha256": "sha256:1db925b8a4869a5df11da96e5c13fd4a48b8b080cb7a9e8294d4da222130b63f"
+      "bytes": 23112,
+      "sha256": "sha256:32a701b9a4051380d294ba770322055094f07b6f3fbc4a6dce8c0ef22fdb0fc5"
     },
     {
       "path": "skills/control-pyproc/references/control-protocol.md",
-      "bytes": 17721,
-      "sha256": "sha256:a0cfd3bf7a32384ead125c19e0c5d53ebc52bb11fa95a476bc76425ccf77c497"
+      "bytes": 17676,
+      "sha256": "sha256:0eef53dddc2a170007da9deecfa23da5ab888d236e0afd007f45d1fe3d883c13"
     },
     {
       "path": "skills/control-pyproc/references/javascript-control.md",
-      "bytes": 13418,
-      "sha256": "sha256:a8039207d55f0bd8188702566733adf58f430ce18ea1c4612d1b7c172f3918ea"
+      "bytes": 13324,
+      "sha256": "sha256:9aa6c56619822bb1d976002a7f2ebe0de5a219e43dbb6d4adadd645510df98d0"
     },
     {
       "path": "skills/control-pyproc/references/python-sdk.md",
-      "bytes": 14967,
-      "sha256": "sha256:8bf700408f7cd8c580b49c41a72fc6c458c3b68e30af26b176311c291442def3"
+      "bytes": 14922,
+      "sha256": "sha256:68301dc1ad32c591af3490d3dfd0c49a7c68b1ae5f803133ea0bc28ec5482d75"
     },
     {
       "path": "skills/develop-pyproc/references/module-boundaries.md",
@@ -374,8 +374,8 @@
     },
     {
       "path": "skills/transact-pyproc-app-state/references/app-space.md",
-      "bytes": 17480,
-      "sha256": "sha256:20456153aa33fe25ad5707b797dbe349b5ce120d90a7d212a2f935545ab24ae9"
+      "bytes": 17431,
+      "sha256": "sha256:6f47730d99e511b38845f0aec4d25a0fdf3455621c041e00e68ab944bf5ccf29"
     },
     {
       "path": "skills/understand-pyproc/references/capability-matrix.md",
@@ -399,8 +399,8 @@
     },
     {
       "path": "skills/use-pyproc-machine/references/machine-entrance.md",
-      "bytes": 8896,
-      "sha256": "sha256:f86431134980d6e9b8fcde47fe87057be63865b5213b6b9d39964c47e10ec201"
+      "bytes": 8554,
+      "sha256": "sha256:efeb28d4bf4564481cdee5f2f7197f44c7704b0cd1c7bf5100ac3a4290cd701c"
     },
     {
       "path": "skills/use-pyproc-machine/references/machine-fleet.md",

skills/commit-pyproc-effects/references/rehearse-commit.md

@@ -53,7 +53,6 @@ and put only its public key in the product profile.
 ```sh
 npx pyproc-mcp init \
   --recipe authorizedBrowser \
-  --engine-root /absolute/path/to/cpython-wasi \
   --origin https://work.example.test \
   --action snapshot --action click \
   --max-risk externalEffect \

skills/control-pyproc/references/control-protocol.md

@@ -26,7 +26,7 @@ the official Python client is documented in the [Python SDK guide](./python-sdk.
 Compile a profile and run the complete effect-free doctor before starting the protocol:
 
 ```sh
-npx pyproc-mcp init --recipe pythonOnly --engine-root /absolute/path/to/cpython-wasi
+npx pyproc-mcp init --recipe pythonOnly
 npx pyproc-control doctor --config ./.pyproc/manifest.json
 npx pyproc-control run --config ./.pyproc/manifest.json --code "40 + 2"
 ```

skills/control-pyproc/references/javascript-control.md

@@ -35,7 +35,7 @@ Create the version 1 policy manifest with [Machine Entrance](../../use-pyproc-ma
 starting a live product:
 
 ```sh
-npx pyproc-mcp init --recipe pythonOnly --engine-root /absolute/path/to/cpython-wasi
+npx pyproc-mcp init --recipe pythonOnly
 npx pyproc-control doctor --config ./.pyproc/manifest.json
 ```
 
@@ -81,7 +81,6 @@ Enable it when creating the profile, then publish the current Machine as an immu
 ```sh
 npx pyproc-mcp init \
   --recipe pythonOnly \
-  --engine-root /absolute/path/to/cpython-wasi \
   --execution-memory-root /absolute/private/pyproc-memory
 ```
 

skills/control-pyproc/references/python-sdk.md

@@ -46,7 +46,7 @@ Create the version 1 manifest with [Machine Entrance](../../use-pyproc-machine/r
 `"browser": { "enabled": false }`. Run the complete doctor before use:
 
 ```sh
-npx pyproc-mcp init --recipe pythonOnly --engine-root /absolute/path/to/cpython-wasi
+npx pyproc-mcp init --recipe pythonOnly
 npx pyproc-control doctor --config ./.pyproc/manifest.json
 ```
 

skills/transact-pyproc-app-state/references/app-space.md

@@ -38,7 +38,6 @@ compile the `transactionalApp` recipe:
 ```sh
 npx pyproc-mcp init \
   --recipe transactionalApp \
-  --engine-root /absolute/path/to/cpython-wasi \
   --origin https://workspace.example.test \
   --action snapshot --action click \
   --purpose "branch the cooperative workspace" \