@hunan36/dsh-git-flow 0.0.0-stage → 0.4.0

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

@@ -0,0 +1,8 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+/** Props the session-scoped slot delivers to this entry. */
+export interface GitFlowChipProps {
+    sessionId: string;
+    t: TranslateNS<'gitFlow'>;
+}
+/** Branch chip for the session's workspace; renders nothing outside a repository. */
+export declare function GitFlowChip({ sessionId, t }: GitFlowChipProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,27 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { GitBranchesView, GitFlowStateView, GitStatusView } from '../contract.ts';
+/** Branch popover props. */
+export interface BranchMenuProps {
+    t: TranslateNS<'gitFlow'>;
+    status: GitStatusView;
+    /** Branch table, loaded on first open. */
+    branches: GitBranchesView | undefined;
+    /** True while a load or switch is in flight; the chip shows a busy state. */
+    busy: boolean;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onSelectBranch: (name: string) => void;
+    onNewBranch: () => void;
+    onCommit: () => void;
+    /** Push what is already committed, without opening the commit panel. */
+    onPush: () => void;
+    /** Pull the current branch's upstream (`--ff-only`). */
+    onPull: () => void;
+    onRefresh: () => void;
+    /** Flow state of the current branch; absent until it has been read. */
+    flow: GitFlowStateView | undefined;
+    onStartFlow: () => void;
+    onFinishFlow: () => void;
+}
+/** Pill plus anchored branch picker: pinned search, scrolling rows, pinned actions. */
+export declare function BranchMenu(props: BranchMenuProps): import("react").JSX.Element;

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

@@ -0,0 +1,45 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { GitStatusView } from '../contract.ts';
+/** What a dialog reports back to the chip that owns it. */
+export interface DialogHost {
+    t: TranslateNS<'gitFlow'>;
+    sessionId: string;
+    /** Transient banner text; `failed` renders the warning glyph. */
+    notify: (text: string, failed?: boolean) => void;
+    /** Re-read status after the repository changed. */
+    refresh: () => void;
+}
+/** Commit composer: pick paths, draft or write the message, commit, optionally push. */
+export declare function CommitDialog(props: CommitDialogProps): import("react").JSX.Element;
+/**
+ * Confirmation for a destructive discard. Nothing is sent until the user picks
+ * the destructive action here.
+ */
+export declare function DiscardDialog(props: DiscardDialogProps): import("react").JSX.Element;
+/** Discard dialog props. */
+export interface DiscardDialogProps extends DialogHost {
+    files: string[];
+    onClose: () => void;
+}
+/** Commit dialog props. */
+export interface CommitDialogProps extends DialogHost {
+    status: GitStatusView;
+    onClose: () => void;
+}
+/** Ask for a branch name, create it from the current HEAD, and switch to it. */
+export declare function CreateBranchDialog(props: CreateBranchDialogProps): import("react").JSX.Element;
+/** New-branch dialog props. */
+export interface CreateBranchDialogProps extends DialogHost {
+    status: GitStatusView;
+    onClose: () => void;
+}
+/**
+ * A switch that git refused because it would overwrite local edits. The first
+ * attempt runs without `force`; only this second confirmation sends it.
+ */
+export declare function ForceCheckoutDialog(props: ForceCheckoutDialogProps): import("react").JSX.Element;
+/** Forced-switch dialog props. */
+export interface ForceCheckoutDialogProps extends DialogHost {
+    branch: string;
+    onClose: () => void;
+}

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

@@ -0,0 +1,37 @@
+import type { GitFlowStateView, GitStatusView } from '../contract.ts';
+import type { DialogHost } from './CommitDialog.tsx';
+/** Start dialog props. */
+export interface StartFlowDialogProps extends DialogHost {
+    state: GitFlowStateView;
+    status: GitStatusView;
+    onClose: () => void;
+    /** A start refused for a missing develop hands off to the init dialog. */
+    onNeedDevelop: () => void;
+}
+/**
+ * Name a flow branch and create it from the branch its family starts at.
+ * A missing develop is not an error the user can fix in this dialog, so it
+ * closes and hands off to the guided creation instead.
+ */
+export declare function StartFlowDialog(props: StartFlowDialogProps): import("react").JSX.Element;
+/** Init-develop dialog props. */
+export interface InitDevelopDialogProps extends DialogHost {
+    state: GitFlowStateView;
+    status: GitStatusView;
+    onClose: () => void;
+    /** Continue whatever asked for develop in the first place. */
+    onDone: () => void;
+}
+/** Create the integration branch from production (or HEAD when there is none). */
+export declare function InitDevelopDialog(props: InitDevelopDialogProps): import("react").JSX.Element;
+/** Finish dialog props. */
+export interface FinishFlowDialogProps extends DialogHost {
+    state: GitFlowStateView;
+    status: GitStatusView;
+    onClose: () => void;
+}
+/**
+ * Confirm and run the finish sequence. The step list is generated from the same
+ * facts the host will act on, so what the user reads is what will happen.
+ */
+export declare function FinishFlowDialog(props: FinishFlowDialogProps): import("react").JSX.Element;

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

@@ -0,0 +1,42 @@
+/**
+ * Typed fetch wrapper for `/api/dsh-git-flow/*`. Every call names only the
+ * session; the host resolves the repository.
+ */
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { CheckoutRequest, DiscardRequest, CreateBranchRequest, CommitRequest, GenerateMessageRequest, GitBranchesView, GitCommitView, GitErrorCode, GitFlowFinishView, GitFlowStartRequest, GitFlowStateView, GitMessageView, GitPullView, GitPushView, GitStatusView } from '../contract.ts';
+/** A git operation refused by the host, carrying its structured code. */
+export declare class GitApiError extends Error {
+    readonly code: GitErrorCode;
+    constructor(code: GitErrorCode, message: string);
+}
+/** Whether an error should hide the branch chip instead of reporting itself. */
+export declare function isSilentError(error: unknown): boolean;
+/** Whether an error means the checked paths are out of date. */
+export declare function isStaleSelection(error: unknown): boolean;
+/** Human-readable failure text for any thrown value. */
+export declare function errorText(t: TranslateNS<'gitFlow'>, error: unknown): string;
+/** The browser-side git API. */
+export declare const gitApi: {
+    status: (sessionId: string) => Promise<GitStatusView>;
+    branches: (sessionId: string) => Promise<GitBranchesView>;
+    checkout: (body: CheckoutRequest) => Promise<GitStatusView>;
+    createBranch: (body: CreateBranchRequest) => Promise<GitStatusView>;
+    commit: (body: CommitRequest) => Promise<GitCommitView>;
+    discard: (body: DiscardRequest) => Promise<GitStatusView>;
+    push: (body: {
+        sessionId: string;
+    }) => Promise<GitPushView>;
+    pull: (body: {
+        sessionId: string;
+    }) => Promise<GitPullView>;
+    generateMessage: (body: GenerateMessageRequest) => Promise<GitMessageView>;
+    gitflowState: (sessionId: string) => Promise<GitFlowStateView>;
+    startFlow: (body: GitFlowStartRequest) => Promise<GitStatusView>;
+    initDevelop: (body: {
+        sessionId: string;
+    }) => Promise<GitStatusView>;
+    finishFlow: (body: {
+        sessionId: string;
+        version?: string;
+    }) => Promise<GitFlowFinishView>;
+};

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

@@ -0,0 +1,14 @@
+/**
+ * dsh-git-flow, browser half. Registers the `gitFlow` dictionary and one
+ * `conversation.input.left` entry: the branch chip and everything it opens.
+ * Loaded by the harness module loader as `dsh-git-flow/client.js`.
+ * @module dsh-git-flow/client
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Services this fiber needs before it activates. */
+export declare const inject: string[];
+/**
+ * Mount the branch chip and its copy.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: Context): void;

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

@@ -0,0 +1,236 @@
+/**
+ * Browser copy for the git surface. Both dictionaries carry the same keys;
+ * `en` is typed against `zh` so a missing key is a compile error.
+ */
+export declare const GIT_FLOW_NS = "gitFlow";
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Branch, commit, and push copy owned by this plugin. */
+        gitFlow: GitFlowKey;
+    }
+}
+declare const zh: {
+    readonly 'chip.tooltip': "当前分支 {branch}，{count} 个未提交改动";
+    readonly 'chip.tooltip.clean': "当前分支 {branch}，工作区干净";
+    readonly 'chip.aheadBehind': "领先 {ahead}，落后 {behind}";
+    readonly 'chip.unpushed': "有 {count} 个提交未推送";
+    readonly 'menu.search': "搜索分支";
+    readonly 'menu.local': "本地分支";
+    readonly 'menu.remote': "仅在远端";
+    readonly 'menu.empty': "没有匹配的分支";
+    readonly 'menu.loading': "读取分支…";
+    readonly 'menu.newBranch': "新建分支…";
+    readonly 'menu.commit': "提交…";
+    readonly 'menu.push': "推送提交";
+    readonly 'menu.pull': "拉取远程代码";
+    readonly 'menu.refresh': "刷新状态";
+    readonly 'menu.startFlow': "启动 Git Flow 分支…";
+    readonly 'menu.finishFlow': "完成 Git Flow 分支…";
+    readonly 'flow.feature': "功能";
+    readonly 'flow.release': "发布";
+    readonly 'flow.hotfix': "热修复";
+    readonly 'flow.badge': "{kind}";
+    readonly 'start.title': "启动 Git Flow 分支";
+    readonly 'start.description': "功能与发布分支从 {develop} 切出，热修复从 {production} 切出。";
+    readonly 'start.kind': "分支类型";
+    readonly 'start.name': "名称";
+    readonly 'start.placeholder': "例如 login，将创建 {prefix}login";
+    readonly 'start.submit': "创建并切换";
+    readonly 'start.done': "已创建并切换到 {branch}";
+    readonly 'start.needName': "请先填写名称";
+    readonly 'start.base': "将从 {base} 切出";
+    readonly 'start.versionHint': "发布与热修复的名称建议带版本号，例如 0.4.0";
+    readonly 'initDevelop.title': "还没有 {develop} 分支";
+    readonly 'initDevelop.description': "Git Flow 需要一个集成分支。将从 {from} 创建 {develop} 并切换过去。";
+    readonly 'initDevelop.submit': "创建 {develop}";
+    readonly 'initDevelop.done': "已创建 {develop}";
+    readonly 'finish.title': "完成 {branch}";
+    readonly 'finish.description': "以下动作会依次执行，合并提交与标签一旦创建就不会回滚。";
+    readonly 'finish.mergeInto': "合并到 {targets}（--no-ff）";
+    readonly 'finish.tag': "创建标签 {tag}";
+    readonly 'finish.version': "把 package.json 版本改为 {version}";
+    readonly 'finish.push': "推送分支与标签到 origin";
+    readonly 'finish.delete': "删除已完成的本地分支";
+    readonly 'finish.versionLabel': "版本号";
+    readonly 'finish.submit': "完成并合并";
+    readonly 'finish.tagExists': "标签 {tag} 已存在，请先改用其它版本号";
+    readonly 'finish.done': "已完成 {branch}";
+    readonly 'finish.partial': "{branch} 已在本地完成，但推送失败：{detail}";
+    readonly 'finish.merged': "已合并到 {targets}";
+    readonly 'finish.tagCreated': "已创建标签 {tag}";
+    readonly 'finish.versionWritten': "已提交版本号 {version}";
+    readonly 'finish.deleted': "已删除本地分支";
+    readonly 'finish.pushFail': "推送失败：{detail}";
+    readonly 'checkout.done': "已切换到 {branch}";
+    readonly 'checkout.dirtyTitle': "工作区有未提交改动";
+    readonly 'checkout.dirtyBody': "切换到 {branch} 会覆盖本地改动。可以先提交，或者强制切换（`git switch --force` 会丢弃全部本地改动）。";
+    readonly 'checkout.force': "强制切换";
+    readonly 'create.title': "新建分支";
+    readonly 'create.description': "基于当前分支 {branch} 创建并切换。";
+    readonly 'create.name': "分支名称";
+    readonly 'create.placeholder': "例如 feature/git-flow";
+    readonly 'create.submit': "创建并切换";
+    readonly 'create.done': "已创建并切换到 {branch}";
+    readonly 'commit.title': "提交改动";
+    readonly 'commit.description': "只提交勾选的文件；提交信息可由模型生成，也可以自己写。";
+    readonly 'commit.files': "改动文件";
+    readonly 'commit.selectAll': "全部 {count} 个文件";
+    readonly 'commit.message': "提交信息";
+    readonly 'commit.messageLanguage': "提交信息语言";
+    readonly 'commit.messagePlaceholder': "第一行写成 feat: 描述，空一行后可以补充要点";
+    readonly 'commit.generate': "生成提交信息";
+    readonly 'commit.regenerate': "重新生成";
+    readonly 'commit.generating': "正在生成…";
+    readonly 'commit.push': "推送";
+    readonly 'commit.commit': "提交";
+    readonly 'commit.commitPush': "提交并推送";
+    readonly 'commit.cancel': "取消";
+    readonly 'commit.discard': "放弃更改";
+    readonly 'commit.discardTitle': "放弃这些文件的改动？";
+    readonly 'commit.discardBody': "将把 {count} 个文件恢复到 HEAD：已跟踪的改动被丢弃，未跟踪的文件会被删除。此操作无法撤销。";
+    readonly 'commit.discardDone': "已放弃 {count} 个文件的改动";
+    readonly 'commit.discardOne': "放弃「{path}」的改动";
+    readonly 'commit.resize': "拖动调整面板宽度";
+    readonly 'commit.none': "还没有勾选文件";
+    readonly 'commit.needMessage': "请先填写提交信息";
+    readonly 'commit.selected': "已选 {count} 个文件";
+    readonly 'commit.noUpstream': "当前分支还没有上游，首次推送会自动建立";
+    readonly 'commit.fallback': "模型没有给出可用信息，已填入模板，可自行修改";
+    readonly 'commit.staleHost': "语言选择没生效：宿主进程还是旧版本，重启 dsh web 后再试";
+    readonly 'commit.fallbackReason': "模型没有给出可用信息（{detail}），已填入模板，可自行修改";
+    readonly 'commit.done': "已提交 {hash}";
+    readonly 'commit.pushDone': "已提交并推送 {hash}";
+    readonly 'commit.pushFail': "已提交 {hash}，但推送失败";
+    readonly 'push.done': "已推送 {branch}";
+    readonly 'pull.done': "已拉取 {branch}";
+    readonly 'status.clean': "工作区干净";
+    readonly 'status.conflict': "有冲突文件";
+    readonly 'error.notRepository': "当前工作区不是 git 仓库";
+    readonly 'error.notInstalled': "本机没有可用的 git 命令";
+    readonly 'error.timeout': "git 命令超时";
+    readonly 'error.noRoute': "这个会话还没有模型路由，先发出一轮对话再试";
+    readonly 'error.detached': "当前处于游离 HEAD，先切到一个分支再操作";
+    readonly 'error.noFiles': "请至少勾选一个文件";
+    readonly 'error.invalid': "输入不合法：{detail}";
+    readonly 'error.failed': "操作失败：{detail}";
+    readonly 'error.developMissing': "仓库里还没有 develop 分支，请先创建";
+    readonly 'error.mergeConflict': "合并时出现冲突，请先解决冲突再完成分支";
+    readonly 'error.tagExists': "标签已经存在：{detail}";
+    readonly 'error.gitflowBranchRequired': "当前分支不是功能、发布或热修复分支";
+};
+/** Both locales, in the shape `ctx.locale.register` validates. */
+export declare const gitFlowLocale: {
+    zh: {
+        readonly 'chip.tooltip': "当前分支 {branch}，{count} 个未提交改动";
+        readonly 'chip.tooltip.clean': "当前分支 {branch}，工作区干净";
+        readonly 'chip.aheadBehind': "领先 {ahead}，落后 {behind}";
+        readonly 'chip.unpushed': "有 {count} 个提交未推送";
+        readonly 'menu.search': "搜索分支";
+        readonly 'menu.local': "本地分支";
+        readonly 'menu.remote': "仅在远端";
+        readonly 'menu.empty': "没有匹配的分支";
+        readonly 'menu.loading': "读取分支…";
+        readonly 'menu.newBranch': "新建分支…";
+        readonly 'menu.commit': "提交…";
+        readonly 'menu.push': "推送提交";
+        readonly 'menu.pull': "拉取远程代码";
+        readonly 'menu.refresh': "刷新状态";
+        readonly 'menu.startFlow': "启动 Git Flow 分支…";
+        readonly 'menu.finishFlow': "完成 Git Flow 分支…";
+        readonly 'flow.feature': "功能";
+        readonly 'flow.release': "发布";
+        readonly 'flow.hotfix': "热修复";
+        readonly 'flow.badge': "{kind}";
+        readonly 'start.title': "启动 Git Flow 分支";
+        readonly 'start.description': "功能与发布分支从 {develop} 切出，热修复从 {production} 切出。";
+        readonly 'start.kind': "分支类型";
+        readonly 'start.name': "名称";
+        readonly 'start.placeholder': "例如 login，将创建 {prefix}login";
+        readonly 'start.submit': "创建并切换";
+        readonly 'start.done': "已创建并切换到 {branch}";
+        readonly 'start.needName': "请先填写名称";
+        readonly 'start.base': "将从 {base} 切出";
+        readonly 'start.versionHint': "发布与热修复的名称建议带版本号，例如 0.4.0";
+        readonly 'initDevelop.title': "还没有 {develop} 分支";
+        readonly 'initDevelop.description': "Git Flow 需要一个集成分支。将从 {from} 创建 {develop} 并切换过去。";
+        readonly 'initDevelop.submit': "创建 {develop}";
+        readonly 'initDevelop.done': "已创建 {develop}";
+        readonly 'finish.title': "完成 {branch}";
+        readonly 'finish.description': "以下动作会依次执行，合并提交与标签一旦创建就不会回滚。";
+        readonly 'finish.mergeInto': "合并到 {targets}（--no-ff）";
+        readonly 'finish.tag': "创建标签 {tag}";
+        readonly 'finish.version': "把 package.json 版本改为 {version}";
+        readonly 'finish.push': "推送分支与标签到 origin";
+        readonly 'finish.delete': "删除已完成的本地分支";
+        readonly 'finish.versionLabel': "版本号";
+        readonly 'finish.submit': "完成并合并";
+        readonly 'finish.tagExists': "标签 {tag} 已存在，请先改用其它版本号";
+        readonly 'finish.done': "已完成 {branch}";
+        readonly 'finish.partial': "{branch} 已在本地完成，但推送失败：{detail}";
+        readonly 'finish.merged': "已合并到 {targets}";
+        readonly 'finish.tagCreated': "已创建标签 {tag}";
+        readonly 'finish.versionWritten': "已提交版本号 {version}";
+        readonly 'finish.deleted': "已删除本地分支";
+        readonly 'finish.pushFail': "推送失败：{detail}";
+        readonly 'checkout.done': "已切换到 {branch}";
+        readonly 'checkout.dirtyTitle': "工作区有未提交改动";
+        readonly 'checkout.dirtyBody': "切换到 {branch} 会覆盖本地改动。可以先提交，或者强制切换（`git switch --force` 会丢弃全部本地改动）。";
+        readonly 'checkout.force': "强制切换";
+        readonly 'create.title': "新建分支";
+        readonly 'create.description': "基于当前分支 {branch} 创建并切换。";
+        readonly 'create.name': "分支名称";
+        readonly 'create.placeholder': "例如 feature/git-flow";
+        readonly 'create.submit': "创建并切换";
+        readonly 'create.done': "已创建并切换到 {branch}";
+        readonly 'commit.title': "提交改动";
+        readonly 'commit.description': "只提交勾选的文件；提交信息可由模型生成，也可以自己写。";
+        readonly 'commit.files': "改动文件";
+        readonly 'commit.selectAll': "全部 {count} 个文件";
+        readonly 'commit.message': "提交信息";
+        readonly 'commit.messageLanguage': "提交信息语言";
+        readonly 'commit.messagePlaceholder': "第一行写成 feat: 描述，空一行后可以补充要点";
+        readonly 'commit.generate': "生成提交信息";
+        readonly 'commit.regenerate': "重新生成";
+        readonly 'commit.generating': "正在生成…";
+        readonly 'commit.push': "推送";
+        readonly 'commit.commit': "提交";
+        readonly 'commit.commitPush': "提交并推送";
+        readonly 'commit.cancel': "取消";
+        readonly 'commit.discard': "放弃更改";
+        readonly 'commit.discardTitle': "放弃这些文件的改动？";
+        readonly 'commit.discardBody': "将把 {count} 个文件恢复到 HEAD：已跟踪的改动被丢弃，未跟踪的文件会被删除。此操作无法撤销。";
+        readonly 'commit.discardDone': "已放弃 {count} 个文件的改动";
+        readonly 'commit.discardOne': "放弃「{path}」的改动";
+        readonly 'commit.resize': "拖动调整面板宽度";
+        readonly 'commit.none': "还没有勾选文件";
+        readonly 'commit.needMessage': "请先填写提交信息";
+        readonly 'commit.selected': "已选 {count} 个文件";
+        readonly 'commit.noUpstream': "当前分支还没有上游，首次推送会自动建立";
+        readonly 'commit.fallback': "模型没有给出可用信息，已填入模板，可自行修改";
+        readonly 'commit.staleHost': "语言选择没生效：宿主进程还是旧版本，重启 dsh web 后再试";
+        readonly 'commit.fallbackReason': "模型没有给出可用信息（{detail}），已填入模板，可自行修改";
+        readonly 'commit.done': "已提交 {hash}";
+        readonly 'commit.pushDone': "已提交并推送 {hash}";
+        readonly 'commit.pushFail': "已提交 {hash}，但推送失败";
+        readonly 'push.done': "已推送 {branch}";
+        readonly 'pull.done': "已拉取 {branch}";
+        readonly 'status.clean': "工作区干净";
+        readonly 'status.conflict': "有冲突文件";
+        readonly 'error.notRepository': "当前工作区不是 git 仓库";
+        readonly 'error.notInstalled': "本机没有可用的 git 命令";
+        readonly 'error.timeout': "git 命令超时";
+        readonly 'error.noRoute': "这个会话还没有模型路由，先发出一轮对话再试";
+        readonly 'error.detached': "当前处于游离 HEAD，先切到一个分支再操作";
+        readonly 'error.noFiles': "请至少勾选一个文件";
+        readonly 'error.invalid': "输入不合法：{detail}";
+        readonly 'error.failed': "操作失败：{detail}";
+        readonly 'error.developMissing': "仓库里还没有 develop 分支，请先创建";
+        readonly 'error.mergeConflict': "合并时出现冲突，请先解决冲突再完成分支";
+        readonly 'error.tagExists': "标签已经存在：{detail}";
+        readonly 'error.gitflowBranchRequired': "当前分支不是功能、发布或热修复分支";
+    };
+    en: Record<"chip.tooltip" | "chip.tooltip.clean" | "chip.aheadBehind" | "chip.unpushed" | "menu.search" | "menu.local" | "menu.remote" | "menu.empty" | "menu.loading" | "menu.newBranch" | "menu.commit" | "menu.push" | "menu.pull" | "menu.refresh" | "menu.startFlow" | "menu.finishFlow" | "flow.feature" | "flow.release" | "flow.hotfix" | "flow.badge" | "start.title" | "start.description" | "start.kind" | "start.name" | "start.placeholder" | "start.submit" | "start.done" | "start.needName" | "start.base" | "start.versionHint" | "initDevelop.title" | "initDevelop.description" | "initDevelop.submit" | "initDevelop.done" | "finish.title" | "finish.description" | "finish.mergeInto" | "finish.tag" | "finish.version" | "finish.push" | "finish.delete" | "finish.versionLabel" | "finish.submit" | "finish.tagExists" | "finish.done" | "finish.partial" | "finish.merged" | "finish.tagCreated" | "finish.versionWritten" | "finish.deleted" | "finish.pushFail" | "checkout.done" | "checkout.dirtyTitle" | "checkout.dirtyBody" | "checkout.force" | "create.title" | "create.description" | "create.name" | "create.placeholder" | "create.submit" | "create.done" | "commit.title" | "commit.description" | "commit.files" | "commit.selectAll" | "commit.message" | "commit.messageLanguage" | "commit.messagePlaceholder" | "commit.generate" | "commit.regenerate" | "commit.generating" | "commit.push" | "commit.commit" | "commit.commitPush" | "commit.cancel" | "commit.discard" | "commit.discardTitle" | "commit.discardBody" | "commit.discardDone" | "commit.discardOne" | "commit.resize" | "commit.none" | "commit.needMessage" | "commit.selected" | "commit.noUpstream" | "commit.fallback" | "commit.staleHost" | "commit.fallbackReason" | "commit.done" | "commit.pushDone" | "commit.pushFail" | "push.done" | "pull.done" | "status.clean" | "status.conflict" | "error.notRepository" | "error.notInstalled" | "error.timeout" | "error.noRoute" | "error.detached" | "error.noFiles" | "error.invalid" | "error.failed" | "error.developMissing" | "error.mergeConflict" | "error.tagExists" | "error.gitflowBranchRequired", string>;
+};
+/** Every copy key of the `gitFlow` namespace. */
+export type GitFlowKey = keyof typeof zh;
+export {};

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

