atabey 0.0.37 → 0.1.0

package/dist/shared/src/modules/observability/otel.js

@@ -0,0 +1,93 @@
+/**
+ * OpenTelemetry-compatible tracing without an SDK dependency.
+ *
+ * Produces W3C Trace Context ids and OTLP-shaped span records, written as
+ * JSON Lines to `.atabey/telemetry/otel.jsonl` (and optionally pushed to an
+ * OTLP/HTTP collector via OTEL_EXPORTER_OTLP_ENDPOINT). This lets enterprise
+ * teams ship Atabey's tool spans to Datadog/Jaeger/Grafana/ELK without Atabey
+ * taking a hard dependency on the OTel SDK.
+ */
+import crypto from "crypto";
+import fs from "fs";
+import os from "os";
+import path from "path";
+export function newTraceId() {
+    return crypto.randomBytes(16).toString("hex");
+}
+export function newSpanId() {
+    return crypto.randomBytes(8).toString("hex");
+}
+/** W3C traceparent header for the given ids. */
+export function formatTraceparent(traceId, spanId, sampled = true) {
+    return `00-${traceId}-${spanId}-${sampled ? "01" : "00"}`;
+}
+function cleanAttributes(attributes) {
+    const out = {};
+    for (const [k, v] of Object.entries(attributes)) {
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}
+/**
+ * Emit a span record. Best-effort: telemetry must never break tool execution.
+ */
+export function emitSpan(projectRoot, span) {
+    const record = {
+        traceId: span.traceId,
+        spanId: span.spanId,
+        parentSpanId: span.parentSpanId,
+        name: span.name,
+        startTimeUnixNano: String(BigInt(Math.round(span.startMs)) * 1000000n),
+        endTimeUnixNano: String(BigInt(Math.round(span.endMs)) * 1000000n),
+        attributes: cleanAttributes(span.attributes || {}),
+        status: span.status || "OK",
+    };
+    try {
+        const effectiveRoot = process.env.VITEST && path.resolve(projectRoot) === path.resolve(process.cwd())
+            ? path.join(os.tmpdir(), `atabey-vitest-worker-${process.pid}`)
+            : projectRoot;
+        const dir = path.join(effectiveRoot, ".atabey", "telemetry");
+        fs.mkdirSync(dir, { recursive: true });
+        fs.appendFileSync(path.join(dir, "otel.jsonl"), `${JSON.stringify(record)}\n`);
+    }
+    catch {
+        /* best-effort */
+    }
+    const endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT?.trim();
+    if (endpoint) {
+        void pushOtlp(endpoint, record).catch(() => { });
+    }
+    return record;
+}
+async function pushOtlp(endpoint, record) {
+    const url = endpoint.replace(/\/$/, "") + "/v1/traces";
+    const body = JSON.stringify({
+        resourceSpans: [{
+                resource: { attributes: [{ key: "service.name", value: { stringValue: "atabey" } }] },
+                scopeSpans: [{ spans: [{
+                                traceId: record.traceId,
+                                spanId: record.spanId,
+                                parentSpanId: record.parentSpanId,
+                                name: record.name,
+                                startTimeUnixNano: record.startTimeUnixNano,
+                                endTimeUnixNano: record.endTimeUnixNano,
+                                attributes: Object.entries(record.attributes).map(([k, v]) => ({
+                                    key: k,
+                                    value: typeof v === "number"
+                                        ? { doubleValue: v }
+                                        : typeof v === "boolean"
+                                            ? { boolValue: v }
+                                            : { stringValue: String(v) },
+                                })),
+                                status: { code: record.status === "ERROR" ? 2 : 1 },
+                            }] }],
+            }],
+    });
+    await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body,
+    }).catch(() => { });
+}
+//# sourceMappingURL=otel.js.map

package/dist/shared/src/modules/observability/otel.js.map

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

