@arvoretech/hub 0.18.0 → 0.19.0

package/dist/{chunk-UAJWXUMU.js → chunk-FMBCFOVH.js}

@@ -117,7 +117,7 @@ async function checkAndAutoRegenerate(hubDir) {
       return;
     }
     console.log(chalk.yellow("\n  Detected outdated configs, auto-regenerating..."));
-    const { generators: generators2 } = await import("./generate-MZP6TEFI.js");
+    const { generators: generators2 } = await import("./generate-J6FNJF7F.js");
     const generator = generators2[result.editor];
     if (!generator) {
       console.log(chalk.red(`  Unknown editor '${result.editor}' in cache. Run 'hub generate' manually.`));
@@ -446,7 +446,11 @@ var STEP_INFO = {
   role: { title: "What's your role?", subtitle: "e.g. CEO, Product Manager, Designer, Backend Dev, QA Engineer..." },
   technical_level: { title: "How technical are you?", subtitle: "This changes how the AI explains things to you." },
   context: { title: "Anything else the AI should know about you?", subtitle: `e.g. "I focus on business metrics", "I only work on the mobile app", "I review PRs but don't code"` },
-  language: { title: "What language should the AI use?", subtitle: "e.g. English, Portugu\xEAs, Espa\xF1ol..." }
+  language: { title: "What language should the AI use?", subtitle: "e.g. English, Portugu\xEAs, Espa\xF1ol..." },
+  github_username: { title: "What's your GitHub username?", subtitle: "Used for branch naming and PR assignments. (optional \u2014 press Enter to skip)" },
+  aws_profiles: { title: "What AWS profiles do you use?", subtitle: 'Format: profile-name:description (one per line). e.g. "my-company-prd:Production account". Press Enter to skip.' },
+  focus_areas: { title: "What areas do you focus on?", subtitle: 'e.g. "infrastructure and costs", "frontend UX", "backend APIs", "mobile app". (optional)' },
+  timezone: { title: "What's your timezone?", subtitle: "e.g. America/Sao_Paulo, US/Eastern, Europe/London. (optional)" }
 };
 function PersonaApp({ existing, onComplete }) {
   const { stdout } = useStdout();
@@ -459,7 +463,12 @@ function PersonaApp({ existing, onComplete }) {
     role: existing?.role || "",
     context: existing?.context || "",
     technical_level: existing?.technical_level || "intermediate",
-    language: existing?.language || "English"
+    language: existing?.language || "English",
+    aws_profiles: existing?.aws_profiles || [],
+    github_username: existing?.github_username || "",
+    slack_display_name: existing?.slack_display_name || "",
+    focus_areas: existing?.focus_areas || "",
+    timezone: existing?.timezone || ""
   });
   const [inputValue, setInputValue] = useState(existing?.name || "");
   const [levelCursor, setLevelCursor] = useState(
@@ -487,7 +496,13 @@ function PersonaApp({ existing, onComplete }) {
     }
     if (step === "review") {
       if (key.return || input === "y") {
-        onComplete(data);
+        const cleanedData = { ...data };
+        if (!cleanedData.github_username) delete cleanedData.github_username;
+        if (!cleanedData.slack_display_name) delete cleanedData.slack_display_name;
+        if (!cleanedData.focus_areas) delete cleanedData.focus_areas;
+        if (!cleanedData.timezone) delete cleanedData.timezone;
+        if (!cleanedData.aws_profiles?.length) delete cleanedData.aws_profiles;
+        onComplete(cleanedData);
         goTo("done");
       }
       if (input === "b" || key.leftArrow) {
@@ -580,19 +595,91 @@ function PersonaApp({ existing, onComplete }) {
             value: inputValue,
             onChange: setInputValue,
             onSubmit: (v) => {
-              handleTextSubmit(v || "English", "language", "review");
+              handleTextSubmit(v || "English", "language", "github_username");
             },
             placeholder: "English"
           }
         )
       ] }),
