@aopslabs/aops 0.3.20 → 0.3.22

package/dist/commands/pm/index.js

@@ -256,7 +256,7 @@ function addUtaskCommands(cmd) {
         .requiredOption('--sprint <id>', 'Sprint id')
         .requiredOption('--id <id>', 'Utask id')
         .option('--title <title>', 'Updated utask title')
-        .option('--status <value>', 'Updated utask status')
+        .option('--status <value>', 'Updated utask status (canonical: completed; aliases: done, complete)')
         .option('--notes <text>', 'Updated utask notes')
         .option('--position <index>', 'Optional position override', (value) => Number.parseInt(String(value), 10)), { destructive: false })).action(async (options) => {
         await runPmUtaskUpdate(options);
@@ -266,7 +266,7 @@ function addUtaskCommands(cmd) {
         .description('Update only the lifecycle status of a sprint-bound utask')
         .requiredOption('--sprint <id>', 'Sprint id')
         .requiredOption('--id <id>', 'Utask id')
-        .requiredOption('--status <value>', 'Updated utask status'), { destructive: false }).action(async (options) => {
+        .requiredOption('--status <value>', 'Updated utask status (canonical: completed; aliases: done, complete)'), { destructive: false }).action(async (options) => {
         await runPmUtaskSetStatus(options);
     }));
     applyPmContextOptions(applyWriteOptions(utask
@@ -344,7 +344,7 @@ function addSprintCommands(cmd) {
         .command('set-status')
         .description('Set all microtask statuses in a sprint to the target status, deriving the sprint-level status')
         .requiredOption('--id <id>', 'Sprint id')
-        .requiredOption('--status <value>', 'Target status: todo, doing, completed, done, cancelled, paused, blocked, postponed, in_review'), { destructive: false }).action(async (options) => {
+        .requiredOption('--status <value>', 'Target status (canonical: completed; aliases: done, complete; plus todo, doing, cancelled, paused, blocked, postponed, in_review)'), { destructive: false }).action(async (options) => {
         await runPmSprintSetStatus(options);
     }));
     applyPmContextOptions(applyWriteOptions(sprint

package/dist/commands/pm/projectman.js

@@ -112,6 +112,10 @@ const PM_STATUS_AUDIT_CLASS_DEFINITIONS = [
         class: 'archived_nonterminal',
         description: 'Archived board/sprint visibility hides non-terminal work from active surfaces; advisory only, never auto-reconciled.',
     },
+    {
+        class: 'review_scope_dangling',
+        description: 'Accepted review evidence references a sprint phase or microtask that no longer resolves in the current sprint plan.',
+    },
     {
         class: 'review_approved_pm_nonterminal',
         description: 'Optional future cross-check: approved review evidence exists while PM entities remain non-terminal.',
@@ -394,10 +398,11 @@ function unwrapResultData(result) {
 }
 function normalizeMicrotaskStatusInput(value) {
     const normalized = normalizeNonEmpty(value)?.toLowerCase() ?? 'todo';
-    if (!MICROTASK_STATUSES.has(normalized)) {
-        throw new Error(`Invalid --status "${value}". Expected one of: todo, doing, blocked, paused, in_review, completed, cancelled, postponed.`);
+    const canonical = normalized === 'done' || normalized === 'complete' ? 'completed' : normalized;
+    if (!MICROTASK_STATUSES.has(canonical)) {
+        throw new Error(`Invalid --status "${value}". Expected one of: todo, doing, blocked, paused, in_review, completed, cancelled, postponed. Completion aliases: done, complete.`);
     }
-    return normalized;
+    return canonical;
 }
 function normalizeKanbanTaskStatusColumnInput(value) {
     const normalized = normalizeNonEmpty(value)?.toLowerCase();
@@ -1428,19 +1433,21 @@ function incrementAuditClassCount(byClass, className) {
     byClass[className] = (byClass[className] ?? 0) + 1;
 }
 function pushAuditFinding(findings, finding) {
+    const reviewRequestId = normalizeNonEmpty(finding.evidence?.reviewRequestId);
     const taskId = normalizeNonEmpty(finding.task?.id);
     const sprintIds = uniqueStringValues([
         finding.sprint?.id,
         ...(finding.sprints ?? []).map((sprint) => sprint.id),
     ]).join(',');
-    const key = `${finding.class}:${taskId ?? ''}:${sprintIds}:${finding.message}`;
+    const key = `${finding.class}:${reviewRequestId ?? ''}:${taskId ?? ''}:${sprintIds}:${finding.message}`;
     const existing = findings.some((entry) => {
+        const entryReviewRequestId = normalizeNonEmpty(entry.evidence?.reviewRequestId);
         const entryTaskId = normalizeNonEmpty(entry.task?.id);
         const entrySprintIds = uniqueStringValues([
             entry.sprint?.id,
             ...(entry.sprints ?? []).map((sprint) => sprint.id),
         ]).join(',');
-        return `${entry.class}:${entryTaskId ?? ''}:${entrySprintIds}:${entry.message}` === key;
+        return `${entry.class}:${entryReviewRequestId ?? ''}:${entryTaskId ?? ''}:${entrySprintIds}:${entry.message}` === key;
     });
     if (!existing)
         findings.push(finding);
@@ -1477,7 +1484,7 @@ function pushArchivedNonterminalFinding(findings, params) {
         }),
     });
 }
-function summarizePmStatusAudit(tasks, sprints, columnIndex, filters, nowMs = Date.now()) {
+function summarizePmStatusAudit(tasks, sprints, reviewRequests, columnIndex, filters, nowMs = Date.now()) {
     const taskSummaries = tasks
         .map((task) => summarizePmStatusTask(task, columnIndex))
         .filter((task) => Boolean(task));
@@ -1716,6 +1723,66 @@ function summarizePmStatusAudit(tasks, sprints, columnIndex, filters, nowMs = Da
             });
         }
     }
+    const phaseIds = new Set();
+    const microtaskIds = new Set();
+    for (const sprint of sprints) {
+        for (const phase of toRecordArray(sprint.phases)) {
+            const phaseId = normalizeNonEmpty(phase.id);
+            if (phaseId)
+                phaseIds.add(phaseId);
+            for (const microtask of toRecordArray(phase.microtasks)) {
+                const microtaskId = normalizeNonEmpty(microtask.id);
+                if (microtaskId)
+                    microtaskIds.add(microtaskId);
+            }
+        }
+    }
+    const acceptedReviews = reviewRequests.filter((review) => normalizeAuditToken(review.status) === 'accepted');
+    const scopedAcceptedReviews = acceptedReviews.filter((review) => {
+        const reviewTaskId = normalizeNonEmpty(review.kanbanTaskId);
+        const reviewSprintId = normalizeNonEmpty(review.sprintId);
+        if (filters.board || filters.task) {
+            const matchesSelectedTask = Boolean(reviewTaskId && selectedTaskIds.has(reviewTaskId));
+            const matchesSelectedSprint = Boolean(reviewSprintId && selectedSprintIds.has(reviewSprintId));
+            if (!matchesSelectedTask && !matchesSelectedSprint)
+                return false;
+        }
+        if (filters.sprint && (!reviewSprintId || !selectedSprintIds.has(reviewSprintId)))
+            return false;
+        return true;
+    });
+    let danglingReviewCount = 0;
+    for (const review of scopedAcceptedReviews) {
+        const missingReferences = [];
+        const reviewScope = normalizeNonEmpty(review.reviewScope);
+        const phaseMatch = reviewScope?.match(/^sprint-phase:([0-9a-f-]{36})(?:\/.*)?$/i);
+        const scopedPhaseId = phaseMatch?.[1];
+        if (scopedPhaseId && !phaseIds.has(scopedPhaseId)) {
+            missingReferences.push({ kind: 'phase', id: scopedPhaseId });
+        }
+        const linkedMicrotaskId = normalizeNonEmpty(review.microTaskItemId);
+        if (linkedMicrotaskId && !microtaskIds.has(linkedMicrotaskId)) {
+            missingReferences.push({ kind: 'microtask', id: linkedMicrotaskId });
+        }
+        if (missingReferences.length === 0)
+            continue;
+        danglingReviewCount += 1;
+        pushAuditFinding(findings, {
+            class: 'review_scope_dangling',
+            severity: 'warning',
+            message: 'Accepted review evidence references a phase or microtask that no longer resolves.',
+            suggestion: 'Backfill a deterministic current work-unit reference, or record an explicit irrecoverable historical-scope disposition without inventing identity.',
+            evidence: compactPayload({
+                reviewRequestId: normalizeNonEmpty(review.id),
+                title: normalizeNonEmpty(review.title),
+                status: normalizeNonEmpty(review.status),
+                reviewScope,
+                sprintId: normalizeNonEmpty(review.sprintId),
+                microTaskItemId: linkedMicrotaskId,
+                missingReferences,
+            }),
+        });
+    }
     const byClass = Object.fromEntries(PM_STATUS_AUDIT_CLASS_DEFINITIONS.map((definition) => [definition.class, 0]));
     for (const finding of findings)
         incrementAuditClassCount(byClass, finding.class);
@@ -1727,6 +1794,7 @@ function summarizePmStatusAudit(tasks, sprints, columnIndex, filters, nowMs = Da
             hasFindings: findings.length > 0,
             tasksAudited: selectedTaskIds.size,
             sprintsAudited: selectedSprintIds.size,
+            reviewsAudited: scopedAcceptedReviews.length,
             byClass,
         },
         filters: compactPayload({
@@ -1736,9 +1804,11 @@ function summarizePmStatusAudit(tasks, sprints, columnIndex, filters, nowMs = Da
         }),
         taxonomy: PM_STATUS_AUDIT_CLASS_DEFINITIONS.map((definition) => ({ ...definition })),
         reviewAudit: {
-            enabled: false,
-            class: 'review_approved_pm_nonterminal',
-            reason: 'Slice 1 audits PM task/sprint entities only; review-result correlation is reserved for a later explicit read path.',
+            enabled: true,
+            class: 'review_scope_dangling',
+            reviewsAudited: scopedAcceptedReviews.length,
+            danglingReviewCount,
+            acceptedOnly: true,
         },
         findings,
     };
@@ -1905,10 +1975,17 @@ function buildOwnerScopedInput(resolvedContext, extra = {}) {
 }
 function buildGatewayOptions(options, resolvedContext) {
     return {
-        ...options,
+        apiBaseUrl: options.apiBaseUrl,
+        accessToken: options.accessToken,
+        refreshToken: options.refreshToken,
+        timeoutMs: options.timeoutMs,
+        tenantId: options.tenantId,
+        locale: options.locale,
+        fallbackLocale: options.fallbackLocale,
         scopeId: resolvedContext.scopeId,
         projectId: resolvedContext.projectId,
         projectName: resolvedContext.projectName,
+        scopeResolution: options.scopeResolution,
         ...preferProjectNameBinding(resolvedContext),
     };
 }
@@ -1925,6 +2002,10 @@ async function hydrateHostedProjectContext(apiState, options, resolvedContext) {
         ...buildGatewayOptions(options, resolvedContext),
         toolId: 'agentspace.project.get-by-id',
         input: { id: projectId },
+        preview: false,
+        apply: false,
+        confirm: false,
+        idempotencyKey: undefined,
     });
     const project = unwrapResultData(unwrapHostedToolResult(payload));
     if (!isRecord(project)) {
@@ -1993,6 +2074,7 @@ async function invokeProjectmanReadTool(execution, options, params) {
         preview: false,
         apply: false,
         confirm: false,
+        idempotencyKey: undefined,
         timeoutMs: options.timeoutMs,
     });
 }
@@ -2226,21 +2308,45 @@ async function resolveBoardColumnReference(execution, options, params) {
     if (!trimmed) {
         throw new Error('Column is required.');
     }
-    if (isUuidLike(trimmed)) {
-        return { input: trimmed, id: trimmed };
-    }
     if (!params.boardId) {
+        if (isUuidLike(trimmed)) {
+            return { input: trimmed, id: trimmed };
+        }
         throw new Error('Board is required when resolving a column by exact name.');
     }
     const boardColumnsPayload = await invokeProjectmanReadTool(execution, options, {
         toolId: 'projectman.kanban-board-column.list',
         input: { board: params.boardId },
     });
+    const boardColumns = toRecordArray(unwrapHostedToolResult(boardColumnsPayload));
+    if (isUuidLike(trimmed)) {
+        const placementMatches = boardColumns.filter((placement) => extractEntityId(placement, ['id', 'boardColumnId']) === trimmed);
+        if (placementMatches.length === 1) {
+            return { input: trimmed, id: trimmed };
+        }
+        if (placementMatches.length > 1) {
+            throw new Error(`Column placement id "${trimmed}" is ambiguous on the selected board.`);
+        }
+        const libraryColumnMatches = boardColumns.filter((placement) => extractEntityId(placement, ['columnId', 'column']) === trimmed);
+        if (libraryColumnMatches.length === 1) {
+            const placementId = extractEntityId(libraryColumnMatches[0], ['id', 'boardColumnId']);
+            if (!placementId) {
+                throw new Error(`Library column "${trimmed}" matched a board placement without an id.`);
+            }
+            return { input: trimmed, id: placementId, assumedId: false };
+        }
+        if (libraryColumnMatches.length > 1) {
+            const candidates = libraryColumnMatches
+                .map((placement) => extractEntityId(placement, ['id', 'boardColumnId']) ?? 'missing-id')
+                .join(', ');
+            throw new Error(`Library column "${trimmed}" is ambiguous on the selected board. Placements: ${candidates}.`);
+        }
+        return { input: trimmed, id: trimmed, assumedId: true };
+    }
     const columnLibraryPayload = await invokeProjectmanReadTool(execution, options, {
         toolId: 'projectman.kanban-column.list',
         input: trimmed.includes(' ') ? { name: trimmed } : { slug: trimmed },
     });
-    const boardColumns = toRecordArray(unwrapHostedToolResult(boardColumnsPayload));
     const enrichedBoardColumns = await Promise.all(boardColumns.map(async (placement) => {
         const columnId = extractEntityId(placement, ['columnId', 'column']);
         if (!columnId) {
@@ -2317,10 +2423,7 @@ async function resolveBoardColumnReference(execution, options, params) {
             .join(', ');
         throw new Error(`Column "${trimmed}" is ambiguous on the selected board. Placements: ${candidates}.`);
     }
-    if (trimmed.includes(' ')) {
-        throw new Error(`Column "${trimmed}" was not found on the selected board.`);
-    }
-    return { input: trimmed, id: trimmed, assumedId: true };
+    throw new Error(`Column "${trimmed}" was not found on the selected board.`);
 }
 async function getProjectmanRecord(execution, options, toolId, id) {
     try {
@@ -3863,6 +3966,7 @@ export async function runPmStatusAudit(options = {}) {
             return;
         const taskInput = buildOwnerScopedInput(execution.resolvedContext);
         const sprintInput = buildOwnerScopedInput(execution.resolvedContext);
+        const reviewInput = buildOwnerScopedInput(execution.resolvedContext);
         const boardValue = normalizeNonEmpty(options.board);
         const taskSelector = normalizeNonEmpty(options.task);
         const sprintSelector = normalizeNonEmpty(options.sprint);
@@ -3870,7 +3974,7 @@ export async function runPmStatusAudit(options = {}) {
         if (boardValue) {
             boardRef = await resolveBoardReference(execution, options, boardValue);
         }
-        const [taskPayload, sprintPayload, boards] = await Promise.all([
+        const [taskPayload, sprintPayload, reviewPayload, boards] = await Promise.all([
             invokeProjectmanReadTool(execution, options, {
                 toolId: 'projectman.kanban-task.list',
                 input: taskInput,
@@ -3879,6 +3983,10 @@ export async function runPmStatusAudit(options = {}) {
                 toolId: 'projectman.sprint.list',
                 input: sprintInput,
             }),
+            invokeProjectmanReadTool(execution, options, {
+                toolId: 'projectman.review-request.list',
+                input: reviewInput,
+            }),
             listProjectmanBoards(execution, options, { includeArchived: true }),
         ]);
         const columnSourceBoardIds = boardRef
@@ -3911,8 +4019,9 @@ export async function runPmStatusAudit(options = {}) {
         }
         const tasks = toRecordArray(unwrapHostedToolResult(taskPayload));
         const sprints = toRecordArray(unwrapHostedToolResult(sprintPayload));
+        const reviewRequests = toRecordArray(unwrapHostedToolResult(reviewPayload));
         const columnIndex = buildPmStatusAuditColumnIndex(boards, boardColumnRows, columnEntities);
-        const audit = summarizePmStatusAudit(tasks, sprints, columnIndex, {
+        const audit = summarizePmStatusAudit(tasks, sprints, reviewRequests, columnIndex, {
             board: boardValue,
             boardId: boardRef?.id,
             task: taskSelector,
@@ -3933,6 +4042,7 @@ export async function runPmStatusAudit(options = {}) {
             input: compactPayload({
                 taskInput,
                 sprintInput,
+                reviewInput,
                 filters: compactPayload({
                     board: boardValue,
                     task: taskSelector,
@@ -4213,11 +4323,7 @@ export async function runPmSprintSetStatus(options = {}) {
         const targetStatus = normalizeNonEmpty(options.status)?.toLowerCase();
         if (!targetStatus)
             throw new Error('Missing required --status.');
-        const validStatuses = new Set(['todo', 'doing', 'blocked', 'paused', 'in_review', 'completed', 'cancelled', 'postponed', 'done']);
-        const resolvedStatus = targetStatus === 'done' || targetStatus === 'complete' ? 'completed' : targetStatus;
-        if (!validStatuses.has(targetStatus)) {
-            throw new Error(`Invalid --status "${targetStatus}". Expected one of: ${[...validStatuses].join(', ')}.`);
-        }
+        const resolvedStatus = normalizeMicrotaskStatusInput(targetStatus);
         const execution = await prepareExecution(options, { requireProject: false });
         if (!execution)
             return;

package/dist/lib/agent-assets/native-fs.js

@@ -543,9 +543,9 @@ function defaultNativeRoot() {
     return moduleDirectory.endsWith(`${path.sep}dist`) ? bundled : compiledOrSource;
 }
 function injectedNativeManifestSha256() {
-    return typeof "1ffbe15b7e7471f9cb11b2b122b5e39117a6bc9e2765c4d84c219b8f30a3f2f1" === 'undefined'
+    return typeof "a107fa53b7534ad3b8d967f76261b0791269256e1698d11b8a6266fa1d1d6e30" === 'undefined'
         ? undefined
-        : "1ffbe15b7e7471f9cb11b2b122b5e39117a6bc9e2765c4d84c219b8f30a3f2f1";
+        : "a107fa53b7534ad3b8d967f76261b0791269256e1698d11b8a6266fa1d1d6e30";
 }
 function sha256(bytes) {
     return createHash('sha256').update(bytes).digest('hex');

package/dist/lib/cli-error-format.js

@@ -1,6 +1,38 @@
 function messageOf(error) {
     return error instanceof Error ? error.message : String(error);
 }
+const MEMBER_AUTH_REASONS = new Set([
+    'member_token_required',
+    'member_token_invalid_format',
+    'member_token_unknown',
+    'member_token_mismatch',
+    'membership_inactive',
+    'membership_channel_mismatch',
+]);
+function record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function buildCliJsonError(error) {
+    const candidate = record(error) ? error : null;
+    const details = record(candidate?.details) ? candidate.details : null;
+    const memberAuthReason = details?.memberAuthReason;
+    const errorCode = typeof candidate?.errorCode === 'string'
+        ? candidate.errorCode
+        : typeof candidate?.code === 'string'
+            ? candidate.code
+            : undefined;
+    return {
+        schemaVersion: 1,
+        ok: false,
+        error: {
+            message: messageOf(error),
+            ...(errorCode ? { errorCode } : {}),
+            ...(typeof memberAuthReason === 'string' && MEMBER_AUTH_REASONS.has(memberAuthReason)
+                ? { details: { memberAuthReason } }
+                : {}),
+        },
+    };
+}
 export function formatCliError(error, depth = 0) {
     const message = messageOf(error);
     if (!(error instanceof AggregateError) || error.errors.length === 0 || depth >= 3)

package/dist/lib/community-diagnostic.js

@@ -36,7 +36,7 @@ function categoryFor(code) {
         return 'migration';
     if (/config|policy|env|tls/.test(code))
         return 'configuration';
-    if (/runtime|server|process|health|source_drift|build(?:_identity)?_drift/.test(code))
+    if (/runtime|server|process|health|native_child|source_drift|build(?:_identity)?_drift/.test(code))
         return 'runtime';
     return 'unknown';
 }
@@ -57,7 +57,7 @@ function inferredPhase(code, fallback) {
         return 'verify';
     if (/migration|apply/.test(code))
         return 'apply';
-    if (/start|health|process/.test(code))
+    if (/start|health|process|native_child.*(?:exited|ready)/.test(code))
         return 'start-server';
     return fallback;
 }
@@ -123,6 +123,13 @@ function safeDetails(details, error) {
     if (SAFE_SQLSTATE.test(sqlState))
         output.sqlState = sqlState;
     const message = error instanceof Error ? error.message : String(error ?? '');
+    const nativeChildExit = /^community_native_child_exited_before_ready:([^:\s]+):([^:\s]+)/u.exec(message);
+    if (nativeChildExit) {
+        output.nativeChildExitCode = /^\d+$/u.test(nativeChildExit[1])
+            ? Number(nativeChildExit[1])
+            : redacted(nativeChildExit[1]);
+        output.nativeChildSignal = redacted(nativeChildExit[2]);
+    }
     const semanticPrefix = 'community_strict_semantic_schema_mismatch:';
     if (message.startsWith(semanticPrefix)) {
         try {

package/dist/main.js

@@ -37,11 +37,12 @@ import { makeCommunityCockpitCommand } from './commands/community-cockpit.js';
 import { makeCommunityDoctorCommand } from './commands/community-doctor.js';
 import { makeTargetCommand } from './commands/target.js';
 import { makeVersionCommand } from './commands/version.js';
+import { makeCodexCommand } from './commands/codex.js';
 import { makeGlobalUpdateCommand } from './commands/global-update.js';
 import { launchBundledTui, shouldLaunchBundledTui } from './lib/tui-launcher.js';
 import { CommunityDiagnosticError, formatCommunityDiagnostic, } from './lib/community-diagnostic.js';
 import { resolveCliApiBaseUrl } from './utils/api.js';
-import { formatCliError } from './lib/cli-error-format.js';
+import { buildCliJsonError, formatCliError } from './lib/cli-error-format.js';
 const KERNEL_COMMANDS_REPLACED_BY_AOPS = new Set(['agent', 'api', 'auth', 'client', 'host']);
 function removeReplacedKernelCommands(program) {
     const mutable = program;
@@ -154,6 +155,7 @@ export function buildCommunityProgram() {
     program.addCommand(makeCommunityDoctorCommand());
     program.addCommand(makeTargetCommand());
     program.addCommand(makeVersionCommand());
+    program.addCommand(makeCodexCommand());
     program.addCommand(makeGlobalUpdateCommand());
     program.addHelpText('after', `
 AOPS Community is a single-user, self-hosted/local-trusted distribution.
@@ -205,7 +207,12 @@ async function main() {
             }
         }
         else {
-            logError(formatCliError(error));
+            if (jsonOutputRequested) {
+                process.stderr.write(`${JSON.stringify(buildCliJsonError(error))}\n`);
+            }
+            else {
+                logError(formatCliError(error));
+            }
         }
         process.exitCode = 1;
     }

package/native/manifest.json

@@ -42,7 +42,7 @@
       "capabilityClass": "windows-ntfs-crash-recoverable-v1",
       "qualification": {
         "relativePath": "qualifications/win32-x64.json",
-        "sha256": "3ba56b89ad82cba1d2005dc0dda0724cd08395cd40af00a3ed4709c5e63b8938"
+        "sha256": "e6c9581ab34629b19a376c5cf3fb675e36ee34403ef64ec4f43c715533c45249"
       }
     }
   ]

package/native/qualifications/win32-x64.json

@@ -7,7 +7,7 @@
   "filesystem": "NTFS",
   "primitiveProfile": "windows-createfile-flush-movefileex-v1",
   "capabilityClass": "windows-ntfs-crash-recoverable-v1",
-  "evidenceSha256": "138d0d5bdd55ac851084a02e829e0b2f4d66ac03cee92ea28da4dcce2f802eab",
+  "evidenceSha256": "4d353324b943a237459b60429128c1bd19ae5e15e86c833a1cd9a20180eca9e3",
   "crashInjectionPoints": [
     "authority-history",
     "authority-current",

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@aopslabs/aops",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "type": "module",
   "description": "AOPS CLI and terminal setup application.",
-  "aopsDockerServerVersion": "0.2.15",
+  "aopsDockerServerVersion": "0.2.16",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
     "type": "git",
@@ -34,6 +34,7 @@
     "test:chatv3-keyring-parameter-log-effects": "node --test test/chatv3-keyring-parameter-log-effects.test.mjs",
     "test:chatv3-session-store": "node --test test/chatv3-session-store.test.mjs",
     "test:projectman-review-evidence": "node --test test/projectman-review-evidence.test.mjs",
+    "test:projectman-pm-contract": "node --test test/projectman-pm-contract.test.mjs",
     "test:commercial-lifecycle-scale-effects": "node --test test/commercial-lifecycle-scale-effects.test.mjs",
     "test:commercial-lifecycle-managed-effects": "node --test test/commercial-lifecycle-managed-effects.test.mjs",
     "test:commercial-lifecycle-negative-effects": "node --test test/commercial-lifecycle-negative-effects.test.mjs",
@@ -55,12 +56,13 @@
     "test:hosted-contract-hardening": "node --test test/hosted-contract-hardening.test.mjs",
     "test:home": "node --test test/home-menu.test.mjs",
     "test:launchers": "node --test test/terminal-launchers.test.mjs",
-    "test:shortcuts": "pnpm --dir ../.. run build && pnpm run test:home && pnpm run test:cockpit && pnpm run test:launchers && pnpm run test:assets-menu && pnpm run test:agent-assets-content && pnpm run test:chatv3-session-store && pnpm run test:projectman-review-evidence && pnpm run test:setup-install && pnpm run test:container-runtime && pnpm run test:native-lifecycle && pnpm run test:operation-journal && pnpm run test:commercial-canonical-order && pnpm run test:commercial-runtime-closure && pnpm run test:commercial-artifact && pnpm run test:commercial-final-readiness && pnpm run test:commercial-admission && pnpm run test:commercial-license && pnpm run test:commercial-runbook && pnpm run test:package-identity && pnpm run test:tui-launcher && pnpm run test:global-update && pnpm run test:skill-discovery && pnpm run test:target-transport && pnpm run test:target-auth && pnpm run test:r6-auth-cutover && pnpm run test:r6-cutover-baseline && pnpm run test:hosted-contract-hardening",
+    "test:shortcuts": "pnpm --dir ../.. run build && pnpm run test:home && pnpm run test:cockpit && pnpm run test:launchers && pnpm run test:assets-menu && pnpm run test:agent-assets-content && pnpm run test:chatv3-session-store && pnpm run test:projectman-review-evidence && pnpm run test:projectman-pm-contract && pnpm run test:setup-install && pnpm run test:container-runtime && pnpm run test:native-lifecycle && pnpm run test:operation-journal && pnpm run test:commercial-canonical-order && pnpm run test:commercial-runtime-closure && pnpm run test:commercial-artifact && pnpm run test:commercial-final-readiness && pnpm run test:commercial-admission && pnpm run test:commercial-license && pnpm run test:commercial-runbook && pnpm run test:package-identity && pnpm run test:tui-launcher && pnpm run test:global-update && pnpm run test:skill-discovery && pnpm run test:target-transport && pnpm run test:target-auth && pnpm run test:r6-auth-cutover && pnpm run test:r6-cutover-baseline && pnpm run test:hosted-contract-hardening",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "start": "node dist/main.js"
   },
   "dependencies": {
-    "@aopslabs/aops-server": "0.2.15",
+    "@aopslabs/aops-agent-runtime": "0.1.0",
+    "@aopslabs/aops-server": "0.2.16",
     "@aopslabs/artifact-trust-contracts": "0.3.1",
     "@aopslabs/cli-kit": "0.1.0",
     "@aopslabs/aops-host-registration": "0.2.1",
@@ -71,7 +73,7 @@
     "@sigstore/tuf": "4.0.2",
     "@sigstore/verify": "3.1.1",
     "@aopslabs/api-client": "0.2.1",
-    "@aopslabs/domain-product-client-chatv3": "0.4.0",
+    "@aopslabs/domain-product-client-chatv3": "0.4.1",
     "@aopslabs/xf-cli-ui": "0.2.0",
     "commander": "14.0.3",
     "pg": "8.20.0",