0xray 4.0.34 → 4.0.36

package/scripts/node/bridge-mcp-wiring.cjs

@@ -218,10 +218,69 @@ function readInstalledXrayVersion() {
   return pkg.version;
 }
 
+/**
+ * npm installs the package named `0xray` at `node_modules/0xray`.
+ * `node_modules/xray` is the pre-rename folder. Use it only when that tree
+ * is the one on disk. Never prefer the old name over the real install.
+ */
+const INSTALLED_PACKAGE_DIRS = ["0xray", "xray"];
+
+function normalizeLaunchToken(token) {
+  return String(token).replace(/\\/g, "/");
+}
+
 function localXrayCli(targetDir) {
   if (!targetDir) return null;
-  const cli = path.join(targetDir, "node_modules", "0xray", "dist", "cli", "index.js");
-  return fs.existsSync(cli) ? cli : null;
+  for (const dirName of INSTALLED_PACKAGE_DIRS) {
+    const cli = path.join(targetDir, "node_modules", dirName, "dist", "cli", "index.js");
+    if (fs.existsSync(cli)) return cli;
+  }
+  return null;
+}
+
+function isInstalledPackageCli(token) {
+  const normalized = normalizeLaunchToken(token);
+  return INSTALLED_PACKAGE_DIRS.some((dirName) =>
+    normalized.includes(`node_modules/${dirName}/dist/cli/index.js`),
+  );
+}
+
+/** Project-root `dist/cli/index.js` is the factory checkout. It is gitignored and goes stale. */
+function isCheckoutDistCliLaunch(server) {
+  return launchTokens(server).some((token) => {
+    const normalized = normalizeLaunchToken(token);
+    const isDistCli =
+      normalized === "dist/cli/index.js" ||
+      normalized === "./dist/cli/index.js" ||
+      normalized.endsWith("/dist/cli/index.js");
+    return isDistCli && !isInstalledPackageCli(normalized);
+  });
+}
+
+function isLegacyXrayCliLaunch(server) {
+  return launchTokens(server).some((token) => {
+    const normalized = normalizeLaunchToken(token);
+    return normalized.includes("node_modules/xray/dist/cli/index.js");
+  });
+}
+
+function mcpSubcommand(inner) {
+  if (!inner || !Array.isArray(inner.args)) return null;
+  const idx = inner.args.indexOf("mcp");
+  if (idx >= 0 && inner.args[idx + 1]) return inner.args[idx + 1];
+  return null;
+}
+
+/**
+ * A checkout `dist/cli` launch is replaced with the installed package.
+ * A legacy `node_modules/xray` launch is replaced only when `node_modules/0xray` exists.
+ */
+function shouldRepinToInstalledCli(inner, targetDir) {
+  if (!inner || hasVersionPin(inner)) return false;
+  if (isCheckoutDistCliLaunch(inner)) return true;
+  if (!isLegacyXrayCliLaunch(inner)) return false;
+  const cli = localXrayCli(targetDir);
+  return Boolean(cli && normalizeLaunchToken(cli).includes("/node_modules/0xray/"));
 }
 
 /** Prefer the installed CLI. Else pin npx to this package version. Never bare `0xray`. */
@@ -388,7 +447,7 @@ function mcpCmdFromInner(inner) {
   return inner.args.length > 0 ? inner.args[inner.args.length - 1] : null;
 }
 
