@kjerneverk/execution 1.0.4-dev.0

package/dist/index.js

@@ -0,0 +1,239 @@
+function createRequest(model) {
+  const messages = [];
+  return {
+    model,
+    messages,
+    responseFormat: void 0,
+    validator: void 0,
+    addMessage: (message) => {
+      messages.push(message);
+    }
+  };
+}
+const LIBRARY_NAME = "execution";
+const DEFAULT_LOGGER = {
+  name: "default",
+  debug: (message, ...args) => console.debug(message, ...args),
+  info: (message, ...args) => console.info(message, ...args),
+  warn: (message, ...args) => console.warn(message, ...args),
+  error: (message, ...args) => console.error(message, ...args),
+  verbose: () => {
+  },
+  silly: () => {
+  }
+};
+function wrapLogger(toWrap, name) {
+  const requiredMethods = [
+    "debug",
+    "info",
+    "warn",
+    "error",
+    "verbose",
+    "silly"
+  ];
+  const missingMethods = requiredMethods.filter(
+    (method) => typeof toWrap[method] !== "function"
+  );
+  if (missingMethods.length > 0) {
+    throw new Error(
+      `Logger is missing required methods: ${missingMethods.join(", ")}`
+    );
+  }
+  const log = (level, message, ...args) => {
+    message = `[${LIBRARY_NAME}] ${name ? `[${name}]` : ""}: ${message}`;
+    if (level === "debug") toWrap.debug(message, ...args);
+    else if (level === "info") toWrap.info(message, ...args);
+    else if (level === "warn") toWrap.warn(message, ...args);
+    else if (level === "error") toWrap.error(message, ...args);
+    else if (level === "verbose") toWrap.verbose(message, ...args);
+    else if (level === "silly") toWrap.silly(message, ...args);
+  };
+  return {
+    name: "wrapped",
+    debug: (message, ...args) => log("debug", message, ...args),
+    info: (message, ...args) => log("info", message, ...args),
+    warn: (message, ...args) => log("warn", message, ...args),
+    error: (message, ...args) => log("error", message, ...args),
+    verbose: (message, ...args) => log("verbose", message, ...args),
+    silly: (message, ...args) => log("silly", message, ...args)
+  };
+}
+class ModelRegistry {
+  configs;
+  cache;
+  logger;
+  constructor(logger) {
+    this.configs = [];
+    this.cache = /* @__PURE__ */ new Map();
+    this.logger = wrapLogger(logger || DEFAULT_LOGGER, "ModelRegistry");
+    this.registerDefaults();
+  }
+  /**
+   * Register default model configurations
+   */
+  registerDefaults() {
+    this.register({
+      pattern: /.*/,
+      personaRole: "system",
+      encoding: "gpt-4o",
+      supportsToolCalls: true,
+      family: "unknown",
+      description: "Default fallback configuration"
+    });
+    this.register({
+      pattern: /^claude/i,
+      personaRole: "system",
+      encoding: "cl100k_base",
+      supportsToolCalls: true,
+      family: "claude",
+      description: "Claude family models"
+    });
+    this.register({
+      pattern: /^o\d+/i,
+      personaRole: "developer",
+      encoding: "gpt-4o",
+      supportsToolCalls: true,
+      family: "o-series",
+      description: "O-series reasoning models"
+    });
+    this.register({
+      pattern: /^gpt-4/i,
+      personaRole: "system",
+      encoding: "gpt-4o",
+      supportsToolCalls: true,
+      family: "gpt-4",
+      description: "GPT-4 family models"
+    });
+    this.register({
+      pattern: /^gemini/i,
+      personaRole: "system",
+      encoding: "cl100k_base",
+      supportsToolCalls: true,
+      family: "gemini",
+      description: "Gemini family models"
+    });
+    this.logger.debug("Registered default model configurations");
+  }
+  /**
+   * Register a model configuration
+   */
+  register(config) {
+    if (!config.pattern && !config.exactMatch) {
+      throw new Error("Model config must have either pattern or exactMatch");
+    }
+    this.configs.unshift(config);
+    this.cache.clear();
+    this.logger.debug("Registered model config", {
+      family: config.family,
+      pattern: config.pattern?.source,
+      exactMatch: config.exactMatch
+    });
+  }
+  /**
+   * Get configuration for a model
+   */
+  getConfig(model) {
+    if (this.cache.has(model)) {
+      return this.cache.get(model);
+    }
+    for (const config of this.configs) {
+      if (config.exactMatch && config.exactMatch === model) {
+        this.cache.set(model, config);
+        return config;
+      }
+      if (config.pattern && config.pattern.test(model)) {
+        this.cache.set(model, config);
+        return config;
+      }
+    }
+    throw new Error(`No configuration found for model: ${model}`);
+  }
+  /**
+   * Get persona role for a model
+   */
+  getPersonaRole(model) {
+    return this.getConfig(model).personaRole;
+  }
+  /**
+   * Get tokenizer encoding for a model
+   */
+  getEncoding(model) {
+    return this.getConfig(model).encoding;
+  }
+  /**
+   * Check if model supports tool calls
+   */
+  supportsToolCalls(model) {
+    return this.getConfig(model).supportsToolCalls ?? true;
+  }
+  /**
+   * Get model family
+   */
+  getFamily(model) {
+    return this.getConfig(model).family;
+  }
+  /**
+   * Clear all registered configs and reset to defaults
+   */
+  reset() {
+    this.configs = [];
+    this.cache.clear();
+    this.registerDefaults();
+    this.logger.debug("Reset model configurations to defaults");
+  }
+  /**
+   * Clear cache
+   */
+  clearCache() {
+    this.cache.clear();
+    this.logger.debug("Cleared model configuration cache");
+  }
+  /**
+   * Get all registered configurations
+   */
+  getAllConfigs() {
+    return [...this.configs];
+  }
+}
+let globalRegistry = null;
+function getModelRegistry(logger) {
+  if (!globalRegistry) {
+    globalRegistry = new ModelRegistry(logger);
+  }
+  return globalRegistry;
+}
+function resetModelRegistry() {
+  globalRegistry = null;
+}
+function getPersonaRole(model) {
+  return getModelRegistry().getPersonaRole(model);
+}
+function getEncoding(model) {
+  return getModelRegistry().getEncoding(model);
+}
+function supportsToolCalls(model) {
+  return getModelRegistry().supportsToolCalls(model);
+}
+function getModelFamily(model) {
+  return getModelRegistry().getFamily(model);
+}
+function configureModel(config) {
+  getModelRegistry().register(config);
+}
+const VERSION = "0.0.1";
+export {
+  DEFAULT_LOGGER,
+  LIBRARY_NAME,
+  ModelRegistry,
+  VERSION,
+  configureModel,
+  createRequest,
+  getEncoding,
+  getModelFamily,
+  getModelRegistry,
+  getPersonaRole,
+  resetModelRegistry,
+  supportsToolCalls,
+  wrapLogger
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/types.ts","../src/logger.ts","../src/model-registry.ts","../src/index.ts"],"sourcesContent":["/**\n * Execution Package - Core Types\n *\n * Defines the fundamental types for LLM execution across providers.\n */\n\n// ===== ROLE AND MODEL TYPES =====\n\n/**\n * Message role in a conversation\n */\nexport type Role = 'user' | 'assistant' | 'system' | 'developer' | 'tool';\n\n/**\n * Model identifier - flexible string to support any model\n */\nexport type Model = string;\n\n/**\n * Model role mapping for persona/system messages\n */\nexport type PersonaRole = 'system' | 'developer';\n\n/**\n * Tokenizer encoding to use for token counting\n */\nexport type TokenizerEncoding = 'gpt-4o' | 'cl100k_base' | 'o200k_base';\n\n// ===== MESSAGE TYPES =====\n\n/**\n * A message in a conversation\n */\nexport interface Message {\n    role: Role;\n    content: string | string[] | null;\n    name?: string;\n}\n\n/**\n * Tool call made by the assistant\n */\nexport interface ToolCall {\n    id: string;\n    type: 'function';\n    function: {\n        name: string;\n        arguments: string;\n    };\n}\n\n/**\n * Message in a conversation (compatible with OpenAI format)\n */\nexport interface ConversationMessage {\n    role: 'system' | 'user' | 'assistant' | 'tool' | 'developer';\n    content: string | null;\n    name?: string;\n    tool_calls?: ToolCall[];\n    tool_call_id?: string;\n}\n\n// ===== REQUEST TYPES =====\n\n/**\n * LLM request interface\n */\nexport interface Request {\n    messages: Message[];\n    model: Model;\n    responseFormat?: any;\n    validator?: any;\n    addMessage(message: Message): void;\n}\n\n/**\n * Create a new request object\n */\nexport function createRequest(model: Model): Request {\n    const messages: Message[] = [];\n\n    return {\n        model,\n        messages,\n        responseFormat: undefined,\n        validator: undefined,\n        addMessage: (message: Message) => {\n            messages.push(message);\n        },\n    };\n}\n\n// ===== PROVIDER TYPES =====\n\n/**\n * Response from an LLM provider\n */\nexport interface ProviderResponse {\n    content: string;\n    model: string;\n    usage?: {\n        inputTokens: number;\n        outputTokens: number;\n    };\n    toolCalls?: ToolCall[];\n}\n\n/**\n * Options for execution\n */\nexport interface ExecutionOptions {\n    apiKey?: string;\n    model?: string;\n    temperature?: number;\n    maxTokens?: number;\n    timeout?: number;\n    retries?: number;\n}\n\n/**\n * Provider interface for LLM execution\n */\nexport interface Provider {\n    /**\n     * Provider name (e.g., 'openai', 'anthropic', 'gemini')\n     */\n    readonly name: string;\n\n    /**\n     * Execute a request against this provider\n     */\n    execute(request: Request, options?: ExecutionOptions): Promise<ProviderResponse>;\n\n    /**\n     * Check if this provider supports a given model\n     */\n    supportsModel?(model: Model): boolean;\n}\n\n// ===== MODEL CONFIGURATION =====\n\n/**\n * Configuration for a model or model family\n */\nexport interface ModelConfig {\n    pattern?: RegExp;\n    exactMatch?: string;\n    personaRole: PersonaRole;\n    encoding: TokenizerEncoding;\n    supportsToolCalls?: boolean;\n    maxTokens?: number;\n    family?: string;\n    description?: string;\n}\n\n","/**\n * Execution Package - Logger\n *\n * Shared logging infrastructure for execution packages.\n */\n\n/* eslint-disable no-var */\ndeclare var console: {\n    debug: (message: string, ...args: any[]) => void;\n    info: (message: string, ...args: any[]) => void;\n    warn: (message: string, ...args: any[]) => void;\n    error: (message: string, ...args: any[]) => void;\n};\n/* eslint-enable no-var */\n\nexport const LIBRARY_NAME = 'execution';\n\nexport interface Logger {\n    name: string;\n    debug: (message: string, ...args: any[]) => void;\n    info: (message: string, ...args: any[]) => void;\n    warn: (message: string, ...args: any[]) => void;\n    error: (message: string, ...args: any[]) => void;\n    verbose: (message: string, ...args: any[]) => void;\n    silly: (message: string, ...args: any[]) => void;\n}\n\n \nexport const DEFAULT_LOGGER: Logger = {\n    name: 'default',\n    debug: (message: string, ...args: any[]) => console.debug(message, ...args),\n    info: (message: string, ...args: any[]) => console.info(message, ...args),\n    warn: (message: string, ...args: any[]) => console.warn(message, ...args),\n    error: (message: string, ...args: any[]) => console.error(message, ...args),\n    verbose: () => {},\n    silly: () => {},\n};\n \n\nexport function wrapLogger(toWrap: Logger, name?: string): Logger {\n    const requiredMethods: (keyof Logger)[] = [\n        'debug',\n        'info',\n        'warn',\n        'error',\n        'verbose',\n        'silly',\n    ];\n    const missingMethods = requiredMethods.filter(\n        (method) => typeof toWrap[method] !== 'function'\n    );\n\n    if (missingMethods.length > 0) {\n        throw new Error(\n            `Logger is missing required methods: ${missingMethods.join(', ')}`\n        );\n    }\n\n    const log = (level: keyof Logger, message: string, ...args: any[]) => {\n        message = `[${LIBRARY_NAME}] ${name ? `[${name}]` : ''}: ${message}`;\n\n        if (level === 'debug') toWrap.debug(message, ...args);\n        else if (level === 'info') toWrap.info(message, ...args);\n        else if (level === 'warn') toWrap.warn(message, ...args);\n        else if (level === 'error') toWrap.error(message, ...args);\n        else if (level === 'verbose') toWrap.verbose(message, ...args);\n        else if (level === 'silly') toWrap.silly(message, ...args);\n    };\n\n    return {\n        name: 'wrapped',\n        debug: (message: string, ...args: any[]) => log('debug', message, ...args),\n        info: (message: string, ...args: any[]) => log('info', message, ...args),\n        warn: (message: string, ...args: any[]) => log('warn', message, ...args),\n        error: (message: string, ...args: any[]) => log('error', message, ...args),\n        verbose: (message: string, ...args: any[]) =>\n            log('verbose', message, ...args),\n        silly: (message: string, ...args: any[]) => log('silly', message, ...args),\n    };\n}\n\n","/**\n * Execution Package - Model Registry\n *\n * Provides a flexible, user-configurable system for model detection and configuration.\n */\n\nimport { DEFAULT_LOGGER, wrapLogger, type Logger } from './logger.js';\nimport type { ModelConfig, PersonaRole, TokenizerEncoding } from './types.js';\n\n/**\n * Model registry for managing model configurations\n */\nexport class ModelRegistry {\n    private configs: ModelConfig[];\n    private cache: Map<string, ModelConfig>;\n    private logger: Logger;\n\n    constructor(logger?: Logger) {\n        this.configs = [];\n        this.cache = new Map();\n        this.logger = wrapLogger(logger || DEFAULT_LOGGER, 'ModelRegistry');\n\n        // Register default configurations\n        this.registerDefaults();\n    }\n\n    /**\n     * Register default model configurations\n     */\n    private registerDefaults(): void {\n        // Default fallback (Registered first so it ends up last with unshift)\n        this.register({\n            pattern: /.*/,\n            personaRole: 'system',\n            encoding: 'gpt-4o',\n            supportsToolCalls: true,\n            family: 'unknown',\n            description: 'Default fallback configuration',\n        });\n\n        // Claude family (uses 'system' role)\n        this.register({\n            pattern: /^claude/i,\n            personaRole: 'system',\n            encoding: 'cl100k_base',\n            supportsToolCalls: true,\n            family: 'claude',\n            description: 'Claude family models',\n        });\n\n        // O-series models (uses 'developer' role)\n        this.register({\n            pattern: /^o\\d+/i,\n            personaRole: 'developer',\n            encoding: 'gpt-4o',\n            supportsToolCalls: true,\n            family: 'o-series',\n            description: 'O-series reasoning models',\n        });\n\n        // GPT-4 family (uses 'system' role)\n        this.register({\n            pattern: /^gpt-4/i,\n            personaRole: 'system',\n            encoding: 'gpt-4o',\n            supportsToolCalls: true,\n            family: 'gpt-4',\n            description: 'GPT-4 family models',\n        });\n\n        // Gemini family\n        this.register({\n            pattern: /^gemini/i,\n            personaRole: 'system',\n            encoding: 'cl100k_base',\n            supportsToolCalls: true,\n            family: 'gemini',\n            description: 'Gemini family models',\n        });\n\n        this.logger.debug('Registered default model configurations');\n    }\n\n    /**\n     * Register a model configuration\n     */\n    register(config: ModelConfig): void {\n        if (!config.pattern && !config.exactMatch) {\n            throw new Error('Model config must have either pattern or exactMatch');\n        }\n\n        this.configs.unshift(config);\n        this.cache.clear();\n\n        this.logger.debug('Registered model config', {\n            family: config.family,\n            pattern: config.pattern?.source,\n            exactMatch: config.exactMatch,\n        });\n    }\n\n    /**\n     * Get configuration for a model\n     */\n    getConfig(model: string): ModelConfig {\n        if (this.cache.has(model)) {\n            return this.cache.get(model)!;\n        }\n\n        for (const config of this.configs) {\n            if (config.exactMatch && config.exactMatch === model) {\n                this.cache.set(model, config);\n                return config;\n            }\n\n            if (config.pattern && config.pattern.test(model)) {\n                this.cache.set(model, config);\n                return config;\n            }\n        }\n\n        throw new Error(`No configuration found for model: ${model}`);\n    }\n\n    /**\n     * Get persona role for a model\n     */\n    getPersonaRole(model: string): PersonaRole {\n        return this.getConfig(model).personaRole;\n    }\n\n    /**\n     * Get tokenizer encoding for a model\n     */\n    getEncoding(model: string): TokenizerEncoding {\n        return this.getConfig(model).encoding;\n    }\n\n    /**\n     * Check if model supports tool calls\n     */\n    supportsToolCalls(model: string): boolean {\n        return this.getConfig(model).supportsToolCalls ?? true;\n    }\n\n    /**\n     * Get model family\n     */\n    getFamily(model: string): string | undefined {\n        return this.getConfig(model).family;\n    }\n\n    /**\n     * Clear all registered configs and reset to defaults\n     */\n    reset(): void {\n        this.configs = [];\n        this.cache.clear();\n        this.registerDefaults();\n        this.logger.debug('Reset model configurations to defaults');\n    }\n\n    /**\n     * Clear cache\n     */\n    clearCache(): void {\n        this.cache.clear();\n        this.logger.debug('Cleared model configuration cache');\n    }\n\n    /**\n     * Get all registered configurations\n     */\n    getAllConfigs(): ModelConfig[] {\n        return [...this.configs];\n    }\n}\n\n// Global registry instance\nlet globalRegistry: ModelRegistry | null = null;\n\n/**\n * Get the global model registry\n */\nexport function getModelRegistry(logger?: Logger): ModelRegistry {\n    if (!globalRegistry) {\n        globalRegistry = new ModelRegistry(logger);\n    }\n    return globalRegistry;\n}\n\n/**\n * Reset the global registry\n */\nexport function resetModelRegistry(): void {\n    globalRegistry = null;\n}\n\n/**\n * Helper functions using global registry\n */\nexport function getPersonaRole(model: string): PersonaRole {\n    return getModelRegistry().getPersonaRole(model);\n}\n\nexport function getEncoding(model: string): TokenizerEncoding {\n    return getModelRegistry().getEncoding(model);\n}\n\nexport function supportsToolCalls(model: string): boolean {\n    return getModelRegistry().supportsToolCalls(model);\n}\n\nexport function getModelFamily(model: string): string | undefined {\n    return getModelRegistry().getFamily(model);\n}\n\n/**\n * Configure a custom model\n */\nexport function configureModel(config: ModelConfig): void {\n    getModelRegistry().register(config);\n}\n\nexport default ModelRegistry;\n\n","/**\n * Execution Package\n *\n * Core interfaces and types for LLM execution providers.\n * This package contains no provider-specific dependencies.\n *\n * @packageDocumentation\n */\n\n// Types\nexport type {\n    Role,\n    Model,\n    PersonaRole,\n    TokenizerEncoding,\n    Message,\n    ToolCall,\n    ConversationMessage,\n    Request,\n    ProviderResponse,\n    ExecutionOptions,\n    Provider,\n    ModelConfig,\n} from './types.js';\n\nexport { createRequest } from './types.js';\n\n// Logger\nexport type { Logger } from './logger.js';\nexport { DEFAULT_LOGGER, wrapLogger, LIBRARY_NAME } from './logger.js';\n\n// Model Registry\nexport {\n    ModelRegistry,\n    getModelRegistry,\n    resetModelRegistry,\n    getPersonaRole,\n    getEncoding,\n    supportsToolCalls,\n    getModelFamily,\n    configureModel,\n} from './model-registry.js';\n\n/**\n * Package version\n */\nexport const VERSION = '0.0.1';\n"],"names":[],"mappings":"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"}

package/output/kodrdriv/260110-1725-commit-message.md

@@ -0,0 +1 @@
+test: delete legacy src/*.test.ts after moving tests to tests/

package/output/kodrdriv/260110-1729-release-notes.md

@@ -0,0 +1,40 @@
+# @riotprompt/execution v0.0.2 — test suite moved to tests/ and coverage enabled by default
+
+## Summary
+This release focuses on developer tooling: it reorganizes the unit test layout, enables Vitest v8 coverage reporting, and tightens up publish/test scripts.
+
+## Changes
+
+### Tests: move to `tests/`
+- Unit tests were moved from `src/*.test.ts` into `tests/`.
+- Legacy `src/*.test.ts` files were removed after the move.
+- Test imports were updated to reference `../src/...` instead of relative imports from within `src/`.
+
+**Why it matters:** keeps source files and tests separated, simplifies coverage targeting, and avoids mixing production and test code under `src/`.
+
+### Coverage: enabled with V8 provider
+- `npm test` now runs `vitest run --coverage` (coverage is on by default).
+- Added `@vitest/coverage-v8` and configured coverage output:
+  - Reporters: `text`, `json`, and `html`
+  - Coverage includes `src/**/*.ts`
+  - Expanded excludes to avoid counting build output and config files (e.g. `dist/**`, `node_modules/`, `vitest.config.ts`, `vite.config.ts`, `eslint.config.mjs`).
+
+**Why it matters:** makes coverage available in CI and locally without extra flags, and produces a machine-readable JSON report.
+
+### Package scripts and publishing hygiene
+- Added `clean` script (`rm -rf dist`).
+- Added `prepublishOnly` to ensure a clean, fresh build when publishing (`clean` + `build`).
+- Added `precommit` convenience script (`lint` + `test`).
+
+**Impact for developers:**
+- Publishing will now always rebuild from a clean `dist/` state.
+- Running tests will generate coverage artifacts and may take slightly longer.
+
+### Metadata / housekeeping
+- Bumped package version: `0.0.1` → `0.0.2`.
+- Repository URL changed from `git+https://...` to `https://...`.
+- Test cache metadata file (`.kodrdriv-test-cache.json`) was updated (no runtime impact).
+
+## Breaking changes
+- No runtime/API breaking changes were detected in this range.
+- Developer/CI consideration: if your workflows assumed tests lived under `src/**` or expected `npm test` to run without coverage, update them accordingly.

package/output/kodrdriv/260112-2158-commit-message.md

@@ -0,0 +1 @@
+chore(release): bump @riotprompt/execution to 0.0.3

package/output/kodrdriv/260112-2159-release-notes.md

@@ -0,0 +1,40 @@
+# @riotprompt/execution 0.0.3 — CI/runtime toolchain update (Node 24) and lockfile removal
+
+## Summary
+This release is primarily maintenance/ops work:
+- CI and publish workflows now run on **Node.js 24**.
+- Workflows switched from `npm ci` to `npm install`.
+- The repository no longer tracks `package-lock.json` (it’s now gitignored).
+
+There are **no library API changes** in this diff; the package contents/exports remain the same.
+
+## Changes
+### CI / Release automation
+- **GitHub Actions now uses Node 24** for both test and publish workflows.
+- **Dependency install step changed**:
+  - `npm ci` → `npm install` in `test.yml`
+  - `npm ci --verbose --foreground-scripts` → `npm install --verbose --foreground-scripts` in `npm-publish.yml`
+- The `test.yml` workflow also no longer configures the npm cache via `actions/setup-node`.
+
+### Repository hygiene
+- **`package-lock.json` is no longer committed** and is now listed in `.gitignore`.
+
+### Version
+- Package version bumped from **0.0.2 → 0.0.3**.
+
+## Why it matters
+- **More consistent CI environment**: running tests/publish on Node 24 ensures the repo stays aligned with the current Node major.
+- **Unblocks CI/publish without a lockfile**: `npm ci` requires a committed lockfile; switching to `npm install` keeps workflows functional when `package-lock.json` is intentionally not tracked.
+- **Less lockfile churn**: avoiding `package-lock.json` changes reduces noisy diffs for a library package.
+
+## Impact
+### For package consumers
+- No expected impact. This release does not include runtime or public API changes.
+
+### For contributors / maintainers
+- Expect CI to validate against **Node 24**.
+- Local `npm install` may generate a `package-lock.json`, but it is **ignored** and should not be committed.
+
+## Breaking changes
+- No breaking API changes detected.
+- **Potential tooling break for contributors**: if you rely on a committed `package-lock.json` (e.g., for reproducible installs or certain CI setups), you’ll need to adjust, since the repo now ignores it and GitHub Actions no longer uses `npm ci`.

package/output/kodrdriv/260112-2340-commit-message.md

@@ -0,0 +1 @@
+chore(build): switch to ESM-only output, require Node 24, and target ES2024

package/output/kodrdriv/260113-0020-commit-message.md

@@ -0,0 +1 @@
+chore(release): bump @riotprompt/execution to 0.0.4

package/output/kodrdriv/260113-0020-release-notes.md

@@ -0,0 +1,44 @@
+# @riotprompt/execution v0.0.4 — ESM-only build, Node 24+ requirement, ES2024 target
+
+## Overview
+This release is primarily a packaging/build update. `@riotprompt/execution` now ships **ESM-only** output, targets **ES2024**, and declares **Node.js >= 24** support.
+
+## Breaking changes
+### ESM-only distribution (CommonJS removed)
+- The package no longer builds or publishes a CommonJS (`.cjs`) entry.
+- `package.json` exports now provide **only** an ESM `import` path.
+
+**Impact**
+- Consumers using `require('@riotprompt/execution')` will no longer be able to load the package.
+
+**Migration**
+- Switch to ESM imports:
+  ```js
+  import { /* ... */ } from "@riotprompt/execution";
+  ```
+- If you must stay in CommonJS, you’ll need to load via dynamic import from CJS:
+  ```js
+  const mod = await import("@riotprompt/execution");
+  ```
+  (or use a bundler/transpilation step that supports consuming ESM dependencies).
+
+### Node.js 24+ required
+- `package.json` now includes:
+  - `engines.node: >=24.0.0`
+
+**Impact**
+- Install/use on Node 22/20/etc. may fail (or be blocked depending on your package manager settings).
+
+## Build and tooling changes
+- TypeScript target/lib updated from **ES2022** to **ES2024**.
+- Vite library build now outputs only **ES** format:
+  - Output filename is always `dist/index.js`.
+  - `main` now points to `./dist/index.js`.
+
+## What didn’t change
+- No functional/API changes are indicated in this diff—this release is focused on how the package is built and consumed.
+
+## Upgrade checklist
+- Ensure your runtime is **Node 24+**.
+- Ensure your project can consume **ESM-only** dependencies (or migrate your usage to `import` / dynamic import).
+- If you previously depended on `dist/index.cjs` or the `exports.require` entry, update your integration accordingly.

package/output/kodrdriv/260115-0616-commit-message.md

@@ -0,0 +1,4 @@
+chore(release): reset @riotprompt/execution to 1.0.0-dev.0
+
+- bump package.json version to 1.0.0-dev.0 and record _versionReset date
+- add v1.0.0 marker comment to README

package/output/kodrdriv/260115-0739-commit-message.md

@@ -0,0 +1 @@
+chore(precommit): run build before lint and tests

package/output/kodrdriv/260126-0859-commit-message.md

@@ -0,0 +1 @@
+chore(release): bump @riotprompt/execution to 1.0.0

package/output/kodrdriv/260126-0900-release-notes.md

@@ -0,0 +1,39 @@
+# 1.0.0 — Stable release + repo hygiene updates
+
+## Overview
+
+This release is primarily about graduating `@riotprompt/execution` to a stable **1.0.0** version and tightening up a couple of repository/developer workflows. There are **no functional code changes** in this range (no changes to `src/`), and no API surface changes were detected.
+
+Compared to `v0.0.4`, this release contains **5 commits** and changes **3 files** (`package.json`, `README.md`, `.gitignore`).
+
+## Changes
+
+### Versioning / release metadata
+- Bumped package version to **1.0.0** in `package.json`.
+- Added internal release bookkeeping metadata (`_versionReset`) to record the version reset date.
+
+**Impact**
+- Consumers should see this as the stable 1.0.0 release of the existing package.
+- No runtime behavior changes are introduced by this version bump itself.
+
+### Developer workflow
+- Updated the `precommit` script to run **build before lint and tests**:
+  - `npm run build && npm run lint && npm run test`
+
+**Impact**
+- Commits will now fail earlier if the build is broken (at the cost of doing a build on every precommit run).
+- If your local environment isn’t set up to build successfully (e.g., missing prerequisites), you’ll hit that earlier in the commit process.
+
+### Repo hygiene
+- Updated `.gitignore` to ignore `.kodrdriv*` internal files.
+
+**Impact**
+- Helps prevent accidentally committing local tooling artifacts.
+
+### Documentation
+- Added a `<!-- v1.0.0 -->` marker comment to `README.md` (release bookkeeping).
+
+## Breaking changes
+
+- **None detected** in the diff from `main` to `HEAD`.
+- This change set does not modify production source files; it is primarily versioning and workflow cleanup.

package/output/kodrdriv/260128-0920-commit-message.md

@@ -0,0 +1 @@
+No changes detected; nothing to commit.

package/output/kodrdriv/260128-0921-release-notes.md

@@ -0,0 +1,28 @@
+# Release 1.0.1
+
+### Overview
+Version 1.0.1 introduces important updates and fixes related to the execution provider interfaces, addressing key issues identified in earlier releases. This release aims to enhance functionality and reliability for both users and developers, with a focus on improving the workflow for handling various versions and dependencies.
+
+### Key Changes
+1. **Improvements and Fixes**:
+   - **Dependency Management**: Adjustments were made in the `package.json` to update the dependency versions, ensuring compatibility and addressing potential security vulnerabilities.
+   - **Workflow Enhancements**: The CI/CD workflow defined in `.github/workflows/npm-publish.yml` has been refined to better handle npm publishing and version tagging, facilitating smoother deployments.
+
+### Problems Solved
+- Issues regarding the handling of development dependencies have been tackled, ensuring that the package allows for explicit version overrides and resolves conflicts more effectively during the ingestion of new library versions.
+- Streamlined workflows reduce manual overhead and increase reliability in the deployment process, which is critical for continuous integration environments.
+
+### Impact
+- **Users**: Improvements in dependency management enhance application stability and security. Users can expect fewer issues when installing and upgrading packages in their projects.
+- **Developers**: Developers benefit from a refined workflow that automates more steps in the publishing process, allowing them to focus on coding rather than manual steps.
+
+### Breaking Changes
+- No breaking changes were detected in this release. However, a manual review is recommended for any API changes that might affect existing integrations.
+
+### Dependencies
+- There were no files found importing the updated `package.json`, indicating a stable transition to using the library without immediate impacts on other components of the codebase.
+
+### Related Tests
+- Testing for the updates to `package.json` has been noted, ensuring that all functionalities are covered and suitable for the new version.
+
+This release marks a significant step in the evolution of the application, continuing the trajectory of improvements and refinements that address both user and developer needs.

package/output/kodrdriv/260128-0958-commit-message.md

@@ -0,0 +1 @@
+chore: bump package.json version

package/output/kodrdriv/260128-1125-commit-message.md

@@ -0,0 +1 @@
+No changes detected; the target file does not exist or may have been deleted.

package/output/kodrdriv/260128-1125-release-notes.md

@@ -0,0 +1,23 @@
+# Version 1.0.3
+
+### Overview
+Version 1.0.3 includes vital updates to the package management and build processes. This release focuses on solving issues related to dependency management and enhancing the efficiency of automated workflows.
+
+### Changes Made
+- Updated the package manager configuration in `package.json`.
+- Modified the scripts associated with the package to streamline the build and test processes.
+- Overall, there are 10 significant changes — 5 insertions and 5 deletions in the `package.json` file.
+
+### Key Enhancements
+- **Dependency Management:** This release ensures better detection of npm tags, specifically for prerelease versions, improving the publishing workflow.
+- **Improved Build Process:** Enhancements to the npm lifecycle scripts (`clean`, `build`, `test`, etc.) have been made, ensuring a more efficient development cycle.
+
+### Impact on Users
+- Users will benefit from smoother installation and upgrade processes for package dependencies, thanks to improved handling of version tags.
+- Developers will find the new build and test scripts to be more modular and reliable, facilitating easier integration and continuous deployment practices.
+
+### Breaking Changes
+- No breaking changes have been identified in this release. However, a manual review of API changes is recommended to ensure compatibility.
+
+### Conclusion
+This release is a crucial step in refining the development workflow and package management for the project, primarily focusing on enhancing user experience and developer efficiency.

package/output/kodrdriv/RELEASE_NOTES.md

@@ -0,0 +1,21 @@
+### Overview
+Version 1.0.3 includes vital updates to the package management and build processes. This release focuses on solving issues related to dependency management and enhancing the efficiency of automated workflows.
+
+### Changes Made
+- Updated the package manager configuration in `package.json`.
+- Modified the scripts associated with the package to streamline the build and test processes.
+- Overall, there are 10 significant changes — 5 insertions and 5 deletions in the `package.json` file.
+
+### Key Enhancements
+- **Dependency Management:** This release ensures better detection of npm tags, specifically for prerelease versions, improving the publishing workflow.
+- **Improved Build Process:** Enhancements to the npm lifecycle scripts (`clean`, `build`, `test`, etc.) have been made, ensuring a more efficient development cycle.
+
+### Impact on Users
+- Users will benefit from smoother installation and upgrade processes for package dependencies, thanks to improved handling of version tags.
+- Developers will find the new build and test scripts to be more modular and reliable, facilitating easier integration and continuous deployment practices.
+
+### Breaking Changes
+- No breaking changes have been identified in this release. However, a manual review of API changes is recommended to ensure compatibility.
+
+### Conclusion
+This release is a crucial step in refining the development workflow and package management for the project, primarily focusing on enhancing user experience and developer efficiency.

package/output/kodrdriv/RELEASE_TITLE.md

@@ -0,0 +1 @@
+Version 1.0.3