package/dist/shared/src/modules/primitives/constants.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Atabey — Single Source of Truth for framework constants.
+ * Import from here instead of hardcoding paths, phases, or directory names.
+ */
+export declare const FRAMEWORK: {
+    NAME: string;
+    CORE_DIR: string;
+    UNIFIED_HUB_DIR: string;
+    CONSTITUTION_FILE: string;
+    DEFAULT_TRACE_ID: string;
+    DEFAULT_PHASE: string;
+    DEFAULT_MANAGER_STATE: string;
+};
+export declare const PROJECT_PHASES: readonly ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"];
+export declare const ADAPTER_DIRS: {
+    readonly GEMINI: ".gemini";
+    readonly CLAUDE: ".claude";
+    readonly GROK: ".grok";
+    readonly CURSOR: ".cursor";
+    readonly CODEX: ".agents";
+    readonly ANTIGRAVITY: ".agents";
+    readonly LOCAL: ".atabey";
+    readonly OPENCODE: ".opencode";
+    readonly LEGACY_AGENT: ".agent";
+};
+/** Priority order for framework directory resolution (CLI + MCP).
+ *  De-duplicated: `.agents` serves both CODEX and ANTIGRAVITY, `.atabey` is also LOCAL. */
+export declare const FRAMEWORK_DIR_CANDIDATES: readonly [string, ".agents", ".claude", ".gemini", ".grok", ".cursor", ".opencode"];
+/** Slug under `.agents/{slug}/` for each adapter in unified mode. */
+export declare const UNIFIED_ADAPTER_SLUG: {
+    readonly gemini: "gemini";
+    readonly claude: "claude";
+    readonly grok: "grok";
+    readonly cursor: "cursor";
+    readonly codex: "codex";
+    readonly local: "local";
+    readonly opencode: "opencode";
+    readonly "antigravity-cli": "antigravity";
+};
+export type UnifiedAdapterSlug = keyof typeof UNIFIED_ADAPTER_SLUG;
+export declare const NATIVE_AGENT_PATHS: {
+    readonly gemini: string;
+    readonly claude: string;
+    readonly grok: string;
+    readonly cursor: string;
+    readonly codex: string;
+    readonly local: string;
+    readonly opencode: string;
+    readonly "antigravity-cli": string;
+};
+/** Legacy layout bases used by `check` and discovery (non-unified installs). */
+export declare const LEGACY_AGENT_LAYOUT_BASES: readonly [string, string, string, string, string, string, string, string];
+export declare const FRAMEWORK_SUBDIRS: {
+    readonly AGENTS: "agents";
+    readonly SKILLS: "skills";
+    readonly KNOWLEDGE: "knowledge";
+    readonly PROMPTS: "prompts";
+    readonly MEMORY: "memory";
+    readonly ROUTER: "router";
+    readonly REGISTRY: "registry";
+    readonly OBSERVABILITY: "observability";
+    readonly RULES: "rules";
+    readonly MESSAGES: "messages";
+    readonly LOGS: "logs";
+    readonly MEMORY_GRAPH: "memory-graph";
+};
+export declare const CORE_SCAFFOLD_SUBDIRS: readonly ["knowledge", "prompts", "memory", "router", "registry", "observability", "rules"];
+export declare const RUNTIME_SUBDIRS: readonly ["messages", "logs", "memory-graph"];
+export declare const MEMORY_SUBDIRS: {
+    readonly TASKS: "tasks";
+    readonly HISTORY: "history";
+};
+export declare const MEMORY_FILES: {
+    readonly STATE: "state.json";
+    readonly STATUS: "status.json";
+    readonly PROJECT_MEMORY: "PROJECT_MEMORY.md";
+    readonly SHARED_FACTS: "shared-facts.json";
+};
+/** Default layout scaffolded into consumer projects after `atabey init`. */
+export declare const DEFAULT_CONSUMER_PATHS: {
+    readonly backend: "apps/backend";
+    readonly frontend: "apps/web";
+    readonly mobile: "apps/mobile";
+    readonly docs: "docs";
+    readonly tests: "tests";
+};
+/** Paths inside the Atabey framework source monorepo (not consumer apps/). */
+export declare const FRAMEWORK_MONOREPO_PATHS: {
+    readonly backend: "packages/atabey";
+    readonly frontend: "apps/web";
+    readonly mobile: "apps/mobile";
+    readonly docs: "docs";
+    readonly tests: "packages";
+};
+/** @deprecated Use DEFAULT_CONSUMER_PATHS */
+export declare const DEFAULT_MONOREPO_PATHS: {
+    readonly backend: "apps/backend";
+    readonly frontend: "apps/web";
+    readonly mobile: "apps/mobile";
+    readonly docs: "docs";
+    readonly tests: "tests";
+};
+/** Cursor rule globs per agent role (framework monorepo layout). */
+export declare const CURSOR_AGENT_GLOBS: Record<string, string>;
+export declare const MCP: {
+    readonly SERVER_NAME: "atabey";
+    readonly ROOT_CONFIG_FILE: "mcp.json";
+    readonly PROJECT_ROOT_ENV: "ATABEY_PROJECT_ROOT";
+    readonly TEST_DIR_ENV: "ATABEY_TEST_DIR";
+    readonly TRANSPORT_ENV: "MCP_TRANSPORT";
+    /** IDE clients (Claude, Cursor, Gemini) spawn MCP via stdio JSON-RPC. */
+    readonly TRANSPORT_STDIO: "stdio";
+    /** HTTP/SSE unified server for multi-session and remote clients. */
+    readonly TRANSPORT_UNIFIED: "unified";
+    readonly SERVER_DIST_PATH: "../atabey-mcp/dist/atabey-mcp/src/mcp/index.js";
+};
+/** Headless Hermes orchestrator (AgentLoop) — auto-starts with MCP server by default. */
+export declare const ORCHESTRATOR: {
+    readonly AUTO_START_ENV: "ATABEY_AUTO_START_ORCHESTRATOR";
+    readonly INTERVAL_MS_ENV: "ATABEY_ORCHESTRATOR_INTERVAL_MS";
+    readonly DEFAULT_AUTO_START: true;
+    readonly DEFAULT_INTERVAL_MS: 1000;
+};
+export declare const ROOT_CONFIG_FILES: {
+    readonly MCP: "mcp.json";
+    readonly DOT_MCP: ".mcp.json";
+    readonly ENV_EXAMPLE: ".env.example";
+    readonly VSCODE_MCP: ".vscode/mcp.json";
+};
+export declare const TEMPLATE_PLACEHOLDERS: {
+    readonly FRAMEWORK_DIR: "{{FRAMEWORK_DIR}}";
+    readonly ADAPTER: "{{ADAPTER}}";
+    readonly BACKEND_DIR: "{{BACKEND_DIR}}";
+    readonly FRONTEND_DIR: "{{FRONTEND_DIR}}";
+    readonly DOCS_DIR: "{{DOCS_DIR}}";
+    readonly TESTS_DIR: "{{TESTS_DIR}}";
+};
+export declare const AGENT_FILE_EXT: {
+    readonly MARKDOWN: ".md";
+    readonly CURSOR_RULE: ".mdc";
+};
+export declare function pathJoin(...segments: string[]): string;
+export declare function corePath(...segments: string[]): string;
+export declare function unifiedHubPath(...segments: string[]): string;
+export declare function unifiedAdapterPath(slug: string, ...segments: string[]): string;
+export declare function knowledgePath(filename: string): string;
+/** Backward-compatible aliases */
+export declare const CORE_FRAMEWORK_DIR: string;
+export declare const UNIFIED_HUB_DIR: string;
+export declare const SKILLS_HUB_PATH: string;

