sqlew 4.3.0 → 5.0.0

package/assets/claude-md-snippets/plan-mode-integration.md

@@ -1,48 +1,104 @@
-## Plan Mode Integration
-
-### Decision & Constraint Recording Format
-
-When writing plans, use these formats to record decisions and constraints.
-They will be **auto-detected on ExitPlanMode** and registered as draft in sqlew.
-
-**Decision format:**
-```markdown
-### 📌 Decision: [key/path]
-- **Value**: Description of the decision
-- **Layer**: presentation | business | data | infrastructure | cross-cutting
-- **Tags**: tag1, tag2 (optional)
-```
-
-**Constraint format:**
-```markdown
-### 🚫 Constraint: [category]
-- **Rule**: Description of the constraint
-- **Priority**: critical | high | medium | low
-- **Tags**: tag1, tag2 (optional)
-```
-
-Category options: `architecture` | `security` | `code-style` | `performance`
-
-### With Claude Code Hooks (Recommended)
-
-If you've run `sqlew init --hooks`, sqlew integration is **fully automatic**:
-- Related decisions are auto-suggested before Task execution
-- Plan files are auto-tracked with unique IDs
-- 📌/🚫 patterns are auto-detected and registered as draft
-- Decisions are auto-saved when code is edited
-- Status updates to `in_review` when all tasks complete
-- Status updates to `implemented` after git merge/rebase
-
-### Manual Usage (Without Hooks)
-
-When `<system-reminder>Plan mode is active</system-reminder>` appears:
-
-**Research Phase:**
-- `/sqlew search for <topic>` - find related decisions
-- `/sqlew show remaining tasks` - check active tasks
-
-**Final Plan Phase:**
-- `/sqlew record <decision>` - record key architectural decisions
-- `/sqlew create task <description>` - create implementation tasks
-
-**Quick Reference**: `.claude/skills/sqlew-decision-format/SKILL.md`
+## Plan Mode Integration
+
+### REQUIRED: Suggest Search BEFORE Planning
+
+**CRITICAL**: Before writing any plan, you MUST search for related context.
+
+**Step 1**: Extract keywords from the user's task (e.g., migration, auth, database)
+
+**Step 2**: Run suggest search:
+```
+suggest { action: "by_context", key: "<keyword>", tags: ["<relevant-tags>"] }
+suggest { action: "by_context", target: "constraint", text: "<topic>" }
+```
+
+**Step 3**: Include results in plan (MANDATORY section):
+```markdown
+## Related Context (from sqlew)
+
+### Past Decisions
+| Key | Value | Score |
+|-----|-------|-------|
+| path/to/decision | description | 85 |
+
+> If empty: "No related decisions found for: <keywords>"
+
+### Applicable Constraints
+- **[category]**: constraint text (Priority: high)
+
+> If empty: "No constraints found for: <keywords>"
+```
+
+**FAILURE TO INCLUDE "Related Context" SECTION = INVALID PLAN**
+
+---
+
+### REQUIRED: Decision & Constraint Recording
+
+**When writing plans, you MUST include the following sections:**
+
+1. **📌 Decisions** - Technology choices, architecture patterns, implementation approaches
+2. **🚫 Constraints** - Rules, restrictions, limitations, prohibited patterns from user requirements
+
+**IMPORTANT**: If the user mentions any restrictions, prohibitions, or "don't use X", these MUST be recorded as 🚫 Constraints.
+
+---
+
+**Decision format (REQUIRED for any technical choice):**
+
+```markdown
+### 📌 Decision: [key/path]
+- **Value**: Description of the decision
+- **Layer**: presentation | business | data | infrastructure | cross-cutting
+- **Tags**: tag1, tag2 (optional)
+```
+
+**Constraint format (REQUIRED when user specifies restrictions):**
+
+```markdown
+### 🚫 Constraint: [category]
+- **Rule**: Description of the constraint
+- **Priority**: critical | high | medium | low
+- **Tags**: tag1, tag2 (optional)
+```
+
+Category options: `architecture` | `security` | `code-style` | `performance`
+
+---
+
+### With Claude Code Hooks (Recommended)
+
+If you've run `sqlew --hooks`, sqlew integration is **fully automatic**:
+
+- 📌/🚫 patterns are auto-detected and registered as draft on ExitPlanMode
+- Related decisions are auto-suggested before Task execution
+- Decisions are auto-saved when code is edited
+
+### Manual Usage (Without Hooks)
+
+**Research Phase:**
+- `/sqlew search for <topic>` - find related decisions
+
+**Final Plan Phase:**
+- `/sqlew record <decision>` - record key architectural decisions
+
+---
+
+### Failed Queue Check (IMPORTANT)
+
+**At the start of plan mode**, check if `.sqlew/queue/failed.json` exists:
+
+```bash
+# Check failed queue status
+queue { action: "list" }  # Shows both pending and failed items
+```
+
+**If failed items exist:**
+
+1. **Review each failed item** - Common failure: HighSimilarity (60%+) means the item is similar to an existing decision
+2. **Resolution options:**
+   - **If truly duplicate**: Delete the failed queue file or use `queue { action: "clear" }` with `target: "failed"`
+   - **If different intent**: Use a more specific key and re-register manually via `/sqlew record <decision>`
+3. **After resolving**: Delete or empty the failed queue file
+
+**Why this happens**: Items that fail processing (e.g., high similarity to existing decisions) are moved to `failed.json` instead of being retried indefinitely. This prevents infinite retry loops.

