@aopslabs/aops 0.2.0

package/dist/utils/session-state.js

@@ -0,0 +1,137 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const DEFAULT_CHECKPOINT_DELAY_MINUTES = 30;
+const DEFAULT_SUMMARY_DELAY_MINUTES = 120;
+function stringValue(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function booleanValue(value) {
+    return value === true || value === 'true' || value === 'yes' || value === 'due';
+}
+function parseTimestamp(value) {
+    const raw = stringValue(value);
+    if (!raw)
+        return undefined;
+    const parsed = Date.parse(raw);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function isoTimestamp(value) {
+    const parsed = parseTimestamp(value);
+    return parsed === undefined ? undefined : new Date(parsed).toISOString();
+}
+function minutesSince(value, nowMs) {
+    if (value === undefined)
+        return undefined;
+    return Math.max(0, Math.floor((nowMs - value) / 60000));
+}
+function checkpointNudgeAction(record) {
+    const parts = [
+        'aops-cli checkpoint create',
+        '--summary "<checkpoint summary>"',
+    ];
+    const taskId = stringValue(record.taskId);
+    const sprintId = stringValue(record.sprintId);
+    if (taskId)
+        parts.push(`--task-id ${taskId}`);
+    if (sprintId)
+        parts.push(`--sprint-id ${sprintId}`);
+    parts.push('--apply --json');
+    return parts.join(' ');
+}
+function repoRelative(repoRoot, filePath) {
+    return path.relative(repoRoot, filePath).split(path.sep).join('/');
+}
+function sessionStateDirs(repoRoot, localRoot) {
+    const dirs = [path.join(repoRoot, '.aops', 'agentspace', 'session-state')];
+    if (localRoot) {
+        const localDir = path.join(repoRoot, localRoot, 'agentspace', 'session-state');
+        if (!dirs.includes(localDir))
+            dirs.push(localDir);
+    }
+    return dirs;
+}
+async function readJsonFiles(dir) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    const records = [];
+    for (const entry of entries.sort()) {
+        if (!entry.endsWith('.json'))
+            continue;
+        const filePath = path.join(dir, entry);
+        try {
+            const parsed = JSON.parse(await fs.readFile(filePath, 'utf8'));
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                records.push({ filePath, record: parsed });
+            }
+        }
+        catch {
+        }
+    }
+    return records;
+}
+function recordNudges(repoRoot, filePath, record, options) {
+    const nowMs = options.now.getTime();
+    const lastBriefAtMs = parseTimestamp(record.lastBriefAt);
+    const lastCheckpointAtMs = parseTimestamp(record.lastCheckpointAt);
+    const lastSummaryAtMs = parseTimestamp(record.lastSummaryAt);
+    const checkpointDueAtMs = parseTimestamp(record.checkpointDueAt);
+    const summaryDueAtMs = parseTimestamp(record.summaryDueAt);
+    const sourcePath = repoRelative(repoRoot, filePath);
+    const common = {
+        severity: 'warning',
+        sourcePath,
+        label: stringValue(record.label) ?? stringValue(record.title) ?? stringValue(record.id),
+        taskId: stringValue(record.taskId),
+        sprintId: stringValue(record.sprintId),
+        lastBriefAt: isoTimestamp(record.lastBriefAt),
+        lastCheckpointAt: isoTimestamp(record.lastCheckpointAt),
+        lastSummaryAt: isoTimestamp(record.lastSummaryAt),
+    };
+    const nudges = [];
+    const checkpointRequired = booleanValue(record.checkpointRequired) || booleanValue(record.needsCheckpoint);
+    const checkpointOverdue = checkpointDueAtMs !== undefined && checkpointDueAtMs <= nowMs;
+    const checkpointAfterBrief = lastBriefAtMs !== undefined
+        && (lastCheckpointAtMs === undefined || lastCheckpointAtMs < lastBriefAtMs)
+        && nowMs - lastBriefAtMs >= options.checkpointDelayMinutes * 60000;
+    if (checkpointRequired || checkpointOverdue || checkpointAfterBrief) {
+        const ageSource = checkpointDueAtMs ?? lastBriefAtMs;
+        nudges.push({
+            ...common,
+            kind: 'checkpoint-delayed',
+            message: 'checkpoint gecikti',
+            action: checkpointNudgeAction(record),
+            ageMinutes: minutesSince(ageSource, nowMs),
+        });
+    }
+    const summaryRequired = booleanValue(record.summaryRequired) || booleanValue(record.needsSummary);
+    const summaryOverdue = summaryDueAtMs !== undefined && summaryDueAtMs <= nowMs;
+    const summaryAfterCheckpoint = lastCheckpointAtMs !== undefined
+        && (lastSummaryAtMs === undefined || lastSummaryAtMs < lastCheckpointAtMs)
+        && nowMs - lastCheckpointAtMs >= options.summaryDelayMinutes * 60000;
+    if (summaryRequired || summaryOverdue || summaryAfterCheckpoint) {
+        const ageSource = summaryDueAtMs ?? lastCheckpointAtMs;
+        nudges.push({
+            ...common,
+            kind: 'summary-missing',
+            message: 'summary yazilmadi',
+            action: 'aops-cli mem summary --apply --json',
+            ageMinutes: minutesSince(ageSource, nowMs),
+        });
+    }
+    return nudges;
+}
+export async function readSessionStateNudges(options) {
+    const now = options.now ?? new Date();
+    const checkpointDelayMinutes = options.checkpointDelayMinutes ?? DEFAULT_CHECKPOINT_DELAY_MINUTES;
+    const summaryDelayMinutes = options.summaryDelayMinutes ?? DEFAULT_SUMMARY_DELAY_MINUTES;
+    const files = (await Promise.all(sessionStateDirs(options.repoRoot, options.localRoot).map((dir) => readJsonFiles(dir)))).flat();
+    return files.flatMap(({ filePath, record }) => recordNudges(options.repoRoot, filePath, record, { now, checkpointDelayMinutes, summaryDelayMinutes }));
+}

