fraim-framework 2.0.167 → 2.0.169

package/public/first-run/styles.css

@@ -421,14 +421,209 @@ body {
   flex-direction: column;
 }
 
-.recruit-container,
-.start-container {
-  gap: 12px;
-}
-
-.start-container {
-  gap: 14px;
-}
+.setup-shell {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: grid;
+  grid-template-columns: minmax(190px, 0.85fr) minmax(0, 2fr);
+  gap: 20px;
+}
+.setup-steps {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  border-right: 1px solid var(--line);
+  padding-right: 16px;
+}
+.setup-step {
+  width: 100%;
+  min-height: 44px;
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: var(--surface);
+  color: var(--text);
+  padding: 9px 10px;
+  font: inherit;
+  font-weight: 600;
+  text-align: left;
+  cursor: pointer;
+}
+.setup-step[aria-current="step"] {
+  border-color: var(--accent);
+  background: var(--accent-soft);
+}
+.setup-step:disabled {
+  opacity: 0.55;
+  cursor: not-allowed;
+}
+.step-dot {
+  width: 24px;
+  height: 24px;
+  border-radius: 50%;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--line);
+  color: var(--muted);
+  font-size: 12px;
+  flex: 0 0 auto;
+}
+.setup-step[data-status="done"] .step-dot {
+  background: var(--accent);
+  color: #fff;
+}
+.setup-pane {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+.setup-pane h2 {
+  margin: 0;
+  font-size: 18px;
+  font-weight: 650;
+}
+.pane-copy,
+.locked-note {
+  margin: 0;
+  color: var(--muted);
+  font-size: 14px;
+}
+.locked-note { color: var(--warn); }
+.row-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  border: 1px solid var(--line);
+  border-radius: 10px;
+  overflow: hidden;
+}
+.row-list .row {
+  display: flex;
+  gap: 10px;
+  align-items: center;
+  padding: 12px;
+  border-bottom: 1px solid var(--line);
+}
+.row-list .row:last-child { border-bottom: 0; }
+.agent-grid,
+.choice-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 12px;
+}
+.ready-strip {
+  background: var(--accent-soft);
+  border: 1px solid var(--accent);
+  color: var(--accent-strong);
+  border-radius: 8px;
+  padding: 10px 12px;
+  font-size: 13px;
+  font-weight: 600;
+}
+.ready-strip--muted {
+  background: var(--soft);
+  border-color: var(--line);
+  color: var(--muted);
+}
+.ready-strip--error {
+  background: #fff1f2;
+  border-color: #fb7185;
+  color: #9f1239;
+}
+.btn {
+  border-radius: 8px;
+  padding: 9px 14px;
+  font: inherit;
+  font-weight: 600;
+  cursor: pointer;
+  border: 1px solid var(--line);
+  align-self: flex-start;
+}
+.btn:disabled {
+  opacity: 0.55;
+  cursor: not-allowed;
+}
+.btn-primary {
+  background: var(--accent);
+  border-color: var(--accent);
+  color: #fff;
+}
+.btn-primary:hover { background: var(--accent-strong); }
+.btn-secondary {
+  background: var(--surface);
+  color: var(--accent-strong);
+}
+.btn-secondary:hover {
+  border-color: var(--accent);
+  background: var(--soft);
+}
+.btn-ghost {
+  background: transparent;
+  color: var(--muted);
+}
+.modal-backdrop {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 18px;
+  background: rgba(31, 42, 36, 0.36);
+}
+.modal {
+  width: min(520px, 100%);
+  background: var(--surface);
+  border: 1px solid var(--line);
+  border-radius: 12px;
+  box-shadow: var(--shadow-lg);
+  padding: 22px;
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+.modal h2 {
+  margin: 0;
+  font-size: 19px;
+}
+.install-status {
+  margin: 0;
+  border: 1px solid var(--line);
+  background: var(--soft);
+  border-radius: 8px;
+  padding: 10px 12px;
+  color: var(--muted);
+}
+.install-status[data-tone="error"] {
+  color: var(--danger);
+  background: #fbf1f1;
+  border-color: var(--danger);
+}
+.modal-help {
+  margin: -4px 0 0;
+  color: var(--muted);
+  font-size: 13px;
+  line-height: 1.45;
+}
+.install-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.recruit-container,
+.start-container {
+  gap: 12px;
+}
+
+.start-container {
+  gap: 14px;
+}
 
 .user-type-card {
   background: var(--surface);
@@ -448,23 +643,23 @@ body {
   border-color: var(--accent);
   background: var(--accent-soft);
 }
-.user-type-card--featured:hover {
-  box-shadow: 0 4px 20px rgba(61, 138, 110, 0.18);
-}
-
-.user-type-card--ide-default {
-  padding: 24px;
-  gap: 18px;
-}
-
-.user-type-card--compact {
-  padding: 16px 18px;
-  gap: 12px;
-}
-
-.user-type-card--alpha {
-  background: linear-gradient(180deg, #fbfcfa 0%, #f4f7f2 100%);
-}
+.user-type-card--featured:hover {
+  box-shadow: 0 4px 20px rgba(61, 138, 110, 0.18);
+}
+
+.user-type-card--ide-default {
+  padding: 24px;
+  gap: 18px;
+}
+
+.user-type-card--compact {
+  padding: 16px 18px;
+  gap: 12px;
+}
+
+.user-type-card--alpha {
+  background: linear-gradient(180deg, #fbfcfa 0%, #f4f7f2 100%);
+}
 
 .card-header {
   display: flex;
@@ -492,38 +687,38 @@ body {
   border-color: var(--accent);
 }
 
-.card-title {
-  display: block;
-  font-size: 15px;
-  font-weight: 600;
-  color: var(--text);
-  margin-bottom: 3px;
-}
-.card-desc { margin: 0; font-size: 13px; color: var(--muted); line-height: 1.45; }
-
-.card-eyebrow {
-  display: inline-flex;
-  align-self: flex-start;
-  padding: 4px 10px;
-  border-radius: 999px;
-  background: var(--accent-soft);
-  color: var(--accent-strong);
-  font-size: 11px;
-  font-weight: 700;
-  letter-spacing: 0.06em;
-  text-transform: uppercase;
-}
-
-.route-note {
-  margin: 0;
-  color: var(--muted);
-  font-size: 13px;
-  line-height: 1.5;
-}
-
-.route-note--compact {
-  font-size: 12px;
-}
+.card-title {
+  display: block;
+  font-size: 15px;
+  font-weight: 600;
+  color: var(--text);
+  margin-bottom: 3px;
+}
+.card-desc { margin: 0; font-size: 13px; color: var(--muted); line-height: 1.45; }
+
+.card-eyebrow {
+  display: inline-flex;
+  align-self: flex-start;
+  padding: 4px 10px;
+  border-radius: 999px;
+  background: var(--accent-soft);
+  color: var(--accent-strong);
+  font-size: 11px;
+  font-weight: 700;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+}
+
+.route-note {
+  margin: 0;
+  color: var(--muted);
+  font-size: 13px;
+  line-height: 1.5;
+}
+
+.route-note--compact {
+  font-size: 12px;
+}
 
 .btn {
   display: inline-flex;
@@ -567,14 +762,25 @@ body {
 .recruit-card {
   cursor: default;
 }
+
+.byoa-card {
+  grid-column: 1 / -1;
+}
+
+.byoa-card .cmd-block {
+  align-self: flex-start;
+  display: inline-block;
+  white-space: nowrap;
+  word-break: normal;
+}
 .recruit-card:hover {
   box-shadow: none;
   border-color: var(--line);
 }
 
-/* IDE command display — shown after choosing "In my IDE". */
-.cmd-block {
-  background: #0d1410;
+/* IDE command display — shown after choosing "In my IDE". */
+.cmd-block {
+  background: #0d1410;
   color: #c8d3cd;
   font-family: "JetBrains Mono", "Cascadia Code", Consolas, monospace;
   font-size: 14px;
@@ -612,16 +818,25 @@ body {
  * want the surface to degrade gracefully for users who happen to open it
  * in a narrow window. Stack the label / verb / change link vertically and
  * let the row breathe. */
-@media (max-width: 600px) {
-  .page { padding: 24px 16px 24px; }
-  .checklist .row { gap: 8px; padding: 12px 14px; }
-  .row .label { min-width: 0; }
-  .row .verb { flex: 1 1 100%; }
-  .row .change-link { margin-left: auto; }
-  .row .project-picker { gap: 8px; }
-  .row .project-picker input { width: 100%; min-width: 0; }
-  .user-type-card--ide-default,
-  .user-type-card--compact {
-    padding: 18px 16px;
-  }
-}
+@media (max-width: 600px) {
+  .page { padding: 24px 16px 24px; }
+  .setup-shell { grid-template-columns: 1fr; }
+  .setup-steps {
+    border-right: 0;
+    border-bottom: 1px solid var(--line);
+    padding-right: 0;
+    padding-bottom: 12px;
+  }
+  .agent-grid,
+  .choice-grid { grid-template-columns: 1fr; }
+  .checklist .row { gap: 8px; padding: 12px 14px; }
+  .row .label { min-width: 0; }
+  .row .verb { flex: 1 1 100%; }
+  .row .change-link { margin-left: auto; }
+  .row .project-picker { gap: 8px; }
+  .row .project-picker input { width: 100%; min-width: 0; }
+  .user-type-card--ide-default,
+  .user-type-card--compact {
+    padding: 18px 16px;
+  }
+}

package/dist/src/config/ai-manager-hiring.js

@@ -1,121 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HUMAN_MANAGER_PROFILES = exports.AI_MANAGER_QUALITIES = exports.HIRING_SERVICES = void 0;
-exports.getHumanManagerProfile = getHumanManagerProfile;
-exports.buildSearchQuery = buildSearchQuery;
-exports.buildJobDescription = buildJobDescription;
-exports.buildServiceUrl = buildServiceUrl;
-exports.buildManagerHiringCatalog = buildManagerHiringCatalog;
-/**
- * Issue #538 — human-manager hiring engine (app side).
- *
- * Self-contained on purpose: the app (AI Hub UI modal + bootstrap) must resolve this
- * at runtime in every packaging context (dev tsx, compiled dist, packed CLI), so it
- * must NOT import across the app→registry boundary. The `hire-the-right-human-ai-manager`
- * job uses the mirror engine `registry/scripts/ai-manager-hiring.ts` (self-contained +
- * CLI). The two are kept identical by a parity test (tests/isolated/test-538-ai-manager-hiring.ts);
- * that is the DRY contract — one behavior, enforced, with no fragile cross-boundary import.
- */
-const persona_hiring_1 = require("./persona-hiring");
-exports.HIRING_SERVICES = ['linkedin', 'indeed', 'seekout'];
-/** The qualities of a strong AI manager — embedded in both the query and the JD. */
-exports.AI_MANAGER_QUALITIES = [
-    { title: 'Clear specification & written communication', detail: 'Can brief an AI agent so it executes correctly the first time.' },
-    { title: 'Trust-but-verify judgment', detail: 'Knows when to delegate to the agent and when to review deeply.' },
-    { title: 'Coaching mindset', detail: 'Gives feedback that compounds into reusable rules and learnings.' },
-    { title: 'Outcome ownership & AI fluency', detail: 'Owns results; comfortable directing autonomous agents.' },
-];
-const GENERALIST_PROFILE = {
-    humanTitle: 'Manager',
-    keywords: ['"Manager"', '"Director"', '"Team Lead"', '"Chief of Staff"'],
-};
-/** Role key -> the human manager best suited to manage that AI employee. Mirror of registry/scripts/ai-manager-hiring.ts. */
-exports.HUMAN_MANAGER_PROFILES = {
-    maestro: { humanTitle: 'Co-Founder / General Manager', keywords: ['"Co-Founder"', '"General Manager"', '"Chief of Staff"', '"Founder"'] },
-    beza: { humanTitle: 'Head of Strategy', keywords: ['"Head of Strategy"', '"Strategy Director"', '"Chief of Staff"'] },
-    pam: { humanTitle: 'Head of Product', keywords: ['"Head of Product"', '"Group Product Manager"', '"Director of Product"'] },
-    swen: { humanTitle: 'Engineering Manager', keywords: ['"Engineering Manager"', '"Tech Lead"', '"Staff Software Engineer"'] },
-    qasm: { humanTitle: 'QA Manager', keywords: ['"QA Manager"', '"QA Lead"', '"Head of Quality"'] },
-    huxley: { humanTitle: 'Design Manager', keywords: ['"Design Manager"', '"Head of Design"', '"Design Lead"'] },
-    gautam: { humanTitle: 'Marketing Director', keywords: ['"Head of Growth"', '"Marketing Director"', '"Demand Generation Lead"'] },
-    cela: { humanTitle: 'General Counsel', keywords: ['"General Counsel"', '"Head of Legal"', '"Legal Director"'] },
-    sekhar: { humanTitle: 'Security Manager', keywords: ['"Security Manager"', '"Head of Security"', '"CISO"'] },
-    ashley: { humanTitle: 'Chief of Staff', keywords: ['"Chief of Staff"', '"Executive Operations Manager"', '"Office Manager"'] },
-    mandy: { humanTitle: 'Head of Operations', keywords: ['"Head of Operations"', '"Director of Operations"', '"Program Manager"'] },
-    ricardo: { humanTitle: 'Recruiting Manager', keywords: ['"Recruiting Manager"', '"Head of Talent"', '"Talent Acquisition Lead"'] },
-    hari: { humanTitle: 'HR Manager', keywords: ['"HR Manager"', '"Head of People"', '"HR Business Partner"'] },
-    careena: { humanTitle: 'Head of Talent Development', keywords: ['"Head of Talent Development"', '"L&D Manager"', '"Career Coaching Lead"'] },
-    sade: { humanTitle: 'Salesforce Manager', keywords: ['"Salesforce Manager"', '"CRM Lead"', '"Salesforce Architect"'] },
-    sam: { humanTitle: 'Sales Manager', keywords: ['"Sales Manager"', '"Head of Sales"', '"Director of Sales"'] },
-    casey: { humanTitle: 'Customer Success Manager', keywords: ['"Customer Success Manager"', '"Head of Customer Success"', '"Support Manager"'] },
-    deidre: { humanTitle: 'Head of DEI', keywords: ['"Head of DEI"', '"Director of Inclusion"', '"DEI Program Manager"'] },
-    mona: { humanTitle: 'Finance Manager', keywords: ['"Finance Manager"', '"Head of Finance"', '"Controller"'] },
-    sreya: { humanTitle: 'SRE Manager', keywords: ['"SRE Manager"', '"Head of Reliability"', '"Platform Engineering Lead"'] },
-    procella: { humanTitle: 'Procurement Manager', keywords: ['"Procurement Manager"', '"Head of Procurement"', '"Sourcing Lead"'] },
-    banke: { humanTitle: 'KYC Operations Manager', keywords: ['"KYC Operations Manager"', '"AML Compliance Manager"', '"Banking Compliance Lead"'] },
-    auditya: { humanTitle: 'Audit Manager', keywords: ['"Audit Manager"', '"Internal Audit Lead"', '"Compliance Audit Manager"'] },
-};
-function getHumanManagerProfile(roleKey) {
-    return exports.HUMAN_MANAGER_PROFILES[roleKey] ?? GENERALIST_PROFILE;
-}
-const AI_MANAGER_QUERY_TERMS = '("AI" OR "LLM" OR "agentic") AND ("coaching" OR "mentoring")';
-function buildSearchQuery(roleKey) {
-    const profile = getHumanManagerProfile(roleKey);
-    return `${profile.keywords.join(' OR ')} AND ${AI_MANAGER_QUERY_TERMS}`;
-}
-function buildJobDescription(roleKey) {
-    const profile = getHumanManagerProfile(roleKey);
-    const role = persona_hiring_1.PERSONA_HIRE_CATALOG[roleKey]?.role ?? 'AI Employee';
-    return [
-        `${profile.humanTitle} — manager for an ${role}`,
-        '',
-        `You will manage an ${role} (an autonomous AI agent) and the humans around it, owning the outcomes it ships.`,
-        '',
-        "What you'll do:",
-        `- Write crisp specifications and acceptance criteria the ${role} can execute against.`,
-        `- Review the agent's output with judgment: know when to trust it and when to dig in.`,
-        '- Coach the agent and team so feedback compounds into reusable rules.',
-        '- Own delivery outcomes, not activity; prioritize ruthlessly.',
-        '',
-        'What makes a strong AI manager:',
-        ...exports.AI_MANAGER_QUALITIES.map((q) => `- ${q.title}: ${q.detail}`),
-    ].join('\n');
-}
-function buildServiceUrl(service, query, location) {
-    const q = encodeURIComponent(query);
-    const loc = location && location.trim().length > 0 ? location.trim() : '';
-    switch (service) {
-        case 'linkedin':
-            return `https://www.linkedin.com/search/results/people/?keywords=${q}`;
-        case 'indeed':
-            return `https://www.indeed.com/jobs?q=${q}${loc ? `&l=${encodeURIComponent(loc)}` : ''}`;
-        case 'seekout':
-            return 'https://app.seekout.com/';
-    }
-}
-/**
- * Catalog projection for the AI Hub bootstrap so the client renders off the server's
- * source of truth. Defaults to exactly the hireable personas in `PERSONA_HIRE_CATALOG`.
- */
-function buildManagerHiringCatalog(roleKeys = Object.keys(persona_hiring_1.PERSONA_HIRE_CATALOG)) {
-    const roles = {};
-    for (const key of roleKeys) {
-        const profile = getHumanManagerProfile(key);
-        const query = buildSearchQuery(key);
-        // managedRole is derived from PERSONA_HIRE_CATALOG so the bootstrap response
-        // shape is unchanged even after removing the field from HumanManagerProfile.
-        const managedRole = persona_hiring_1.PERSONA_HIRE_CATALOG[key]?.role ?? 'AI Employee';
-        roles[key] = {
-            ...profile,
-            managedRole,
-            query,
-            jobDescription: buildJobDescription(key),
-            serviceUrls: {
-                linkedin: buildServiceUrl('linkedin', query),
-                indeed: buildServiceUrl('indeed', query),
-                seekout: buildServiceUrl('seekout', query),
-            },
-        };
-    }
-    return { qualities: exports.AI_MANAGER_QUALITIES, services: exports.HIRING_SERVICES, roles };
-}

package/dist/src/config/compat.js

@@ -1,16 +0,0 @@
-"use strict";
-/**
- * Compatibility configuration for FRAIM.
- * This file defines breaking changes and minimum required versions for clients.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBreakingChangesNotice = exports.MINIMUM_CLIENT_VERSION = void 0;
-exports.MINIMUM_CLIENT_VERSION = '2.0.94';
-/**
- * Notice template for clients running outdated versions.
- * This is appended to tool responses to guide users toward the standardized setup.
- */
-const getBreakingChangesNotice = (currentVersion) => {
-    return `\n\n---\n\n> [!WARNING] migration_notice\n> **Action Required**: You are using an outdated FRAIM configuration (v${currentVersion}). FRAIM requires at least v${exports.MINIMUM_CLIENT_VERSION}.\n> \n> To fix this permanently so you never have to update again, please run this terminal command **once**:\n> \`\`\`bash\n> npx fraim@latest setup\n> \`\`\`\n> Then restart your IDE.`;
-};
-exports.getBreakingChangesNotice = getBreakingChangesNotice;

package/dist/src/config/feature-flags.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFeatureFlags = getFeatureFlags;
-exports.isPersonaEntitlementsEnabled = isPersonaEntitlementsEnabled;
-exports.getPublicFeatureFlags = getPublicFeatureFlags;
-function parseBooleanFlag(value) {
-    if (!value)
-        return false;
-    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
-}
-function getFeatureFlags() {
-    return {
-        personaEntitlements: {
-            enabled: parseBooleanFlag(process.env.FRAIM_FF_PERSONA_ENTITLEMENTS)
-        }
-    };
-}
-function isPersonaEntitlementsEnabled() {
-    return getFeatureFlags().personaEntitlements.enabled;
-}
-function getPublicFeatureFlags() {
-    return {
-        personaEntitlementsEnabled: isPersonaEntitlementsEnabled()
-    };
-}