claudeup 4.17.0 → 4.19.0

package/src/data/gitignore-reasons.ts

@@ -0,0 +1,103 @@
+import type { RuleAction } from "../types/gitignore.js";
+
+const RULE_REASONS = new Map<string, string>([
+  [
+    key("ignore", ".claude/settings.local.json"),
+    "Personal Claude settings belong to each developer and should not be shared.",
+  ],
+  [
+    key("ignore", ".claude/scheduled_tasks.lock"),
+    "Runtime lock files are local process state and should be regenerated locally.",
+  ],
+  [
+    key("ignore", ".claude/cache/"),
+    "Claude cache contents are local generated data and can grow quickly.",
+  ],
+  [
+    key("ignore", ".claude/.statusline-worktree-*"),
+    "Statusline worktree markers are local runtime state.",
+  ],
+  [
+    key("ignore", "ai-docs/sessions/"),
+    "Session transcripts and scratch notes are local working artifacts.",
+  ],
+  [
+    key("ignore", ".mnemex/"),
+    "Local memory/index data is machine-specific and regenerated by tooling.",
+  ],
+  [
+    key("ignore", ".claudemem/"),
+    "Local claudemem indexes are generated from the repo and should not be committed.",
+  ],
+  [
+    key("ignore", "gtd/sessions/"),
+    "Local GTD session artifacts are personal workflow state.",
+  ],
+  [
+    key("ignore", ".agents/"),
+    "Local agent workspaces and runtime artifacts should stay out of team history.",
+  ],
+  [
+    key("ignore", "node_modules/"),
+    "Installed dependencies are restored from the package manager lockfile.",
+  ],
+  [
+    key("ignore", ".env"),
+    "Environment files commonly contain local secrets and machine-specific values.",
+  ],
+  [
+    key("ignore", ".env.local"),
+    "Local environment overrides commonly contain secrets or developer-specific values.",
+  ],
+  [
+    key("ignore", ".DS_Store"),
+    "macOS Finder metadata is machine-generated noise.",
+  ],
+  [
+    key("ignore", "dist/"),
+    "Distribution output is generated from source during builds.",
+  ],
+  [
+    key("ignore", "build/"),
+    "Build output is generated from source during builds.",
+  ],
+  [
+    key("ignore", "*.log"),
+    "Log files are runtime output and usually contain noisy local details.",
+  ],
+  [
+    key("ignore", "coverage/"),
+    "Coverage reports are generated by test runs.",
+  ],
+  [
+    key("ignore", ".cache/"),
+    "Tool cache contents are local generated data.",
+  ],
+  [
+    key("track", ".claude/settings.json"),
+    "Team Claude settings should be committed so everyone gets the same project behavior.",
+  ],
+  [
+    key("track", ".mcp.json"),
+    "Team MCP configuration should be committed so shared tools are discoverable.",
+  ],
+  [
+    key("track", "plugin.json"),
+    "The plugin manifest is source metadata required by the plugin system.",
+  ],
+]);
+
+export function getGitignoreRuleReason(
+  action: RuleAction,
+  pattern: string,
+): string {
+  const reason = RULE_REASONS.get(key(action, pattern));
+  if (reason) return reason;
+  return action === "ignore"
+    ? "A managed rule says this path should stay out of git."
+    : "A managed rule says this path should stay tracked in git.";
+}
+
+function key(action: RuleAction, pattern: string): string {
+  return `${action}:${pattern}`;
+}

package/src/data/marketplaces.js