package/dist/utils/table.js

@@ -0,0 +1,39 @@
+import { normalizeNonEmpty } from './command.js';
+function truncateCell(value, maxWidth) {
+    if (!maxWidth || value.length <= maxWidth)
+        return value;
+    if (maxWidth <= 3)
+        return value.slice(0, maxWidth);
+    return `${value.slice(0, maxWidth - 3)}...`;
+}
+function padRight(value, width) {
+    return value.padEnd(width, ' ');
+}
+export function renderTable(params) {
+    if (params.rows.length === 0) {
+        return params.emptyText ?? '(no rows)';
+    }
+    const widths = params.columns.map((column, index) => {
+        const cellWidths = params.rows.map((row) => {
+            const raw = row[index];
+            const normalized = typeof raw === 'boolean'
+                ? (raw ? 'true' : 'false')
+                : normalizeNonEmpty(raw) ?? String(raw ?? '-');
+            return truncateCell(normalized, column.maxWidth).length;
+        });
+        return Math.max(column.header.length, ...cellWidths);
+    });
+    const header = params.columns
+        .map((column, index) => padRight(column.header, widths[index] ?? column.header.length))
+        .join(' | ');
+    const separator = widths.map((width) => ''.padEnd(width, '-')).join('-+-');
+    const body = params.rows.map((row) => row
+        .map((cell, index) => {
+        const normalized = typeof cell === 'boolean'
+            ? (cell ? 'true' : 'false')
+            : normalizeNonEmpty(cell) ?? String(cell ?? '-');
+        return padRight(truncateCell(normalized, params.columns[index]?.maxWidth), widths[index] ?? normalized.length);
+    })
+        .join(' | '));
+    return [header, separator, ...body].join('\n');
+}

package/dist/utils/transient-fs.js

