fraim-framework 2.0.120 → 2.0.122

package/dist/src/cli/mcp/command-resolution.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveManagedCommand = exports.getPortableNpxCommand = void 0;
+exports.resolveManagedCommand = exports.getSystemCommandPath = exports.getPortableNpxCommand = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
@@ -36,10 +36,43 @@ const getPortableNpxCommand = () => {
     return null;
 };
 exports.getPortableNpxCommand = getPortableNpxCommand;
+const getPathEntries = () => {
+    const rawPath = process.env.PATH || '';
+    return rawPath
+        .split(path_1.default.delimiter)
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+};
+const getSystemCommandCandidates = (command) => {
+    if (!command || path_1.default.isAbsolute(command)) {
+        return command ? [command] : [];
+    }
+    const commandNames = process.platform === 'win32'
+        ? command.includes('.')
+            ? [command]
+            : [command, `${command}.cmd`, `${command}.exe`, `${command}.bat`, `${command}.com`]
+        : [command];
+    return getPathEntries().flatMap((entry) => commandNames.map((name) => path_1.default.join(entry, name)));
+};
+const getSystemCommandPath = (command) => {
+    for (const candidate of getSystemCommandCandidates(command)) {
+        try {
+            const stats = fs_1.default.statSync(candidate);
+            if (stats.isFile()) {
+                return candidate;
+            }
+        }
+        catch {
+            // Ignore missing or inaccessible PATH entries and keep scanning.
+        }
+    }
+    return null;
+};
+exports.getSystemCommandPath = getSystemCommandPath;
 const resolveManagedCommand = (command) => {
     if (command !== 'npx') {
         return command;
     }
-    return (0, exports.getPortableNpxCommand)() || command;
+    return (0, exports.getPortableNpxCommand)() || (0, exports.getSystemCommandPath)(command) || command;
 };
 exports.resolveManagedCommand = resolveManagedCommand;

package/dist/src/cli/setup/ide-global-integration.js

