@empire-builder-kit/nx 1.0.0-beta.9 → 1.0.0-rc.2

package/src/cli/agent-command.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAgentCommand = parseAgentCommand;
+const errors_js_1 = require("../local-dev/errors.js");
+const PROJECT_PATTERN = /^[A-Za-z0-9@][A-Za-z0-9@/._-]{0,255}$/;
+const SLUG_PATTERN = /^[a-z0-9][a-z0-9-]{0,127}$/;
+const TARGET_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
+const SAFE_REF = /^[A-Za-z0-9][A-Za-z0-9._/@+-]{0,255}$/;
+// The portable retained-path vocabulary deliberately excludes colons on every
+// host so POSIX input cannot later be interpreted as a Windows drive or ADS.
+const SAFE_PATH = /^(?![\\/])(?!.*(?:^|[\\/])\.\.(?:[\\/]|$))[A-Za-z0-9._@+ /\\-]{1,1024}$/;
+const UPGRADE_PREVIEW_OUTPUT = /^\.ebk\/agent\/previews\/[a-z][a-z0-9-]{0,62}\.json$/;
+function hasUnsafeControlCharacter(value) {
+    return [...value].some((character) => {
+        const codePoint = character.codePointAt(0) ?? 0;
+        return codePoint <= 0x1f || (codePoint >= 0x7f && codePoint <= 0x9f);
+    });
+}
+function usageError(message) {
+    throw new errors_js_1.LocalDevContractError('invalid-input', message);
+}
+function parseTokens(arguments_) {
+    const options = {};
+    const positionals = [];
+    for (let index = 0; index < arguments_.length; index += 1) {
+        const token = arguments_[index];
+        if (!token.startsWith('--')) {
+            if (token.startsWith('-')) {
+                return usageError(`Short option ${token} is not supported.`);
+            }
+            positionals.push(token);
+            continue;
+        }
+        if (token === '--') {
+            return usageError('The raw argument separator is not supported.');
+        }
+        const separator = token.indexOf('=');
+        const name = token.slice(2, separator === -1 ? undefined : separator);
+        if (![
+            'base',
+            'candidate-provenance',
+            'canonical-stage',
+            'feature',
+            'head',
+            'json',
+            'projects',
+            'slice',
+            'targets',
+        ].includes(name)) {
+            return usageError(`Unknown ebk agent option --${name}.`);
+        }
+        if (name in options) {
+            return usageError(`Option --${name} was repeated.`);
+        }
+        if (name === 'json') {
+            if (separator !== -1)
+                return usageError('--json does not accept a value.');
+            options[name] = true;
+            continue;
+        }
+        const value = separator === -1 ? arguments_[index + 1] : token.slice(separator + 1);
+        if (separator === -1)
+            index += 1;
+        if (value === undefined ||
+            value.startsWith('--') ||
+            value.length === 0 ||
+            hasUnsafeControlCharacter(value)) {
+            return usageError(`--${name} requires a safe non-empty value.`);
+        }
+        options[name] = value;
+    }
+    return { options, positionals };
+}
+function option(tokens, name) {
+    const value = tokens.options[name];
+    return typeof value === 'string' ? value : undefined;
+}
+function listOption(tokens, name, pattern, maximum) {
+    const value = option(tokens, name);
+    if (value === undefined)
+        return undefined;
+    const values = value.split(',');
+    if (values.length === 0 ||
+        values.length > maximum ||
+        values.some((entry) => !pattern.test(entry)) ||
+        new Set(values).size !== values.length) {
+        return usageError(`--${name} must contain at most ${maximum} unique comma-separated names.`);
+    }
+    return values;
+}
+function contextQuery(tokens) {
+    const projects = listOption(tokens, 'projects', PROJECT_PATTERN, 128);
+    const targets = listOption(tokens, 'targets', TARGET_PATTERN, 64);
+    const slice = option(tokens, 'slice');
+    const feature = option(tokens, 'feature');
+    const base = option(tokens, 'base');
+    const head = option(tokens, 'head');
+    const candidateProvenancePath = option(tokens, 'candidate-provenance');
+    const canonicalStage = option(tokens, 'canonical-stage');
+    if (slice !== undefined && !SLUG_PATTERN.test(slice)) {
+        return usageError('--slice is invalid.');
+    }
+    if (feature !== undefined && !SLUG_PATTERN.test(feature)) {
+        return usageError('--feature is invalid.');
+    }
+    if (feature !== undefined && slice === undefined) {
+        return usageError('--feature requires --slice.');
+    }
+    if (projects && slice && !projects.includes(slice)) {
+        return usageError('--projects must include the selected --slice.');
+    }
+    if ((base === undefined) !== (head === undefined)) {
+        return usageError('--base and --head must be supplied together.');
+    }
+    if ((base !== undefined && !SAFE_REF.test(base)) ||
+        (head !== undefined && !SAFE_REF.test(head))) {
+        return usageError('--base and --head must be bounded literal Git refs.');
+    }
+    if (targets && base === undefined) {
+        return usageError('--targets requires --base and --head.');
+    }
+    if (candidateProvenancePath !== undefined &&
+        !SAFE_PATH.test(candidateProvenancePath)) {
+        return usageError('--candidate-provenance must be a safe workspace-relative path.');
+    }
+    if (canonicalStage !== undefined &&
+        !['development', 'staging', 'production'].includes(canonicalStage)) {
+        return usageError('--canonical-stage must be development, staging, or production.');
+    }
+    return {
+        ...(targets ? { affectedTargets: targets } : {}),
+        ...(base ? { base } : {}),
+        ...(candidateProvenancePath ? { candidateProvenancePath } : {}),
+        ...(canonicalStage
+            ? {
+                canonicalStage: canonicalStage,
+            }
+            : {}),
+        ...(head ? { head } : {}),
+        ...(feature ? { selectedFeature: feature } : {}),
+        ...(projects ? { selectedProjects: projects } : {}),
+        ...(slice ? { selectedSlice: slice } : {}),
+    };
+}
+function requirePath(path, label) {
+    if (path === undefined || !SAFE_PATH.test(path)) {
+        return usageError(`${label} must be one safe workspace-relative JSON path.`);
+    }
+    return path;
+}
+function parseAgentCommand(arguments_) {
+    const command = arguments_[0];
+    if (command !== 'context' &&
+        command !== 'plan' &&
+        command !== 'upgrade-preview' &&
+        command !== 'handoff' &&
+        command !== 'resume') {
+        return usageError(`Unknown ebk agent command ${String(command)}.`);
+    }
+    const tokens = parseTokens(arguments_.slice(1));
+    const json = tokens.options.json === true;
+    if (command === 'context') {
+        if (tokens.positionals.length > 0) {
+            return usageError('ebk agent context uses bounded --projects rather than positional selectors.');
+        }
+        return { command, json, kind: 'agent', query: contextQuery(tokens) };
+    }
+    const positionalCount = command === 'upgrade-preview' ? 2 : 1;
+    if (tokens.positionals.length !== positionalCount) {
+        return usageError(`ebk agent ${command} requires ${positionalCount === 1 ? 'one JSON file path' : 'one request path and one canonical preview output path'}.`);
+    }
+    const path = requirePath(tokens.positionals[0], command === 'plan' || command === 'upgrade-preview'
+        ? 'Plan request'
+        : 'Handoff');
+    if (command === 'handoff' || command === 'resume') {
+        const unsupported = Object.keys(tokens.options).filter((name) => name !== 'json');
+        if (unsupported.length > 0) {
+            return usageError(`ebk agent ${command} derives context from the retained handoff and accepts only a file path plus optional --json.`);
+        }
+        return { command, handoffPath: path, json, kind: 'agent' };
+    }
+    if (command === 'upgrade-preview') {
+        const outputPath = tokens.positionals[1];
+        if (!UPGRADE_PREVIEW_OUTPUT.test(outputPath)) {
+            return usageError('Upgrade preview output must equal .ebk/agent/previews/<safe-slug>.json.');
+        }
+        return {
+            command,
+            json,
+            kind: 'agent',
+            outputPath,
+            query: contextQuery(tokens),
+            requestPath: path,
+        };
+    }
+    return {
+        command,
+        json,
+        kind: 'agent',
+        query: contextQuery(tokens),
+        requestPath: path,
+    };
+}
+//# sourceMappingURL=agent-command.js.map