@@ -18,6 +18,7 @@ function normalizeRepo(repo) {
 export const deprecatedMarketplaces = {
     "mag-claude-plugins": "magus",
     "MadAppGang-claude-code": "magus",
+    superpowers: "superpowers-marketplace",
 };
 export const defaultMarketplaces = [
     {
@@ -42,13 +43,14 @@ export const defaultMarketplaces = [
         official: true,
     },
     {
-        name: "superpowers",
+        name: "superpowers-marketplace",
         displayName: "Superpowers",
         source: {
             source: "github",
-            repo: "obra/superpowers",
+            repo: "obra/superpowers-marketplace",
         },
-        description: "Jesse Vincent's agentic skills framework and software development methodology",
+        description: "Curated Claude Code plugins for skills and workflows",
+        featured: true,
     },
     {
         name: "claude-code-plugins",

package/src/data/marketplaces.ts

@@ -23,6 +23,7 @@ function normalizeRepo(repo: string): string {
 export const deprecatedMarketplaces: Record<string, string> = {
 	"mag-claude-plugins": "magus",
 	"MadAppGang-claude-code": "magus",
+	superpowers: "superpowers-marketplace",
 };
 
 export const defaultMarketplaces: Marketplace[] = [
@@ -50,14 +51,14 @@ export const defaultMarketplaces: Marketplace[] = [
 		official: true,
 	},
 	{
-		name: "superpowers",
+		name: "superpowers-marketplace",
 		displayName: "Superpowers",
 		source: {
 			source: "github",
-			repo: "obra/superpowers",
+			repo: "obra/superpowers-marketplace",
 		},
-		description:
-			"Jesse Vincent's agentic skills framework and software development methodology",
+		description: "Curated Claude Code plugins for skills and workflows",
+		featured: true,
 	},
 	{
 		name: "claude-code-plugins",

package/src/services/alias-settings.js

@@ -0,0 +1,51 @@
+/**
+ * Read/write the managed-alias name in Claude Code's `settings.json`.
+ *
+ * The alias is computer-wide (one name per user), so it lives in
+ * `~/.claude/settings.json` only — no project scope. We store it under a
+ * `claudeup` namespace to avoid colliding with Claude Code's own keys:
+ *
+ *   {
+ *     "model": "sonnet",
+ *     "claudeup": {
+ *       "aliasName": "c"
+ *     }
+ *   }
+ *
+ * Flag values are NOT stored here. They live in the shell rc file's managed
+ * block and are read on screen mount via `parseAliasFromRc`.
+ */
+import { readGlobalSettings, writeGlobalSettings, } from "./claude-settings.js";
+import { DEFAULT_ALIAS_NAME, validateAliasName } from "./alias-store.js";
+/**
+ * Load the user's preferred alias name from `~/.claude/settings.json`.
+ * Returns the default `"c"` when the key is absent or invalid.
+ */
+export async function loadAliasName() {
+    const settings = (await readGlobalSettings());
+    const stored = settings.claudeup?.aliasName;
+    if (typeof stored !== "string")
+        return DEFAULT_ALIAS_NAME;
+    if (validateAliasName(stored) !== null)
+        return DEFAULT_ALIAS_NAME;
+    return stored;
+}
+/**
+ * Save the alias name to `~/.claude/settings.json`, preserving all other
+ * keys (including unrelated Claude Code settings). No-op without throwing
+ * if the name fails validation — caller should validate first.
+ */
+export async function saveAliasName(name) {
+    if (validateAliasName(name) !== null)
+        return;
+    const settings = (await readGlobalSettings());
+    const next = {
+        ...settings,
+        claudeup: {
+            ...(settings.claudeup ?? {}),
+            aliasName: name,
+        },
+    };
+    // claude-settings.writeGlobalSettings accepts the same shape we received.
+    await writeGlobalSettings(next);
+}

package/src/services/alias-settings.ts

@@ -0,0 +1,63 @@
+/**
+ * Read/write the managed-alias name in Claude Code's `settings.json`.
+ *
+ * The alias is computer-wide (one name per user), so it lives in
+ * `~/.claude/settings.json` only — no project scope. We store it under a
+ * `claudeup` namespace to avoid colliding with Claude Code's own keys:
+ *
+ *   {
+ *     "model": "sonnet",
+ *     "claudeup": {
+ *       "aliasName": "c"
+ *     }
+ *   }
+ *
+ * Flag values are NOT stored here. They live in the shell rc file's managed
+ * block and are read on screen mount via `parseAliasFromRc`.
+ */
+
+import {
+  readGlobalSettings,
+  writeGlobalSettings,
+} from "./claude-settings.js";
+import { DEFAULT_ALIAS_NAME, validateAliasName } from "./alias-store.js";
+
+interface ClaudeupSettings {
+  aliasName?: string;
+}
+
+interface SettingsWithClaudeup {
+  claudeup?: ClaudeupSettings;
+  [key: string]: unknown;
+}
+
+/**
+ * Load the user's preferred alias name from `~/.claude/settings.json`.
+ * Returns the default `"c"` when the key is absent or invalid.
+ */
+export async function loadAliasName(): Promise<string> {
+  const settings = (await readGlobalSettings()) as SettingsWithClaudeup;
+  const stored = settings.claudeup?.aliasName;
+  if (typeof stored !== "string") return DEFAULT_ALIAS_NAME;
+  if (validateAliasName(stored) !== null) return DEFAULT_ALIAS_NAME;
+  return stored;
+}
+
+/**
+ * Save the alias name to `~/.claude/settings.json`, preserving all other
+ * keys (including unrelated Claude Code settings). No-op without throwing
+ * if the name fails validation — caller should validate first.
+ */
+export async function saveAliasName(name: string): Promise<void> {
+  if (validateAliasName(name) !== null) return;
+  const settings = (await readGlobalSettings()) as SettingsWithClaudeup;
+  const next: SettingsWithClaudeup = {
+    ...settings,
+    claudeup: {
+      ...(settings.claudeup ?? {}),
+      aliasName: name,
+    },
+  };
+  // claude-settings.writeGlobalSettings accepts the same shape we received.
+  await writeGlobalSettings(next as Parameters<typeof writeGlobalSettings>[0]);
+}