shirokuma-docs 0.1.0-alpha.1

package/dist/utils/repo-pairs.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Repo Pairs Utility
+ *
+ * Central utility for public/private repository pair management.
+ * Used by repo-pairs command, --public flag, and session management.
+ */
+import { type RepoPairConfig, type GhConfig } from "./gh-config.js";
+/** Default files/directories to exclude from public release */
+export declare const DEFAULT_EXCLUDE_PATTERNS: string[];
+/**
+ * Parse "owner/name" into { owner, name }
+ */
+export declare function parseRepoFullName(fullName: string): {
+    owner: string;
+    name: string;
+} | null;
+/**
+ * Get all configured repo pairs
+ */
+export declare function getAllRepoPairs(config?: GhConfig): RepoPairConfig[];
+/**
+ * Get a specific repo pair by alias
+ */
+export declare function getRepoPair(alias: string, config?: GhConfig): RepoPairConfig | null;
+/**
+ * Detect which repo pair matches the current repository.
+ * Checks if current repo matches either the private or public side.
+ */
+export declare function detectCurrentRepoPair(config?: GhConfig): RepoPairConfig | null;
+/**
+ * Resolve target repository for --public flag.
+ *
+ * When --public is passed, finds the matching repo pair for the current repo
+ * and returns the public counterpart.
+ *
+ * @returns { owner, name } of the target repo, or null if not found
+ */
+export declare function resolveTargetRepo(options: {
+    public?: boolean;
+    repo?: string;
+}, config?: GhConfig): {
+    owner: string;
+    name: string;
+} | null;
+/**
+ * Resolve a cross-repo alias to { owner, name }
+ */
+export declare function resolveCrossRepo(alias: string, config?: GhConfig): {
+    owner: string;
+    name: string;
+} | null;
+/**
+ * Get all configured cross-repo aliases
+ */
+export declare function getAllCrossRepos(config?: GhConfig): Array<{
+    alias: string;
+    repo: string;
+}>;
+/**
+ * Validate a cross-repo alias and return detailed error info if invalid.
+ *
+ * Checks:
+ * 1. Is it a known alias?
+ * 2. Is it a full path (owner/repo) instead of an alias?
+ * 3. Are there any configured aliases at all?
+ *
+ * @returns null if valid, error message string if invalid
+ */
+export declare function validateCrossRepoAlias(alias: string, config?: GhConfig): string | null;
+/**
+ * Check if a repo full name matches the private side of any pair
+ */
+export declare function isPrivateRepo(repoFullName: string, config?: GhConfig): boolean;
+/**
+ * Check if a repo full name matches the public side of any pair
+ */
+export declare function isPublicRepo(repoFullName: string, config?: GhConfig): boolean;
+/**
+ * Get merged exclude patterns for a repo pair release.
+ *
+ * Combines patterns from three sources (in order):
+ * 1. DEFAULT_EXCLUDE_PATTERNS (built-in base patterns)
+ * 2. Config patterns (repoPairs[alias].exclude in config YAML)
+ * 3. .shirokumaignore file patterns (project root)
+ *
+ * Patterns are deduplicated while preserving order.
+ *
+ * @param alias - Repo pair alias
+ * @param projectPath - Absolute path to the project root
+ * @param config - Optional pre-loaded config
+ * @returns Deduplicated array of all exclude patterns
+ */
+export declare function getMergedExcludePatterns(alias: string, projectPath: string, config?: GhConfig): string[];
+//# sourceMappingURL=repo-pairs.d.ts.map

package/dist/utils/repo-pairs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-pairs.d.ts","sourceRoot":"","sources":["../../src/utils/repo-pairs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAgB,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAOlF,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,UAKpC,CAAC;AAMF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAM1F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,cAAc,EAAE,CAWnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,IAAI,CAGnF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,IAAI,CAU9E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5C,MAAM,CAAC,EAAE,QAAQ,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBxC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQzG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAK1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CA8BtF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAG9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAG7E;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,QAAQ,GAChB,MAAM,EAAE,CAmBV"}

package/dist/utils/repo-pairs.js