+      step === "github_username" && /* @__PURE__ */ jsxs(Box, { children: [
+        /* @__PURE__ */ jsx(Text, { color: colors.brand, bold: true, children: "\u276F " }),
+        /* @__PURE__ */ jsx(
+          TextInput,
+          {
+            value: inputValue,
+            onChange: setInputValue,
+            onSubmit: (v) => {
+              setData((prev) => ({ ...prev, github_username: v.trim() }));
+              setInputValue(data.aws_profiles?.map((p) => `${p.name}:${p.description}`).join(", ") || "");
+              goTo("aws_profiles");
+            },
+            placeholder: "(optional \u2014 press Enter to skip)"
+          }
+        )
+      ] }),
+      step === "aws_profiles" && /* @__PURE__ */ jsx(Box, { flexDirection: "column", children: /* @__PURE__ */ jsxs(Box, { children: [
+        /* @__PURE__ */ jsx(Text, { color: colors.brand, bold: true, children: "\u276F " }),
+        /* @__PURE__ */ jsx(
+          TextInput,
+          {
+            value: inputValue,
+            onChange: setInputValue,
+            onSubmit: (v) => {
+              const profiles = v.trim() ? v.split(",").map((p) => {
+                const [name, ...descParts] = p.trim().split(":");
+                return { name: name.trim(), description: descParts.join(":").trim() || name.trim() };
+              }).filter((p) => p.name) : [];
+              setData((prev) => ({ ...prev, aws_profiles: profiles }));
+              setInputValue(data.focus_areas || "");
+              goTo("focus_areas");
+            },
+            placeholder: "my-prd:Production, my-stg:Staging (optional)"
+          }
+        )
+      ] }) }),
+      step === "focus_areas" && /* @__PURE__ */ jsxs(Box, { children: [
+        /* @__PURE__ */ jsx(Text, { color: colors.brand, bold: true, children: "\u276F " }),
+        /* @__PURE__ */ jsx(
+          TextInput,
+          {
+            value: inputValue,
+            onChange: setInputValue,
+            onSubmit: (v) => {
+              setData((prev) => ({ ...prev, focus_areas: v.trim() }));
+              setInputValue(data.timezone || "");
+              goTo("timezone");
+            },
+            placeholder: "(optional \u2014 press Enter to skip)"
+          }
+        )
+      ] }),
+      step === "timezone" && /* @__PURE__ */ jsxs(Box, { children: [
+        /* @__PURE__ */ jsx(Text, { color: colors.brand, bold: true, children: "\u276F " }),
+        /* @__PURE__ */ jsx(
+          TextInput,
+          {
+            value: inputValue,
+            onChange: setInputValue,
+            onSubmit: (v) => {
+              setData((prev) => ({ ...prev, timezone: v.trim() }));
+              setInputValue("");
+              goTo("review");
+            },
+            placeholder: "America/Sao_Paulo (optional)"
+          }
+        )
+      ] }),
       step === "review" && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
         /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingLeft: 1, borderStyle: "round", borderColor: colors.dim, paddingRight: 1, children: [
           /* @__PURE__ */ jsx(ReviewRow, { label: "Name", value: data.name }),
           /* @__PURE__ */ jsx(ReviewRow, { label: "Role", value: data.role }),
           /* @__PURE__ */ jsx(ReviewRow, { label: "Level", value: TECHNICAL_LEVELS.find((l) => l.value === data.technical_level)?.label || data.technical_level }),
           data.context && /* @__PURE__ */ jsx(ReviewRow, { label: "Context", value: data.context }),
-          /* @__PURE__ */ jsx(ReviewRow, { label: "Language", value: data.language })
+          /* @__PURE__ */ jsx(ReviewRow, { label: "Language", value: data.language }),
+          data.github_username && /* @__PURE__ */ jsx(ReviewRow, { label: "GitHub", value: data.github_username }),
+          data.aws_profiles && data.aws_profiles.length > 0 && /* @__PURE__ */ jsx(ReviewRow, { label: "AWS", value: data.aws_profiles.map((p) => `${p.name} (${p.description})`).join(", ") }),
+          data.focus_areas && /* @__PURE__ */ jsx(ReviewRow, { label: "Focus", value: data.focus_areas }),
+          data.timezone && /* @__PURE__ */ jsx(ReviewRow, { label: "Timezone", value: data.timezone })
         ] }),
         /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsxs(Text, { color: colors.dim, children: [
           /* @__PURE__ */ jsx(Text, { color: colors.brand, children: "enter" }),
@@ -684,6 +771,28 @@ ${persona.name} is an experienced developer. Communicate directly:
 - Be concise and technical. Skip basic explanations.
 - Focus on trade-offs, edge cases, and non-obvious implications.
 - Show code directly without hand-holding.`);
+  }
+  if (persona.focus_areas) {
+    lines.push(`
+${persona.name} focuses on: ${persona.focus_areas}. Prioritize these areas in suggestions and discussions.`);
+  }
+  if (persona.aws_profiles?.length) {
+    lines.push(`
+### AWS Profiles
+`);
+    for (const profile of persona.aws_profiles) {
+      lines.push(`- \`${profile.name}\`: ${profile.description}`);
+    }
+    lines.push(`
+When running AWS commands, ask which environment if not clear from context.`);
+  }
+  if (persona.github_username) {
+    lines.push(`
+GitHub username: **${persona.github_username}**`);
+  }
+  if (persona.timezone) {
+    lines.push(`
+Timezone: ${persona.timezone}`);
   }
   if (persona.context) {
     lines.push(`
@@ -695,6 +804,32 @@ Always communicate with ${persona.name} in **${persona.language}**.`);
   }
   return lines.join("\n");
 }
