Function getFeatureHub

src/tools/feature-hub.ts:37–134

(options: FeatureHubOptions)

}

export async function getFeatureHub(options: FeatureHubOptions): Promise<string> {
  const { rootDir, showOrphans } = options;
  const out: string[] = [];

  if (!options.hubPath && !options.featureName && !showOrphans) {
    const hubs = await discoverHubs(rootDir);
    if (hubs.length === 0) {
      return "No hub files found. Create a .md file with [[path/to/file]] links to establish a feature hub.";
    }
    out.push(`Feature Hubs (${hubs.length}):`);
    out.push("");
    for (const h of hubs) {
      const info = await parseHubFile(resolve(rootDir, h));
      out.push(`  ${h} | ${info.title} | ${info.links.length} links`);
    }
    return out.join("\n");
  }

  if (showOrphans) {
    const entries = await walkDirectory({ rootDir, depthLimit: 10 });
    const filePaths = entries.filter((e) => !e.isDirectory).map((e) => e.relativePath);
    const orphans = await findOrphanedFiles(rootDir, filePaths);
    if (orphans.length === 0) return "No orphaned files. All source files are linked to a hub.";

    out.push(`Orphaned Files (${orphans.length}):`);
    out.push("These files are not linked to any feature hub:");
    out.push("");
    for (const o of orphans) out.push(`  ⚠ ${o}`);
    out.push("");
    out.push("Fix: Add [[" + orphans[0] + "]] to the appropriate hub .md file.");
    return out.join("\n");
  }

  let hubRelPath = options.hubPath;
  if (!hubRelPath && options.featureName) {
    hubRelPath = (await findHubByName(rootDir, options.featureName)) ?? undefined;
    if (!hubRelPath) {
      return `No hub found for feature "${options.featureName}". Available hubs:\n` +
        (await discoverHubs(rootDir)).map((h) => `  - ${h}`).join("\n") || "  (none)";
    }
  }

  if (!hubRelPath) return "Provide hub_path, feature_name, or set show_orphans=true.";

  const hubFull = resolve(rootDir, hubRelPath);
  if (!(await fileExists(hubFull))) {
    return `Hub file not found: ${hubRelPath}`;
  }

  const hub = await parseHubFile(hubFull);

  out.push(`Hub: ${hub.title}`);
  out.push(`Path: ${hubRelPath}`);
  out.push(`Links: ${hub.links.length}`);
  if (hub.crossLinks.length > 0) {
    out.push(`Cross-links: ${hub.crossLinks.map((c) => c.hubName).join(", ")}`);
  }
  out.push("");