@morphist/aspects 0.1.2 → 0.1.3

package/dist/{cli.js → src/cli.js}

@@ -6311,12 +6311,12 @@ var icons = {
 var LINE_COLORS = [colors2.cyan, colors2.teal, colors2.orange, colors2.red];
 function morphistBanner() {
   const lines = [
-    "   █████╗  ███████╗██████╗ ███████╗ ██████╗████████╗███████╗",
-    "  ██╔══██╗ ██╔════╝██╔══██╗██╔════╝██╔════╝╚══██╔══╝██╔════╝",
-    "  ███████║ ███████╗██████╔╝█████╗  ██║        ██║   ███████╗",
-    "  ██╔══██║ ╚════██║██╔═══╝ ██╔══╝  ██║        ██║   ╚════██║",
-    "  ██║  ██║ ███████║██║     ███████╗╚██████╗   ██║   ███████║",
-    "  ╚═╝  ╚═╝ ╚══════╝╚═╝     ╚══════╝ ╚═════╝   ╚═╝   ╚══════╝"
+    "   █████╗ ███████╗██████╗ ███████╗ ██████╗████████╗███████╗",
+    "  ██╔══██╗██╔════╝██╔══██╗██╔════╝██╔════╝╚══██╔══╝██╔════╝",
+    "  ███████║███████╗██████╔╝█████╗  ██║        ██║   ███████╗",
+    "  ██╔══██║╚════██║██╔═══╝ ██╔══╝  ██║        ██║   ╚════██║",
+    "  ██║  ██║███████║██║     ███████╗╚██████╗   ██║   ███████║",
+    "  ╚═╝  ╚═╝╚══════╝╚═╝     ╚══════╝ ╚═════╝   ╚═╝   ╚══════╝"
   ];
   console.log();
   console.log(colors2.cyan(lines[0]));
@@ -6327,9 +6327,87 @@ function morphistBanner() {
   console.log(colors2.red(lines[5]));
   console.log();
 }
+// package.json
+var package_default = {
+  name: "@morphist/aspects",
+  version: "0.1.3",
+  description: "Package manager for AI personality aspects - like npm for agent personas",
+  author: "Morphist <hello@morphist.ai>",
+  license: "MIT",
+  type: "module",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/aimorphist/aspects.git"
+  },
+  homepage: "https://github.com/aimorphist/aspects#readme",
+  bugs: {
+    url: "https://github.com/aimorphist/aspects/issues"
+  },
+  keywords: [
+    "ai",
+    "personality",
+    "aspects",
+    "agents",
+    "llm",
+    "prompts",
+    "voice",
+    "cli",
+    "package-manager"
+  ],
+  bin: {
+    aspects: "dist/cli.js"
+  },
+  files: [
+    "dist"
+  ],
+  scripts: {
+    dev: "bun run src/cli.ts",
+    aspects: "bun run src/cli.ts",
+    create: "bun run src/cli.ts create",
+    new: "bun run src/cli.ts create",
+    init: "bun run src/cli.ts create",
+    add: "bun run src/cli.ts add",
+    get: "bun run src/cli.ts add",
+    list: "bun run src/cli.ts list",
+    compile: "bun run src/cli.ts compile",
+    edit: "bun run src/cli.ts edit",
+    build: "bun build src/cli.ts scripts/postinstall.ts --outdir dist --target node --format esm",
+    typecheck: "tsc --noEmit",
+    prepublishOnly: "bun run build",
+    postinstall: "node dist/postinstall.js || true",
+    validate: "bun run scripts/validate-pr.ts",
+    scan: "bun run scripts/security-scan.ts",
+    test: "bun test tests/unit",
+    "test:e2e": "./scripts/test-cli.sh",
+    "test:unit": "bun test tests/unit",
+    "test:integration": "ASPECTS_REGISTRY_URL=http://localhost:5173/api/v1 bun test tests/integration",
+    "test:all": "bun test tests"
+  },
+  dependencies: {
+    "@clack/prompts": "^0.11.0",
+    "@noble/hashes": "^2.0.1",
+    "@scure/base": "^2.0.0",
+    citty: "^0.1.6",
+    consola: "^3.2.3",
+    ofetch: "^1.3.4",
+    picocolors: "^1.1.1",
+    zod: "^4.3.5"
+  },
+  devDependencies: {
+    "@types/bun": "latest",
+    "@types/node": "^22",
+    typescript: "^5"
+  },
+  engines: {
+    node: ">=18"
+  },
+  publishConfig: {
+    access: "public"
+  }
+};
 
 // src/commands/create.ts
-import { writeFile as writeFile4, readFile as readFile5, stat as stat3, mkdir as mkdir4 } from "node:fs/promises";
+import { writeFile as writeFile4, readFile as readFile4, stat as stat3, mkdir as mkdir4 } from "node:fs/promises";
 import { join as join5 } from "node:path";
 import { execSync } from "node:child_process";
 
@@ -20607,11 +20685,18 @@ var OFFICIAL_CATEGORIES = [
   "guide"
 ];
 var FIELD_LIMITS = {
+  nameMin: 2,
   name: 50,
+  displayNameMin: 2,
   displayName: 100,
+  taglineMin: 10,
   tagline: 200,
+  categoryMin: 2,
+  category: 20,
+  tagMin: 2,
   tag: 30,
   maxTags: 10,
+  promptMin: 10,
   prompt: 50000,
   author: 100,
   publisher: 50,
@@ -20631,19 +20716,17 @@ var FIELD_LIMITS = {
   maxInstructions: 25
 };
 var aspectSchema = exports_external.object({
-  schemaVersion: exports_external.number().default(1),
-  name: exports_external.string().min(1, "name is required").max(FIELD_LIMITS.name, `name must be ${FIELD_LIMITS.name} chars or less`),
-  publisher: exports_external.string().max(FIELD_LIMITS.publisher, `publisher must be ${FIELD_LIMITS.publisher} chars or less`).optional(),
+  schemaVersion: exports_external.literal(1),
+  name: exports_external.string().min(FIELD_LIMITS.nameMin, `name must be at least ${FIELD_LIMITS.nameMin} chars`).max(FIELD_LIMITS.name, `name must be ${FIELD_LIMITS.name} chars or less`),
+  publisher: exports_external.string().min(1, "publisher is required").max(FIELD_LIMITS.publisher, `publisher must be ${FIELD_LIMITS.publisher} chars or less`).default("anon-user"),
   version: exports_external.string().default("0.0.0"),
-  displayName: exports_external.string().min(1, "displayName is required").max(FIELD_LIMITS.displayName, `displayName must be ${FIELD_LIMITS.displayName} chars or less`),
-  tagline: exports_external.string().min(1, "tagline is required").max(FIELD_LIMITS.tagline, `tagline must be ${FIELD_LIMITS.tagline} chars or less`),
+  displayName: exports_external.string().min(FIELD_LIMITS.displayNameMin, `displayName must be at least ${FIELD_LIMITS.displayNameMin} chars`).max(FIELD_LIMITS.displayName, `displayName must be ${FIELD_LIMITS.displayName} chars or less`),
+  tagline: exports_external.string().min(FIELD_LIMITS.taglineMin, `tagline must be at least ${FIELD_LIMITS.taglineMin} chars`).max(FIELD_LIMITS.tagline, `tagline must be ${FIELD_LIMITS.tagline} chars or less`),
   icon: exports_external.string().max(FIELD_LIMITS.icon, `icon must be ${FIELD_LIMITS.icon} chars or less`).optional(),
   author: exports_external.string().max(FIELD_LIMITS.author, `author must be ${FIELD_LIMITS.author} chars or less`).optional(),
   license: exports_external.string().max(FIELD_LIMITS.license, `license must be ${FIELD_LIMITS.license} chars or less`).optional(),
-  category: exports_external.enum(OFFICIAL_CATEGORIES, {
-    message: `category must be one of: ${OFFICIAL_CATEGORIES.join(", ")}`
-  }),
-  tags: exports_external.array(exports_external.string().max(FIELD_LIMITS.tag, `each tag must be ${FIELD_LIMITS.tag} chars or less`)).max(FIELD_LIMITS.maxTags, `maximum ${FIELD_LIMITS.maxTags} tags allowed`).optional(),
+  category: exports_external.string().min(FIELD_LIMITS.categoryMin, `Category must be at least ${FIELD_LIMITS.categoryMin} characters`).max(FIELD_LIMITS.category, `Category must be at most ${FIELD_LIMITS.category} characters`).regex(/^[a-zA-Z0-9-]+$/, "Category must be alphanumeric with hyphens only"),
+  tags: exports_external.array(exports_external.string().min(FIELD_LIMITS.tagMin, `each tag must be at least ${FIELD_LIMITS.tagMin} chars`).max(FIELD_LIMITS.tag, `each tag must be ${FIELD_LIMITS.tag} chars or less`)).max(FIELD_LIMITS.maxTags, `maximum ${FIELD_LIMITS.maxTags} tags allowed`).optional(),
   voiceHints: exports_external.object({
     speed: exports_external.enum(["slow", "normal", "fast"]).optional(),
     emotions: exports_external.array(exports_external.string().max(FIELD_LIMITS.emotion, `each emotion must be ${FIELD_LIMITS.emotion} chars or less`)).max(FIELD_LIMITS.maxEmotions, `maximum ${FIELD_LIMITS.maxEmotions} emotions allowed`).optional(),
@@ -20656,21 +20739,6 @@ var aspectSchema = exports_external.object({
   })).refine((modes) => Object.keys(modes).length <= FIELD_LIMITS.maxModes, {
     message: `maximum ${FIELD_LIMITS.maxModes} modes allowed`
   }).optional(),
-  resources: exports_external.object({
-    voice: exports_external.object({
-      recommended: exports_external.object({
-        provider: exports_external.string(),
-        voiceId: exports_external.string()
-      }).optional()
-    }).optional(),
-    model: exports_external.object({
-      recommended: exports_external.object({
-        provider: exports_external.string(),
-        modelId: exports_external.string()
-      }).optional()
-    }).optional(),
-    skills: exports_external.array(exports_external.string()).optional()
-  }).optional(),
   directives: exports_external.array(exports_external.object({
     id: exports_external.string().max(FIELD_LIMITS.directiveId, `directive id must be ${FIELD_LIMITS.directiveId} chars or less`),
     rule: exports_external.string().max(FIELD_LIMITS.directiveRule, `directive rule must be ${FIELD_LIMITS.directiveRule} chars or less`),
@@ -20680,11 +20748,11 @@ var aspectSchema = exports_external.object({
     id: exports_external.string().max(FIELD_LIMITS.instructionId, `instruction id must be ${FIELD_LIMITS.instructionId} chars or less`),
     rule: exports_external.string().max(FIELD_LIMITS.instructionRule, `instruction rule must be ${FIELD_LIMITS.instructionRule} chars or less`)
   })).max(FIELD_LIMITS.maxInstructions, `maximum ${FIELD_LIMITS.maxInstructions} instructions allowed`).optional(),
-  prompt: exports_external.string().min(1, "prompt is required").max(FIELD_LIMITS.prompt, `prompt must be ${FIELD_LIMITS.prompt} chars or less`)
+  prompt: exports_external.string().min(FIELD_LIMITS.promptMin, `prompt must be at least ${FIELD_LIMITS.promptMin} chars`).max(FIELD_LIMITS.prompt, `prompt must be ${FIELD_LIMITS.prompt} chars or less`)
 });
 
 // src/commands/set.ts
-import { mkdir as mkdir3, readFile as readFile4, writeFile as writeFile3, readdir } from "node:fs/promises";
+import { mkdir as mkdir3, readFile as readFile3, writeFile as writeFile3, readdir } from "node:fs/promises";
 import { join as join4 } from "node:path";
 
 // src/utils/colors.ts
@@ -20704,21 +20772,57 @@ var c3 = {
   value: (text) => import_picocolors3.default.white(text),
   highlight: (text) => import_picocolors3.default.bold(import_picocolors3.default.cyan(text)),
   muted: (text) => import_picocolors3.default.dim(text),
-  cmd: (text) => import_picocolors3.default.cyan(text)
+  cmd: (text) => import_picocolors3.default.cyan(text),
+  file: (text) => import_picocolors3.default.yellow(text)
 };
 var icons2 = {
   success: import_picocolors3.default.green("✓"),
   error: import_picocolors3.default.red("✗"),
   warn: import_picocolors3.default.yellow("⚠"),
   info: import_picocolors3.default.blue("ℹ"),
+  working: import_picocolors3.default.cyan("◌"),
   arrow: import_picocolors3.default.dim("→"),
   bullet: import_picocolors3.default.dim("•"),
   sparkle: "✨",
   package: "\uD83D\uDCE6",
   search: "\uD83D\uDD0D",
-  wizard: "\uD83E\uDDD9",
-  share: "\uD83D\uDD17"
+  generator: "\uD83E\uDDD9",
+  share: "\uD83D\uDD17",
+  verified: import_picocolors3.default.green("✓"),
+  community: import_picocolors3.default.blue("◆"),
+  github: import_picocolors3.default.dim("◎"),
+  local: import_picocolors3.default.yellow("▸"),
+  anonymous: import_picocolors3.default.dim("#"),
+  modified: import_picocolors3.default.yellow("*")
 };
+function formatAspectLine(info) {
+  const name = c3.aspect(info.name);
+  const version2 = c3.version(`@${info.version}`);
+  const scopes = c3.dim(`[${info.scopes.join(",")}]`);
+  let source;
+  switch (info.trust) {
+    case "verified":
+      source = icons2.verified + c3.dim(info.publisher ?? "");
+      break;
+    case "community":
+      source = icons2.community + c3.dim(info.publisher ?? "");
+      break;
+    case "github":
+      source = icons2.github + c3.dim("gh");
+      break;
+    case "local":
+      source = icons2.local + c3.dim("local");
+      break;
+    default: {
+      const spec = info.specifier ?? "";
+      const hashPart = spec.startsWith("blake3:") ? spec.slice(7, 13) : spec.startsWith("hash:") ? spec.slice(5, 11) : "";
+      source = hashPart ? icons2.anonymous + c3.dim(hashPart) : c3.dim("registry");
+    }
+  }
+  const modified = info.isModified ? ` ${icons2.modified}` : "";
+  const tagline = info.tagline ? c3.muted(` — ${info.tagline}`) : "";
+  return `  ${name}${version2} ${scopes} ${source}${modified}${tagline}`;
+}
 
 // src/utils/paths.ts
 import { homedir } from "node:os";
@@ -20735,7 +20839,11 @@ async function findProjectRoot() {
     return cachedProjectRoot || null;
   let dir = process.cwd();
   const root = "/";
+  const home = homedir();
   while (dir !== root) {
+    if (dir === home) {
+      break;
+    }
     try {
       await stat(join(dir, PROJECT_ASPECTS_DIR_NAME));
       cachedProjectRoot = dir;
@@ -20850,6 +20958,22 @@ async function listAllInstalledAspects(projectRoot) {
     return globalAspects;
   }
 }
+async function findInstalledAspect(name, projectRoot) {
+  const results = [];
+  if (projectRoot) {
+    try {
+      const projectAspect = await getInstalledAspect(name, "project", projectRoot);
+      if (projectAspect) {
+        results.push({ scope: "project", ...projectAspect });
+      }
+    } catch {}
+  }
+  const globalAspect = await getInstalledAspect(name, "global");
+  if (globalAspect) {
+    results.push({ scope: "global", ...globalAspect });
+  }
+  return results;
+}
 async function getRegistryUrl() {
   const config2 = await readConfig();
   return resolveRegistryUrl(process.env.ASPECTS_REGISTRY_URL, config2.settings.registryUrl);
@@ -20880,9 +21004,50 @@ async function clearAuth() {
   delete config2.auth;
   await writeConfig(config2);
 }
+async function getDefaultHandle() {
+  const auth = await getAuth();
+  return auth?.defaultHandle ?? null;
+}
+async function getHandles() {
+  const auth = await getAuth();
+  return auth?.handles ?? [];
+}
+async function setDefaultHandle(handle) {
+  const config2 = await readConfig();
+  if (!config2.auth) {
+    throw new Error("Not logged in");
+  }
+  const hasHandle = config2.auth.handles.some((h3) => h3.name === handle);
+  if (!hasHandle) {
+    throw new Error(`You don't have access to handle @${handle}`);
+  }
+  config2.auth.handles = config2.auth.handles.map((h3) => ({
+    ...h3,
+    default: h3.name === handle
+  }));
+  config2.auth.defaultHandle = handle;
+  await writeConfig(config2);
+}
+async function updateHandles(handles) {
+  const config2 = await readConfig();
+  if (!config2.auth) {
+    throw new Error("Not logged in");
+  }
+  config2.auth.handles = handles;
+  const defaultStillExists = handles.some((h3) => h3.name === config2.auth.defaultHandle);
+  if (!defaultStillExists) {
+    const newDefault = handles.find((h3) => h3.default) ?? handles[0];
+    config2.auth.defaultHandle = newDefault?.name ?? "";
+  }
+  await writeConfig(config2);
+}
+async function hasHandlePermission(handle) {
+  const handles = await getHandles();
+  return handles.some((h3) => h3.name === handle);
+}
 
 // src/lib/installer.ts
-import { mkdir as mkdir2, writeFile as writeFile2, readFile as readFile3, stat as stat2, access } from "node:fs/promises";
+import { mkdir as mkdir2, writeFile as writeFile2, stat as stat2, access } from "node:fs/promises";
 import { join as join3, dirname } from "node:path";
 
 // node_modules/ofetch/dist/node.mjs
@@ -21678,7 +21843,7 @@ async function searchAspects(params) {
 async function publishAspect(aspect) {
   return apiFetch("/aspects", {
     method: "POST",
-    body: { aspect },
+    body: aspect,
     auth: true
   });
 }
@@ -21712,6 +21877,26 @@ async function pollDeviceAuth(deviceCode, codeVerifier) {
     parseResponse: JSON.parse
   });
 }
+async function getAccount() {
+  return apiFetch("/account", { auth: true });
+}
+async function claimHandle(name, displayName) {
+  return apiFetch("/handles", {
+    method: "POST",
+    body: { name, display_name: displayName },
+    auth: true
+  });
+}
+async function checkHandleAvailability(name) {
+  return apiFetch(`/handles/${encodeURIComponent(name)}/available`);
+}
+async function setDefaultHandleApi(handle) {
+  await apiFetch("/account/default-handle", {
+    method: "PUT",
+    body: { handle },
+    auth: true
+  });
+}
 
 // src/lib/registry.ts
 var FALLBACK_REGISTRY_URL = "https://raw.githubusercontent.com/aimorphist/aspects/main/registry/index.json";
@@ -23258,12 +23443,17 @@ async function installFromRegistryApi(name, version2, options) {
   await mkdir2(aspectDir, { recursive: true });
   const content = JSON.stringify(aspect, null, 2);
   await writeFile2(join3(aspectDir, ASPECT_FILENAME), content);
-  const hash2 = versionData.blake3 || blake3Hash(content);
+  const hash2 = versionData.blake3 || blake3HashAspect(aspect);
+  const publisher = aspect.publisher;
+  const trust = publisher ? "community" : undefined;
   await addInstalledAspect(name, {
     version: aspect.version,
-    source: "registry",
     installedAt: new Date().toISOString(),
-    blake3: hash2
+    blake3: hash2,
+    source: "registry",
+    trust: trust ?? "community",
+    publisher,
+    specifier: options?.specifier ?? (publisher ? `${publisher}/${name}` : name)
   }, scope, projectRoot);
   return { success: true, aspect, source: "registry" };
 }
@@ -23328,12 +23518,17 @@ async function installFromRegistryLegacy(name, version2, options) {
   const aspectDir = getAspectPath(name, scope, projectRoot);
   await mkdir2(aspectDir, { recursive: true });
   await writeFile2(join3(aspectDir, ASPECT_FILENAME), content);
-  const hash2 = blake3Hash(content);
+  const hash2 = blake3HashAspect(aspect);
+  const publisher = aspect.publisher;
+  const trust = registryAspect.metadata.trust ?? "community";
   await addInstalledAspect(name, {
     version: aspect.version,
-    source: "registry",
     installedAt: new Date().toISOString(),
-    blake3: hash2
+    blake3: hash2,
+    source: "registry",
+    trust,
+    publisher,
+    specifier: options?.specifier ?? (publisher ? `${publisher}/${name}` : name)
   }, scope, projectRoot);
   return { success: true, aspect, source: "registry" };
 }
@@ -23370,11 +23565,12 @@ async function installFromGitHub(owner, repo, ref, options) {
     parseResult.warnings.forEach((w4) => log.warn(w4));
   }
   const aspect = parseResult.aspect;
+  const hash2 = blake3HashAspect(aspect);
   if (!options?.force) {
     const existing = await getInstalledAspect(aspect.name, scope, projectRoot);
-    if (existing && existing.source === "github" && existing.githubRef === targetRef) {
+    if (existing && existing.source === "github" && existing.githubRef === `${owner}/${repo}@${targetRef}`) {
       const existingAspect = await loadAspectFromPath(getAspectPath(aspect.name, scope, projectRoot));
-      if (existingAspect && existing.blake3 === blake3Hash(content)) {
+      if (existingAspect && existing.blake3 === hash2) {
         return { success: true, aspect: existingAspect, source: "github", alreadyInstalled: true };
       }
     }
@@ -23383,13 +23579,15 @@ async function installFromGitHub(owner, repo, ref, options) {
   const aspectDir = getAspectPath(aspect.name, scope, projectRoot);
   await mkdir2(aspectDir, { recursive: true });
   await writeFile2(join3(aspectDir, ASPECT_FILENAME), content);
-  const hash2 = blake3Hash(content);
+  const specifier = options?.specifier ?? `github:${owner}/${repo}@${targetRef}`;
   await addInstalledAspect(aspect.name, {
     version: aspect.version,
-    source: "github",
     installedAt: new Date().toISOString(),
     blake3: hash2,
-    githubRef: targetRef
+    source: "github",
+    trust: "github",
+    githubRef: `${owner}/${repo}@${targetRef}`,
+    specifier
   }, scope, projectRoot);
   return { success: true, aspect, source: "github" };
 }
@@ -23423,22 +23621,23 @@ async function installFromLocal(path, options) {
     parseResult.warnings.forEach((w4) => log.warn(w4));
   }
   const aspect = parseResult.aspect;
-  const content = await readFile3(filePath, "utf-8");
-  const hash2 = blake3Hash(content);
+  const hash2 = blake3HashAspect(aspect);
   const scope = options?.scope ?? "global";
   const projectRoot = options?.projectRoot;
   if (!options?.force) {
     const existing = await getInstalledAspect(aspect.name, scope, projectRoot);
-    if (existing && existing.path === aspectDir && existing.blake3 === hash2) {
+    if (existing && existing.localPath === aspectDir && existing.blake3 === hash2) {
       return { success: true, aspect, source: "local", alreadyInstalled: true };
     }
   }
   await addInstalledAspect(aspect.name, {
     version: aspect.version,
-    source: "local",
     installedAt: new Date().toISOString(),
     blake3: hash2,
-    path: aspectDir
+    source: "local",
+    trust: "local",
+    localPath: aspectDir,
+    specifier: options?.specifier ?? path
   }, scope, projectRoot);
   return { success: true, aspect, source: "local" };
 }
@@ -23473,9 +23672,11 @@ async function installFromHash(hash2, options) {
   await writeFile2(join3(aspectDir, ASPECT_FILENAME), content);
   await addInstalledAspect(aspect.name, {
     version: aspect.version,
-    source: "registry",
     installedAt: new Date().toISOString(),
-    blake3: versionData.blake3 || blake3Hash(content)
+    blake3: versionData.blake3 || blake3HashAspect(aspect),
+    source: "registry",
+    trust: "community",
+    specifier: options?.specifier ?? `blake3:${hash2}`
   }, scope, projectRoot);
   return { success: true, aspect, source: "registry" };
 }
@@ -23490,8 +23691,8 @@ async function loadAspectFromPath(aspectDir) {
 // src/lib/resolver.ts
 import { resolve, isAbsolute } from "node:path";
 function parseInstallSpec(spec) {
-  if (spec.startsWith("hash:")) {
-    const hash2 = spec.slice(5);
+  if (spec.startsWith("blake3:") || spec.startsWith("hash:")) {
+    const hash2 = spec.startsWith("blake3:") ? spec.slice(7) : spec.slice(5);
     if (hash2.length < 16) {
       throw new Error(`Invalid hash spec: ${spec}. Hash must be at least 16 characters.`);
     }
@@ -23515,33 +23716,49 @@ function parseInstallSpec(spec) {
     const absolutePath = isAbsolute(spec) ? spec : resolve(process.cwd(), spec);
     return { type: "local", path: absolutePath };
   }
+  if (spec.includes("aspects.sh/")) {
+    const aspectsMatch = spec.match(/aspects\.sh\/aspects\/([a-z0-9-]+)/i);
+    if (aspectsMatch?.[1]) {
+      return { type: "registry", name: aspectsMatch[1] };
+    }
+    const hashMatch = spec.match(/aspects\.sh\/a\/([A-Za-z0-9]{16,44})/);
+    if (hashMatch?.[1]) {
+      return { type: "hash", hash: hashMatch[1] };
+    }
+    throw new Error(`Invalid aspects.sh URL: ${spec}`);
+  }
   let name;
+  let publisher;
   let version2;
-  if (spec.startsWith("@")) {
-    const lastAtIndex = spec.lastIndexOf("@");
-    if (lastAtIndex > 0 && spec.indexOf("/") < lastAtIndex) {
-      name = spec.slice(0, lastAtIndex);
-      version2 = spec.slice(lastAtIndex + 1);
-    } else {
-      name = spec;
-    }
+  const atIndex = spec.lastIndexOf("@");
+  let nameWithPublisher;
+  if (atIndex > 0) {
+    nameWithPublisher = spec.slice(0, atIndex);
+    version2 = spec.slice(atIndex + 1);
   } else {
-    const atIndex = spec.indexOf("@");
-    if (atIndex > 0) {
-      name = spec.slice(0, atIndex);
-      version2 = spec.slice(atIndex + 1);
-    } else {
-      name = spec;
+    nameWithPublisher = spec;
+  }
+  const slashIndex = nameWithPublisher.indexOf("/");
+  if (slashIndex > 0) {
+    publisher = nameWithPublisher.slice(0, slashIndex);
+    if (publisher.startsWith("@")) {
+      publisher = publisher.slice(1);
     }
+    name = nameWithPublisher.slice(slashIndex + 1);
+    if (!name) {
+      throw new Error(`Invalid spec: ${spec}. Expected publisher/name format.`);
+    }
+  } else {
+    name = nameWithPublisher;
   }
-  return { type: "registry", name, version: version2 };
+  return { type: "registry", name, publisher, version: version2 };
 }
 
 // src/commands/set.ts
 async function loadSet(name) {
   try {
     const setPath = join4(getSetsDir(), name, "set.json");
-    const content = await readFile4(setPath, "utf-8");
+    const content = await readFile3(setPath, "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -23586,7 +23803,7 @@ var createCommand = defineCommand({
     },
     aspects: {
       type: "positional",
-      description: "Aspects to include (optional, launches wizard if omitted)",
+      description: "Aspects to include (optional, launches generator if omitted)",
       required: false
     }
   },
@@ -23991,7 +24208,28 @@ var CATEGORY_OPTIONS = [
 var create_default = defineCommand({
   meta: {
     name: "create",
-    description: "Create a new aspect interactively"
+    description: `Create a new aspect interactively.
+
+The generator guides you through:
+  1. Name & identity (slug, display name, tagline)
+  2. Category selection (assistant, roleplay, creative, etc.)
+  3. Tags for discovery
+  4. Voice hints (speed, emotions)
+  5. Directives & Instructions
+
+Directives vs Instructions:
+  Directives   Strict MUST-follow rules with priority (high/medium/low)
+               Emphasized across all LLM models via XML, bold, repetition
+  Instructions Softer guidance and preferences, not strictly enforced
+
+Examples:
+  aspects create                  Create in current directory
+  aspects create my-aspect        Create in ./my-aspect/
+  aspects create ~/aspects/new    Create at specific path
+
+If run inside the aspects registry repo, automatically offers to:
+  - Add to registry/index.json
+  - Commit and push changes`
   },
   args: {
     path: {
@@ -24041,7 +24279,7 @@ var create_default = defineCommand({
     while (!aspectName) {
       const nameInput = await he2({
         message: "Aspect name (slug)",
-        placeholder: "my-wizard",
+        placeholder: "my-aspect",
         validate: (value) => {
           if (!value)
             return "Name is required";
@@ -24079,7 +24317,7 @@ var create_default = defineCommand({
     const answers = await Ce({
       displayName: () => he2({
         message: "Display name",
-        placeholder: "My Wizard",
+        placeholder: "My Aspect",
         validate: (value) => {
           if (!value)
             return "Display name is required";
@@ -24087,7 +24325,7 @@ var create_default = defineCommand({
       }),
       tagline: () => he2({
         message: "Tagline (one-liner description)",
-        placeholder: "A wise and quirky wizard who loves riddles",
+        placeholder: "A helpful assistant with a unique personality",
         validate: (value) => {
           if (!value)
             return "Tagline is required";
@@ -24126,17 +24364,17 @@ var create_default = defineCommand({
         message: "Voice speed",
         options: [
           { value: "normal", label: "Normal" },
-          { value: "slow", label: "Slow — deliberate, thoughtful" },
-          { value: "fast", label: "Fast — energetic, excited" }
+          { value: "slow", label: "Slow - deliberate, thoughtful" },
+          { value: "fast", label: "Fast - energetic, excited" }
         ],
         initialValue: "normal"
       }),
       promptStyle: () => ve2({
         message: "Prompt template",
         options: [
-          { value: "character", label: "Character — roleplay a persona" },
-          { value: "assistant", label: "Assistant — helpful AI style" },
-          { value: "blank", label: "Blank — start from scratch" }
+          { value: "character", label: "Character - roleplay a persona" },
+          { value: "assistant", label: "Assistant - helpful AI style" },
+          { value: "blank", label: "Blank - start from scratch" }
         ],
         initialValue: "character"
       })
@@ -24151,11 +24389,11 @@ var create_default = defineCommand({
     M2.message(`
 \uD83D\uDCCB Directives & Instructions
 
-Directives are MUST-follow rules — they get special emphasis
+Directives are MUST-follow rules - they get special emphasis
 across all LLM models (bold, XML tags, repetition).
   Example: "Never break character under any circumstances"
 
-Instructions are general guidance — softer preferences for
+Instructions are general guidance - softer preferences for
 how the AI should behave.
   Example: "Prefer shorter responses when possible"
 
@@ -24188,7 +24426,7 @@ Keep it light! A few well-crafted rules beat many vague ones.
           },
           {
             value: "done",
-            label: hasAny ? "Done — finish creating aspect" : "Skip — finish without adding any"
+            label: hasAny ? "Done - finish creating aspect" : "Skip - finish without adding any"
           }
         ]
       });
@@ -24267,7 +24505,7 @@ Keep it light! A few well-crafted rules beat many vague ones.
     const aspect = {
       schemaVersion: 1,
       name: aspectName,
-      publisher: answers.author || "community",
+      publisher: "anon-user",
       version: "1.0.0",
       displayName: answers.displayName,
       tagline: answers.tagline,
@@ -24346,11 +24584,11 @@ Keep it light! A few well-crafted rules beat many vague ones.
               M2.info(`
 Next: Open a PR at https://github.com/${GITHUB_REPO}/compare`);
             } catch {
-              M2.warn("Push failed — you may need to set up your remote");
+              M2.warn("Push failed - you may need to set up your remote");
             }
           }
         } catch {
-          M2.warn("Git commit failed — you may need to commit manually");
+          M2.warn("Git commit failed - you may need to commit manually");
         }
       }
     } else {
@@ -24387,7 +24625,7 @@ To submit to the registry:`);
 });
 async function addToRegistryIndex(repoRoot, name, displayName, tagline, category, publisher) {
   const indexPath = join5(repoRoot, INDEX_PATH);
-  const indexContent = await readFile5(indexPath, "utf-8");
+  const indexContent = await readFile4(indexPath, "utf-8");
   const index = JSON.parse(indexContent);
   const now = new Date().toISOString();
   index.aspects[name] = {
@@ -24456,16 +24694,78 @@ ${tagline}
   }
 }
 
+// src/commands/init.ts
+import { existsSync } from "node:fs";
+import { mkdir as mkdir5 } from "node:fs/promises";
+import { join as join6 } from "node:path";
+var init_default = defineCommand({
+  meta: {
+    name: "init",
+    description: "Initialize a project for local aspect installation"
+  },
+  args: {
+    force: {
+      type: "boolean",
+      alias: "f",
+      description: "Overwrite existing .aspects directory"
+    }
+  },
+  async run({ args }) {
+    const cwd = process.cwd();
+    const aspectsDir = join6(cwd, PROJECT_ASPECTS_DIR_NAME);
+    if (existsSync(aspectsDir) && !args.force) {
+      M2.warn(`${c3.file(".aspects/")} already exists in this directory`);
+      const overwrite = await ye2({
+        message: "Reinitialize?"
+      });
+      if (pD2(overwrite) || !overwrite) {
+        xe("Cancelled");
+        process.exit(0);
+      }
+    }
+    await mkdir5(aspectsDir, { recursive: true });
+    console.log();
+    console.log(`${icons2.success} Initialized ${c3.file(".aspects/")} in ${c3.muted(cwd)}`);
+    console.log();
+    console.log(`  Now you can run ${c3.cmd("aspects add <name>")} to install locally.`);
+    console.log();
+  }
+});
+async function initProjectAspects() {
+  const cwd = process.cwd();
+  const aspectsDir = join6(cwd, PROJECT_ASPECTS_DIR_NAME);
+  await mkdir5(aspectsDir, { recursive: true });
+  return cwd;
+}
+
 // src/commands/add.ts
 var add_default = defineCommand({
   meta: {
     name: "add",
-    description: "Install aspect(s) to your local library"
+    description: `Install aspect(s) to your local library.
+
+Sources:
+  aspects add alaric              From registry (aspects.sh)
+  aspects add alaric@1.2.0        Specific version
+  aspects add blake3:<hash>       By content hash (from 'aspects share')
+  aspects add github:user/repo    From GitHub repository
+  aspects add ./my-aspect         From local path
+
+Scope:
+  By default, installs to ./.aspects/ if in a project, else ~/.aspects/
+  Use -g/--global to always install to ~/.aspects/
+  Use -p/--project to install locally (will prompt to init if needed)
+
+Examples:
+  aspects add alaric meditation-guide    Install multiple aspects
+  aspects add -g alaric                  Install globally
+  aspects add -p alaric                  Install to project (init if needed)
+  aspects add --force alaric             Overwrite existing`
   },
   args: {
     specs: {
       type: "positional",
-      description: "Aspect name(s), github:user/repo, or ./path",
+      description: "Aspect spec(s): name, name@version, blake3:<hash>, github:user/repo, or ./path",
       required: true
     },
     force: {
@@ -24476,6 +24776,11 @@ var add_default = defineCommand({
       type: "boolean",
       alias: "g",
       description: "Install to global scope (~/.aspects) instead of project"
+    },
+    project: {
+      type: "boolean",
+      alias: "p",
+      description: "Install to project scope (init if needed)"
     }
   },
   async run({ args }) {
@@ -24484,6 +24789,24 @@ var add_default = defineCommand({
     let projectRoot;
     if (args.global) {
       scope = "global";
+    } else if (args.project) {
+      projectRoot = await findProjectRoot() || undefined;
+      if (!projectRoot) {
+        console.log();
+        const init2 = await ye2({
+          message: `No ${c3.file(".aspects/")} found. Initialize project here?`
+        });
+        if (pD2(init2) || !init2) {
+          console.log(c3.muted("  Falling back to global scope"));
+          scope = "global";
+        } else {
+          projectRoot = await initProjectAspects();
+          console.log(`${icons2.success} Initialized ${c3.file(".aspects/")}`);
+          scope = "project";
+        }
+      } else {
+        scope = "project";
+      }
     } else {
       projectRoot = await findProjectRoot() || undefined;
       scope = projectRoot ? "project" : "global";
@@ -24500,7 +24823,12 @@ var add_default = defineCommand({
         results.push({ spec: specStr, success: false, error: err.message });
         continue;
       }
-      const result = await installAspect(spec, { force: !!args.force, scope, projectRoot });
+      const result = await installAspect(spec, {
+        force: !!args.force,
+        scope,
+        projectRoot,
+        specifier: specStr
+      });
       if (!result.success) {
         results.push({ spec: specStr, success: false, error: result.error });
         continue;
@@ -24549,18 +24877,33 @@ var add_default = defineCommand({
 });
 
 // src/lib/aspect-loader.ts
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 var ASPECT_FILENAME2 = "aspect.json";
 var LEGACY_FILENAME2 = "aspect.yaml";
+async function findAndLoadAspect(name) {
+  const projectRoot = await findProjectRoot() || undefined;
+  const installed = await findInstalledAspect(name, projectRoot);
+  if (installed.length === 0)
+    return null;
+  const match = installed.find((i2) => i2.scope === "project") || installed[0];
+  const aspect = await loadInstalledAspect(name, match.scope, projectRoot);
+  if (!aspect)
+    return null;
+  return {
+    aspect,
+    scope: match.scope,
+    meta: match
+  };
+}
 async function loadInstalledAspect(name, scope = "global", projectRoot) {
   const installed = await getInstalledAspect(name, scope, projectRoot);
   if (!installed)
     return null;
-  const aspectDir = installed.path ?? getAspectPath(name, scope, projectRoot);
-  const jsonResult = await parseAspectFile(join6(aspectDir, ASPECT_FILENAME2));
+  const aspectDir = installed.localPath ?? getAspectPath(name, scope, projectRoot);
+  const jsonResult = await parseAspectFile(join7(aspectDir, ASPECT_FILENAME2));
   if (jsonResult.success)
     return jsonResult.aspect;
-  const yamlResult = await parseAspectFile(join6(aspectDir, LEGACY_FILENAME2));
+  const yamlResult = await parseAspectFile(join7(aspectDir, LEGACY_FILENAME2));
   return yamlResult.success ? yamlResult.aspect : null;
 }
 
@@ -24595,21 +24938,44 @@ var list_default = defineCommand({
     if (installed.length === 0) {
       console.log();
       console.log(c3.muted("  No aspects installed."));
-      console.log(c3.muted(`  Run ${c3.highlight("aspects install <name>")} to get started.`));
+      console.log(c3.muted(`  Run ${c3.highlight("aspects add <name>")} to get started.`));
       console.log();
       return;
     }
+    const grouped = new Map;
+    for (const item of installed) {
+      const existing = grouped.get(item.blake3);
+      if (existing) {
+        if (!existing.scopes.includes(item.scope)) {
+          existing.scopes.push(item.scope);
+        }
+      } else {
+        const aspect = await loadInstalledAspect(item.name, item.scope, projectRoot);
+        let isModified = false;
+        if (aspect) {
+          const currentHash = blake3HashAspect(aspect);
+          isModified = currentHash !== item.blake3;
+        }
+        const trust = item.trust ?? (item.source === "github" ? "github" : item.source === "local" ? "local" : "community");
+        grouped.set(item.blake3, {
+          name: item.name,
+          version: item.version,
+          blake3: item.blake3,
+          scopes: [item.scope],
+          trust,
+          publisher: item.publisher,
+          specifier: item.specifier,
+          tagline: aspect?.tagline,
+          isModified
+        });
+      }
+    }
     console.log();
     console.log(c3.bold(`${icons2.package} Installed aspects`));
     console.log();
-    for (const item of installed) {
-      const aspect = await loadInstalledAspect(item.name, item.scope, projectRoot);
-      const scopeLabel = item.scope === "project" ? c3.dim(" [project]") : c3.dim(" [global]");
-      const sourceLabel = item.source === "local" ? c3.dim(" (local)") : item.source === "github" ? c3.dim(" (github)") : "";
-      const name = c3.aspect(item.name);
-      const version2 = c3.version(`@${item.version}`);
-      const tagline = aspect?.tagline ? c3.muted(` — ${aspect.tagline}`) : "";
-      console.log(`  ${name}${version2}${scopeLabel}${sourceLabel}${tagline}`);
+    for (const item of grouped.values()) {
+      item.scopes.sort((a2, b4) => a2 === "project" ? -1 : 1);
+      console.log(formatAspectLine(item));
     }
     console.log();
   }
@@ -24619,7 +24985,19 @@ var list_default = defineCommand({
 var search_default = defineCommand({
   meta: {
     name: "search",
-    description: "Search the aspect registry"
+    description: `Search the aspect registry.
+
+Searches aspect names, display names, taglines, and tags.
+
+Examples:
+  aspects search wizard           Find aspects matching "wizard"
+  aspects search                  List all aspects
+  aspects search --category roleplay   Filter by category
+  aspects search --trust verified      Only verified aspects
+
+Categories: assistant, roleplay, creative, productivity, education, gaming, spiritual, pundit
+
+For advanced filtering, use 'aspects find' with boolean operators.`
   },
   args: {
     query: {
@@ -24952,7 +25330,7 @@ var find_default = defineCommand({
         if (results.some((r6) => r6.aspect.name === name && r6.source === "registry")) {
           continue;
         }
-        const aspectPath = aspectInfo.path || getAspectPath(name);
+        const aspectPath = aspectInfo.localPath || getAspectPath(name);
         const parseResult = await parseAspectFile(`${aspectPath}/aspect.json`);
         if (!parseResult.success)
           continue;
@@ -25027,28 +25405,24 @@ var info_default = defineCommand({
     }
   },
   async run({ args }) {
-    const installed = await getInstalledAspect(args.name);
-    if (installed) {
-      const aspect = await loadInstalledAspect(args.name);
-      if (!aspect) {
-        log.error(`Failed to load aspect "${args.name}" — aspect.json may be corrupted`);
-        process.exit(1);
-      }
+    const found = await findAndLoadAspect(args.name);
+    if (found) {
+      const { aspect, scope, meta: installMeta } = found;
       console.log();
-      console.log(`${c3.bold(aspect.displayName)} ${c3.muted("(")}${c3.aspect(aspect.name)}${c3.version(`@${aspect.version}`)}${c3.muted(")")}`);
+      console.log(`${c3.bold(aspect.displayName)} ${c3.muted("(")}${c3.aspect(aspect.name)}${c3.version(`@${aspect.version}`)}${c3.muted(")")} ${c3.dim(`[${scope}]`)}`);
       console.log();
       console.log(`  ${c3.italic(aspect.tagline)}`);
       console.log();
-      const meta3 = [];
+      const displayMeta = [];
       if (aspect.publisher)
-        meta3.push(["Publisher", aspect.publisher]);
+        displayMeta.push(["Publisher", aspect.publisher]);
       if (aspect.author)
-        meta3.push(["Author", aspect.author]);
+        displayMeta.push(["Author", aspect.author]);
       if (aspect.license)
-        meta3.push(["License", aspect.license]);
-      meta3.push(["Source", installed.source]);
-      if (meta3.length > 0) {
-        for (const [label, value] of meta3) {
+        displayMeta.push(["License", aspect.license]);
+      displayMeta.push(["Source", installMeta.source]);
+      if (displayMeta.length > 0) {
+        for (const [label, value] of displayMeta) {
           console.log(`  ${c3.label(label.padEnd(10))} ${c3.value(value)}`);
         }
       }
@@ -25162,31 +25536,79 @@ var remove_default = defineCommand({
       type: "boolean",
       alias: "g",
       description: "Remove from global scope (~/.aspects) instead of project"
+    },
+    project: {
+      type: "boolean",
+      alias: "p",
+      description: "Remove from project scope only"
+    },
+    force: {
+      type: "boolean",
+      alias: "f",
+      description: "Skip confirmation prompt"
     }
   },
   async run({ args }) {
-    let scope;
-    let projectRoot;
-    if (args.global) {
-      scope = "global";
-    } else {
-      projectRoot = await findProjectRoot() || undefined;
-      scope = projectRoot ? "project" : "global";
-    }
-    const installed = await getInstalledAspect(args.name, scope, projectRoot);
-    if (!installed) {
+    const projectRoot = await findProjectRoot() || undefined;
+    const found = await findInstalledAspect(args.name, projectRoot);
+    if (found.length === 0) {
       log.error(`Aspect "${args.name}" is not installed`);
       process.exit(1);
     }
-    await removeInstalledAspect(args.name, scope, projectRoot);
-    if (installed.source === "registry" || installed.source === "github") {
-      const aspectDir = getAspectPath(args.name, scope, projectRoot);
-      try {
-        await rm(aspectDir, { recursive: true });
-      } catch {}
+    let toRemove = found;
+    if (args.global && !args.project) {
+      toRemove = found.filter((f4) => f4.scope === "global");
+      if (toRemove.length === 0) {
+        log.error(`Aspect "${args.name}" is not installed globally`);
+        process.exit(1);
+      }
+    } else if (args.project && !args.global) {
+      toRemove = found.filter((f4) => f4.scope === "project");
+      if (toRemove.length === 0) {
+        log.error(`Aspect "${args.name}" is not installed in project scope`);
+        process.exit(1);
+      }
+    }
+    if (toRemove.length > 1 && !args.global && !args.project) {
+      const choice = await ve2({
+        message: `"${args.name}" is installed in multiple scopes. Which to remove?`,
+        options: [
+          ...toRemove.map((f4) => ({
+            value: f4.scope,
+            label: `${f4.scope} (${f4.version})`
+          })),
+          { value: "both", label: "Both" }
+        ]
+      });
+      if (pD2(choice)) {
+        xe("Cancelled");
+        process.exit(0);
+      }
+      if (choice === "both") {} else {
+        toRemove = toRemove.filter((f4) => f4.scope === choice);
+      }
+    }
+    if (!args.force && toRemove.length > 0) {
+      const first = toRemove[0];
+      const scopeDesc = toRemove.length === 1 ? `from ${c3.dim(first.scope)} scope` : `from ${toRemove.map((f4) => c3.dim(f4.scope)).join(" and ")} scopes`;
+      const confirmed = await ye2({
+        message: `Remove ${c3.aspect(args.name)}${c3.version(`@${first.version}`)} ${scopeDesc}?`
+      });
+      if (pD2(confirmed) || !confirmed) {
+        xe("Cancelled");
+        process.exit(0);
+      }
+    }
+    for (const install of toRemove) {
+      await removeInstalledAspect(args.name, install.scope, projectRoot);
+      if (install.source === "registry" || install.source === "github") {
+        const aspectDir = getAspectPath(args.name, install.scope, projectRoot);
+        try {
+          await rm(aspectDir, { recursive: true });
+        } catch {}
+      }
+      console.log(`${icons2.success} Removed ${c3.aspect(args.name)}${c3.version(`@${install.version}`)} ${c3.dim(`[${install.scope}]`)}`);
     }
-    console.log();
-    console.log(`${icons2.success} Removed ${c3.aspect(args.name)}${c3.version(`@${installed.version}`)}`);
     console.log();
   }
 });
@@ -25234,22 +25656,22 @@ var update_default = defineCommand({
     let updated = 0;
     for (const aspect of toCheck) {
       if (aspect.source === "local") {
-        console.log(`  ${c3.aspect(aspect.name)} ${c3.muted("— local install, skipping")}`);
+        console.log(`  ${c3.aspect(aspect.name)} ${c3.muted("- local install, skipping")}`);
         continue;
       }
       if (aspect.source === "github") {
-        console.log(`  ${c3.aspect(aspect.name)} ${c3.muted("— github install, use")} ${c3.highlight("aspects install github:...")} ${c3.muted("to update")}`);
+        console.log(`  ${c3.aspect(aspect.name)} ${c3.muted("- github install, use")} ${c3.highlight("aspects install github:...")} ${c3.muted("to update")}`);
         continue;
       }
       let registryInfo;
       try {
         registryInfo = await getRegistryAspect(aspect.name);
       } catch {
-        console.log(`  ${c3.aspect(aspect.name)} ${c3.error("— failed to check registry")}`);
+        console.log(`  ${c3.aspect(aspect.name)} ${c3.error("- failed to check registry")}`);
         continue;
       }
       if (!registryInfo) {
-        console.log(`  ${c3.aspect(aspect.name)} ${c3.warn("— not found in registry")}`);
+        console.log(`  ${c3.aspect(aspect.name)} ${c3.warn("- not found in registry")}`);
         continue;
       }
       const currentVersion = aspect.version;
@@ -25296,12 +25718,30 @@ var update_default = defineCommand({
 });
 
 // src/commands/validate.ts
-import { readFile as readFile6, stat as stat4 } from "node:fs/promises";
-import { join as join7 } from "node:path";
+import { readFile as readFile5, stat as stat4 } from "node:fs/promises";
+import { join as join8 } from "node:path";
 var validate_default = defineCommand({
   meta: {
     name: "validate",
-    description: "Validate an aspect.json file against the schema"
+    description: `Validate an aspect.json file against the schema.
+
+Checks:
+  - Required fields (name, displayName, tagline, category, prompt)
+  - Field length limits
+  - Category is valid
+  - Directive/instruction structure
+  - Mode references valid directives
+
+Examples:
+  aspects validate                 Validate in current directory
+  aspects validate ./my-aspect     Validate specific path
+  aspects validate --strict        Stricter checks
+  aspects validate --security      Scan for prompt injection patterns
+
+Security scan flags patterns like:
+  - "ignore previous instructions"
+  - Requests for passwords or financial info
+  - Known jailbreak attempts`
   },
   args: {
     path: {
@@ -25326,15 +25766,28 @@ var validate_default = defineCommand({
     try {
       const stats = await stat4(aspectPath);
       if (stats.isDirectory()) {
-        aspectPath = join7(aspectPath, "aspect.json");
+        aspectPath = join8(aspectPath, "aspect.json");
       }
     } catch {
-      M2.error(`Path not found: ${aspectPath}`);
-      process.exit(1);
+      if (args.path) {
+        const projectRoot = await findProjectRoot() || undefined;
+        const installed = await findInstalledAspect(args.path, projectRoot);
+        if (installed.length > 0) {
+          const match = installed.find((i2) => i2.scope === "project") || installed[0];
+          aspectPath = join8(getAspectPath(args.path, match.scope, projectRoot), "aspect.json");
+          M2.info(`Found installed: ${c3.aspect(args.path)} ${c3.dim(`[${match.scope}]`)}`);
+        } else {
+          M2.error(`Path not found: ${aspectPath}`);
+          process.exit(1);
+        }
+      } else {
+        M2.error(`Path not found: ${aspectPath}`);
+        process.exit(1);
+      }
     }
     let content;
     try {
-      content = await readFile6(aspectPath, "utf-8");
+      content = await readFile5(aspectPath, "utf-8");
     } catch {
       M2.error(`Cannot read file: ${aspectPath}`);
       process.exit(1);
@@ -25420,7 +25873,7 @@ var validate_default = defineCommand({
     M2.info("Checks:");
     for (const check2 of checks3) {
       const icon = check2.passed ? "✓" : "✗";
-      const msg = check2.message ? ` — ${check2.message}` : "";
+      const msg = check2.message ? ` - ${check2.message}` : "";
       if (check2.passed) {
         M2.success(`  ${icon} ${check2.label}${msg}`);
       } else {
@@ -25437,8 +25890,8 @@ var validate_default = defineCommand({
 });
 
 // src/commands/compile.ts
-import { readFile as readFile7, writeFile as writeFile5, stat as stat5 } from "node:fs/promises";
-import { join as join8 } from "node:path";
+import { readFile as readFile6, writeFile as writeFile5, stat as stat5 } from "node:fs/promises";
+import { join as join9 } from "node:path";
 function detectModelFamily(model) {
   const lower = model.toLowerCase();
   if (lower.includes("claude")) {
@@ -25455,28 +25908,45 @@ function detectModelFamily(model) {
   }
   return "unknown";
 }
-function formatDirectivesForModel(directives, family) {
+function formatDirectivesForModel(directives, family, options) {
   if (directives.length === 0)
     return "";
   const isModern = family === "claude-modern" || family === "gpt-modern" || family === "unknown";
+  const isReminder = options?.isReminder ?? false;
   if (isModern) {
+    const tagName = isReminder ? "critical-reminders" : "directives";
     const rules = directives.map((d4) => `  <rule id="${d4.id}" priority="${d4.priority}">${d4.rule}</rule>`).join(`
 `);
-    return `<rules>
+    if (isReminder) {
+      return `<!-- Universal Pattern: High-priority directives repeated here for cross-LLM compatibility.
+     Claude weights prompt beginning; GPT weights prompt end. Repetition ensures emphasis on both. -->
+<${tagName}>
 ${rules}
-</rules>
+</${tagName}>
+`;
+    }
+    return `<${tagName}>
+${rules}
+</${tagName}>
+
+`;
+  }
+  let output = "";
+  if (isReminder) {
+    output += `<!-- Note: Critical directives repeated below for cross-model compatibility -->
+`;
+    output += `## Critical Reminders
 
 `;
   }
   const highPriority = directives.filter((d4) => d4.priority === "high");
   const otherPriority = directives.filter((d4) => d4.priority !== "high");
-  let output = "";
   for (const d4 of highPriority) {
     output += `**IMPORTANT**: ${d4.rule}
 
 `;
   }
-  if (otherPriority.length > 0) {
+  if (!isReminder && otherPriority.length > 0) {
     for (const d4 of otherPriority) {
       output += `- ${d4.rule}
 `;
@@ -25486,10 +25956,49 @@ ${rules}
   }
   return output;
 }
+function formatInstructionsForModel(instructions, family) {
+  if (instructions.length === 0)
+    return "";
+  const isModern = family === "claude-modern" || family === "gpt-modern" || family === "unknown";
+  if (isModern) {
+    const rules = instructions.map((i2) => `  <guideline id="${i2.id}">${i2.rule}</guideline>`).join(`
+`);
+    return `<instructions>
+${rules}
+</instructions>
+
+`;
+  }
+  let output = `## Guidelines
+
+`;
+  for (const i2 of instructions) {
+    output += `- ${i2.rule}
+`;
+  }
+  output += `
+`;
+  return output;
+}
 var compile_default = defineCommand({
   meta: {
     name: "compile",
-    description: "Compile an aspect's prompt for a specific model"
+    description: `Compile an aspect's prompt for a specific model.
+
+Formats directives and instructions optimally for the target model:
+  - Modern models (Claude 4.x, GPT-4.1+): Clean XML tags
+  - Legacy models (Claude 3, GPT-4): Markdown with emphasis
+
+Cross-LLM Universal Pattern:
+  High-priority directives are repeated at BOTH beginning and end.
+  Claude weights prompt beginning; GPT weights prompt end.
+  This ensures critical rules work across all models.
+
+Examples:
+  aspects compile alaric -m claude-haiku-4-5
+  aspects compile alaric -m gpt-4o --mode campaign
+  aspects compile ./my-aspect -m claude-4 -o prompt.txt
+  aspects compile alaric -m claude-4 --verbose`
   },
   args: {
     name: {
@@ -25525,15 +26034,15 @@ var compile_default = defineCommand({
     try {
       const stats = await stat5(args.name);
       if (stats.isDirectory()) {
-        aspectPath = join8(args.name, "aspect.json");
+        aspectPath = join9(args.name, "aspect.json");
       } else {
         aspectPath = args.name;
       }
-      aspectContent = await readFile7(aspectPath, "utf-8");
+      aspectContent = await readFile6(aspectPath, "utf-8");
     } catch {
       try {
-        aspectPath = join8(ASPECTS_DIR, args.name, "aspect.json");
-        aspectContent = await readFile7(aspectPath, "utf-8");
+        aspectPath = join9(ASPECTS_DIR, args.name, "aspect.json");
+        aspectContent = await readFile6(aspectPath, "utf-8");
       } catch {
         M2.error(`Aspect not found: ${args.name}`);
         M2.info("Try: aspects list");
@@ -25563,7 +26072,8 @@ var compile_default = defineCommand({
       M2.info("");
       M2.info(`Model family: ${family}`);
     }
-    const directives = [];
+    const directives = aspect.directives || [];
+    const instructions = aspect.instructions || [];
     let modeInfo = null;
     if (args.mode && aspect.modes) {
       modeInfo = aspect.modes[args.mode] || null;
@@ -25588,6 +26098,9 @@ var compile_default = defineCommand({
     if (directives.length > 0) {
       compiled += formatDirectivesForModel(directives, family);
     }
+    if (instructions.length > 0) {
+      compiled += formatInstructionsForModel(instructions, family);
+    }
     if (modeInfo?.critical) {
       if (family === "claude-modern" || family === "gpt-modern" || family === "unknown") {
         compiled += `<mode name="${args.mode}">
@@ -25603,6 +26116,13 @@ ${modeInfo.critical}
       }
     }
     compiled += aspect.prompt;
+    const highPriorityDirectives = directives.filter((d4) => d4.priority === "high");
+    if (highPriorityDirectives.length > 0) {
+      compiled += `
+
+`;
+      compiled += formatDirectivesForModel(highPriorityDirectives, family, { isReminder: true });
+    }
     if (aspect.voiceHints && args.verbose) {
       M2.info("");
       M2.info("Voice hints:");
@@ -25631,13 +26151,30 @@ ${modeInfo.critical}
 });
 
 // src/commands/publish.ts
-import { readFile as readFile8, stat as stat6, readdir as readdir2 } from "node:fs/promises";
-import { join as join9, dirname as dirname3 } from "node:path";
+import { readFile as readFile7, stat as stat6, readdir as readdir2 } from "node:fs/promises";
+import { join as join10, dirname as dirname3 } from "node:path";
 var MAX_ASPECT_SIZE = 51200;
 var publish_default = defineCommand({
   meta: {
     name: "publish",
-    description: "Publish an aspect to the registry"
+    description: `Publish an aspect to the registry (requires login).
+
+Publishing claims the aspect name under your account. You can then:
+  - Publish new versions (bump version in aspect.json)
+  - Update metadata (tagline, tags, category)
+  - Build a publisher reputation
+
+The publisher field in aspect.json must match your logged-in username.
+
+Examples:
+  aspects publish                  Interactive (scans for aspects)
+  aspects publish ./my-aspect      Publish specific aspect
+  aspects publish --dry-run        Validate without publishing
+
+Don't want an account? Use 'aspects share' instead:
+  - No login required
+  - Content-addressed by Blake3 hash
+  - Anyone can install via: aspects add blake3:<hash>`
   },
   args: {
     path: {
@@ -25666,7 +26203,21 @@ var publish_default = defineCommand({
     }
     let aspectPath;
     if (args.path) {
-      aspectPath = args.path;
+      const inputPath = args.path;
+      try {
+        await stat6(inputPath);
+        aspectPath = inputPath;
+      } catch {
+        const projectRoot = await findProjectRoot() || undefined;
+        const installed = await findInstalledAspect(inputPath, projectRoot);
+        if (installed.length > 0) {
+          const match = installed.find((i2) => i2.scope === "project") || installed[0];
+          aspectPath = getAspectPath(inputPath, match.scope, projectRoot);
+          M2.info(`Found installed: ${c3.aspect(inputPath)} ${c3.dim(`[${match.scope}]`)}`);
+        } else {
+          aspectPath = inputPath;
+        }
+      }
     } else {
       const spinner = Y3();
       spinner.start("Scanning for aspects...");
@@ -25716,13 +26267,37 @@ var publish_default = defineCommand({
       M2.error(`Aspect too large: ${sizeBytes} bytes (${MAX_ASPECT_SIZE} byte limit)`);
       process.exit(1);
     }
-    if (!dryRun) {
-      const auth = await getAuth();
-      if (validation.aspect.publisher && auth && validation.aspect.publisher !== auth.username) {
-        spinner2.stop("Validation failed");
-        M2.error(`Publisher mismatch: aspect.json has "${validation.aspect.publisher}" but you are "@${auth.username}"`);
-        M2.info("Update the publisher field in aspect.json or log in with the correct account.");
-        process.exit(1);
+    const auth = await getAuth();
+    if (!dryRun && auth) {
+      const defaultHandle = await getDefaultHandle();
+      const handles = await getHandles();
+      if (validation.aspect.publisher) {
+        const hasPermission = await hasHandlePermission(validation.aspect.publisher);
+        if (!hasPermission) {
+          spinner2.stop("Validation failed");
+          console.log();
+          M2.error(`You don't have permission to publish under @${c3.bold(validation.aspect.publisher)}`);
+          console.log();
+          console.log(c3.muted("  Your handles:"));
+          for (const h4 of handles) {
+            const isDefault = h4.name === defaultHandle;
+            console.log(`    @${h4.name}${isDefault ? c3.dim(" (default)") : ""}`);
+          }
+          console.log();
+          console.log(c3.muted("  Either:"));
+          console.log(`    1. Change "publisher" in aspect.json to one of your handles`);
+          console.log(`    2. Get added as a member to @${validation.aspect.publisher} (via web UI)`);
+          console.log(`    3. Use ${c3.cmd("aspects share")} for anonymous publishing`);
+          console.log();
+          process.exit(1);
+        }
+      } else {
+        if (!defaultHandle) {
+          spinner2.stop("Validation failed");
+          M2.error('No default handle set. Run "aspects handle claim <name>" first.');
+          process.exit(1);
+        }
+        validation.aspect.publisher = defaultHandle;
       }
     }
     spinner2.stop("Validation passed");
@@ -25753,6 +26328,10 @@ var publish_default = defineCommand({
     spinner3.start(`Publishing ${validation.aspect.name}@${validation.aspect.version}...`);
     try {
       const parsed = JSON.parse(validation.content);
+      const defaultHandle = await getDefaultHandle();
+      if (defaultHandle && !parsed.publisher) {
+        parsed.publisher = defaultHandle;
+      }
       const result = await publishAspect(parsed);
       spinner3.stop("Published");
       console.log();
@@ -25773,6 +26352,10 @@ var publish_default = defineCommand({
         } else if (err.errorCode === "unauthorized") {
           M2.info("");
           M2.info('Run "aspects login" to authenticate');
+        } else if (err.errorCode === "no_permission") {
+          M2.info("");
+          M2.info("You don't have permission to publish under this handle");
+          M2.info('Run "aspects handle list" to see your handles');
         }
       } else {
         M2.error(`Publish failed: ${err.message}`);
@@ -25786,13 +26369,13 @@ async function loadAspectFromPath2(inputPath) {
   try {
     const stats = await stat6(inputPath);
     if (stats.isDirectory()) {
-      aspectPath = join9(inputPath, "aspect.json");
+      aspectPath = join10(inputPath, "aspect.json");
     }
   } catch {
     return null;
   }
   try {
-    const content = await readFile8(aspectPath, "utf-8");
+    const content = await readFile7(aspectPath, "utf-8");
     const aspect = JSON.parse(content);
     return {
       path: dirname3(aspectPath),
@@ -25818,18 +26401,33 @@ async function findLocalAspects() {
     const entries = await readdir2(process.cwd(), { withFileTypes: true });
     for (const entry of entries) {
       if (entry.isDirectory() && !entry.name.startsWith(".")) {
-        const subAspect = await loadAspectFromPath2(join9(process.cwd(), entry.name));
+        const subAspect = await loadAspectFromPath2(join10(process.cwd(), entry.name));
         if (subAspect && !aspects.find((a2) => a2.path === subAspect.path)) {
           aspects.push(subAspect);
         }
       }
     }
   } catch {}
+  const projectRoot = await findProjectRoot();
+  if (projectRoot) {
+    const projectAspectsDir = join10(projectRoot, ".aspects", "aspects");
+    try {
+      const entries = await readdir2(projectAspectsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          const projectAspect = await loadAspectFromPath2(join10(projectAspectsDir, entry.name));
+          if (projectAspect && !aspects.find((a2) => a2.path === projectAspect.path)) {
+            aspects.push(projectAspect);
+          }
+        }
+      }
+    } catch {}
+  }
   try {
     const entries = await readdir2(ASPECTS_DIR, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.isDirectory()) {
-        const installedAspect = await loadAspectFromPath2(join9(ASPECTS_DIR, entry.name));
+        const installedAspect = await loadAspectFromPath2(join10(ASPECTS_DIR, entry.name));
         if (installedAspect && !aspects.find((a2) => a2.path === installedAspect.path)) {
           aspects.push(installedAspect);
         }
@@ -25843,14 +26441,14 @@ async function validateAspect(aspectPath) {
   try {
     const stats = await stat6(aspectPath);
     if (stats.isDirectory()) {
-      filePath = join9(aspectPath, "aspect.json");
+      filePath = join10(aspectPath, "aspect.json");
     }
   } catch {
     return { valid: false, errors: [`Path not found: ${aspectPath}`] };
   }
   let content;
   try {
-    content = await readFile8(filePath, "utf-8");
+    content = await readFile7(filePath, "utf-8");
   } catch {
     return { valid: false, errors: [`Cannot read file: ${filePath}`] };
   }
@@ -25891,8 +26489,8 @@ async function validateAspect(aspectPath) {
 }
 
 // src/commands/edit.ts
-import { readFile as readFile9, writeFile as writeFile6 } from "node:fs/promises";
-import { join as join10 } from "node:path";
+import { readFile as readFile8, writeFile as writeFile6 } from "node:fs/promises";
+import { join as join11 } from "node:path";
 var CATEGORIES = [
   "assistant",
   "roleplay",
@@ -25909,7 +26507,7 @@ async function listLocalAspects() {
   const results = [];
   for (const [name, info] of Object.entries(config2.installed)) {
     const aspectPath = info.path || getAspectPath(name);
-    const parseResult = await parseAspectFile(join10(aspectPath, "aspect.json"));
+    const parseResult = await parseAspectFile(join11(aspectPath, "aspect.json"));
     if (parseResult.success) {
       results.push({ name, path: aspectPath, aspect: parseResult.aspect });
     }
@@ -26065,8 +26663,8 @@ var edit_default = defineCommand({
       xe("Cancelled");
       return;
     }
-    const aspectPath = join10(selectedAspect.path, "aspect.json");
-    const content = await readFile9(aspectPath, "utf-8");
+    const aspectPath = join11(selectedAspect.path, "aspect.json");
+    const content = await readFile8(aspectPath, "utf-8");
     let updatedContent = content;
     if (changes.includes("displayName")) {
       updatedContent = updatedContent.replace(/displayName:.*$/m, `displayName: "${updatedAspect.displayName}"`);
@@ -26103,8 +26701,8 @@ ${updatedAspect.tags.map((t4) => `  - ${t4}`).join(`
 });
 
 // src/commands/bundle.ts
-import { readFile as readFile10, writeFile as writeFile7 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { readFile as readFile9, writeFile as writeFile7 } from "node:fs/promises";
+import { join as join12 } from "node:path";
 var import_picocolors4 = __toESM(require_picocolors(), 1);
 function parseQuery2(query) {
   const filters = [];
@@ -26184,8 +26782,8 @@ async function loadLocalAspects() {
   const aspects = [];
   for (const name of Object.keys(config2.installed || {})) {
     try {
-      const aspectPath = join11(getAspectPath(name), "aspect.json");
-      const content = await readFile10(aspectPath, "utf-8");
+      const aspectPath = join12(getAspectPath(name), "aspect.json");
+      const content = await readFile9(aspectPath, "utf-8");
       aspects.push(JSON.parse(content));
     } catch {}
   }
@@ -26268,8 +26866,8 @@ var bundle_default = defineCommand({
               }
             }
           } else {
-            const aspectPath = join11(getAspectPath(name), "aspect.json");
-            const content = await readFile10(aspectPath, "utf-8");
+            const aspectPath = join12(getAspectPath(name), "aspect.json");
+            const content = await readFile9(aspectPath, "utf-8");
             aspectsToBundle.push(JSON.parse(content));
           }
         } catch (error48) {
@@ -26318,8 +26916,8 @@ var bundle_default = defineCommand({
               }
             }
           } else {
-            const aspectPath = join11(getAspectPath(aspectName), "aspect.json");
-            const content = await readFile10(aspectPath, "utf-8");
+            const aspectPath = join12(getAspectPath(aspectName), "aspect.json");
+            const content = await readFile9(aspectPath, "utf-8");
             const aspect = JSON.parse(content);
             if (!aspectsToBundle.some((a2) => a2.name === aspect.name)) {
               aspectsToBundle.push(aspect);
@@ -26364,8 +26962,8 @@ var bundle_default = defineCommand({
 });
 async function loadSet2(name) {
   try {
-    const setPath = join11(getSetsDir(), name, "set.json");
-    const content = await readFile10(setPath, "utf-8");
+    const setPath = join12(getSetsDir(), name, "set.json");
+    const content = await readFile9(setPath, "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -26373,16 +26971,39 @@ async function loadSet2(name) {
 }
 
 // src/commands/login.ts
+import { exec } from "node:child_process";
+import * as readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
 var login_default = defineCommand({
   meta: {
     name: "login",
-    description: "Authenticate with the aspects registry"
+    description: `Authenticate with the aspects registry.
+
+Uses device authorization flow (like GitHub CLI):
+  1. CLI requests a device code
+  2. Browser opens to verification URL
+  3. Enter the code and authorize
+  4. CLI receives and stores access token
+
+Benefits of logging in:
+  - Name ownership: Claim aspect names under your publisher ID
+  - Versioning: Publish updates to your aspects
+  - Edit metadata: Update tagline, tags, category
+
+Credentials stored in ~/.aspects/config.json
+
+Don't want an account? Use 'aspects share' to publish anonymously.`
   },
   async run() {
     const auth = await getAuth();
     if (auth && await isLoggedIn()) {
+      const defaultHandle = await getDefaultHandle();
       console.log();
-      console.log(`${icons2.info} Already logged in as ${c3.bold(`@${auth.username}`)}`);
+      if (defaultHandle) {
+        console.log(`${icons2.info} Already logged in as ${c3.bold(`@${defaultHandle}`)}`);
+      } else {
+        console.log(`${icons2.info} Already logged in`);
+      }
       console.log(c3.muted('  Run "aspects logout" to sign out first.'));
       console.log();
       return;
@@ -26393,7 +27014,14 @@ var login_default = defineCommand({
     try {
       deviceCode = await initiateDeviceAuth();
     } catch (err) {
-      log.error(`Failed to initiate login: ${err.message}`);
+      const error48 = err;
+      log.error(`Failed to initiate login: ${error48.message}`);
+      if (error48.statusCode) {
+        console.log(c3.muted(`  Status: ${error48.statusCode}`));
+      }
+      if (error48.errorCode) {
+        console.log(c3.muted(`  Code: ${error48.errorCode}`));
+      }
       process.exit(1);
     }
     console.log();
@@ -26403,7 +27031,6 @@ var login_default = defineCommand({
     console.log(`  Code: ${c3.bold(deviceCode.user_code)}`);
     console.log();
     try {
-      const { exec } = await import("node:child_process");
       const platform2 = process.platform;
       const openCmd = platform2 === "darwin" ? "open" : platform2 === "win32" ? "start" : "xdg-open";
       exec(`${openCmd} "${deviceCode.verification_uri_complete}"`);
@@ -26419,15 +27046,44 @@ var login_default = defineCommand({
         if (result.ok && result.access_token) {
           const expiresIn = result.expires_in ?? 3600;
           const expiresAtDate = new Date(Date.now() + expiresIn * 1000).toISOString();
-          const username = extractUsernameFromToken(result.access_token) ?? "user";
+          const account = result.account;
+          if (!account) {
+            log.error("API did not return account info. Please update the registry.");
+            process.exit(1);
+          }
+          if (account.needs_handle) {
+            console.log(`${icons2.success} Authenticated!`);
+            console.log();
+            const suggested = extractUsernameFromToken(result.access_token);
+            const handle = await promptForHandle(suggested, result.access_token);
+            await setAuthTokens({
+              accessToken: result.access_token,
+              refreshToken: result.refresh_token,
+              expiresAt: expiresAtDate,
+              accountId: account.id,
+              handles: [{ name: handle, role: "owner", default: true }],
+              defaultHandle: handle
+            });
+            console.log();
+            console.log(`${icons2.success} Logged in as ${c3.bold(`@${handle}`)}`);
+            console.log(c3.muted("  Credentials stored in ~/.aspects/config.json"));
+            console.log();
+            return;
+          }
+          const defaultHandle = account.handles.find((h4) => h4.default)?.name ?? account.handles[0]?.name ?? "";
           await setAuthTokens({
             accessToken: result.access_token,
             refreshToken: result.refresh_token,
             expiresAt: expiresAtDate,
-            username
+            accountId: account.id,
+            handles: account.handles,
+            defaultHandle
           });
-          console.log(`${icons2.success} Authorized as ${c3.bold(`@${username}`)}`);
-          console.log(c3.muted("  Access token stored in ~/.aspects/config.json"));
+          console.log(`${icons2.success} Logged in as ${c3.bold(`@${defaultHandle}`)}`);
+          if (account.handles.length > 1) {
+            console.log(c3.muted(`  Also: ${account.handles.filter((h4) => h4.name !== defaultHandle).map((h4) => `@${h4.name}`).join(", ")}`));
+          }
+          console.log(c3.muted("  Credentials stored in ~/.aspects/config.json"));
           console.log();
           return;
         }
@@ -26465,11 +27121,75 @@ function extractUsernameFromToken(token) {
     if (parts.length !== 3)
       return null;
     const payload = JSON.parse(Buffer.from(parts[1], "base64url").toString());
-    return payload.username ?? payload.sub ?? payload.preferred_username ?? null;
+    const raw = payload.preferred_username ?? payload.email ?? payload.username ?? payload.name ?? null;
+    if (!raw)
+      return null;
+    let clean2 = raw.split("@")[0] ?? raw;
+    clean2 = clean2.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/--+/g, "-").replace(/^-|-$/g, "");
+    if (clean2.length < 2 || clean2.length > 39)
+      return null;
+    return clean2;
   } catch {
     return null;
   }
 }
+async function promptForHandle(suggested, accessToken) {
+  const rl2 = readline.createInterface({ input, output });
+  const HANDLE_REGEX = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+  console.log(`  ${c3.bold("Claim your handle")}`);
+  console.log(`  This will be your publisher identity (e.g., @${suggested ?? "yourname"})`);
+  console.log();
+  while (true) {
+    const prompt2 = suggested ? `  Handle [${suggested}]: ` : "  Handle: ";
+    let answer = await rl2.question(prompt2);
+    answer = answer.trim().toLowerCase().replace(/^@/, "");
+    if (!answer && suggested) {
+      answer = suggested;
+    }
+    if (!answer) {
+      console.log(c3.warn("  Please enter a handle"));
+      continue;
+    }
+    if (answer.length < 2) {
+      console.log(c3.warn("  Handle must be at least 2 characters"));
+      continue;
+    }
+    if (answer.length > 39) {
+      console.log(c3.warn("  Handle must be at most 39 characters"));
+      continue;
+    }
+    if (!HANDLE_REGEX.test(answer)) {
+      console.log(c3.warn("  Handle must be lowercase alphanumeric with hyphens"));
+      continue;
+    }
+    if (answer.includes("--")) {
+      console.log(c3.warn("  Handle cannot contain consecutive hyphens"));
+      continue;
+    }
+    try {
+      console.log(`  ${icons2.working} Claiming @${answer}...`);
+      await claimHandle(answer);
+      rl2.close();
+      return answer;
+    } catch (err) {
+      if (err instanceof ApiClientError) {
+        switch (err.errorCode) {
+          case "handle_taken":
+            console.log(c3.warn(`  @${answer} is already taken. Try another.`));
+            break;
+          case "handle_reserved":
+            console.log(c3.warn(`  @${answer} is reserved. Try another.`));
+            break;
+          default:
+            console.log(c3.warn(`  ${err.message}`));
+        }
+        continue;
+      }
+      rl2.close();
+      throw err;
+    }
+  }
+}
 
 // src/commands/logout.ts
 var logout_default = defineCommand({
@@ -26485,10 +27205,10 @@ var logout_default = defineCommand({
       console.log();
       return;
     }
-    const username = auth.username;
+    const handle = auth.defaultHandle;
     await clearAuth();
     console.log();
-    console.log(`${icons2.success} Logged out${username ? ` from @${username}` : ""}`);
+    console.log(`${icons2.success} Logged out${handle ? ` from @${handle}` : ""}`);
     console.log(c3.muted("  Auth tokens removed from ~/.aspects/config.json"));
     console.log();
   }
@@ -26496,12 +27216,29 @@ var logout_default = defineCommand({
 
 // src/commands/share.ts
 import { stat as stat7 } from "node:fs/promises";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 var MAX_ASPECT_SIZE2 = 51200;
 var share_default = defineCommand({
   meta: {
     name: "share",
-    description: "Share an aspect anonymously via content hash (no account required)"
+    description: `Share an aspect anonymously via content hash (no account required).
+
+How it works:
+  1. Computes Blake3 hash of your aspect content
+  2. Uploads to registry (content-addressed storage)
+  3. Anyone can install via: aspects add blake3:<hash>
+
+No account needed! Perfect for:
+  - Quick one-off sharing
+  - Testing before claiming a name
+  - Anonymous contributions
+
+Examples:
+  aspects share my-aspect           Share an installed aspect
+  aspects share ./path/to/aspect    Share from local path
+  aspects share my-aspect --dry-run Preview hash without uploading
+
+Want to claim a name instead? Use 'aspects publish' (requires login).`
   },
   args: {
     target: {
@@ -26543,8 +27280,8 @@ var share_default = defineCommand({
       try {
         const stats = await stat7(target);
         if (stats.isDirectory()) {
-          const jsonPath = join12(target, "aspect.json");
-          const yamlPath = join12(target, "aspect.yaml");
+          const jsonPath = join13(target, "aspect.json");
+          const yamlPath = join13(target, "aspect.yaml");
           try {
             await stat7(jsonPath);
             filePath = jsonPath;
@@ -26563,13 +27300,14 @@ var share_default = defineCommand({
       }
       aspect = result.aspect;
     } else {
-      const loaded = await loadInstalledAspect(target);
-      if (!loaded) {
+      const found = await findAndLoadAspect(target);
+      if (!found) {
         M2.error(`Aspect "${target}" is not installed or cannot be read`);
         M2.info("To share from a path, use: aspects share ./path/to/aspect.json");
         process.exit(1);
       }
-      aspect = loaded;
+      M2.info(`Found: ${c3.aspect(target)} ${c3.dim(`[${found.scope}]`)}`);
+      aspect = found.aspect;
     }
     const content = canonicalizeAspect(aspect);
     const sizeBytes = Buffer.byteLength(content);
@@ -26586,7 +27324,7 @@ var share_default = defineCommand({
     console.log(`  ${c3.label("Hash")} ${hash2}`);
     console.log();
     if (dryRun) {
-      M2.info("Dry run — not uploading");
+      M2.info("Dry run - not uploading");
       console.log();
       console.log(`  ${c3.label("Install")} aspects add hash:${hash2}`);
       console.log();
@@ -26608,13 +27346,16 @@ var share_default = defineCommand({
       console.log();
       console.log(`${icons2.success} ${c3.bold("Shared successfully!")}`);
       console.log();
-      console.log(`  ${c3.label("Hash")}    ${response.blake3}`);
-      console.log(`  ${c3.label("Install")} ${c3.highlight(`aspects add blake3:${response.blake3}`)}`);
+      console.log(`  ${c3.label("Name")}    ${c3.highlight(response.name)}`);
+      console.log(`  ${c3.label("Install")} ${c3.highlight(`aspects add ${response.name}`)}`);
+      console.log(`  ${c3.label("URL")}     ${response.url}`);
+      console.log();
+      console.log(`  ${c3.muted("Or by hash:")} aspects add blake3:${response.blake3}`);
       if (response.existing) {
         console.log(`  ${c3.muted("(Already existed on registry)")}`);
       }
       console.log();
-      Se("Share this hash with anyone to let them install your aspect!");
+      Se("Share this name or URL with anyone to let them install your aspect!");
     } catch (err) {
       spinner.stop("Upload failed");
       if (err instanceof ApiClientError) {
@@ -26699,7 +27440,501 @@ var unpublish_default = defineCommand({
   }
 });
 
+// src/commands/config.ts
+import { homedir as homedir2 } from "node:os";
+var DEFAULT_REGISTRY_URL = "https://aspects.sh/api/v1";
+function tildify(path) {
+  const home = homedir2();
+  return path.startsWith(home) ? path.replace(home, "~") : path;
+}
+var CONFIG_KEYS = {
+  "registry.url": {
+    path: ["settings", "registryUrl"],
+    description: "API registry URL",
+    default: DEFAULT_REGISTRY_URL
+  }
+};
+function getNestedValue(obj, path) {
+  let current = obj;
+  for (const key of path) {
+    if (current && typeof current === "object" && key in current) {
+      current = current[key];
+    } else {
+      return;
+    }
+  }
+  return current;
+}
+function setNestedValue(obj, path, value) {
+  let current = obj;
+  for (let i2 = 0;i2 < path.length - 1; i2++) {
+    const key = path[i2];
+    if (!(key in current) || typeof current[key] !== "object") {
+      current[key] = {};
+    }
+    current = current[key];
+  }
+  const lastKey = path[path.length - 1];
+  if (value === undefined) {
+    delete current[lastKey];
+  } else {
+    current[lastKey] = value;
+  }
+}
+var listCommand2 = defineCommand({
+  meta: {
+    name: "list",
+    description: "Show all configuration values"
+  },
+  async run() {
+    const config2 = await readConfig();
+    const registryUrl = await getRegistryUrl();
+    const auth = await getAuth();
+    console.log();
+    console.log(`${icons2.info} Configuration`);
+    console.log();
+    console.log(`  ${c3.label("Config file")} ${tildify(CONFIG_PATH)}`);
+    console.log();
+    console.log(c3.bold("  Registry"));
+    const envUrl = process.env.ASPECTS_REGISTRY_URL;
+    if (envUrl) {
+      console.log(`    ${c3.label("url")} ${registryUrl} ${c3.dim("(from ASPECTS_REGISTRY_URL)")}`);
+    } else if (config2.settings.registryUrl) {
+      console.log(`    ${c3.label("url")} ${registryUrl}`);
+    } else {
+      console.log(`    ${c3.label("url")} ${registryUrl} ${c3.dim("(default)")}`);
+    }
+    console.log();
+    console.log(c3.bold("  Auth"));
+    if (auth) {
+      console.log(`    ${c3.label("logged in as")} @${auth.defaultHandle}`);
+      const expiresAt = new Date(auth.expiresAt);
+      const isExpired = expiresAt < new Date;
+      if (isExpired) {
+        console.log(`    ${c3.label("token")} ${c3.warn("expired")} ${c3.dim(`(${expiresAt.toLocaleString()})`)}`);
+      } else {
+        console.log(`    ${c3.label("token")} valid until ${c3.dim(expiresAt.toLocaleString())}`);
+      }
+    } else {
+      console.log(`    ${c3.muted("Not logged in")}`);
+    }
+    const installedCount = Object.keys(config2.installed).length;
+    console.log();
+    console.log(c3.bold("  Library"));
+    console.log(`    ${c3.label("aspects home")} ${tildify(ASPECTS_HOME)}`);
+    console.log(`    ${c3.label("installed")} ${installedCount} aspect${installedCount === 1 ? "" : "s"}`);
+    console.log();
+  }
+});
+var getCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: "Get a configuration value"
+  },
+  args: {
+    key: {
+      type: "positional",
+      description: "Config key (e.g., registry.url)",
+      required: true
+    }
+  },
+  async run({ args }) {
+    const key = args.key;
+    const config2 = await readConfig();
+    const knownKey = CONFIG_KEYS[key];
+    if (knownKey) {
+      const value = getNestedValue(config2, knownKey.path);
+      const effectiveValue = value ?? knownKey.default;
+      if (key === "registry.url" && process.env.ASPECTS_REGISTRY_URL) {
+        console.log(process.env.ASPECTS_REGISTRY_URL);
+        return;
+      }
+      console.log(effectiveValue);
+    } else {
+      const path = key.split(".");
+      const value = getNestedValue(config2, path);
+      if (value !== undefined) {
+        console.log(typeof value === "object" ? JSON.stringify(value, null, 2) : value);
+      } else {
+        console.error(`Unknown config key: ${key}`);
+        process.exit(1);
+      }
+    }
+  }
+});
+var setCommand = defineCommand({
+  meta: {
+    name: "set",
+    description: "Set a configuration value"
+  },
+  args: {
+    key: {
+      type: "positional",
+      description: "Config key (e.g., registry.url)",
+      required: true
+    },
+    value: {
+      type: "positional",
+      description: "Value to set",
+      required: true
+    }
+  },
+  async run({ args }) {
+    const key = args.key;
+    const value = args.value;
+    const config2 = await readConfig();
+    const knownKey = CONFIG_KEYS[key];
+    if (knownKey) {
+      setNestedValue(config2, knownKey.path, value);
+      await writeConfig(config2);
+      console.log(`${icons2.success} Set ${key} = ${value}`);
+    } else {
+      const path = key.split(".");
+      setNestedValue(config2, path, value);
+      await writeConfig(config2);
+      console.log(`${icons2.success} Set ${key} = ${value}`);
+    }
+  }
+});
+var unsetCommand = defineCommand({
+  meta: {
+    name: "unset",
+    description: "Remove a configuration value (revert to default)"
+  },
+  args: {
+    key: {
+      type: "positional",
+      description: "Config key to remove",
+      required: true
+    }
+  },
+  async run({ args }) {
+    const key = args.key;
+    const config2 = await readConfig();
+    const knownKey = CONFIG_KEYS[key];
+    const path = knownKey ? knownKey.path : key.split(".");
+    const currentValue = getNestedValue(config2, path);
+    if (currentValue === undefined) {
+      console.log(`${icons2.info} ${key} is not set`);
+      return;
+    }
+    setNestedValue(config2, path, undefined);
+    await writeConfig(config2);
+    if (knownKey) {
+      console.log(`${icons2.success} Unset ${key} (will use default: ${knownKey.default})`);
+    } else {
+      console.log(`${icons2.success} Unset ${key}`);
+    }
+  }
+});
+var pathCommand = defineCommand({
+  meta: {
+    name: "path",
+    description: "Show path to config file"
+  },
+  async run() {
+    console.log(CONFIG_PATH);
+  }
+});
+var config_default = defineCommand({
+  meta: {
+    name: "config",
+    description: "View and modify configuration"
+  },
+  subCommands: {
+    list: listCommand2,
+    get: getCommand,
+    set: setCommand,
+    unset: unsetCommand,
+    path: pathCommand
+  }
+});
+
+// src/commands/handle.ts
+var HANDLE_REGEX = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+var MIN_LENGTH = 2;
+var MAX_LENGTH = 39;
+function validateHandleFormat(name) {
+  if (name.length < MIN_LENGTH) {
+    return `Handle must be at least ${MIN_LENGTH} characters`;
+  }
+  if (name.length > MAX_LENGTH) {
+    return `Handle must be at most ${MAX_LENGTH} characters`;
+  }
+  if (!HANDLE_REGEX.test(name)) {
+    return "Handle must be lowercase alphanumeric with hyphens, cannot start or end with hyphen";
+  }
+  if (name.includes("--")) {
+    return "Handle cannot contain consecutive hyphens";
+  }
+  return null;
+}
+var claimCommand = defineCommand({
+  meta: {
+    name: "claim",
+    description: "Claim a new handle"
+  },
+  args: {
+    name: {
+      type: "positional",
+      description: "Handle name to claim (e.g., myhandle)",
+      required: true
+    },
+    "display-name": {
+      type: "string",
+      description: "Display name with preferred casing"
+    }
+  },
+  async run({ args }) {
+    const auth = await getAuth();
+    if (!auth) {
+      console.error(`${icons2.error} Not logged in. Run ${c3.cmd("aspects login")} first.`);
+      process.exit(1);
+    }
+    const name = args.name.toLowerCase();
+    const displayName = args["display-name"];
+    const formatError2 = validateHandleFormat(name);
+    if (formatError2) {
+      console.error(`${icons2.error} ${formatError2}`);
+      process.exit(1);
+    }
+    try {
+      console.log(`${icons2.working} Claiming @${name}...`);
+      const result = await claimHandle(name, displayName);
+      const account = await getAccount();
+      await updateHandles(account.handles);
+      console.log(`${icons2.success} Claimed @${result.name}`);
+      console.log();
+      console.log(`  You can now publish aspects under this handle.`);
+      console.log(`  Use ${c3.cmd(`aspects handle default ${name}`)} to make it your default.`);
+    } catch (err) {
+      if (err instanceof ApiClientError) {
+        switch (err.errorCode) {
+          case "invalid_format":
+            console.error(`${icons2.error} Invalid handle format: ${err.message}`);
+            break;
+          case "handle_taken":
+            console.error(`${icons2.error} @${name} is already taken`);
+            break;
+          case "handle_reserved":
+            console.error(`${icons2.error} @${name} is reserved`);
+            break;
+          case "handle_limit":
+            console.error(`${icons2.error} You've reached the maximum of 5 owned handles`);
+            console.log(`  You can be a member of unlimited handles owned by others.`);
+            break;
+          case "rate_limit":
+            console.error(`${icons2.error} Rate limit: max 3 handle claims per 30 days`);
+            break;
+          default:
+            console.error(`${icons2.error} ${err.message}`);
+        }
+        process.exit(1);
+      }
+      throw err;
+    }
+  }
+});
+var listCommand3 = defineCommand({
+  meta: {
+    name: "list",
+    description: "List your handles"
+  },
+  args: {
+    refresh: {
+      type: "boolean",
+      description: "Refresh from API",
+      default: false
+    }
+  },
+  async run({ args }) {
+    const auth = await getAuth();
+    if (!auth) {
+      console.error(`${icons2.error} Not logged in. Run ${c3.cmd("aspects login")} first.`);
+      process.exit(1);
+    }
+    let handles = await getHandles();
+    if (args.refresh) {
+      try {
+        const account = await getAccount();
+        await updateHandles(account.handles);
+        handles = account.handles;
+      } catch (err) {
+        console.error(`${icons2.warn} Could not refresh from API: ${err.message}`);
+      }
+    }
+    if (handles.length === 0) {
+      console.log(`${icons2.info} You don't have any handles yet.`);
+      console.log(`  Run ${c3.cmd("aspects handle claim <name>")} to claim one.`);
+      return;
+    }
+    console.log();
+    console.log(`${icons2.info} Your Handles`);
+    console.log();
+    for (const handle of handles) {
+      const defaultTag = handle.default ? c3.success(" (default)") : "";
+      const roleTag = c3.dim(` ${handle.role}`);
+      console.log(`  @${handle.name}${roleTag}${defaultTag}`);
+    }
+    const ownedCount = handles.filter((h4) => h4.role === "owner").length;
+    console.log();
+    console.log(`  ${c3.dim(`${ownedCount}/5 owned handles`)}`);
+    console.log();
+  }
+});
+var defaultCommand = defineCommand({
+  meta: {
+    name: "default",
+    description: "Set your default publishing handle"
+  },
+  args: {
+    name: {
+      type: "positional",
+      description: "Handle to set as default",
+      required: true
+    }
+  },
+  async run({ args }) {
+    const auth = await getAuth();
+    if (!auth) {
+      console.error(`${icons2.error} Not logged in. Run ${c3.cmd("aspects login")} first.`);
+      process.exit(1);
+    }
+    const name = args.name.toLowerCase().replace(/^@/, "");
+    const handles = await getHandles();
+    const hasHandle = handles.some((h4) => h4.name === name);
+    if (!hasHandle) {
+      console.error(`${icons2.error} You don't have access to @${name}`);
+      console.log();
+      console.log("  Your handles:");
+      for (const h4 of handles) {
+        console.log(`    @${h4.name}`);
+      }
+      process.exit(1);
+    }
+    try {
+      await setDefaultHandleApi(name);
+      await setDefaultHandle(name);
+      console.log(`${icons2.success} Default handle set to @${name}`);
+    } catch (err) {
+      if (err instanceof ApiClientError) {
+        console.error(`${icons2.error} ${err.message}`);
+        process.exit(1);
+      }
+      throw err;
+    }
+  }
+});
+var checkCommand = defineCommand({
+  meta: {
+    name: "check",
+    description: "Check if a handle is available"
+  },
+  args: {
+    name: {
+      type: "positional",
+      description: "Handle name to check",
+      required: true
+    }
+  },
+  async run({ args }) {
+    const name = args.name.toLowerCase().replace(/^@/, "");
+    const formatError2 = validateHandleFormat(name);
+    if (formatError2) {
+      console.error(`${icons2.error} ${formatError2}`);
+      process.exit(1);
+    }
+    try {
+      const result = await checkHandleAvailability(name);
+      if (result.available) {
+        console.log(`${icons2.success} @${name} is available`);
+      } else {
+        console.log(`${icons2.error} @${name} is not available`);
+        if (result.reason) {
+          switch (result.reason) {
+            case "taken":
+              console.log(`  This handle is already claimed.`);
+              break;
+            case "reserved":
+              console.log(`  This handle is reserved.`);
+              break;
+            case "invalid":
+              console.log(`  This handle format is not allowed.`);
+              break;
+            default:
+              console.log(`  Reason: ${result.reason}`);
+          }
+        }
+      }
+    } catch (err) {
+      if (err instanceof ApiClientError) {
+        console.error(`${icons2.error} ${err.message}`);
+        process.exit(1);
+      }
+      throw err;
+    }
+  }
+});
+var handle_default = defineCommand({
+  meta: {
+    name: "handle",
+    description: "Manage your handles (namespaces for publishing)"
+  },
+  subCommands: {
+    claim: claimCommand,
+    list: listCommand3,
+    default: defaultCommand,
+    check: checkCommand
+  }
+});
+
+// src/commands/whoami.ts
+var whoami_default = defineCommand({
+  meta: {
+    name: "whoami",
+    description: "Show your current identity"
+  },
+  async run() {
+    const auth = await getAuth();
+    if (!auth) {
+      console.log(`${icons2.info} Not logged in`);
+      console.log(`  Run ${c3.cmd("aspects login")} to authenticate.`);
+      return;
+    }
+    const defaultHandle = await getDefaultHandle();
+    const handles = await getHandles();
+    console.log();
+    if (defaultHandle) {
+      console.log(`  ${c3.bold(`@${defaultHandle}`)} ${c3.dim("(default)")}`);
+    } else if (handles.length === 0) {
+      console.log(`  ${c3.warn("No handles claimed")}`);
+      console.log(`  Run ${c3.cmd("aspects handle claim <name>")} to claim a handle.`);
+      return;
+    }
+    if (handles.length > 0) {
+      console.log();
+      console.log(`  ${c3.bold("Handles")}`);
+      for (const handle of handles) {
+        const isDefault = handle.name === defaultHandle;
+        const roleColor = handle.role === "owner" ? c3.success : c3.dim;
+        const defaultIndicator = isDefault ? c3.success(" *") : "";
+        console.log(`    @${handle.name}  ${roleColor(handle.role)}${defaultIndicator}`);
+      }
+    }
+    const ownedCount = handles.filter((h4) => h4.role === "owner").length;
+    console.log();
+    console.log(`  ${c3.dim(`${ownedCount}/5 owned handles`)}`);
+    const expiresAt = new Date(auth.expiresAt);
+    const isExpired = expiresAt < new Date;
+    if (isExpired) {
+      console.log(`  ${c3.warn("Token expired")} - run ${c3.cmd("aspects login")} to refresh`);
+    }
+    console.log();
+  }
+});
+
 // src/cli.ts
+var VERSION = package_default.version;
 var ALIASES = {
   c: "create",
   new: "create",
@@ -26708,7 +27943,8 @@ var ALIASES = {
   get: "add",
   a: "add",
   i: "add",
-  g: "add"
+  g: "add",
+  h: "handle"
 };
 var ALIAS_HINTS = {};
 for (const [alias, canonical] of Object.entries(ALIASES)) {
@@ -26718,7 +27954,14 @@ var cmdArg = process.argv[2];
 if (cmdArg && ALIASES[cmdArg]) {
   process.argv[2] = ALIASES[cmdArg];
 }
+if (process.argv[2] === "config" && !process.argv[3]) {
+  process.argv.splice(3, 0, "list");
+}
+if (process.argv[2] === "handle" && !process.argv[3]) {
+  process.argv.splice(3, 0, "list");
+}
 var COMMANDS = [
+  { name: "init", cmd: init_default, desc: "Initialize project for local aspects" },
   { name: "create", cmd: create_default, desc: "Create a new aspect interactively", aliases: ["c", "new", "n"] },
   { name: "add", cmd: add_default, desc: "Install aspect(s) to your local library", aliases: ["install", "get", "a", "i", "g"] },
   { name: "list", cmd: list_default, desc: "List installed aspects" },
@@ -26736,14 +27979,42 @@ var COMMANDS = [
   { name: "share", cmd: share_default, desc: "Share an aspect via content hash" },
   { name: "unpublish", cmd: unpublish_default, desc: "Unpublish a version from the registry" },
   { name: "login", cmd: login_default, desc: "Authenticate with the registry" },
-  { name: "logout", cmd: logout_default, desc: "Clear stored authentication tokens" }
+  { name: "logout", cmd: logout_default, desc: "Clear stored authentication tokens" },
+  { name: "handle", cmd: handle_default, desc: "Manage your handles (namespaces)", aliases: ["h"] },
+  { name: "whoami", cmd: whoami_default, desc: "Show your current identity" },
+  { name: "config", cmd: config_default, desc: "View and modify configuration" }
 ];
 function showCustomHelp() {
   morphistBanner();
-  console.log(import_picocolors5.default.dim(`Package manager for AI personality aspects (v0.1.0)`));
+  console.log(import_picocolors5.default.dim(`Package manager for AI personality aspects (v${VERSION})`));
   console.log();
   console.log(`${import_picocolors5.default.bold(import_picocolors5.default.underline("USAGE"))} ${import_picocolors5.default.cyan("aspects")} ${import_picocolors5.default.dim("<command>")} ${import_picocolors5.default.dim("[options]")}`);
   console.log();
+  console.log(import_picocolors5.default.bold(import_picocolors5.default.underline("QUICK START")));
+  console.log();
+  console.log(`  ${import_picocolors5.default.cyan("aspects add alaric")}        Install an aspect from the registry`);
+  console.log(`  ${import_picocolors5.default.cyan("aspects create")}            Create a new aspect interactively`);
+  console.log(`  ${import_picocolors5.default.cyan("aspects search wizard")}     Search for aspects`);
+  console.log();
+  console.log(import_picocolors5.default.bold(import_picocolors5.default.underline("EXAMPLE: CREATE & SHARE (NO ACCOUNT)")));
+  console.log();
+  console.log(`  ${import_picocolors5.default.dim("1.")} ${import_picocolors5.default.cyan("aspects create my-aspect")}   Create aspect interactively`);
+  console.log(`  ${import_picocolors5.default.dim("2.")} ${import_picocolors5.default.dim("Edit")} ./my-aspect/aspect.json  ${import_picocolors5.default.dim("(customize prompt, add directives)")}`);
+  console.log(`  ${import_picocolors5.default.dim("3.")} ${import_picocolors5.default.cyan("aspects share ./my-aspect")}  Share to registry, get hash`);
+  console.log(`  ${import_picocolors5.default.dim("4.")} ${import_picocolors5.default.dim("Share hash with others:")} ${import_picocolors5.default.cyan("aspects add blake3:<hash>")}`);
+  console.log();
+  console.log(import_picocolors5.default.bold(import_picocolors5.default.underline("PUBLISHING")));
+  console.log();
+  console.log(`  ${import_picocolors5.default.cyan("aspects share")}     ${import_picocolors5.default.dim("No account")} - Share via content hash`);
+  console.log(`                    Anyone installs with: ${import_picocolors5.default.cyan("aspects add blake3:<hash>")}`);
+  console.log(`                    Quick, anonymous, no versioning`);
+  console.log();
+  console.log(`  ${import_picocolors5.default.cyan("aspects publish")}   ${import_picocolors5.default.dim("Account required")} - Claim a name`);
+  console.log(`                    Anyone installs with: ${import_picocolors5.default.cyan("aspects add <name>")}`);
+  console.log(`                    Versioning, updates, publisher reputation`);
+  console.log();
+  console.log(`  ${import_picocolors5.default.cyan("aspects login")}     Create account or authenticate`);
+  console.log();
   console.log(import_picocolors5.default.bold(import_picocolors5.default.underline("COMMANDS")));
   console.log();
   const maxNameLen = Math.max(...COMMANDS.map((c5) => c5.name.length));
@@ -26753,7 +28024,15 @@ function showCustomHelp() {
     console.log(`  ${import_picocolors5.default.cyan(paddedName)}  ${desc}${aliasPart}`);
   }
   console.log();
-  console.log(`Use ${import_picocolors5.default.cyan("aspects <command> --help")} for more info.`);
+  console.log(import_picocolors5.default.bold(import_picocolors5.default.underline("CONCEPTS")));
+  console.log();
+  console.log(`  ${import_picocolors5.default.bold("Directives")}    Strict MUST-follow rules with priority levels`);
+  console.log(`                Emphasized across all LLM models (XML, bold, repetition)`);
+  console.log();
+  console.log(`  ${import_picocolors5.default.bold("Instructions")}  Softer guidance and preferences`);
+  console.log(`                General behavioral hints, not strictly enforced`);
+  console.log();
+  console.log(`Use ${import_picocolors5.default.cyan("aspects <command> --help")} for detailed command help.`);
   console.log();
 }
 var showingHelp = process.argv.length === 2 || process.argv.length === 3 && (process.argv[2] === "--help" || process.argv[2] === "-h");
@@ -26768,7 +28047,7 @@ for (const { name, cmd } of COMMANDS) {
 var main = defineCommand({
   meta: {
     name: "aspects",
-    version: "0.1.0",
+    version: VERSION,
     description: "Package manager for AI personality aspects"
   },
   subCommands