@polymorphism-tech/morph-spec 7.8.1 → 7.9.0

package/src/utils/agent-id-mapper.js

@@ -1,11 +1,11 @@
-/**
- * Map an agents.json ID to the Claude Code subagent_type.
- *
- * @param {string} id - Agent ID from agents.json (e.g., "nextjs-expert")
- * @param {number} [tier] - Agent tier (1-4). Defaults to non-validator.
- * @returns {string} subagent_type matching .claude/agents/ filename stem
- */
-export function agentIdToSubagentType(id, tier) {
-  const prefix = tier === 4 ? 'morph-validator-' : 'morph-';
-  return `${prefix}${id}`;
-}
+/**
+ * Map an agents.json ID to the Claude Code subagent_type.
+ *
+ * @param {string} id - Agent ID from agents.json (e.g., "nextjs-expert")
+ * @param {number} [tier] - Agent tier (1-4). Defaults to non-validator.
+ * @returns {string} subagent_type matching .claude/agents/ filename stem
+ */
+export function agentIdToSubagentType(id, tier) {
+  const prefix = tier === 4 ? 'morph-validator-' : 'morph-';
+  return `${prefix}${id}`;
+}

package/src/utils/agents-installer.js

@@ -45,6 +45,26 @@ export function loadKnownMcpIds(frameworkDir) {
   }
 }
 
+/**
+ * Personas install-all default (friction fix, MORPH_GHLBrain 2026-07-11):
+ * with NO known stack tags (greenfield / install before config.json exists)
+ * EVERY persona is generated — a project that dispatches `morph-{id}` must
+ * find the subagent registered, and an install that only lands
+ * morph-evaluator forces every domain dispatch into the general-purpose
+ * fallback. Stack filtering only applies when the project's stack is KNOWN
+ * (tags non-empty): the fallback stays reserved for stacks the project
+ * genuinely does not have. Note this deliberately differs from rules/skills
+ * filtering (stack-filter.js), which stays minimal on greenfield.
+ *
+ * @param {object} agent - agents.json entry (with `stack`)
+ * @param {string[]} projectTags
+ * @returns {boolean}
+ */
+export function agentEligible(agent, projectTags = []) {
+  if (projectTags.length === 0) return true;
+  return shouldInstall(agent.stack ?? ['*'], projectTags);
+}
+
 const MANAGED_HEADER =
   '<!-- MANAGED BY morph-spec — generated from .morph/framework/agents.json (single source of truth).\n' +
   '     Do NOT edit by hand: changes are overwritten on `morph-spec update` / `setup-infra --reinstall`.\n' +
@@ -75,11 +95,8 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
 
   const knownMcpIds = loadKnownMcpIds(frameworkDir);
 
-  // Filter by stack
-  const eligible = agents.filter(a => {
-    const stack = a.stack ?? ['*'];
-    return shouldInstall(stack, projectTags);
-  });
+  // Filter by stack — install-all when the stack is unknown (empty tags).
+  const eligible = agents.filter(a => agentEligible(a, projectTags));
 
   // Build set of all possible filenames for orphan cleanup
   const allPossible = new Set(agents.map(a => `morph-${a.id}.md`));
@@ -231,12 +248,11 @@ export function checkMissingAgents(projectDir, frameworkDir, projectTags = []) {
   let expected = 0;
 
   for (const a of agents) {
-    const stack = a.stack ?? ['*'];
-    if (!shouldInstall(stack, projectTags)) continue;
+    if (!agentEligible(a, projectTags)) continue;
     expected++;
     const filename = `morph-${a.id}.md`;
     if (!installedFiles.has(filename)) {
-      missing.push({ name: a.title ?? a.id, stacks: stack });
+      missing.push({ name: a.title ?? a.id, stacks: a.stack ?? ['*'] });
     }
   }
 
@@ -276,8 +292,7 @@ export function checkAgentsDrift(projectDir, frameworkDir, projectTags = []) {
   let expected = 0;
 
   for (const agent of agents) {
-    const stack = agent.stack ?? ['*'];
-    if (!shouldInstall(stack, projectTags)) continue;
+    if (!agentEligible(agent, projectTags)) continue;
     expected++;
     const filename = `morph-${agent.id}.md`;
     const filePath = join(targetDir, filename);

package/src/utils/banner.js

@@ -1,6 +1,8 @@
 // src/utils/banner.js
 import chalk from "chalk";
-import { type as osType, release as osRelease } from "os";
+import { type as osType, release as osRelease, homedir } from "os";
+import { join } from "path";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
 
 const BRAND = chalk.hex("#7C3AED");
 const DIM = chalk.dim;
@@ -54,6 +56,39 @@ export function renderLogo(version) {
   return `\n${art}\n${rule}\n`;
 }
 
+/**
+ * Print the install banner once per version change, on the first CLI run
+ * after an install/upgrade. npm ≥7 swallows lifecycle-script output, so the
+ * postinstall banner is invisible on a normal `npm i -g` — this is the
+ * fallback that guarantees the next-steps guidance is actually seen.
+ *
+ * Marker: ~/.claude/morph-spec-banner-version (last version shown).
+ * Skips silently when stdout is not a TTY (piped/parsed output) or when
+ * MORPH_QUIET=1. Fail-open: any fs error just skips the banner.
+ *
+ * @param {{version: string, nodeVersion: string, markerDir?: string}} opts
+ * @returns {boolean} true if the banner was printed
+ */
+export function maybePrintFirstRunBanner({ version, nodeVersion, markerDir }) {
+  try {
+    if (!process.stdout.isTTY) return false;
+    if (process.env.MORPH_QUIET === "1") return false;
+
+    const dir = markerDir ?? join(homedir(), ".claude");
+    const marker = join(dir, "morph-spec-banner-version");
+    const last = existsSync(marker) ? readFileSync(marker, "utf8").trim() : null;
+    if (last === version) return false;
+
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(marker, version, "utf8");
+
+    printInstallBanner({ version, nodeVersion, results: [] });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function platformLabel() {
   const t = osType();
   const r = osRelease().split(".").slice(0, 2).join(".");
@@ -78,9 +113,7 @@ export function printInstallBanner({ version, nodeVersion, results = [] }) {
       `  ${DIM("Spec-driven development harness for Claude Code")}`,
       `  ${DIM("by Polymorphism Tech")} ${DIM("·")} ${DIM("Node")} ${chalk.white(nodeVersion)} ${DIM("·")} ${chalk.white(platformLabel())}`,
       "",
-      sep("Installed"),
-      ...itemLines,
-      "",
+      ...(itemLines.length > 0 ? [sep("Installed"), ...itemLines, ""] : []),
       sep("Next · new project"),
       `  ${chalk.cyan("1.")} ${DIM("cd")} ${chalk.white("your-project")} ${DIM("(git repo)")}`,
       `  ${chalk.cyan("2.")} Run ${chalk.bold.white("morph-spec init")}`,