fraim 2.0.359 → 2.0.360-next.1

package/dist/src/mcp/tool-schemas.js

@@ -205,7 +205,7 @@ For read-only diagnosis or delivery verification, use get_fraim_file({ path: "jo
 
 Examples:
 - get_fraim_file({ path: "skills/communication/active-listening.md" })
-- get_fraim_file({ path: "rules/local-development.md" })`,
+- get_fraim_file({ path: "rules/engineering/engineering.md" })`,
             annotations: readOnlyClosedWorldAnnotations,
             inputSchema: {
                 type: 'object',
@@ -213,7 +213,7 @@ Examples:
                     ...sessionIdProperty,
                     path: {
                         type: 'string',
-                        description: 'Path to the file (e.g., skills/communication/active-listening.md, rules/local-development.md, templates/specs/FEATURESPEC-TEMPLATE.md)'
+                        description: 'Path to the file (e.g., skills/communication/active-listening.md, rules/engineering/engineering.md, templates/specs/FEATURESPEC-TEMPLATE.md)'
                     },
                     raw: {
                         type: 'boolean',

package/dist/src/services/mcp-service.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.McpService = exports.REQUIRED_QUALITY_FIELDS = exports.QUALITY_SCORE_JOBS = exports.QUALITY_PRODUCING_JOBS = exports.DEFAULT_LAUNCH_PHRASE_MAPPINGS = void 0;
 exports.buildTrainingModeBlock = buildTrainingModeBlock;
+const domain_rule_assembler_1 = require("../core/utils/domain-rule-assembler");
 const fs_1 = require("fs");
 const crypto_1 = require("crypto");
 const job_parser_1 = require("../core/utils/job-parser");
@@ -311,8 +312,8 @@ class McpService {
                 header += `These must be filled by the agent/runtime from the active task context.\n\n`;
             }
             if (metadata.type === 'script') {
-                header += `\n## 🛡️ Ephemeral Execution Mandatory (IP Protection)\n\n`;
-                header += `This script MUST be executed ephemerally (see rules/ephemeral-execution.md).\n\n`;
+                header += `\n## Script execution\n\n`;
+                header += `Use the synchronized installed script with the arguments supplied by its owning skill. If it is missing or stale, restore synchronization before execution.\n\n`;
             }
             header += `---\n\n`;
             return {
@@ -421,12 +422,9 @@ class McpService {
                 console.error(`❌ McpService: Failed to fetch executionMode for ${jobName}:`, e);
             }
         }
-        return {
-            content: [{
-                    type: 'text',
-                    text: response
-                }]
-        };
+        return this.addRuleDelivery({
+            content: [{ type: 'text', text: response }]
+        }, jobName);
     }
     async handleListJobs() {
         const jobs = Array.from(this.registryService.getFileIndex().values()).filter((f) => f.type === 'job' && !f.isStub);
@@ -574,7 +572,7 @@ class McpService {
         }
         // Learning context is injected by the local proxy (learning-context-builder.ts)
         // after this response is received, because learning files live in the local workspace.
-        return {
+        return this.addRuleDelivery({
             content: [{
                     type: 'text',
                     text: lines.join('\n')
@@ -587,7 +585,7 @@ class McpService {
                 repo: session.repo
             },
             sessionId: sessionId
-        };
+        });
     }
     validateIssueTrackingConfig(issueTracking) {
         if (!issueTracking.provider) {
@@ -708,7 +706,8 @@ class McpService {
         };
     }
     async handleSeekMentoring(args, userId) {
-        const personaLock = await this.maybeBuildPersonaLockResponse(args.jobName, userId, undefined, args.status === 'starting');
+        const restoringInstructions = args.status === 'starting' && args.requestInstructions === true;
+        const personaLock = await this.maybeBuildPersonaLockResponse(args.jobName, userId, undefined, args.status === 'starting' && !restoringInstructions);
         if (personaLock) {
             return personaLock;
         }
@@ -827,7 +826,7 @@ class McpService {
         let phaseStartWarning = '';
         const sessionId = typeof args.sessionId === 'string' ? args.sessionId.trim() : '';
         const isPhaseCompletion = args.status === 'complete' || args.status === 'failure';
-        if (sessionId && sessionId !== 'unknown') {
+        if (!restoringInstructions && sessionId && sessionId !== 'unknown') {
             const markerKey = JSON.stringify([userId ?? null, sessionId, args.jobName]);
             const context = {
                 sessionId,
@@ -864,7 +863,7 @@ class McpService {
             phaseStartWarning = `Phase-start notice: phase \`${args.currentPhase}\` has no identifiable session, so its start cannot be matched to this run. The missing match was flagged, but this completion remains accepted.\n\n`;
         }
         // Update job execution tracking using usage events
-        if (canTrackJob && userId && this.analyticsService) {
+        if (!restoringInstructions && canTrackJob && userId && this.analyticsService) {
             try {
                 const sessionId = args.sessionId || 'unknown';
                 await this.analyticsService.logMentoringCall(args.jobId, args.jobName, userId, sessionId, args.currentPhase, args.status, result.nextPhase, result.message ? true : false);
@@ -885,7 +884,7 @@ class McpService {
         }
         // Issue #1345: persist executionModeUpdate from findings when present.
         const executionModeUpdate = args.findings?.executionModeUpdate;
-        if (userId && executionModeUpdate && typeof executionModeUpdate['jobName'] === 'string') {
+        if (!restoringInstructions && userId && executionModeUpdate && typeof executionModeUpdate['jobName'] === 'string') {
             try {
                 await this.dbService.upsertJobExecutionMode(userId, executionModeUpdate);
             }
@@ -893,13 +892,33 @@ class McpService {
                 console.error(`❌ McpService: Failed to upsert executionMode:`, e);
             }
         }
-        return {
+        return this.addRuleDelivery({
             content: [{
                     type: 'text',
                     text: trackingWarning + phaseStartWarning + result.message
                 }],
             structuredContent: { phaseAccepted: true, nextPhase: result.nextPhase, phaseStartWarning }
-        };
+        }, args.jobName, args);
+    }
+    async addRuleDelivery(response, jobName, phaseArgs) {
+        if (response.isError || response.personaLock)
+            return response;
+        const context = jobName ? await this.aiMentor.getRuleDeliveryContext(jobName) : null;
+        if (jobName && !context)
+            return response;
+        if (phaseArgs && !(phaseArgs.status === 'starting' && (phaseArgs.currentPhase === 'starting' || phaseArgs.currentPhase === context?.initialPhase || phaseArgs.requestInstructions === true)))
+            return response;
+        const assembly = await (0, domain_rule_assembler_1.assembleDomainRules)({ jobPath: context?.jobPath, resolveFile: async (path) => {
+                const content = await this.registryService.getFile(path);
+                if (content === null)
+                    throw new Error(`Rule source unavailable: ${path}`);
+                return { content, source: 'remote', personalized: false, inherited: false };
+            } });
+        const result = (0, domain_rule_assembler_1.attachRuleAssembly)(response, assembly);
+        for (const warning of assembly.metadata.warnings) {
+            console.warn('Rule delivery warning:', JSON.stringify(warning));
+        }
+        return result;
     }
     getJobDescription(jobName, fullPath) {
         if (fullPath && (0, fs_1.existsSync)(fullPath)) {

package/dist/src/services/registry-service.js

@@ -308,6 +308,10 @@ class RegistryService {
     }
     getSyncBundle() {
         const files = [];
+        const domainCatalog = (0, path_1.join)(this.registryPath, 'domains.json');
+        if ((0, fs_1.existsSync)(domainCatalog)) {
+            files.push({ path: 'domains.json', content: (0, fs_1.readFileSync)(domainCatalog, 'utf8'), type: 'config' });
+        }
         const allFiles = Array.from(this.fileIndex.values());
         // 1. Add job STUBS (not full jobs) from registry/stubs/jobs
         const jobStubs = allFiles.filter(f => f.type === 'job' && f.path.includes('stubs/jobs/'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim",
-  "version": "2.0.359",
+  "version": "2.0.360-next.1",
   "description": "FRAIM core CLI and MCP package.",
   "main": "index.js",
   "bin": {
@@ -9,7 +9,8 @@
   "files": [
     "dist/registry/scripts/artifact-paths.js",
     "dist/registry/scripts/learning-usage/local-runtime.js",
-    "dist/registry/scripts/learning/learning-domains.json",
+    "dist/registry/domains.json",
+    "dist/registry/scripts/domains/catalog.js",
     "dist/registry/scripts/learning/entry-format.js",
     "dist/registry/scripts/learning/completion-state.js",
     "dist/registry/scripts/learning/corpus-audit.js",

package/dist/registry/scripts/learning/learning-domains.json

@@ -1,80 +0,0 @@
-{
-  "schemaVersion": 1,
-  "mapVersion": 1,
-  "domains": [
-    "engineering",
-    "product",
-    "go-to-market",
-    "people-ops",
-    "finance",
-    "legal",
-    "compliance",
-    "customer",
-    "company-building",
-    "operations"
-  ],
-  "jobDomainMap": {
-    "engineering": "engineering",
-    "product-building": "engineering",
-    "dev-ops": "engineering",
-    "quality-assurance": "engineering",
-    "migration": "engineering",
-    "replicate": "engineering",
-    "reviewer": "engineering",
-    "security": "engineering",
-    "delivery-ops": "engineering",
-    "salesforce": "engineering",
-    "ai-engineering": "engineering",
-    "product-management": "product",
-    "customer-development": "product",
-    "brainstorming": "product",
-    "marketing": "go-to-market",
-    "branding": "go-to-market",
-    "sales": "go-to-market",
-    "go-to-market": "go-to-market",
-    "business-development": "go-to-market",
-    "commercial-ops": "go-to-market",
-    "people-ops": "people-ops",
-    "recruiting": "people-ops",
-    "inclusion-ops": "people-ops",
-    "career": "people-ops",
-    "finance": "finance",
-    "invoicing": "finance",
-    "banking": "finance",
-    "legal": "legal",
-    "compliance": "compliance",
-    "customer-success": "customer",
-    "customer-communication": "customer",
-    "company-creation": "company-building",
-    "bootstrap": "company-building",
-    "fundraising": "company-building",
-    "business-ops": "operations",
-    "procurement": "operations",
-    "project-management": "operations"
-  },
-  "globalJobCategories": [
-    "manager",
-    "fraim",
-    "1-1",
-    "coaching",
-    "delegation",
-    "hiring",
-    "productivity",
-    "project-setup",
-    "setup-guardrails",
-    "team-learning",
-    "verification"
-  ],
-  "domainVoice": {
-    "engineering": "Precise and technical; file paths, commands, and test names are appropriate.",
-    "product": "Product and user-outcome language; behavior and flow, not code symbols.",
-    "go-to-market": "Marketing and sales language; campaigns, funnels, messaging, audience.",
-    "people-ops": "Plain HR and recruiting language; no engineering jargon.",
-    "finance": "Finance and accounting language; figures, close, forecasts.",
-    "legal": "Contract and IP language; obligations, clauses, risk.",
-    "compliance": "Controls, evidence, and regulation language.",
-    "customer": "Customer-relationship and support language.",
-    "company-building": "Founder and operations language; setup, entity, funding.",
-    "operations": "Business-operations language; process, vendors, planning, coordination."
-  }
-}