fraim 2.0.132 → 2.0.134

package/dist/src/ai-hub/catalog.js

@@ -27,13 +27,11 @@ const project_fraim_paths_1 = require("../core/utils/project-fraim-paths");
 //                        (per-project override layer; CLAUDE.md says it
 //                        "takes precedence over synced baseline content")
 const EMPLOYEE_JOB_LAYERS = [
-    { base: 'registry', segments: ['jobs', 'ai-employee'] },
     { base: 'fraim', segments: ['ai-employee', 'jobs'] },
     { base: 'fraim', segments: ['personalized-employee', 'jobs'] },
 ];
-// Manager templates use the matching three-layer model.
+// Manager templates use the matching two-layer model.
 const MANAGER_JOB_LAYERS = [
-    { base: 'registry', segments: ['jobs', 'ai-manager'] },
     { base: 'fraim', segments: ['ai-manager', 'jobs'] },
     { base: 'fraim', segments: ['personalized-employee', 'manager-jobs'] },
 ];
@@ -139,16 +137,14 @@ function summarizeProject(projectPath) {
         };
     }
     const fraimDir = (0, project_fraim_paths_1.getWorkspaceFraimDir)(projectPath);
-    const registryEmployeeDir = path_1.default.join(projectPath, 'registry', 'jobs', 'ai-employee');
-    const registryManagerDir = path_1.default.join(projectPath, 'registry', 'jobs', 'ai-manager');
     const hasFraim = fs_1.default.existsSync(fraimDir);
