@shirokuma-library/shirokuma-docs 0.1.0-alpha.5

package/dist/commands/session.d.ts

@@ -0,0 +1,153 @@
+/**
+ * session command - Unified session management
+ *
+ * Subcommands:
+ * - start: Fetch session context (latest handover + active issues with project fields)
+ * - end: Save handover discussion + update issue statuses
+ * - check: Detect inconsistencies between Issue state and Project Status
+ *
+ * Design:
+ * - Combines multiple API calls into a single command
+ * - Excludes Done/Released items by default
+ * - Used internally by starting-session / ending-session skills
+ */
+import { Logger } from "../utils/logger.js";
+import { type MetricsConfig } from "../utils/gh-config.js";
+import { OutputFormat } from "../utils/formatters.js";
+export interface SessionOptions {
+    owner?: string;
+    verbose?: boolean;
+    format?: OutputFormat;
+    user?: string;
+    all?: boolean;
+    team?: boolean;
+    title?: string;
+    body?: string;
+    done?: string[];
+    review?: string[];
+    fix?: boolean;
+    setup?: boolean;
+}
+/** Statuses to exclude from session start results */
+export declare const DEFAULT_EXCLUDE_STATUSES: string[];
+/** Git repository state for session start */
+export interface GitState {
+    currentBranch: string | null;
+    uncommittedChanges: string[];
+    hasUncommittedChanges: boolean;
+}
+type InconsistencySeverity = "error" | "info";
+/** A single detected inconsistency between Issue state and Project Status */
+export interface Inconsistency {
+    number: number;
+    title: string;
+    url: string;
+    issueState: string;
+    projectStatus: string | null;
+    severity: InconsistencySeverity;
+    description: string;
+}
+/** Result of fixing an inconsistency */
+export interface FixResult {
+    number: number;
+    action: string;
+    success: boolean;
+    error?: string;
+}
+/** ワークフロー自動化チェック結果 (#250) */
+export interface AutomationStatus {
+    checked: boolean;
+    workflows: Array<{
+        name: string;
+        enabled: boolean;
+        recommended: boolean;
+    }>;
+    missing_recommended: string[];
+}
+/** Full check output structure */
+export interface CheckOutput {
+    repository: string;
+    inconsistencies: Inconsistency[];
+    fixes: FixResult[];
+    automations?: AutomationStatus;
+    summary: {
+        total_checked: number;
+        total_inconsistencies: number;
+        errors: number;
+        info: number;
+        fixed: number;
+        fix_failures: number;
+    };
+}
+/**
+ * Classify inconsistencies from a list of issues with project data.
+ * Pure function - no API calls, fully testable.
+ *
+ * Detects two types of inconsistencies:
+ * 1. OPEN issue with terminal status (Done/Released) → should be closed (error)
+ * 2. CLOSED issue with work-started status (In Progress/Review/etc.) → status should be Done (error)
+ * 3. CLOSED issue with pre-work status (Backlog/Icebox/etc.) → may be intentional (info)
+ */
+export declare function classifyInconsistencies(issues: IssueData[], doneStatuses?: string[]): Inconsistency[];
+export interface IssueData {
+    number: number;
+    title: string;
+    url: string;
+    state: string;
+    closedAt: string | null;
+    labels: string[];
+    assignees: string[];
+    status: string | null;
+    priority: string | null;
+    type: string | null;
+    size: string | null;
+    projectItemId: string | null;
+    projectId: string | null;
+}
+/**
+ * Issue に紐づくマージ済み PR を検出する。
+ *
+ * 検出戦略:
+ * 1. ブランチ名検索: 現在のブランチに対応する merged PR を探す
+ * 2. Issue リンク逆引き: マージ済み PR の body から "Closes #N" 等を検索
+ *
+ * @returns マージ済み PR 番号。見つからない場合は null
+ */
+export declare function findMergedPrForIssue(owner: string, repo: string, issueNumber: number, logger: Logger): number | null;
+/**
+ * Get current git repository state (branch + uncommitted changes).
+ * Returns safe defaults if git commands fail.
+ */
+export declare function getGitState(): GitState;
+/** Session backup metadata returned by getSessionBackups */
+export interface SessionBackup {
+    filename: string;
+    timestamp: string;
+    content: string;
+}
+/**
+ * Check for PreCompact session backups in .claude/sessions/.
+ * Returns backups sorted by timestamp (most recent first).
+ */
+export declare function getSessionBackups(): SessionBackup[];
+/**
+ * Remove all PreCompact session backups from .claude/sessions/.
+ * Called after a successful handover to prevent stale backups.
+ *
+ * @returns Number of files cleaned up
+ */
+export declare function cleanupSessionBackups(): number;
+/** Group issues by assignee for team view */
+export declare function groupIssuesByAssignee(issues: IssueData[]): Record<string, IssueData[]>;
+/**
+ * Classify metrics-related inconsistencies.
+ * Pure function - no API calls, fully testable.
+ *
+ * Detects:
+ * 1. Done/Released issues missing Completed At timestamp
+ * 2. In Progress issues that are stale (In Progress At older than threshold)
+ */
+export declare function classifyMetricsInconsistencies(issues: IssueData[], textFieldValues: Record<string, Record<string, string>>, metricsConfig: MetricsConfig, now?: Date): Inconsistency[];
+export declare function sessionCommand(action: string, options: SessionOptions): Promise<void>;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/commands/session.d.ts.map

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