@loopstack/git-examples 0.1.1

package/README.md

@@ -0,0 +1,79 @@
+---
+title: Git Examples
+description: Git and GitHub workflow examples — scripted multi-tool git operations and end-to-end repo sync via ConnectGitHubWorkflow
+---
+
+# @loopstack/git-examples
+
+> Git and GitHub workflow examples for the [Loopstack](https://loopstack.ai) automation framework.
+
+Two workflow examples that show how to compose git tools and integrate with GitHub.
+
+## Install as Source (Recommended)
+
+```bash
+npx giget@latest gh:loopstack-ai/loopstack/registry/examples/git-examples src/git-examples
+```
+
+Register the module:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { LoopstackModule } from '@loopstack/loopstack-module';
+import { GitExamplesModule } from './git-examples/git-examples.module';
+
+@Module({
+  imports: [LoopstackModule.forRoot(), GitExamplesModule],
+})
+export class AppModule {}
+```
+
+## Install as a Dependency
+
+```bash
+npm install @loopstack/git-examples
+```
+
+```typescript
+import { GitExamplesModule } from '@loopstack/git-examples';
+```
+
+## Environment
+
+The repo-sync example requires GitHub OAuth credentials:
+
+```bash
+GITHUB_CLIENT_ID=...
+GITHUB_CLIENT_SECRET=...
+```
+
+## Examples
+
+| Example                               | Studio title                     | Description                                                            |
+| ------------------------------------- | -------------------------------- | ---------------------------------------------------------------------- |
+| [Git Commit Flow](#git-commit-flow)   | `Git - Commit Flow Example`      | Scripted multi-tool git workflow — status → add → commit → log, no LLM |
+| [GitHub Repo Sync](#github-repo-sync) | `Git - GitHub Repo Sync Example` | Launches `ConnectGitHubWorkflow` for the full repo sync flow           |
+
+---
+
+## Git Commit Flow
+
+A scripted workflow that orchestrates four git tools in sequence: `gitStatus`, `gitAdd`, `gitCommit`, `gitLog`. No LLM involved — demonstrates composing tools deterministically.
+
+### Files
+
+- `git-commit-flow-example.workflow.ts` — workflow class
+
+## GitHub Repo Sync
+
+Thin wrapper that launches `ConnectGitHubWorkflow` from `@loopstack/github-integration` as a sub-workflow. The integration handles the full sync flow: OAuth → create or pick repo → check uncommitted changes → resolve divergence → push.
+
+### Files
+
+- `github-repo-sync-example.workflow.ts` — workflow class
+
+## About
+
+Author: [Jakob Klippel](https://www.linkedin.com/in/jakob-klippel/)
+
+License: MIT

package/dist/git-examples.module.d.ts

@@ -0,0 +1,3 @@
+export declare class GitExamplesModule {
+}
+//# sourceMappingURL=git-examples.module.d.ts.map

package/dist/git-examples.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-examples.module.d.ts","sourceRoot":"","sources":["../src/git-examples.module.ts"],"names":[],"mappings":"AAUA,qBAaa,iBAAiB;CAAG"}

package/dist/git-examples.module.js

@@ -0,0 +1,36 @@
+"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.GitExamplesModule = void 0;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@loopstack/common");
+const git_module_1 = require("@loopstack/git-module");
+const github_integration_1 = require("@loopstack/github-integration");
+const remote_client_1 = require("@loopstack/remote-client");
+const git_commit_flow_example_workflow_1 = require("./workflows/git-commit-flow/git-commit-flow-example.workflow");
+const github_repo_sync_example_workflow_1 = require("./workflows/github-repo-sync/github-repo-sync-example.workflow");
+const WORKFLOWS = [git_commit_flow_example_workflow_1.GitCommitFlowExampleWorkflow, github_repo_sync_example_workflow_1.GithubRepoSyncExampleWorkflow];
+let GitExamplesModule = class GitExamplesModule {
+};
+exports.GitExamplesModule = GitExamplesModule;
+exports.GitExamplesModule = GitExamplesModule = __decorate([
+    (0, common_2.StudioApp)({
+        title: 'Git Examples',
+        workflows: WORKFLOWS,
+    }),
+    (0, common_1.Module)({
+        imports: [
+            git_module_1.GitModule.forFeature(),
+            github_integration_1.GitHubIntegrationModule,
+            remote_client_1.RemoteClientModule.forFeature({ slots: [{ id: 'sandbox', type: 'sandbox', title: 'Sandbox' }] }),
+        ],
+        providers: WORKFLOWS,
+        exports: WORKFLOWS,
+    })
+], GitExamplesModule);
+//# sourceMappingURL=git-examples.module.js.map

package/dist/git-examples.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-examples.module.js","sourceRoot":"","sources":["../src/git-examples.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,8CAA8C;AAC9C,sDAAkD;AAClD,sEAAwE;AACxE,4DAA8D;AAC9D,mHAA4G;AAC5G,sHAA+G;AAE/G,MAAM,SAAS,GAAG,CAAC,+DAA4B,EAAE,iEAA6B,CAAC,CAAC;AAezE,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;CAAG,CAAA;AAApB,8CAAiB;4BAAjB,iBAAiB;IAb7B,IAAA,kBAAS,EAAC;QACT,KAAK,EAAE,cAAc;QACrB,SAAS,EAAE,SAAS;KACrB,CAAC;IACD,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,sBAAS,CAAC,UAAU,EAAE;YACtB,4CAAuB;YACvB,kCAAkB,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;SACjG;QACD,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,SAAS;KACnB,CAAC;GACW,iBAAiB,CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './git-examples.module';
+export * from './workflows/git-commit-flow/git-commit-flow-example.workflow';
+export * from './workflows/github-repo-sync/github-repo-sync-example.workflow';
+//# 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,uBAAuB,CAAC;AACtC,cAAc,8DAA8D,CAAC;AAC7E,cAAc,gEAAgE,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"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("./git-examples.module"), exports);
+__exportStar(require("./workflows/git-commit-flow/git-commit-flow-example.workflow"), exports);
+__exportStar(require("./workflows/github-repo-sync/github-repo-sync-example.workflow"), 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,wDAAsC;AACtC,+FAA6E;AAC7E,iGAA+E"}

package/dist/workflows/git-commit-flow/git-commit-flow-example.workflow.d.ts

@@ -0,0 +1,19 @@
+import { BaseWorkflow } from '@loopstack/common';
+import { GitAddTool, GitCommitTool, GitLogTool, GitStatusTool } from '@loopstack/git-module';
+import { WriteTool } from '@loopstack/remote-client';
+export declare class GitCommitFlowExampleWorkflow extends BaseWorkflow {
+    private readonly write;
+    private readonly gitStatus;
+    private readonly gitAdd;
+    private readonly gitCommit;
+    private readonly gitLog;
+    constructor(write: WriteTool, gitStatus: GitStatusTool, gitAdd: GitAddTool, gitCommit: GitCommitTool, gitLog: GitLogTool);
+    writeTestFile(): Promise<void>;
+    checkStatus(): Promise<void>;
+    stageAll(): Promise<void>;
+    commit(state: {
+        stamp: string;
+    }): Promise<void>;
+    readBack(): Promise<void>;
+}
+//# sourceMappingURL=git-commit-flow-example.workflow.d.ts.map

package/dist/workflows/git-commit-flow/git-commit-flow-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-commit-flow-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/git-commit-flow/git-commit-flow-example.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAKa,4BAA6B,SAAQ,YAAY;IAE1D,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAJN,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,UAAU;IAM/B,aAAa;IAWb,WAAW;IASX,QAAQ;IAKR,MAAM,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAO/B,QAAQ;CAOf"}

package/dist/workflows/git-commit-flow/git-commit-flow-example.workflow.js

@@ -0,0 +1,104 @@
+"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.GitCommitFlowExampleWorkflow = void 0;
+const common_1 = require("@loopstack/common");
+const git_module_1 = require("@loopstack/git-module");
+const remote_client_1 = require("@loopstack/remote-client");
+let GitCommitFlowExampleWorkflow = class GitCommitFlowExampleWorkflow extends common_1.BaseWorkflow {
+    write;
+    gitStatus;
+    gitAdd;
+    gitCommit;
+    gitLog;
+    constructor(write, gitStatus, gitAdd, gitCommit, gitLog) {
+        super();
+        this.write = write;
+        this.gitStatus = gitStatus;
+        this.gitAdd = gitAdd;
+        this.gitCommit = gitCommit;
+        this.gitLog = gitLog;
+    }
+    async writeTestFile() {
+        const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const filePath = `tmp/git-commit-flow-${stamp}.txt`;
+        await this.write.call({
+            file_path: filePath,
+            content: `Generated by git-commit-flow example at ${stamp}\n`,
+        });
+        this.assignState({ filePath, stamp });
+    }
+    async checkStatus() {
+        const status = await this.gitStatus.call();
+        await this.documentStore.save(common_1.MessageDocument, {
+            role: 'assistant',
+            text: `Status before commit:\n\`\`\`json\n${JSON.stringify(status.data, null, 2)}\n\`\`\``,
+        });
+    }
+    async stageAll() {
+        await this.gitAdd.call({ files: ['.'] });
+    }
+    async commit(state) {
+        await this.gitCommit.call({
+            message: `chore: example commit from git-commit-flow workflow (${state.stamp})`,
+        });
+    }
+    async readBack() {
+        const log = await this.gitLog.call({ limit: 1 });
+        await this.documentStore.save(common_1.MessageDocument, {
+            role: 'assistant',
+            text: `Latest commit:\n\`\`\`json\n${JSON.stringify(log.data, null, 2)}\n\`\`\``,
+        });
+    }
+};
+exports.GitCommitFlowExampleWorkflow = GitCommitFlowExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'file_written' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], GitCommitFlowExampleWorkflow.prototype, "writeTestFile", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'file_written', to: 'status_checked' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], GitCommitFlowExampleWorkflow.prototype, "checkStatus", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'status_checked', to: 'staged' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], GitCommitFlowExampleWorkflow.prototype, "stageAll", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'staged', to: 'committed' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], GitCommitFlowExampleWorkflow.prototype, "commit", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'committed', to: 'end' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], GitCommitFlowExampleWorkflow.prototype, "readBack", null);
+exports.GitCommitFlowExampleWorkflow = GitCommitFlowExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'Git - Commit Flow Example',
+        description: 'Scripted multi-tool git workflow: write test file → status → add → commit → log. Demonstrates composing tools without an LLM or agent loop.',
+    }),
+    __metadata("design:paramtypes", [remote_client_1.WriteTool,
+        git_module_1.GitStatusTool,
+        git_module_1.GitAddTool,
+        git_module_1.GitCommitTool,
+        git_module_1.GitLogTool])
+], GitCommitFlowExampleWorkflow);
+//# sourceMappingURL=git-commit-flow-example.workflow.js.map