@@ -0,0 +1,196 @@
+/**
+ * Repo Pairs Utility
+ *
+ * Central utility for public/private repository pair management.
+ * Used by repo-pairs command, --public flag, and session management.
+ */
+import { getRepoInfo } from "./github.js";
+import { loadGhConfig } from "./gh-config.js";
+import { loadShirokumaIgnoreFile, mergeExcludePatterns } from "./shirokumaignore.js";
+// ========================================
+// Default Patterns
+// ========================================
+/** Default files/directories to exclude from public release */
+export const DEFAULT_EXCLUDE_PATTERNS = [
+    ".claude/",
+    ".github/DISCUSSION_TEMPLATE/",
+    "docs/internal/",
+    ".shirokumaignore",
+];
+// ========================================
+// Repo Pair Resolution
+// ========================================
+/**
+ * Parse "owner/name" into { owner, name }
+ */
+export function parseRepoFullName(fullName) {
+    const parts = fullName.split("/");
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        return null;
+    }
+    return { owner: parts[0], name: parts[1] };
+}
+/**
+ * Get all configured repo pairs
+ */
+export function getAllRepoPairs(config) {
+    const cfg = config ?? loadGhConfig();
+    if (!cfg.repoPairs)
+        return [];
+    return Object.entries(cfg.repoPairs).map(([alias, pair]) => ({
+        alias,
+        private: pair.private,
+        public: pair.public,
+        exclude: pair.exclude ?? DEFAULT_EXCLUDE_PATTERNS,
+        defaultBranch: pair.defaultBranch ?? "main",
+    }));
+}
+/**
+ * Get a specific repo pair by alias
+ */
+export function getRepoPair(alias, config) {
+    const pairs = getAllRepoPairs(config);
+    return pairs.find(p => p.alias === alias) ?? null;
+}
+/**
+ * Detect which repo pair matches the current repository.
+ * Checks if current repo matches either the private or public side.
+ */
+export function detectCurrentRepoPair(config) {
+    const repoInfo = getRepoInfo();
+    if (!repoInfo)
+        return null;
+    const currentFullName = `${repoInfo.owner}/${repoInfo.name}`;
+    const pairs = getAllRepoPairs(config);
+    return pairs.find(p => p.private === currentFullName || p.public === currentFullName) ?? null;
+}
+/**
+ * Resolve target repository for --public flag.
+ *
+ * When --public is passed, finds the matching repo pair for the current repo
+ * and returns the public counterpart.
+ *
+ * @returns { owner, name } of the target repo, or null if not found
+ */
+export function resolveTargetRepo(options, config) {
+    const cfg = config ?? loadGhConfig();
+    // If --repo alias is specified (cross-repo), resolve from crossRepos
+    if (options.repo) {
+        return resolveCrossRepo(options.repo, cfg);
+    }
+    // If --public is not set, return current repo
+    if (!options.public) {
+        return getRepoInfo();
+    }
+    // Find the repo pair for current repo
+    const pair = detectCurrentRepoPair(cfg);
+    if (!pair)
+        return null;
+    return parseRepoFullName(pair.public);
+}
+/**
+ * Resolve a cross-repo alias to { owner, name }
+ */
+export function resolveCrossRepo(alias, config) {
+    const cfg = config ?? loadGhConfig();
+    if (!cfg.crossRepos)
+        return null;
+    const fullName = cfg.crossRepos[alias];
+    if (!fullName)
+        return null;
+    return parseRepoFullName(fullName);
+}
+/**
+ * Get all configured cross-repo aliases
+ */
+export function getAllCrossRepos(config) {
+    const cfg = config ?? loadGhConfig();
+    if (!cfg.crossRepos)
+        return [];
+    return Object.entries(cfg.crossRepos).map(([alias, repo]) => ({ alias, repo }));
+}
+/**
+ * Validate a cross-repo alias and return detailed error info if invalid.
+ *
+ * Checks:
+ * 1. Is it a known alias?
+ * 2. Is it a full path (owner/repo) instead of an alias?
+ * 3. Are there any configured aliases at all?
+ *
+ * @returns null if valid, error message string if invalid
+ */
+export function validateCrossRepoAlias(alias, config) {
+    const cfg = config ?? loadGhConfig();
+    const crossRepos = cfg.crossRepos;
+    // No crossRepos configured at all
+    if (!crossRepos || Object.keys(crossRepos).length === 0) {
+        return `No cross-repo aliases configured.\nAdd crossRepos to shirokuma-docs.config.yaml:\n  crossRepos:\n    myalias: "owner/repo"`;
+    }
+    // Check if alias exists
+    if (crossRepos[alias]) {
+        return null; // Valid
+    }
+    const availableAliases = Object.entries(crossRepos)
+        .map(([a, repo]) => `  ${a} (${repo})`)
+        .join("\n");
+    // Check if input looks like a full path (owner/repo)
+    if (alias.includes("/")) {
+        // Check if this full path matches any configured repo
+        const matchingAlias = Object.entries(crossRepos).find(([, repo]) => repo === alias);
+        if (matchingAlias) {
+            return `Use the alias '${matchingAlias[0]}' instead of '${alias}'.\nAvailable aliases:\n${availableAliases}`;
+        }
+        return `Unknown repo '${alias}'.\nUse a configured alias instead of owner/repo.\nAvailable aliases:\n${availableAliases}\nSee crossRepos in shirokuma-docs.config.yaml`;
+    }
+    // Unknown alias
+    return `Unknown repo alias '${alias}'.\nAvailable aliases:\n${availableAliases}\nSee crossRepos in shirokuma-docs.config.yaml`;
+}
+/**
+ * Check if a repo full name matches the private side of any pair
+ */
+export function isPrivateRepo(repoFullName, config) {
+    const pairs = getAllRepoPairs(config);
+    return pairs.some(p => p.private === repoFullName);
+}
+/**
+ * Check if a repo full name matches the public side of any pair
+ */
+export function isPublicRepo(repoFullName, config) {
+    const pairs = getAllRepoPairs(config);
+    return pairs.some(p => p.public === repoFullName);
+}
+// ========================================
+// Merged Exclude Patterns
+// ========================================
+/**
+ * Get merged exclude patterns for a repo pair release.
+ *
+ * Combines patterns from three sources (in order):
+ * 1. DEFAULT_EXCLUDE_PATTERNS (built-in base patterns)
+ * 2. Config patterns (repoPairs[alias].exclude in config YAML)
+ * 3. .shirokumaignore file patterns (project root)
+ *
+ * Patterns are deduplicated while preserving order.
+ *
+ * @param alias - Repo pair alias
+ * @param projectPath - Absolute path to the project root
+ * @param config - Optional pre-loaded config
+ * @returns Deduplicated array of all exclude patterns
+ */
+export function getMergedExcludePatterns(alias, projectPath, config) {
+    const cfg = config ?? loadGhConfig();
+    // Access raw config to check if exclude was explicitly set.
+    // Note: getRepoPair() → getAllRepoPairs() applies fallback
+    // (pair.exclude ?? DEFAULT_EXCLUDE_PATTERNS), so pair.exclude
+    // is never undefined there. We need the raw config value.
+    const rawExclude = cfg.repoPairs?.[alias]?.exclude;
+    // .shirokumaignore file patterns
+    const filePatterns = loadShirokumaIgnoreFile(projectPath);
+    // If no explicit exclude config, use only defaults + file patterns
+    if (rawExclude === undefined) {
+        return mergeExcludePatterns(DEFAULT_EXCLUDE_PATTERNS, [], filePatterns);
+    }
+    // Explicit config: merge defaults + config + file patterns
+    return mergeExcludePatterns(DEFAULT_EXCLUDE_PATTERNS, rawExclude, filePatterns);
+}
+//# sourceMappingURL=repo-pairs.js.map