package/dist/shared/src/modules/primitives/constants.js

@@ -0,0 +1,212 @@
+/**
+ * Atabey — Single Source of Truth for framework constants.
+ * Import from here instead of hardcoding paths, phases, or directory names.
+ */
+// ─── Framework identity ───────────────────────────────────────────────────────
+export const FRAMEWORK = {
+    NAME: "Atabey",
+    CORE_DIR: ".atabey",
+    UNIFIED_HUB_DIR: ".agents",
+    CONSTITUTION_FILE: "ATABEY.md",
+    DEFAULT_TRACE_ID: "T-000",
+    DEFAULT_PHASE: "PHASE_0",
+    DEFAULT_MANAGER_STATE: "ACTIVE",
+};
+export const PROJECT_PHASES = [
+    "PHASE_0",
+    "PHASE_1",
+    "PHASE_2",
+    "PHASE_3",
+    "PHASE_4",
+];
+// ─── Adapter platform directories (native / legacy) ───────────────────────────
+export const ADAPTER_DIRS = {
+    GEMINI: ".gemini",
+    CLAUDE: ".claude",
+    GROK: ".grok",
+    CURSOR: ".cursor",
+    CODEX: ".agents",
+    ANTIGRAVITY: ".agents",
+    LOCAL: ".atabey",
+    OPENCODE: ".opencode",
+    LEGACY_AGENT: ".agent",
+};
+/** Priority order for framework directory resolution (CLI + MCP).
+ *  De-duplicated: `.agents` serves both CODEX and ANTIGRAVITY, `.atabey` is also LOCAL. */
+export const FRAMEWORK_DIR_CANDIDATES = [
+    FRAMEWORK.CORE_DIR, // .atabey
+    ADAPTER_DIRS.CODEX, // .agents (codex + antigravity)
+    ADAPTER_DIRS.CLAUDE, // .claude
+    ADAPTER_DIRS.GEMINI, // .gemini
+    ADAPTER_DIRS.GROK, // .grok
+    ADAPTER_DIRS.CURSOR, // .cursor
+    ADAPTER_DIRS.OPENCODE, // .opencode
+];
+/** Slug under `.agents/{slug}/` for each adapter in unified mode. */
+export const UNIFIED_ADAPTER_SLUG = {
+    gemini: "gemini",
+    claude: "claude",
+    grok: "grok",
+    cursor: "cursor",
+    codex: "codex",
+    local: "local",
+    opencode: "opencode",
+    "antigravity-cli": "antigravity",
+};
+// ─── Native agent instruction paths (legacy tool compatibility) ───────────────
+export const NATIVE_AGENT_PATHS = {
+    gemini: pathJoin(ADAPTER_DIRS.GEMINI, "agents"),
+    claude: pathJoin(ADAPTER_DIRS.CLAUDE, "agents"),
+    grok: pathJoin(ADAPTER_DIRS.GROK, "agents"),
+    cursor: pathJoin(ADAPTER_DIRS.CURSOR, "rules"),
+    codex: pathJoin(ADAPTER_DIRS.CODEX, "instructions"),
+    local: pathJoin(ADAPTER_DIRS.LOCAL, "agents"),
+    opencode: pathJoin(ADAPTER_DIRS.OPENCODE, "agents"),
+    "antigravity-cli": pathJoin(ADAPTER_DIRS.ANTIGRAVITY, "agents"),
+};
+/** Legacy layout bases used by `check` and discovery (non-unified installs). */
+export const LEGACY_AGENT_LAYOUT_BASES = [
+    NATIVE_AGENT_PATHS.gemini,
+    NATIVE_AGENT_PATHS.claude,
+    NATIVE_AGENT_PATHS.cursor,
+    NATIVE_AGENT_PATHS.grok,
+    NATIVE_AGENT_PATHS.codex,
+    NATIVE_AGENT_PATHS.local,
+    NATIVE_AGENT_PATHS.opencode,
+    NATIVE_AGENT_PATHS["antigravity-cli"],
+];
+// ─── Framework internal subdirectories (under `.atabey/`) ──────────────────
+export const FRAMEWORK_SUBDIRS = {
+    AGENTS: "agents",
+    SKILLS: "skills",
+    KNOWLEDGE: "knowledge",
+    PROMPTS: "prompts",
+    MEMORY: "memory",
+    ROUTER: "router",
+    REGISTRY: "registry",
+    OBSERVABILITY: "observability",
+    RULES: "rules",
+    MESSAGES: "messages",
+    LOGS: "logs",
+    MEMORY_GRAPH: "memory-graph",
+};
+export const CORE_SCAFFOLD_SUBDIRS = [
+    FRAMEWORK_SUBDIRS.KNOWLEDGE,
+    FRAMEWORK_SUBDIRS.PROMPTS,
+    FRAMEWORK_SUBDIRS.MEMORY,
+    FRAMEWORK_SUBDIRS.ROUTER,
+    FRAMEWORK_SUBDIRS.REGISTRY,
+    FRAMEWORK_SUBDIRS.OBSERVABILITY,
+    FRAMEWORK_SUBDIRS.RULES,
+];
+export const RUNTIME_SUBDIRS = [
+    FRAMEWORK_SUBDIRS.MESSAGES,
+    FRAMEWORK_SUBDIRS.LOGS,
+    FRAMEWORK_SUBDIRS.MEMORY_GRAPH,
+];
+export const MEMORY_SUBDIRS = {
+    TASKS: "tasks",
+    HISTORY: "history",
+};
+export const MEMORY_FILES = {
+    STATE: "state.json",
+    STATUS: "status.json",
+    PROJECT_MEMORY: "PROJECT_MEMORY.md",
+    SHARED_FACTS: "shared-facts.json",
+};
+// ─── Monorepo default paths ───────────────────────────────────────────────────
+/** Default layout scaffolded into consumer projects after `atabey init`. */
+export const DEFAULT_CONSUMER_PATHS = {
+    backend: "apps/backend",
+    frontend: "apps/web",
+    mobile: "apps/mobile",
+    docs: "docs",
+    tests: "tests",
+};
+/** Paths inside the Atabey framework source monorepo (not consumer apps/). */
+export const FRAMEWORK_MONOREPO_PATHS = {
+    backend: "packages/atabey",
+    frontend: "apps/web",
+    mobile: "apps/mobile",
+    docs: "docs",
+    tests: "packages",
+};
+/** @deprecated Use DEFAULT_CONSUMER_PATHS */
+export const DEFAULT_MONOREPO_PATHS = DEFAULT_CONSUMER_PATHS;
+/** Cursor rule globs per agent role (framework monorepo layout). */
+export const CURSOR_AGENT_GLOBS = {
+    manager: "**/*",
+    security: "**/*",
+    architect: "**/*",
+    backend: `${DEFAULT_MONOREPO_PATHS.backend}/**/*`,
+    frontend: `${DEFAULT_MONOREPO_PATHS.frontend}/**/*`,
+    mobile: `${DEFAULT_MONOREPO_PATHS.mobile}/**/*`,
+    native: "apps/native/**/*",
+    database: `${DEFAULT_MONOREPO_PATHS.backend}/src/database/**/*`,
+    devops: "{.github,docker,infra,scripts,*.yml,*.yaml,Dockerfile*}",
+    quality: "**/*",
+    analyst: "{docs,specs,contracts}/**/*",
+    explorer: "**/*",
+    git: "**/*",
+};
+// ─── MCP & environment ──────────────────────────────────────────────────────
+export const MCP = {
+    SERVER_NAME: "atabey",
+    ROOT_CONFIG_FILE: "mcp.json",
+    PROJECT_ROOT_ENV: "ATABEY_PROJECT_ROOT",
+    TEST_DIR_ENV: "ATABEY_TEST_DIR",
+    TRANSPORT_ENV: "MCP_TRANSPORT",
+    /** IDE clients (Claude, Cursor, Gemini) spawn MCP via stdio JSON-RPC. */
+    TRANSPORT_STDIO: "stdio",
+    /** HTTP/SSE unified server for multi-session and remote clients. */
+    TRANSPORT_UNIFIED: "unified",
+    SERVER_DIST_PATH: "../atabey-mcp/dist/atabey-mcp/src/mcp/index.js",
+};
+/** Headless Hermes orchestrator (AgentLoop) — auto-starts with MCP server by default. */
+export const ORCHESTRATOR = {
+    AUTO_START_ENV: "ATABEY_AUTO_START_ORCHESTRATOR",
+    INTERVAL_MS_ENV: "ATABEY_ORCHESTRATOR_INTERVAL_MS",
+    DEFAULT_AUTO_START: true,
+    DEFAULT_INTERVAL_MS: 1000,
+};
+export const ROOT_CONFIG_FILES = {
+    MCP: MCP.ROOT_CONFIG_FILE,
+    DOT_MCP: ".mcp.json",
+    ENV_EXAMPLE: ".env.example",
+    VSCODE_MCP: ".vscode/mcp.json",
+};
+// ─── Shim template placeholders ───────────────────────────────────────────────
+export const TEMPLATE_PLACEHOLDERS = {
+    FRAMEWORK_DIR: "{{FRAMEWORK_DIR}}",
+    ADAPTER: "{{ADAPTER}}",
+    BACKEND_DIR: "{{BACKEND_DIR}}",
+    FRONTEND_DIR: "{{FRONTEND_DIR}}",
+    DOCS_DIR: "{{DOCS_DIR}}",
+    TESTS_DIR: "{{TESTS_DIR}}",
+};
+// ─── File extensions ─────────────────────────────────────────────────────────
+export const AGENT_FILE_EXT = {
+    MARKDOWN: ".md",
+    CURSOR_RULE: ".mdc",
+};
+// ─── Path helpers ─────────────────────────────────────────────────────────────
+export function pathJoin(...segments) {
+    return segments.filter(Boolean).join("/");
+}
+export function corePath(...segments) {
+    return [FRAMEWORK.CORE_DIR, ...segments.filter(Boolean)].join("/");
+}
+export function unifiedHubPath(...segments) {
+    return [FRAMEWORK.UNIFIED_HUB_DIR, ...segments.filter(Boolean)].join("/");
+}
+export function unifiedAdapterPath(slug, ...segments) {
+    return unifiedHubPath(slug, ...segments);
+}
+export function knowledgePath(filename) {
+    return corePath(FRAMEWORK_SUBDIRS.KNOWLEDGE, filename);
+}
+/** Backward-compatible aliases */
+export const CORE_FRAMEWORK_DIR = FRAMEWORK.CORE_DIR;
+export const UNIFIED_HUB_DIR = FRAMEWORK.UNIFIED_HUB_DIR;
+export const SKILLS_HUB_PATH = pathJoin(UNIFIED_HUB_DIR, FRAMEWORK_SUBDIRS.SKILLS);
+//# sourceMappingURL=constants.js.map