@@ -0,0 +1,49 @@
+import fs from 'node:fs/promises';
+import { setTimeout as delay } from 'node:timers/promises';
+const DEFAULT_RETRY_OPTIONS = {
+    attempts: 8,
+    baseDelayMs: 50,
+    maxDelayMs: 1500,
+    jitterMs: 75,
+};
+const RETRYABLE_CODES = new Set(['EBUSY', 'EPERM', 'EACCES']);
+function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+function normalizeString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+export function isTransientFsError(error, platform = process.platform) {
+    if (!isRecord(error))
+        return false;
+    const code = normalizeString(error.code);
+    const syscall = normalizeString(error.syscall);
+    if (code && RETRYABLE_CODES.has(code))
+        return true;
+    return platform === 'win32' && code === 'UNKNOWN' && (!syscall || ['open', 'write', 'close'].includes(syscall));
+}
+function retryDelayMs(attemptIndex, options) {
+    const exponential = Math.min(options.maxDelayMs, options.baseDelayMs * 2 ** attemptIndex);
+    const jitter = options.jitterMs > 0 ? Math.floor(Math.random() * (options.jitterMs + 1)) : 0;
+    return exponential + jitter;
+}
+export async function withTransientFsRetry(operation, options = {}) {
+    const resolved = {
+        ...DEFAULT_RETRY_OPTIONS,
+        ...options,
+    };
+    const attempts = Math.max(1, Math.floor(resolved.attempts));
+    for (let attempt = 0;; attempt += 1) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (attempt >= attempts - 1 || !isTransientFsError(error, options.platform))
+                throw error;
+            await delay(retryDelayMs(attempt, resolved));
+        }
+    }
+}
+export async function writeFileWithRetry(filePath, data, options) {
+    await withTransientFsRetry(() => fs.writeFile(filePath, data, options));
+}

package/dist/utils/workspace-root.js

@@ -0,0 +1 @@
+export { findWorkspaceRoot } from './operator-runtime.js';

package/launchers/aops-cockpit.ps1

@@ -0,0 +1,15 @@
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$packageRoot = Split-Path -Parent $PSScriptRoot
+$entryPoint = Join-Path $packageRoot 'dist/launchers/cockpit.js'
+
+if (-not (Test-Path -LiteralPath $entryPoint -PathType Leaf)) {
+  throw "AOPS Cockpit launcher entrypoint is missing: $entryPoint"
+}
+$nodeCommand = Get-Command node -CommandType Application -ErrorAction Stop
+
+& $nodeCommand.Source $entryPoint @args
+if ($LASTEXITCODE -ne 0) {
+  throw "AOPS Cockpit launcher exited with code $LASTEXITCODE."
+}

package/launchers/aops-cockpit.sh

@@ -0,0 +1,16 @@
+#!/bin/sh
+set -eu
+
+launcher_dir=$(CDPATH= cd "$(dirname "$0")" && pwd -P)
+entry_point="$launcher_dir/../dist/launchers/cockpit.js"
+
+if [ ! -f "$entry_point" ]; then
+  printf '%s\n' "AOPS Cockpit launcher entrypoint is missing: $entry_point" >&2
+  exit 1
+fi
+if ! command -v node >/dev/null 2>&1; then
+  printf '%s\n' 'Node.js is required to run AOPS Cockpit.' >&2
+  exit 1
+fi
+
+exec node "$entry_point" "$@"

package/launchers/aops-server.ps1

@@ -0,0 +1,15 @@
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$packageRoot = Split-Path -Parent $PSScriptRoot
+$entryPoint = Join-Path $packageRoot 'dist/launchers/server.js'
+
+if (-not (Test-Path -LiteralPath $entryPoint -PathType Leaf)) {
+  throw "AOPS Server launcher entrypoint is missing: $entryPoint"
+}
+$nodeCommand = Get-Command node -CommandType Application -ErrorAction Stop
+
+& $nodeCommand.Source $entryPoint @args
+if ($LASTEXITCODE -ne 0) {
+  throw "AOPS Server launcher exited with code $LASTEXITCODE."
+}

package/launchers/aops-server.sh

