@software-dlc/cli 0.157.2

package/dist/local/task-context-inspection.js

@@ -0,0 +1,165 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { execFile } from 'node:child_process';
+import { realpath } from 'node:fs/promises';
+import { promisify } from 'node:util';
+import { z } from 'zod';
+import { readLocalTaskContext } from './task-context-provider.js';
+import { context_id_schema, TASK_CONTEXT_LIMITS } from './task-context-schema.js';
+import { checkOperation, currentOperation, OperationError, runOperation } from './operation.js';
+export const task_context_inspection_options_schema = z
+    .object({
+    task_id: context_id_schema,
+    execution_id: context_id_schema.optional(),
+    registry_id: context_id_schema.optional(),
+    request_id: context_id_schema.optional(),
+    timeout_ms: z.number().int().min(1000).max(30_000).optional(),
+    response_bytes: z
+        .number()
+        .int()
+        .min(256)
+        .max(TASK_CONTEXT_LIMITS.response_bytes)
+        .optional()
+})
+    .strict();
+class DiscoveryError extends Error {
+    reason;
+    constructor(reason) {
+        super(reason);
+        this.reason = reason;
+    }
+}
+const exec_file = promisify(execFile);
+async function git(context, args, absent_ok = false) {
+    checkOperation();
+    const signal = currentOperation()?.signal;
+    const command = exec_file('git', ['--no-optional-locks', '-c', 'core.fsmonitor=false', ...args], {
+        cwd: context.cwd,
+        encoding: 'buffer',
+        maxBuffer: 16 * 1024,
+        signal,
+        env: {
+            PATH: context.env.PATH,
+            HOME: context.env.HOME,
+            NODE_ENV: 'production',
+            LC_ALL: 'C',
+            GIT_OPTIONAL_LOCKS: '0',
+            GIT_CONFIG_NOSYSTEM: '1',
+            GIT_CONFIG_GLOBAL: '/dev/null'
+        }
+    });
+    // Promise rejection from AbortSignal is not proof that the process has closed.
+    const abort = () => command.child.kill('SIGKILL');
+    const closed = new Promise((resolve) => command.child.once('close', () => {
+        signal?.removeEventListener('abort', abort);
+        resolve();
+    }));
+    signal?.addEventListener('abort', abort, { once: true });
+    if (signal?.aborted)
+        abort();
+    const [result] = await Promise.allSettled([command, closed]);
+    checkOperation();
+    if (result.status === 'fulfilled') {
+        // Git emits one LF delimiter. Whitespace can be part of a filesystem path.
+        // Decode strictly so invalid UTF-8 cannot alias a replacement-character path.
+        const output = new TextDecoder('utf-8', { fatal: true }).decode(result.value.stdout);
+        if (!output.endsWith('\n'))
+            throw new DiscoveryError('source_unavailable');
+        return output.slice(0, -1);
+    }
+    const error = result.reason;
+    if (error && typeof error === 'object') {
+        if (absent_ok && 'code' in error && error.code === 1)
+            return null;
+        if ('stderr' in error &&
+            Buffer.isBuffer(error.stderr) &&
+            error.stderr.toString('utf8').includes('not a git repository'))
+            throw new DiscoveryError('not_repository');
+    }
+    throw new DiscoveryError('source_unavailable');
+}
+async function source(context) {
+    const root = await git(context, ['rev-parse', '--show-toplevel']);
+    const common = await git(context, [
+        'rev-parse',
+        '--path-format=absolute',
+        '--git-common-dir'
+    ]);
+    const ref = await git(context, ['symbolic-ref', '--quiet', 'HEAD'], true);
+    if (!ref?.startsWith('refs/heads/'))
+        throw new DiscoveryError('detached_ref');
+    const head = await git(context, ['rev-parse', '--verify', '--quiet', 'HEAD'], true);
+    if (!head || !/^[a-f0-9]{40,64}$/.test(head))
+        throw new DiscoveryError('unborn_ref');
+    if (!root || !common)
+        throw new DiscoveryError('source_unavailable');
+    const result = {
+        root: await realpath(root),
+        common: await realpath(common),
+        ref,
+        head
+    };
+    checkOperation();
+    return result;
+}
+/** Operator-owned cwd/env only; untrusted arguments cannot select filesystem paths. */
+export async function inspectTaskContext(input) {
+    const failure = (reason) => ({
+        schema_version: 1,
+        status: 'error',
+        reason
+    });
+    const parsed = task_context_inspection_options_schema.safeParse(input.arguments);
+    if (!parsed.success)
+        return failure('invalid_request');
+    const options = parsed.data;
+    try {
+        return await runOperation({
+            operation: 'context',
+            timeout_ms: options.timeout_ms,
+            signal: input.signal,
+            on_cleanup_timeout: input.on_cleanup_timeout,
+            run: async () => {
+                const before = await source(input);
+                const registry_id = 'local-registry:' +
+                    createHash('sha256').update(before.common).digest('hex');
+                const request = {
+                    schema_version: 1,
+                    request_id: options.request_id ?? randomUUID(),
+                    work_selector: {
+                        namespace: 'local_task',
+                        registry_id: options.registry_id ?? registry_id,
+                        task_id: options.task_id
+                    },
+                    ...(options.execution_id
+                        ? {
+                            execution_selector: {
+                                namespace: 'local_task',
+                                execution_id: options.execution_id
+                            }
+                        }
+                        : {}),
+                    budget: {
+                        response_bytes: options.response_bytes ?? TASK_CONTEXT_LIMITS.response_bytes
+                    }
+                };
+                const report = await readLocalTaskContext({
+                    request_json: JSON.stringify(request),
+                    trusted_registry: { registry_id, git_common_dir: before.common }
+                });
+                checkOperation();
+                if (JSON.stringify(await source(input)) !== JSON.stringify(before))
+                    return failure('changed_during_read');
+                return report;
+            }
+        });
+    }
+    catch (error) {
+        return failure(error instanceof DiscoveryError
+            ? error.reason
+            : error instanceof OperationError &&
+                (error.code === 'cancelled' || error.code === 'deadline_exceeded')
+                ? error.code
+                : 'source_unavailable');
+    }
+}
+//# sourceMappingURL=task-context-inspection.js.map

package/dist/local/task-context-inspection.js.map

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