@intent-systems/nexus 2026.1.5-5 → 2026.1.5-8

package/dist/commands/skills-manifest.js

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import fsp from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { MANAGED_SKILLS_DIR } from "../utils.js";
+import { SKILLS_STATE_DIR } from "../utils.js";
 /**
  * Parse skill frontmatter to extract name and description
  */
@@ -16,7 +16,7 @@ function parseSkillFrontmatter(content) {
         return result;
     const block = normalized.slice(4, endIndex);
     for (const line of block.split("\n")) {
-        const match = line.match(/^(name|description):\s*(.*)$/);
+        const match = line.match(/^(name|description|type|metadata):\s*(.*)$/);
         if (!match)
             continue;
         const key = match[1];
@@ -26,10 +26,40 @@ function parseSkillFrontmatter(content) {
             (value.startsWith("'") && value.endsWith("'"))) {
             value = value.slice(1, -1);
         }
-        result[key] = value;
+        if (key === "metadata") {
+            result.metadataRaw = value;
+        }
+        else {
+            result[key] = value;
+        }
     }
     return result;
 }
+function resolveSkillRootDirs(rootDir) {
+    const typedDirs = ["tools", "connectors", "guides"].map((segment) => path.join(rootDir, segment));
+    const existingTyped = typedDirs.filter((dir) => fs.existsSync(dir));
+    if (existingTyped.length > 0)
+        return existingTyped;
+    return fs.existsSync(rootDir) ? [rootDir] : [];
+}
+function resolveSkillType(frontmatter) {
+    if (frontmatter.type === "tool" || frontmatter.type === "connector" || frontmatter.type === "guide") {
+        return frontmatter.type;
+    }
+    if (!frontmatter.metadataRaw)
+        return null;
+    try {
+        const parsed = JSON.parse(frontmatter.metadataRaw);
+        const type = parsed?.nexus?.type;
+        if (type === "tool" || type === "connector" || type === "guide") {
+            return type;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
 /**
  * Resolve the bundled skills directory from the installed Nexus package.
  * This finds skills shipped with the CLI, NOT from user workspace.
@@ -98,6 +128,17 @@ async function scanSkillsDir(dir, source) {
     }
     return skills;
 }
+async function scanSkillRoots(rootDir, source) {
+    const roots = resolveSkillRootDirs(rootDir);
+    const merged = {};
+    for (const root of roots) {
+        const scanned = await scanSkillsDir(root, source);
+        for (const [name, entry] of Object.entries(scanned)) {
+            merged[name] = entry;
+        }
+    }
+    return merged;
+}
 /**
  * Copy bundled skills from installed package to ~/nexus/skills/
  */
@@ -113,29 +154,48 @@ export async function copyBundledSkills(targetDir) {
         return result;
     }
     await fsp.mkdir(targetDir, { recursive: true });
-    const entries = await fsp.readdir(bundledDir, { withFileTypes: true });
-    for (const entry of entries) {
-        if (!entry.isDirectory())
-            continue;
-        if (entry.name.startsWith("."))
-            continue;
-        const sourcePath = path.join(bundledDir, entry.name);
-        const targetPath = path.join(targetDir, entry.name);
-        // Check if SKILL.md exists
-        if (!fs.existsSync(path.join(sourcePath, "SKILL.md")))
-            continue;
-        try {
-            // Check if already exists
-            if (fs.existsSync(targetPath)) {
-                result.skipped.push(entry.name);
+    const bundledRoots = resolveSkillRootDirs(bundledDir);
+    for (const root of bundledRoots) {
+        const entries = await fsp.readdir(root, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
                 continue;
+            if (entry.name.startsWith("."))
+                continue;
+            const sourcePath = path.join(root, entry.name);
+            const skillPath = path.join(sourcePath, "SKILL.md");
+            if (!fs.existsSync(skillPath))
+                continue;
+            let targetBase = targetDir;
+            if (root !== bundledDir) {
+                targetBase = path.join(targetDir, path.basename(root));
+            }
+            else {
+                try {
+                    const content = await fsp.readFile(skillPath, "utf-8");
+                    const frontmatter = parseSkillFrontmatter(content);
+                    const type = resolveSkillType(frontmatter);
+                    if (type) {
+                        targetBase = path.join(targetDir, `${type}s`);
+                    }
+                }
+                catch {
+                    // keep default targetBase
+                }
+            }
+            const targetPath = path.join(targetBase, entry.name);
+            try {
+                await fsp.mkdir(targetBase, { recursive: true });
+                if (fs.existsSync(targetPath)) {
+                    result.skipped.push(entry.name);
+                    continue;
+                }
+                await fsp.cp(sourcePath, targetPath, { recursive: true });
+                result.copied.push(entry.name);
+            }
+            catch (err) {
+                result.errors.push(`${entry.name}: ${err instanceof Error ? err.message : String(err)}`);
             }
-            // Copy recursively
-            await fsp.cp(sourcePath, targetPath, { recursive: true });
-            result.copied.push(entry.name);
-        }
-        catch (err) {
-            result.errors.push(`${entry.name}: ${err instanceof Error ? err.message : String(err)}`);
         }
     }
     return result;
@@ -145,17 +205,17 @@ export async function copyBundledSkills(targetDir) {
  */
 export async function generateSkillManifest(skillsDir, userSkillsDir) {
     // Skills in ~/nexus/skills/ are considered "bundled" (copied from package)
-    // Skills user installs via NexusHub go in a managed/ subfolder or directly
+    // Managed skills live under ~/nexus/skills/managed/
     // User skills are in ~/nexus/home/skills/
-    const bundledSkills = await scanSkillsDir(skillsDir, "bundled");
+    const bundledSkills = await scanSkillRoots(skillsDir, "bundled");
     // Check for managed subfolder (NexusHub installs)
     const managedDir = path.join(skillsDir, "managed");
     const managedSkills = fs.existsSync(managedDir)
-        ? await scanSkillsDir(managedDir, "managed")
+        ? await scanSkillRoots(managedDir, "managed")
         : {};
     // User skills from workspace
     const userSkills = userSkillsDir
-        ? await scanSkillsDir(userSkillsDir, "user")
+        ? await scanSkillRoots(userSkillsDir, "user")
         : {};
     return {
         version: 1,
@@ -178,7 +238,7 @@ export async function generateSkillManifest(skillsDir, userSkillsDir) {
  * Get the path to the skills manifest file
  */
 export function getSkillManifestPath() {
-    return path.join(MANAGED_SKILLS_DIR, "manifest.json");
+    return path.join(SKILLS_STATE_DIR, "manifest.json");
 }
 /**
  * Write the skill manifest to disk

package/dist/commands/status.js

@@ -4,9 +4,7 @@ import { getAggregateStats } from "../agents/skill-usage.js";
 import { detectCapabilities } from "../capabilities/detector.js";
 import { defaultRuntime } from "../runtime.js";
 import { listCredentials } from "./credential.js";
-import { resolveQuestState } from "./quest-state.js";
 const STATUS_BOX_WIDTH = 62;
-const POWER_BOX_WIDTH = 62;
 function clampText(text, width) {
     if (text.length <= width)
         return text;
@@ -30,7 +28,7 @@ const FALLBACK_BOOTSTRAP_PROMPT = `# BOOTSTRAP.md - Welcome to Nexus
 Identity setup is required.
 
 For humans: start a short conversation and share your name, goals, and preferences.
-For agents: write PROFILE.md, IDENTITY.md, SOUL.md, and MEMORY.md as you learn them.
+For agents: write IDENTITY.md, SOUL.md, and MEMORY.md for the agent, plus state/user/IDENTITY.md for the user.
 `;
 function readBootstrapPrompt(pathname) {
     try {
@@ -64,6 +62,12 @@ function formatSuggestions(capabilities) {
         };
     });
 }
+function reindexSuggestions(suggestions) {
+    return suggestions.map((suggestion, idx) => ({
+        ...suggestion,
+        index: idx + 1,
+    }));
+}
 export async function statusCommand(opts, runtime = defaultRuntime) {
     const identityResolution = resolveIdentitySnapshot();
     if (!identityResolution.ok) {
@@ -103,18 +107,6 @@ export async function statusCommand(opts, runtime = defaultRuntime) {
     const usage = showUsage
         ? await getAggregateStats({ windowDays: 7, limit: 3 })
         : null;
-    const questState = showBrief
-        ? null
-        : await resolveQuestState({
-            identityConfigured: identity.hasIdentity,
-            capabilities: capabilitySnapshot?.capabilities ?? [],
-            credentials: credentials ?? {
-                version: 1,
-                lastUpdated: "",
-                services: {},
-            },
-            includeSecrets: true,
-        });
     if (opts.quiet) {
         runtime.exit(bootstrapPrompt ? 2 : 0);
         return;
@@ -130,7 +122,6 @@ export async function statusCommand(opts, runtime = defaultRuntime) {
             capabilities: capabilitySnapshot ?? undefined,
             suggestions,
             usage: usage ?? undefined,
-            power: questState?.power ?? undefined,
         }, null, 2));
         return;
     }
@@ -147,20 +138,23 @@ export async function statusCommand(opts, runtime = defaultRuntime) {
         return;
     }
     runtime.log("\n👤 Identity");
-    runtime.log(`  User: ${identity.userName ?? "(unknown)"} → ${identity.userProfilePath}`);
+    runtime.log(`  User: ${identity.userName ?? "(unknown)"} → ${identity.userIdentityPath}`);
     runtime.log(`  Agent: ${identity.agentName ?? "(unknown)"} (${identity.agentId}) → ${identity.agentIdentityPath}`);
     runtime.log(`         → ${identity.agentSoulPath}`);
-    runtime.log(`         → ${identity.agentMemoryPath}`);
+    const credentialServices = credentials
+        ? Object.entries(credentials.services ?? {})
+        : [];
+    const credentialAccountCount = credentialServices.reduce((sum, [, info]) => sum + (info.accounts?.length ?? 0), 0);
     if (showCredentials && credentials) {
-        const services = Object.entries(credentials.services ?? {});
-        const accountCount = services.reduce((sum, [, info]) => sum + (info.accounts?.length ?? 0), 0);
-        runtime.log(`\n🔑 Credentials (${accountCount} configured)`);
+        runtime.log(`\n🔑 Credentials (${credentialAccountCount} configured)`);
         const statusIcon = {
             active: "✅",
             ready: "⭐",
             broken: "❌",
         };
-        for (const [service, info] of services) {
+        const maxServices = 6;
+        const visibleServices = credentialServices.slice(0, maxServices);
+        for (const [service, info] of visibleServices) {
             const accounts = info.accounts ?? [];
             if (accounts.length === 0) {
                 runtime.log(`  ${service}: none`);
@@ -174,22 +168,32 @@ export async function statusCommand(opts, runtime = defaultRuntime) {
                 runtime.log(`    ${icon} ${account.id} (${status})${suffix}`);
             }
         }
+        if (credentialServices.length > maxServices) {
+            runtime.log(`  … +${credentialServices.length - maxServices} more services`);
+        }
         runtime.log(`  Run 'nexus credential list' for full details`);
     }
     if (showCapabilities && capabilitySnapshot) {
-        runtime.log(`\n🎯 Capabilities (${capabilitySnapshot.summary.active}/${capabilitySnapshot.summary.total} active)`);
-        for (const [category, _entries] of Object.entries(capabilitySnapshot.registry.categories)) {
-            const categoryCaps = capabilitySnapshot.capabilities.filter((cap) => cap.category === category);
-            const activeCount = categoryCaps.filter((cap) => cap.status === "active").length;
-            if (categoryCaps.length === 0)
-                continue;
-            runtime.log(`  ${category} (${activeCount}/${categoryCaps.length})`);
-            const sample = categoryCaps.slice(0, 3);
-            for (const cap of sample) {
+        const { summary } = capabilitySnapshot;
+        runtime.log("\n🎯 Capabilities");
+        runtime.log(`  ✅ active: ${summary.active}  ⭐ ready: ${summary.ready}  🔧 needs-setup: ${summary.needs_setup}  📥 needs-install: ${summary.needs_install}`);
+        if (summary.broken > 0) {
+            runtime.log(`  ❌ broken: ${summary.broken}`);
+        }
+        if (summary.unavailable > 0) {
+            runtime.log(`  ⛔ unavailable: ${summary.unavailable}`);
+        }
+        const quickWins = capabilitySnapshot.capabilities
+            .filter((cap) => cap.status === "ready")
+            .slice(0, 4);
+        if (quickWins.length > 0) {
+            runtime.log("  Quick wins:");
+            for (const cap of quickWins) {
                 const providers = cap.providers.map((p) => p.id).join(", ");
-                runtime.log(`    - ${cap.id}: ${providers || cap.providersRaw}`);
+                runtime.log(`    - ${cap.id}${providers ? ` (${providers})` : ""}`);
             }
         }
+        runtime.log(`  Run 'nexus capabilities' for the full map`);
     }
     if (showUsage && usage) {
         runtime.log("\n📊 Usage (last 7 days)");
@@ -206,29 +210,27 @@ export async function statusCommand(opts, runtime = defaultRuntime) {
         runtime.log(`  Most used: ${mostUsed}`);
         runtime.log(`  Ready but unused: ${readyUnused}`);
     }
-    if (suggestions.length > 0) {
+    let finalSuggestions = suggestions;
+    if (showCredentials && credentials && credentialAccountCount === 0) {
+        finalSuggestions = [
+            {
+                id: "credentials",
+                status: "ready",
+                index: 1,
+                title: "Set up credentials",
+                action: "nexus credential scan --deep",
+            },
+            ...finalSuggestions,
+        ];
+    }
+    finalSuggestions = reindexSuggestions(finalSuggestions).slice(0, 3);
+    if (finalSuggestions.length > 0) {
         runtime.log("\n🎯 Suggestions");
-        for (const suggestion of suggestions) {
+        for (const suggestion of finalSuggestions) {
             runtime.log(`  ${suggestion.index}. ${suggestion.title}`);
             runtime.log(`     → ${suggestion.action}`);
         }
     }
-    if (questState?.power) {
-        const width = 10;
-        const filled = Math.round((questState.power.percent / 100) * width);
-        const bar = `${"#".repeat(filled)}${"-".repeat(width - filled)}`;
-        const lines = [
-            `Power Level: ${bar} ${questState.power.percent}%`,
-            questState.power.nextQuest
-                ? `Next unlock: ${questState.power.nextQuest.title} (+${questState.power.nextQuest.weight}%)`
-                : "Next unlock: none",
-            "Complete the core path to reach 100%",
-        ];
-        runtime.log("");
-        for (const line of renderBox(lines, POWER_BOX_WIDTH)) {
-            runtime.log(line);
-        }
-    }
     runtime.log(`\nNext: run 'nexus capabilities' or 'nexus credential list' for details.`);
 }
 export async function getStatusSummary() {

package/dist/daemon/launchd.js

@@ -74,9 +74,23 @@ export async function readLaunchAgentProgramArguments(env) {
         const workingDirectory = workingDirMatch
             ? plistUnescape(workingDirMatch[1] ?? "").trim()
             : "";
+        const envMatch = plist.match(/<key>EnvironmentVariables<\/key>\s*<dict>([\s\S]*?)<\/dict>/i);
+        let environment;
+        if (envMatch) {
+            const entries = Array.from(envMatch[1].matchAll(/<key>([\s\S]*?)<\/key>\s*<string>([\s\S]*?)<\/string>/gi))
+                .map((match) => [
+                plistUnescape(match[1] ?? "").trim(),
+                plistUnescape(match[2] ?? "").trim(),
+            ])
+                .filter(([key, value]) => key && value);
+            if (entries.length > 0) {
+                environment = Object.fromEntries(entries);
+            }
+        }
         return {
             programArguments: args.filter(Boolean),
             ...(workingDirectory ? { workingDirectory } : {}),
+            ...(environment ? { environment } : {}),
         };
     }
     catch {

package/dist/utils.js

@@ -150,5 +150,9 @@ export function resolveNexusRoot(env = process.env, homedir = os.homedir) {
 }
 // Nexus root directory containing home/ and state/
 export const NEXUS_ROOT = resolveNexusRoot();
-// Managed skills directory lives under state/
-export const MANAGED_SKILLS_DIR = path.join(resolveStateDir(), "skills");
+// Workspace skill definitions live under the Nexus root.
+export const WORKSPACE_SKILLS_DIR = path.join(NEXUS_ROOT, "skills");
+// Skill state + usage logs live under state/.
+export const SKILLS_STATE_DIR = path.join(resolveStateDir(), "skills");
+// Backward-compat alias (legacy naming).
+export const MANAGED_SKILLS_DIR = SKILLS_STATE_DIR;

package/docs/AGENTS.default.md

@@ -46,7 +46,7 @@ cp docs/AGENTS.default.md ~/nexus/AGENTS.md
 - Don’t send partial/streaming replies to external messaging surfaces (only final replies).
 
 ## Session start (required)
-- Read `state/agents/{agent}/identity/SOUL.md`, `state/user/identity/PROFILE.md`, and today+yesterday in `home/memory/`.
+- Read `state/agents/{agent}/SOUL.md`, `state/user/IDENTITY.md`, and today+yesterday in `home/memory/`.
 - Do it before responding.
 
 ## Soul (required)

package/docs/configuration.md

@@ -726,7 +726,7 @@ own per-session workspaces under `agent.sandbox.workspaceRoot`.
 
 ### `agent.skipBootstrap`
 
-Disables automatic creation of the workspace bootstrap files (`AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `PROFILE.md`, and `BOOTSTRAP.md`).
+Disables automatic creation of the workspace bootstrap files (`AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, and `BOOTSTRAP.md`).
 
 Use this for pre-seeded deployments where your workspace files come from a repo.
 

package/docs/feature-inventory/overview.md

@@ -1,6 +1,6 @@
 # Feature Inventory Overview
 
-> Scope: Nexus CLI repo (`/home/projects/nexus`) + Nexus Website repo (`/home/projects/nexus-website`)  
+> Scope: Nexus CLI repo (`/home/projects/nexus/nexus-cli`) + Nexus Website repo (`/home/projects/nexus/nexus-website`)  
 > Includes Rust cloud engine under `native/nexus-cloud`.  
 > Last updated: 2026-01-17
 
@@ -33,7 +33,7 @@ Use it to guide stabilization, documentation, and test planning.
 - `nexus cloud spaces list/mount/unmount/push/pull`
 
 ### Skills (Local)
-- `nexus skill list/info/use/run/verify/stats`
+- `nexus skill list/info/use/verify/stats`
 
 ### Skills Hub (Remote)
 - `nexus skills search/publish/install`