@@ -21,8 +21,9 @@ function describeConfiguredInvocationSurfaces(installedIDEs) {
     return installedIDEs.map((ide) => (0, ide_invocation_surfaces_1.describeInvocationSurface)(ide.name, ide.invocationProfile));
 }
 /**
- * Install the FRAIM slash command for Claude Code at the user level.
- * Writes to ~/.claude/commands/fraim.md and does not overwrite existing files.
+ * Install Claude FRAIM discovery artifacts at the user level.
+ * Writes a skill to ~/.claude/skills/fraim/SKILL.md and a compatibility command
+ * to ~/.claude/commands/fraim.md. Existing user files are preserved.
  */
 async function installSlashCommands(homeDir) {
     const home = homeDir || os_1.default.homedir();
@@ -30,7 +31,8 @@ async function installSlashCommands(homeDir) {
     if (!fs_1.default.existsSync(claudeDir)) {
         return;
     }
-    installFileIfMissing(path_1.default.join(claudeDir, 'commands', 'fraim.md'), (0, ide_invocation_surfaces_1.buildClaudeSlashCommandContent)(), 'Claude slash command (~/.claude/commands/fraim.md)');
+    installFileIfMissing(path_1.default.join(claudeDir, 'skills', 'fraim', 'SKILL.md'), (0, ide_invocation_surfaces_1.buildClaudeSkillContent)(), 'Claude FRAIM skill (~/.claude/skills/fraim/SKILL.md)');
+    installFileIfMissing(path_1.default.join(claudeDir, 'commands', 'fraim.md'), (0, ide_invocation_surfaces_1.buildClaudeCommandShimContent)(), 'Claude compatibility command (~/.claude/commands/fraim.md)');
 }
 /**
  * Install FRAIM invocation artifacts for non-Claude IDEs.

package/dist/src/cli/setup/ide-invocation-surfaces.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FRAIM_INVOCATION_BODY = exports.CURSOR_MDC_FRONTMATTER = exports.FRAIM_LAUNCH_PHRASE = void 0;
+exports.buildClaudeSkillContent = buildClaudeSkillContent;
+exports.buildClaudeCommandShimContent = buildClaudeCommandShimContent;
 exports.buildClaudeSlashCommandContent = buildClaudeSlashCommandContent;
 exports.buildCursorMentionRuleContent = buildCursorMentionRuleContent;
 exports.buildCodexSkillContent = buildCodexSkillContent;
@@ -12,7 +14,7 @@ exports.CURSOR_MDC_FRONTMATTER = `---
 description: FRAIM discovery and execution contract
 alwaysApply: true
 ---`;
-exports.FRAIM_INVOCATION_BODY = `Follow this process:
+exports.FRAIM_INVOCATION_BODY = `Follow this process:
 
 1. **If the user did not specify a FRAIM job or topic**:
    Call \`list_fraim_jobs()\` to discover available jobs. Present the results grouped by the categories returned by the server. For each group, list 3-5 of the most relevant jobs with a one-line description.
@@ -25,11 +27,23 @@ exports.FRAIM_INVOCATION_BODY = `Follow this process:
    - For skills, use the content returned by \`get_fraim_file(...)\`.
 
 4. **Execute**:
-   - For jobs, follow the phased instructions and use \`seekMentoring\` when the job requires phase transitions.
-   - For skills, apply the skill steps directly to the user's current context.
+   - For jobs, follow the phased instructions and use \`seekMentoring\` when the job requires phase transitions.
+   - For skills, apply the skill steps directly to the user's current context.
 `;
+function buildClaudeSkillContent() {
+    return `# FRAIM
+
+${exports.FRAIM_INVOCATION_BODY}`;
+}
+function buildClaudeCommandShimContent() {
+    return `# FRAIM Compatibility Command
+
+Use the FRAIM skill when Claude exposes skills directly. This compatibility command keeps \`/fraim\` working on surfaces that still discover legacy command files.
+
+${exports.FRAIM_INVOCATION_BODY}`;
+}
 function buildClaudeSlashCommandContent() {
-    return exports.FRAIM_INVOCATION_BODY;
+    return buildClaudeCommandShimContent();
 }
 function buildCursorMentionRuleContent() {
     return `${exports.CURSOR_MDC_FRONTMATTER}

package/dist/src/cli/utils/agent-adapters.js

@@ -12,6 +12,7 @@ const START_MARKER = '<!-- FRAIM_AGENT_ADAPTER_START -->';
 const END_MARKER = '<!-- FRAIM_AGENT_ADAPTER_END -->';
 const CURSOR_RULE_PATH = path_1.default.join('.cursor', 'rules', 'fraim.mdc');
 const CLAUDE_FRAIM_COMMAND_PATH = path_1.default.join('.claude', 'commands', 'fraim.md');
+const CLAUDE_FRAIM_SKILL_PATH = path_1.default.join('.claude', 'skills', 'fraim', 'SKILL.md');
 const VSCODE_FRAIM_PROMPT_PATH = path_1.default.join('.github', 'prompts', 'fraim.prompt.md');
 const CODEX_FRAIM_SKILL_PATH = path_1.default.join('.codex', 'skills', 'fraim', 'SKILL.md');
 const WINDSURF_FRAIM_COMMAND_PATH = path_1.default.join('.windsurf', 'commands', 'fraim.md');
@@ -108,7 +109,8 @@ ${ide_invocation_surfaces_1.FRAIM_INVOCATION_BODY}`;
         { path: CURSOR_RULE_PATH, content: cursorManagedBody },
         { path: VSCODE_FRAIM_PROMPT_PATH, content: vscodePrompt },
         { path: path_1.default.join(project_fraim_paths_1.WORKSPACE_FRAIM_DIRNAME, 'README.md'), content: fraimReadme },
-        { path: CLAUDE_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeSlashCommandContent)() },
+        { path: CLAUDE_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeSkillContent)() },
+        { path: CLAUDE_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeCommandShimContent)() },
         { path: CODEX_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildCodexSkillContent)() },
         { path: WINDSURF_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildWindsurfCommandContent)() },
         { path: KIRO_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildKiroCommandContent)() }
@@ -127,6 +129,7 @@ function ensureAgentAdapterFiles(projectRoot) {
             ? mergeCursorRule(existing, file.content)
             : file.path.endsWith('README.md')
                 || file.path === VSCODE_FRAIM_PROMPT_PATH
+                || file.path === CLAUDE_FRAIM_SKILL_PATH
                 || file.path === CLAUDE_FRAIM_COMMAND_PATH
                 || file.path === CODEX_FRAIM_SKILL_PATH
                 || file.path === WINDSURF_FRAIM_COMMAND_PATH

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.120",
+  "version": "2.0.122",
   "description": "FRAIM: AI Workforce Infrastructure — the organizational capability that turns AI agents into an accountable workforce, their operators into capable AI managers, and executives into leaders with clear optics on AI proficiency.",
   "main": "index.js",
   "bin": {