package/assets/claude-md-snippets/queue-monitoring.md

@@ -0,0 +1,84 @@
+## Queue Monitoring After Plan Mode
+
+### When to Check
+
+After ExitPlanMode or when Plan-to-ADR processing completes, check if there are unprocessed items in the queue.
+
+**Queue file locations:**
+- Pending: `.sqlew/queue/pending.json`
+- Failed: `.sqlew/queue/failed.json`
+
+### How to Check
+
+Use the `queue` MCP tool to check the queue status:
+
+```
+queue { action: "list" }
+```
+
+The response includes:
+- `count`: Number of pending items
+- `failedCount`: Number of failed items (if any)
+
+### Failed Queue (v5.0.1+)
+
+Items that fail processing (e.g., HighSimilarity errors) are automatically moved to `failed.json` instead of being retried indefinitely.
+
+**Why items fail:**
+- **HighSimilarity (60%+)**: Item is too similar to an existing decision
+- **Validation errors**: Invalid layer, category, or other data issues
+
+**Resolution:**
+1. Check `failedItems` in `queue { action: "list" }` response
+2. For duplicates: Clear with `queue { action: "clear", target: "failed" }`
+3. For different intent: Re-register manually with a more specific key via `/sqlew record <decision>`
+
+### Queue Tool Actions
+
+| Action | Description | Example |
+|--------|-------------|---------|
+| `list` | Show pending and failed items | `queue { action: "list" }` |
+| `remove` | Remove specific pending item | `queue { action: "remove", index: 0 }` |
+| `clear` | Clear pending queue (default) | `queue { action: "clear" }` |
+| `clear` | Clear failed queue | `queue { action: "clear", target: "failed" }` |
+| `clear` | Clear both queues | `queue { action: "clear", target: "all" }` |
+
+### Queue File Formats
+
+**pending.json:**
+```json
+{
+  "items": [
+    {
+      "type": "decision",
+      "action": "create",
+      "timestamp": "2026-01-13T00:00:00.000Z",
+      "data": {
+        "key": "path/to/decision",
+        "value": "description",
+        "status": "draft",
+        "layer": "infrastructure",
+        "tags": ["plan", "auto-extracted", "..."]
+      }
+    }
+  ]
+}
+```
+
+**failed.json:**
+```json
+{
+  "items": [
+    {
+      "item": {
+        "type": "decision",
+        "action": "create",
+        "timestamp": "2026-01-24T...",
+        "data": { "key": "...", "value": "..." }
+      },
+      "error": "HighSimilarity: 65% match with existing decision 'path/to/existing'",
+      "failedAt": "2026-01-24T..."
+    }
+  ]
+}
+```