package/src/cli/agent-command.js.map

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

package/src/cli/agent-runtime.d.ts

@@ -0,0 +1,25 @@
+import { inspectDeveloperAgentContext } from '../developer-agent/context.js';
+import { inspectDeveloperAgentHandoffResume, type DeveloperAgentResumeAssessment } from '../developer-agent/handoff.js';
+import { createDeveloperAgentUpgradePreview, persistDeveloperAgentUpgradePreview } from '../developer-agent/generator-preview.js';
+import { type DeveloperAgentContext, type DeveloperAgentFailureClassification, type DeveloperAgentGeneratorPreviewReceipt, type DeveloperAgentHandoff, type DeveloperAgentPlan } from '../developer-agent/model.js';
+import type { AgentCliCommand } from './agent-command.js';
+import { type CliResultEnvelope } from './output.js';
+export interface DeveloperAgentCliDependencies {
+    createUpgradePreview: typeof createDeveloperAgentUpgradePreview;
+    inspectContext: typeof inspectDeveloperAgentContext;
+    inspectResume: typeof inspectDeveloperAgentHandoffResume;
+    persistUpgradePreview: typeof persistDeveloperAgentUpgradePreview;
+}
+export interface DeveloperAgentCommandExecution {
+    human: string;
+    result: CliResultEnvelope<DeveloperAgentContext | DeveloperAgentHandoff | DeveloperAgentGeneratorPreviewReceipt | DeveloperAgentPlan | DeveloperAgentResumeAssessment>;
+}
+export declare class DeveloperAgentCliError extends Error {
+    readonly classification: DeveloperAgentFailureClassification;
+    constructor(classification: DeveloperAgentFailureClassification, message: string);
+}
+export declare function executeDeveloperAgentCommand(command: AgentCliCommand, workspaceRoot: string, overrides?: Partial<DeveloperAgentCliDependencies>): Promise<DeveloperAgentCommandExecution>;
+export declare function classifyDeveloperAgentCliError(error: unknown): {
+    classification: DeveloperAgentFailureClassification;
+    message: string;
+};