@@ -0,0 +1,16 @@
+#!/bin/sh
+set -eu
+
+launcher_dir=$(CDPATH= cd "$(dirname "$0")" && pwd -P)
+entry_point="$launcher_dir/../dist/launchers/server.js"
+
+if [ ! -f "$entry_point" ]; then
+  printf '%s\n' "AOPS Server launcher entrypoint is missing: $entry_point" >&2
+  exit 1
+fi
+if ! command -v node >/dev/null 2>&1; then
+  printf '%s\n' 'Node.js is required to run AOPS Server.' >&2
+  exit 1
+fi
+
+exec node "$entry_point" "$@"

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@aopslabs/aops",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "AOPS CLI and terminal setup application.",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eeemzs/aops-platform.git",
+    "directory": "apps/aops-cli"
+  },
+  "bin": {
+    "aops": "dist/main.js",
+    "aops-cli": "dist/main.js"
+  },
+  "scripts": {
+    "build": "node --eval \"const { rmSync } = require('node:fs'); rmSync('dist', { recursive: true, force: true });\" && tsc -p tsconfig.json --incremental false",
+    "test:assets-menu": "node --test test/assets-menu.test.mjs",
+    "test:agent-assets-content": "node --test test/agent-assets-content.test.mjs",
+    "test:cockpit": "node --test test/cockpit.test.mjs",
+    "test:setup-install": "node --test test/setup-install.test.mjs",
+    "test:native-lifecycle": "node --test test/community-native-lifecycle.test.mjs",
+    "test:operation-journal": "node --test test/community-operation-journal.test.mjs",
+    "test:commercial-artifact": "node --test test/commercial-artifact.test.mjs",
+    "test:commercial-canonical-order": "node --test test/commercial-canonical-order.test.mjs",
+    "test:commercial-runtime-closure": "node --test test/commercial-runtime-closure.test.mjs",
+    "test:commercial-final-readiness": "node --test test/commercial-final-readiness.test.mjs",
+    "test:commercial-lifecycle-smoke-isolation": "node --test test/commercial-lifecycle-smoke-isolation.test.mjs",
+    "test:commercial-managed-postgres-docker-adapter": "node --test test/commercial-managed-postgres-docker-adapter.test.mjs",
+    "test:commercial-managed-postgres-docker-effects": "node --test test/commercial-managed-postgres-docker-effects.test.mjs",
+    "test:existing-postgres-statement-log-effects": "node --test test/existing-postgres-statement-log-effects.test.mjs",
+    "test:chatv3-keyring-parameter-log-effects": "node --test test/chatv3-keyring-parameter-log-effects.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",
+    "test:commercial-admission": "node --test test/commercial-admission.test.mjs",
+    "test:commercial-license": "node --test test/commercial-license.test.mjs",
+    "test:commercial-runbook": "node --test test/commercial-runbook.test.mjs",
+    "test:commercial-performance": "node --test test/commercial-performance.test.mjs",
+    "test:package-identity": "node --test test/package-identity.test.mjs",
+    "test:tui-launcher": "node --test test/tui-launcher.test.mjs",
+    "test:skill-discovery": "node --test test/skill-discovery.test.mjs",
+    "test:target-auth": "node --test test/target-auth.test.mjs test/device-login.test.mjs",
+    "test:target-transport": "node --test test/target-transport.test.mjs",
+    "test:r6-cutover-baseline": "node scripts/verify-r6-cutover-baseline.mjs",
+    "test:r6-auth-cutover": "node --test test/r6-auth-cutover.test.mjs",
+    "test:container-runtime": "node --test test/container-runtime.test.mjs",
+    "test:home": "node --test test/home-menu.test.mjs",
+    "test:console": "node --test test/community-console.test.mjs",
+    "test:launchers": "node --test test/terminal-launchers.test.mjs",
+    "test:shortcuts": "pnpm run test:home && pnpm run test:cockpit && pnpm run test:console && pnpm run test:launchers && pnpm run test:assets-menu && pnpm run test:agent-assets-content && 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:skill-discovery && pnpm run test:target-transport && pnpm run test:target-auth && pnpm run test:r6-auth-cutover && pnpm run test:r6-cutover-baseline",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/main.js"
+  },
+  "dependencies": {
+    "@aopslabs/artifact-trust-contracts": "0.2.0",
+    "@aopslabs/aops-host-registration": "0.2.0",
+    "@aopslabs/aops-pg-bootstrap": "0.2.0",
+    "@aopslabs/aops-runtime-config": "0.2.0",
+    "@sigstore/bundle": "4.0.0",
+    "@sigstore/protobuf-specs": "0.5.1",
+    "@sigstore/tuf": "4.0.2",
+    "@sigstore/verify": "3.1.1",
+    "@aopslabs/api-client": "0.2.0",
+    "@aopslabs/domain-product-client-chatv3": "0.2.0",
+    "@aopslabs/xf-cli-ui": "0.2.0",
+    "commander": "14.0.3",
+    "inquirer": "13.3.0",
+    "pg": "8.20.0",
+    "sigstore": "4.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "25.3.1",
+    "@types/pg": "8.20.0",
+    "typescript": "5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}