shirokuma-docs 0.1.0-alpha.1

package/dist/utils/file.js

@@ -0,0 +1,103 @@
+/**
+ * ファイル操作ユーティリティ
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, statSync, } from "node:fs";
+import { resolve, dirname, relative, extname } from "node:path";
+import { glob } from "glob";
+/**
+ * ディレクトリを作成 (再帰的)
+ */
+export function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * ファイルを書き込み (ディレクトリも作成)
+ */
+export function writeFile(filePath, content) {
+    ensureDir(dirname(filePath));
+    writeFileSync(filePath, content, "utf-8");
+}
+/**
+ * ファイルを読み込み
+ */
+export function readFile(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    return readFileSync(filePath, "utf-8");
+}
+/**
+ * ファイル一覧を取得 (glob パターン)
+ */
+export async function findFiles(basePath, pattern, options) {
+    const files = await glob(pattern, {
+        cwd: basePath,
+        absolute: true,
+        nodir: true, // ディレクトリを除外
+        ignore: options?.ignore || ["**/node_modules/**"],
+    });
+    return files;
+}
+/**
+ * ディレクトリ内のファイル一覧を取得 (再帰的)
+ */
+export function listFiles(dirPath, options) {
+    const result = [];
+    if (!existsSync(dirPath)) {
+        return result;
+    }
+    const entries = readdirSync(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = resolve(dirPath, entry.name);
+        // 無視パターンチェック
+        if (options?.ignore?.some((pattern) => fullPath.includes(pattern))) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            if (options?.recursive !== false) {
+                result.push(...listFiles(fullPath, options));
+            }
+        }
+        else if (entry.isFile()) {
+            // 拡張子フィルタ
+            if (options?.extensions) {
+                const ext = extname(entry.name);
+                if (!options.extensions.includes(ext)) {
+                    continue;
+                }
+            }
+            result.push(fullPath);
+        }
+    }
+    return result;
+}
+/**
+ * ファイルの相対パスを取得
+ */
+export function getRelativePath(from, to) {
+    return relative(from, to);
+}
+/**
+ * ファイルが存在するか確認
+ */
+export function fileExists(filePath) {
+    return existsSync(filePath);
+}
+/**
+ * ディレクトリが存在するか確認
+ */
+export function dirExists(dirPath) {
+    return existsSync(dirPath) && statSync(dirPath).isDirectory();
+}
+/**
+ * ファイルの最終更新日時を取得
+ */
+export function getFileMtime(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    return statSync(filePath).mtime;
+}
+//# sourceMappingURL=file.js.map

package/dist/utils/file.js.map

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

package/dist/utils/formatters.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Output Formatters
+ *
+ * Provides Table JSON format for AI agent context optimization.
+ * Table JSON reduces token usage by eliminating repeated key names.
+ *
+ * Traditional JSON:
+ * ```json
+ * {
+ *   "issues": [
+ *     {"number": 19, "title": "Fix bug", "status": "Backlog"},
+ *     {"number": 20, "title": "New feature", "status": "Ready"}
+ *   ]
+ * }
+ * ```
+ *
+ * Table JSON:
+ * ```json
+ * {
+ *   "columns": ["number", "title", "status"],
+ *   "rows": [
+ *     [19, "Fix bug", "Backlog"],
+ *     [20, "New feature", "Ready"]
+ *   ]
+ * }
+ * ```
+ */
+/**
+ * Table JSON output structure
+ */
+export interface TableJsonOutput {
+    columns: string[];
+    rows: unknown[][];
+}
+/**
+ * Supported output formats
+ */
+export type OutputFormat = "json" | "table-json";
+/**
+ * Options for formatOutput function
+ */
+export interface FormatOptions {
+    /** The key in the data object that contains the array to convert */
+    arrayKey?: string;
+    /** Columns to include (optional, defaults to all keys from first item) */
+    columns?: string[];
+}
+/**
+ * Convert an array of objects to Table JSON format
+ *
+ * @param data - Array of objects to convert
+ * @param columns - Optional array of column names to include (preserves order)
+ * @returns Table JSON output with columns and rows
+ *
+ * @example
+ * ```typescript
+ * const data = [
+ *   { number: 19, title: "Fix bug", status: "Backlog" },
+ *   { number: 20, title: "New feature", status: "Ready" },
+ * ];
+ *
+ * const tableJson = toTableJson(data);
+ * // {
+ * //   columns: ["number", "title", "status"],
+ * //   rows: [[19, "Fix bug", "Backlog"], [20, "New feature", "Ready"]]
+ * // }
+ * ```
+ */
+export declare function toTableJson<T extends Record<string, unknown>>(data: T[], columns?: string[]): TableJsonOutput;
+/**
+ * Format output data based on specified format
+ *
+ * @param data - Data object to format
+ * @param format - Output format ("json" or "table-json")
+ * @param options - Format options for table-json
+ * @returns Formatted JSON string
+ *
+ * @example
+ * ```typescript
+ * const data = {
+ *   repository: "owner/repo",
+ *   issues: [
+ *     { number: 19, title: "Fix bug" },
+ *   ],
+ *   total_count: 1,
+ * };
+ *
+ * // Regular JSON
+ * formatOutput(data, "json");
+ *
+ * // Table JSON (converts issues array)
+ * formatOutput(data, "table-json", {
+ *   arrayKey: "issues",
+ *   columns: ["number", "title"]
+ * });
+ * ```
+ */
+export declare function formatOutput(data: Record<string, unknown>, format: OutputFormat, options?: FormatOptions): string;
+/**
+ * Default columns for issues list output
+ */
+export declare const GH_ISSUES_LIST_COLUMNS: string[];
+/**
+ * Default columns for projects list output
+ */
+export declare const GH_PROJECTS_LIST_COLUMNS: string[];
+/**
+ * Default columns for discussions list output
+ */
+export declare const GH_DISCUSSIONS_LIST_COLUMNS: string[];
+//# sourceMappingURL=formatters.d.ts.map