package/dist/utils/repo-pairs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-pairs.js","sourceRoot":"","sources":["../../src/utils/repo-pairs.ts"],"names":[],"mappings":"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"}

package/dist/utils/route-inference.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Route Inference Utility
+ *
+ * Utilities for inferring URL routes from Next.js App Router file paths
+ * and applying route parameter substitution.
+ *
+ * @module utils/route-inference
+ */
+/**
+ * Infer URL route from Next.js App Router file path.
+ *
+ * Extracts the route from a page.tsx file path by:
+ * 1. Finding the 'app' directory
+ * 2. Removing layout groups (parenthesized segments)
+ * 3. Removing the page.tsx filename
+ *
+ * @param filePath - Relative file path (e.g., "apps/web/app/[locale]/(dashboard)/page.tsx")
+ * @returns Inferred route (e.g., "/[locale]") or null if not a page file
+ *
+ * @example
+ * ```typescript
+ * inferRouteFromPath("apps/web/app/[locale]/(dashboard)/[orgSlug]/page.tsx")
+ * // Returns: "/[locale]/[orgSlug]"
+ * ```
+ */
+export declare function inferRouteFromPath(filePath: string): string | null;
+/**
+ * Apply route parameter substitution.
+ *
+ * Replaces dynamic route segments like [locale] with actual values
+ * from the routeParams configuration.
+ *
+ * @param route - Route with dynamic segments (e.g., "/[locale]/[orgSlug]")
+ * @param routeParams - Parameter mapping (e.g., { "[locale]": "ja", "[orgSlug]": "demo-org" })
+ * @returns Route with substituted values (e.g., "/ja/demo-org")
+ *
+ * @example
+ * ```typescript
+ * applyRouteParams("/[locale]/[orgSlug]", { "[locale]": "ja", "[orgSlug]": "test" })
+ * // Returns: "/ja/test"
+ * ```
+ */
+export declare function applyRouteParams(route: string, routeParams: Record<string, string>): string;
+/**
+ * Normalize route string.
+ *
+ * Ensures consistent route format:
+ * - Adds leading slash if missing
+ * - Removes trailing slash (except for root "/")
+ * - Collapses multiple consecutive slashes
+ *
+ * @param route - Route string to normalize
+ * @returns Normalized route string
+ *
+ * @example
+ * ```typescript
+ * normalizeRoute("ja/dashboard/")  // Returns: "/ja/dashboard"
+ * normalizeRoute("/ja//dashboard") // Returns: "/ja/dashboard"
+ * normalizeRoute("/")              // Returns: "/"
+ * ```
+ */
+export declare function normalizeRoute(route: string): string;
+/**
+ * Infer screen name from file path.
+ *
+ * Generates a screen name from the file path by:
+ * 1. Extracting the last meaningful segment before page.tsx
+ * 2. Converting to PascalCase
+ * 3. Appending "Screen" suffix
+ *
+ * @param filePath - File path to generate screen name from
+ * @returns Inferred screen name (e.g., "DashboardScreen")
+ *
+ * @example
+ * ```typescript
+ * inferScreenNameFromPath("apps/web/app/[locale]/dashboard/page.tsx")
+ * // Returns: "DashboardScreen"
+ * ```
+ */
+export declare function inferScreenNameFromPath(filePath: string): string;
+//# sourceMappingURL=route-inference.d.ts.map

