@asc-agent/runtime 0.6.1 → 0.7.0

package/dist/core/runtime/background.js

@@ -16,6 +16,18 @@ import { dirname } from 'node:path';
 export const RUNTIME_LEASE_KEY = 'runtime-lease';
 /** 마지막 회차 시각이 사는 열쇠. Orchestrator가 쓰고 status가 읽는다. */
 export const LAST_RUN_KEY = 'last-run';
+/**
+ * 마지막 기계 회차가 이 workspace 에서 **어떻게 끝났는가** (0.7.0 / Phase J).
+ *
+ * 실측 하나가 이 열쇠의 출처다. 이 기계의 workspace 세 개 중 둘이 여러 릴리스 동안
+ * 회차를 한 번도 통과하지 못했는데, 화면 어디에도 그 말이 없었다 — 붙어 있고, 등록물도
+ * 서 있고, 그래서 건강해 보였다. 실패는 `service.log` 에만 흘러갔고 아무도 그것을 읽지
+ * 않는다.
+ *
+ * 새 상태 저장소가 아니다. 이미 회차가 쓰고 status 가 읽는 같은 scope 의 기록 하나이며,
+ * 판정도 하지 않는다 — 무슨 일이 있었는지만 적는다.
+ */
+export const LAST_PASS_KEY = 'last-pass';
 /**
  * lease가 죽은 것으로 보이기까지의 최소 시간.
  *
@@ -125,6 +137,40 @@ export class RuntimeLease {
         await this.#scope.delete(RUNTIME_LEASE_KEY);
     }
 }
+/**
+ * 회차 결말을 적는다. **판정하지 않는다** — 코드와 연속 실패 수를 세어 둘 뿐이다.
+ *
+ * 이전 기록을 읽어 이어 세므로, 성공 한 번이 실패의 역사를 지운다. 그것이 맞다:
+ * 지금 돌고 있다면 사람이 볼 것은 지금이다.
+ */
+export async function recordPass(scope, code, at = new Date().toISOString()) {
+    let previous;
+    const raw = await scope.get(LAST_PASS_KEY);
+    if (raw) {
+        try {
+            previous = JSON.parse(raw);
+        }
+        catch {
+            // 못 읽는 기록은 없는 것으로 본다 — 이 값 때문에 회차가 멈추면 안 된다
+        }
+    }
+    const record = {
+        at,
+        code,
+        consecutiveFailures: code === 0 ? 0 : (previous?.consecutiveFailures ?? 0) + 1,
+        ...(code === 0 ? { lastOkAt: at } : previous?.lastOkAt ? { lastOkAt: previous.lastOkAt } : {}),
+    };
+    await scope.set(LAST_PASS_KEY, JSON.stringify(record));
+    return record;
+}
+/** 붙어 있다는 것과 돌고 있다는 것은 다른 사실이다. 무엇이 어긋났는지 한 줄로 말한다. */
+export function passLine(record) {
+    if (!record || record.code === 0)
+        return null;
+    const since = record.lastOkAt ? `last good pass ${record.lastOkAt}` : 'no pass has ever succeeded here';
+    return (`Background runtime: DEGRADED — the last machine pass exited ${record.code} ` +
+        `(${record.consecutiveFailures} in a row, ${since}). Attached is not the same as observed.`);
+}
 /** 상태를 모은다. **읽기만 한다** — 보는 것이 상태를 바꾸면 아무도 못 본다. */
 export async function readBackground(scope, staleMs, now = () => new Date().toISOString()) {
     const lease = await new RuntimeLease({ scope, owner: '(reader)', staleMs, now }).read();
@@ -138,7 +184,17 @@ export async function readBackground(scope, staleMs, now = () => new Date().toIS
             // 깨진 기록은 없는 것으로 본다 — 아래 렌더가 "한 번도 돌지 않았다"로 말한다
         }
     }