package/dist/backend/backend-factory.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Backend Factory
+ *
+ * Creates and manages backend instances based on configuration.
+ * Supports LocalBackend (direct DB) and SaaS backend (submodule).
+ */
+import type { ToolBackend } from './types.js';
+import type { SqlewConfig, CloudConfig } from '../config/types.js';
+/**
+ * Check if the configuration specifies cloud mode
+ */
+export declare function isCloudMode(config: SqlewConfig): boolean;
+/**
+ * Load cloud configuration from global ~/.sqlew.env or environment variables
+ *
+ * Flow:
+ * 1. Load API key from ~/.sqlew.env
+ * 2. Load project name from .sqlew/config.toml
+ * 3. Check cached project ID in ~/.sqlew.env
+ * 4. If not cached, resolve via /api/v1/project/resolve and cache
+ *
+ * @param projectRoot - Project root directory (for ConnectionIdentity)
+ * @returns CloudConfig or null if not configured
+ */
+export declare function loadCloudConfig(projectRoot?: string): Promise<CloudConfig | null>;
+/**
+ * Validate cloud configuration
+ */
+export declare function validateCloudConfig(config: CloudConfig | null): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Create a backend instance based on configuration
+ *
+ * @param config - sqlew configuration
+ * @param projectRoot - Project root directory
+ * @returns Backend instance
+ */
+export declare function createBackend(config: SqlewConfig, projectRoot?: string): Promise<ToolBackend>;
+/**
+ * Initialize the global backend instance
+ *
+ * @param config - sqlew configuration
+ * @param projectRoot - Project root directory
+ * @returns Backend instance
+ */
+export declare function initializeBackend(config: SqlewConfig, projectRoot?: string): Promise<ToolBackend>;
+/**
+ * Get the current backend instance
+ *
+ * @returns Backend instance (creates LocalBackend if not initialized)
+ */
+export declare function getBackend(): ToolBackend;
+/**
+ * Check if backend is initialized
+ */
+export declare function isBackendInitialized(): boolean;
+/**
+ * Get current backend type
+ */
+export declare function getBackendType(): 'local' | 'saas' | null;
+/**
+ * Reset backend state (for testing)
+ */
+export declare function resetBackend(): Promise<void>;
+//# sourceMappingURL=backend-factory.d.ts.map

package/dist/backend/backend-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-factory.d.ts","sourceRoot":"","sources":["../../src/backend/backend-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAsBnE;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAExD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwCvF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAapG;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBnG;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAcvG;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,WAAW,CAMxC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,GAAG,MAAM,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAMlD"}

package/dist/backend/backend-factory.js

