tracegrove 0.0.0-stage → 0.3.0

package/dist/cli/doctor.js

@@ -0,0 +1,118 @@
+/** Native metadata inspection. Compilation writes derived files; this never launches the app. */
+import { accessSync, constants, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { chromium } from 'playwright';
+import { compileProject, findConfig } from "../authoring/compile.js";
+import { loadProject, localScope } from "../core/corpus.js";
+import { Blocked } from "../core/errors.js";
+import { plan } from "../core/planner.js";
+import { CaseSpec, HostPlan } from "../protocol/index.js";
+import { sourceIdentityDigest } from "../hosts/local.js";
+import { observeApplicationRuntime } from "../hosts/runtime.js";
+import { readGitSnapshotTree } from "../source/snapshotTree.js";
+import { sameScope } from "../protocol/canonical.js";
+export function doctorFailure(error, report) {
+    const result = report ?? emptyReport();
+    result.blocked = true;
+    result.exitCode = 2;
+    result.errors.push(...(error instanceof Blocked ? error.reasons : [{ code: 'doctor_inspection_failed',
+            detail: 'project metadata could not be inspected; no application was launched', owner: 'operator',
+            action: 'check the configuration, source paths and interpreter; run check for authoring diagnostics' }]));
+    return result;
+}
+function emptyReport() {
+    return { schemaVersion: 'tracegrove.doctor/v1', profile: null, blocked: true, exitCode: 2, checks: [], errors: [],
+        selection: null, source: null, runtime: null, execution: 'not_started', verificationVerdict: 'not_evaluated' };
+}
+export async function inspectDoctor(options) {
+    const report = emptyReport();
+    try {
+        if (options.config && options.dir)
+            throw new Blocked([{ code: 'conflicting_flags', detail: '--config and --dir cannot be combined' }]);
+        const configPath = options.config ? resolve(options.config) : findConfig(options.dir ?? '.');
+        const raw = parseYaml(readFileSync(configPath, 'utf8'), { strict: true });
+        // Explicitly recognize the two existing config formats; portable SDK examples are not executable configs.
+        const kind = raw && typeof raw === 'object' && 'schemaVersion' in raw
+            ? (raw.schemaVersion === 'workflow.config/v1' ? 'corpus' : null)
+            : raw && typeof raw === 'object' && 'app' in raw ? 'authoring' : null;
+        if (!kind)
+            throw new Blocked([{ code: 'unsupported_doctor_config', detail: 'expected tracegrove.config.yaml or workflow.config/v1',
+                    action: 'select an existing authoring or corpus config; portable SDK profiles are not executable CLI configs' }]);
+        // Authoring currently compiles exactly one native profile; reject selection mistakes before writing derived files.
+        if (kind === 'authoring' && options.profile && options.profile !== 'real')
+            throw new Blocked([{ code: 'unknown_profile',
+                    detail: options.profile, action: 'select real for the native authoring profile' }]);
+        const workflowConfigPath = kind === 'authoring' ? compileProject(configPath).workflowConfigPath : configPath;
+        const project = loadProject(workflowConfigPath);
+        const profileName = options.profile ?? project.config.defaultProfile;
+        report.profile = profileName;
+        const profile = project.config.profiles[profileName];
+        if (!profile)
+            throw new Blocked([{ code: 'unknown_profile', detail: profileName,
+                    action: `choose one of ${Object.keys(project.config.profiles).join(', ')}` }]);
+        const hostRef = project.fileRefs.get(profile.hostPlanRef ?? project.config.executionHostRef);
+        const host = project.corpus.getAs(HostPlan, hostRef);
+        report.selection = { inputKind: kind, configPath, workflowConfigPath, hostPlanRef: host.ref,
+            hostAdapter: host.adapter, placement: host.placement, requiredCapabilities: host.requiredCapabilities,
+            corpusRef: project.corpus.manifest.ref, compiledFilesWritten: kind === 'authoring' };
+        const check = (name, state, detail, code, action = 'none') => report.checks.push({ check: name, state, detail, code, action });
+        check('node', process.versions.node.startsWith('22.') ? 'ok' : 'warn', process.version, 'controller_runtime_observed');
+        if (host.adapter === 'local_process' && process.platform === 'win32')
+            check('host', 'blocked', 'local host requires POSIX process-group termination', 'local_process_tree_unsupported', 'select a qualified POSIX host');
+        if (host.launch) {
+            const cwd = resolve(project.root, host.launch.cwd);
+            if (host.launch.sourceSnapshot) {
+                const pin = host.launch.sourceSnapshot;
+                if (!sameScope(pin.snapshot.scope, localScope()))
+                    doctorFailure(new Blocked([{ code: 'snapshot_scope_mismatch', detail: 'snapshot belongs to another local owner' }]), report);
+                else
+                    try {
+                        const files = readGitSnapshotTree(pin.snapshot, resolve(project.root, pin.root));
+                        check('source_snapshot', 'ok', `${files.length} pinned file(s); no application launched`, 'source_snapshot_verified');
+                    }
+                    catch {
+                        check('source_snapshot', 'blocked', 'Pinned source tree no longer matches its manifest', 'source_snapshot_mismatch', 'materialize the snapshot again');
+                    }
+            }
+            try {
+                const identity = sourceIdentityDigest(cwd, host.launch.identitySourceFiles);
+                report.source = { digest: identity.hex, files: identity.entries.length };
+                check('identity_sources', 'ok', `${identity.entries.length} file(s), digest ${identity.hex}`, 'source_identity_observed');
+            }
+            catch (error) {
+                doctorFailure(error, report);
+            }
+            try {
+                const runtime = await observeApplicationRuntime(host.launch.command, cwd, process.env.PATH ?? '');
+                report.runtime = { runtime: runtime.runtime, version: runtime.version, executableSha256: runtime.executableSha256 };
+                check('application_runtime', 'ok', `${runtime.runtime} (${runtime.version}); executable digest ${runtime.executableSha256}`, 'application_runtime_observed');
+            }
+            catch (error) {
+                doctorFailure(error, report);
+            }
+        }
+        else
+            check('host', 'ok', `${host.adapter} selected; no application launch inspected`, 'host_adapter_selected');
+        const bundle = plan({ project, profileName, scope: localScope() });
+        report.errors.push(...bundle.blockers);
+        check('plan', bundle.blockers.length ? 'blocked' : 'ok', `${bundle.request?.caseRefs.length ?? 0} case(s), ${bundle.excludedCells.length} excluded`, bundle.blockers.length ? 'plan_blocked' : 'plan_compiled', bundle.blockers.length ? 'resolve the reported blockers' : 'none');
+        const browserRequired = (bundle.request?.caseRefs ?? []).some(ref => project.corpus.getAs(CaseSpec, ref).steps.some(step => step.kind.startsWith('ui.')));
+        if (browserRequired) {
+            try {
+                accessSync(chromium.executablePath(), constants.X_OK);
+                check('chromium_installation', 'ok', 'executable is installed; engine launch, system libraries and video capture are untested', 'browser_executable_installed');
+            }
+            catch {
+                check('chromium_installation', 'blocked', 'required Chromium executable is missing or inaccessible', 'browser_executable_missing', 'install the pinned Playwright Chromium and required system libraries in an authorized environment, then run doctor again');
+            }
+        }
+        report.blocked = report.errors.length > 0 || report.checks.some(c => c.state === 'blocked');
+        report.exitCode = report.blocked ? 2 : 0;
+        return report;
+    }
+    catch (error) {
+        return doctorFailure(error, report);
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"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"}

package/dist/cli/errors.d.ts

@@ -0,0 +1,2 @@
+import { CliErrorReport } from '../protocol/index.ts';
+export declare function cliErrorReport(error: unknown, command: string | undefined): CliErrorReport;

package/dist/cli/errors.js

@@ -0,0 +1,84 @@
+/** Controlled public diagnostics: never copy exception messages or candidate-supplied details. */
+import { Blocked, Conflict, InfrastructureFailure } from "../core/errors.js";
+import { CliErrorReport, SchemaViolation } from "../protocol/index.js";
+import { COMMAND_SCHEMAS } from "./arguments.js";
+const reason = (code, message, recovery) => ({ code, message, recovery });
+const options = 'Run tracegrove help and correct the command options.';
+const config = 'Create or select a valid project configuration; use tracegrove check for authoring diagnostics.';
+const cases = 'List the available flows and correct the selected flow names or tags.';
+const interpreter = 'Install the application interpreter in an authorized environment or configure its executable path.';
+const blockedReasons = {
+    unknown_command: reason('unknown_command', 'The command is not supported.', options),
+    unknown_flag: reason('unknown_flag', 'An option is not supported for this command.', options),
+    duplicate_flag: reason('duplicate_flag', 'An option was supplied more than once.', options),
+    unexpected_argument: reason('unexpected_argument', 'An unexpected positional argument was supplied.', options),
+    invalid_boolean: reason('invalid_boolean', 'A boolean option requires true or false.', options),
+    missing_argument: reason('missing_argument', 'A required option or option value is missing.', options),
+    conflicting_flags: reason('conflicting_flags', 'The selected options cannot be combined.', options),
+    invalid_argument: reason('invalid_argument', 'An option value is invalid.', options),
+    config_not_found: reason('config_not_found', 'The project configuration could not be found.', config),
+    invalid_authoring_file: reason('invalid_authoring_file', 'An authoring file is invalid.', config),
+    invalid_yaml: reason('invalid_yaml', 'A YAML input is invalid.', config),
+    no_flows: reason('no_flows', 'The project has no authoring flows.', cases),
+    no_flows_selected: reason('no_flows_selected', 'No authoring flows match the selection.', cases),
+    unknown_profile: reason('unknown_profile', 'The selected profile is not available.', config),
+    launch_executable_missing: reason('launch_executable_missing', 'The application interpreter is unavailable.', interpreter),
+    application_runtime_unrecognized: reason('application_runtime_unrecognized', 'The configured executable did not identify a supported interpreter.', interpreter),
+    command_adapter_unqualified: reason('command_adapter_unqualified', 'The command adapter is not qualified.', 'Select the supported Node, FastAPI or Django interpreter preset.'),
+    run_not_found: reason('run_not_found', 'The selected run is unavailable.', 'Select an existing run or execute an authorized test first.'),
+    execution_not_found: reason('execution_not_found', 'The selected execution is unavailable.', 'Select an existing execution and its matching state directory.'),
+    invalid_request_file: reason('invalid_request_file', 'The input is not a frozen request bundle.', 'Pass an unchanged request bundle written by tracegrove plan.'),
+    invalid_port: reason('invalid_port', 'The selected port is invalid.', 'Choose a valid port or omit the port option.'),
+};
+const prerequisite = reason('prerequisite_unavailable', 'A required prerequisite is unavailable.', 'Check the selected configuration, dependencies and authorization; resolve the prerequisite before retrying.');
+export function cliErrorReport(error, command) {
+    let errorClass;
+    let exitCode;
+    let reasons;
+    let omittedReasonCount = 0;
+    if (error instanceof Blocked) {
+        errorClass = 'blocked';
+        exitCode = 2;
+        reasons = error.reasons.slice(0, 32).map(item => Object.hasOwn(blockedReasons, item.code)
+            ? blockedReasons[item.code] : prerequisite);
+        if (!reasons.length)
+            reasons = [prerequisite];
+        omittedReasonCount = Math.max(0, error.reasons.length - 32);
+    }
+    else if (error instanceof Conflict) {
+        errorClass = 'conflict';
+        exitCode = 2;
+        reasons = [reason('state_conflict', 'The operation conflicts with existing state or ownership.', 'Inspect the owned state and reconcile the interrupted operation; do not break locks or replay uncertain effects.')];
+    }
+    else if (error instanceof SchemaViolation) {
+        errorClass = 'invalid_input';
+        exitCode = 2;
+        reasons = [reason('invalid_document', 'An input document does not match its schema.', 'Validate and regenerate the input with the matching Tracegrove version.')];
+    }
+    else if (error instanceof SyntaxError) {
+        errorClass = 'invalid_input';
+        exitCode = 3; // Preserve the existing top-level JSON parse error exit status.
+        reasons = [reason('invalid_json', 'A JSON input could not be parsed.', 'Restore or regenerate valid JSON input; do not replay an interrupted execution blindly.')];
+    }
+    else if (error instanceof InfrastructureFailure) {
+        errorClass = 'infrastructure_failure';
+        exitCode = 3;
+        reasons = [reason('infrastructure_failure', 'An infrastructure operation failed.', 'Inspect the owned environment and retained execution evidence; reconcile uncertain effects before retrying.')];
+    }
+    else {
+        const code = error !== null && typeof error === 'object' && 'code' in error ? error.code : null;
+        errorClass = 'infrastructure_failure';
+        exitCode = 3;
+        if (code === 'ENOENT' || code === 'ENOTDIR')
+            reasons = [reason('input_unavailable', 'A required local input or directory is unavailable.', 'Check that the selected configuration, input files and dependencies exist.')];
+        else if (code === 'EACCES' || code === 'EPERM')
+            reasons = [reason('access_denied', 'A local operation was denied.', 'Use an authorized readable input or writable output; request owner assistance if access is required.')];
+        else {
+            errorClass = 'unexpected_failure';
+            reasons = [reason('unexpected_failure', 'The command could not complete.', 'Inspect the owned environment and retained evidence. Report the command, error code and exit status without credentials.')];
+        }
+    }
+    return CliErrorReport.parse({ schemaVersion: 'tracegrove.cli-error/v1', command: command && Object.hasOwn(COMMAND_SCHEMAS, command) ? command : null,
+        errorClass, exitCode, reasons, omittedReasonCount });
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"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"}

package/dist/cli/jsonFile.d.ts

@@ -0,0 +1,2 @@
+/** Operator-owned configuration, bounded and parsed before any local write. */
+export declare function readConfigurationJson(path: string, maximumBytes: number): unknown;

package/dist/cli/jsonFile.js

@@ -0,0 +1,15 @@
+import { readFileSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Conflict } from "../core/errors.js";
+/** Operator-owned configuration, bounded and parsed before any local write. */
+export function readConfigurationJson(path, maximumBytes) {
+    const file = resolve(path);
+    const stat = statSync(file);
+    if (!stat.isFile() || stat.size > maximumBytes)
+        throw new Conflict(`Configuration must be a file of at most ${maximumBytes} bytes`);
+    const bytes = readFileSync(file);
+    if (bytes.length > maximumBytes)
+        throw new Conflict('Configuration grew beyond its byte limit');
+    return JSON.parse(bytes.toString('utf8'));
+}
+//# sourceMappingURL=jsonFile.js.map

package/dist/cli/jsonFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonFile.js","sourceRoot":"","sources":["../../src/cli/jsonFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,YAAoB;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,YAAY;QAAE,MAAM,IAAI,QAAQ,CAAC,2CAA2C,YAAY,QAAQ,CAAC,CAAC;IACpI,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,GAAG,YAAY;QAAE,MAAM,IAAI,QAAQ,CAAC,0CAA0C,CAAC,CAAC;IAChG,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/cli/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};