-    return { lease, lastRun, staleMs };
+    let lastPass;
+    const passRaw = await scope.get(LAST_PASS_KEY);
+    if (passRaw) {
+        try {
+            lastPass = JSON.parse(passRaw);
+        }
+        catch {
+            // 깨진 기록은 없는 것으로 본다
+        }
+    }
+    return { lease, lastRun, ...(lastPass ? { lastPass } : {}), staleMs };
 }
 const ORDER = ['delta', 'reconcile', 'census', 'digest'];
 /**
@@ -149,9 +205,19 @@ const ORDER = ['delta', 'reconcile', 'census', 'digest'];
  */
 export function renderBackground(status) {
     const lines = [];
+    // 회차가 서 있는 것과 그 회차가 이 자리를 실제로 돌았는지는 다른 사실이다.
+    // 어긋나 있으면 lease 상태보다 먼저 말한다 — 아래 줄들은 "돌고 있다" 로 읽힌다.
+    const degraded = passLine(status.lastPass);
+    if (degraded)
+        lines.push(degraded);
     switch (status.lease.kind) {
         case 'FREE':
-            lines.push('Background runtime: not running — `asc runtime start --detach` keeps it observing');
+            // **정상 경로는 기계 등록물이다** (0.4.0 이 그렇게 정했다: "those surfaces exist for
+            // development and recovery, not for the normal path"). 그런데 이 줄은 사람에게
+            // 개발용 명령을 정상 경로로 안내하고 있었다 — 화면이 결정과 어긋나 있으면 사람은
+            // 화면을 따른다.
+            lines.push('Background runtime: not running — this machine observes through its registration ' +
+                '(`asc runtime service status` shows it)');
             break;
         case 'HELD':
             lines.push(`Background runtime: running (pid ${status.lease.record.pid}, since ${status.lease.record.startedAt}, last heartbeat ${status.lease.record.at})`);

package/dist/core/runtime/controller.d.ts

@@ -8,6 +8,14 @@ export type CollectOutcome = {
     active: string[];
     /** 이번에 거둔 세션들. Handoff를 읽었다는 뜻이다. */
     collected: string[];
+    /**
+     * 거둔 세션 그 자체 (0.7.0).
+     *
+     * 회수는 세션을 보관소로 옮기고 끝난다. 그 뒤에 다시 목록을 물으면 방금 거둔 것은
+     * 거기 없다 — 화면이 `(다음 작업 없음)` 을 적던 자리가 정확히 여기였다. 인계를 읽은
+     * 것은 회수이므로, 읽은 것을 그대로 넘긴다.
+     */
+    handoffs: Session[];
     /** 사람이 판단할 것 — 미결과 막힌 세션. */
     awaiting: string[];
     occupancy: {
@@ -37,4 +45,4 @@ export type CollectOptions = {
  */
 export declare function collectSessions(store: StateStore, at: string, options?: CollectOptions): Promise<CollectOutcome>;
 /** 사람이 읽는 회수 결과. 다음에 무엇을 할지가 맨 아래 오도록 짠다. */
-export declare function renderCollect(outcome: CollectOutcome, sessions: readonly Session[]): string;
+export declare function renderCollect(outcome: CollectOutcome): string;

package/dist/core/runtime/controller.js

@@ -90,10 +90,10 @@ export async function collectSessions(store, at, options = {}) {
         // 같은 세션을 다시 거두지 않는다 — 멱등을 따로 구현할 필요가 없다 (OM §7.4).
         await store.archive('session', session.id);
     }
-    return { active, collected: finished.map((s) => s.id), awaiting, occupancy };
+    return { active, collected: finished.map((s) => s.id), handoffs: finished, awaiting, occupancy };
 }
 /** 사람이 읽는 회수 결과. 다음에 무엇을 할지가 맨 아래 오도록 짠다. */
-export function renderCollect(outcome, sessions) {
+export function renderCollect(outcome) {
     const lines = [];
     lines.push(`활성 세션: ${outcome.active.join(', ') || '없음'}`);
     if (outcome.occupancy.length > 0) {
@@ -103,13 +103,14 @@ export function renderCollect(outcome, sessions) {
     }
     if (outcome.collected.length > 0) {
         lines.push('', '거둔 세션:');
-        for (const id of outcome.collected) {
-            const session = sessions.find((s) => s.id === id);
-            lines.push(`  ${id} — ${session?.handoff?.next ?? '(다음 작업 없음)'}`);
-            for (const done of session?.handoff?.done ?? [])
+        for (const session of outcome.handoffs) {
+            lines.push(`  ${session.id} — ${session.handoff?.next ?? '(다음 작업 없음)'}`);
+            for (const done of session.handoff?.done ?? [])
                 lines.push(`    완료: ${done}`);
-            if (session?.handoff?.verified)
+            if (session.handoff?.verified)
                 lines.push(`    검증: ${session.handoff.verified}`);
+            for (const changed of session.handoff?.changed ?? [])
+                lines.push(`    바꾼 것: ${changed}`);
         }
     }
     if (outcome.awaiting.length > 0) {

package/dist/core/runtime/workspaces.d.ts

@@ -34,6 +34,7 @@ export declare function viewWorkspaces(workspaces: readonly WorkspaceInput[], ex
 export declare function dueWorkspaces(views: readonly WorkspaceView[]): {
     workspaceId: string;
     cwd: string;
+    root: string;
 }[];
 /** 사람이 읽는 기계 전체 화면. `cd` 없이 지금 무엇이 도는지 보여야 한다 (설계 §13.2). */
 export declare function renderWorkspaces(views: readonly WorkspaceView[]): string[];

package/dist/core/runtime/workspaces.js

@@ -44,7 +44,7 @@ export function dueWorkspaces(views) {
         .filter((view) => view.health === 'ACTIVE')
         // 여러 checkout 이 있으면 아무 곳에서나 한 번이면 된다 — 관측 대상은 workspace 이지
         // checkout 이 아니다. 첫 번째를 쓰는 것은 안정적인 선택이다(목록 순서가 index 순서다).
-        .map((view) => ({ workspaceId: view.workspaceId, cwd: view.liveLocators[0] }));
+        .map((view) => ({ workspaceId: view.workspaceId, cwd: view.liveLocators[0], root: view.root }));
 }
 /** 사람이 읽는 기계 전체 화면. `cd` 없이 지금 무엇이 도는지 보여야 한다 (설계 §13.2). */
 export function renderWorkspaces(views) {

package/dist/ports/scm.d.ts

@@ -30,6 +30,14 @@ export type ExternalActionResult = {
 };
 export interface ScmPort {
     readonly id: string;
+    /**
+     * 이 통로가 그 행위를 수행할 수 있는가.
+     *
+     * 발급 시점에 묻기 위한 것이다. 예전에는 아무 action 으로나 Grant 가 발급됐고, 사람이
+     * 승인한 **뒤에** 실행에서 "unsupported" 가 나왔다 — 승인의 의미가 그 자리에서 무너진다.
+     * 두지 않아도 되며, 그때는 호출자가 확인하지 못했다는 사실을 그대로 다룬다.
+     */
+    supports?(action: string): boolean;
     getThread(reference: string): Promise<ThreadSnapshot>;
     getBaselines(queries: readonly BaselineQuery[]): Promise<CanonicalSnapshot[]>;
     /**

package/dist/ports/state-store.d.ts

@@ -1,4 +1,4 @@
-import type { ApprovalRequest, ControlState, ExecutionGrant, MonitorEvent, QueueItem, Session } from '../core/model/entities.ts';
+import type { ApprovalRequest, ControlState, ExecutionGrant, MonitorEvent, Session } from '../core/model/entities.ts';
 /**
  * 저장 가능한 entity 종류. 모든 entity는 `version`을 갖고, 그 값이 CAS 토큰이다 —
  * 별도 etag를 두지 않는다 (C-01 §8).
@@ -7,7 +7,6 @@ export type EntityMap = {
     session: Session;
     request: ApprovalRequest;
     grant: ExecutionGrant;
-    queueItem: QueueItem;
     event: MonitorEvent;
 };
 export type EntityKind = keyof EntityMap;

package/dist/ports/state-store.js

@@ -7,6 +7,5 @@ export const ENTITY_KEY = {
     session: 'id',
     request: 'id',
     grant: 'id',
-    queueItem: 'id',
     event: 'eventKey',
 };

package/package.json

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