-/** Framework fills gaps. User env, enabled/disabled, and version pins win. Unpinned `0xray` is repinned. Launch is `node mcp-launch.cjs --keep names -- cmd`. */
+/** Framework fills gaps. User env, enabled/disabled, and version pins win. Unpinned `0xray` and a checkout `dist/cli` launch are repinned to the installed package. Launch is `node mcp-launch.cjs --keep names -- cmd`. */
 function mergeUserWinsServer(framework, user, targetDir) {
   if (!user || typeof user !== "object") return framework;
   if (!framework || typeof framework !== "object") return user;
@@ -403,6 +462,10 @@ function mergeUserWinsServer(framework, user, targetDir) {
     const mcpCmd = mcpCmdFromInner(inner);
     if (mcpCmd) inner = pinnedMcpLaunch(targetDir, mcpCmd);
   }
+  if (inner && shouldRepinToInstalledCli(inner, targetDir)) {
+    const mcpCmd = mcpSubcommand(inner);
+    if (mcpCmd) inner = pinnedMcpLaunch(targetDir, mcpCmd);
+  }
   if (!inner) return framework;
   const mergedEnv = mergeScopedEnv([
     baseScopedEnv(targetDir),

package/scripts/node/install-bridges.cjs

@@ -228,10 +228,10 @@ function mergeOpencodeJson(targetDir, packageRoot, log) {
 }
 
 function grokHookShellCommand(packageRoot, scriptName, extraArgs) {
-  const script = path.join(packageRoot, "dist", "integrations", "grok", "hooks", scriptName);
+  const script = path.join(packageRoot, "scripts", "mjs", "run-grok-hook.mjs");
   const extra = extraArgs ? ` ${extraArgs}` : "";
   // JSON.stringify quotes so spaces/$ in install paths still exec (Grok fail-opens on crash).
-  return `XRAY_AI_PATH=${JSON.stringify(packageRoot)} node ${JSON.stringify(script)}${extra}`;
+  return `XRAY_AI_PATH=${JSON.stringify(packageRoot)} node ${JSON.stringify(script)} ${scriptName}${extra}`;
 }
 
 function patchGrokHookEntry(hook, packageRoot, targetDir, scriptName, extraArgs) {
@@ -260,7 +260,7 @@ function ensureGrokHookEvent(hooks, eventName) {
 function patchGrokHooks(pluginDir, packageRoot, targetDir, log, label) {
   const hooksDir = path.join(pluginDir, "hooks");
   const hooksPath = path.join(hooksDir, "hooks.json");
-  const hookScript = path.join(packageRoot, "dist", "integrations", "grok", "hooks", "pre-tool-use.js");
+  const hookScript = path.join(packageRoot, "scripts", "mjs", "run-grok-hook.mjs");
   if (!fs.existsSync(hooksPath)) {
     if (!fs.existsSync(hooksDir)) fs.mkdirSync(hooksDir, { recursive: true });
     if (!fs.existsSync(hooksPath)) return;

package/scripts/node/postinstall.cjs

@@ -75,7 +75,7 @@ function deployManagedAgents(packageRoot, targetDir, log) {
   if (updated !== current) fs.writeFileSync(agentsDest, updated);
 }
 
-/** npm install links vendored @0xray/repertoire and nothing else. The suit is `npx 0xray wear`. */
+/** npm install links vendored @0xray/repertoire and does not write `.mcp.json`. `npx 0xray wear` rewrites a checkout `dist/cli` launch to `node_modules/0xray`. */
 function runPostinstall(packageRoot, targetDir, _log) {
   linkVendoredRepertoire(packageRoot, targetDir);
   console.log("Run `npx 0xray wear`");

package/scripts/node/prepare-consumer.cjs

@@ -33,21 +33,25 @@ function updatePathsInFile(filePath) {
     let content = fs.readFileSync(filePath, 'utf-8');
     let updated = false;
 
-    // Transform development paths back to consumer paths (plain xray; legacy @0xray/xray removed)
-    // Only transform if it's not already a consumer path
-    if (content.includes('dist/plugin/mcps/') && !content.includes('node_modules/xray/dist/plugin/mcps/')) {
+    // The published package name is 0xray, so the installed tree is node_modules/0xray.
+    // Upgrade a pre-rename node_modules/xray path before prefixing bare dist/ paths.
+    if (content.includes('node_modules/xray/')) {
+      content = content.replace(/node_modules\/xray\//g, 'node_modules/0xray/');
+      updated = true;
+    }
+
+    if (content.includes('dist/plugin/mcps/') && !content.includes('node_modules/0xray/dist/plugin/mcps/')) {
       content = content.replace(
         /dist\/plugin\/mcps\//g,
-        'node_modules/xray/dist/plugin/mcps/'
+        'node_modules/0xray/dist/plugin/mcps/'
       );
       updated = true;
     }
 
-    // Transform plugin paths back to consumer format (only the relative dev paths)
     if (content.includes('../../../dist/plugin/')) {
       content = content.replace(
         /\.\.\/\.\.\/\.\.\/dist\/plugin\//g,
-        'node_modules/xray/dist/plugin/'
+        'node_modules/0xray/dist/plugin/'
       );
       updated = true;
     }
@@ -140,4 +144,4 @@ function addJsExtensionsToDist() {
 addJsExtensionsToDist();
 
 structuredLog('prepare-consumer', 'xray v2 Consumer Preparation: Complete!', 'success');
-structuredLog('prepare-consumer', 'Package is now ready for consumer installation (plain xray technical identity).', 'info');
+structuredLog('prepare-consumer', 'Package is now ready for consumer installation (node_modules/0xray).', 'info');

package/scripts/node/setup-dev.cjs

@@ -23,32 +23,24 @@ function updatePathsInFile(filePath) {
     let content = fs.readFileSync(filePath, 'utf-8');
     let updated = false;
 
-    // Transform MCP server paths (specific first)
-    if (content.includes('node_modules/xray/dist/plugin/mcps/')) {
-      content = content.replace(
-        /node_modules\/xray\/dist\/plugin\/mcps\//g,
-        'dist/plugin/mcps/'
-      );
-      updated = true;
-    }
-
-    // Transform plugin paths (go up 3 directories from .opencode to project root)
-    if (content.includes('node_modules/xray/dist/plugin/plugins/')) {
-      content = content.replace(
-        /node_modules\/xray\/dist\/plugin\/plugins\//g,
-        '../../../dist/plugin/plugins/'
-      );
-      updated = true;
-    }
-
-    // Transform any remaining node_modules paths (but not plugin-specific ones we already handled)
-    if (content.includes('node_modules/xray/dist/') &&
-        !content.includes('dist/plugin/')) {  // Avoid double transformation
-      content = content.replace(
-        /node_modules\/xray\/dist\//g,
-        'dist/'
-      );
-      updated = true;
+    // npm installs at node_modules/0xray. node_modules/xray is the pre-rename folder.
+    // Specific plugin paths first so the general dist/ strip does not flatten them.
+    for (const dirName of ['0xray', 'xray']) {
+      const plugins = `node_modules/${dirName}/dist/plugin/plugins/`;
+      if (content.includes(plugins)) {
+        content = content.replaceAll(plugins, '../../../dist/plugin/plugins/');
+        updated = true;
+      }
+      const mcps = `node_modules/${dirName}/dist/plugin/mcps/`;
+      if (content.includes(mcps)) {
+        content = content.replaceAll(mcps, 'dist/plugin/mcps/');
+        updated = true;
+      }
+      const prefix = `node_modules/${dirName}/dist/`;
+      if (content.includes(prefix)) {
+        content = content.replaceAll(prefix, 'dist/');
+        updated = true;
+      }
     }
 
     if (updated) {

package/scripts/node/validate-mcp-connectivity.js

@@ -18,7 +18,8 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 // Detect if running in consumer environment (node_modules)
-const isConsumerEnvironment = __dirname.includes("node_modules/xray");
+const isConsumerEnvironment = __dirname.includes(`${path.sep}node_modules${path.sep}0xray${path.sep}`)
+  || __dirname.includes(`${path.sep}node_modules${path.sep}xray${path.sep}`);
 const pathPrefix = isConsumerEnvironment ? "" : "";
 
 const MCP_SERVERS = [

package/src/integrations/grok/plugin/0xray/hooks/hooks.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/dist/integrations/grok/hooks/pre-tool-use.js\"",
+            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/scripts/mjs/run-grok-hook.mjs\" pre-tool-use.js",
             "timeout": 30
           }
         ]
@@ -16,7 +16,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/dist/integrations/grok/hooks/session-start.js\"",
+            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/scripts/mjs/run-grok-hook.mjs\" session-start.js",
             "timeout": 30
           }
         ]
@@ -27,7 +27,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/dist/integrations/grok/hooks/session-start.js\" --hook-event=user_prompt_submit",
+            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/scripts/mjs/run-grok-hook.mjs\" session-start.js --hook-event=user_prompt_submit",
             "timeout": 30
           }
         ]
@@ -38,7 +38,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/dist/integrations/grok/hooks/post-tool-use.js\"",
+            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/scripts/mjs/run-grok-hook.mjs\" post-tool-use.js",
             "timeout": 30
           }
         ]
@@ -49,7 +49,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/dist/integrations/grok/hooks/session-start.js\" --hook-event=pre_compact",
+            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/scripts/mjs/run-grok-hook.mjs\" session-start.js --hook-event=pre_compact",
             "timeout": 30
           }
         ]
@@ -60,7 +60,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/dist/integrations/grok/hooks/session-start.js\" --hook-event=post_compact",
+            "command": "XRAY_AI_PATH=\"${XRAY_AI_PATH:-node_modules/0xray}\" node \"${XRAY_AI_PATH:-node_modules/0xray}/scripts/mjs/run-grok-hook.mjs\" session-start.js --hook-event=post_compact",
             "timeout": 30
           }
         ]

package/src/integrations/openclaw/plugin/xray-pre-tool/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xray-pre-tool",
-  "version": "4.0.34",
+  "version": "4.0.36",
   "private": true,
   "type": "module",
   "description": "0xRay constitution + temperament PreToolUse for OpenClaw",

package/src/mcps/knowledge-skills/storyteller.server.ts

@@ -24,7 +24,6 @@ interface WriteStoryArgs {
 function resolveSkillMd(): string {
   const here = dirname(fileURLToPath(import.meta.url));
   const candidates = [
-    join(here, '../../../skills/storyteller/SKILL.md'),
     join(here, '../../skills/storyteller/SKILL.md'),
     join(process.cwd(), 'node_modules/0xray/dist/skills/storyteller/SKILL.md'),
     join(process.cwd(), 'node_modules/xray/dist/skills/storyteller/SKILL.md'),

package/xray/agents_template.md

@@ -30,14 +30,14 @@ All seven use `npx -y 0xray mcp <cmd>`:
 
 xray operates under the three-subsystem model: Inference + External Governance (Dynamo Solar SSOT) + Autonomous Engine (thinDispatch 7-flow in MCP orchestrator). All actions are validated against the Universal Development Codex before execution.
 
-**Codex**: `.xray/codex.json` — **69 terms** across all agent interactions.
+**Codex**: `.xray/codex.json` — **70 terms** across all agent interactions.
 
 ## thinDispatch Routing
 
-- Simple (≤15): Single agent
-- Moderate (≤25): Single agent with tools
-- Complex (≤50): Multi-agent coordination
-- Enterprise (>50): Orchestrator-led team
+- Simple (≤15): single-agent
+- Moderate (≤25): multi-agent
+- Complex (≤50): orchestrator-led
+- Enterprise (>50): orchestrator-led
 
 ## File Organization
 

package/xray/codex.json

@@ -1,6 +1,6 @@
 {
   "version": "3.1.0",
-  "lastUpdated": "2026-08-24",
+  "lastUpdated": "2026-10-01",
   "errorPreventionTarget": 0.998,
   "terms": {
     "1": {
@@ -62,7 +62,7 @@
     "8": {
       "number": 8,
       "title": "Prevent Infinite Loops",
-      "description": "Guarantee termination in all iterative processes. All loops must have clear termination conditions. Recursive functions must have base cases. Event loops must have exit strategies. Async operations must have timeout mechanisms.",
+      "description": "Guarantee termination in all iterative processes. All loops must have clear termination conditions. Recursive functions must have base cases. Event loops must have exit strategies. Async operations must have timeout mechanisms. A job names when it is done and when it stops.",
       "category": "core",
       "zeroTolerance": true,
       "enforcementLevel": "blocking"
@@ -230,7 +230,7 @@
     "29": {
       "number": 29,
       "title": "Security by Design",
-      "description": "Validate all inputs. Sanitize data before rendering. Use HTTPS for all requests. Implement rate limiting. Never expose sensitive data.",
+      "description": "Validate all inputs. Sanitize data before rendering. Use HTTPS for all requests. Implement rate limiting. Never expose sensitive data. Do not trust Host or X-Forwarded-Host to choose an environment. A refusal in the UI needs the same check on the server.",
       "category": "security",
       "zeroTolerance": true,
       "enforcementLevel": "blocking"
@@ -534,7 +534,7 @@
     "67": {
       "number": 67,
       "title": "Use Best Subagents, Reuse Session Context",
-      "description": "Delegate work to the best-suited subagent for each task. Stay responsive to user inquiries, additional todos, and course corrections. Reuse the same subagent via session ID to preserve context and avoid restarting from zero. Do not spawn fresh agents when an existing one has the relevant context.",
+      "description": "Delegate work to the best-suited subagent for each task. Stay responsive to user inquiries, additional todos, and course corrections. Reuse the same subagent via session ID to preserve context and avoid restarting from zero. Do not spawn fresh agents when an existing one has the relevant context. Reuse one cloud for a workstream. Do not launch a new agent for a check the seat can run.",
       "category": "process",
       "zeroTolerance": false,
       "enforcementLevel": "high"
@@ -554,6 +554,14 @@
       "category": "process",
       "zeroTolerance": true,
       "enforcementLevel": "blocking"
+    },
+    "70": {
+      "number": 70,
+      "title": "Current Copy Before Edits",
+      "description": "Before an edit, be on the latest main and run the current package. If this repo is 0xray, this repo is that package. An older package waits. Compare set-aside work to main before you throw it away.",
+      "category": "process",
+      "zeroTolerance": true,
+      "enforcementLevel": "blocking"
     }
   },
   "interweaves": [

package/xray/features.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./features.schema.json",
-  "version": "4.0.34",
+  "version": "4.0.36",
   "description": "0xRay Framework - Unified Feature Configuration",
   "suit_temperament": {
     "profile": "auto",

package/dist/agents/known-names.d.ts

@@ -1,26 +0,0 @@
-/**
- * Known Names — Single combined vocabulary for agent names, skill names,
- * system service names, and opencode built-in types. All consumers import
- * from here instead of defining their own hardcoded lists.
- *
- * Imports:
- *   - registry.ts (AGENT_REGISTRY, AGENT_KEYS) — canonical agent definitions
- *   - mcps/index.ts (MCP_SERVERS) — canonical MCP server manifest
- */
-import { AGENT_KEYS, type AgentKey } from "./registry.js";
-import { MCP_SERVERS } from "../mcps/index.js";
-export { AGENT_KEYS, type AgentKey };
-export type { AgentKey as AgentName };
-/** All agent names as a mutable array */
-export declare function getAgentNames(): string[];
-export declare const SYSTEM_SERVICE_NAMES: readonly ["enforcer", "orchestrator", "analyzer"];
-export declare const OPENCODE_BUILTIN_TYPES: readonly ["explore", "general"];
-export declare const ALL_KNOWN_NAMES: readonly [...string[], "enforcer", "orchestrator", "analyzer", "explore", "general"];
-export type KnownName = typeof ALL_KNOWN_NAMES[number];
-export declare const BOOT_AGENTS: readonly ["enforcer", "architect", "bug-triage-specialist", "code-reviewer", "security-auditor", "refactorer", "testing-lead"];
-export declare function isValidType(name: string): boolean;
-export declare const AGENT_TO_SKILL_MAP: Record<string, string>;
-/** Resolve agent name to skill name via alias map, fallback to identity */
-export declare function resolveSkill(agentOrSkill: string): string;
-export { MCP_SERVERS };
-export declare function getSkillNames(): string[];

package/dist/agents/known-names.js

@@ -1,72 +0,0 @@
-/**
- * Known Names — Single combined vocabulary for agent names, skill names,
- * system service names, and opencode built-in types. All consumers import
- * from here instead of defining their own hardcoded lists.
- *
- * Imports:
- *   - registry.ts (AGENT_REGISTRY, AGENT_KEYS) — canonical agent definitions
- *   - mcps/index.ts (MCP_SERVERS) — canonical MCP server manifest
- */
-import { AGENT_KEYS } from "./registry.js";
-import { MCP_SERVERS } from "../mcps/index.js";
-// ── Agent names (from SSOT) ──
-export { AGENT_KEYS };
-/** All agent names as a mutable array */
-export function getAgentNames() {
-    return [...AGENT_KEYS];
-}
-// ── System service names (not in AGENT_REGISTRY) ──
-export const SYSTEM_SERVICE_NAMES = [
-    "enforcer",
-    "orchestrator",
-    "analyzer",
-];
-// ── Opencode CLI built-in types ──
-export const OPENCODE_BUILTIN_TYPES = [
-    "explore",
-    "general",
-];
-// ── Combined vocabulary ──
-export const ALL_KNOWN_NAMES = [
-    ...AGENT_KEYS,
-    ...SYSTEM_SERVICE_NAMES,
-    ...OPENCODE_BUILTIN_TYPES,
-];
-// ── Boot-priority agents (loaded first by boot-orchestrator) ──
-export const BOOT_AGENTS = [
-    "enforcer",
-    "architect",
-    "bug-triage-specialist",
-    "code-reviewer",
-    "security-auditor",
-    "refactorer",
-    "testing-lead",
-];
-// ── Validation ──
-export function isValidType(name) {
-    return ALL_KNOWN_NAMES.includes(name);
-}
-// ── Agent → Skill alias map (single source) ──
-export const AGENT_TO_SKILL_MAP = {
-    "architect": "architecture-patterns",
-    "backend-engineer": "api-design",
-    "code-reviewer": "code-review",
-    "database-engineer": "database-design",
-    "devops-engineer": "devops-deployment",
-    "mobile-developer": "mobile-development",
-    "performance-engineer": "performance-optimization",
-    "security-auditor": "security-audit",
-    "testing-lead": "testing-strategy",
-    "tech-writer": "documentation-generation",
-    "frontend-ui-ux-engineer": "ui-ux-design",
-    "frontend-engineer": "project-analysis",
-};
-/** Resolve agent name to skill name via alias map, fallback to identity */
-export function resolveSkill(agentOrSkill) {
-    return AGENT_TO_SKILL_MAP[agentOrSkill] || agentOrSkill;
-}
-// ── MCP server names (for consumers that need them) ──
-export { MCP_SERVERS };
-export function getSkillNames() {
-    return MCP_SERVERS.map(s => s.serverName);
-}

package/dist/analytics/consent-manager.d.ts

@@ -1,92 +0,0 @@
-/**
- * Consent Manager for 0xRay Central Analytics
- *
- * Manages user consent for analytics data submission with granular
- * control over what categories can be shared.
- *
- * @since 2026-03-06
- */
-export interface ConsentConfiguration {
-    analyticsEnabled: boolean;
-    consentDate: Date;
-    consentVersion: string;
-    lastOptOut: Date | undefined;
-    categories: {
-        reflections: boolean;
-        logs: boolean;
-        metrics: boolean;
-        patterns: boolean;
-    };
-    projectId: string;
-}
-export interface ConsentCategory {
-    name: string;
-    description: string;
-    enabled: boolean;
-}
-export declare class ConsentManager {
-    private configPath;
-    private config;
-    private submissionQueue;
-    constructor(configPath?: string | undefined);
-    /**
-     * Initialize consent manager - load existing config or create default
-     */
-    initialize(): Promise<ConsentConfiguration>;
-    /**
-     * Enable analytics (opt-in)
-     */
-    enableConsent(categories?: string[]): Promise<void>;
-    /**
-     * Disable analytics (opt-out)
-     */
-    disableConsent(): Promise<void>;
-    /**
-     * Check if submission is allowed for a category
-     */
-    canSubmit(category: string): boolean;
-    /**
-     * Get current consent status
-     */
-    getStatus(): Promise<ConsentConfiguration>;
-    /**
-     * Enable specific category
-     */
-    enableCategory(category: string): Promise<void>;
-    /**
-     * Disable specific category
-     */
-    disableCategory(category: string): Promise<void>;
-    /**
-     * Get all categories with their status
-     */
-    getCategories(): ConsentCategory[];
-    /**
-     * Generate anonymous project ID
-     */
-    private generateProjectId;
-    /**
-     * Create default disabled configuration
-     */
-    private createDefaultConfig;
-    /**
-     * Load configuration from file
-     */
-    private loadConfig;
-    /**
-     * Save configuration to file
-     */
-    private saveConfig;
-    /**
-     * Clear submission queue
-     */
-    private clearSubmissionQueue;
-    /**
-     * Add item to submission queue
-     */
-    queueSubmission(data: unknown): Promise<void>;
-    /**
-     * Save submission queue to file
-     */
-    private saveSubmissionQueue;
-}