package/dist/utils/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,eAAe,CAwBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CA2CR;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,UAQlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAQpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,UAMvC,CAAC"}

package/dist/utils/formatters.js

@@ -0,0 +1,164 @@
+/**
+ * Output Formatters
+ *
+ * Provides Table JSON format for AI agent context optimization.
+ * Table JSON reduces token usage by eliminating repeated key names.
+ *
+ * Traditional JSON:
+ * ```json
+ * {
+ *   "issues": [
+ *     {"number": 19, "title": "Fix bug", "status": "Backlog"},
+ *     {"number": 20, "title": "New feature", "status": "Ready"}
+ *   ]
+ * }
+ * ```
+ *
+ * Table JSON:
+ * ```json
+ * {
+ *   "columns": ["number", "title", "status"],
+ *   "rows": [
+ *     [19, "Fix bug", "Backlog"],
+ *     [20, "New feature", "Ready"]
+ *   ]
+ * }
+ * ```
+ */
+/**
+ * Convert an array of objects to Table JSON format
+ *
+ * @param data - Array of objects to convert
+ * @param columns - Optional array of column names to include (preserves order)
+ * @returns Table JSON output with columns and rows
+ *
+ * @example
+ * ```typescript
+ * const data = [
+ *   { number: 19, title: "Fix bug", status: "Backlog" },
+ *   { number: 20, title: "New feature", status: "Ready" },
+ * ];
+ *
+ * const tableJson = toTableJson(data);
+ * // {
+ * //   columns: ["number", "title", "status"],
+ * //   rows: [[19, "Fix bug", "Backlog"], [20, "New feature", "Ready"]]
+ * // }
+ * ```
+ */
+export function toTableJson(data, columns) {
+    if (data.length === 0) {
+        return { columns: columns ?? [], rows: [] };
+    }
+    // Determine columns: use specified columns or all keys from first item
+    const columnNames = columns ?? Object.keys(data[0]);
+    // Convert each object to an array of values in column order
+    const rows = data.map((item) => columnNames.map((col) => {
+        const value = item[col];
+        // Convert undefined to null for consistency
+        if (value === undefined) {
+            return null;
+        }
+        return value;
+    }));
+    return {
+        columns: columnNames,
+        rows,
+    };
+}
+/**
+ * Format output data based on specified format
+ *
+ * @param data - Data object to format
+ * @param format - Output format ("json" or "table-json")
+ * @param options - Format options for table-json
+ * @returns Formatted JSON string
+ *
+ * @example
+ * ```typescript
+ * const data = {
+ *   repository: "owner/repo",
+ *   issues: [
+ *     { number: 19, title: "Fix bug" },
+ *   ],
+ *   total_count: 1,
+ * };
+ *
+ * // Regular JSON
+ * formatOutput(data, "json");
+ *
+ * // Table JSON (converts issues array)
+ * formatOutput(data, "table-json", {
+ *   arrayKey: "issues",
+ *   columns: ["number", "title"]
+ * });
+ * ```
+ */
+export function formatOutput(data, format, options) {
+    switch (format) {
+        case "json":
+            return JSON.stringify(data, null, 2);
+        case "table-json": {
+            if (!options?.arrayKey) {
+                // Fallback to regular JSON if arrayKey not specified
+                return JSON.stringify(data, null, 2);
+            }
+            const arrayData = data[options.arrayKey];
+            if (!Array.isArray(arrayData)) {
+                // Fallback to regular JSON if arrayKey doesn't point to an array
+                return JSON.stringify(data, null, 2);
+            }
+            // Convert the array to table format
+            const tableData = toTableJson(arrayData, options.columns);
+            // Build output with metadata and table data
+            const output = {};
+            // Add all non-array fields first
+            for (const [key, value] of Object.entries(data)) {
+                if (key !== options.arrayKey) {
+                    output[key] = value;
+                }
+            }
+            // Add columns and rows
+            output.columns = tableData.columns;
+            output.rows = tableData.rows;
+            return JSON.stringify(output, null, 2);
+        }
+        default:
+            return "";
+    }
+}
+/**
+ * Default columns for issues list output
+ */
+export const GH_ISSUES_LIST_COLUMNS = [
+    "number",
+    "title",
+    "state",
+    "status",
+    "priority",
+    "type",
+    "size",
+];
+/**
+ * Default columns for projects list output
+ */
+export const GH_PROJECTS_LIST_COLUMNS = [
+    "id",
+    "title",
+    "status",
+    "priority",
+    "type",
+    "size",
+    "issue_number",
+];
+/**
+ * Default columns for discussions list output
+ */
+export const GH_DISCUSSIONS_LIST_COLUMNS = [
+    "number",
+    "title",
+    "category",
+    "author",
+    "answer_chosen",
+];
+//# sourceMappingURL=formatters.js.map

