@civilization/dsh-experimental-git 0.0.0-stage → 0.2.1-rc.2

package/lib/types/client/GitBody.d.ts

@@ -0,0 +1,66 @@
+/**
+ * IntelliJ IDEA-Grade Git Tool Window Component.
+ * Supports DAG commit topology graph visualization, working tree staging, commit console,
+ * branch switcher, and unified diff inspector.
+ */
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { GitBranchesSummary, GitCommitDetail, GitCommitItem, GitDiffSummary, GitStatusSummary, GitTagItem } from '../types.ts';
+/** Injected Git RPC methods */
+export interface GitInjected {
+    readonly getStatus: (sessionId?: string) => Promise<GitStatusSummary>;
+    readonly getLog: (sessionId?: string, maxCount?: number) => Promise<readonly GitCommitItem[]>;
+    readonly getCommitDetails: (sessionId?: string, commit?: string) => Promise<GitCommitDetail | undefined>;
+    readonly getDiff: (sessionId?: string, options?: {
+        filePath?: string;
+        staged?: boolean;
+        commit?: string;
+    }) => Promise<GitDiffSummary>;
+    readonly getBranches: (sessionId?: string) => Promise<GitBranchesSummary>;
+    readonly checkout: (sessionId?: string, branch?: string, create?: boolean) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    readonly stage: (sessionId?: string, paths?: string[] | 'all') => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    readonly unstage: (sessionId?: string, paths?: string[] | 'all') => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    readonly discard: (sessionId?: string, paths?: string[]) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    readonly commit: (sessionId?: string, message?: string) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    readonly fetch: (sessionId?: string) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    readonly pull: (sessionId?: string) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    readonly push: (sessionId?: string) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    readonly getTags: (sessionId?: string) => Promise<readonly GitTagItem[]>;
+    readonly createTag: (sessionId?: string, name?: string, commit?: string, message?: string) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    readonly deleteTag: (sessionId?: string, name?: string) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+}
+export type GitBodyProps = PropsRuntime<'sidebar.right.pane.tab'> & PropsLocale<'gitView'> & GitInjected;
+/**
+ * Main Git Body Component.
+ */
+export declare const GitBody: import("react").MemoExoticComponent<(props: GitBodyProps) => import("react").JSX.Element>;
+//# sourceMappingURL=GitBody.d.ts.map

package/lib/types/client/GitBranchPill.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Status bar Git branch pill and popover branch switcher (IDEA / VS Code style).
+ * Injected into the 'conversation.composer.dock' slot at order: -1.
+ */
+import type { GitBranchesSummary, GitStatusSummary } from '../types.ts';
+export interface GitBranchPillProps {
+    getStatus?: ((sessionId?: string) => Promise<GitStatusSummary>) | undefined;
+    getBranches?: ((sessionId?: string) => Promise<GitBranchesSummary>) | undefined;
+    checkout?: ((sessionId: string | undefined, branch: string, create?: boolean) => Promise<{
+        success: boolean;
+        message?: string;
+    }>) | undefined;
+    pull?: ((sessionId?: string) => Promise<{
+        success: boolean;
+        message?: string;
+    }>) | undefined;
+    push?: ((sessionId?: string) => Promise<{
+        success: boolean;
+        message?: string;
+    }>) | undefined;
+    sessionId?: string | undefined;
+}
+/**
+ * Git Branch Pill rendered in the Composer Dock.
+ */
+export declare const GitBranchPill: import("react").MemoExoticComponent<({ getStatus, getBranches, checkout, pull, push, sessionId, }: GitBranchPillProps) => import("react").JSX.Element | null>;
+//# sourceMappingURL=GitBranchPill.d.ts.map

package/lib/types/client/GitTitle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The Git tab's chip title in the right-sidebar header.
+ */
+import type { ReactNode } from 'react';
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/**
+ * Git chip title component with branch glyph and title text.
+ * @param props - Slot props including tab info hook.
+ * @returns React node for tab chip.
+ */
+export declare function GitTitle({ useTabInfo }: PropsRuntime<'sidebar.right.pane.tab.title'>): ReactNode;
+//# sourceMappingURL=GitTitle.d.ts.map