package/dist/workflows/git-commit-flow/git-commit-flow-example.workflow.js.map

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

package/dist/workflows/github-repo-sync/github-repo-sync-example.workflow.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { BaseWorkflow } from '@loopstack/common';
+import type { TransitionInput } from '@loopstack/common';
+import { ConnectGitHubWorkflow } from '@loopstack/github-integration';
+declare const ConnectResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+    repo: z.ZodString;
+    url: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    cancelled: z.ZodLiteral<true>;
+}, z.core.$strip>]>;
+type ConnectResult = z.infer<typeof ConnectResultSchema>;
+export declare class GithubRepoSyncExampleWorkflow extends BaseWorkflow {
+    private readonly connectGitHubWorkflow;
+    constructor(connectGitHubWorkflow: ConnectGitHubWorkflow);
+    connect(_state: Record<string, unknown>): Promise<void>;
+    connectComplete(_state: Record<string, unknown>, input: TransitionInput<ConnectResult>): Promise<void>;
+}
+export {};
+//# sourceMappingURL=github-repo-sync-example.workflow.d.ts.map

package/dist/workflows/github-repo-sync/github-repo-sync-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-repo-sync-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/github-repo-sync/github-repo-sync-example.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAA0C,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,QAAA,MAAM,mBAAmB;;;;;mBAGvB,CAAC;AACH,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEzD,qBAKa,6BAA8B,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBAArB,qBAAqB,EAAE,qBAAqB;IAKnE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAavC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,aAAa,CAAC;CAa7F"}

