agentloom 0.1.0 → 0.1.1

package/dist/core/copy.js

@@ -1,17 +1,26 @@
 const PROVIDERS_CSV = "cursor,claude,codex,opencode,gemini,copilot";
 export function getRootHelpText() {
-    return `agentloom - unified agent and MCP sync CLI
+    return `agentloom - unified canonical agent package manager
 
 Usage:
-  agentloom <command> [options]
+  agentloom <aggregate-command> [options]
+  agentloom <entity> <verb> [options]
 
-Commands:
-  skills ...                 Pass through to "npx skills ..." (vercel-labs/skills)
-  add <source>               Import agents and MCP from a repo source
-  update                     Refresh lockfile-managed imports
+Aggregate commands:
+  add <source>               Import agents/commands/mcp/skills from a source
+  find <query>               Search remote + local entities
+  update [source]            Refresh lockfile-managed imports
   sync                       Generate provider-specific outputs
-  mcp <add|list|delete>      Manage canonical MCP servers
-  help                       Show this help text
+  delete <source|name>       Delete imported entities by source or name
+
+Entity commands:
+  agent <add|list|delete|find|update|sync>
+  command <add|list|delete|find|update|sync>
+  mcp <add|list|delete|find|update|sync>
+  skill <add|list|delete|find|update|sync>
+
+MCP manual server commands:
+  mcp server <add|list|delete>
 
 Common options:
   --local                    Use .agents from current workspace
@@ -20,18 +29,46 @@ Common options:
   --no-sync                  Skip post-change sync (mutating commands)
   --providers <csv>          Limit sync providers (${PROVIDERS_CSV})
   --dry-run                  Print planned sync changes without writing files
+  --agents <csv>             Agent selectors for add/delete
+  --commands <csv>           Command selectors for add/delete
+  --mcps <csv>               MCP selectors for add/delete
+  --skills <csv>             Skill selectors for add/delete
+  --selection-mode <mode>    Add mode: all (default) or custom
+  --source <value>           Explicit source filter for update/delete
+  --name <value>             Explicit name filter for delete
+  --entity <type>            Delete disambiguation for aggregate delete
 
 Examples:
-  agentloom add vercel-labs/skills
-  agentloom add /repo --subdir packages/agents
-  agentloom update --local
-  agentloom sync --providers codex,claude,cursor
-  agentloom mcp add browser-tools --command npx --arg browser-tools-mcp
-  agentloom skills add vercel-labs/skills
+  agentloom add farnoodma/agents
+  agentloom agent add farnoodma/agents --agents issue-creator
+  agentloom command add farnoodma/agents --commands review
+  agentloom mcp add farnoodma/agents --mcps browser
+  agentloom skill add farnoodma/agents --skills pr-review
+  agentloom update
+  agentloom command update farnoodma/agents
+  agentloom delete farnoodma/agents
+  agentloom mcp server add browser --command npx --arg browser-tools-mcp
+`;
+}
+export function getFindHelpText() {
+    return `Search remote repositories and local .agents entities.
+
+Usage:
+  agentloom find <query>
+  agentloom <agent|command|mcp|skill> find <query>
+
+Examples:
+  agentloom find reviewer
+  agentloom command find release
 `;
 }
 export function getAddHelpText() {
-    return `Import canonical agents and MCP from a source repository.
+    return `Import canonical entities from a source repository.
+
+Source discovery:
+  agents: .agents/agents -> agents
+  commands: .agents/commands -> commands -> prompts
+  skills: .agents/skills -> skills -> root SKILL.md
 
 Usage:
   agentloom add <source> [options]
@@ -39,116 +76,133 @@ Usage:
 Options:
   --ref <ref>                Git ref (branch/tag/commit) for remote sources
   --subdir <path>            Subdirectory inside source repo
-  --rename <name>            Rename imported agent (single-agent import only)
-  --local | --global         Choose destination scope
-  --yes                      Skip conflict prompts (overwrite/merge defaults)
+  --agents <name>            Import selected agents (repeatable/csv)
+  --commands <name>          Import selected commands (repeatable/csv)
+  --mcps <name>              Import selected MCP servers (repeatable/csv)
+  --skills <name>            Import selected skills (repeatable/csv)
+  --selection-mode <mode>    all|sync-all (include future items) or custom (pin selection)
+  --rename <name>            Rename imported item for single-item add flows
+  --local | --global         Choose destination scope (interactive prompts when omitted)
+  --yes                      Skip conflict prompts
   --no-sync                  Do not run sync after import
   --providers <csv>          Providers for post-import sync (${PROVIDERS_CSV})
   --dry-run                  Show sync plan without writing provider files
 
 Example:
-  agentloom add vercel-labs/skills --subdir skills --providers codex,claude
+  agentloom add farnoodma/agents --providers codex,claude
 `;
 }
 export function getUpdateHelpText() {
     return `Refresh lockfile-managed sources and re-import updated revisions.
 
 Usage:
-  agentloom update [options]
+  agentloom update [source] [options]
+  agentloom <agent|command|mcp|skill> update [source] [options]
 
 Options:
-  --local | --global         Choose lockfile scope
+  --source <value>           Explicit source filter
+  --local | --global         Choose lockfile scope (interactive prompts when omitted)
   --yes                      Skip conflict prompts during re-import
   --no-sync                  Do not run sync after updates
   --providers <csv>          Providers for post-update sync (${PROVIDERS_CSV})
   --dry-run                  Show sync plan without writing provider files
 
 Example:
-  agentloom update --local --providers codex,cursor
+  agentloom update farnoodma/agents --providers codex,cursor
 `;
 }
 export function getSyncHelpText() {
-    return `Generate provider-specific agent and MCP files from canonical .agents data.
+    return `Generate provider-specific files from canonical .agents data.
 
 Usage:
   agentloom sync [options]
+  agentloom <agent|command|mcp|skill> sync [options]
 
 Options:
-  --local | --global         Choose canonical scope
+  --local | --global         Choose canonical scope (interactive prompts when omitted)
   --providers <csv>          Limit providers (${PROVIDERS_CSV})
   --yes                      Auto-delete stale generated files
   --dry-run                  Show file changes without writing
+`;
+}
+export function getCommandHelpText() {
+    return `Manage canonical command entities.
 
-Example:
-  agentloom sync --local --providers codex,claude,cursor --dry-run
+Usage:
+  agentloom command <add|list|delete|find|update|sync> [options]
 `;
 }
-export function getMcpHelpText() {
-    return `Manage canonical MCP servers in .agents/mcp.json.
+export function getCommandAddHelpText() {
+    return `Import canonical command files from a source repository.
+
+Usage:
+  agentloom command add <source> [options]
+
+Options:
+  --commands <name>          Repeatable command selector (name or filename)
+  --ref <ref>                Git ref (branch/tag/commit) for remote sources
+  --subdir <path>            Subdirectory inside source repo
+  --rename <name>            Rename imported command (single-command import only)
+`;
+}
+export function getCommandListHelpText() {
+    return `List canonical command files.
 
 Usage:
-  agentloom mcp <command> [options]
+  agentloom command list [--json] [--local|--global]
+`;
+}
+export function getCommandDeleteHelpText() {
+    return `Delete command imports by source or name.
 
-Commands:
-  add <name>                 Add or update an MCP server
-  list                       List configured MCP servers
-  delete <name>              Remove an MCP server
+Usage:
+  agentloom command delete <source|name> [options]
+`;
+}
+export function getMcpHelpText() {
+    return `Manage MCP entities imported from sources.
 
-Shared options:
-  --local | --global         Choose canonical scope
-  --no-sync                  Skip post-change sync (add/delete only)
-  --providers <csv>          Providers for post-change sync (${PROVIDERS_CSV})
+Usage:
+  agentloom mcp <add|list|delete|find|update|sync> [options]
+  agentloom mcp server <add|list|delete> [options]
+`;
+}
+export function getMcpServerHelpText() {
+    return `Manage manual MCP servers in canonical .agents/mcp.json.
+
+Usage:
+  agentloom mcp server <add|list|delete> [options]
 
 Examples:
-  agentloom mcp add browser --command npx --arg browser-tools-mcp
-  agentloom mcp list --json
-  agentloom mcp delete browser
+  agentloom mcp server add browser --command npx --arg browser-tools-mcp
+  agentloom mcp server list --json
+  agentloom mcp server delete browser
 `;
 }
 export function getMcpAddHelpText() {
-    return `Add or update an MCP server in canonical .agents/mcp.json.
+    return `Add or update a manual MCP server in canonical .agents/mcp.json.
 
 Usage:
-  agentloom mcp add <name> (--url <url> | --command <cmd>) [options]
+  agentloom mcp server add <name> (--url <url> | --command <cmd>) [options]
 
 Options:
   --arg <value>              Repeatable command argument
   --env KEY=VALUE            Repeatable environment variable
   --providers <csv>          Provider-specific server assignment (${PROVIDERS_CSV})
-  --local | --global         Choose canonical scope
-  --no-sync                  Skip post-change sync
-
-Examples:
-  agentloom mcp add browser --command npx --arg browser-tools-mcp
-  agentloom mcp add docs --url https://example.com/mcp --providers codex,claude
 `;
 }
 export function getMcpListHelpText() {
     return `List canonical MCP servers.
 
 Usage:
-  agentloom mcp list [options]
-
-Options:
-  --json                     Print raw JSON
-  --local | --global         Choose canonical scope
-
-Example:
-  agentloom mcp list --json
+  agentloom mcp server list [--json] [--local|--global]
 `;
 }
 export function getMcpDeleteHelpText() {
-    return `Delete an MCP server from canonical .agents/mcp.json.
+    return `Delete a manual MCP server from canonical .agents/mcp.json.
 
 Usage:
-  agentloom mcp delete <name> [options]
-
-Options:
-  --local | --global         Choose canonical scope
-  --no-sync                  Skip post-change sync
-
-Example:
-  agentloom mcp delete browser
+  agentloom mcp server delete <name> [options]
 `;
 }
 export function formatUsageError(input) {
@@ -159,6 +213,13 @@ export function formatUsageError(input) {
     return lines.join("\n");
 }
 export function formatUnknownCommandError(command) {
+    if (command === "skills") {
+        return formatUsageError({
+            issue: 'Command "skills" was removed.',
+            usage: "agentloom skill <add|list|delete|find|update|sync> [options]",
+            example: "agentloom skill find typescript",
+        });
+    }
     return formatUsageError({
         issue: `Unknown command "${command}".`,
         usage: "agentloom --help",

package/dist/core/importer.d.ts

@@ -1,4 +1,4 @@
-import type { ScopePaths } from "../types.js";
+import type { Provider, SelectionMode, ScopePaths } from "../types.js";
 export declare class NonInteractiveConflictError extends Error {
     constructor(message: string);
 }
@@ -7,15 +7,42 @@ export interface ImportOptions {
     ref?: string;
     subdir?: string;
     rename?: string;
+    agents?: string[];
+    promptForAgentSelection?: boolean;
     yes?: boolean;
     nonInteractive?: boolean;
     paths: ScopePaths;
+    importAgents?: boolean;
+    requireAgents?: boolean;
+    importCommands?: boolean;
+    requireCommands?: boolean;
+    importMcp?: boolean;
+    requireMcp?: boolean;
+    mcpSelectors?: string[];
+    promptForMcp?: boolean;
+    importSkills?: boolean;
+    requireSkills?: boolean;
+    skillSelectors?: string[];
+    promptForSkills?: boolean;
+    skillsProviders?: Provider[];
+    resolveSkillsProviders?: () => Promise<Provider[] | undefined>;
+    skillRenameMap?: Record<string, string>;
+    selectionMode?: SelectionMode;
+    commandSelectors?: string[];
+    commandRenameMap?: Record<string, string>;
+    promptForCommands?: boolean;
 }
 export interface ImportSummary {
     source: string;
     sourceType: "local" | "github" | "git";
     importedAgents: string[];
+    importedCommands: string[];
     importedMcpServers: string[];
+    importedSkills: string[];
+    telemetrySkills?: Array<{
+        name: string;
+        filePath: string;
+    }>;
     resolvedCommit: string;
 }
 export declare function importSource(options: ImportOptions): Promise<ImportSummary>;