Convenience

Thin wrappers over the built-in commands and workflows. Each takes a target path and forwards to runCommand()/runWorkflow() with the corresponding definition name.

5 methods

client.validate()

Run the built-in `validate` command against a target. Equivalent to runCommand('validate', { target, options }).

Requires authentication

Parameters

targetrequiredstring

Absolute path to the project directory to validate.

optionsoptionalRecord<string, unknown>

Optional overrides passed to the command executor.

Return Fields

decisionrequiredstring

Aggregated decision.

scoreoptionalnumber | null

Aggregated score (0-100); null for scoreless runs.

recommendationsrequiredRecommendation[]

All recommendations.

validate(target: string, options?: Record<string, unknown>): Promise<CommandResult>

typescript

import { UluOpsClient } from '@uluops/core';

const client = new UluOpsClient({
  apiKey: process.env.ULUOPS_API_KEY,
});

const result = await client.validate('./src');
console.log(`${result.decision} · ${result.score}`);

Response Type

// CommandResult
{
  decision: string;
  score?: number | null;
  recommendations: Recommendation[];
}

client.security()

Run the built-in `security` command against a target. Equivalent to runCommand('security', { target, options }).

Requires authentication

Parameters

targetrequiredstring

Absolute path to the project directory to scan.

optionsoptionalRecord<string, unknown>

Optional overrides passed to the command executor.

Return Fields

decisionrequiredstring

Aggregated security decision.

recommendationsrequiredRecommendation[]

Security findings as recommendations.

security(target: string, options?: Record<string, unknown>): Promise<CommandResult>

typescript

import { UluOpsClient } from '@uluops/core';

const client = new UluOpsClient({
  apiKey: process.env.ULUOPS_API_KEY,
});

const result = await client.security('./src');
console.log(`${result.decision} · ${result.recommendations.length} findings`);

Response Type

// CommandResult
{
  decision: string;
  recommendations: Recommendation[];
}

client.optimize()

Run the built-in `optimize` command against a target. Equivalent to runCommand('optimize', { target, options }).

Requires authentication

Parameters

targetrequiredstring

Absolute path to the project directory to analyze.

optionsoptionalRecord<string, unknown>

Optional overrides passed to the command executor.

Return Fields

decisionrequiredstring

Aggregated decision.

recommendationsrequiredRecommendation[]

Optimization recommendations.

optimize(target: string, options?: Record<string, unknown>): Promise<CommandResult>

typescript

import { UluOpsClient } from '@uluops/core';

const client = new UluOpsClient({
  apiKey: process.env.ULUOPS_API_KEY,
});

const result = await client.optimize('./src');
console.log(`${result.recommendations.length} optimizations`);

Response Type

// CommandResult
{
  decision: string;
  recommendations: Recommendation[];
}

client.ship()

Run the built-in `ship` workflow against a target — the final ship gate. Equivalent to runWorkflow('ship', { target, options }).

Requires authentication

Parameters

targetrequiredstring

Absolute path to the project directory to validate for shipping.

optionsoptionalRecord<string, unknown>

Optional overrides passed to the workflow executor.

Return Fields

decisionrequiredstring

Aggregate ship decision.

phasesrequiredPhaseResult[]

Per-phase outcomes.

metricsrequiredWorkflowMetrics

Phase pass/warn/block counts and cost totals.

ship(target: string, options?: Record<string, unknown>): Promise<WorkflowResult>

typescript

import { UluOpsClient } from '@uluops/core';

const client = new UluOpsClient({
  apiKey: process.env.ULUOPS_API_KEY,
});

const result = await client.ship('./src');
console.log(`${result.decision} · ${result.metrics.phasesPassed}/${result.metrics.phasesExecuted} phases`);

Response Type

// WorkflowResult
{
  decision: string;
  phases: PhaseResult[];
  metrics: WorkflowMetrics;
}

client.postImplementation()

Run the built-in `post-implementation` workflow against a target — iterative validation after an implementation phase. Equivalent to runWorkflow('post-implementation', { target, options }).

Requires authentication

Parameters

targetrequiredstring

Absolute path to the project directory to validate.

optionsoptionalRecord<string, unknown>

Optional overrides passed to the workflow executor.

Return Fields

decisionrequiredstring

Aggregate decision.

phasesrequiredPhaseResult[]

Iterative validation outcomes.

postImplementation(target: string, options?: Record<string, unknown>): Promise<WorkflowResult>

typescript

import { UluOpsClient } from '@uluops/core';

const client = new UluOpsClient({
  apiKey: process.env.ULUOPS_API_KEY,
});

const result = await client.postImplementation('./src');
console.log(result.decision);

Response Type

// WorkflowResult
{
  decision: string;
  phases: PhaseResult[];
}