package/dist/workflows/github-repo-sync/github-repo-sync-example.workflow.js

@@ -0,0 +1,67 @@
+"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.GithubRepoSyncExampleWorkflow = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const github_integration_1 = require("@loopstack/github-integration");
+const ConnectResultSchema = zod_1.z.union([
+    zod_1.z.object({ repo: zod_1.z.string(), url: zod_1.z.string() }),
+    zod_1.z.object({ cancelled: zod_1.z.literal(true) }),
+]);
+let GithubRepoSyncExampleWorkflow = class GithubRepoSyncExampleWorkflow extends common_1.BaseWorkflow {
+    connectGitHubWorkflow;
+    constructor(connectGitHubWorkflow) {
+        super();
+        this.connectGitHubWorkflow = connectGitHubWorkflow;
+    }
+    async connect(_state) {
+        await this.connectGitHubWorkflow.run({}, { callback: { transition: 'connectComplete' }, show: 'inline', label: 'Connecting to GitHub...' });
+    }
+    async connectComplete(_state, input) {
+        if ('cancelled' in input.data) {
+            await this.documentStore.save(common_1.MarkdownDocument, {
+                markdown: '### Cancelled\n\nThe sync was cancelled.',
+            });
+            return;
+        }
+        await this.documentStore.save(common_1.MarkdownDocument, {
+            markdown: `### Connected\n\nWorkspace synced with [${input.data.repo}](${input.data.url}).`,
+        });
+        this.setResult({ repo: input.data.repo, url: input.data.url });
+    }
+};
+exports.GithubRepoSyncExampleWorkflow = GithubRepoSyncExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'connecting' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], GithubRepoSyncExampleWorkflow.prototype, "connect", null);
+__decorate([
+    (0, common_1.Transition)({
+        from: 'connecting',
+        to: 'end',
+        wait: true,
+        schema: ConnectResultSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], GithubRepoSyncExampleWorkflow.prototype, "connectComplete", null);
+exports.GithubRepoSyncExampleWorkflow = GithubRepoSyncExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'Git - GitHub Repo Sync Example',
+        description: 'Launches the ConnectGitHubWorkflow from @loopstack/github-integration as a sub-workflow. End-to-end: OAuth → create or pick repo → handle uncommitted changes → resolve divergence → connect.',
+    }),
+    __metadata("design:paramtypes", [github_integration_1.ConnectGitHubWorkflow])
+], GithubRepoSyncExampleWorkflow);
+//# sourceMappingURL=github-repo-sync-example.workflow.js.map