package/dist/shared/src/modules/primitives/constants.js.map

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

package/dist/shared/src/modules/primitives/errors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Enterprise Base Error class for the Atabey Framework.
+ */
+export declare class AtabeyBaseError extends Error {
+    readonly code: string;
+    readonly timestamp: Date;
+    readonly details?: unknown;
+    readonly solution?: string;
+    constructor(message: string, code?: string, details?: unknown, solution?: string);
+    /**
+     * Converts the error into a structured JSON log format.
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+        details: unknown;
+        solution: string | undefined;
+        stack: string | undefined;
+    };
+}
+/**
+ * Thrown when configuration loading or validation fails.
+ */
+export declare class ConfigurationError extends AtabeyBaseError {
+    constructor(message: string, details?: unknown, solution?: string);
+}
+/**
+ * Thrown when data schema or payload validation fails.
+ */
+export declare class ValidationError extends AtabeyBaseError {
+    constructor(message: string, details?: unknown, solution?: string);
+}
+/**
+ * Thrown when adapter initialization or execution fails.
+ */
+export declare class AdapterError extends AtabeyBaseError {
+    constructor(message: string, adapterId: string, details?: unknown, solution?: string);
+}
+/**
+ * Thrown when orchestration or agent communication fails.
+ */
+export declare class OrchestrationError extends AtabeyBaseError {
+    constructor(message: string, details?: unknown, solution?: string);
+}

package/dist/shared/src/modules/primitives/errors.js

@@ -0,0 +1,69 @@
+/**
+ * Enterprise Base Error class for the Atabey Framework.
+ */
+export class AtabeyBaseError extends Error {
+    code;
+    timestamp;
+    details;
+    solution;
+    constructor(message, code = "ATABEY_INTERNAL_ERROR", details, solution) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.timestamp = new Date();
+        this.details = details;
+        this.solution = solution;
+        // Ensure proper prototype chain and capture stack trace
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Converts the error into a structured JSON log format.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            timestamp: this.timestamp.toISOString(),
+            details: this.details,
+            solution: this.solution,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Thrown when configuration loading or validation fails.
+ */
+export class ConfigurationError extends AtabeyBaseError {
+    constructor(message, details, solution) {
+        super(message, "CONFIGURATION_ERROR", details, solution);
+    }
+}
+/**
+ * Thrown when data schema or payload validation fails.
+ */
+export class ValidationError extends AtabeyBaseError {
+    constructor(message, details, solution) {
+        super(message, "VALIDATION_ERROR", details, solution);
+    }
+}
+/**
+ * Thrown when adapter initialization or execution fails.
+ */
+export class AdapterError extends AtabeyBaseError {
+    constructor(message, adapterId, details, solution) {
+        super(`Adapter '${adapterId}' failure: ${message}`, "ADAPTER_ERROR", details, solution);
+    }
+}
+/**
+ * Thrown when orchestration or agent communication fails.
+ */
+export class OrchestrationError extends AtabeyBaseError {
+    constructor(message, details, solution) {
+        super(message, "ORCHESTRATION_ERROR", details, solution);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/shared/src/modules/primitives/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../../shared/src/modules/primitives/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACtB,IAAI,CAAS;IACb,SAAS,CAAO;IAChB,OAAO,CAAW;IAClB,QAAQ,CAAU;IAElC,YAAY,OAAe,EAAE,IAAI,GAAG,uBAAuB,EAAE,OAAiB,EAAE,QAAiB;QAC7F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED;;OAEG;IACI,MAAM;QACT,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;SACpB,CAAC;IACN,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACnD,YAAY,OAAe,EAAE,OAAiB,EAAE,QAAiB;QAC7D,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAChD,YAAY,OAAe,EAAE,OAAiB,EAAE,QAAiB;QAC7D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC7C,YAAY,OAAe,EAAE,SAAiB,EAAE,OAAiB,EAAE,QAAiB;QAChF,KAAK,CAAC,YAAY,SAAS,cAAc,OAAO,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5F,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACnD,YAAY,OAAe,EAAE,OAAiB,EAAE,QAAiB;QAC7D,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACJ"}

package/dist/shared/src/modules/primitives/fs.d.ts

@@ -0,0 +1,9 @@
+export declare function ensureDir(dirPath: string, dryRun?: boolean): void;
+/**
+ * Writes content to a file atomically by using a temporary file.
+ * This prevents data corruption during unexpected system failures.
+ */
+export declare function writeTextFile(filePath: string, content: string, dryRun?: boolean): void;
+export declare function appendFile(filePath: string, content: string, dryRun?: boolean): void;
+export declare function writeJsonFile(filePath: string, value: unknown, dryRun?: boolean): void;
+export declare function runCommandQuiet(command: string, args: string[], cwd: string): void;

package/dist/shared/src/modules/primitives/fs.js

@@ -0,0 +1,54 @@
+import { execFileSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import { logger } from "../observability/logger.js";
+export function ensureDir(dirPath, dryRun = false) {
+    if (!fs.existsSync(dirPath)) {
+        if (dryRun) {
+            logger.info(`[DRY RUN] Would create directory: ${dirPath}`);
+        }
+        else {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+    }
+}
+/**
+ * Writes content to a file atomically by using a temporary file.
+ * This prevents data corruption during unexpected system failures.
+ */
+export function writeTextFile(filePath, content, dryRun = false) {
+    if (dryRun) {
+        logger.info(`[DRY RUN] Would write file: ${filePath}`);
+        return;
+    }
+    const dir = path.dirname(filePath);
+    ensureDir(dir);
+    const tempPath = `${filePath}.${Math.random().toString(36).slice(2, 9)}.tmp`;
+    const finalContent = content.endsWith("\n") ? content : `${content}\n`;
+    try {
+        fs.writeFileSync(tempPath, finalContent, "utf8");
+        fs.renameSync(tempPath, filePath);
+    }
+    catch (err) {
+        if (fs.existsSync(tempPath))
+            fs.unlinkSync(tempPath);
+        throw err;
+    }
+}
+export function appendFile(filePath, content, dryRun = false) {
+    if (dryRun) {
+        logger.info(`[DRY RUN] Would append to file: ${filePath}`);
+        return;
+    }
+    ensureDir(path.dirname(filePath));
+    // Atomic append: oku → ekle → atomic yaz
+    const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf8") : "";
+    writeTextFile(filePath, existing + content);
+}
+export function writeJsonFile(filePath, value, dryRun = false) {
+    writeTextFile(filePath, JSON.stringify(value, null, 2), dryRun);
+}
+export function runCommandQuiet(command, args, cwd) {
+    execFileSync(command, args, { cwd, stdio: "ignore" });
+}
+//# sourceMappingURL=fs.js.map

package/dist/shared/src/modules/primitives/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../../../../shared/src/modules/primitives/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,MAAM,GAAG,KAAK;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACJ,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe,EAAE,MAAM,GAAG,KAAK;IAC3E,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;QACvD,OAAO;IACX,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,SAAS,CAAC,GAAG,CAAC,CAAC;IAEf,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IAC7E,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC;IAEvE,IAAI,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QACjD,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,GAAG,CAAC;IACd,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe,EAAE,MAAM,GAAG,KAAK;IACxE,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;QAC3D,OAAO;IACX,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClC,yCAAyC;IACzC,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAc,EAAE,MAAM,GAAG,KAAK;IAC1E,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,IAAc,EAAE,GAAW;IACxE,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC1D,CAAC"}