@decibelsystems/tools 2.0.0

package/dist/tools/dojoPolicy.js

@@ -0,0 +1,263 @@
+/**
+ * Dojo Policy Enforcement
+ *
+ * Loads and enforces role-based access control for Dojo tools.
+ * Ensures AI callers can only access sandbox-safe operations.
+ */
+import fs from 'fs';
+import path from 'path';
+import { parse as parseYaml } from 'yaml';
+import { log } from '../config.js';
+// ============================================================================
+// Default Policy (fallback if file not found)
+// ============================================================================
+const DEFAULT_POLICY = {
+    roles: {
+        human: {
+            description: 'Full Dojo access',
+            allowed_tools: ['*'],
+            sandbox: {
+                fs_read: ['**'],
+                fs_write: ['**'],
+                exec_allowlist: ['*'],
+                net: true,
+            },
+        },
+        mother: {
+            description: 'AI agent role - sandbox-only',
+            allowed_tools: [
+                'dojo_add_wish',
+                'dojo_list_wishes',
+                'dojo_create_proposal',
+                'dojo_list',
+                'dojo_scaffold_experiment',
+                'dojo_run_experiment',
+                'dojo_get_results',
+                'dojo_can_graduate',
+            ],
+            denied_tools: [
+                'dojo_enable_experiment',
+                'dojo_disable_experiment',
+                'dojo_graduate_experiment',
+            ],
+            sandbox: {
+                fs_read: ['{DOJO_ROOT}/**'],
+                fs_write: ['{DOJO_ROOT}/results/**', '{DOJO_ROOT}/wishes/**', '{DOJO_ROOT}/proposals/**'],
+                exec_allowlist: ['python', 'python3', 'node', 'rg', 'git'],
+                net: false,
+            },
+        },
+        ai: {
+            description: 'Generic AI caller',
+            allowed_tools: [],
+            inherits: 'mother',
+            sandbox: {
+                fs_read: [],
+                fs_write: [],
+                exec_allowlist: [],
+                net: false,
+            },
+        },
+    },
+    default_role: 'human',
+    safety: {
+        never_expose_to_ai: [
+            'dojo_enable_experiment',
+            'dojo_disable_experiment',
+            'dojo_graduate_experiment',
+        ],
+        always_sandbox_run: true,
+        results_write_fence: '{DOJO_ROOT}/results/**',
+    },
+};
+// ============================================================================
+// Policy Loader (singleton)
+// ============================================================================
+let cachedPolicy = null;
+/**
+ * Load the Dojo policy from .decibel/dojo_policy.yaml
+ * Falls back to default policy if file not found
+ */
+export function loadDojoPolicy(forceReload = false) {
+    if (cachedPolicy && !forceReload) {
+        return cachedPolicy;
+    }
+    const policyPaths = [
+        path.join(process.cwd(), '.decibel', 'dojo_policy.yaml'),
+        path.join(process.cwd(), 'dojo_policy.yaml'),
+    ];
+    for (const policyPath of policyPaths) {
+        try {
+            if (fs.existsSync(policyPath)) {
+                const content = fs.readFileSync(policyPath, 'utf-8');
+                const parsed = parseYaml(content);
+                cachedPolicy = mergeWithDefaults(parsed);
+                log(`dojoPolicy: Loaded policy from ${policyPath}`);
+                return cachedPolicy;
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            log(`dojoPolicy: Failed to load ${policyPath}: ${message}`);
+        }
+    }
+    log('dojoPolicy: Using default policy (no policy file found)');
+    cachedPolicy = DEFAULT_POLICY;
+    return cachedPolicy;
+}
+/**
+ * Merge loaded policy with defaults to ensure all fields exist
+ */
+function mergeWithDefaults(loaded) {
+    return {
+        roles: { ...DEFAULT_POLICY.roles, ...loaded.roles },
+        default_role: loaded.default_role || DEFAULT_POLICY.default_role,
+        safety: { ...DEFAULT_POLICY.safety, ...loaded.safety },
+    };
+}
+// ============================================================================
+// Policy Enforcement
+// ============================================================================
+/**
+ * Resolve a role, handling inheritance
+ */
+function resolveRole(roleName, policy) {
+    const role = policy.roles[roleName];
+    if (!role) {
+        return null;
+    }
+    // Handle inheritance
+    if (role.inherits && policy.roles[role.inherits]) {
+        const parent = resolveRole(role.inherits, policy);
+        if (parent) {
+            return {
+                ...parent,
+                ...role,
+                allowed_tools: role.allowed_tools.length > 0 ? role.allowed_tools : parent.allowed_tools,
+                denied_tools: [...(parent.denied_tools || []), ...(role.denied_tools || [])],
+                sandbox: {
+                    ...parent.sandbox,
+                    ...role.sandbox,
+                },
+            };
+        }
+    }
+    return role;
+}
+/**
+ * Check if a caller role is allowed to use a specific tool
+ */
+export function checkToolAccess(toolName, callerRole = 'human') {
+    const policy = loadDojoPolicy();
+    // Check safety: never expose certain tools to AI
+    if (callerRole !== 'human' && policy.safety.never_expose_to_ai.includes(toolName)) {
+        return {
+            allowed: false,
+            reason: `Tool "${toolName}" is never allowed for AI callers`,
+        };
+    }
+    // Get role policy
+    const role = resolveRole(callerRole, policy);
+    if (!role) {
+        // Unknown role - use default
+        const defaultRole = resolveRole(policy.default_role, policy);
+        if (!defaultRole) {
+            return { allowed: false, reason: 'Unknown role and no default role configured' };
+        }
+    }
+    const effectiveRole = role || resolveRole(policy.default_role, policy);
+    // Check denied list first
+    if (effectiveRole.denied_tools?.includes(toolName)) {
+        return {
+            allowed: false,
+            reason: `Tool "${toolName}" is explicitly denied for role "${callerRole}"`,
+        };
+    }
+    // Check allowed list
+    const isAllowed = effectiveRole.allowed_tools.includes('*') || effectiveRole.allowed_tools.includes(toolName);
+    if (!isAllowed) {
+        return {
+            allowed: false,
+            reason: `Tool "${toolName}" is not in allowed list for role "${callerRole}"`,
+        };
+    }
+    return {
+        allowed: true,
+        sandbox: effectiveRole.sandbox,
+    };
+}
+/**
+ * Get the sandbox policy for a caller role
+ */
+export function getSandboxPolicy(callerRole = 'human') {
+    const policy = loadDojoPolicy();
+    const role = resolveRole(callerRole, policy);
+    if (!role) {
+        // Strictest sandbox for unknown roles
+        return {
+            fs_read: [],
+            fs_write: [],
+            exec_allowlist: [],
+            net: false,
+        };
+    }
+    return role.sandbox;
+}
+/**
+ * Expand sandbox path patterns with actual Dojo root
+ */
+export function expandSandboxPaths(sandbox, dojoRoot) {
+    const expand = (patterns) => patterns.map((p) => p.replace('{DOJO_ROOT}', dojoRoot));
+    return {
+        fs_read: expand(sandbox.fs_read),
+        fs_write: expand(sandbox.fs_write),
+        exec_allowlist: sandbox.exec_allowlist,
+        net: sandbox.net,
+    };
+}
+/**
+ * Check if a path is allowed for writing under the sandbox policy
+ */
+export function isWriteAllowed(targetPath, sandbox) {
+    const normalizedTarget = path.normalize(targetPath);
+    for (const pattern of sandbox.fs_write) {
+        // Simple glob matching (supports ** and *)
+        const regexPattern = pattern
+            .replace(/\*\*/g, '.*')
+            .replace(/\*/g, '[^/]*')
+            .replace(/\//g, '\\/');
+        const regex = new RegExp(`^${regexPattern}$`);
+        if (regex.test(normalizedTarget)) {
+            return true;
+        }
+        // Also check if target is under the pattern directory
+        const patternDir = pattern.replace(/\/\*\*$/, '').replace(/\/\*$/, '');
+        if (normalizedTarget.startsWith(path.normalize(patternDir))) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if an executable is allowed under the sandbox policy
+ */
+export function isExecAllowed(executable, sandbox) {
+    if (sandbox.exec_allowlist.includes('*')) {
+        return true;
+    }
+    const baseName = path.basename(executable);
+    return sandbox.exec_allowlist.includes(baseName) || sandbox.exec_allowlist.includes(executable);
+}
+// ============================================================================
+// Convenience: Enforce or throw
+// ============================================================================
+/**
+ * Enforce tool access - throws if not allowed
+ */
+export function enforceToolAccess(toolName, callerRole = 'human') {
+    const result = checkToolAccess(toolName, callerRole);
+    if (!result.allowed) {
+        throw new Error(`Access denied: ${result.reason}`);
+    }
+}
+//# sourceMappingURL=dojoPolicy.js.map

package/dist/tools/dojoPolicy.js.map

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

package/dist/tools/feedback/index.d.ts

@@ -0,0 +1,5 @@
+import { ToolSpec } from '../types.js';
+export declare const feedbackSubmitTool: ToolSpec;
+export declare const feedbackListTool: ToolSpec;
+export declare const feedbackTools: ToolSpec[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/feedback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/feedback/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA2BvC,eAAO,MAAM,kBAAkB,EAAE,QAwEhC,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,QAsD9B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,QAAQ,EAGnC,CAAC"}

package/dist/tools/feedback/index.js

@@ -0,0 +1,153 @@
+// ============================================================================
+// Feedback Domain Tool Definitions
+// ============================================================================
+// MCP tool specs for collecting and querying user/AI feedback.
+// Phase 1: feedback_submit + feedback_list
+// ============================================================================
+import { toolSuccess, toolError } from '../shared/index.js';
+import { submitFeedback, listFeedback, isFeedbackError, } from '../feedback.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const VALID_CATEGORIES = ['tool', 'workflow', 'docs', 'ux', 'perf', 'other'];
+const VALID_SENTIMENTS = ['positive', 'negative'];
+const VALID_SOURCES = ['human', 'agent'];
+const VALID_STATUSES = ['open', 'acknowledged', 'actioned', 'archived'];
+// ============================================================================
+// feedback_submit
+// ============================================================================
+export const feedbackSubmitTool = {
+    definition: {
+        name: 'feedback_submit',
+        description: 'Submit feedback on a tool, workflow, or feature. Supports thumbs up/down sentiment, category tagging, and optional tool reference. Stored in .decibel/feedback/ for tracking.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                category: {
+                    type: 'string',
+                    enum: VALID_CATEGORIES,
+                    description: 'Feedback category: tool, workflow, docs, ux, perf, or other',
+                },
+                feedback: {
+                    type: 'string',
+                    description: 'The feedback text - what you liked, disliked, or observed',
+                },
+                tool_ref: {
+                    type: 'string',
+                    description: 'Specific tool name (e.g., "workflow_preflight"). Most useful when category=tool.',
+                },
+                sentiment: {
+                    type: 'string',
+                    enum: VALID_SENTIMENTS,
+                    description: 'Thumbs up (positive) or thumbs down (negative). Default: positive.',
+                },
+                source: {
+                    type: 'string',
+                    enum: VALID_SOURCES,
+                    description: 'Who is giving feedback (default: human)',
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tags for categorization (e.g., ["helpful", "time-saver"])',
+                },
+            },
+            required: ['category', 'feedback'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            // Validate category
+            if (!VALID_CATEGORIES.includes(input.category)) {
+                throw new Error(`Invalid category: "${input.category}". Must be one of: ${VALID_CATEGORIES.join(', ')}`);
+            }
+            // Validate sentiment if provided
+            if (input.sentiment && !VALID_SENTIMENTS.includes(input.sentiment)) {
+                throw new Error(`Invalid sentiment: "${input.sentiment}". Must be one of: ${VALID_SENTIMENTS.join(', ')}`);
+            }
+            // Validate source if provided
+            if (input.source && !VALID_SOURCES.includes(input.source)) {
+                throw new Error(`Invalid source: "${input.source}". Must be one of: ${VALID_SOURCES.join(', ')}`);
+            }
+            const result = await submitFeedback(input);
+            if (isFeedbackError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// feedback_list
+// ============================================================================
+export const feedbackListTool = {
+    definition: {
+        name: 'feedback_list',
+        description: 'List feedback entries with optional filters. Returns entries and summary statistics including totals by category and sentiment breakdown.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                category: {
+                    type: 'string',
+                    enum: VALID_CATEGORIES,
+                    description: 'Filter by category',
+                },
+                tool_ref: {
+                    type: 'string',
+                    description: 'Filter by specific tool name',
+                },
+                sentiment: {
+                    type: 'string',
+                    enum: VALID_SENTIMENTS,
+                    description: 'Filter by sentiment (positive or negative)',
+                },
+                status: {
+                    type: 'string',
+                    enum: VALID_STATUSES,
+                    description: 'Filter by status',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum entries to return (default: 20)',
+                },
+                since: {
+                    type: 'string',
+                    description: 'Only include feedback created after this ISO date',
+                },
+            },
+            required: [],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await listFeedback(args);
+            if (isFeedbackError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Export All Tools
+// ============================================================================
+export const feedbackTools = [
+    feedbackSubmitTool,
+    feedbackListTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/feedback/index.js.map

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

package/dist/tools/feedback.d.ts

@@ -0,0 +1,61 @@
+export interface ProjectResolutionError {
+    error: 'project_resolution_failed';
+    message: string;
+    hint: string;
+}
+export type FeedbackCategory = 'tool' | 'workflow' | 'docs' | 'ux' | 'perf' | 'other';
+export type FeedbackSentiment = 'positive' | 'negative';
+export type FeedbackSource = 'human' | 'agent';
+export type FeedbackStatus = 'open' | 'acknowledged' | 'actioned' | 'archived';
+export interface SubmitFeedbackInput {
+    projectId?: string;
+    category: FeedbackCategory;
+    feedback: string;
+    tool_ref?: string;
+    sentiment?: FeedbackSentiment;
+    source?: FeedbackSource;
+    tags?: string[];
+}
+export interface SubmitFeedbackOutput {
+    id: string;
+    path: string;
+    created_at: string;
+    category: FeedbackCategory;
+    sentiment: FeedbackSentiment;
+}
+export interface ListFeedbackInput {
+    projectId?: string;
+    category?: FeedbackCategory;
+    tool_ref?: string;
+    sentiment?: FeedbackSentiment;
+    status?: FeedbackStatus;
+    limit?: number;
+    since?: string;
+}
+export interface FeedbackEntry {
+    id: string;
+    category: FeedbackCategory;
+    tool_ref: string;
+    sentiment: FeedbackSentiment;
+    source: FeedbackSource;
+    status: FeedbackStatus;
+    created_at: string;
+    tags: string[];
+    excerpt: string;
+}
+export interface ListFeedbackOutput {
+    entries: FeedbackEntry[];
+    summary: {
+        total: number;
+        by_category: Record<string, number>;
+        sentiment_breakdown: Record<string, number>;
+    };
+}
+export interface FeedbackError {
+    error: string;
+    details?: string;
+}
+export declare function isFeedbackError(result: unknown): result is FeedbackError;
+export declare function submitFeedback(input: SubmitFeedbackInput): Promise<SubmitFeedbackOutput | ProjectResolutionError>;
+export declare function listFeedback(input: ListFeedbackInput): Promise<ListFeedbackOutput | ProjectResolutionError>;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/tools/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/tools/feedback.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,2BAA2B,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAeD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AACtF,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAC/C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC7C,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAExE;AAMD,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,GAAG,sBAAsB,CAAC,CA0FxD;AAMD,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,GAAG,sBAAsB,CAAC,CA4DtD"}