package/dist/workflows/github-repo-sync/github-repo-sync-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-repo-sync-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/github-repo-sync/github-repo-sync-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6BAAwB;AACxB,8CAAyF;AAEzF,sEAAsE;AAEtE,MAAM,mBAAmB,GAAG,OAAC,CAAC,KAAK,CAAC;IAClC,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC/C,OAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC;AAQI,IAAM,6BAA6B,GAAnC,MAAM,6BAA8B,SAAQ,qBAAY;IAChC;IAA7B,YAA6B,qBAA4C;QACvE,KAAK,EAAE,CAAC;QADmB,0BAAqB,GAArB,qBAAqB,CAAuB;IAEzE,CAAC;IAGK,AAAN,KAAK,CAAC,OAAO,CAAC,MAA+B;QAC3C,MAAM,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAClC,EAAE,EACF,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAClG,CAAC;IACJ,CAAC;IAQK,AAAN,KAAK,CAAC,eAAe,CAAC,MAA+B,EAAE,KAAqC;QAC1F,IAAI,WAAW,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,yBAAgB,EAAE;gBAC9C,QAAQ,EAAE,0CAA0C;aACrD,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,yBAAgB,EAAE;YAC9C,QAAQ,EAAE,2CAA2C,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI;SAC5F,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAwC,CAAC,CAAC;IACvG,CAAC;CACF,CAAA;AAhCY,sEAA6B;AAMlC;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC;;;;4DAMhC;AAQK;IANL,IAAA,mBAAU,EAAC;QACV,IAAI,EAAE,YAAY;QAClB,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,mBAAmB;KAC5B,CAAC;;;;oEAaD;wCA/BU,6BAA6B;IALzC,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,gCAAgC;QACvC,WAAW,EACT,+LAA+L;KAClM,CAAC;qCAEoD,0CAAqB;GAD9D,6BAA6B,CAgCzC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@loopstack/git-examples",
+  "displayName": "Loopstack Git Examples",
+  "description": "Git and GitHub workflow examples — scripted multi-tool git operations, and end-to-end GitHub repo sync via the ConnectGitHubWorkflow sub-workflow.",
+  "keywords": [
+    "loopstack",
+    "example",
+    "git",
+    "github",
+    "workflow"
+  ],
+  "version": "0.1.1",
+  "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": "vitest run --passWithNoTests",
+    "watch": "nest build --watch"
+  },
+  "dependencies": {
+    "@loopstack/common": "*",
+    "@loopstack/git-module": "*",
+    "@loopstack/github-integration": "*",
+    "@nestjs/common": "^11.1.19",
+    "zod": "^4.3.6"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "devDependencies": {
+    "vitest": "^4.1.6",
+    "@swc/core": "^1.15.33",
+    "unplugin-swc": "^1.5.9"
+  }
+}