package/lib/types/client/definition.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Definition of the `git` tab type for the right Sidebar.
+ */
+import React from 'react';
+import type { SidebarRightTabDefinition } from '@deepseek-ai/dsh-client-ui-sidebar-right/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-locale/client';
+/** The tab kind this package owns */
+export declare const GIT_KIND = "git";
+/** Implementation identity in the tab system */
+export declare const GIT_ID = "@deepseek-ai/dsh-experimental-git";
+/** Git artwork for the Sidebar Guide */
+export declare function GuideArtworkGit(): React.ReactElement;
+/**
+ * Tab definition for the Git right-sidebar viewer.
+ * @param t - namespace-bound translation function.
+ * @returns Complete sidebar tab definition.
+ */
+export declare function gitDefinition(t: TranslateNS<'gitView'>): SidebarRightTabDefinition;
+//# sourceMappingURL=definition.d.ts.map

package/lib/types/client/git-helpers.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Conventional Commits and presentation helpers for Git commits and avatars.
+ */
+export type ConventionalType = 'feat' | 'fix' | 'style' | 'refactor' | 'docs' | 'test' | 'chore' | 'release' | 'merge' | 'revert';
+export interface ParsedCommitSubject {
+    readonly type?: ConventionalType;
+    readonly scope?: string;
+    readonly cleanSubject: string;
+}
+/**
+ * Parse conventional commit prefix from a commit subject.
+ * @param subject - Raw first line of commit message.
+ * @returns Parsed type, scope, and clean subject.
+ */
+export declare function parseConventionalCommit(subject: string): ParsedCommitSubject;
+/**
+ * Deterministically compute avatar initial and background color for an author name.
+ * @param author - Author name or email.
+ * @returns Initial letter and hex color code.
+ */
+export declare function getAuthorAvatar(author: string): {
+    initial: string;
+    color: string;
+};
+/**
+ * Format date string into YYYY-MM-DD HH:mm:ss.
+ * @param dateStr - ISO or Git date string.
+ * @returns Clean formatted local date and time string.
+ */
+export declare function formatFullDate(dateStr: string): string;
+export declare const GRAPH_LANE_PALETTE: readonly ["#388bfd", "#3fb950", "#f0883e", "#a371f7", "#58a6ff", "#bc8cff", "#db61a2", "#2ea043"];
+export interface DagNode {
+    readonly hash: string;
+    readonly lane: number;
+    readonly color: string;
+    readonly x: number;
+    readonly y: number;
+    readonly isHead: boolean;
+    readonly hasTag: boolean;
+}
+export interface DagEdge {
+    readonly key: string;
+    readonly fromHash: string;
+    readonly toHash?: string;
+    readonly color: string;
+    readonly d: string;
+}
+export interface DagGraphModel {
+    readonly nodes: readonly DagNode[];
+    readonly edges: readonly DagEdge[];
+    readonly maxLane: number;
+    readonly graphWidth: number;
+}
+/**
+ * Compute global continuous SVG DAG topology graph for commit items (IntelliJ IDEA grade).
+ * Eliminates per-row segmentation gaps, floating nodes, and misaligned curves.
+ * @param commits - Ordered commit items.
+ * @returns Fully computed nodes, edges, maxLane, and width.
+ */
+export declare function computeDagGraph(commits: readonly {
+    hash: string;
+    parents?: readonly string[];
+    refs?: readonly string[];
+}[]): DagGraphModel;
+//# sourceMappingURL=git-helpers.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Browser entry for the experimental Git right-sidebar plugin.
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+export type { GitBodyProps, GitInjected } from './GitBody.tsx';
+export type { GitViewKey } from './locales.ts';
+/**
+ * Required browser services.
+ */
+export declare const inject: string[];
+/**
+ * Client plugin body: registers Git tab definition, locales, shortcut, and components.
+ * @param ctx - Client context carrying slots and connection services.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Localized copy for the Git right-sidebar viewer and commands.
+ */
+export declare const NS = "gitView";
+export declare const zh: {
+    'type.label': string;
+    'guide.title': string;
+    'guide.description': string;
+    'shortcut.noSession': string;
+    'tabs.changes': string;
+    'tabs.history': string;
+    'tabs.tree': string;
+    'tabs.branches': string;
+    'tabs.tags': string;
+    'actions.refresh': string;
+    'actions.viewDiff': string;
+    'actions.closeDiff': string;
+    'actions.stage': string;
+    'actions.unstage': string;
+    'actions.stageAll': string;
+    'actions.unstageAll': string;
+    'actions.discard': string;
+    'actions.commit': string;
+    'actions.commitAndPush': string;
+    'actions.checkout': string;
+    'actions.newBranch': string;
+    'actions.fetch': string;
+    'actions.pull': string;
+    'actions.push': string;
+    'commit.placeholder': string;
+    'commit.emptyWarning': string;
+    'commit.success': string;
+    'branch.filter': string;
+    'branch.local': string;
+    'branch.remote': string;
+    'branch.current': string;
+    'branch.newPrompt': string;
+    'branch.createAndCheckout': string;
+    'tree.author': string;
+    'tree.date': string;
+    'tree.hash': string;
+    'tree.changedFiles': string;
+    'tree.selectCommit': string;
+    'status.clean': string;
+    'status.notRepo': string;
+    'status.staged': string;
+    'status.unstaged': string;
+    'status.untracked': string;
+    'status.ahead': string;
+    'status.behind': string;
+    'diff.additions': string;
+    'diff.deletions': string;
+    'diff.empty': string;
+    'tag.filter': string;
+    'tag.newPrompt': string;
+    'tag.nameLabel': string;
+    'tag.namePlaceholder': string;
+    'tag.targetCommitLabel': string;
+    'tag.messageLabel': string;
+    'tag.messagePrompt': string;
+    'tag.createBtn': string;
+    'tag.cancelBtn': string;
+    'tag.locateBtn': string;
+    'tag.copyName': string;
+    'tag.deleteBtn': string;
+    'tag.deleteConfirm': string;
+    'tag.empty': string;
+    'tag.annotated': string;
+    'tag.locatedNotice': string;
+    'actions.locate': string;
+    'tree.colGraph': string;
+    'tree.colSubject': string;
+    'tree.colAuthor': string;
+    'tree.colTime': string;
+    'tree.colSha': string;
+    'tree.searchPlaceholder': string;
+    'tree.filterAll': string;
+    'tree.filterMainline': string;
+    'detail.title': string;
+    'detail.references': string;
+    'detail.author': string;
+    'detail.date': string;
+    'detail.parent': string;
+    'detail.checkout': string;
+    'detail.createBranchOrTag': string;
+    'footer.showingCount': string;
+    'footer.loadMore': string;
+    'footer.syncNormal': string;
+    'footer.ahead': string;
+    'footer.behind': string;
+};
+export type GitViewKey = keyof typeof zh;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        gitView: GitViewKey;
+    }
+}
+export declare const en: {
+    'type.label': string;
+    'guide.title': string;
+    'guide.description': string;
+    'shortcut.noSession': string;
+    'tabs.changes': string;
+    'tabs.history': string;
+    'tabs.tree': string;
+    'tabs.branches': string;
+    'tabs.tags': string;
+    'actions.refresh': string;
+    'actions.viewDiff': string;
+    'actions.closeDiff': string;
+    'actions.stage': string;
+    'actions.unstage': string;
+    'actions.stageAll': string;
+    'actions.unstageAll': string;
+    'actions.discard': string;
+    'actions.commit': string;
+    'actions.commitAndPush': string;
+    'actions.checkout': string;
+    'actions.newBranch': string;
+    'actions.fetch': string;
+    'actions.pull': string;
+    'actions.push': string;
+    'commit.placeholder': string;
+    'commit.emptyWarning': string;
+    'commit.success': string;
+    'branch.filter': string;
+    'branch.local': string;
+    'branch.remote': string;
+    'branch.current': string;
+    'branch.newPrompt': string;
+    'branch.createAndCheckout': string;
+    'tree.author': string;
+    'tree.date': string;
+    'tree.hash': string;
+    'tree.changedFiles': string;
+    'tree.selectCommit': string;
+    'status.clean': string;
+    'status.notRepo': string;
+    'status.staged': string;
+    'status.unstaged': string;
+    'status.untracked': string;
+    'status.ahead': string;
+    'status.behind': string;
+    'diff.additions': string;
+    'diff.deletions': string;
+    'diff.empty': string;
+    'tag.filter': string;
+    'tag.newPrompt': string;
+    'tag.nameLabel': string;
+    'tag.namePlaceholder': string;
+    'tag.targetCommitLabel': string;
+    'tag.messageLabel': string;
+    'tag.messagePrompt': string;
+    'tag.createBtn': string;
+    'tag.cancelBtn': string;
+    'tag.locateBtn': string;
+    'tag.copyName': string;
+    'tag.deleteBtn': string;
+    'tag.deleteConfirm': string;
+    'tag.empty': string;
+    'tag.annotated': string;
+    'tag.locatedNotice': string;
+    'actions.locate': string;
+    'tree.colGraph': string;
+    'tree.colSubject': string;
+    'tree.colAuthor': string;
+    'tree.colTime': string;
+    'tree.colSha': string;
+    'tree.searchPlaceholder': string;
+    'tree.filterAll': string;
+    'tree.filterMainline': string;
+    'detail.title': string;
+    'detail.references': string;
+    'detail.author': string;
+    'detail.date': string;
+    'detail.parent': string;
+    'detail.checkout': string;
+    'detail.createBranchOrTag': string;
+    'footer.showingCount': string;
+    'footer.loadMore': string;
+    'footer.syncNormal': string;
+    'footer.ahead': string;
+    'footer.behind': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/git-executor.d.ts

@@ -0,0 +1,151 @@
+import type { GitBranchInfo, GitBranchesSummary, GitCommitDetail, GitCommitItem, GitDiffSummary, GitOperationResult, GitStatusSummary, GitTagItem } from './types.ts';
+/**
+ * Execute a git command in the target directory safely.
+ * @param cwd - Working directory for the git execution.
+ * @param args - Subcommand and arguments to pass to git.
+ * @returns Raw stdout trimmed, or undefined if the execution failed.
+ */
+export declare function runGit(cwd: string, args: readonly string[]): Promise<string | undefined>;
+/**
+ * Detailed execution result returning stdout, stderr, and success code.
+ * @param cwd - Working directory.
+ * @param args - Arguments.
+ * @returns Standard execution details.
+ */
+export declare function runGitDetailed(cwd: string, args: readonly string[]): Promise<{
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Check if the target directory is inside a valid git repository worktree.
+ * @param cwd - Target directory.
+ * @returns Whether cwd is a git repository.
+ */
+export declare function checkIsGitRepo(cwd: string): Promise<boolean>;
+/**
+ * Get the absolute top-level directory of the git repository.
+ * @param cwd - Target directory.
+ * @returns Top-level directory path, or undefined.
+ */
+export declare function getGitRoot(cwd: string): Promise<string | undefined>;
+/**
+ * Query full git repository status for the given directory.
+ * @param cwd - Target directory.
+ * @returns Complete status summary.
+ */
+export declare function getGitStatus(cwd: string): Promise<GitStatusSummary>;
+/**
+ * Query recent git commit history with DAG graph topology for the given directory.
+ * @param cwd - Target directory.
+ * @param maxCount - Maximum number of commits to retrieve (defaults to 50).
+ * @returns Ordered list of recent commits with topology paths.
+ */
+export declare function getGitLog(cwd: string, maxCount?: number): Promise<readonly GitCommitItem[]>;
+/**
+ * Query details and changed files for a specific commit.
+ * @param cwd - Working directory.
+ * @param commitHash - Full or abbreviated commit hash.
+ * @returns Detailed commit information.
+ */
+export declare function getGitCommitDetails(cwd: string, commitHash: string): Promise<GitCommitDetail | undefined>;
+/**
+ * Query git diff for specified file or current directory.
+ * @param cwd - Target directory.
+ * @param options - Diff parameters.
+ * @returns Complete diff text and per-file parsed statistics.
+ */
+export declare function getGitDiff(cwd: string, options?: {
+    path?: string;
+    staged?: boolean;
+    commit?: string;
+}): Promise<GitDiffSummary>;
+/**
+ * Query local and remote branches.
+ * @param cwd - Target directory.
+ * @returns Aggregated branch summary.
+ */
+export declare function getGitAllBranches(cwd: string): Promise<GitBranchesSummary>;
+/**
+ * Query git local branches (legacy helper).
+ * @param cwd - Target directory.
+ * @returns List of branch information.
+ */
+export declare function getGitBranches(cwd: string): Promise<readonly GitBranchInfo[]>;
+/**
+ * Checkout an existing branch or create a new branch.
+ * @param cwd - Target directory.
+ * @param branch - Branch name to switch to.
+ * @param createNew - Whether to create a new branch (-b).
+ * @returns Operation result.
+ */
+export declare function gitCheckout(cwd: string, branch: string, createNew?: boolean): Promise<GitOperationResult>;
+/**
+ * Stage files to index.
+ * @param cwd - Target directory.
+ * @param paths - Specific file paths or 'all'.
+ * @returns Operation result.
+ */
+export declare function gitStage(cwd: string, paths: readonly string[] | 'all'): Promise<GitOperationResult>;
+/**
+ * Unstage files from index.
+ * @param cwd - Target directory.
+ * @param paths - Specific file paths or 'all'.
+ * @returns Operation result.
+ */
+export declare function gitUnstage(cwd: string, paths: readonly string[] | 'all'): Promise<GitOperationResult>;
+/**
+ * Discard working tree changes for specified files.
+ * @param cwd - Target directory.
+ * @param paths - Specific file paths to discard.
+ * @returns Operation result.
+ */
+export declare function gitDiscard(cwd: string, paths: readonly string[]): Promise<GitOperationResult>;
+/**
+ * Commit staged changes with message.
+ * @param cwd - Target directory.
+ * @param message - Commit message.
+ * @returns Operation result.
+ */
+export declare function gitCommit(cwd: string, message: string): Promise<GitOperationResult>;
+/**
+ * Fetch updates from remotes.
+ * @param cwd - Target directory.
+ * @returns Operation result.
+ */
+export declare function gitFetch(cwd: string): Promise<GitOperationResult>;
+/**
+ * Pull remote changes into current branch.
+ * @param cwd - Target directory.
+ * @returns Operation result.
+ */
+export declare function gitPull(cwd: string): Promise<GitOperationResult>;
+/**
+ * Push local commits to remote upstream.
+ * @param cwd - Target directory.
+ * @returns Operation result.
+ */
+export declare function gitPush(cwd: string): Promise<GitOperationResult>;
+/**
+ * Query all git tags in the repository sorted by creation date descending.
+ * @param cwd - Target directory.
+ * @returns Ordered list of Git tags with commit hashes and metadata.
+ */
+export declare function getGitTags(cwd: string): Promise<readonly GitTagItem[]>;
+/**
+ * Create a new git tag at the specified commit or HEAD.
+ * @param cwd - Target directory.
+ * @param name - Tag name (e.g. 'v1.0.0').
+ * @param targetCommit - Optional commit hash (defaults to HEAD).
+ * @param message - Optional annotation message. If provided, creates an annotated tag (-a).
+ * @returns Operation result.
+ */
+export declare function gitCreateTag(cwd: string, name: string, targetCommit?: string, message?: string): Promise<GitOperationResult>;
+/**
+ * Delete a git tag.
+ * @param cwd - Target directory.
+ * @param name - Tag name to delete.
+ * @returns Operation result.
+ */
+export declare function gitDeleteTag(cwd: string, name: string): Promise<GitOperationResult>;
+//# sourceMappingURL=git-executor.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Host entry for the experimental Git plugin.
+ * Provides RPC endpoints for the Client right-sidebar viewer and the model tool for Agents.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export type * from './types.ts';
+/** Cordis plugin name */
+export declare const name = "experimental-git";
+/** Required host services */
+export declare const inject: string[];
+/**
+ * Apply the Git host plugin.
+ * Sets up authenticated RPC handlers under `/git/*` and registers the model tool.
+ * @param ctx - Context carrying the connection and optional session services.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/tool.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Agent model tool for inspecting Git repository status, commits, and diffs.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * Register git model tools (git_view and git_checkout) in the tools service.
+ * @param ctx - Context carrying the tools service.
+ * @param resolveDir - Resolver for the current agent or session working directory.
+ */
+export declare function registerGitTool(ctx: Context, resolveDir: (sessionId?: string) => string): void;
+//# sourceMappingURL=tool.d.ts.map