package/dist/utils/route-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-inference.d.ts","sourceRoot":"","sources":["../../src/utils/route-inference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8BlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAapD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqBhE"}

package/dist/utils/route-inference.js

@@ -0,0 +1,137 @@
+/**
+ * Route Inference Utility
+ *
+ * Utilities for inferring URL routes from Next.js App Router file paths
+ * and applying route parameter substitution.
+ *
+ * @module utils/route-inference
+ */
+/**
+ * Infer URL route from Next.js App Router file path.
+ *
+ * Extracts the route from a page.tsx file path by:
+ * 1. Finding the 'app' directory
+ * 2. Removing layout groups (parenthesized segments)
+ * 3. Removing the page.tsx filename
+ *
+ * @param filePath - Relative file path (e.g., "apps/web/app/[locale]/(dashboard)/page.tsx")
+ * @returns Inferred route (e.g., "/[locale]") or null if not a page file
+ *
+ * @example
+ * ```typescript
+ * inferRouteFromPath("apps/web/app/[locale]/(dashboard)/[orgSlug]/page.tsx")
+ * // Returns: "/[locale]/[orgSlug]"
+ * ```
+ */
+export function inferRouteFromPath(filePath) {
+    // Only process page.tsx files
+    if (!filePath.endsWith("page.tsx") && !filePath.endsWith("page.ts")) {
+        return null;
+    }
+    // Find the 'app' directory in the path
+    const appIndex = filePath.indexOf("/app/");
+    if (appIndex === -1) {
+        return null;
+    }
+    // Extract the route part (after 'app/')
+    const routePart = filePath.substring(appIndex + 5); // +5 for '/app/'
+    // Remove page.tsx filename (handles both /page.tsx and page.tsx at root)
+    const withoutFilename = routePart.replace(/\/?page\.(tsx|ts)$/, "");
+    // Split into segments
+    const segments = withoutFilename.split("/").filter((s) => s.length > 0);
+    // Filter out layout groups (segments in parentheses)
+    const filteredSegments = segments.filter((segment) => !segment.startsWith("("));
+    // Build the route
+    if (filteredSegments.length === 0) {
+        return "/";
+    }
+    return "/" + filteredSegments.join("/");
+}
+/**
+ * Apply route parameter substitution.
+ *
+ * Replaces dynamic route segments like [locale] with actual values
+ * from the routeParams configuration.
+ *
+ * @param route - Route with dynamic segments (e.g., "/[locale]/[orgSlug]")
+ * @param routeParams - Parameter mapping (e.g., { "[locale]": "ja", "[orgSlug]": "demo-org" })
+ * @returns Route with substituted values (e.g., "/ja/demo-org")
+ *
+ * @example
+ * ```typescript
+ * applyRouteParams("/[locale]/[orgSlug]", { "[locale]": "ja", "[orgSlug]": "test" })
+ * // Returns: "/ja/test"
+ * ```
+ */
+export function applyRouteParams(route, routeParams) {
+    let result = route;
+    for (const [param, value] of Object.entries(routeParams)) {
+        result = result.replaceAll(param, value);
+    }
+    return result;
+}
+/**
+ * Normalize route string.
+ *
+ * Ensures consistent route format:
+ * - Adds leading slash if missing
+ * - Removes trailing slash (except for root "/")
+ * - Collapses multiple consecutive slashes
+ *
+ * @param route - Route string to normalize
+ * @returns Normalized route string
+ *
+ * @example
+ * ```typescript
+ * normalizeRoute("ja/dashboard/")  // Returns: "/ja/dashboard"
+ * normalizeRoute("/ja//dashboard") // Returns: "/ja/dashboard"
+ * normalizeRoute("/")              // Returns: "/"
+ * ```
+ */
+export function normalizeRoute(route) {
+    // Add leading slash if missing
+    let normalized = route.startsWith("/") ? route : "/" + route;
+    // Collapse multiple slashes
+    normalized = normalized.replace(/\/+/g, "/");
+    // Remove trailing slash (except for root)
+    if (normalized.length > 1 && normalized.endsWith("/")) {
+        normalized = normalized.slice(0, -1);
+    }
+    return normalized;
+}
+/**
+ * Infer screen name from file path.
+ *
+ * Generates a screen name from the file path by:
+ * 1. Extracting the last meaningful segment before page.tsx
+ * 2. Converting to PascalCase
+ * 3. Appending "Screen" suffix
+ *
+ * @param filePath - File path to generate screen name from
+ * @returns Inferred screen name (e.g., "DashboardScreen")
+ *
+ * @example
+ * ```typescript
+ * inferScreenNameFromPath("apps/web/app/[locale]/dashboard/page.tsx")
+ * // Returns: "DashboardScreen"
+ * ```
+ */
+export function inferScreenNameFromPath(filePath) {
+    // Extract route first
+    const route = inferRouteFromPath(filePath);
+    if (!route || route === "/") {
+        return "HomeScreen";
+    }
+    // Get the last segment
+    const segments = route.split("/").filter((s) => s.length > 0);
+    const lastSegment = segments[segments.length - 1];
+    // Remove brackets from dynamic segments
+    const cleanSegment = lastSegment.replace(/^\[|\]$/g, "");
+    // Convert to PascalCase
+    const pascalCase = cleanSegment
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join("");
+    return pascalCase + "Screen";
+}
+//# sourceMappingURL=route-inference.js.map

