@asc-agent/runtime 0.5.1 → 0.5.3

package/README.md

@@ -7,7 +7,7 @@ proceed-by-default, escalation, audit, the external-write guard, host integratio
 here.
 
 ```bash
-npm install -g @asc-agent/runtime@0.5.1
+npm install -g @asc-agent/runtime@0.5.3
 ```
 
 npm owns the executable link (on Windows, npm's own `asc.cmd`). This package never edits

package/dist/cli/asc.d.ts

@@ -12,4 +12,6 @@ export type AscEntry = 'runtime' | 'bootstrap';
  * 사용자가 실행하는 명령이 된다 (0.2.0 회차의 skill.ts가 그랬다).
  */
 export { BOOTSTRAP_SPEC } from '../core/distribution/release.ts';
+/** 재실행을 가로질러 진입점을 나르는 자리. 값은 `bootstrap` 하나뿐이다. */
+export declare const ENTRY_ENV = "ASC_ENTRY";
 export declare function runAscCommand(argv: string[], entry?: AscEntry): Promise<number>;

package/dist/cli/asc.js

@@ -515,7 +515,12 @@ function reportNodeRuntime(check, asJson) {
     for (const action of actions)
         console.error(`  ${action.node.version} at ${action.node.path}\n    ${action.display}`);
 }
+/** 재실행을 가로질러 진입점을 나르는 자리. 값은 `bootstrap` 하나뿐이다. */
+export const ENTRY_ENV = 'ASC_ENTRY';
 export async function runAscCommand(argv, entry = 'runtime') {
+    // 호환 Node 로 다시 실행된 프로세스는 자기가 어느 문으로 들어왔는지 argv 로는 알 수 없다.
+    const inherited = process.env[ENTRY_ENV] === 'bootstrap' ? 'bootstrap' : undefined;
+    entry = inherited ?? entry;
     let parsed;
     try {
         parsed = parseArgsOrThrow(argv);
@@ -675,7 +680,11 @@ async function runParsedCommand(values, positionals, entry, argv) {
     if (!runnable.ok) {
         // 후보를 이미 찾았으면 처방 대신 실행한다 — 같은 명령, 같은 argv, 호환 Node (A6).
         const reexec = reexecWithCandidate(runnable, argv, {
-            env: process.env,
+            // **어느 문으로 들어왔는지가 재실행을 넘어가야 한다.** 이것이 없으면 bootstrap 으로
+            // 시작한 첫 설치가 재실행 뒤 자기를 설치된 runtime 이라고 말하고, 그러면 stable
+            // runtime 설치도 기계 등록도 계획에 들지 않는다 — 기본 Node 가 하한보다 낮은 기계에서
+            // 첫 설치가 조용히 절반만 끝나던 자리다.
+            env: { ...process.env, [ENTRY_ENV]: entry },
             entry: fileURLToPath(import.meta.url),
             spawn: (path, args, env) => {
                 const child = spawnSync(path, args, { stdio: 'inherit', env: env });
@@ -1546,6 +1555,7 @@ async function detectSetupState(values, entry) {
     const attachedProfile = ascRoot ? await lockedProfileId(ascRoot) : undefined;
     // 이번 계획이 쓸 Profile 하나 — 그것의 결합 선언이 비어 있을 때만 제안을 관측한다.
     const targetProfile = values.profile ?? attachedProfile ?? adoptable.adoptable?.id;
+    const stable = entry === 'bootstrap' ? await detectStableInstall(nodeProcessRunner) : undefined;
     return {
         entry,
         projectRoot,
@@ -1564,11 +1574,11 @@ async function detectSetupState(values, entry) {
         host: [{ id: 'claude', status: hostReport.status }],
         // Profile 이 작업 도구를 선언했으면 그 준비 상태까지 본다 (설계 §9.3).
         ...(await workBindingState(ascRoot, projectRoot)),
-        // 이 기계의 지속 등록. **별도 onboarding 을 만들지 않는다** — 같은 계획에 함께 든다.
-        ...(await persistentRuntimeState(values)),
         // **bootstrap으로 들어왔을 때만 본다.** 설치된 runtime이 자기를 다시 설치할 이유가
         // 없고, 그 축을 안 그리면 plan은 설치된 `asc` 를 전제하지도 않는다 (C-14 §3.4).
-        ...(entry === 'bootstrap' ? { stableRuntime: await detectStableInstall(nodeProcessRunner) } : {}),
+        ...(stable ? { stableRuntime: stable } : {}),
+        // 이 기계의 지속 등록. **별도 onboarding 을 만들지 않는다** — 같은 계획에 함께 든다.
+        ...(await persistentRuntimeState(values, Boolean(stable && stable.status !== 'CURRENT'))),
     };
 }
 /**
@@ -1595,7 +1605,7 @@ function runningFromInstalledPackage() {
 function serviceRegistrationAllowed() {
     if (process.env.ASC_SERVICE === 'off')
         return false;
-    return runningFromInstalledPackage();
+    return true;
 }
 /**
  * 이 기계에 ASC runtime 이 등록돼 있는가 (설계 §6, Gate 7).
@@ -1603,7 +1613,7 @@ function serviceRegistrationAllowed() {
  * 물어볼 수 없으면 이 축을 그리지 않는다 — 모르는 것을 "해야 한다"로 적으면 설치되지
  * 않은 기계에서 setup 이 영영 끝나지 않는다.
  */
-async function persistentRuntimeState(values) {
+async function persistentRuntimeState(values, installing) {
     if (!serviceRegistrationAllowed())
         return {};
     const adapter = serviceAdapter();
@@ -1611,10 +1621,19 @@ async function persistentRuntimeState(values) {
         return {};
     // 등록물이 가리킬 자리가 없으면 이 축을 그리지 않는다 — 깨진 등록을 남기느니 등록하지
     // 않고 그 사실을 말한다 (P0 F1).
+    //
+    // **이번 계획이 그 자리를 만든다면 지금 없는 것은 근거가 아니다.** 첫 설치는 npx 로
+    // 들어와 전역 runtime 을 놓는데, 그 전에 판정하면 "가리킬 것이 없다" 가 되어 등록이
+    // 영영 계획에 들지 않는다 — 사람이 뒤에 명령 하나를 더 쳐야 했던 자리다. 등록 자체는
+    // apply 순서상 맨 마지막이고, 그때 다시 해석한다.
     const runtime = await serviceRuntime();
-    if (runtime.kind !== 'STABLE') {
+    if (runtime.kind !== 'STABLE' && !installing) {
         return { persistentRuntime: { action: 'unsupported', adapter: adapter.id, detail: runtime.detail } };
     }
+    if (runtime.kind !== 'STABLE') {
+        // 아직 없다 — 이번에 놓는다. 그러면 등록할 것이 생긴다.
+        return { persistentRuntime: { action: 'install', adapter: adapter.id } };
+    }
     const plan = await planPersistentRuntime(adapter, serviceCommand(serviceInterval(values), runtime)).catch(() => null);
     if (!plan)
         return {};
@@ -3860,7 +3879,9 @@ async function serviceRuntime() {
     const stable = await globalRuntimeEntry();
     const check = await checkNodeRuntime(nodeRuntimeDeps());
     return resolveServiceRuntime({
-        runningEntry: fileURLToPath(import.meta.url),
+        // **checkout 은 등록물이 가리킬 자리가 아니다.** 지금 도는 것을 후보로 쓰는 것은 그것이
+        // 설치된 패키지일 때뿐이고, 아니면 전역 설치본만 남는다 — 없으면 등록하지 않는다.
+        runningEntry: runningFromInstalledPackage() ? fileURLToPath(import.meta.url) : '/dev/null/not-installed',
         runningNode: process.execPath,
         runningNodeVersion: process.version,
         ...(stable ? { stableEntry: stable } : {}),

package/dist/core/distribution/release.d.ts

@@ -1,9 +1,9 @@
 export declare const RUNTIME_PACKAGE = "@asc-agent/runtime";
 export declare const BOOTSTRAP_PACKAGE = "@asc-agent/bootstrap";
 /** runtime과 bootstrap은 초기 release에서 lockstep이다. */
-export declare const RELEASE_VERSION = "0.5.1";
-export declare const RUNTIME_SPEC = "@asc-agent/runtime@0.5.1";
-export declare const BOOTSTRAP_SPEC = "@asc-agent/bootstrap@0.5.1";
+export declare const RELEASE_VERSION = "0.5.3";
+export declare const RUNTIME_SPEC = "@asc-agent/runtime@0.5.3";
+export declare const BOOTSTRAP_SPEC = "@asc-agent/bootstrap@0.5.3";
 /**
  * 아직 설치되지 않은 machine에서 그대로 실행되는 형태 (C-14 §3.4).
  *

package/dist/core/distribution/release.js

@@ -9,7 +9,7 @@
 export const RUNTIME_PACKAGE = '@asc-agent/runtime';
 export const BOOTSTRAP_PACKAGE = '@asc-agent/bootstrap';
 /** runtime과 bootstrap은 초기 release에서 lockstep이다. */
-export const RELEASE_VERSION = '0.5.1';
+export const RELEASE_VERSION = '0.5.3';
 export const RUNTIME_SPEC = `${RUNTIME_PACKAGE}@${RELEASE_VERSION}`;
 export const BOOTSTRAP_SPEC = `${BOOTSTRAP_PACKAGE}@${RELEASE_VERSION}`;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asc-agent/runtime",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "ASC (Agent Session Control) \u2014 local-first human-in-the-loop agent control plane: core, CLI, and adapters",
   "keywords": [
     "agent",