@loopstack/github-integration 0.2.0

package/dist/github-integration.module.d.ts

@@ -0,0 +1,3 @@
+export declare class GitHubIntegrationModule {
+}
+//# sourceMappingURL=github-integration.module.d.ts.map

package/dist/github-integration.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-integration.module.d.ts","sourceRoot":"","sources":["../src/github-integration.module.ts"],"names":[],"mappings":"AASA,qBAKa,uBAAuB;CAAG"}

package/dist/github-integration.module.js

@@ -0,0 +1,28 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubIntegrationModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@loopstack/core");
+const git_module_1 = require("@loopstack/git-module");
+const github_module_1 = require("@loopstack/github-module");
+const hitl_1 = require("@loopstack/hitl");
+const oauth_module_1 = require("@loopstack/oauth-module");
+const remote_client_1 = require("@loopstack/remote-client");
+const connect_github_workflow_1 = require("./workflows/connect-github/connect-github.workflow");
+let GitHubIntegrationModule = class GitHubIntegrationModule {
+};
+exports.GitHubIntegrationModule = GitHubIntegrationModule;
+exports.GitHubIntegrationModule = GitHubIntegrationModule = __decorate([
+    (0, common_1.Module)({
+        imports: [core_1.LoopCoreModule, git_module_1.GitModule, github_module_1.GitHubModule, hitl_1.HitlModule, oauth_module_1.OAuthModule, remote_client_1.RemoteClientModule],
+        providers: [connect_github_workflow_1.ConnectGitHubWorkflow],
+        exports: [connect_github_workflow_1.ConnectGitHubWorkflow],
+    })
+], GitHubIntegrationModule);
+//# sourceMappingURL=github-integration.module.js.map

