sfcc-dev-mcp 1.0.15 → 1.0.19

package/dist/core/handlers/system-object-handler.js

@@ -1,29 +1,25 @@
-import { BaseToolHandler } from './base-handler.js';
+import { AbstractClientHandler } from './abstract-client-handler.js';
 import { ClientFactory } from './client-factory.js';
 import { SYSTEM_OBJECT_TOOL_CONFIG, SYSTEM_OBJECT_TOOL_NAMES_SET, } from '../../tool-configs/system-object-tool-config.js';
 /**
- * Handler for system object tools using config-driven dispatch
- * Provides access to SFCC system object definitions, attributes, and site preferences
+ * Handler for system object tools using config-driven dispatch.
+ * Provides access to SFCC system object definitions, attributes, and site preferences.
  */
-export class SystemObjectToolHandler extends BaseToolHandler {
-    ocapiClient = null;
-    clientFactory;
+export class SystemObjectToolHandler extends AbstractClientHandler {
     constructor(context, subLoggerName) {
         super(context, subLoggerName);
-        this.clientFactory = new ClientFactory(context, this.logger);
     }
-    async onInitialize() {
-        this.ocapiClient = this.clientFactory.createOCAPIClient();
-        if (this.ocapiClient) {
-            this.logger.debug('OCAPI client initialized for system objects');
-        }
+    createClient() {
+        return this.clientFactory.createOCAPIClient();
     }
-    async onDispose() {
-        this.ocapiClient = null;
-        this.logger.debug('OCAPI client disposed');
+    getClientContextKey() {
+        return 'ocapiClient';
     }
-    canHandle(toolName) {
-        return SYSTEM_OBJECT_TOOL_NAMES_SET.has(toolName);
+    getClientDisplayName() {
+        return 'OCAPI (System Objects)';
+    }
+    getClientRequiredError() {
+        return ClientFactory.getClientRequiredError('OCAPI');
     }
     getToolNameSet() {
         return SYSTEM_OBJECT_TOOL_NAMES_SET;
@@ -31,15 +27,5 @@ export class SystemObjectToolHandler extends BaseToolHandler {
     getToolConfig() {
         return SYSTEM_OBJECT_TOOL_CONFIG;
     }
-    async createExecutionContext() {
-        if (!this.ocapiClient) {
-            throw new Error(ClientFactory.getClientRequiredError('OCAPI'));
-        }
-        return {
-            handlerContext: this.context,
-            logger: this.logger,
-            ocapiClient: this.ocapiClient,
-        };
-    }
 }
 //# sourceMappingURL=system-object-handler.js.map

package/dist/core/handlers/system-object-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-object-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/system-object-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwE,MAAM,mBAAmB,CAAC;AAE1H,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,yBAAyB,EAEzB,4BAA4B,GAC7B,MAAM,iDAAiD,CAAC;AAEzD;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,eAAqC;IACxE,WAAW,GAAuB,IAAI,CAAC;IACvC,aAAa,CAAgB;IAErC,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAES,KAAK,CAAC,YAAY;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC;QAC1D,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,OAAO,4BAA4B,CAAC,GAAG,CAAC,QAAgC,CAAC,CAAC;IAC5E,CAAC;IAES,cAAc;QACtB,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAES,aAAa;QACrB,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAES,KAAK,CAAC,sBAAsB;QACpC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"system-object-handler.js","sourceRoot":"","sources":["../../../src/core/handlers/system-object-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EACL,yBAAyB,EAEzB,4BAA4B,GAC7B,MAAM,iDAAiD,CAAC;AAEzD;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,qBAAwD;IACnG,YAAY,OAAuB,EAAE,aAAqB;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAES,YAAY;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC;IAChD,CAAC;IAES,mBAAmB;QAC3B,OAAO,aAAa,CAAC;IACvB,CAAC;IAES,oBAAoB;QAC5B,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAES,sBAAsB;QAC9B,OAAO,aAAa,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAES,cAAc;QACtB,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAES,aAAa;QACrB,OAAO,yBAAyB,CAAC;IACnC,CAAC;CACF"}

package/dist/core/handlers/validation-helpers.d.ts

@@ -14,38 +14,36 @@ export declare class ValidationHelpers {
      * Validate arguments against a set of rules
      */
     static validateArguments(args: ToolArguments, rules: ValidationRule[], toolName: string): void;
-    /**
-     * Quick validation for required string fields
-     * @deprecated Use CommonValidations.requiredString() with validateArguments() instead
-     * @example
-     * // Old way
-     * ValidationHelpers.requireStrings(args, ['fieldName'], 'tool_name');
-     *
-     * // New way
-     * ValidationHelpers.validateArguments(args, CommonValidations.requiredString('fieldName'), 'tool_name');
-     */
-    static requireStrings(args: ToolArguments, fields: string[], toolName: string): void;
-    /**
-     * Validate a single field with custom validator
-     */
-    static validateField<T>(args: ToolArguments, field: string, validator: (value: T) => boolean, errorMessage: string, toolName: string): void;
     private static validateType;
 }
 /**
  * Common validation rules factory
  */
 export declare const CommonValidations: {
-    /**
-     * Create a required string field validation
-     */
+    /** Create a required string field validation */
     requiredString: (field: string, customMessage?: string) => ValidationRule[];
-    /**
-     * Create a required field validation with custom validator
-     */
+    /** Create a required field validation with custom validator */
     requiredField: (field: string, type: ValidationRule["type"], validator: (value: any) => boolean, errorMessage: string) => ValidationRule[];
-    /**
-     * Create an optional field validation
-     */
+    /** Create an optional field validation */
     optionalField: (field: string, type: ValidationRule["type"], validator: (value: any) => boolean, errorMessage: string) => ValidationRule[];
 };
+/** Validate log level parameter */
+export declare function validateLogLevel(level: string, toolName: string): void;
+/** Validate limit parameter */
+export declare function validateLimit(limit: number | undefined, toolName: string): void;
+/** Validate maxBytes parameter */
+export declare function validateMaxBytes(maxBytes: number | undefined, toolName: string): void;
+/** Validate filename parameter */
+export declare function validateFilename(filename: string, toolName: string): void;
+/** Format log operation message */
+export declare function formatLogMessage(operation: string, params?: {
+    level?: string;
+    limit?: number;
+    date?: string;
+    pattern?: string;
+    jobName?: string;
+    filename?: string;
+    maxBytes?: number;
+    tailOnly?: boolean;
+}): string;
 //# sourceMappingURL=validation-helpers.d.ts.map

package/dist/core/handlers/validation-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/validation-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,IAAI;IAyCP;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUpF;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EACpB,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,IAAI;IASP,OAAO,CAAC,MAAM,CAAC,YAAY;CAgB5B;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;4BACqB,MAAM,kBAAkB,MAAM,KAAG,cAAc,EAAE;IAQzE;;OAEG;2BAEM,MAAM,QACP,cAAc,CAAC,MAAM,CAAC,aACjB,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,gBACpB,MAAM,KACnB,cAAc,EAAE;IAQnB;;OAEG;2BAEM,MAAM,QACP,cAAc,CAAC,MAAM,CAAC,aACjB,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,gBACpB,MAAM,KACnB,cAAc,EAAE;CAOpB,CAAC"}
+{"version":3,"file":"validation-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/handlers/validation-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGhE,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,IAAI;IAyCP,OAAO,CAAC,MAAM,CAAC,YAAY;CAgB5B;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,gDAAgD;4BACxB,MAAM,kBAAkB,MAAM,KAAG,cAAc,EAAE;IAQzE,+DAA+D;2BAEtD,MAAM,QACP,cAAc,CAAC,MAAM,CAAC,aACjB,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,gBACpB,MAAM,KACnB,cAAc,EAAE;IAQnB,0CAA0C;2BAEjC,MAAM,QACP,cAAc,CAAC,MAAM,CAAC,aACjB,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,gBACpB,MAAM,KACnB,cAAc,EAAE;CAOpB,CAAC;AAMF,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKtE;AAED,+BAA+B;AAC/B,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQ/E;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQrF;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAoBzE;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE;IACN,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACf,GACL,MAAM,CAWR"}

package/dist/core/handlers/validation-helpers.js

@@ -2,6 +2,7 @@
  * Validation helpers for handler arguments
  */
 import { HandlerError } from './base-handler.js';
+import { isValidLogLevel, LogLevelValues } from '../../utils/log-tool-constants.js';
 export class ValidationHelpers {
     /**
      * Validate arguments against a set of rules
@@ -27,36 +28,6 @@ export class ValidationHelpers {
             }
         }
     }
-    /**
-     * Quick validation for required string fields
-     * @deprecated Use CommonValidations.requiredString() with validateArguments() instead
-     * @example
-     * // Old way
-     * ValidationHelpers.requireStrings(args, ['fieldName'], 'tool_name');
-     *
-     * // New way
-     * ValidationHelpers.validateArguments(args, CommonValidations.requiredString('fieldName'), 'tool_name');
-     */
-    static requireStrings(args, fields, toolName) {
-        const rules = fields.map(field => ({
-            field,
-            required: true,
-            type: 'string',
-            errorMessage: `${field} is required for ${toolName}`,
-        }));
-        this.validateArguments(args, rules, toolName);
-    }
-    /**
-     * Validate a single field with custom validator
-     */
-    static validateField(args, field, validator, errorMessage, toolName) {
-        const rules = [{
-                field,
-                validator,
-                errorMessage,
-            }];
-        this.validateArguments(args, rules, toolName);
-    }
     static validateType(value, type) {
         switch (type) {
             case 'string':
@@ -78,9 +49,7 @@ export class ValidationHelpers {
  * Common validation rules factory
  */
 export const CommonValidations = {
-    /**
-     * Create a required string field validation
-     */
+    /** Create a required string field validation */
     requiredString: (field, customMessage) => [{
             field,
             required: true,
@@ -88,9 +57,7 @@ export const CommonValidations = {
             validator: (value) => value.trim().length > 0,
             errorMessage: customMessage ?? `${field} must be a non-empty string`,
         }],
-    /**
-     * Create a required field validation with custom validator
-     */
+    /** Create a required field validation with custom validator */
     requiredField: (field, type, validator, errorMessage) => [{
             field,
             required: true,
@@ -98,9 +65,7 @@ export const CommonValidations = {
             validator,
             errorMessage,
         }],
-    /**
-     * Create an optional field validation
-     */
+    /** Create an optional field validation */
     optionalField: (field, type, validator, errorMessage) => [{
             field,
             required: false,
@@ -109,4 +74,89 @@ export const CommonValidations = {
             errorMessage,
         }],
 };
+// =============================================================================
+// Log-specific validators (consolidated from log-validation.ts)
+// =============================================================================
+/** Validate log level parameter */
+export function validateLogLevel(level, toolName) {
+    if (!isValidLogLevel(level)) {
+        const validLevels = Object.values(LogLevelValues).join(', ');
+        throw new Error(`Invalid log level '${level}' for ${toolName}. Valid levels: ${validLevels}`);
+    }
+}
+/** Validate limit parameter */
+export function validateLimit(limit, toolName) {
+    if (limit === undefined) {
+        return;
+    }
+    if (typeof limit !== 'number' || isNaN(limit)) {
+        throw new Error(`Invalid limit '${limit}' for ${toolName}. Must be a valid number`);
+    }
+    if (limit <= 0 || limit > 1000) {
+        throw new Error(`Invalid limit '${limit}' for ${toolName}. Must be between 1 and 1000`);
+    }
+}
+/** Validate maxBytes parameter */
+export function validateMaxBytes(maxBytes, toolName) {
+    if (maxBytes === undefined) {
+        return;
+    }
+    if (typeof maxBytes !== 'number' || isNaN(maxBytes)) {
+        throw new Error(`Invalid maxBytes '${maxBytes}' for ${toolName}. Must be a valid number`);
+    }
+    if (maxBytes <= 0 || maxBytes > 10_000_000) {
+        throw new Error(`Invalid maxBytes '${maxBytes}' for ${toolName}. Must be between 1 and 10,000,000`);
+    }
+}
+/** Validate filename parameter */
+export function validateFilename(filename, toolName) {
+    if (!filename || filename.trim().length === 0) {
+        throw new Error(`Filename is required for ${toolName}`);
+    }
+    // Check for path traversal attempts
+    if (filename.includes('..') || filename.includes('\\')) {
+        throw new Error(`Invalid filename '${filename}' for ${toolName}. Path traversal not allowed`);
+    }
+    // Check for null byte injection
+    if (filename.includes('\0') || filename.includes('\x00')) {
+        throw new Error(`Invalid filename for ${toolName}. Contains invalid characters`);
+    }
+    // Check for absolute path attempts
+    if (filename.startsWith('/') && !filename.startsWith('/Logs/') && !filename.startsWith('/jobs/')) {
+        throw new Error(`Invalid filename '${filename}' for ${toolName}. Absolute paths outside /Logs/ are not allowed`);
+    }
+    // Check filename length to prevent DoS
+    if (filename.length > 1024) {
+        throw new Error(`Invalid filename for ${toolName}. Filename too long`);
+    }
+}
+/** Format log operation message */
+export function formatLogMessage(operation, params = {}) {
+    const parts = [operation];
+    if (params.jobName) {
+        parts.push(`jobName=${params.jobName}`);
+    }
+    if (params.level) {
+        parts.push(`level=${params.level}`);
+    }
+    if (params.limit !== undefined) {
+        parts.push(`limit=${params.limit}`);
+    }
+    if (params.date) {
+        parts.push(`date=${params.date}`);
+    }
+    if (params.pattern) {
+        parts.push(`pattern="${params.pattern}"`);
+    }
+    if (params.filename) {
+        parts.push(`filename=${params.filename}`);
+    }
+    if (params.maxBytes !== undefined) {
+        parts.push(`maxBytes=${params.maxBytes}`);
+    }
+    if (params.tailOnly !== undefined) {
+        parts.push(`tailOnly=${params.tailOnly}`);
+    }
+    return parts.join(' ');
+}
 //# sourceMappingURL=validation-helpers.js.map

package/dist/core/handlers/validation-helpers.js.map

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

package/dist/core/instruction-advisor.d.ts

@@ -0,0 +1,28 @@
+import { AgentInstructionsClient } from '../clients/agent-instructions-client.js';
+import { Logger } from '../utils/logger.js';
+export interface McpDevConfig {
+    disableAgentSync?: boolean;
+}
+/**
+ * Provides gentle, one-time guidance when AGENTS.md or skills are missing.
+ * Respects mcp-dev.json configuration to permanently disable sync suggestions.
+ */
+export declare class InstructionAdvisor {
+    private readonly client;
+    private readonly logger;
+    constructor(client: AgentInstructionsClient, logger: Logger);
+    /**
+     * Check if agent sync is disabled via mcp-dev.json in the workspace root.
+     */
+    isAgentSyncDisabled(workspaceRoot: string): Promise<boolean>;
+    /**
+     * Create or update mcp-dev.json to disable agent sync suggestions.
+     */
+    disableAgentSync(workspaceRoot: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    getNotice(): Promise<string | undefined>;
+    reset(): void;
+}
+//# sourceMappingURL=instruction-advisor.d.ts.map

package/dist/core/instruction-advisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-advisor.d.ts","sourceRoot":"","sources":["../../src/core/instruction-advisor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM;IAK3D;;OAEG;IACG,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlE;;OAEG;IACG,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA6BvF,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiD9C,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/instruction-advisor.js

@@ -0,0 +1,114 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+/**
+ * Provides gentle, one-time guidance when AGENTS.md or skills are missing.
+ * Respects mcp-dev.json configuration to permanently disable sync suggestions.
+ */
+export class InstructionAdvisor {
+    client;
+    logger;
+    constructor(client, logger) {
+        this.client = client;
+        this.logger = logger;
+    }
+    /**
+     * Check if agent sync is disabled via mcp-dev.json in the workspace root.
+     */
+    async isAgentSyncDisabled(workspaceRoot) {
+        try {
+            const configPath = path.join(workspaceRoot, 'mcp-dev.json');
+            const content = await fs.readFile(configPath, 'utf-8');
+            const config = JSON.parse(content);
+            return config.disableAgentSync === true;
+        }
+        catch {
+            // File doesn't exist or is invalid - sync is not disabled
+            return false;
+        }
+    }
+    /**
+     * Create or update mcp-dev.json to disable agent sync suggestions.
+     */
+    async disableAgentSync(workspaceRoot) {
+        try {
+            const configPath = path.join(workspaceRoot, 'mcp-dev.json');
+            let config = {};
+            // Try to read existing config
+            try {
+                const content = await fs.readFile(configPath, 'utf-8');
+                config = JSON.parse(content);
+            }
+            catch {
+                // File doesn't exist, start with empty config
+            }
+            config.disableAgentSync = true;
+            await fs.writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, 'utf-8');
+            return {
+                success: true,
+                message: `Created/updated ${configPath} with disableAgentSync: true. Agent sync suggestions are now disabled for this workspace.`,
+            };
+        }
+        catch (error) {
+            const errMsg = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                message: `Failed to create mcp-dev.json: ${errMsg}`,
+            };
+        }
+    }
+    async getNotice() {
+        try {
+            const status = await this.client.getStatus();
+            this.logger.debug('[InstructionAdvisor] Status', {
+                workspaceRoot: status.workspaceRoot,
+                hasAgents: status.hasAgents,
+                hasSkills: status.hasSkills,
+                detectedSkillsDir: status.detectedSkillsDir,
+                missingSkills: status.missingSkills,
+                sourceSkills: status.sourceSkills,
+            });
+            // If we cannot determine a workspace root, skip the notice (can't reliably detect presence)
+            if (!status.workspaceRoot) {
+                return undefined;
+            }
+            // Check if agent sync is disabled via mcp-dev.json
+            const syncDisabled = await this.isAgentSyncDisabled(status.workspaceRoot);
+            if (syncDisabled) {
+                this.logger.debug('[InstructionAdvisor] Agent sync disabled via mcp-dev.json');
+                return undefined;
+            }
+            if (status.hasAgents && status.hasSkills) {
+                return undefined;
+            }
+            const missingParts = [];
+            if (!status.hasAgents) {
+                missingParts.push('AGENTS.md');
+            }
+            if (!status.hasSkills) {
+                missingParts.push('skills');
+            }
+            const missingSkills = status.missingSkills?.length
+                ? `Missing skills: ${status.missingSkills.join(', ')}`
+                : 'All skills will be installed.';
+            this.logger.debug('[InstructionAdvisor] Issuing workspace-root notice');
+            return [
+                '📋 Agent instructions available for this SFCC project.',
+                `Missing: ${missingParts.join(' + ')}`,
+                missingSkills,
+                '',
+                '👉 ASK THE USER: "Would you like me to install AGENTS.md and SFCC development skills into your project?"',
+                '',
+                'If YES: Run sync_agent_instructions with dryRun=false',
+                'If NO: Create mcp-dev.json with {"disableAgentSync": true} to permanently disable this suggestion.',
+            ].join('\n');
+        }
+        catch (error) {
+            this.logger.debug('InstructionAdvisor failed to evaluate status', error);
+            return undefined;
+        }
+    }
+    reset() {
+        // no-op for now; retained for potential future stateful notice throttling
+    }
+}
+//# sourceMappingURL=instruction-advisor.js.map

package/dist/core/instruction-advisor.js.map

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

package/dist/core/server.d.ts

@@ -18,6 +18,8 @@ export declare class SFCCDevServer {
     private config;
     private capabilities;
     private handlers;
+    private workspaceRootsService;
+    private instructionAdvisor;
     /**
      * Initialize the SFCC Development MCP Server
      *
@@ -27,6 +29,24 @@ export declare class SFCCDevServer {
     private initializeServer;
     private logMethodEntry;
     private logMethodExit;
+    /**
+     * Discover workspace roots from the MCP client and search for dw.json
+     *
+     * This method is called after the client is initialized. It uses the
+     * MCP roots/list capability to get the client's workspace directories,
+     * then delegates to WorkspaceRootsService for discovery and validation.
+     *
+     * Priority: This is only called when no CLI parameter or environment
+     * variables provided credentials (those take precedence).
+     */
+    private discoverWorkspaceRoots;
+    /**
+     * Reconfigure the server with newly discovered SFCC credentials
+     *
+     * This updates the config, capabilities, and handlers when we discover
+     * a dw.json file in the workspace roots after initialization.
+     */
+    private reconfigureWithCredentials;
     private registerHandlers;
     /**
      * Set up MCP tool handlers for SFCC operations
@@ -40,5 +60,10 @@ export declare class SFCCDevServer {
      * Gracefully shutdown the server and dispose of resources
      */
     private shutdown;
+    /**
+     * Inject a preflight error into JSON responses while preserving existing structure.
+     * Falls back to text concatenation if the payload is not valid JSON.
+     */
+    private attachError;
 }
 //# sourceMappingURL=server.d.ts.map

package/dist/core/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAwB/C;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,YAAY,CAA0D;IAC9E,OAAO,CAAC,QAAQ,CAAyB;IAEzC;;;;OAIG;gBACS,MAAM,EAAE,UAAU;IAY9B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsEzB;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B;;OAEG;YACW,QAAQ;CASvB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,UAAU,EAAgB,MAAM,mBAAmB,CAAC;AA+B7D;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,YAAY,CAA0D;IAC9E,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,kBAAkB,CAAqB;IAE/C;;;;OAIG;gBACS,MAAM,EAAE,UAAU;IAe9B,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,aAAa;IAIrB;;;;;;;;;OASG;YACW,sBAAsB;IAiDpC;;;;;OAKG;YACW,0BAA0B;IAqCxC,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4EzB;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B;;OAEG;YACW,QAAQ;IAUtB;;;OAGG;IACH,OAAO,CAAC,WAAW;CA+BpB"}