@bluelibs/runner-dev 4.1.1 → 4.2.0

package/AI.md

@@ -235,61 +235,38 @@ mutation EvalCode($code: String!, $inputJson: String, $evalInput: Boolean) {
 
 ## MCP Tools Available
 
-### GraphQL Operations
-
 - `graphql.query` - Execute read-only GraphQL queries
 - `graphql.mutation` - Execute GraphQL mutations (if ALLOW_MUTATIONS=true)
 - `graphql.introspect` - Get full schema introspection
-- `graphql.schemaSdl` - Get schema as SDL string
 - `graphql.ping` - Test connectivity
+- `project.overview` - Generate dynamic project overview aggregated from the API
 
-### Documentation
-
-- `help.read` - Read local docs (README.md, AI.md) or package docs
-- `help.runner` - Read @bluelibs/runner framework documentation
-- `help.runnerDev` - Read Runner-Dev application documentation (README + AI guide)
-- `project.overview` - Generate dynamic project overview
-
-**🎯 Pro Tip: Array-Based Heading Filtering**
-All documentation tools support powerful array-based heading filtering:
+## Direct CLI Usage
 
-```typescript
-// Single heading (traditional)
-headingIncludes: "installation";
+Beyond MCP, Runner-Dev offers a powerful standalone CLI for direct interaction from your terminal. This is ideal for scripting, quick checks, or when not operating within an MCP-enabled AI assistant.
 
-// Multiple headings (NEW!) - Get comprehensive context in one call
-headingIncludes: ["installation", "configuration", "troubleshooting"];
-headingIncludes: ["tasks", "resources", "events", "middleware"];
-headingIncludes: ["hot-swapping", "live telemetry", "debugging"];
-```
+### Prerequisites
 
-This enables gathering related information efficiently instead of making multiple sequential requests. The output shows exactly what sections were found and combines them with clear separators.
+- Your app must be running with the Dev server enabled (for remote mode).
+- The `@bluelibs/runner-dev` package should be installed.
 
-**Example Usage:**
+### Create a New Project
 
-```typescript
-// Get comprehensive Runner framework understanding
-help.runner({
-  headingIncludes: ["tasks", "resources", "events", "middleware"],
-});
+You can scaffold a new Runner project directly from the CLI.
 
-// Understand development workflow
-help.runner_dev({
-  headingIncludes: ["hot-swapping", "live telemetry", "debugging"],
-});
+```bash
+# Create a new Runner project
+npx @bluelibs/runner-dev new <project-name>
 
-// Compare installation methods
-help.read({ headingIncludes: ["installation", "setup", "configuration"] });
+# Example
+npx @bluelibs/runner-dev new my-awesome-app
 ```
+This command creates a new Runner project with a complete TypeScript setup, Jest for testing, and all necessary dependencies.
 
-## Direct CLI Usage
-
-Beyond MCP, Runner-Dev offers a powerful standalone CLI for direct interaction from your terminal. This is ideal for scripting, quick checks, or when not operating within an MCP-enabled AI assistant.
-
-### Prerequisites
-
-- Your app must be running with the Dev server enabled.
-- The `@bluelibs/runner-dev` package should be installed.
+Key flags for `new`:
+- `--install`: Install dependencies after scaffolding.
+- `--run-tests`: Run the generated test suite after installation.
+- `--run`: Start the dev server after installation.
 
 ### Common Commands
 
@@ -300,7 +277,7 @@ All commands can be prefixed with environment variables like `ENDPOINT` and `HEA
 ENDPOINT=http://localhost:1337/graphql npx @bluelibs/runner-dev ping
 ```
 
-**Execute a GraphQL query:**
+**Execute a GraphQL query (Remote Mode):**
 ```bash
 # Simple query
 ENDPOINT=http://localhost:1337/graphql npx @bluelibs/runner-dev query 'query { tasks { id } }'
@@ -313,12 +290,27 @@ ENDPOINT=http://localhost:1337/graphql \
   --format pretty
 ```
 
+**Execute a GraphQL query (Dry-Run Mode):**
+
+Run queries against a TypeScript entry file without needing a running server.
+
+```bash
+# Using a TS entry file default export
+npx @bluelibs/runner-dev query 'query { tasks { id } }' \
+  --entry-file ./src/main.ts
+
+# Using a named export (e.g., exported as `app`)
+npx @bluelibs/runner-dev query 'query { tasks { id } }' \
+  --entry-file ./src/main.ts --export app
+```
+
 **Generate a project overview:**
 ```bash
 ENDPOINT=http://localhost:1337/graphql npx @bluelibs/runner-dev overview --details 10
 ```
 
 **Fetch GraphQL schema:**
+
 ```bash
 # As SDL
 ENDPOINT=http://localhost:1337/graphql npx @bluelibs/runner-dev schema sdl
@@ -329,14 +321,19 @@ ENDPOINT=http://localhost:1337/graphql npx @bluelibs/runner-dev schema json
 
 ### Key Flags
 
-- `--endpoint <url>`: GraphQL endpoint URL.
+- `--endpoint <url>`: GraphQL endpoint URL for remote mode.
 - `--headers '<json>'`: JSON for extra headers.
 - `--variables '<json>'`: JSON variables for a query.
 - `--format data|json|pretty`: Output format.
 - `--namespace <str>`: A filter to inject `idIncludes` on top-level fields.
+- `--entry-file <path>`: TypeScript entry file for dry-run mode (no server).
+- `--export <name>`: Named export to use from the entry file (default export is preferred).
+- `--operation <name>`: Operation name for documents with multiple operations.
+- `--raw`: Print the full GraphQL envelope including errors.
 
 This direct CLI access provides a powerful way for AI assistants with shell access to script complex interactions, perform detailed introspection, and validate application state without relying on MCP tools.
 
+
 ## Common Use Cases
 
 ### 1. Understanding System Architecture

package/README.md

@@ -111,6 +111,7 @@ This package also ships a CLI that can query the same GraphQL API or generate an
 Prerequisites:
 
 - Ensure your app registers the Dev GraphQL server (`dev.with({ port: 1337 })`) or otherwise expose a compatible endpoint.
+- Alternatively, you can run queries in a new **dry‑run mode** with a TypeScript entry file (no server required).
 - Build this package (or install it) so the binary is available.
 
 Help:
@@ -119,6 +120,50 @@ Help:
 npx @bluelibs/runner-dev --help
 ```
 
+Create new project:
+
+```bash
+# Create a new Runner project
+npx @bluelibs/runner-dev new <project-name>
+
+# Example
+npx @bluelibs/runner-dev new my-awesome-app
+```
+
+This command creates a new Runner project with:
+
+- Complete TypeScript setup with ts-node-dev for development
+- Jest configuration for testing
+- Package.json with all necessary dependencies
+- Basic project structure with main.ts entry point
+- README and .gitignore files
+
+Flags for `new`:
+
+- `--install`: install dependencies after scaffolding
+- `--run-tests`: run the generated test suite (`npm test -- --runInBand`) after install
+- `--run`: start the dev server (`npm run dev`) after install/tests; this keeps the process running
+
+Examples:
+
+```bash
+# Create and auto-install dependencies, then run tests
+npx @bluelibs/runner-dev new my-awesome-app --install --run-tests
+
+# Create and start the dev server immediately (blocks)
+npx @bluelibs/runner-dev new my-awesome-app --install --run
+```
+
+Note: the `new` command requires the target directory to be empty. If the directory exists and is not empty, the command aborts with an error.
+
+The project name must contain only letters, numbers, dashes, and underscores.
+
+After creation, follow the next steps:
+
+- `cd <project-name>`
+- `npm install`
+- `npm run dev`
+
 Ping endpoint:
 
 ```bash
@@ -141,6 +186,24 @@ ENDPOINT=http://localhost:1337/graphql \
 ENDPOINT=http://localhost:1337/graphql npx @bluelibs/runner-dev query 'query { tasks { id } }' --namespace task.
 ```
 
+Dry‑run (no server):
+
+```bash
+# Using a TS entry file default export
+npx @bluelibs/runner-dev query 'query { tasks { id } }' \
+  --entry-file ./src/main.ts
+
+# Using a named export (e.g., exported as `app`)
+npx @bluelibs/runner-dev query 'query { tasks { id } }' \
+  --entry-file ./src/main.ts --export app
+
+# Notes
+# - Dry‑run compiles your entry, builds the Runner Store in-memory, and executes the query against
+#   an in-memory GraphQL schema. No HTTP server is started.
+# - TypeScript only. Requires ts-node at runtime. If missing, you'll be prompted to install it.
+# - Precedence: when --entry-file is provided, dry‑run mode is used; otherwise the CLI uses --endpoint/ENDPOINT.
+```
+
 Project overview (Markdown):
 
 ```bash
@@ -171,6 +234,13 @@ Flags:
 - `--format data|json|pretty`: output mode (default `data`)
 - `--raw`: print full GraphQL envelope including errors
 - `--namespace <str>`: convenience filter that injects `idIncludes` or `events(filter: { idIncludes })` at the top-level fields when possible
+- `--entry-file <path>`: TypeScript entry file for dry‑run mode (no server)
+- `--export <name>`: named export to use from the entry (default export preferred)
+
+Precedence:
+
+- If `--entry-file` is present, dry‑run mode is used.
+- Otherwise, remote mode via `--endpoint`/`ENDPOINT` is used.
 
 ### Local dev playbook
 

package/dist/architect/core/errors.d.ts

@@ -0,0 +1,39 @@
+export declare class ArchitectError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, any> | undefined;
+    constructor(message: string, code: string, context?: Record<string, any> | undefined);
+}
+export declare class AIModelError extends ArchitectError {
+    readonly modelId?: string | undefined;
+    constructor(message: string, modelId?: string | undefined, context?: Record<string, any>);
+}
+export declare class PlanningError extends ArchitectError {
+    readonly prompt?: string | undefined;
+    constructor(message: string, prompt?: string | undefined, context?: Record<string, any>);
+}
+export declare class ExecutionError extends ArchitectError {
+    readonly actionIndex?: number | undefined;
+    readonly actionType?: string | undefined;
+    constructor(message: string, actionIndex?: number | undefined, actionType?: string | undefined, context?: Record<string, any>);
+}
+export declare class ValidationError extends ArchitectError {
+    readonly field?: string | undefined;
+    readonly value?: any;
+    constructor(message: string, field?: string | undefined, value?: any, context?: Record<string, any>);
+}
+export declare class ConfigurationError extends ArchitectError {
+    readonly configKey?: string | undefined;
+    constructor(message: string, configKey?: string | undefined, context?: Record<string, any>);
+}
+export declare class PermissionError extends ArchitectError {
+    readonly operation?: string | undefined;
+    constructor(message: string, operation?: string | undefined, context?: Record<string, any>);
+}
+export declare class PluginError extends ArchitectError {
+    readonly pluginName?: string | undefined;
+    readonly pluginVersion?: string | undefined;
+    constructor(message: string, pluginName?: string | undefined, pluginVersion?: string | undefined, context?: Record<string, any>);
+}
+export declare function isArchitectError(error: unknown): error is ArchitectError;
+export declare function createErrorFromResponse(response: any): ArchitectError;
+export declare function formatErrorForUser(error: ArchitectError): string;