@@ -0,0 +1,12 @@
+/**
+ * The one stylesheet this plugin needs. Inline styles cannot reach inside the
+ * primitive components (the checkbox labels its own text, the modal card owns
+ * its width), so the few rules that must cross that boundary live here and are
+ * installed once per client fiber.
+ * @module dsh-git-flow/client/styles
+ */
+/**
+ * Install the stylesheet for this fiber.
+ * @returns a disposer removing the style element.
+ */
+export declare function installStyles(): () => void;

package/lib/types/contract.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Wire contract shared by the node half (implementations) and the browser half
+ * (fetch calls). Types only — importing this module never pulls runtime code
+ * into either bundle.
+ * @module dsh-git-flow/contract
+ */
+/** Structured failure codes, mirrored by the browser dictionary. */
+export type GitErrorCode = 'git/not-installed' | 'git/not-a-repository' | 'git/timeout' | 'git/failed' | 'git/dirty-worktree' | 'git/detached-head' | 'git/invalid-input' | 'git/no-files-selected' | 'git/no-route' | 'git/develop-missing' | 'git/merge-conflict' | 'git/tag-exists' | 'git/gitflow-branch-required';
+/** One changed path, as rendered in the commit panel. */
+export interface GitFileView {
+    /** Repository-relative path; the new name for a rename. */
+    path: string;
+    /** Previous name, present only for a rename. */
+    oldPath?: string;
+    /** Index-vs-HEAD status code, `'.'` when clean there. */
+    indexStatus: string;
+    /** Worktree-vs-index status code, `'.'` when clean there. */
+    worktreeStatus: string;
+    /** True when the path already has staged content. */
+    staged: boolean;
+    /** True for untracked paths. */
+    untracked: boolean;
+    /** True for unresolved conflicts. */
+    conflicted: boolean;
+}
+/** `GET /api/dsh-git-flow/status`. */
+export interface GitStatusView {
+    /** Repository top level, display only. */
+    repo: string;
+    /** Branch name, or `'(detached)'` / `'(unknown)'`. */
+    head: string;
+    detached: boolean;
+    upstream?: string;
+    ahead: number;
+    behind: number;
+    dirty: boolean;
+    files: GitFileView[];
+}
+/** One local branch row. */
+export interface GitBranchView {
+    name: string;
+    current: boolean;
+    upstream?: string;
+    /** True when only a remote-tracking ref carries this name. */
+    remoteOnly: boolean;
+}
+/** `GET /api/dsh-git-flow/branches`. */
+export interface GitBranchesView {
+    head: string;
+    local: GitBranchView[];
+    /** Remote-tracking branches, minus the symbolic `HEAD` pointers. */
+    remote: string[];
+}
+/** `POST /api/dsh-git-flow/commit`. */
+export interface GitCommitView {
+    hash: string;
+    shortHash: string;
+    branch: string;
+    files: number;
+    pushed: boolean;
+    pushNote?: string;
+}
+/** `POST /api/dsh-git-flow/push`. */
+export interface GitPushView {
+    pushed: boolean;
+    /** git's own summary, trimmed to its last lines. */
+    pushNote: string;
+}
+/** `POST /api/dsh-git-flow/pull`. */
+export interface GitPullView {
+    pulled: boolean;
+    /** git's own summary, trimmed to its last lines. */
+    pullNote: string;
+}
+/** `POST /api/dsh-git-flow/generate-message`. */
+export interface GitMessageView {
+    message: string;
+    /** True when the model produced nothing usable and the template was used. */
+    fallback: boolean;
+    /** Why the model answer was unusable: its failure, or a rejected shape. */
+    reason?: string;
+    /**
+     * Language the message was actually written in. Absent on a host older than
+     * the language option, which is how the panel notices a stale host process.
+     */
+    language?: MessageLanguage;
+    /** Route used, so a stale model choice is diagnosable. */
+    route?: string;
+}
+/** Language of an AI-written commit message. */
+export type MessageLanguage = 'zh' | 'en';
+/** The three branch families of a git-flow workflow. */
+export type GitFlowKind = 'feature' | 'release' | 'hotfix';
+/** Where the flow branches live and what they are called. */
+export interface GitFlowConfigView {
+    production: string;
+    develop: string;
+    featurePrefix: string;
+    releasePrefix: string;
+    hotfixPrefix: string;
+    tagPrefix: string;
+}
+/** `GET /api/dsh-git-flow/gitflow`. */
+export interface GitFlowStateView {
+    /** Branch facts the panel needs to decide what is offered. */
+    head: string;
+    detached: boolean;
+    /** Flow family the current branch belongs to, when its name matches a prefix. */
+    kind?: GitFlowKind;
+    /** The current branch's own name within its family, e.g. `login` for `feature/login`. */
+    slug?: string;
+    /** Version parsed from a release/hotfix branch name, when it carries one. */
+    version?: string;
+    /** True when the develop branch exists locally or on a remote. */
+    hasDevelop: boolean;
+    /** True when a production branch exists locally or on a remote. */
+    hasProduction: boolean;
+    /** Commits the current branch has that its finish target lacks. */
+    ahead: number;
+    /** Name a release/hotfix finish would tag, e.g. `v0.4.0`. */
+    tagName?: string;
+    /** True when that tag already exists, in which case finish must refuse. */
+    tagExists: boolean;
+    branches: GitFlowConfigView;
+}
+/** `POST /api/dsh-git-flow/gitflow/start`. */
+export interface GitFlowStartRequest {
+    sessionId: string;
+    kind: GitFlowKind;
+    /** Branch name inside the family; the prefix is added by the host. */
+    name: string;
+}
+/** `POST /api/dsh-git-flow/gitflow/init-develop`. */
+export interface GitFlowInitRequest {
+    sessionId: string;
+}
+/** `POST /api/dsh-git-flow/gitflow/finish`. */
+export interface GitFlowFinishRequest {
+    sessionId: string;
+    /** Release/hotfix only: set `package.json` to this version before tagging. */
+    version?: string;
+}
+/** One step of a finish run, so the panel can report exactly what landed. */
+export interface GitFlowStepView {
+    /** Stable step id: `merge`, `tag`, `version`, `push`, `delete`. */
+    id: string;
+    /** Human-readable outcome, already localized on the host side by the caller. */
+    detail: string;
+    ok: boolean;
+}
+/** `POST /api/dsh-git-flow/gitflow/finish`. */
+export interface GitFlowFinishView {
+    kind: GitFlowKind;
+    branch: string;
+    /** Branches the finished branch was merged into, in order. */
+    mergedInto: string[];
+    /** Annotated tag created, for release and hotfix. */
+    tag?: string;
+    /** Version written to `package.json`, when one exists at the root. */
+    version?: string;
+    /** Commits and tags git confirmed as pushed. */
+    pushed: string[];
+    /** True when the finished branch was deleted. */
+    deleted: boolean;
+    /** Steps that did not complete; the run stops at the first one. */
+    failure?: GitFlowStepView;
+}
+/** Envelope every route answers with. */
+export type GitResponse<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    code: GitErrorCode;
+    message: string;
+};
+/** Request bodies. */
+export interface CheckoutRequest {
+    sessionId: string;
+    name: string;
+    force?: boolean;
+}
+export interface CreateBranchRequest {
+    sessionId: string;
+    name: string;
+    base?: string;
+}
+export interface CommitRequest {
+    sessionId: string;
+    files: string[];
+    message: string;
+    push?: boolean;
+}
+/** `POST /api/dsh-git-flow/discard`: throw the selected paths back to HEAD. */
+export interface DiscardRequest {
+    sessionId: string;
+    files: string[];
+}
+export interface GenerateMessageRequest {
+    sessionId: string;
+    files: string[];
+    /** Overrides the configured `messageLanguage` for this call. */
+    language?: MessageLanguage;
+}
+export interface PushRequest {
+    sessionId: string;
+}