package/dist/utils/formatters.js.map

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

package/dist/utils/gh-config.d.ts

@@ -0,0 +1,99 @@
+/**
+ * GitHub CLI Configuration
+ *
+ * Reads GitHub settings from `shirokuma-docs.config.yaml` (github section).
+ * Falls back to `.shirokuma-gh.json` for backward compatibility.
+ */
+/** Repo pair configuration */
+export interface RepoPairConfig {
+    /** Pair alias (key from config) */
+    alias: string;
+    /** Private repository (owner/name) */
+    private: string;
+    /** Public repository (owner/name) */
+    public: string;
+    /** Files/directories to exclude from public release */
+    exclude: string[];
+    /** Default branch name */
+    defaultBranch: string;
+}
+/** Metrics configuration for automatic timestamp recording */
+export interface MetricsConfig {
+    /** Enable metrics tracking (default: false) */
+    enabled?: boolean;
+    /** Text field names for date tracking */
+    dateFields?: {
+        planningAt?: string;
+        specReviewAt?: string;
+        startedAt?: string;
+        reviewAt?: string;
+        completedAt?: string;
+    };
+    /** Status → Text field mapping (e.g., "In Progress" → "Started At") */
+    statusToDateMapping?: Record<string, string>;
+    /** Days before an In Progress issue is considered stale (default: 14) */
+    staleThresholdDays?: number;
+}
+/** Configuration structure */
+export interface GhConfig {
+    /** Default category for discussions (e.g., "Handovers") */
+    discussionsCategory?: string;
+    /** Default limit for list commands */
+    listLimit?: number;
+    /** Default Status for newly created issues (e.g., "Backlog") */
+    defaultStatus?: string;
+    /** Labels for issue types */
+    labels?: {
+        feature?: string;
+        bug?: string;
+        chore?: string;
+        docs?: string;
+        research?: string;
+    };
+    /** Public/Private repo pairs */
+    repoPairs?: Record<string, {
+        private: string;
+        public: string;
+        exclude?: string[];
+        defaultBranch?: string;
+    }>;
+    /** Cross-repository references (alias → owner/repo) */
+    crossRepos?: Record<string, string>;
+    /** Metrics configuration for automatic timestamp recording */
+    metrics?: MetricsConfig;
+}
+/**
+ * Load configuration from file(s) or return defaults.
+ *
+ * Supports config inheritance: finds all config files from CWD up to root,
+ * then merges them from farthest (workspace root) to nearest (project-specific).
+ * This allows workspace-level settings (repoPairs, crossRepos) to be inherited
+ * by project-specific configs in subdirectories.
+ */
+export declare function loadGhConfig(projectPath?: string): GhConfig;
+/**
+ * Get default discussions category
+ */
+export declare function getDefaultCategory(config?: GhConfig): string;
+/**
+ * Get default list limit
+ */
+export declare function getDefaultLimit(config?: GhConfig): number;
+/**
+ * Get default status for new issues
+ */
+export declare function getDefaultStatus(config?: GhConfig): string;
+/**
+ * Get label for issue type
+ */
+export declare function getTypeLabel(type: "feature" | "bug" | "chore" | "docs" | "research", config?: GhConfig): string;
+/**
+ * Get metrics configuration with defaults applied.
+ * Returns null if metrics is not configured at all.
+ */
+export declare function getMetricsConfig(config?: GhConfig): MetricsConfig;
+/**
+ * Clear cached config (for testing)
+ */
+export declare function clearConfigCache(): void;
+//# sourceMappingURL=gh-config.d.ts.map

package/dist/utils/gh-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh-config.d.ts","sourceRoot":"","sources":["../../src/utils/gh-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,yCAAyC;IACzC,UAAU,CAAC,EAAE;QACX,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAsBD,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,6BAA6B;IAC7B,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IAEH,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AA8GD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,CAmE3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAG1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAG/G;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,aAAa,CASjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}