package/dist/utils/route-inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-inference.js","sourceRoot":"","sources":["../../src/utils/route-inference.ts"],"names":[],"mappings":"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"}

package/dist/utils/setup-check.d.ts

@@ -0,0 +1,34 @@
+/**
+ * GitHub setup validation utility (#345)
+ *
+ * Checks whether manual GitHub configuration steps have been completed:
+ * - Discussion categories (Handovers, ADR, Knowledge, Research)
+ * - Project workflow automations (Item closed → Done, PR merged → Done)
+ * - Metrics text fields (if metrics enabled)
+ */
+import type { Logger } from "./logger.js";
+export interface SetupCheckItem {
+    category: "discussions" | "workflows" | "metrics";
+    name: string;
+    ok: boolean;
+    hint?: string;
+    url?: string;
+}
+export interface SetupCheckResult {
+    repository: string;
+    items: SetupCheckItem[];
+    summary: {
+        total: number;
+        ok: number;
+        missing: number;
+    };
+}
+/**
+ * Validate GitHub setup and return results
+ */
+export declare function validateGitHubSetup(logger: Logger): SetupCheckResult | null;
+/**
+ * Print setup check results to logger (human-friendly format)
+ */
+export declare function printSetupCheckResults(result: SetupCheckResult, logger: Logger): void;
+//# sourceMappingURL=setup-check.d.ts.map

package/dist/utils/setup-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-check.d.ts","sourceRoot":"","sources":["../../src/utils/setup-check.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AA6GD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA2B3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,GACb,IAAI,CAUN"}