package/src/git-examples.module.ts

@@ -0,0 +1,24 @@
+import { Module } from '@nestjs/common';
+import { StudioApp } from '@loopstack/common';
+import { GitModule } from '@loopstack/git-module';
+import { GitHubIntegrationModule } from '@loopstack/github-integration';
+import { RemoteClientModule } from '@loopstack/remote-client';
+import { GitCommitFlowExampleWorkflow } from './workflows/git-commit-flow/git-commit-flow-example.workflow';
+import { GithubRepoSyncExampleWorkflow } from './workflows/github-repo-sync/github-repo-sync-example.workflow';
+
+const WORKFLOWS = [GitCommitFlowExampleWorkflow, GithubRepoSyncExampleWorkflow];
+
+@StudioApp({
+  title: 'Git Examples',
+  workflows: WORKFLOWS,
+})
+@Module({
+  imports: [
+    GitModule.forFeature(),
+    GitHubIntegrationModule,
+    RemoteClientModule.forFeature({ slots: [{ id: 'sandbox', type: 'sandbox', title: 'Sandbox' }] }),
+  ],
+  providers: WORKFLOWS,
+  exports: WORKFLOWS,
+})
+export class GitExamplesModule {}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './git-examples.module';
+export * from './workflows/git-commit-flow/git-commit-flow-example.workflow';
+export * from './workflows/github-repo-sync/github-repo-sync-example.workflow';

package/src/workflows/git-commit-flow/git-commit-flow-example.workflow.ts