package/dist/github-integration.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-integration.module.js","sourceRoot":"","sources":["../src/github-integration.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,0CAAiD;AACjD,sDAAkD;AAClD,4DAAwD;AACxD,0CAA6C;AAC7C,0DAAsD;AACtD,4DAA8D;AAC9D,gGAA2F;AAOpF,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CAAG,CAAA;AAA1B,0DAAuB;kCAAvB,uBAAuB;IALnC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAc,EAAE,sBAAS,EAAE,4BAAY,EAAE,iBAAU,EAAE,0BAAW,EAAE,kCAAkB,CAAC;QAC/F,SAAS,EAAE,CAAC,+CAAqB,CAAC;QAClC,OAAO,EAAE,CAAC,+CAAqB,CAAC;KACjC,CAAC;GACW,uBAAuB,CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './workflows';
+export * from './github-integration.module';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./workflows"), exports);
+__exportStar(require("./github-integration.module"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,8DAA4C"}

package/dist/workflows/connect-github/connect-github.ui.yaml

@@ -0,0 +1,5 @@
+title: 'Connect to GitHub'
+
+description: |
+  Connects your workspace to a GitHub repository.
+  Authenticates with GitHub, lets you create or link a repo, and configures git push access.

package/dist/workflows/connect-github/connect-github.workflow.d.ts

@@ -0,0 +1,88 @@
+import { BaseWorkflow } from '@loopstack/common';
+import { AskUserWorkflow } from '@loopstack/hitl';
+import { OAuthWorkflow } from '@loopstack/oauth-module';
+interface GitHubUser {
+    login: string;
+    name: string | null;
+    email: string | null;
+}
+interface GitHubRepo {
+    fullName: string;
+    name: string;
+    htmlUrl: string;
+    private: boolean;
+    defaultBranch: string;
+}
+export declare class ConnectGitHubWorkflow extends BaseWorkflow {
+    private gitHubGetAuthenticatedUser;
+    private gitHubCreateRepo;
+    private gitHubListRepos;
+    private gitRemoteConfigure;
+    private gitConfigUser;
+    private gitStatus;
+    private gitPush;
+    private gitFetch;
+    private bash;
+    oAuth: OAuthWorkflow;
+    askUser: AskUserWorkflow;
+    private tokenStore;
+    private clientMessageService;
+    private getGitHubToken;
+    requiresAuth?: boolean;
+    user?: GitHubUser;
+    repo?: GitHubRepo;
+    isNewRepo?: boolean;
+    divergenceState?: 'none' | 'local_ahead' | 'remote_ahead' | 'diverged';
+    start(): Promise<void>;
+    launchOAuth(): Promise<void>;
+    private needsAuth;
+    authCompleted(payload: {
+        workflowId: string;
+    }): Promise<void>;
+    askCreateOrLink(): Promise<void>;
+    choiceReceived(payload: {
+        data: {
+            answer: string;
+        };
+    }): Promise<void>;
+    createRepo(payload: {
+        data: {
+            answer: string;
+        };
+    }): Promise<void>;
+    repoSelected(payload: {
+        data: {
+            answer: string;
+        };
+    }): Promise<void>;
+    hasUncommittedChanges?: boolean;
+    checkForUncommittedChanges(): Promise<void>;
+    skipCommitCheck(): Promise<void>;
+    private isCleanWorkspace;
+    askCommitChanges(): Promise<void>;
+    uncommittedChangesHandled(payload: {
+        data: {
+            answer: string;
+        };
+    }): Promise<void>;
+    setupRemote(): Promise<void>;
+    pushDirectly(): Promise<void>;
+    private canPushDirectly;
+    askSyncStrategy(): Promise<void>;
+    syncStrategyChosen(payload: {
+        data: {
+            answer: string;
+        };
+    }): Promise<void>;
+    showSuccess(): Promise<{
+        cancelled: boolean;
+        repo?: undefined;
+        url?: undefined;
+    } | {
+        repo: string;
+        url: string;
+        cancelled?: undefined;
+    }>;
+}
+export {};
+//# sourceMappingURL=connect-github.workflow.d.ts.map

package/dist/workflows/connect-github/connect-github.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-github.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/connect-github/connect-github.workflow.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EAYb,MAAM,mBAAmB,CAAC;AAU3B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAmB,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGzE,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAIa,qBAAsB,SAAQ,YAAY;IACvC,OAAO,CAAC,0BAA0B,CAAiC;IACnE,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,kBAAkB,CAAyB;IACnD,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,IAAI,CAAW;IAEnB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IAEjC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,oBAAoB,CAAuB;YAE/C,cAAc;IAI5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,CAAC;IAKjE,KAAK;IAUL,WAAW;IAkBjB,OAAO,CAAC,SAAS;IAKX,aAAa,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;IAqB7C,eAAe;IAkBf,cAAc,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IA0CpD,UAAU,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IAqBhD,YAAY,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IAsBxD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAG1B,0BAA0B;IAwB1B,eAAe;IAErB,OAAO,CAAC,gBAAgB;IAMlB,gBAAgB;IAmBhB,yBAAyB,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IAmB/D,WAAW;IA8CX,YAAY;IAYlB,OAAO,CAAC,eAAe;IAOjB,eAAe;IA4Bf,kBAAkB,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IA6BxD,WAAW;;;;;;;;;CAqBlB"}

package/dist/workflows/connect-github/connect-github.workflow.js

@@ -0,0 +1,414 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectGitHubWorkflow = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const common_2 = require("@loopstack/common");
+const core_1 = require("@loopstack/core");
+const git_module_1 = require("@loopstack/git-module");
+const github_module_1 = require("@loopstack/github-module");
+const hitl_1 = require("@loopstack/hitl");
+const oauth_module_1 = require("@loopstack/oauth-module");
+const remote_client_1 = require("@loopstack/remote-client");
+let ConnectGitHubWorkflow = class ConnectGitHubWorkflow extends common_2.BaseWorkflow {
+    gitHubGetAuthenticatedUser;
+    gitHubCreateRepo;
+    gitHubListRepos;
+    gitRemoteConfigure;
+    gitConfigUser;
+    gitStatus;
+    gitPush;
+    gitFetch;
+    bash;
+    oAuth;
+    askUser;
+    tokenStore;
+    clientMessageService;
+    async getGitHubToken() {
+        return (await this.tokenStore.getValidAccessToken(this.ctx.context.userId, 'github')) ?? undefined;
+    }
+    requiresAuth;
+    user;
+    repo;
+    isNewRepo;
+    divergenceState;
+    async start() {
+        const result = await this.gitHubGetAuthenticatedUser.call({});
+        this.requiresAuth = result.data.error === 'unauthorized';
+        this.user = result.data.user;
+    }
+    async launchOAuth() {
+        const result = await this.oAuth.run({ provider: 'github', scopes: ['repo', 'user'] }, { alias: 'oAuth', callback: { transition: 'authCompleted' } });
+        await this.repository.save(common_2.LinkDocument, {
+            label: 'Sign in with GitHub',
+            workflowId: result.workflowId,
+            embed: true,
+            expanded: true,
+        }, { id: `link_${result.workflowId}` });
+    }
+    needsAuth() {
+        return !!this.requiresAuth;
+    }
+    async authCompleted(payload) {
+        await this.repository.save(common_2.LinkDocument, {
+            status: 'success',
+            label: 'GitHub authentication completed',
+            workflowId: payload.workflowId,
+            embed: true,
+            expanded: false,
+        }, { id: `link_${payload.workflowId}` });
+        const result = await this.gitHubGetAuthenticatedUser.call({});
+        this.user = result.data.user;
+        this.requiresAuth = false;
+    }
+    async askCreateOrLink() {
+        const result = await this.askUser.run({
+            question: 'Would you like to create a new GitHub repository or connect an existing one?',
+            mode: 'options',
+            options: ['Create new repository', 'Connect existing repository'],
+        }, { alias: 'chooseAction', callback: { transition: 'choiceReceived' } });
+        await this.repository.save(common_2.LinkDocument, { label: 'Create or connect repository', workflowId: result.workflowId, embed: true, expanded: true }, { id: `link_choice` });
+    }
+    async choiceReceived(payload) {
+        await this.repository.save(common_2.LinkDocument, { label: 'Create or connect repository', status: 'success', embed: true, expanded: false }, { id: `link_choice` });
+        if (payload.data.answer === 'Connect existing repository') {
+            const listResult = await this.gitHubListRepos.call({ visibility: 'all', sort: 'updated', perPage: 30 });
+            const repos = listResult.data.repos ?? [];
+            const repoNames = repos.map((r) => r.fullName);
+            const askResult = await this.askUser.run({ question: 'Select a repository to connect:', mode: 'options', options: repoNames }, { alias: 'chooseRepo', callback: { transition: 'repoSelected' } });
+            await this.repository.save(common_2.LinkDocument, { label: 'Select repository', workflowId: askResult.workflowId, embed: true, expanded: true }, { id: `link_repo_select` });
+        }
+        else {
+            const askResult = await this.askUser.run({ question: 'Enter a name for your new repository:' }, { alias: 'repoName', callback: { transition: 'createRepo' } });
+            await this.repository.save(common_2.LinkDocument, { label: 'Repository name', workflowId: askResult.workflowId, embed: true, expanded: true }, { id: `link_repo_name` });
+        }
+    }
+    async createRepo(payload) {
+        await this.repository.save(common_2.LinkDocument, { label: 'Repository name', status: 'success', embed: true, expanded: false }, { id: `link_repo_name` });
+        const repoName = payload.data.answer.trim();
+        const createResult = await this.gitHubCreateRepo.call({
+            name: repoName,
+            private: true,
+            autoInit: false,
+        });
+        this.repo = createResult.data.repo;
+        this.isNewRepo = true;
+    }
+    async repoSelected(payload) {
+        await this.repository.save(common_2.LinkDocument, { label: 'Select repository', status: 'success', embed: true, expanded: false }, { id: `link_repo_select` });
+        const fullName = payload.data.answer;
+        const [, name] = fullName.split('/');
+        this.repo = {
+            fullName,
+            name,
+            htmlUrl: `https://github.com/${fullName}`,
+            private: false,
+            defaultBranch: 'main',
+        };
+        this.isNewRepo = false;
+    }
+    hasUncommittedChanges;
+    async checkForUncommittedChanges() {
+        const user = this.user;
+        if (user) {
+            await this.gitConfigUser.call({
+                name: user.name || user.login,
+                email: user.email || `${user.login}@users.noreply.github.com`,
+            });
+        }
+        const statusResult = await this.gitStatus.call();
+        const status = statusResult.data;
+        this.hasUncommittedChanges =
+            status.staged.length > 0 ||
+                status.modified.length > 0 ||
+                status.untracked.length > 0 ||
+                status.deleted.length > 0;
+    }
+    async skipCommitCheck() { }
+    isCleanWorkspace() {
+        return !this.hasUncommittedChanges;
+    }
+    async askCommitChanges() {
+        const confirmResult = await this.askUser.run({
+            question: 'There are uncommitted changes in your workspace. They need to be committed before connecting to a remote repository. Would you like to commit them now?',
+            mode: 'options',
+            options: ['Commit changes and continue', 'Cancel'],
+        }, { alias: 'commitChanges', callback: { transition: 'uncommittedChangesHandled' } });
+        await this.repository.save(common_2.LinkDocument, { label: 'Uncommitted changes', workflowId: confirmResult.workflowId, embed: true, expanded: true }, { id: `link_uncommitted` });
+    }
+    async uncommittedChangesHandled(payload) {
+        await this.repository.save(common_2.LinkDocument, { label: 'Uncommitted changes', status: 'success', embed: true, expanded: false }, { id: `link_uncommitted` });
+        if (payload.data.answer === 'Cancel') {
+            this.repo = undefined;
+            return;
+        }
+        await this.bash.call({ command: 'git add -A' });
+        await this.bash.call({ command: 'git commit -m "Auto-commit before connecting to GitHub"' });
+    }
+    async setupRemote() {
+        if (!this.repo) {
+            this.divergenceState = 'none';
+            return;
+        }
+        const repo = this.repo;
+        const remoteUrl = `https://github.com/${repo.fullName}.git`;
+        await this.gitRemoteConfigure.call({ url: remoteUrl });
+        const token = await this.getGitHubToken();
+        await this.gitFetch.call({ remote: 'origin', token });
+        if (!this.isNewRepo) {
+            const checkResult = (await this.bash.call({
+                command: [
+                    'REMOTE_EXISTS=$(git rev-parse --verify origin/main 2>/dev/null && echo yes || echo no)',
+                    'if [ "$REMOTE_EXISTS" = "no" ]; then echo "no_remote"; exit 0; fi',
+                    'LOCAL=$(git rev-parse main)',
+                    'REMOTE=$(git rev-parse origin/main)',
+                    'if [ "$LOCAL" = "$REMOTE" ]; then echo "same"; exit 0; fi',
+                    'git merge-base --is-ancestor main origin/main && echo "remote_ahead" && exit 0',
+                    'git merge-base --is-ancestor origin/main main && echo "local_ahead" && exit 0',
+                    'echo "diverged"',
+                ].join(' && '),
+            }));
+            const state = checkResult.data.stdout.trim().split('\n').pop().trim();
+            if (state === 'same' || state === 'no_remote') {
+                this.divergenceState = 'none';
+            }
+            else {
+                this.divergenceState = state;
+            }
+        }
+        else {
+            this.divergenceState = 'none';
+        }
+    }
+    async pushDirectly() {
+        if (this.divergenceState === 'none') {
+            return;
+        }
+        const statusResult = await this.gitStatus.call();
+        const branch = statusResult.data.branch ?? 'main';
+        const token = await this.getGitHubToken();
+        await this.gitPush.call({ remote: 'origin', branch, token });
+    }
+    canPushDirectly() {
+        return this.divergenceState === 'none' || this.divergenceState === 'local_ahead';
+    }
+    async askSyncStrategy() {
+        const isRemoteAhead = this.divergenceState === 'remote_ahead';
+        const question = isRemoteAhead
+            ? 'The remote repository has newer commits than your workspace. How would you like to proceed?'
+            : 'The remote repository has a different commit history than your workspace. How would you like to proceed?';
+        const options = isRemoteAhead
+            ? ['Pull remote changes into workspace', 'Push workspace code (overwrite remote)', 'Cancel (disconnect remote)']
+            : [
+                'Use remote code (replace local files with remote)',
+                'Merge remote changes into workspace',
+                'Push workspace code (overwrite remote)',
+                'Cancel (disconnect remote)',
+            ];
+        const result = await this.askUser.run({ question, mode: 'options', options }, { alias: 'syncStrategy', callback: { transition: 'syncStrategyChosen' } });
+        await this.repository.save(common_2.LinkDocument, { label: 'Resolve differences', workflowId: result.workflowId, embed: true, expanded: true }, { id: `link_sync` });
+    }
+    async syncStrategyChosen(payload) {
+        await this.repository.save(common_2.LinkDocument, { label: 'Resolve differences', status: 'success', embed: true, expanded: false }, { id: `link_sync` });
+        const answer = payload.data.answer;
+        const statusResult = await this.gitStatus.call();
+        const branch = statusResult.data.branch ?? 'main';
+        const token = await this.getGitHubToken();
+        if (answer.startsWith('Use remote code')) {
+            await this.bash.call({ command: `git reset --hard origin/${branch}` });
+        }
+        else if (answer.startsWith('Pull remote changes') || answer.startsWith('Merge remote changes')) {
+            await this.bash.call({ command: `git merge origin/${branch} --allow-unrelated-histories --no-edit` });
+            await this.gitPush.call({ remote: 'origin', branch, token });
+        }
+        else if (answer.startsWith('Push workspace code')) {
+            await this.gitPush.call({ remote: 'origin', branch, force: true, token });
+        }
+        else {
+            await this.bash.call({ command: 'git remote remove origin' });
+            this.repo = undefined;
+        }
+    }
+    async showSuccess() {
+        if (!this.repo) {
+            await this.repository.save(common_2.MarkdownDocument, {
+                markdown: '### Cancelled\n\nThe remote connection was removed. No changes were made.',
+            });
+            return { cancelled: true };
+        }
+        const repo = this.repo;
+        await this.repository.save(common_2.MarkdownDocument, {
+            markdown: `### Repository Connected\n\nYour workspace is now connected to [${repo.fullName}](${repo.htmlUrl}).\n\nAll future commits can be pushed to this repository using the git tools in your workflows.`,
+        });
+        this.clientMessageService.dispatchWorkspaceEvent('git.updated', this.ctx.context.workspaceId, this.ctx.context.userId);
+        return { repo: repo.fullName, url: repo.htmlUrl };
+    }
+};
+exports.ConnectGitHubWorkflow = ConnectGitHubWorkflow;
+__decorate([
+    (0, common_2.InjectTool)(),
+    __metadata("design:type", github_module_1.GitHubGetAuthenticatedUserTool)
+], ConnectGitHubWorkflow.prototype, "gitHubGetAuthenticatedUser", void 0);
+__decorate([
+    (0, common_2.InjectTool)(),
+    __metadata("design:type", github_module_1.GitHubCreateRepoTool)
+], ConnectGitHubWorkflow.prototype, "gitHubCreateRepo", void 0);
+__decorate([
+    (0, common_2.InjectTool)(),
+    __metadata("design:type", github_module_1.GitHubListReposTool)
+], ConnectGitHubWorkflow.prototype, "gitHubListRepos", void 0);
+__decorate([
+    (0, common_2.InjectTool)(),
+    __metadata("design:type", git_module_1.GitRemoteConfigureTool)
+], ConnectGitHubWorkflow.prototype, "gitRemoteConfigure", void 0);
+__decorate([
+    (0, common_2.InjectTool)(),
+    __metadata("design:type", git_module_1.GitConfigUserTool)
+], ConnectGitHubWorkflow.prototype, "gitConfigUser", void 0);
+__decorate([
+    (0, common_2.InjectTool)(),
+    __metadata("design:type", git_module_1.GitStatusTool)
+], ConnectGitHubWorkflow.prototype, "gitStatus", void 0);
+__decorate([
+    (0, common_2.InjectTool)(),
+    __metadata("design:type", git_module_1.GitPushTool)
+], ConnectGitHubWorkflow.prototype, "gitPush", void 0);
+__decorate([
+    (0, common_2.InjectTool)(),
+    __metadata("design:type", git_module_1.GitFetchTool)
+], ConnectGitHubWorkflow.prototype, "gitFetch", void 0);
+__decorate([
+    (0, common_2.InjectTool)(),
+    __metadata("design:type", remote_client_1.BashTool)
+], ConnectGitHubWorkflow.prototype, "bash", void 0);
+__decorate([
+    (0, common_2.InjectWorkflow)(),
+    __metadata("design:type", oauth_module_1.OAuthWorkflow)
+], ConnectGitHubWorkflow.prototype, "oAuth", void 0);
+__decorate([
+    (0, common_2.InjectWorkflow)(),
+    __metadata("design:type", hitl_1.AskUserWorkflow)
+], ConnectGitHubWorkflow.prototype, "askUser", void 0);
+__decorate([
+    (0, common_1.Inject)(),
+    __metadata("design:type", oauth_module_1.OAuthTokenStore)
+], ConnectGitHubWorkflow.prototype, "tokenStore", void 0);
+__decorate([
+    (0, common_1.Inject)(),
+    __metadata("design:type", core_1.ClientMessageService)
+], ConnectGitHubWorkflow.prototype, "clientMessageService", void 0);
+__decorate([
+    (0, common_2.Initial)({ to: 'check_auth' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "start", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'check_auth', to: 'awaiting_auth', priority: 10 }),
+    (0, common_2.Guard)('needsAuth'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "launchOAuth", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'awaiting_auth', to: 'check_auth', wait: true, schema: common_2.CallbackSchema }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "authCompleted", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'check_auth', to: 'awaiting_choice' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "askCreateOrLink", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'awaiting_choice', to: 'route_choice', wait: true, schema: common_2.CallbackSchema }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "choiceReceived", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'route_choice', to: 'configure_remote', wait: true, schema: common_2.CallbackSchema }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "createRepo", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'route_choice', to: 'configure_remote', wait: true, schema: common_2.CallbackSchema }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "repoSelected", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'configure_remote', to: 'check_uncommitted' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "checkForUncommittedChanges", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'check_uncommitted', to: 'setup_remote' }),
+    (0, common_2.Guard)('isCleanWorkspace'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "skipCommitCheck", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'check_uncommitted', to: 'awaiting_commit_confirm' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "askCommitChanges", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'awaiting_commit_confirm', to: 'setup_remote', wait: true, schema: common_2.CallbackSchema }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "uncommittedChangesHandled", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'setup_remote', to: 'check_divergence' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "setupRemote", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'check_divergence', to: 'done' }),
+    (0, common_2.Guard)('canPushDirectly'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "pushDirectly", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'check_divergence', to: 'awaiting_sync_choice' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "askSyncStrategy", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'awaiting_sync_choice', to: 'done', wait: true, schema: common_2.CallbackSchema }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "syncStrategyChosen", null);
+__decorate([
+    (0, common_2.Final)({ from: 'done' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectGitHubWorkflow.prototype, "showSuccess", null);
+exports.ConnectGitHubWorkflow = ConnectGitHubWorkflow = __decorate([
+    (0, common_2.Workflow)({
+        uiConfig: __dirname + '/connect-github.ui.yaml',
+        schema: zod_1.z.object({}).strict(),
+    })
+], ConnectGitHubWorkflow);
+//# sourceMappingURL=connect-github.workflow.js.map

package/dist/workflows/connect-github/connect-github.workflow.js.map

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

package/dist/workflows/index.d.ts

@@ -0,0 +1,2 @@
+export { ConnectGitHubWorkflow } from './connect-github/connect-github.workflow';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/workflows/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectGitHubWorkflow = void 0;
+var connect_github_workflow_1 = require("./connect-github/connect-github.workflow");
+Object.defineProperty(exports, "ConnectGitHubWorkflow", { enumerable: true, get: function () { return connect_github_workflow_1.ConnectGitHubWorkflow; } });
+//# sourceMappingURL=index.js.map

package/dist/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":";;;AAAA,oFAAiF;AAAxE,gIAAA,qBAAqB,OAAA"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@loopstack/github-integration",
+  "displayName": "Loopstack GitHub Integration",
+  "description": "GitHub integration workflows for Loopstack — connect workspaces to GitHub repositories with OAuth, push, pull, and sync",
+  "keywords": [
+    "loopstack",
+    "github",
+    "git",
+    "integration",
+    "workflow"
+  ],
+  "version": "0.2.0",
+  "license": "MIT",
+  "author": {
+    "name": "Jakob Klippel",
+    "url": "https://www.linkedin.com/in/jakob-klippel/"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./src/*": "./src/*"
+  },
+  "scripts": {
+    "build": "nest build",
+    "compile": "tsc --noEmit",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "jest --passWithNoTests",
+    "watch": "nest build --watch"
+  },
+  "dependencies": {
+    "@loopstack/common": "^0.27.0",
+    "@loopstack/core": "^0.27.0",
+    "@loopstack/git-module": "^0.1.1",
+    "@loopstack/github-module": "^0.2.3",
+    "@loopstack/hitl": "^0.1.1",
+    "@loopstack/oauth-module": "^0.2.5",
+    "@loopstack/remote-client": "^0.23.2",
+    "@nestjs/common": "^11.1.19",
+    "zod": "^4.3.6"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.ts$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node",
+    "maxWorkers": 1
+  },
+  "loopstack": {
+    "modules": [
+      {
+        "path": "src/github-integration.module.ts",
+        "className": "GitHubIntegrationModule"
+      }
+    ],
+    "installModes": [
+      "add",
+      "install"
+    ]
+  }
+}

package/src/github-integration.module.ts

@@ -0,0 +1,15 @@
+import { Module } from '@nestjs/common';
+import { LoopCoreModule } from '@loopstack/core';
+import { GitModule } from '@loopstack/git-module';
+import { GitHubModule } from '@loopstack/github-module';
+import { HitlModule } from '@loopstack/hitl';
+import { OAuthModule } from '@loopstack/oauth-module';
+import { RemoteClientModule } from '@loopstack/remote-client';
+import { ConnectGitHubWorkflow } from './workflows/connect-github/connect-github.workflow';
+
+@Module({
+  imports: [LoopCoreModule, GitModule, GitHubModule, HitlModule, OAuthModule, RemoteClientModule],
+  providers: [ConnectGitHubWorkflow],
+  exports: [ConnectGitHubWorkflow],
+})
+export class GitHubIntegrationModule {}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './workflows';
+export * from './github-integration.module';

package/src/workflows/connect-github/connect-github.ui.yaml

@@ -0,0 +1,5 @@
+title: 'Connect to GitHub'
+
+description: |
+  Connects your workspace to a GitHub repository.
+  Authenticates with GitHub, lets you create or link a repo, and configures git push access.

package/src/workflows/connect-github/connect-github.workflow.ts

@@ -0,0 +1,451 @@
+import { Inject } from '@nestjs/common';
+import { z } from 'zod';
+import {
+  BaseWorkflow,
+  CallbackSchema,
+  Final,
+  Guard,
+  Initial,
+  InjectTool,
+  InjectWorkflow,
+  LinkDocument,
+  MarkdownDocument,
+  ToolResult,
+  Transition,
+  Workflow,
+} from '@loopstack/common';
+import { ClientMessageService } from '@loopstack/core';
+import {
+  GitConfigUserTool,
+  GitFetchTool,
+  GitPushTool,
+  GitRemoteConfigureTool,
+  GitStatusTool,
+} from '@loopstack/git-module';
+import { GitHubCreateRepoTool, GitHubGetAuthenticatedUserTool, GitHubListReposTool } from '@loopstack/github-module';
+import { AskUserWorkflow } from '@loopstack/hitl';
+import { OAuthTokenStore, OAuthWorkflow } from '@loopstack/oauth-module';
+import { BashTool } from '@loopstack/remote-client';
+
+interface GitHubUser {
+  login: string;
+  name: string | null;
+  email: string | null;
+}
+
+interface GitHubRepo {
+  fullName: string;
+  name: string;
+  htmlUrl: string;
+  private: boolean;
+  defaultBranch: string;
+}
+
+@Workflow({
+  uiConfig: __dirname + '/connect-github.ui.yaml',
+  schema: z.object({}).strict(),
+})
+export class ConnectGitHubWorkflow extends BaseWorkflow {
+  @InjectTool() private gitHubGetAuthenticatedUser: GitHubGetAuthenticatedUserTool;
+  @InjectTool() private gitHubCreateRepo: GitHubCreateRepoTool;
+  @InjectTool() private gitHubListRepos: GitHubListReposTool;
+  @InjectTool() private gitRemoteConfigure: GitRemoteConfigureTool;
+  @InjectTool() private gitConfigUser: GitConfigUserTool;
+  @InjectTool() private gitStatus: GitStatusTool;
+  @InjectTool() private gitPush: GitPushTool;
+  @InjectTool() private gitFetch: GitFetchTool;
+  @InjectTool() private bash: BashTool;
+
+  @InjectWorkflow() oAuth: OAuthWorkflow;
+  @InjectWorkflow() askUser: AskUserWorkflow;
+
+  @Inject() private tokenStore: OAuthTokenStore;
+  @Inject() private clientMessageService: ClientMessageService;
+
+  private async getGitHubToken(): Promise<string | undefined> {
+    return (await this.tokenStore.getValidAccessToken(this.ctx.context.userId, 'github')) ?? undefined;
+  }
+
+  requiresAuth?: boolean;
+  user?: GitHubUser;
+  repo?: GitHubRepo;
+  isNewRepo?: boolean;
+  divergenceState?: 'none' | 'local_ahead' | 'remote_ahead' | 'diverged';
+
+  // ── Step 1: Check if already authenticated ──────────────────────────
+
+  @Initial({ to: 'check_auth' })
+  async start() {
+    const result: ToolResult<{ error?: string; user?: GitHubUser }> = await this.gitHubGetAuthenticatedUser.call({});
+    this.requiresAuth = result.data!.error === 'unauthorized';
+    this.user = result.data!.user;
+  }
+
+  // ── Step 2a: OAuth if needed ────────────────────────────────────────
+
+  @Transition({ from: 'check_auth', to: 'awaiting_auth', priority: 10 })
+  @Guard('needsAuth')
+  async launchOAuth() {
+    const result = await this.oAuth.run(
+      { provider: 'github', scopes: ['repo', 'user'] },
+      { alias: 'oAuth', callback: { transition: 'authCompleted' } },
+    );
+
+    await this.repository.save(
+      LinkDocument,
+      {
+        label: 'Sign in with GitHub',
+        workflowId: result.workflowId,
+        embed: true,
+        expanded: true,
+      },
+      { id: `link_${result.workflowId}` },
+    );
+  }
+
+  private needsAuth(): boolean {
+    return !!this.requiresAuth;
+  }
+
+  @Transition({ from: 'awaiting_auth', to: 'check_auth', wait: true, schema: CallbackSchema })
+  async authCompleted(payload: { workflowId: string }) {
+    await this.repository.save(
+      LinkDocument,
+      {
+        status: 'success',
+        label: 'GitHub authentication completed',
+        workflowId: payload.workflowId,
+        embed: true,
+        expanded: false,
+      },
+      { id: `link_${payload.workflowId}` },
+    );
+
+    const result: ToolResult<{ user?: GitHubUser }> = await this.gitHubGetAuthenticatedUser.call({});
+    this.user = result.data!.user;
+    this.requiresAuth = false;
+  }
+
+  // ── Step 2b: Ask create or link ─────────────────────────────────────
+
+  @Transition({ from: 'check_auth', to: 'awaiting_choice' })
+  async askCreateOrLink() {
+    const result = await this.askUser.run(
+      {
+        question: 'Would you like to create a new GitHub repository or connect an existing one?',
+        mode: 'options',
+        options: ['Create new repository', 'Connect existing repository'],
+      },
+      { alias: 'chooseAction', callback: { transition: 'choiceReceived' } },
+    );
+
+    await this.repository.save(
+      LinkDocument,
+      { label: 'Create or connect repository', workflowId: result.workflowId, embed: true, expanded: true },
+      { id: `link_choice` },
+    );
+  }
+
+  @Transition({ from: 'awaiting_choice', to: 'route_choice', wait: true, schema: CallbackSchema })
+  async choiceReceived(payload: { data: { answer: string } }) {
+    await this.repository.save(
+      LinkDocument,
+      { label: 'Create or connect repository', status: 'success', embed: true, expanded: false },
+      { id: `link_choice` },
+    );
+
+    if (payload.data.answer === 'Connect existing repository') {
+      const listResult: ToolResult<{
+        repos: Array<{ fullName: string; name: string; htmlUrl: string; private: boolean; defaultBranch: string }>;
+      }> = await this.gitHubListRepos.call({ visibility: 'all', sort: 'updated', perPage: 30 });
+
+      const repos = listResult.data!.repos ?? [];
+      const repoNames = repos.map((r) => r.fullName);
+
+      const askResult = await this.askUser.run(
+        { question: 'Select a repository to connect:', mode: 'options', options: repoNames },
+        { alias: 'chooseRepo', callback: { transition: 'repoSelected' } },
+      );
+
+      await this.repository.save(
+        LinkDocument,
+        { label: 'Select repository', workflowId: askResult.workflowId, embed: true, expanded: true },
+        { id: `link_repo_select` },
+      );
+    } else {
+      const askResult = await this.askUser.run(
+        { question: 'Enter a name for your new repository:' },
+        { alias: 'repoName', callback: { transition: 'createRepo' } },
+      );
+
+      await this.repository.save(
+        LinkDocument,
+        { label: 'Repository name', workflowId: askResult.workflowId, embed: true, expanded: true },
+        { id: `link_repo_name` },
+      );
+    }
+  }
+
+  // ── Step 3a: Create new repo ────────────────────────────────────────
+
+  @Transition({ from: 'route_choice', to: 'configure_remote', wait: true, schema: CallbackSchema })
+  async createRepo(payload: { data: { answer: string } }) {
+    await this.repository.save(
+      LinkDocument,
+      { label: 'Repository name', status: 'success', embed: true, expanded: false },
+      { id: `link_repo_name` },
+    );
+
+    const repoName = payload.data.answer.trim();
+    const createResult: ToolResult<{ repo: GitHubRepo }> = await this.gitHubCreateRepo.call({
+      name: repoName,
+      private: true,
+      autoInit: false,
+    });
+
+    this.repo = createResult.data!.repo;
+    this.isNewRepo = true;
+  }
+
+  // ── Step 3b: Link existing repo ─────────────────────────────────────
+
+  @Transition({ from: 'route_choice', to: 'configure_remote', wait: true, schema: CallbackSchema })
+  async repoSelected(payload: { data: { answer: string } }) {
+    await this.repository.save(
+      LinkDocument,
+      { label: 'Select repository', status: 'success', embed: true, expanded: false },
+      { id: `link_repo_select` },
+    );
+
+    const fullName = payload.data.answer;
+    const [, name] = fullName.split('/');
+
+    this.repo = {
+      fullName,
+      name,
+      htmlUrl: `https://github.com/${fullName}`,
+      private: false,
+      defaultBranch: 'main',
+    };
+    this.isNewRepo = false;
+  }
+
+  // ── Step 4a: Check for uncommitted changes ───────────────────────────
+
+  hasUncommittedChanges?: boolean;
+
+  @Transition({ from: 'configure_remote', to: 'check_uncommitted' })
+  async checkForUncommittedChanges() {
+    const user = this.user;
+
+    // Configure git user identity early
+    if (user) {
+      await this.gitConfigUser.call({
+        name: user.name || user.login,
+        email: user.email || `${user.login}@users.noreply.github.com`,
+      });
+    }
+
+    const statusResult: ToolResult<{ staged: string[]; modified: string[]; untracked: string[]; deleted: string[] }> =
+      await this.gitStatus.call();
+    const status = statusResult.data!;
+    this.hasUncommittedChanges =
+      status.staged.length > 0 ||
+      status.modified.length > 0 ||
+      status.untracked.length > 0 ||
+      status.deleted.length > 0;
+  }
+
+  // Clean workspace — skip straight to remote setup
+  @Transition({ from: 'check_uncommitted', to: 'setup_remote' })
+  @Guard('isCleanWorkspace')
+  async skipCommitCheck() {}
+
+  private isCleanWorkspace(): boolean {
+    return !this.hasUncommittedChanges;
+  }
+
+  // Uncommitted changes — ask user
+  @Transition({ from: 'check_uncommitted', to: 'awaiting_commit_confirm' })
+  async askCommitChanges() {
+    const confirmResult = await this.askUser.run(
+      {
+        question:
+          'There are uncommitted changes in your workspace. They need to be committed before connecting to a remote repository. Would you like to commit them now?',
+        mode: 'options',
+        options: ['Commit changes and continue', 'Cancel'],
+      },
+      { alias: 'commitChanges', callback: { transition: 'uncommittedChangesHandled' } },
+    );
+
+    await this.repository.save(
+      LinkDocument,
+      { label: 'Uncommitted changes', workflowId: confirmResult.workflowId, embed: true, expanded: true },
+      { id: `link_uncommitted` },
+    );
+  }
+
+  @Transition({ from: 'awaiting_commit_confirm', to: 'setup_remote', wait: true, schema: CallbackSchema })
+  async uncommittedChangesHandled(payload: { data: { answer: string } }) {
+    await this.repository.save(
+      LinkDocument,
+      { label: 'Uncommitted changes', status: 'success', embed: true, expanded: false },
+      { id: `link_uncommitted` },
+    );
+
+    if (payload.data.answer === 'Cancel') {
+      this.repo = undefined;
+      return;
+    }
+
+    await this.bash.call({ command: 'git add -A' });
+    await this.bash.call({ command: 'git commit -m "Auto-commit before connecting to GitHub"' });
+  }
+
+  // ── Step 4b: Configure remote and check for divergence ──────────────
+
+  @Transition({ from: 'setup_remote', to: 'check_divergence' })
+  async setupRemote() {
+    // If cancelled during commit confirmation, skip to done
+    if (!this.repo) {
+      this.divergenceState = 'none';
+      return;
+    }
+
+    const repo = this.repo;
+
+    // Configure the remote URL (no credentials stored)
+    const remoteUrl = `https://github.com/${repo.fullName}.git`;
+    await this.gitRemoteConfigure.call({ url: remoteUrl });
+
+    // Fetch remote refs using token for auth (token only exists in memory during the command)
+    const token = await this.getGitHubToken();
+    await this.gitFetch.call({ remote: 'origin', token });
+
+    // Determine relationship between local and remote branches
+    if (!this.isNewRepo) {
+      const checkResult = (await this.bash.call({
+        command: [
+          'REMOTE_EXISTS=$(git rev-parse --verify origin/main 2>/dev/null && echo yes || echo no)',
+          'if [ "$REMOTE_EXISTS" = "no" ]; then echo "no_remote"; exit 0; fi',
+          'LOCAL=$(git rev-parse main)',
+          'REMOTE=$(git rev-parse origin/main)',
+          'if [ "$LOCAL" = "$REMOTE" ]; then echo "same"; exit 0; fi',
+          'git merge-base --is-ancestor main origin/main && echo "remote_ahead" && exit 0',
+          'git merge-base --is-ancestor origin/main main && echo "local_ahead" && exit 0',
+          'echo "diverged"',
+        ].join(' && '),
+      })) as ToolResult<{ stdout: string }>;
+      const state = checkResult.data!.stdout.trim().split('\n').pop()!.trim();
+      if (state === 'same' || state === 'no_remote') {
+        this.divergenceState = 'none';
+      } else {
+        this.divergenceState = state as 'local_ahead' | 'remote_ahead' | 'diverged';
+      }
+    } else {
+      this.divergenceState = 'none';
+    }
+  }
+
+  // ── Step 5a: No divergence or local ahead — just push ────────────────
+
+  @Transition({ from: 'check_divergence', to: 'done' })
+  @Guard('canPushDirectly')
+  async pushDirectly() {
+    if (this.divergenceState === 'none') {
+      // Already in sync — nothing to push
+      return;
+    }
+    // local_ahead — fast-forward push
+    const statusResult: ToolResult<{ branch: string }> = await this.gitStatus.call();
+    const branch = statusResult.data!.branch ?? 'main';
+    const token = await this.getGitHubToken();
+    await this.gitPush.call({ remote: 'origin', branch, token });
+  }
+
+  private canPushDirectly(): boolean {
+    return this.divergenceState === 'none' || this.divergenceState === 'local_ahead';
+  }
+
+  // ── Step 5b: Divergence detected — ask user how to resolve ──────────
+
+  @Transition({ from: 'check_divergence', to: 'awaiting_sync_choice' })
+  async askSyncStrategy() {
+    const isRemoteAhead = this.divergenceState === 'remote_ahead';
+    const question = isRemoteAhead
+      ? 'The remote repository has newer commits than your workspace. How would you like to proceed?'
+      : 'The remote repository has a different commit history than your workspace. How would you like to proceed?';
+
+    const options = isRemoteAhead
+      ? ['Pull remote changes into workspace', 'Push workspace code (overwrite remote)', 'Cancel (disconnect remote)']
+      : [
+          'Use remote code (replace local files with remote)',
+          'Merge remote changes into workspace',
+          'Push workspace code (overwrite remote)',
+          'Cancel (disconnect remote)',
+        ];
+
+    const result = await this.askUser.run(
+      { question, mode: 'options', options },
+      { alias: 'syncStrategy', callback: { transition: 'syncStrategyChosen' } },
+    );
+
+    await this.repository.save(
+      LinkDocument,
+      { label: 'Resolve differences', workflowId: result.workflowId, embed: true, expanded: true },
+      { id: `link_sync` },
+    );
+  }
+
+  @Transition({ from: 'awaiting_sync_choice', to: 'done', wait: true, schema: CallbackSchema })
+  async syncStrategyChosen(payload: { data: { answer: string } }) {
+    await this.repository.save(
+      LinkDocument,
+      { label: 'Resolve differences', status: 'success', embed: true, expanded: false },
+      { id: `link_sync` },
+    );
+
+    const answer = payload.data.answer;
+    const statusResult: ToolResult<{ branch: string }> = await this.gitStatus.call();
+    const branch = statusResult.data!.branch ?? 'main';
+
+    const token = await this.getGitHubToken();
+
+    if (answer.startsWith('Use remote code')) {
+      await this.bash.call({ command: `git reset --hard origin/${branch}` });
+    } else if (answer.startsWith('Pull remote changes') || answer.startsWith('Merge remote changes')) {
+      await this.bash.call({ command: `git merge origin/${branch} --allow-unrelated-histories --no-edit` });
+      await this.gitPush.call({ remote: 'origin', branch, token });
+    } else if (answer.startsWith('Push workspace code')) {
+      await this.gitPush.call({ remote: 'origin', branch, force: true, token });
+    } else {
+      await this.bash.call({ command: 'git remote remove origin' });
+      this.repo = undefined;
+    }
+  }
+
+  // ── Final: Show result ──────────────────────────────────────────────
+
+  @Final({ from: 'done' })
+  async showSuccess() {
+    if (!this.repo) {
+      await this.repository.save(MarkdownDocument, {
+        markdown: '### Cancelled\n\nThe remote connection was removed. No changes were made.',
+      });
+      return { cancelled: true };
+    }
+
+    const repo = this.repo;
+    await this.repository.save(MarkdownDocument, {
+      markdown: `### Repository Connected\n\nYour workspace is now connected to [${repo.fullName}](${repo.htmlUrl}).\n\nAll future commits can be pushed to this repository using the git tools in your workflows.`,
+    });
+
+    this.clientMessageService.dispatchWorkspaceEvent(
+      'git.updated',
+      this.ctx.context.workspaceId,
+      this.ctx.context.userId,
+    );
+
+    return { repo: repo.fullName, url: repo.htmlUrl };
+  }
+}

package/src/workflows/index.ts

@@ -0,0 +1 @@
+export { ConnectGitHubWorkflow } from './connect-github/connect-github.workflow';