-    const hasRegistry = fs_1.default.existsSync(registryEmployeeDir) || fs_1.default.existsSync(registryManagerDir);
-    if (!hasFraim && !hasRegistry) {
+    if (!hasFraim) {
         return {
             path: projectPath,
             exists: true,
             hasFraim: false,
-            message: 'This folder does not contain a local fraim/ or registry/jobs/ directory.',
+            needsOnboarding: true,
+            message: 'This folder has not been set up with FRAIM yet. Onboarding will get your AI employee started.',
         };
     }
     return {
@@ -158,13 +154,6 @@ function summarizeProject(projectPath) {
     };
 }
 function resolveLayerRoot(projectPath, layer) {
-    if (layer.base === 'registry') {
-        // The registry is the FRAIM source-of-truth catalog. It lives at the
-        // project root in the FRAIM source repo (this repo) and in any project
-        // that ships dist/registry alongside its source. Not under fraim/.
-        return path_1.default.join(projectPath, 'registry', ...layer.segments);
-    }
-    // 'fraim' layers live inside <projectRoot>/fraim/.
     return path_1.default.join((0, project_fraim_paths_1.getWorkspaceFraimDir)(projectPath), ...layer.segments);
 }
 function discoverLayers(projectPath, layers) {
@@ -300,13 +289,29 @@ function nextPhase(edge, discriminant) {
     }
     return null;
 }
+// Parse the ordered phase list from a job stub's ## Steps section.
+// Real FRAIM job stubs use Markdown steps rather than JSON frontmatter;
+// this is the fallback parser that makes the pizza tracker work for them.
+function loadJobPhasesFromSteps(filePath) {
+    const raw = fs_1.default.readFileSync(filePath, 'utf8');
+    const stepsMatch = raw.match(/## Steps\r?\n([\s\S]*?)(?:\r?\n## |\r?\n---|$)/);
+    if (!stepsMatch)
+        return [];
+    const phases = [];
+    for (const line of stepsMatch[1].split(/\r?\n/)) {
+        const m = line.match(/`([a-z][a-z0-9-]*)`/);
+        if (m)
+            phases.push({ id: m[1], label: friendlyPhaseLabel(m[1]) });
+    }
+    return phases;
+}
 function loadJobPhases(jobId, projectPath, discriminant = 'feature') {
     const stubPath = findJobStubPath(projectPath, jobId);
     if (!stubPath)
         return [];
     const fm = readJobFrontmatter(stubPath);
     if (!fm || !fm.initialPhase || !fm.phases)
-        return [];
+        return loadJobPhasesFromSteps(stubPath);
     const visited = new Set();
     const ordered = [];
     let cursor = fm.initialPhase;
@@ -334,8 +339,10 @@ function loadAllJobPhaseIds(jobId, projectPath) {
     if (!stubPath)
         return new Set();
     const fm = readJobFrontmatter(stubPath);
-    if (!fm || !fm.phases)
-        return new Set();
+    if (!fm || !fm.phases) {
+        const phases = loadJobPhasesFromSteps(stubPath);
+        return new Set(phases.map((p) => p.id));
+    }
     return new Set(Object.keys(fm.phases));
 }
 // Issue #347 — public exposure of the friendly-label rule so callers

package/dist/src/ai-hub/server.js

@@ -386,6 +386,14 @@ class AiHubServer {
                     recentJobIds: existingPreferences.recentJobIds,
                 }, jobId);
                 res.status(201).json(this.enrichRunForResponse(run));
+                // Background sync: refresh the local FRAIM catalog so the next job
+                // picker load sees any jobs that were added or updated since last run.
+                try {
+                    const syncChild = (0, child_process_1.spawn)('npx', ['fraim', 'sync'], { cwd: projectPath, detached: true, stdio: 'ignore' });
+                    syncChild.on('error', () => { });
+                    syncChild.unref();
+                }
+                catch { /* ignore if spawn itself throws synchronously */ }
             }
             catch (error) {
                 res.status(400).json({ error: error instanceof Error ? error.message : 'Could not start run.' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim",
-  "version": "2.0.132",
+  "version": "2.0.134",
   "description": "FRAIM CLI - Framework for Rigor-based AI Management (alias for fraim-framework)",
   "main": "index.js",
   "bin": {

package/public/ai-hub/script.js

@@ -951,18 +951,22 @@ function fraimInvocationFor(employeeId, jobId, kind) {
 // invocation. The wrapped text is what we ACTUALLY send to the host CLI
 // AND what we show in the timeline so the manager sees what the agent
 // received.
-function buildAgentMessage(employeeId, jobId, kind, instructions) {
+function buildAgentMessage(employeeId, jobId, kind, instructions, stubPath) {
   const invocation = fraimInvocationFor(employeeId, jobId, kind);
+  const stub = (kind === 'start' && stubPath) ? `\n[Job stub: ${stubPath}]` : '';
   const trimmed = (instructions || '').trim();
-  if (!trimmed) return invocation;
-  return `${invocation}\n\n${trimmed}`;
+  if (!trimmed) return `${invocation}${stub}`;
+  return `${invocation}${stub}\n\n${trimmed}`;
 }
 
 async function startRun(job, instructions, employeeId) {
   // Prefix the manager's typed instructions with the FRAIM invocation so
   // the underlying host actually launches the right job. The prefixed
   // text is what the host receives AND what we show in the timeline.
-  const agentMessage = buildAgentMessage(employeeId, job.id, 'start', instructions);
+  const absoluteStubPath = (job.stubPath && state.projectPath)
+    ? [state.projectPath, job.stubPath].join('/').replace(/\\/g, '/').replace(/\/+/g, '/')
+    : job.stubPath;
+  const agentMessage = buildAgentMessage(employeeId, job.id, 'start', instructions, absoluteStubPath);
   const conv = {
     id: newConversationId(),
     projectPath: state.projectPath,
@@ -1266,6 +1270,16 @@ function wireEvents() {
     return;
   }
 
+  // Auto-onboard: if the project hasn't been set up with FRAIM and there's no
+  // existing conversation for it, kick off the onboarding job automatically.
+  if (state.bootstrap && state.bootstrap.project && state.bootstrap.project.needsOnboarding) {
+    const existing = activeConversation();
+    if (!existing || existing.projectPath !== state.projectPath) {
+      await autoOnboardProject();
+      return;
+    }
+  }
+
   // If an active conversation belongs to the loaded project and is still running, resume polling.
   const conv = activeConversation();
   if (conv && conv.projectPath === state.projectPath) {
@@ -1277,6 +1291,53 @@ function wireEvents() {
   }
 })();
 
+async function autoOnboardProject() {
+  const employeeId = state.selectedEmployeeId || 'claude';
+  const onboardingMessage = "Your AI employee is onboarding to this project. They'll explore the codebase, learn how it's structured, and may ask a few questions so they can contribute meaningfully.";
+  const job = (state.bootstrap && state.bootstrap.jobs || []).find((j) => j.id === 'project-onboarding');
+  if (job) {
+    await startRun(job, onboardingMessage, employeeId);
+    return;
+  }
+  // Fallback: project-onboarding job not in catalog (fraim/ doesn't exist yet) — POST directly.
+  try {
+    const run = await requestJson('/api/ai-hub/runs', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        projectPath: state.projectPath,
+        hostId: employeeId,
+        jobId: 'project-onboarding',
+        message: onboardingMessage,
+      }),
+    });
+    const conv = {
+      id: newConversationId(),
+      projectPath: state.projectPath,
+      title: 'Project Onboarding',
+      jobId: 'project-onboarding',
+      jobTitle: 'Project Onboarding',
+      employeeId,
+      runId: run.id,
+      sessionId: run.sessionId || null,
+      status: 'running',
+      messages: [{ role: 'manager', text: onboardingMessage, at: Date.now() }],
+      events: [],
+      artifacts: [],
+      lastUpdatedAt: Date.now(),
+    };
+    foldRunIntoConversation(conv, run);
+    upsertConversation(conv);
+    state.activeId = conv.id;
+    persistConversations();
+    renderRail();
+    renderActive();
+    startPolling();
+  } catch (err) {
+    showStatus(err.message, true);
+  }
+}
+
 function renderFirstRunLanding() {
   // Show first-run onboarding screen over the normal Hub UI.
   // The user picks a project folder here; clicking Start fires the