@@ -0,0 +1,61 @@
+import { BaseWorkflow, MessageDocument, Transition, Workflow } from '@loopstack/common';
+import { GitAddTool, GitCommitTool, GitLogTool, GitStatusTool } from '@loopstack/git-module';
+import { WriteTool } from '@loopstack/remote-client';
+
+@Workflow({
+  title: 'Git - Commit Flow Example',
+  description:
+    'Scripted multi-tool git workflow: write test file → status → add → commit → log. Demonstrates composing tools without an LLM or agent loop.',
+})
+export class GitCommitFlowExampleWorkflow extends BaseWorkflow {
+  constructor(
+    private readonly write: WriteTool,
+    private readonly gitStatus: GitStatusTool,
+    private readonly gitAdd: GitAddTool,
+    private readonly gitCommit: GitCommitTool,
+    private readonly gitLog: GitLogTool,
+  ) {
+    super();
+  }
+
+  @Transition({ to: 'file_written' })
+  async writeTestFile() {
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const filePath = `tmp/git-commit-flow-${stamp}.txt`;
+    await this.write.call({
+      file_path: filePath,
+      content: `Generated by git-commit-flow example at ${stamp}\n`,
+    });
+    this.assignState({ filePath, stamp });
+  }
+
+  @Transition({ from: 'file_written', to: 'status_checked' })
+  async checkStatus() {
+    const status = await this.gitStatus.call();
+    await this.documentStore.save(MessageDocument, {
+      role: 'assistant',
+      text: `Status before commit:\n\`\`\`json\n${JSON.stringify(status.data, null, 2)}\n\`\`\``,
+    });
+  }
+
+  @Transition({ from: 'status_checked', to: 'staged' })
+  async stageAll() {
+    await this.gitAdd.call({ files: ['.'] });
+  }
+
+  @Transition({ from: 'staged', to: 'committed' })
+  async commit(state: { stamp: string }) {
+    await this.gitCommit.call({
+      message: `chore: example commit from git-commit-flow workflow (${state.stamp})`,
+    });
+  }
+
+  @Transition({ from: 'committed', to: 'end' })
+  async readBack() {
+    const log = await this.gitLog.call({ limit: 1 });
+    await this.documentStore.save(MessageDocument, {
+      role: 'assistant',
+      text: `Latest commit:\n\`\`\`json\n${JSON.stringify(log.data, null, 2)}\n\`\`\``,
+    });
+  }
+}

package/src/workflows/github-repo-sync/github-repo-sync-example.workflow.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { BaseWorkflow, MarkdownDocument, Transition, Workflow } from '@loopstack/common';
+import type { TransitionInput } from '@loopstack/common';
+import { ConnectGitHubWorkflow } from '@loopstack/github-integration';
+
+const ConnectResultSchema = z.union([
+  z.object({ repo: z.string(), url: z.string() }),
+  z.object({ cancelled: z.literal(true) }),
+]);
+type ConnectResult = z.infer<typeof ConnectResultSchema>;
+
+@Workflow({
+  title: 'Git - GitHub Repo Sync Example',
+  description:
+    'Launches the ConnectGitHubWorkflow from @loopstack/github-integration as a sub-workflow. End-to-end: OAuth → create or pick repo → handle uncommitted changes → resolve divergence → connect.',
+})
+export class GithubRepoSyncExampleWorkflow extends BaseWorkflow {
+  constructor(private readonly connectGitHubWorkflow: ConnectGitHubWorkflow) {
+    super();
+  }
+
+  @Transition({ to: 'connecting' })
+  async connect(_state: Record<string, unknown>) {
+    await this.connectGitHubWorkflow.run(
+      {},
+      { callback: { transition: 'connectComplete' }, show: 'inline', label: 'Connecting to GitHub...' },
+    );
+  }
+
+  @Transition({
+    from: 'connecting',
+    to: 'end',
+    wait: true,
+    schema: ConnectResultSchema,
+  })
+  async connectComplete(_state: Record<string, unknown>, input: TransitionInput<ConnectResult>) {
+    if ('cancelled' in input.data) {
+      await this.documentStore.save(MarkdownDocument, {
+        markdown: '### Cancelled\n\nThe sync was cancelled.',
+      });
+      return;
+    }
+
+    await this.documentStore.save(MarkdownDocument, {
+      markdown: `### Connected\n\nWorkspace synced with [${input.data.repo}](${input.data.url}).`,
+    });
+    this.setResult({ repo: input.data.repo, url: input.data.url } as unknown as Record<string, unknown>);
+  }
+}