package/dist/architect/core/errors.js

@@ -0,0 +1,143 @@
+"use strict";
+// Custom error classes for the architect system
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginError = exports.PermissionError = exports.ConfigurationError = exports.ValidationError = exports.ExecutionError = exports.PlanningError = exports.AIModelError = exports.ArchitectError = void 0;
+exports.isArchitectError = isArchitectError;
+exports.createErrorFromResponse = createErrorFromResponse;
+exports.formatErrorForUser = formatErrorForUser;
+class ArchitectError extends Error {
+    code;
+    context;
+    constructor(message, code, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = "ArchitectError";
+        Object.setPrototypeOf(this, ArchitectError.prototype);
+    }
+}
+exports.ArchitectError = ArchitectError;
+class AIModelError extends ArchitectError {
+    modelId;
+    constructor(message, modelId, context) {
+        super(message, "AI_MODEL_ERROR", context);
+        this.modelId = modelId;
+        this.name = "AIModelError";
+    }
+}
+exports.AIModelError = AIModelError;
+class PlanningError extends ArchitectError {
+    prompt;
+    constructor(message, prompt, context) {
+        super(message, "PLANNING_ERROR", context);
+        this.prompt = prompt;
+        this.name = "PlanningError";
+    }
+}
+exports.PlanningError = PlanningError;
+class ExecutionError extends ArchitectError {
+    actionIndex;
+    actionType;
+    constructor(message, actionIndex, actionType, context) {
+        super(message, "EXECUTION_ERROR", context);
+        this.actionIndex = actionIndex;
+        this.actionType = actionType;
+        this.name = "ExecutionError";
+    }
+}
+exports.ExecutionError = ExecutionError;
+class ValidationError extends ArchitectError {
+    field;
+    value;
+    constructor(message, field, value, context) {
+        super(message, "VALIDATION_ERROR", context);
+        this.field = field;
+        this.value = value;
+        this.name = "ValidationError";
+    }
+}
+exports.ValidationError = ValidationError;
+class ConfigurationError extends ArchitectError {
+    configKey;
+    constructor(message, configKey, context) {
+        super(message, "CONFIGURATION_ERROR", context);
+        this.configKey = configKey;
+        this.name = "ConfigurationError";
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+class PermissionError extends ArchitectError {
+    operation;
+    constructor(message, operation, context) {
+        super(message, "PERMISSION_ERROR", context);
+        this.operation = operation;
+        this.name = "PermissionError";
+    }
+}
+exports.PermissionError = PermissionError;
+class PluginError extends ArchitectError {
+    pluginName;
+    pluginVersion;
+    constructor(message, pluginName, pluginVersion, context) {
+        super(message, "PLUGIN_ERROR", context);
+        this.pluginName = pluginName;
+        this.pluginVersion = pluginVersion;
+        this.name = "PluginError";
+    }
+}
+exports.PluginError = PluginError;
+// Error utilities
+function isArchitectError(error) {
+    return error instanceof ArchitectError;
+}
+function createErrorFromResponse(response) {
+    if (response.error) {
+        const { message, code, type } = response.error;
+        switch (type) {
+            case "invalid_request_error":
+                return new ValidationError(message, undefined, undefined, { code });
+            case "authentication_error":
+                return new ConfigurationError(message, "apiKey", { code });
+            case "permission_error":
+                return new PermissionError(message, undefined, { code });
+            case "rate_limit_error":
+                return new AIModelError(message, undefined, {
+                    code,
+                    rateLimited: true,
+                });
+            default:
+                return new ArchitectError(message, code || "UNKNOWN_ERROR", response.error);
+        }
+    }
+    return new ArchitectError("Unknown error occurred", "UNKNOWN_ERROR", {
+        response,
+    });
+}
+function formatErrorForUser(error) {
+    switch (error.name) {
+        case "AIModelError":
+            return `AI Model Error: ${error.message}${error.code ? ` (Model: ${error.name})` : ""}`;
+        case "PlanningError":
+            return `Planning Error: ${error.message}`;
+        case "ExecutionError":
+            const execError = error;
+            return `Execution Error: ${error.message}${execError.actionIndex !== undefined
+                ? ` (Action ${execError.actionIndex})`
+                : ""}`;
+        case "ValidationError":
+            const valError = error;
+            return `Validation Error: ${error.message}${valError.field ? ` (Field: ${valError.field})` : ""}`;
+        case "ConfigurationError":
+            const configError = error;
+            return `Configuration Error: ${error.message}${configError.configKey ? ` (Key: ${configError.configKey})` : ""}`;
+        case "PermissionError":
+            const permError = error;
+            return `Permission Error: ${error.message}${permError.operation ? ` (Operation: ${permError.operation})` : ""}`;
+        case "PluginError":
+            const pluginError = error;
+            return `Plugin Error: ${error.message}${pluginError.pluginName ? ` (Plugin: ${pluginError.pluginName})` : ""}`;
+        default:
+            return `Architect Error: ${error.message}`;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/architect/core/errors.js.map

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

package/dist/architect/core/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './interfaces';
+export * from './errors';

package/dist/architect/core/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Core exports for the architect system
+__exportStar(require("./types"), exports);
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/architect/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/architect/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAwC;AACxC,0CAAwB;AACxB,+CAA6B;AAC7B,2CAAyB"}

package/dist/architect/core/interfaces.d.ts

@@ -0,0 +1,158 @@
+import { AIModelConfig, ChatMessage, ChatCompletionRequest, ChatCompletionResponse, ArchitectPlan, ArchitectResult, ArchitectAction } from './types';
+export interface IAIModel {
+    readonly config: AIModelConfig;
+    /**
+     * Send a chat completion request
+     */
+    chat(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    /**
+     * Simple text completion with messages
+     */
+    complete(messages: ChatMessage[]): Promise<string>;
+    /**
+     * Check if the model supports a specific feature
+     */
+    supports(feature: 'tools' | 'vision' | 'json_mode'): boolean;
+    /**
+     * Get model information
+     */
+    getInfo(): Promise<{
+        id: string;
+        contextWindow: number;
+        maxOutputTokens: number;
+        supportedFeatures: string[];
+    }>;
+}
+export interface IArchitectPlanner {
+    /**
+     * Generate a plan from a user prompt
+     */
+    plan(prompt: string, context?: PlanningContext): Promise<ArchitectPlan>;
+    /**
+     * Validate a plan before execution
+     */
+    validate(plan: ArchitectPlan): Promise<ValidationResult>;
+    /**
+     * Optimize a plan for better execution
+     */
+    optimize(plan: ArchitectPlan): Promise<ArchitectPlan>;
+    /**
+     * Estimate the complexity and duration of a plan
+     */
+    estimate(plan: ArchitectPlan): Promise<PlanEstimate>;
+}
+export interface IArchitectExecutor {
+    /**
+     * Execute a validated plan
+     */
+    execute(plan: ArchitectPlan, options?: ExecutionOptions): Promise<ArchitectResult>;
+    /**
+     * Execute a single action
+     */
+    executeAction(action: ArchitectAction, context?: ExecutionContext): Promise<ActionResult>;
+    /**
+     * Check if execution is allowed for the current environment
+     */
+    canExecute(action: ArchitectAction): Promise<boolean>;
+    /**
+     * Rollback executed actions if possible
+     */
+    rollback(result: ArchitectResult): Promise<RollbackResult>;
+}
+export interface PlanningContext {
+    projectRoot: string;
+    existingFiles: string[];
+    packageJson?: any;
+    tsConfig?: any;
+    runnerConfig?: any;
+    constraints?: string[];
+    preferences?: Record<string, any>;
+}
+export interface ExecutionOptions {
+    dryRun?: boolean;
+    allowWrites?: boolean;
+    allowCommands?: boolean;
+    allowPackageInstalls?: boolean;
+    continueOnError?: boolean;
+    maxConcurrentActions?: number;
+    timeout?: number;
+}
+export interface ExecutionContext {
+    projectRoot: string;
+    currentDirectory: string;
+    environment: Record<string, string>;
+    logger: IArchitectLogger;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+    suggestions: string[];
+}
+export interface ValidationError {
+    actionIndex: number;
+    field: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+export interface ValidationWarning {
+    actionIndex: number;
+    message: string;
+    recommendation?: string;
+}
+export interface PlanEstimate {
+    complexity: 'low' | 'medium' | 'high';
+    estimatedDuration: number;
+    riskFactors: string[];
+    prerequisites: string[];
+}
+export interface ActionResult {
+    success: boolean;
+    output?: any;
+    error?: string;
+    logs: string[];
+    sideEffects: SideEffect[];
+}
+export interface SideEffect {
+    type: 'file_created' | 'file_modified' | 'file_deleted' | 'command_executed' | 'package_installed';
+    target: string;
+    before?: any;
+    after?: any;
+}
+export interface RollbackResult {
+    success: boolean;
+    actionsRolledBack: number;
+    errors: string[];
+    warnings: string[];
+}
+export interface IArchitectLogger {
+    info(message: string, context?: Record<string, any>): void;
+    warn(message: string, context?: Record<string, any>): void;
+    error(message: string, error?: Error, context?: Record<string, any>): void;
+    debug(message: string, context?: Record<string, any>): void;
+}
+export interface IArchitectPlugin {
+    readonly name: string;
+    readonly version: string;
+    /**
+     * Initialize the plugin
+     */
+    initialize(context: PluginContext): Promise<void>;
+    /**
+     * Handle custom actions
+     */
+    handleAction?(action: ArchitectAction): Promise<ActionResult>;
+    /**
+     * Modify plans before execution
+     */
+    transformPlan?(plan: ArchitectPlan): Promise<ArchitectPlan>;
+    /**
+     * Cleanup resources
+     */
+    dispose?(): Promise<void>;
+}
+export interface PluginContext {
+    logger: IArchitectLogger;
+    config: Record<string, any>;
+    projectRoot: string;
+}

package/dist/architect/core/interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/architect/core/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/architect/core/interfaces.ts"],"names":[],"mappings":""}