+function buildPersonaEditorFile(persona, editor) {
+  const content = buildPersonaSection(persona);
+  if (editor === "kiro") {
+    return `---
+inclusion: always
+name: persona
+---
+
+# Persona \u2014 ${persona.name}
+${content}
+`;
+  }
+  if (editor === "cursor") {
+    return `---
+description: "Personal AI profile for ${persona.name}"
+alwaysApply: true
+---
+
+# Persona \u2014 ${persona.name}
+${content}
+`;
+  }
+  return `# Persona \u2014 ${persona.name}
+${content}
+`;
+}
 var personaCommand = new Command("persona").description("Set up your personal AI profile \u2014 adapts how the agent communicates with you").action(async () => {
   const hubDir = process.cwd();
   const hubPath = join3(hubDir, ".hub");
@@ -749,6 +884,18 @@ function buildDesignSection(config) {
   const parts = [];
   parts.push(`
 ## Design System`);
+  if (design.enforce && design.skills?.length) {
+    const skillList = design.skills.map((s) => `\`${s}\``).join(", ");
+    parts.push(`
+**DESIGN ENFORCEMENT \u2014 MANDATORY**
+
+Before creating or modifying ANY UI component, page, or visual element:
+1. Consult the design skill(s): ${skillList}
+2. Use ONLY the design tokens, colors, spacing, and typography defined in the design system
+3. Do NOT invent custom styles, colors, or spacing values \u2014 always reference the design tokens
+4. If a component exists in the design system or component library, use it instead of creating a new one
+5. After implementing UI changes, verify that the output follows the design system guidelines`);
+  }
   if (design.instructions) {
     parts.push(`
 ${design.instructions.trim()}`);
@@ -1007,12 +1154,13 @@ async function generateCursor(config, hubDir) {
   const cleanedOrchestratorForAgents = orchestratorRule.replace(/^---[\s\S]*?---\n/m, "").trim();
   const skillsSectionCursor = await buildSkillsSection(hubDir, config);
   const personaCursor = await loadPersona(hubDir);
-  const personaSectionCursor = personaCursor ? buildPersonaSection(personaCursor) : "";
-  const agentsMdCursor = [cleanedOrchestratorForAgents, skillsSectionCursor, personaSectionCursor].filter(Boolean).join("\n");
+  const agentsMdCursor = [cleanedOrchestratorForAgents, skillsSectionCursor].filter(Boolean).join("\n");
   await writeFile4(join4(hubDir, "AGENTS.md"), agentsMdCursor + "\n", "utf-8");
   console.log(chalk3.green("  Generated AGENTS.md"));
   if (personaCursor) {
-    console.log(chalk3.green(`  Applied persona: ${personaCursor.name} (${personaCursor.role})`));
+    const personaRuleContent = buildPersonaEditorFile(personaCursor, "cursor");
+    await writeFile4(join4(cursorDir, "rules", "persona.mdc"), personaRuleContent, "utf-8");
+    console.log(chalk3.green(`  Generated .cursor/rules/persona.mdc (${personaCursor.name}, ${personaCursor.role})`));
   }
   const hubSteeringDirCursor = resolve2(hubDir, "steering");
   try {
@@ -1538,7 +1686,7 @@ Some MCPs are aggregated behind a proxy (\`${proxyMcp.name}\`). Their tools are
     lines.push(`
 > When you need a capability and are unsure which tool to use, always try \`mcp_search\` first with relevant keywords. The proxy aggregates tools from all upstream MCPs.`);
   }
-  const mcpsWithInstructions = mcps.filter((m) => m.instructions && !m.upstreams);
+  const mcpsWithInstructions = mcps.filter((m) => m.instructions);
   if (mcpsWithInstructions.length > 0) {
     lines.push(`
 ### MCP Instructions`);
@@ -1906,12 +2054,13 @@ async function generateOpenCode(config, hubDir) {
   });
   const skillsSectionOC = await buildSkillsSection(hubDir, config);
   const personaOC = await loadPersona(hubDir);
-  const personaSectionOC = personaOC ? buildPersonaSection(personaOC) : "";
-  const agentsMdOC = [orchestratorContent, skillsSectionOC, personaSectionOC].filter(Boolean).join("\n");
+  const agentsMdOC = [orchestratorContent, skillsSectionOC].filter(Boolean).join("\n");
   await writeFile4(join4(hubDir, "AGENTS.md"), agentsMdOC + "\n", "utf-8");
   console.log(chalk3.green("  Generated AGENTS.md"));
   if (personaOC) {
-    console.log(chalk3.green(`  Applied persona: ${personaOC.name} (${personaOC.role})`));
+    const personaRuleContent = buildPersonaEditorFile(personaOC, "opencode");
+    await writeFile4(join4(opencodeDir, "rules", "persona.md"), personaRuleContent, "utf-8");
+    console.log(chalk3.green(`  Generated .opencode/rules/persona.md (${personaOC.name}, ${personaOC.role})`));
   }
   const hubSteeringDirOC = resolve2(hubDir, "steering");
   try {
@@ -2485,8 +2634,7 @@ async function generateClaudeCode(config, hubDir) {
   const cleanedOrchestrator = orchestratorRule.replace(/^---[\s\S]*?---\n/m, "").trim();
   const skillsSectionClaude = await buildSkillsSection(hubDir, config);
   const personaClaude = await loadPersona(hubDir);
-  const personaSectionClaude = personaClaude ? buildPersonaSection(personaClaude) : "";
-  const agentsMdClaude = [cleanedOrchestrator, skillsSectionClaude, personaSectionClaude].filter(Boolean).join("\n");
+  const agentsMdClaude = [cleanedOrchestrator, skillsSectionClaude].filter(Boolean).join("\n");
   await writeFile4(join4(hubDir, "AGENTS.md"), agentsMdClaude + "\n", "utf-8");
   console.log(chalk3.green("  Generated AGENTS.md"));
   if (personaClaude) {
@@ -2549,6 +2697,10 @@ async function generateClaudeCode(config, hubDir) {
     }
   } catch {
   }
+  if (personaClaude) {
+    claudeMdSections.push(buildPersonaEditorFile(personaClaude, "claude-code"));
+    console.log(chalk3.green(`  Generated persona section in CLAUDE.md (${personaClaude.name}, ${personaClaude.role})`));
+  }
   await writeFile4(join4(hubDir, "CLAUDE.md"), claudeMdSections.join("\n\n"), "utf-8");
   console.log(chalk3.green("  Generated CLAUDE.md"));
   if (config.mcps?.length) {
@@ -2646,12 +2798,13 @@ async function generateKiro(config, hubDir) {
   const kiroRule = buildKiroOrchestratorRule(config);
   const skillsSection = await buildSkillsSection(hubDir, config);
   const personaKiro = await loadPersona(hubDir);
-  const personaSectionKiro = personaKiro ? buildPersonaSection(personaKiro) : "";
-  const kiroRuleWithSkills = [kiroRule, skillsSection, personaSectionKiro].filter(Boolean).join("\n");
+  const kiroRuleWithSkills = [kiroRule, skillsSection].filter(Boolean).join("\n");
   await writeFile4(join4(hubDir, "AGENTS.md"), kiroRuleWithSkills + "\n", "utf-8");
   console.log(chalk3.green("  Generated AGENTS.md"));
   if (personaKiro) {
-    console.log(chalk3.green(`  Applied persona: ${personaKiro.name} (${personaKiro.role})`));
+    const personaSteeringContent = buildPersonaEditorFile(personaKiro, "kiro");
+    await writeFile4(join4(steeringDir, "persona.md"), personaSteeringContent, "utf-8");
+    console.log(chalk3.green(`  Generated .kiro/steering/persona.md (${personaKiro.name}, ${personaKiro.role})`));
   }
   await rm(join4(steeringDir, "orchestrator.md")).catch(() => {
   });
@@ -2951,6 +3104,13 @@ function buildGitignoreLines(config) {
       ".agent-teams/"
     );
   }
+  lines.push(
+    "",
+    "# Persona (personal, not shared)",
+    ".kiro/steering/persona.md",
+    ".cursor/rules/persona.mdc",
+    ".opencode/rules/persona.md"
+  );
   return lines;
 }
 var generators = {

package/dist/config/index.d.ts

@@ -136,6 +136,7 @@ interface DesignConfig {
     libraries?: DesignLibrary[];
     icons?: string;
     instructions?: string;
+    enforce?: boolean;
 }
 interface HubConfig {
     name: string;

package/dist/{generate-MZP6TEFI.js → generate-J6FNJF7F.js}

@@ -1,7 +1,7 @@
 import {
   generateCommand,
   generators
-} from "./chunk-UAJWXUMU.js";
+} from "./chunk-FMBCFOVH.js";
 import "./chunk-VMN4KGAK.js";
 export {
   generateCommand,

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   horizontalLine,
   personaCommand,
   symbols
-} from "./chunk-UAJWXUMU.js";
+} from "./chunk-FMBCFOVH.js";
 import {
   loadHubConfig,
   resolveConfigPath
@@ -4109,6 +4109,7 @@ async function findUnsyncedAssets(hubDir) {
       for (const file of files) {
         if (!file.endsWith(".md")) continue;
         if (file === "orchestrator.md") continue;
+        if (file === "persona.md") continue;
         const canonicalFile = join18(canonicalSteeringDir, file);
         if (existsSync14(canonicalFile)) continue;
         const key = `steering:${file}`;
@@ -4127,6 +4128,7 @@ async function findUnsyncedAssets(hubDir) {
       for (const file of files) {
         if (!file.endsWith(".mdc")) continue;
         if (file === "orchestrator.mdc") continue;
+        if (file === "persona.mdc") continue;
         const mdName = file.replace(/\.mdc$/, ".md");
         const canonicalFile = join18(canonicalSteeringDir, mdName);
         if (existsSync14(canonicalFile)) continue;
@@ -4146,6 +4148,7 @@ async function findUnsyncedAssets(hubDir) {
       for (const file of files) {
         if (!file.endsWith(".md")) continue;
         if (file === "orchestrator.md") continue;
+        if (file === "persona.md") continue;
         const canonicalFile = join18(canonicalSteeringDir, file);
         if (existsSync14(canonicalFile)) continue;
         const key = `steering:${file}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arvoretech/hub",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "CLI for managing AI-aware multi-repository workspaces",
   "main": "dist/index.js",
   "type": "module",