@aigne/afs-cli 1.11.0-beta.10 → 1.11.0-beta.12

package/dist/core/commands/explain.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"explain.mjs","names":[],"sources":["../../../src/core/commands/explain.ts"],"sourcesContent":["/**\n * explain Command - Core Implementation\n *\n * Explains AFS paths or concepts.\n * Matches old version output format with topic/explanation/examples structure.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport type { CommandModule } from \"yargs\";\nimport { configMountListCommand } from \"../../config/mount-commands.js\";\nimport { formatExplainOutput, formatPathExplainOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Result for concept explanations (mount, paths, uri, overview)\n */\nexport interface ExplainResult {\n  topic: string;\n  explanation: string;\n  examples?: string[];\n}\n\n/**\n * Result for path explanations\n */\nexport interface PathExplainResult {\n  path: string;\n  type: string;\n  description?: string;\n  inputs?: string[];\n  outputs?: string[];\n  errors?: string[];\n  sideEffects?: string[];\n  meta?: Record<string, string>;\n  /** When set, the formatter renders this markdown directly instead of structured fields */\n  markdown?: string;\n}\n\n/**\n * Explain command arguments\n */\nexport interface ExplainArgs {\n  topic?: string;\n}\n\n/**\n * Create explain command factory\n */\nexport function createExplainCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ExplainArgs> {\n  return {\n    command: \"explain [topic]\",\n    describe: \"Explain AFS concepts or paths\",\n    builder: {\n      topic: {\n        type: \"string\",\n        description: \"Topic (mount, path, uri) or AFS path (e.g., /src)\",\n      },\n    },\n    handler: async (argv) => {\n      const target = argv.topic;\n\n      // No target - explain overview\n      if (!target) {\n        options.onResult({\n          command: \"explain\",\n          result: explainOverview(),\n          format: formatExplainOutput,\n        });\n        return;\n      }\n\n      // Priority: try as path first, then as concept\n      const isPath = target.startsWith(\"/\") || target.startsWith(\"@\") || target.startsWith(\"$\");\n\n      if (isPath) {\n        const afs = await resolveAFS(options);\n        const canonicalPath = cliPathToCanonical(target);\n        const result = await getPathExplanation(afs, target, canonicalPath);\n        options.onResult({ command: \"explain\", result, format: formatPathExplainOutput });\n      } else {\n        // Not obviously a path — try as path first, fall back to concept\n        let afs: AFS | undefined;\n        try {\n          afs = await resolveAFS(options);\n        } catch {}\n\n        if (afs) {\n          try {\n            const canonicalPath = cliPathToCanonical(`/${target}`);\n            const explainResult = await afs.explain(canonicalPath);\n            if (explainResult.format === \"markdown\" && explainResult.content) {\n              options.onResult({\n                command: \"explain\",\n                result: { path: `/${target}`, type: \"explained\", markdown: explainResult.content },\n                format: formatPathExplainOutput,\n              });\n              return;\n            }\n          } catch {\n            // Not a valid path, fall through to concept\n          }\n        }\n\n        const cwd = options.cwd ?? process.cwd();\n        const result = await getConceptExplanation(target.toLowerCase(), cwd, afs);\n        options.onResult({\n          command: \"explain\",\n          result,\n          format: formatExplainOutput,\n        });\n      }\n    },\n  };\n}\n\n/**\n * Get explanation for a path\n */\nasync function getPathExplanation(\n  afs: AFS,\n  path: string,\n  canonicalPath: string,\n): Promise<PathExplainResult> {\n  try {\n    // Always try afs.explain() first — transparent passthrough to provider explain\n    try {\n      const explainResult = await afs.explain(canonicalPath);\n      if (explainResult.format === \"markdown\" && explainResult.content) {\n        return {\n          path,\n          type: \"explained\",\n          markdown: explainResult.content,\n        };\n      }\n    } catch {\n      // explain not available, fall through to stat-based logic\n    }\n\n    // Fallback: stat-based explanation\n    let entry:\n      | { path: string; meta?: Record<string, unknown> | null; content?: unknown }\n      | undefined;\n\n    try {\n      const statResult = await afs.stat(canonicalPath);\n      entry = statResult.data;\n    } catch {}\n\n    if (!entry) {\n      try {\n        const readResult = await afs.read(canonicalPath);\n        entry = readResult.data;\n      } catch {}\n    }\n\n    if (!entry) {\n      return {\n        path,\n        type: \"unknown\",\n      };\n    }\n\n    const metadata = entry.meta || {};\n    // Determine type from childrenCount: if defined, it has children (directory-like); otherwise file-like\n    const entryType =\n      metadata.kind === \"afs:executable\"\n        ? \"exec\"\n        : typeof metadata.childrenCount === \"number\"\n          ? \"directory\"\n          : \"file\";\n\n    const result: PathExplainResult = {\n      path: entry.path,\n      type: entryType,\n      description: metadata.description as string | undefined,\n      meta: {},\n    };\n\n    // Add metadata\n    if (metadata.provider) {\n      result.meta!.provider = String(metadata.provider);\n    }\n    if (metadata.permissions) {\n      const perms = metadata.permissions;\n      result.meta!.permissions = Array.isArray(perms) ? perms.join(\", \") : String(perms);\n    }\n\n    // For exec type, try to get schema info\n    if (entryType === \"exec\") {\n      if (metadata.inputs) {\n        result.inputs = Array.isArray(metadata.inputs)\n          ? (metadata.inputs as string[])\n          : [String(metadata.inputs)];\n      }\n      if (metadata.outputs) {\n        result.outputs = Array.isArray(metadata.outputs)\n          ? (metadata.outputs as string[])\n          : [String(metadata.outputs)];\n      }\n      if (metadata.errors) {\n        result.errors = Array.isArray(metadata.errors)\n          ? (metadata.errors as string[])\n          : [String(metadata.errors)];\n      }\n      if (metadata.sideEffects) {\n        result.sideEffects = Array.isArray(metadata.sideEffects)\n          ? (metadata.sideEffects as string[])\n          : [String(metadata.sideEffects)];\n      }\n    }\n\n    // Clean up empty metadata\n    if (Object.keys(result.meta!).length === 0) {\n      delete result.meta;\n    }\n\n    return result;\n  } catch (err) {\n    return {\n      path,\n      type: \"error\",\n      description: err instanceof Error ? err.message : String(err),\n    };\n  }\n}\n\n/**\n * Get explanation for a concept\n */\nasync function getConceptExplanation(\n  topic: string,\n  cwd: string,\n  afs?: AFS,\n): Promise<ExplainResult> {\n  switch (topic) {\n    case \"mount\":\n    case \"mounts\":\n      return explainMounts(cwd, afs);\n    case \"path\":\n    case \"paths\":\n      return explainPaths();\n    case \"uri\":\n    case \"provider\":\n    case \"providers\":\n      return explainUri();\n    default:\n      return {\n        topic: \"Unknown Topic\",\n        explanation: `Unknown topic: ${topic}\\n\\nAvailable topics: overview, mount, path, uri`,\n      };\n  }\n}\n\nfunction explainOverview(): ExplainResult {\n  return {\n    topic: \"AFS Overview\",\n    explanation: `AFS (Abstract File System) is a virtual filesystem that unifies different data sources into a single namespace.\n\nCore Concepts:\n- mount: Mount a data source to a virtual path\n- path: Virtual path, e.g., /src, /data\n- uri: Data source address, e.g., fs://, git://, sqlite://\n\nData Flow:\n  User Path -> AFS -> /{mount} -> Provider -> Actual Data`,\n    examples: [\"afs mount add /src fs:///path/to/source\", \"afs ls /src\", \"afs read /src/file.txt\"],\n  };\n}\n\nasync function explainMounts(cwd: string, afs?: AFS): Promise<ExplainResult> {\n  const result = await configMountListCommand(cwd);\n\n  if (result.mounts.length === 0) {\n    // Try runtime mounts if no config mounts\n    if (afs) {\n      try {\n        const listResult = await afs.list(\"$afs:/\");\n        if (listResult.data?.length) {\n          const runtimeMounts = listResult.data\n            .map((entry) => `  ${entry.path} (runtime mount)`)\n            .join(\"\\n\");\n\n          return {\n            topic: \"Mounts\",\n            explanation: `Runtime mounts (mounted via API):\\n\\n${runtimeMounts}`,\n            examples: listResult.data.slice(0, 3).map((entry) => `afs ls ${entry.path}`),\n          };\n        }\n      } catch {}\n    }\n\n    return {\n      topic: \"Mounts\",\n      explanation: `No mounts configured.\n\nUse mount add to add a mount:\n  afs mount add <path> <uri>\n\npath: Virtual path for accessing data in AFS\nuri: Data source URI specifying the data origin`,\n      examples: [\n        \"afs mount add /src fs:///Users/me/project\",\n        \"afs mount add /data sqlite:///data.db\",\n      ],\n    };\n  }\n\n  const mountList = result.mounts\n    .map((m) => `  ${m.path}${m.description ? ` - ${m.description}` : \"\"}`)\n    .join(\"\\n\");\n\n  return {\n    topic: \"Mounts\",\n    explanation: `Current mount configuration:\n\n${mountList}\n\nAfter mounting, data is accessed via the mount path:\n  path=\"/src\" -> /src`,\n    examples: result.mounts.map((m) => `afs ls ${m.path}`),\n  };\n}\n\nfunction explainPaths(): ExplainResult {\n  return {\n    topic: \"Paths\",\n    explanation: `AFS Path Structure:\n\n/                     Root directory\n/{mount}              Mounted data source\n/{mount}/{path}       Files/nodes within a mount\n\nPath Mapping:\n  config: path=\"/src\"  ->  access: /src\n  config: path=\"/data\" ->  access: /data\n\nMounts are accessed directly at their configured path.`,\n  };\n}\n\nfunction explainUri(): ExplainResult {\n  return {\n    topic: \"URI\",\n    explanation: `AFS URI Schemes and Objects:\n\nfs://       Local Filesystem Provider\n  Format: fs:///absolute/path or fs://./relative/path\n  Operations: list, read, write, delete\n\ngit://      Git Repository Provider\n  Format: git:///local/repo or git://github.com/user/repo?branch=main\n  Operations: list, read, exec (diff, create-branch, commit, merge)\n\nsqlite://   SQLite Database Provider\n  Format: sqlite:///path/to/db.sqlite\n  Operations: list, read, exec (SQL queries)\n\njson://     JSON Data Provider\n  Format: json:///path/to/data.json\n  Operations: list, read, write\n\ntoml://     TOML Data Provider\n  Format: toml:///path/to/config.toml\n  Operations: list, read, write\n\nsandbox://  Sandboxed Script Execution Provider\n  Format: sandbox:///path/to/scripts\n  Operations: list, read, exec\n\ngithub://   GitHub Issues/PRs Provider\n  Format: github://owner/repo\n  Operations: list, read, exec (create-issue, close-issue, etc.)\n\nhttp://     HTTP Proxy Provider\n  Format: http://host:port/path\n  Operations: list, read\n\nmcp://      MCP Server Provider\n  Format: mcp:///path/to/server\n  Operations: list, read, exec\n\ns3://       AWS S3 Storage Provider\n  Format: s3://bucket-name\n  Operations: list, read, write, delete\n\ngcs://      Google Cloud Storage Provider\n  Format: gcs://bucket-name\n  Operations: list, read, write, delete\n\nec2://      AWS EC2 Instances Provider\n  Format: ec2://region\n  Operations: list, read, exec (run-instances)\n\ngce://      Google Compute Engine Provider\n  Format: gce://project/zone\n  Operations: list, read, exec\n\ndns://      Cloud DNS Provider\n  Format: dns://provider (route53, clouddns)\n  Operations: list, read`,\n    examples: [\n      \"afs mount add /src fs:///Users/me/project\",\n      \"afs mount add /repo git://github.com/user/repo\",\n      \"afs mount add /db sqlite:///data.sqlite\",\n      \"afs mount add /s3 s3://my-bucket\",\n    ],\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"explain.mjs","names":[],"sources":["../../../src/core/commands/explain.ts"],"sourcesContent":["/**\n * explain Command - Core Implementation\n *\n * Explains AFS paths or concepts.\n * Matches old version output format with topic/explanation/examples structure.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport type { CommandModule } from \"yargs\";\nimport { configMountListCommand } from \"../../config/mount-commands.js\";\nimport { formatExplainOutput, formatPathExplainOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Result for concept explanations (mount, paths, uri, overview)\n */\nexport interface ExplainResult {\n  topic: string;\n  explanation: string;\n  examples?: string[];\n}\n\n/**\n * Result for path explanations\n */\nexport interface PathExplainResult {\n  path: string;\n  type: string;\n  description?: string;\n  inputs?: string[];\n  outputs?: string[];\n  errors?: string[];\n  sideEffects?: string[];\n  meta?: Record<string, string>;\n  /** When set, the formatter renders this markdown directly instead of structured fields */\n  markdown?: string;\n}\n\n/**\n * Explain command arguments\n */\nexport interface ExplainArgs {\n  topic?: string;\n}\n\n/**\n * Create explain command factory\n */\nexport function createExplainCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ExplainArgs> {\n  return {\n    command: \"explain [topic]\",\n    describe: \"Explain AFS concepts or paths\",\n    builder: {\n      topic: {\n        type: \"string\",\n        description: \"Topic (mount, path, uri) or AFS path (e.g., /src)\",\n      },\n    },\n    handler: async (argv) => {\n      const target = argv.topic;\n\n      // No target - explain overview\n      if (!target) {\n        options.onResult({\n          command: \"explain\",\n          result: explainOverview(),\n          format: formatExplainOutput,\n        });\n        return;\n      }\n\n      // Priority: try as path first, then as concept\n      const isPath = target.startsWith(\"/\") || target.startsWith(\"@\") || target.startsWith(\"$\");\n\n      if (isPath) {\n        const afs = await resolveAFS(options);\n        const canonicalPath = cliPathToCanonical(target);\n        const result = await getPathExplanation(afs, target, canonicalPath);\n        options.onResult({ command: \"explain\", result, format: formatPathExplainOutput });\n      } else {\n        // Not obviously a path — try as path first, fall back to concept\n        let afs: AFS | undefined;\n        try {\n          afs = await resolveAFS(options);\n        } catch {\n          // AFS may not be configured — fall through to concept explanation\n        }\n\n        if (afs) {\n          try {\n            const canonicalPath = cliPathToCanonical(`/${target}`);\n            const explainResult = await afs.explain(canonicalPath);\n            if (explainResult.format === \"markdown\" && explainResult.content) {\n              options.onResult({\n                command: \"explain\",\n                result: { path: `/${target}`, type: \"explained\", markdown: explainResult.content },\n                format: formatPathExplainOutput,\n              });\n              return;\n            }\n          } catch {\n            // Not a valid path, fall through to concept\n          }\n        }\n\n        const cwd = options.cwd ?? process.cwd();\n        const result = await getConceptExplanation(target.toLowerCase(), cwd, afs);\n        options.onResult({\n          command: \"explain\",\n          result,\n          format: formatExplainOutput,\n        });\n      }\n    },\n  };\n}\n\n/**\n * Get explanation for a path\n */\nasync function getPathExplanation(\n  afs: AFS,\n  path: string,\n  canonicalPath: string,\n): Promise<PathExplainResult> {\n  try {\n    // Always try afs.explain() first — transparent passthrough to provider explain\n    try {\n      const explainResult = await afs.explain(canonicalPath);\n      if (explainResult.format === \"markdown\" && explainResult.content) {\n        return {\n          path,\n          type: \"explained\",\n          markdown: explainResult.content,\n        };\n      }\n    } catch {\n      // explain not available, fall through to stat-based logic\n    }\n\n    // Fallback: stat-based explanation\n    let entry:\n      | { path: string; meta?: Record<string, unknown> | null; content?: unknown }\n      | undefined;\n\n    try {\n      const statResult = await afs.stat(canonicalPath);\n      entry = statResult.data;\n    } catch {\n      // stat() optional — fall through to read()\n    }\n\n    if (!entry) {\n      try {\n        const readResult = await afs.read(canonicalPath);\n        entry = readResult.data;\n      } catch {\n        // read() also failed — entry stays undefined, returns \"unknown\" type below\n      }\n    }\n\n    if (!entry) {\n      return {\n        path,\n        type: \"unknown\",\n      };\n    }\n\n    const metadata = entry.meta || {};\n    // Determine type from childrenCount: if defined, it has children (directory-like); otherwise file-like\n    const entryType =\n      metadata.kind === \"afs:executable\"\n        ? \"exec\"\n        : typeof metadata.childrenCount === \"number\"\n          ? \"directory\"\n          : \"file\";\n\n    const result: PathExplainResult = {\n      path: entry.path,\n      type: entryType,\n      description: metadata.description as string | undefined,\n      meta: {},\n    };\n\n    // Add metadata\n    if (metadata.provider) {\n      result.meta!.provider = String(metadata.provider);\n    }\n    if (metadata.permissions) {\n      const perms = metadata.permissions;\n      result.meta!.permissions = Array.isArray(perms) ? perms.join(\", \") : String(perms);\n    }\n\n    // For exec type, try to get schema info\n    if (entryType === \"exec\") {\n      if (metadata.inputs) {\n        result.inputs = Array.isArray(metadata.inputs)\n          ? (metadata.inputs as string[])\n          : [String(metadata.inputs)];\n      }\n      if (metadata.outputs) {\n        result.outputs = Array.isArray(metadata.outputs)\n          ? (metadata.outputs as string[])\n          : [String(metadata.outputs)];\n      }\n      if (metadata.errors) {\n        result.errors = Array.isArray(metadata.errors)\n          ? (metadata.errors as string[])\n          : [String(metadata.errors)];\n      }\n      if (metadata.sideEffects) {\n        result.sideEffects = Array.isArray(metadata.sideEffects)\n          ? (metadata.sideEffects as string[])\n          : [String(metadata.sideEffects)];\n      }\n    }\n\n    // Clean up empty metadata\n    if (Object.keys(result.meta!).length === 0) {\n      delete result.meta;\n    }\n\n    return result;\n  } catch (err) {\n    return {\n      path,\n      type: \"error\",\n      description: err instanceof Error ? err.message : String(err),\n    };\n  }\n}\n\n/**\n * Get explanation for a concept\n */\nasync function getConceptExplanation(\n  topic: string,\n  cwd: string,\n  afs?: AFS,\n): Promise<ExplainResult> {\n  switch (topic) {\n    case \"mount\":\n    case \"mounts\":\n      return explainMounts(cwd, afs);\n    case \"path\":\n    case \"paths\":\n      return explainPaths();\n    case \"uri\":\n    case \"provider\":\n    case \"providers\":\n      return explainUri();\n    default:\n      return {\n        topic: \"Unknown Topic\",\n        explanation: `Unknown topic: ${topic}\\n\\nAvailable topics: overview, mount, path, uri`,\n      };\n  }\n}\n\nfunction explainOverview(): ExplainResult {\n  return {\n    topic: \"AFS Overview\",\n    explanation: `AFS (Abstract File System) is a virtual filesystem that unifies different data sources into a single namespace.\n\nCore Concepts:\n- mount: Mount a data source to a virtual path\n- path: Virtual path, e.g., /src, /data\n- uri: Data source address, e.g., fs://, git://, sqlite://\n\nData Flow:\n  User Path -> AFS -> /{mount} -> Provider -> Actual Data`,\n    examples: [\"afs mount add /src fs:///path/to/source\", \"afs ls /src\", \"afs read /src/file.txt\"],\n  };\n}\n\nasync function explainMounts(cwd: string, afs?: AFS): Promise<ExplainResult> {\n  const result = await configMountListCommand(cwd);\n\n  if (result.mounts.length === 0) {\n    // Try runtime mounts if no config mounts\n    if (afs) {\n      try {\n        const listResult = await afs.list(\"$afs:/\");\n        if (listResult.data?.length) {\n          const runtimeMounts = listResult.data\n            .map((entry) => `  ${entry.path} (runtime mount)`)\n            .join(\"\\n\");\n\n          return {\n            topic: \"Mounts\",\n            explanation: `Runtime mounts (mounted via API):\\n\\n${runtimeMounts}`,\n            examples: listResult.data.slice(0, 3).map((entry) => `afs ls ${entry.path}`),\n          };\n        }\n      } catch (err) {\n        // Mount enumeration failed — debug log and show \"no mounts\" fallback\n        console.debug(\"[explain] mount enumeration failed:\", err);\n      }\n    }\n\n    return {\n      topic: \"Mounts\",\n      explanation: `No mounts configured.\n\nUse mount add to add a mount:\n  afs mount add <path> <uri>\n\npath: Virtual path for accessing data in AFS\nuri: Data source URI specifying the data origin`,\n      examples: [\n        \"afs mount add /src fs:///Users/me/project\",\n        \"afs mount add /data sqlite:///data.db\",\n      ],\n    };\n  }\n\n  const mountList = result.mounts\n    .map((m) => `  ${m.path}${m.description ? ` - ${m.description}` : \"\"}`)\n    .join(\"\\n\");\n\n  return {\n    topic: \"Mounts\",\n    explanation: `Current mount configuration:\n\n${mountList}\n\nAfter mounting, data is accessed via the mount path:\n  path=\"/src\" -> /src`,\n    examples: result.mounts.map((m) => `afs ls ${m.path}`),\n  };\n}\n\nfunction explainPaths(): ExplainResult {\n  return {\n    topic: \"Paths\",\n    explanation: `AFS Path Structure:\n\n/                     Root directory\n/{mount}              Mounted data source\n/{mount}/{path}       Files/nodes within a mount\n\nPath Mapping:\n  config: path=\"/src\"  ->  access: /src\n  config: path=\"/data\" ->  access: /data\n\nMounts are accessed directly at their configured path.`,\n  };\n}\n\nfunction explainUri(): ExplainResult {\n  return {\n    topic: \"URI\",\n    explanation: `AFS URI Schemes and Objects:\n\nfs://       Local Filesystem Provider\n  Format: fs:///absolute/path or fs://./relative/path\n  Operations: list, read, write, delete\n\ngit://      Git Repository Provider\n  Format: git:///local/repo or git://github.com/user/repo?branch=main\n  Operations: list, read, exec (diff, create-branch, commit, merge)\n\nsqlite://   SQLite Database Provider\n  Format: sqlite:///path/to/db.sqlite\n  Operations: list, read, exec (SQL queries)\n\njson://     JSON Data Provider\n  Format: json:///path/to/data.json\n  Operations: list, read, write\n\ntoml://     TOML Data Provider\n  Format: toml:///path/to/config.toml\n  Operations: list, read, write\n\nsandbox://  Sandboxed Script Execution Provider\n  Format: sandbox:///path/to/scripts\n  Operations: list, read, exec\n\ngithub://   GitHub Issues/PRs Provider\n  Format: github://owner/repo\n  Operations: list, read, exec (create-issue, close-issue, etc.)\n\nhttp://     HTTP Proxy Provider\n  Format: http://host:port/path\n  Operations: list, read\n\nmcp://      MCP Server Provider\n  Format: mcp:///path/to/server\n  Operations: list, read, exec\n\ns3://       AWS S3 Storage Provider\n  Format: s3://bucket-name\n  Operations: list, read, write, delete\n\ngcs://      Google Cloud Storage Provider\n  Format: gcs://bucket-name\n  Operations: list, read, write, delete\n\nec2://      AWS EC2 Instances Provider\n  Format: ec2://region\n  Operations: list, read, exec (run-instances)\n\ngce://      Google Compute Engine Provider\n  Format: gce://project/zone\n  Operations: list, read, exec\n\ndns://      Cloud DNS Provider\n  Format: dns://provider (route53, clouddns)\n  Operations: list, read`,\n    examples: [\n      \"afs mount add /src fs:///Users/me/project\",\n      \"afs mount add /repo git://github.com/user/repo\",\n      \"afs mount add /db sqlite:///data.sqlite\",\n      \"afs mount add /s3 s3://my-bucket\",\n    ],\n  };\n}\n"],"mappings":"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"}

package/dist/core/commands/explore.cjs

@@ -8,20 +8,55 @@ const require_version = require('../../version.cjs');
 function createExploreCommand(options) {
 	return {
 		command: "explore [path]",
-		describe: "Interactive TUI explorer",
-		builder: { path: {
-			type: "string",
-			default: "/",
-			description: "Starting path"
-		} },
+		describe: "Interactive explorer (TUI or web)",
+		builder: {
+			path: {
+				type: "string",
+				default: "/",
+				description: "Starting path"
+			},
+			web: {
+				type: "boolean",
+				default: false,
+				description: "Launch web-based explorer"
+			},
+			port: {
+				type: "number",
+				default: 0,
+				description: "Port for web explorer (0 = auto)"
+			}
+		},
 		handler: async (argv) => {
 			const afs = await require_types.resolveAFS(options);
-			const { createExplorerScreen } = await Promise.resolve().then(() => require("../../explorer/screen.cjs"));
-			await createExplorerScreen({
-				afs,
-				startPath: argv.path,
-				version: require_version.VERSION
-			});
+			if (argv.web) {
+				const { startExplorer } = await import("@aigne/afs-explorer");
+				const { resolve } = await import("node:path");
+				let webRoot;
+				try {
+					const { createRequire } = await import("node:module");
+					webRoot = resolve(createRequire(require("url").pathToFileURL(__filename).href).resolve("@aigne/afs-explorer/package.json"), "..", "web");
+				} catch {}
+				const info = await startExplorer(afs, {
+					port: argv.port,
+					host: "localhost",
+					webRoot,
+					open: true
+				});
+				console.log(`AFS Explorer running at ${info.url}`);
+				console.log("Press Ctrl+C to stop");
+				process.on("SIGINT", () => {
+					info.stop();
+					process.exit(0);
+				});
+				await new Promise(() => {});
+			} else {
+				const { createExplorerScreen } = await Promise.resolve().then(() => require("../../explorer/screen.cjs"));
+				await createExplorerScreen({
+					afs,
+					startPath: argv.path,
+					version: require_version.VERSION
+				});
+			}
 		}
 	};
 }

package/dist/core/commands/explore.mjs

@@ -8,20 +8,55 @@ import { VERSION } from "../../version.mjs";
 function createExploreCommand(options) {
 	return {
 		command: "explore [path]",
-		describe: "Interactive TUI explorer",
-		builder: { path: {
-			type: "string",
-			default: "/",
-			description: "Starting path"
-		} },
+		describe: "Interactive explorer (TUI or web)",
+		builder: {
+			path: {
+				type: "string",
+				default: "/",
+				description: "Starting path"
+			},
+			web: {
+				type: "boolean",
+				default: false,
+				description: "Launch web-based explorer"
+			},
+			port: {
+				type: "number",
+				default: 0,
+				description: "Port for web explorer (0 = auto)"
+			}
+		},
 		handler: async (argv) => {
 			const afs = await resolveAFS(options);
-			const { createExplorerScreen } = await import("../../explorer/screen.mjs");
-			await createExplorerScreen({
-				afs,
-				startPath: argv.path,
-				version: VERSION
-			});
+			if (argv.web) {
+				const { startExplorer } = await import("@aigne/afs-explorer");
+				const { resolve } = await import("node:path");
+				let webRoot;
+				try {
+					const { createRequire } = await import("node:module");
+					webRoot = resolve(createRequire(import.meta.url).resolve("@aigne/afs-explorer/package.json"), "..", "web");
+				} catch {}
+				const info = await startExplorer(afs, {
+					port: argv.port,
+					host: "localhost",
+					webRoot,
+					open: true
+				});
+				console.log(`AFS Explorer running at ${info.url}`);
+				console.log("Press Ctrl+C to stop");
+				process.on("SIGINT", () => {
+					info.stop();
+					process.exit(0);
+				});
+				await new Promise(() => {});
+			} else {
+				const { createExplorerScreen } = await import("../../explorer/screen.mjs");
+				await createExplorerScreen({
+					afs,
+					startPath: argv.path,
+					version: VERSION
+				});
+			}
 		}
 	};
 }

package/dist/core/commands/explore.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"explore.mjs","names":[],"sources":["../../../src/core/commands/explore.ts"],"sourcesContent":["/**\n * AFS Explore Command\n *\n * Interactive TUI explorer for AFS\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { VERSION } from \"../../version.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\nexport interface ExploreArgs {\n  path: string;\n}\n\n/**\n * Create explore command\n */\nexport function createExploreCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ExploreArgs> {\n  return {\n    command: \"explore [path]\",\n    describe: \"Interactive TUI explorer\",\n    builder: {\n      path: { type: \"string\", default: \"/\", description: \"Starting path\" },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const { createExplorerScreen } = await import(\"../../explorer/screen.js\");\n      await createExplorerScreen({ afs, startPath: argv.path, version: VERSION });\n    },\n  };\n}\n"],"mappings":";;;;;;;AAiBA,SAAgB,qBACd,SACqC;AACrC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,EACP,MAAM;GAAE,MAAM;GAAU,SAAS;GAAK,aAAa;GAAiB,EACrE;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,EAAE,yBAAyB,MAAM,OAAO;AAC9C,SAAM,qBAAqB;IAAE;IAAK,WAAW,KAAK;IAAM,SAAS;IAAS,CAAC;;EAE9E"}
+{"version":3,"file":"explore.mjs","names":[],"sources":["../../../src/core/commands/explore.ts"],"sourcesContent":["/**\n * AFS Explore Command\n *\n * Interactive TUI explorer or web-based explorer for AFS\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { VERSION } from \"../../version.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\nexport interface ExploreArgs {\n  path: string;\n  web: boolean;\n  port: number;\n}\n\n/**\n * Create explore command\n */\nexport function createExploreCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ExploreArgs> {\n  return {\n    command: \"explore [path]\",\n    describe: \"Interactive explorer (TUI or web)\",\n    builder: {\n      path: { type: \"string\", default: \"/\", description: \"Starting path\" },\n      web: { type: \"boolean\", default: false, description: \"Launch web-based explorer\" },\n      port: { type: \"number\", default: 0, description: \"Port for web explorer (0 = auto)\" },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n\n      if (argv.web) {\n        const { startExplorer } = await import(\"@aigne/afs-explorer\");\n        const { resolve } = await import(\"node:path\");\n\n        // Locate web assets: try node_modules first, then relative path\n        let webRoot: string | undefined;\n        try {\n          const { createRequire } = await import(\"node:module\");\n          const req = createRequire(import.meta.url);\n          const explorerPkg = req.resolve(\"@aigne/afs-explorer/package.json\");\n          webRoot = resolve(explorerPkg, \"..\", \"web\");\n        } catch {\n          // Fallback — not critical if embedded assets are used\n        }\n\n        const info = await startExplorer(afs, {\n          port: argv.port,\n          host: \"localhost\",\n          webRoot,\n          open: true,\n        });\n\n        console.log(`AFS Explorer running at ${info.url}`);\n        console.log(\"Press Ctrl+C to stop\");\n\n        // Keep process alive\n        process.on(\"SIGINT\", () => {\n          info.stop();\n          process.exit(0);\n        });\n        await new Promise(() => {});\n      } else {\n        const { createExplorerScreen } = await import(\"../../explorer/screen.js\");\n        await createExplorerScreen({ afs, startPath: argv.path, version: VERSION });\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;AAmBA,SAAgB,qBACd,SACqC;AACrC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS;GACP,MAAM;IAAE,MAAM;IAAU,SAAS;IAAK,aAAa;IAAiB;GACpE,KAAK;IAAE,MAAM;IAAW,SAAS;IAAO,aAAa;IAA6B;GAClF,MAAM;IAAE,MAAM;IAAU,SAAS;IAAG,aAAa;IAAoC;GACtF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;AAErC,OAAI,KAAK,KAAK;IACZ,MAAM,EAAE,kBAAkB,MAAM,OAAO;IACvC,MAAM,EAAE,YAAY,MAAM,OAAO;IAGjC,IAAI;AACJ,QAAI;KACF,MAAM,EAAE,kBAAkB,MAAM,OAAO;AAGvC,eAAU,QAFE,cAAc,OAAO,KAAK,IAAI,CAClB,QAAQ,mCAAmC,EACpC,MAAM,MAAM;YACrC;IAIR,MAAM,OAAO,MAAM,cAAc,KAAK;KACpC,MAAM,KAAK;KACX,MAAM;KACN;KACA,MAAM;KACP,CAAC;AAEF,YAAQ,IAAI,2BAA2B,KAAK,MAAM;AAClD,YAAQ,IAAI,uBAAuB;AAGnC,YAAQ,GAAG,gBAAgB;AACzB,UAAK,MAAM;AACX,aAAQ,KAAK,EAAE;MACf;AACF,UAAM,IAAI,cAAc,GAAG;UACtB;IACL,MAAM,EAAE,yBAAyB,MAAM,OAAO;AAC9C,UAAM,qBAAqB;KAAE;KAAK,WAAW,KAAK;KAAM,SAAS;KAAS,CAAC;;;EAGhF"}

package/dist/core/commands/gen-agent-md.cjs

@@ -0,0 +1,126 @@
+
+//#region src/core/commands/gen-agent-md.ts
+/**
+* Generate AGENT.md content from manifest and optional treeSchema.
+*
+* Exported for direct use in tests and other tools.
+*/
+function generateAgentMd(manifest, treeSchema) {
+	const lines = [];
+	lines.push("---");
+	lines.push(`name: ${manifest.name}`);
+	lines.push(`category: ${manifest.category}`);
+	lines.push(`uri: ${manifest.uriTemplate}`);
+	if (treeSchema) {
+		lines.push("operations:");
+		for (const op of treeSchema.operations) lines.push(`  - ${op}`);
+	}
+	if (manifest.tags?.length) {
+		lines.push("tags:");
+		for (const tag of manifest.tags) lines.push(`  - ${tag}`);
+	}
+	if (treeSchema?.auth) {
+		lines.push(`auth: ${treeSchema.auth.type}`);
+		if (treeSchema.auth.env?.length) {
+			lines.push("auth_env:");
+			for (const env of treeSchema.auth.env) lines.push(`  - ${env}`);
+		}
+	}
+	lines.push("---");
+	lines.push("");
+	lines.push(`# ${manifest.name}`);
+	lines.push("");
+	lines.push(manifest.description);
+	lines.push("");
+	if (treeSchema) {
+		lines.push("## Path Structure");
+		lines.push("");
+		for (const [path, node] of Object.entries(treeSchema.tree)) {
+			let line = `- \`${path}\` — ${node.kind}`;
+			if (node.actions?.length) line += ` (actions: ${node.actions.join(", ")})`;
+			if (node.destructive?.length) line += ` **[destructive: ${node.destructive.join(", ")}]**`;
+			lines.push(line);
+		}
+		lines.push("");
+	}
+	if (manifest.useCases?.length) {
+		lines.push("## Use Cases");
+		lines.push("");
+		for (const uc of manifest.useCases) lines.push(`- ${uc}`);
+		lines.push("");
+	}
+	if (treeSchema?.bestFor?.length) {
+		lines.push("## Best For");
+		lines.push("");
+		for (const item of treeSchema.bestFor) lines.push(`- ${item}`);
+		lines.push("");
+	}
+	if (treeSchema?.notFor?.length) {
+		lines.push("## Not Recommended For");
+		lines.push("");
+		for (const item of treeSchema.notFor) lines.push(`- ${item}`);
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+const formatGenAgentMd = (result) => {
+	if (typeof result === "string") return result;
+	return JSON.stringify(result, null, 2);
+};
+function createGenAgentMdCommand(options) {
+	return {
+		command: "gen-agent-md <provider>",
+		describe: "Generate .afs/AGENT.md for a provider package",
+		builder: { provider: {
+			type: "string",
+			description: "Provider package name (e.g., @aigne/afs-sqlite) or directory path",
+			demandOption: true
+		} },
+		handler: async (argv) => {
+			try {
+				const providerPath = argv.provider;
+				const mod = await import(providerPath);
+				let manifest;
+				let treeSchema;
+				for (const key of Object.keys(mod)) {
+					const val = mod[key];
+					if (typeof val !== "function") continue;
+					if (typeof val.manifest !== "function") continue;
+					const result = val.manifest();
+					const m = Array.isArray(result) ? result[0] : result;
+					if (m?.name) {
+						manifest = m;
+						if (typeof val.treeSchema === "function") treeSchema = val.treeSchema();
+						break;
+					}
+				}
+				if (!manifest) {
+					options.onResult({
+						command: "gen-agent-md",
+						result: null,
+						format: formatGenAgentMd,
+						error: { message: `No provider class with static manifest() found in ${providerPath}` }
+					});
+					return;
+				}
+				const content = generateAgentMd(manifest, treeSchema);
+				options.onResult({
+					command: "gen-agent-md",
+					result: content,
+					format: formatGenAgentMd
+				});
+			} catch (err) {
+				options.onResult({
+					command: "gen-agent-md",
+					result: null,
+					format: formatGenAgentMd,
+					error: { message: `Failed to generate AGENT.md: ${err}` }
+				});
+			}
+		}
+	};
+}
+
+//#endregion
+exports.createGenAgentMdCommand = createGenAgentMdCommand;
+exports.generateAgentMd = generateAgentMd;

package/dist/core/commands/gen-agent-md.d.mts

@@ -0,0 +1,2 @@
+import "./types.mjs";
+import { CommandModule } from "yargs";

package/dist/core/commands/gen-agent-md.mjs

@@ -0,0 +1,125 @@
+//#region src/core/commands/gen-agent-md.ts
+/**
+* Generate AGENT.md content from manifest and optional treeSchema.
+*
+* Exported for direct use in tests and other tools.
+*/
+function generateAgentMd(manifest, treeSchema) {
+	const lines = [];
+	lines.push("---");
+	lines.push(`name: ${manifest.name}`);
+	lines.push(`category: ${manifest.category}`);
+	lines.push(`uri: ${manifest.uriTemplate}`);
+	if (treeSchema) {
+		lines.push("operations:");
+		for (const op of treeSchema.operations) lines.push(`  - ${op}`);
+	}
+	if (manifest.tags?.length) {
+		lines.push("tags:");
+		for (const tag of manifest.tags) lines.push(`  - ${tag}`);
+	}
+	if (treeSchema?.auth) {
+		lines.push(`auth: ${treeSchema.auth.type}`);
+		if (treeSchema.auth.env?.length) {
+			lines.push("auth_env:");
+			for (const env of treeSchema.auth.env) lines.push(`  - ${env}`);
+		}
+	}
+	lines.push("---");
+	lines.push("");
+	lines.push(`# ${manifest.name}`);
+	lines.push("");
+	lines.push(manifest.description);
+	lines.push("");
+	if (treeSchema) {
+		lines.push("## Path Structure");
+		lines.push("");
+		for (const [path, node] of Object.entries(treeSchema.tree)) {
+			let line = `- \`${path}\` — ${node.kind}`;
+			if (node.actions?.length) line += ` (actions: ${node.actions.join(", ")})`;
+			if (node.destructive?.length) line += ` **[destructive: ${node.destructive.join(", ")}]**`;
+			lines.push(line);
+		}
+		lines.push("");
+	}
+	if (manifest.useCases?.length) {
+		lines.push("## Use Cases");
+		lines.push("");
+		for (const uc of manifest.useCases) lines.push(`- ${uc}`);
+		lines.push("");
+	}
+	if (treeSchema?.bestFor?.length) {
+		lines.push("## Best For");
+		lines.push("");
+		for (const item of treeSchema.bestFor) lines.push(`- ${item}`);
+		lines.push("");
+	}
+	if (treeSchema?.notFor?.length) {
+		lines.push("## Not Recommended For");
+		lines.push("");
+		for (const item of treeSchema.notFor) lines.push(`- ${item}`);
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+const formatGenAgentMd = (result) => {
+	if (typeof result === "string") return result;
+	return JSON.stringify(result, null, 2);
+};
+function createGenAgentMdCommand(options) {
+	return {
+		command: "gen-agent-md <provider>",
+		describe: "Generate .afs/AGENT.md for a provider package",
+		builder: { provider: {
+			type: "string",
+			description: "Provider package name (e.g., @aigne/afs-sqlite) or directory path",
+			demandOption: true
+		} },
+		handler: async (argv) => {
+			try {
+				const providerPath = argv.provider;
+				const mod = await import(providerPath);
+				let manifest;
+				let treeSchema;
+				for (const key of Object.keys(mod)) {
+					const val = mod[key];
+					if (typeof val !== "function") continue;
+					if (typeof val.manifest !== "function") continue;
+					const result = val.manifest();
+					const m = Array.isArray(result) ? result[0] : result;
+					if (m?.name) {
+						manifest = m;
+						if (typeof val.treeSchema === "function") treeSchema = val.treeSchema();
+						break;
+					}
+				}
+				if (!manifest) {
+					options.onResult({
+						command: "gen-agent-md",
+						result: null,
+						format: formatGenAgentMd,
+						error: { message: `No provider class with static manifest() found in ${providerPath}` }
+					});
+					return;
+				}
+				const content = generateAgentMd(manifest, treeSchema);
+				options.onResult({
+					command: "gen-agent-md",
+					result: content,
+					format: formatGenAgentMd
+				});
+			} catch (err) {
+				options.onResult({
+					command: "gen-agent-md",
+					result: null,
+					format: formatGenAgentMd,
+					error: { message: `Failed to generate AGENT.md: ${err}` }
+				});
+			}
+		}
+	};
+}
+
+//#endregion
+export { createGenAgentMdCommand, generateAgentMd };
+//# sourceMappingURL=gen-agent-md.mjs.map

package/dist/core/commands/gen-agent-md.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen-agent-md.mjs","names":[],"sources":["../../../src/core/commands/gen-agent-md.ts"],"sourcesContent":["/**\n * gen-agent-md Command\n *\n * Generates a .afs/AGENT.md file from a provider's manifest and treeSchema.\n * This is a developer tool for provider authors.\n */\n\nimport type { CommandModule } from \"yargs\";\nimport type { CommandFactoryOptions, FormatFunction } from \"./types.js\";\n\nexport interface GenAgentMdArgs {\n  provider: string;\n}\n\ninterface ManifestInput {\n  name: string;\n  description: string;\n  category: string;\n  uriTemplate: string;\n  tags?: string[];\n  useCases?: string[];\n}\n\ninterface TreeSchemaInput {\n  operations: string[];\n  tree: Record<\n    string,\n    { kind: string; operations?: string[]; actions?: string[]; destructive?: string[] }\n  >;\n  auth?: { type: string; env?: string[] };\n  bestFor?: string[];\n  notFor?: string[];\n}\n\n/**\n * Generate AGENT.md content from manifest and optional treeSchema.\n *\n * Exported for direct use in tests and other tools.\n */\nexport function generateAgentMd(manifest: ManifestInput, treeSchema?: TreeSchemaInput): string {\n  const lines: string[] = [];\n\n  // YAML frontmatter\n  lines.push(\"---\");\n  lines.push(`name: ${manifest.name}`);\n  lines.push(`category: ${manifest.category}`);\n  lines.push(`uri: ${manifest.uriTemplate}`);\n\n  if (treeSchema) {\n    lines.push(\"operations:\");\n    for (const op of treeSchema.operations) {\n      lines.push(`  - ${op}`);\n    }\n  }\n\n  if (manifest.tags?.length) {\n    lines.push(\"tags:\");\n    for (const tag of manifest.tags) {\n      lines.push(`  - ${tag}`);\n    }\n  }\n\n  if (treeSchema?.auth) {\n    lines.push(`auth: ${treeSchema.auth.type}`);\n    if (treeSchema.auth.env?.length) {\n      lines.push(\"auth_env:\");\n      for (const env of treeSchema.auth.env) {\n        lines.push(`  - ${env}`);\n      }\n    }\n  }\n\n  lines.push(\"---\");\n  lines.push(\"\");\n\n  // Markdown body\n  lines.push(`# ${manifest.name}`);\n  lines.push(\"\");\n  lines.push(manifest.description);\n  lines.push(\"\");\n\n  // Path structure from treeSchema\n  if (treeSchema) {\n    lines.push(\"## Path Structure\");\n    lines.push(\"\");\n    for (const [path, node] of Object.entries(treeSchema.tree)) {\n      let line = `- \\`${path}\\` — ${node.kind}`;\n      if (node.actions?.length) {\n        line += ` (actions: ${node.actions.join(\", \")})`;\n      }\n      if (node.destructive?.length) {\n        line += ` **[destructive: ${node.destructive.join(\", \")}]**`;\n      }\n      lines.push(line);\n    }\n    lines.push(\"\");\n  }\n\n  // Use cases\n  if (manifest.useCases?.length) {\n    lines.push(\"## Use Cases\");\n    lines.push(\"\");\n    for (const uc of manifest.useCases) {\n      lines.push(`- ${uc}`);\n    }\n    lines.push(\"\");\n  }\n\n  // Best for / Not for\n  if (treeSchema?.bestFor?.length) {\n    lines.push(\"## Best For\");\n    lines.push(\"\");\n    for (const item of treeSchema.bestFor) {\n      lines.push(`- ${item}`);\n    }\n    lines.push(\"\");\n  }\n\n  if (treeSchema?.notFor?.length) {\n    lines.push(\"## Not Recommended For\");\n    lines.push(\"\");\n    for (const item of treeSchema.notFor) {\n      lines.push(`- ${item}`);\n    }\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\");\n}\n\nconst formatGenAgentMd: FormatFunction = (result) => {\n  if (typeof result === \"string\") return result;\n  return JSON.stringify(result, null, 2);\n};\n\nexport function createGenAgentMdCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, GenAgentMdArgs> {\n  return {\n    command: \"gen-agent-md <provider>\",\n    describe: \"Generate .afs/AGENT.md for a provider package\",\n    builder: {\n      provider: {\n        type: \"string\",\n        description: \"Provider package name (e.g., @aigne/afs-sqlite) or directory path\",\n        demandOption: true,\n      },\n    },\n    handler: async (argv) => {\n      try {\n        const providerPath = argv.provider;\n\n        // Dynamic import the provider package\n        const mod = (await import(providerPath)) as Record<string, unknown>;\n\n        // Find the provider class with static manifest()\n        let manifest: ManifestInput | undefined;\n        let treeSchema: TreeSchemaInput | undefined;\n\n        for (const key of Object.keys(mod)) {\n          const val = mod[key];\n          if (typeof val !== \"function\") continue;\n          if (typeof (val as any).manifest !== \"function\") continue;\n\n          const result = (val as any).manifest();\n          const m = Array.isArray(result) ? result[0] : result;\n          if (m?.name) {\n            manifest = m;\n            if (typeof (val as any).treeSchema === \"function\") {\n              treeSchema = (val as any).treeSchema();\n            }\n            break;\n          }\n        }\n\n        if (!manifest) {\n          options.onResult({\n            command: \"gen-agent-md\",\n            result: null,\n            format: formatGenAgentMd,\n            error: { message: `No provider class with static manifest() found in ${providerPath}` },\n          });\n          return;\n        }\n\n        const content = generateAgentMd(manifest, treeSchema);\n\n        options.onResult({\n          command: \"gen-agent-md\",\n          result: content,\n          format: formatGenAgentMd,\n        });\n      } catch (err) {\n        options.onResult({\n          command: \"gen-agent-md\",\n          result: null,\n          format: formatGenAgentMd,\n          error: { message: `Failed to generate AGENT.md: ${err}` },\n        });\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/core/commands/index.cjs

@@ -1,15 +1,21 @@
+const require_connect = require('./connect.cjs');
+const require_daemon = require('./daemon.cjs');
 const require_types = require('./types.cjs');
 const require_delete = require('./delete.cjs');
 const require_exec_args = require('../helpers/exec-args.cjs');
 const require_exec = require('./exec.cjs');
 const require_explain = require('./explain.cjs');
 const require_explore = require('./explore.cjs');
+const require_gen_agent_md = require('./gen-agent-md.cjs');
+const require_install = require('./install.cjs');
 const require_ls = require('./ls.cjs');
+const require_mcp_bridge = require('./mcp-bridge.cjs');
 const require_mount = require('./mount.cjs');
 const require_read = require('./read.cjs');
 const require_search = require('./search.cjs');
 const require_serve = require('./serve.cjs');
 const require_stat = require('./stat.cjs');
+const require_vault = require('./vault.cjs');
 const require_write = require('./write.cjs');
 
 //#region src/core/commands/index.ts
@@ -29,7 +35,13 @@ const commandFactories = [
 	require_search.createSearchCommand,
 	require_mount.createMountCommand,
 	require_serve.createServeCommand,
-	require_explore.createExploreCommand
+	require_explore.createExploreCommand,
+	require_vault.createVaultCommand,
+	require_daemon.createServiceCommand,
+	require_connect.createConnectCommand,
+	require_mcp_bridge.createMcpBridgeCommand,
+	require_gen_agent_md.createGenAgentMdCommand,
+	require_install.createInstallCommand
 ];
 
 //#endregion

package/dist/core/commands/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/core/commands/index.ts"],"mappings":";;;;;;;;;;;;;;;;;cAmDa,gBAAA,EAAkB,cAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/core/commands/index.ts"],"mappings":";;;;;;;;;;;;;;;;;cAmEa,gBAAA,EAAkB,cAAA"}

package/dist/core/commands/index.d.mts

@@ -1,15 +1,21 @@
 import { CommandFactory, CommandFactoryOptions, CommandOutput, FormatFunction } from "./types.mjs";
+import "./connect.mjs";
+import "./daemon.mjs";
 import { DeleteArgs, createDeleteCommand } from "./delete.mjs";
 import { parseExecArgs, parseValueBySchema } from "../helpers/exec-args.mjs";
 import { ExecArgs, createExecCommand } from "./exec.mjs";
 import { ExplainArgs, createExplainCommand } from "./explain.mjs";
 import "./explore.mjs";
+import "./gen-agent-md.mjs";
+import "./install.mjs";
 import { LsArgs, createLsCommand } from "./ls.mjs";
+import "./mcp-bridge.mjs";
 import { MountAddArgs, MountListArgs, MountRemoveArgs, createMountCommand } from "./mount.mjs";
 import { ReadArgs, createReadCommand } from "./read.mjs";
 import "./search.mjs";
 import "./serve.mjs";
 import { StatArgs, createStatCommand } from "./stat.mjs";
+import "./vault.mjs";
 import { WriteArgs, createWriteCommand } from "./write.mjs";
 
 //#region src/core/commands/index.d.ts

package/dist/core/commands/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/commands/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;cAmDa,gBAAA,EAAkB,cAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/commands/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;cAmEa,gBAAA,EAAkB,cAAA"}

package/dist/core/commands/index.mjs

@@ -1,15 +1,21 @@
+import { createConnectCommand } from "./connect.mjs";
+import { createServiceCommand } from "./daemon.mjs";
 import { resolveAFS } from "./types.mjs";
 import { createDeleteCommand } from "./delete.mjs";
 import { parseExecArgs, parseValueBySchema } from "../helpers/exec-args.mjs";
 import { createExecCommand } from "./exec.mjs";
 import { createExplainCommand } from "./explain.mjs";
 import { createExploreCommand } from "./explore.mjs";
+import { createGenAgentMdCommand, generateAgentMd } from "./gen-agent-md.mjs";
+import { createInstallCommand } from "./install.mjs";
 import { createLsCommand } from "./ls.mjs";
+import { createMcpBridgeCommand } from "./mcp-bridge.mjs";
 import { createMountCommand } from "./mount.mjs";
 import { createReadCommand } from "./read.mjs";
 import { createSearchCommand } from "./search.mjs";
 import { createServeCommand } from "./serve.mjs";
 import { createStatCommand } from "./stat.mjs";
+import { createVaultCommand } from "./vault.mjs";
 import { createWriteCommand } from "./write.mjs";
 
 //#region src/core/commands/index.ts
@@ -29,7 +35,13 @@ const commandFactories = [
 	createSearchCommand,
 	createMountCommand,
 	createServeCommand,
-	createExploreCommand
+	createExploreCommand,
+	createVaultCommand,
+	createServiceCommand,
+	createConnectCommand,
+	createMcpBridgeCommand,
+	createGenAgentMdCommand,
+	createInstallCommand
 ];
 
 //#endregion

package/dist/core/commands/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/core/commands/index.ts"],"sourcesContent":["/**\n * CLI Core Commands\n *\n * Re-exports all command implementations and factories.\n */\n\n// Command factories and types\nexport { createDeleteCommand, type DeleteArgs } from \"./delete.js\";\nexport { createExecCommand, type ExecArgs, parseExecArgs, parseValueBySchema } from \"./exec.js\";\nexport { createExplainCommand, type ExplainArgs } from \"./explain.js\";\nexport { createExploreCommand, type ExploreArgs } from \"./explore.js\";\nexport { createLsCommand, type LsArgs } from \"./ls.js\";\nexport {\n  createMountCommand,\n  type MountAddArgs,\n  type MountListArgs,\n  type MountRemoveArgs,\n} from \"./mount.js\";\nexport { createReadCommand, type ReadArgs } from \"./read.js\";\nexport { createSearchCommand, type SearchArgs } from \"./search.js\";\nexport { createServeCommand, type ServeArgs, type ServeResult } from \"./serve.js\";\nexport { createStatCommand, type StatArgs } from \"./stat.js\";\n// Types and helpers\nexport type {\n  CommandFactory,\n  CommandFactoryOptions,\n  CommandOutput,\n  FormatFunction,\n} from \"./types.js\";\nexport { resolveAFS } from \"./types.js\";\nexport { createWriteCommand, type WriteArgs } from \"./write.js\";\n\n// Import factories for array export\nimport { createDeleteCommand } from \"./delete.js\";\nimport { createExecCommand } from \"./exec.js\";\nimport { createExplainCommand } from \"./explain.js\";\nimport { createExploreCommand } from \"./explore.js\";\nimport { createLsCommand } from \"./ls.js\";\nimport { createMountCommand } from \"./mount.js\";\nimport { createReadCommand } from \"./read.js\";\nimport { createSearchCommand } from \"./search.js\";\nimport { createServeCommand } from \"./serve.js\";\nimport { createStatCommand } from \"./stat.js\";\nimport type { CommandFactory } from \"./types.js\";\nimport { createWriteCommand } from \"./write.js\";\n\n/**\n * Array of all command factories\n *\n * Used by AFSCommandExecutor to register all commands.\n */\nexport const commandFactories: CommandFactory[] = [\n  createLsCommand,\n  createReadCommand,\n  createWriteCommand,\n  createDeleteCommand,\n  createStatCommand,\n  createExecCommand,\n  createExplainCommand,\n  createSearchCommand,\n  createMountCommand,\n  createServeCommand,\n  createExploreCommand,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,mBAAqC;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/core/commands/index.ts"],"sourcesContent":["/**\n * CLI Core Commands\n *\n * Re-exports all command implementations and factories.\n */\n\nexport { type ConnectArgs, createConnectCommand } from \"./connect.js\";\nexport { createServiceCommand, type ServiceArgs } from \"./daemon.js\";\n// Command factories and types\nexport { createDeleteCommand, type DeleteArgs } from \"./delete.js\";\nexport { createExecCommand, type ExecArgs, parseExecArgs, parseValueBySchema } from \"./exec.js\";\nexport { createExplainCommand, type ExplainArgs } from \"./explain.js\";\nexport { createExploreCommand, type ExploreArgs } from \"./explore.js\";\nexport { createGenAgentMdCommand, type GenAgentMdArgs, generateAgentMd } from \"./gen-agent-md.js\";\nexport {\n  createInstallCommand,\n  type InstallAddArgs,\n  type InstallRemoveArgs,\n} from \"./install.js\";\nexport { createLsCommand, type LsArgs } from \"./ls.js\";\nexport { createMcpBridgeCommand, type McpBridgeArgs } from \"./mcp-bridge.js\";\nexport {\n  createMountCommand,\n  type MountAddArgs,\n  type MountListArgs,\n  type MountRemoveArgs,\n} from \"./mount.js\";\nexport { createReadCommand, type ReadArgs } from \"./read.js\";\nexport { createSearchCommand, type SearchArgs } from \"./search.js\";\nexport { createServeCommand, type ServeArgs, type ServeResult } from \"./serve.js\";\nexport { createStatCommand, type StatArgs } from \"./stat.js\";\n// Types and helpers\nexport type {\n  CommandFactory,\n  CommandFactoryOptions,\n  CommandOutput,\n  FormatFunction,\n} from \"./types.js\";\nexport { resolveAFS } from \"./types.js\";\nexport { createVaultCommand } from \"./vault.js\";\nexport { createWriteCommand, type WriteArgs } from \"./write.js\";\n\n// Import factories for array export\nimport { createConnectCommand } from \"./connect.js\";\nimport { createServiceCommand } from \"./daemon.js\";\nimport { createDeleteCommand } from \"./delete.js\";\nimport { createExecCommand } from \"./exec.js\";\nimport { createExplainCommand } from \"./explain.js\";\nimport { createExploreCommand } from \"./explore.js\";\nimport { createGenAgentMdCommand } from \"./gen-agent-md.js\";\nimport { createInstallCommand } from \"./install.js\";\nimport { createLsCommand } from \"./ls.js\";\nimport { createMcpBridgeCommand } from \"./mcp-bridge.js\";\nimport { createMountCommand } from \"./mount.js\";\nimport { createReadCommand } from \"./read.js\";\nimport { createSearchCommand } from \"./search.js\";\nimport { createServeCommand } from \"./serve.js\";\nimport { createStatCommand } from \"./stat.js\";\nimport type { CommandFactory } from \"./types.js\";\nimport { createVaultCommand } from \"./vault.js\";\nimport { createWriteCommand } from \"./write.js\";\n\n/**\n * Array of all command factories\n *\n * Used by AFSCommandExecutor to register all commands.\n */\nexport const commandFactories: CommandFactory[] = [\n  createLsCommand,\n  createReadCommand,\n  createWriteCommand,\n  createDeleteCommand,\n  createStatCommand,\n  createExecCommand,\n  createExplainCommand,\n  createSearchCommand,\n  createMountCommand,\n  createServeCommand,\n  createExploreCommand,\n  createVaultCommand,\n  createServiceCommand,\n  createConnectCommand,\n  createMcpBridgeCommand,\n  createGenAgentMdCommand,\n  createInstallCommand,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAmEA,MAAa,mBAAqC;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}