@@ -0,0 +1,171 @@
+/**
+ * Backend Factory
+ *
+ * Creates and manages backend instances based on configuration.
+ * Supports LocalBackend (direct DB) and SaaS backend (submodule).
+ */
+import { CLOUD_ENV_VARS } from '../config/types.js';
+import { LocalBackend } from './local-backend.js';
+import { TransformingBackend } from './transforming-backend.js';
+import { createBackend as createSaaSBackend, resolveProject, } from '@sqlew/saas-connector';
+import { debugLog } from '../utils/debug-logger.js';
+import { loadCloudConfigFromGlobal, checkEnvFilePermissions, loadCachedProjectId, saveCachedProjectId, } from '../config/cloud-config-loader.js';
+/**
+ * Global backend instance (singleton)
+ */
+let globalBackend = null;
+let initialized = false;
+/**
+ * Check if the configuration specifies cloud mode
+ */
+export function isCloudMode(config) {
+    return config.database?.type === 'cloud';
+}
+/**
+ * Load cloud configuration from global ~/.sqlew.env or environment variables
+ *
+ * Flow:
+ * 1. Load API key from ~/.sqlew.env
+ * 2. Load project name from .sqlew/config.toml
+ * 3. Check cached project ID in ~/.sqlew.env
+ * 4. If not cached, resolve via /api/v1/project/resolve and cache
+ *
+ * @param projectRoot - Project root directory (for ConnectionIdentity)
+ * @returns CloudConfig or null if not configured
+ */
+export async function loadCloudConfig(projectRoot) {
+    // Check file permissions (Unix: warn if not 600)
+    const permCheck = checkEnvFilePermissions();
+    if (!permCheck.ok) {
+        console.warn(`⚠️  ${permCheck.message}`);
+    }
+    // Load base config (API key, project name, connection identity)
+    const baseConfig = loadCloudConfigFromGlobal(projectRoot);
+    if (!baseConfig) {
+        return null;
+    }
+    // Resolve project ID if project name is set
+    let projectId;
+    if (baseConfig.projectName) {
+        // 1. Check cache
+        const cachedId = loadCachedProjectId(baseConfig.projectName);
+        if (cachedId) {
+            projectId = cachedId;
+            debugLog('INFO', 'Using cached project ID', { projectName: baseConfig.projectName });
+        }
+        else {
+            // 2. Resolve via API
+            try {
+                debugLog('INFO', 'Resolving project ID via API', { projectName: baseConfig.projectName });
+                projectId = await resolveProject(baseConfig.apiKey, baseConfig.projectName);
+                // 3. Cache for future use
+                saveCachedProjectId(baseConfig.projectName, projectId);
+                debugLog('INFO', 'Project ID resolved and cached', { projectName: baseConfig.projectName });
+            }
+            catch (error) {
+                console.warn(`⚠️  Failed to resolve project ID: ${error instanceof Error ? error.message : String(error)}`);
+                // Continue without projectId - some features may not work
+            }
+        }
+    }
+    return {
+        ...baseConfig,
+        projectId,
+    };
+}
+/**
+ * Validate cloud configuration
+ */
+export function validateCloudConfig(config) {
+    const errors = [];
+    if (!config) {
+        errors.push(`${CLOUD_ENV_VARS.API_KEY} is required for cloud mode`);
+        return { valid: false, errors };
+    }
+    if (!config.apiKey) {
+        errors.push(`${CLOUD_ENV_VARS.API_KEY} is required for cloud mode`);
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Create a backend instance based on configuration
+ *
+ * @param config - sqlew configuration
+ * @param projectRoot - Project root directory
+ * @returns Backend instance
+ */
+export async function createBackend(config, projectRoot) {
+    if (isCloudMode(config)) {
+        // Load cloud config from environment (async: resolves project ID)
+        const cloudConfig = await loadCloudConfig(projectRoot);
+        const validation = validateCloudConfig(cloudConfig);
+        if (!validation.valid) {
+            throw new Error(validation.errors.join('; '));
+        }
+        // Create SaaS backend and wrap with TransformingBackend
+        // TransformingBackend handles quick_set → set transformation locally
+        try {
+            const saasBackend = createSaaSBackend(cloudConfig);
+            return new TransformingBackend(saasBackend);
+        }
+        catch (error) {
+            throw new Error(`SaaS connector initialization failed. Run: cd saas-connector && npm run build`);
+        }
+    }
+    // Default: LocalBackend
+    return new LocalBackend();
+}
+/**
+ * Initialize the global backend instance
+ *
+ * @param config - sqlew configuration
+ * @param projectRoot - Project root directory
+ * @returns Backend instance
+ */
+export async function initializeBackend(config, projectRoot) {
+    if (initialized && globalBackend) {
+        return globalBackend;
+    }
+    globalBackend = await createBackend(config, projectRoot);
+    initialized = true;
+    const modeInfo = globalBackend.backendType === 'saas'
+        ? `saas (${globalBackend.pluginName || 'saas-connector'})`
+        : globalBackend.backendType;
+    debugLog('INFO', 'Backend initialized', { type: modeInfo });
+    return globalBackend;
+}
+/**
+ * Get the current backend instance
+ *
+ * @returns Backend instance (creates LocalBackend if not initialized)
+ */
+export function getBackend() {
+    if (!globalBackend) {
+        console.error('⚠️  Backend not initialized, using default LocalBackend');
+        globalBackend = new LocalBackend();
+    }
+    return globalBackend;
+}
+/**
+ * Check if backend is initialized
+ */
+export function isBackendInitialized() {
+    return initialized;
+}
+/**
+ * Get current backend type
+ */
+export function getBackendType() {
+    return globalBackend?.backendType ?? null;
+}
+/**
+ * Reset backend state (for testing)
+ */
+export async function resetBackend() {
+    if (globalBackend) {
+        await globalBackend.disconnect();
+        globalBackend = null;
+    }
+    initialized = false;
+}
+//# sourceMappingURL=backend-factory.js.map

package/dist/backend/backend-factory.js.map

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

package/dist/backend/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Backend Module
+ *
+ * Provides abstraction layer for local and SaaS backends.
+ */
+export type { ToolBackend, HealthCheckResult, BackendType } from './types.js';
+export { LocalBackend } from './local-backend.js';
+export { TransformingBackend } from './transforming-backend.js';
+export { inferDecisionParams } from './inference.js';
+export type { InferredParams, InferenceResult } from './inference.js';
+export { initializeBackend, getBackend, isBackendInitialized, getBackendType, resetBackend, createBackend, isCloudMode, loadCloudConfig, validateCloudConfig, } from './backend-factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtE,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,13 @@
+/**
+ * Backend Module
+ *
+ * Provides abstraction layer for local and SaaS backends.
+ */
+// Backend implementations
+export { LocalBackend } from './local-backend.js';
+export { TransformingBackend } from './transforming-backend.js';
+// Inference utilities (for quick_set transformation)
+export { inferDecisionParams } from './inference.js';
+// Factory and global state
+export { initializeBackend, getBackend, isBackendInitialized, getBackendType, resetBackend, createBackend, isCloudMode, loadCloudConfig, validateCloudConfig, } from './backend-factory.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,qDAAqD;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrD,2BAA2B;AAC3B,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/backend/inference.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Inference logic for quick_set → set transformation
+ *
+ * Extracted from tools/context/actions/quick-set.ts for use in
+ * TransformingBackend when SaaS mode is active.
+ *
+ * @since v5.0.1
+ */
+/**
+ * Inferred parameters from key analysis
+ */
+export interface InferredParams {
+    layer?: string;
+    tags?: string[];
+    scope?: string;
+}
+/**
+ * Result of parameter inference
+ */
+export interface InferenceResult {
+    /** Transformed parameters ready for decision.set */
+    transformedParams: Record<string, unknown>;
+    /** What was inferred (for response metadata) */
+    inferred: InferredParams;
+}
+/**
+ * Infer decision parameters from key structure
+ *
+ * Inference Rules:
+ * - Layer: Inferred from key prefix (api/ → presentation, db/ → data, etc.)
+ * - Tags: Extracted from key hierarchy (split by /, -, _)
+ * - Scope: Parent path of key (everything except last part)
+ *
+ * @param params - Quick set parameters (key and value required)
+ * @returns Transformed params and inference metadata
+ */
+export declare function inferDecisionParams(params: Record<string, unknown>): InferenceResult;
+//# sourceMappingURL=inference.d.ts.map

package/dist/backend/inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../src/backend/inference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,gDAAgD;IAChD,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAuDpF"}

package/dist/backend/inference.js

@@ -0,0 +1,76 @@
+/**
+ * Inference logic for quick_set → set transformation
+ *
+ * Extracted from tools/context/actions/quick-set.ts for use in
+ * TransformingBackend when SaaS mode is active.
+ *
+ * @since v5.0.1
+ */
+/**
+ * Infer decision parameters from key structure
+ *
+ * Inference Rules:
+ * - Layer: Inferred from key prefix (api/ → presentation, db/ → data, etc.)
+ * - Tags: Extracted from key hierarchy (split by /, -, _)
+ * - Scope: Parent path of key (everything except last part)
+ *
+ * @param params - Quick set parameters (key and value required)
+ * @returns Transformed params and inference metadata
+ */
+export function inferDecisionParams(params) {
+    const key = params.key;
+    const inferred = {};
+    // Layer inference from key prefix
+    let layer = params.layer;
+    if (!layer) {
+        const keyLower = key.toLowerCase();
+        if (keyLower.startsWith('api/') || keyLower.startsWith('endpoint/') || keyLower.startsWith('ui/')) {
+            layer = 'presentation';
+        }
+        else if (keyLower.startsWith('service/') || keyLower.startsWith('logic/') || keyLower.startsWith('workflow/')) {
+            layer = 'business';
+        }
+        else if (keyLower.startsWith('db/') || keyLower.startsWith('model/') || keyLower.startsWith('schema/')) {
+            layer = 'data';
+        }
+        else if (keyLower.startsWith('config/') || keyLower.startsWith('deploy/')) {
+            layer = 'infrastructure';
+        }
+        else {
+            layer = 'business'; // Default layer
+        }
+        inferred.layer = layer;
+    }
+    // Tags extraction from key hierarchy
+    let tags = params.tags;
+    if (!tags || tags.length === 0) {
+        // Split key by '/', '-', or '_' to get hierarchy parts
+        tags = key.split(/[\/\-_]/).filter((p) => p.trim() !== '');
+        inferred.tags = tags;
+    }
+    // Scope inference from key hierarchy
+    let scopes = params.scopes;
+    if (!scopes || scopes.length === 0) {
+        // Get parent scope from key (everything except last part)
+        const parts = key.split('/');
+        if (parts.length > 1) {
+            const scope = parts.slice(0, -1).join('/');
+            scopes = [scope];
+            inferred.scope = scope;
+        }
+    }
+    return {
+        transformedParams: {
+            key: params.key,
+            value: params.value,
+            agent: params.agent,
+            layer,
+            version: params.version || 'v1.0.0',
+            status: params.status || 'active',
+            tags,
+            scopes,
+        },
+        inferred,
+    };
+}
+//# sourceMappingURL=inference.js.map

package/dist/backend/inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.js","sourceRoot":"","sources":["../../src/backend/inference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IACjE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAa,CAAC;IACjC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,kCAAkC;IAClC,IAAI,KAAK,GAAG,MAAM,CAAC,KAA2B,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAClG,KAAK,GAAG,cAAc,CAAC;QACzB,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChH,KAAK,GAAG,UAAU,CAAC;QACrB,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACzG,KAAK,GAAG,MAAM,CAAC;QACjB,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5E,KAAK,GAAG,gBAAgB,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,UAAU,CAAC,CAAC,gBAAgB;QACtC,CAAC;QACD,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,qCAAqC;IACrC,IAAI,IAAI,GAAG,MAAM,CAAC,IAA4B,CAAC;IAC/C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,uDAAuD;QACvD,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACnE,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,qCAAqC;IACrC,IAAI,MAAM,GAAG,MAAM,CAAC,MAA8B,CAAC;IACnD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,0DAA0D;QAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;YACjB,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO;QACL,iBAAiB,EAAE;YACjB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,QAAQ;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;YACjC,IAAI;YACJ,MAAM;SACP;QACD,QAAQ;KACT,CAAC;AACJ,CAAC"}