vibe-squire 1.0.0

package/README.md

@@ -0,0 +1,179 @@
+# vibe-squire
+
+Local background orchestrator that polls **GitHub** for PRs requesting your review and syncs them as issues into **[Vibe Kanban](https://vibekanban.com)** over MCP (Model Context Protocol).
+
+Built with [NestJS](https://nestjs.com), [Prisma](https://www.prisma.io) + SQLite, and a hexagonal architecture that keeps source/destination adapters pluggable.
+
+## How it works
+
+```mermaid
+graph LR
+    GH["GitHub (PRs)"] -- "gh pr list<br/>review-requested:@me" --> VS["vibe-squire<br/>(localhost)"]
+    VS -- "MCP stdio<br/>create / update issue" --> VK["Vibe Kanban<br/>(board)"]
+    VS -- "state" --> DB["SQLite"]
+```
+
+1. **Scout** — polls GitHub via `gh pr list --search "review-requested:@me"` on a configurable interval.
+2. **Dispatcher** — routes each PR to a Kanban project based on `owner/repo` mappings, deduplicates, and creates/updates issues via the Vibe Kanban MCP server.
+3. **Reconciliation** — when a PR leaves your review queue, the matching Kanban issue is closed automatically.
+
+## Prerequisites
+
+- **Node.js** >= 20 (LTS)
+- **[`gh`](https://cli.github.com/)** — installed and authenticated (`gh auth login`)
+- **[Vibe Kanban](https://vibekanban.com)** — the MCP server is spawned automatically as a stdio subprocess (`npx vibe-kanban@latest --mcp`)
+
+## Quick start
+
+```bash
+git clone https://github.com/AliakseiPialetski/vibe-squire.git
+cd vibe-squire
+npm install
+cp .env.example .env          # review and adjust settings
+npm run start:dev              # dev mode with watch
+```
+
+Open the operator UI at **http://127.0.0.1:3000/ui/dashboard** (root `/` redirects there).
+
+## Configuration
+
+### Environment variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DATABASE_URL` | `file:./dev.db` | SQLite URL for Prisma. If unset, resolved from `DATABASE_PATH`, `VIBE_SQUIRE_DATA_DIR`, or OS defaults. |
+| `HOST` | `127.0.0.1` | HTTP bind address. |
+| `PORT` | `3000` | HTTP bind port. |
+| `SOURCE_TYPE` | `github` | Scout adapter (`github`). |
+| `DESTINATION_TYPE` | `vibe_kanban` | Board adapter (`vibe_kanban`). |
+| `SCHEDULED_SYNC_ENABLED` | `true` | Set `false` to disable the automatic poll timer (manual "Sync now" still works). |
+| `POLL_INTERVAL_MINUTES` | `10` | Minutes between scheduled polls (minimum 5, clamped). |
+| `JITTER_MAX_SECONDS` | `30` | Random jitter added to the poll interval. |
+| `RUN_NOW_COOLDOWN_SECONDS` | `60` | Minimum gap after a manual sync before another is allowed. |
+| `LOG_LEVEL` | `info` | Pino log level (`fatal` / `error` / `warn` / `info` / `debug` / `trace` / `silent`). |
+| `LOG_FILE_PATH` | — | Path for JSON file logging (in addition to console). |
+| `OPENAPI_ENABLED` | `true` | Expose Swagger UI at `/api/docs`. |
+
+### Runtime settings (SQLite)
+
+These have no env var equivalent — set them via the operator UI or `PATCH /api/settings`:
+
+`default_organization_id`, `default_project_id`, `vk_workspace_executor`, `kanban_done_status`, `pr_ignore_author_logins`, `pr_review_body_template`, `max_board_pr_count`.
+
+### Effective precedence
+
+For keys that have both an env var and a SQLite row: **env (non-empty) > SQLite > code default**.
+
+### Database location
+
+When `DATABASE_URL` is not set, the app resolves a path automatically:
+
+| OS | Default directory |
+|----|-------------------|
+| Linux | `~/.local/state/vibe-squire/` (respects `XDG_STATE_HOME`) |
+| macOS | `~/Library/Application Support/vibe-squire/` |
+| Windows | `%APPDATA%\vibe-squire\` |
+
+Override with `VIBE_SQUIRE_DATA_DIR` (directory) or `DATABASE_PATH` (full file path).
+
+## Operator UI
+
+Server-rendered Handlebars templates served by the same Nest process — no separate frontend build.
+
+| URL | Page |
+|-----|------|
+| `/ui/dashboard` | Health status, sync schedule, "Sync now" button |
+| `/ui/settings` | Poll interval, board limits, PR filters |
+| `/ui/mappings` | GitHub `owner/repo` → Vibe Kanban project mappings |
+| `/ui/vibe-kanban` | Organisation/project picker, workspace executor |
+
+## HTTP API
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `GET` | `/api/status` | Aggregate health, setup, and scheduler snapshot |
+| `GET` | `/api/status/stream` | SSE status stream (heartbeat + events) |
+| `POST` | `/api/sync/run` | Trigger manual sync (cooldown + guards) |
+| `POST` | `/api/reinit` | Soft reinit: re-probe `gh`, DB, MCP; reset backoff |
+| `CRUD` | `/api/settings` | Runtime settings |
+| `CRUD` | `/api/mappings` | Repo → project mappings |
+| `GET` | `/api/vibe-kanban/organizations` | MCP `list_organizations` |
+| `GET` | `/api/vibe-kanban/projects?organization_id=` | MCP `list_projects` |
+
+OpenAPI docs (when enabled): **http://127.0.0.1:3000/api/docs**
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `npm run build` | Compile with `nest build` |
+| `npm run start:dev` | Dev mode with file watching |
+| `npm run start:prod` | Production: `node dist/main` |
+| `npm test` | Unit tests |
+| `npm run test:cov` | Unit tests with coverage |
+| `npm run test:integration` | Integration tests (Prisma + migrations + Supertest) |
+| `npm run lint` | Lint and auto-fix |
+| `npm run typecheck` | TypeScript type checking |
+
+## Testing
+
+- **Unit tests** — `src/**/__tests__/**/*.spec.ts`. Pure logic, Zod schemas, helpers.
+- **Integration tests** — `test/*.integration-spec.ts`. Real Prisma + SQLite (`:memory:`), Nest module wiring, Supertest HTTP. External boundaries (GitHub `gh`, Vibe Kanban MCP) are stubbed.
+- CI runs lint, typecheck, build, unit, and integration tests on every push and PR.
+
+```bash
+npm test && npm run test:integration
+```
+
+## Deployment
+
+### Direct (recommended for development)
+
+```bash
+npm run build
+node dist/main
+```
+
+### systemd (user unit)
+
+```ini
+[Unit]
+Description=vibe-squire orchestrator
+After=network-online.target
+
+[Service]
+Type=simple
+WorkingDirectory=%h/projects/vibe-squire
+Environment=NODE_ENV=production
+Environment=HOST=127.0.0.1
+Environment=PORT=3000
+Environment=DATABASE_URL=file:%h/.local/share/vibe-squire/data.sqlite
+ExecStart=/usr/bin/node dist/main
+Restart=on-failure
+
+[Install]
+WantedBy=default.target
+```
+
+### Docker (optional)
+
+```dockerfile
+FROM node:22-bookworm-slim
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm ci
+COPY . .
+RUN npx prisma generate && npm run build
+ENV NODE_ENV=production
+ENV HOST=0.0.0.0
+EXPOSE 3000
+CMD ["node", "dist/main"]
+```
+
+Mount a volume for the SQLite database and set `DATABASE_URL=file:/data/vibe-squire.sqlite`.
+
+**Important:** Run a single vibe-squire process per SQLite file. Concurrent processes on the same database are unsupported.
+
+## License
+
+UNLICENSED

package/bin/vibe-squire.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+'use strict';
+require('../dist/main.js');

package/dist/prisma.config.d.ts

@@ -0,0 +1,3 @@
+import 'dotenv/config';
+declare const _default: import("@prisma/config").PrismaConfigInternal;
+export default _default;

package/dist/prisma.config.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const config_1 = require("prisma/config");
+exports.default = (0, config_1.defineConfig)({
+    schema: 'prisma/schema.prisma',
+    migrations: {
+        path: 'prisma/migrations',
+    },
+    datasource: {
+        url: process.env['DATABASE_URL'],
+    },
+});
+//# sourceMappingURL=prisma.config.js.map

package/dist/prisma.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.config.js","sourceRoot":"","sources":["../prisma.config.ts"],"names":[],"mappings":";;AAEA,yBAAuB;AACvB,0CAA6C;AAE7C,kBAAe,IAAA,qBAAY,EAAC;IAC1B,MAAM,EAAE,sBAAsB;IAC9B,UAAU,EAAE;QACV,IAAI,EAAE,mBAAmB;KAC1B;IACD,UAAU,EAAE;QACV,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;KACjC;CACF,CAAC,CAAC"}

package/dist/src/app.controller.d.ts

@@ -0,0 +1,3 @@
+export declare class AppController {
+    root(): void;
+}

package/dist/src/app.controller.js

@@ -0,0 +1,30 @@
+"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.AppController = void 0;
+const common_1 = require("@nestjs/common");
+let AppController = class AppController {
+    root() {
+        void 0;
+    }
+};
+exports.AppController = AppController;
+__decorate([
+    (0, common_1.Get)(),
+    (0, common_1.Redirect)('/ui/dashboard', 302),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], AppController.prototype, "root", null);
+exports.AppController = AppController = __decorate([
+    (0, common_1.Controller)()
+], AppController);
+//# sourceMappingURL=app.controller.js.map

package/dist/src/app.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.controller.js","sourceRoot":"","sources":["../../src/app.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA2D;AAGpD,IAAM,aAAa,GAAnB,MAAM,aAAa;IAGxB,IAAI;QACF,KAAK,CAAC,CAAC;IACT,CAAC;CACF,CAAA;AANY,sCAAa;AAGxB;IAFC,IAAA,YAAG,GAAE;IACL,IAAA,iBAAQ,EAAC,eAAe,EAAE,GAAG,CAAC;;;;yCAG9B;wBALU,aAAa;IADzB,IAAA,mBAAU,GAAE;GACA,aAAa,CAMzB"}

package/dist/src/app.module.d.ts

@@ -0,0 +1,5 @@
+import { DynamicModule } from '@nestjs/common';
+import type { AppEnv } from './config/app-env.token';
+export declare class AppModule {
+    static forRoot(env: AppEnv): DynamicModule;
+}

package/dist/src/app.module.js

@@ -0,0 +1,56 @@
+"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 AppModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModule = void 0;
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const nestjs_pino_1 = require("nestjs-pino");
+const app_controller_1 = require("./app.controller");
+const env_module_1 = require("./config/env.module");
+const create_logger_params_1 = require("./logging/create-logger-params");
+const integrations_module_1 = require("./integrations/integrations.module");
+const prisma_module_1 = require("./prisma/prisma.module");
+const settings_module_1 = require("./settings/settings.module");
+const mappings_module_1 = require("./mappings/mappings.module");
+const status_module_1 = require("./status/status.module");
+const status_events_module_1 = require("./events/status-events.module");
+const sync_module_1 = require("./sync/sync.module");
+const sync_run_state_module_1 = require("./sync/sync-run-state.module");
+const reinit_module_1 = require("./reinit/reinit.module");
+const ui_module_1 = require("./ui/ui.module");
+const setup_module_1 = require("./setup/setup.module");
+let AppModule = AppModule_1 = class AppModule {
+    static forRoot(env) {
+        return {
+            module: AppModule_1,
+            imports: [
+                env_module_1.EnvModule.forRoot(env),
+                nestjs_pino_1.LoggerModule.forRoot((0, create_logger_params_1.createLoggerModuleParams)(env)),
+                event_emitter_1.EventEmitterModule.forRoot(),
+                status_events_module_1.StatusEventsModule,
+                prisma_module_1.PrismaModule,
+                sync_run_state_module_1.SyncRunStateModule,
+                settings_module_1.SettingsModule,
+                integrations_module_1.IntegrationsModule.register(env),
+                sync_module_1.SyncModule,
+                reinit_module_1.ReinitModule,
+                mappings_module_1.MappingsModule,
+                status_module_1.StatusModule,
+                setup_module_1.SetupModule,
+                ui_module_1.UiModule,
+            ],
+            controllers: [app_controller_1.AppController],
+        };
+    }
+};
+exports.AppModule = AppModule;
+exports.AppModule = AppModule = AppModule_1 = __decorate([
+    (0, common_1.Module)({})
+], AppModule);
+//# sourceMappingURL=app.module.js.map

package/dist/src/app.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,yDAA2D;AAC3D,6CAA2C;AAC3C,qDAAiD;AACjD,oDAAgD;AAEhD,yEAA0E;AAC1E,4EAAwE;AACxE,0DAAsD;AACtD,gEAA4D;AAC5D,gEAA4D;AAC5D,0DAAsD;AACtD,wEAAmE;AACnE,oDAAgD;AAChD,wEAAkE;AAClE,0DAAsD;AACtD,8CAA0C;AAC1C,uDAAmD;AAQ5C,IAAM,SAAS,iBAAf,MAAM,SAAS;IAMpB,MAAM,CAAC,OAAO,CAAC,GAAW;QACxB,OAAO;YACL,MAAM,EAAE,WAAS;YACjB,OAAO,EAAE;gBACP,sBAAS,CAAC,OAAO,CAAC,GAAG,CAAC;gBACtB,0BAAY,CAAC,OAAO,CAAC,IAAA,+CAAwB,EAAC,GAAG,CAAC,CAAC;gBACnD,kCAAkB,CAAC,OAAO,EAAE;gBAC5B,yCAAkB;gBAClB,4BAAY;gBACZ,0CAAkB;gBAClB,gCAAc;gBACd,wCAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAChC,wBAAU;gBACV,4BAAY;gBACZ,gCAAc;gBACd,4BAAY;gBACZ,0BAAW;gBACX,oBAAQ;aACT;YACD,WAAW,EAAE,CAAC,8BAAa,CAAC;SAC7B,CAAC;IACJ,CAAC;CACF,CAAA;AA5BY,8BAAS;oBAAT,SAAS;IADrB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,SAAS,CA4BrB"}

package/dist/src/config/app-env.token.d.ts

@@ -0,0 +1,14 @@
+import type { LevelWithSilent } from 'pino';
+import type { SupportedSourceType, SupportedDestinationType } from './integration-types';
+export type AppEnv = {
+    nodeEnv: string | undefined;
+    databaseUrl: string;
+    host: string;
+    port: number;
+    openapiEnabled: boolean;
+    logLevel: LevelWithSilent;
+    logFilePath: string | undefined;
+    sourceType: SupportedSourceType;
+    destinationType: SupportedDestinationType;
+};
+export declare const APP_ENV: unique symbol;

package/dist/src/config/app-env.token.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APP_ENV = void 0;
+exports.APP_ENV = Symbol('APP_ENV');
+//# sourceMappingURL=app-env.token.js.map

package/dist/src/config/app-env.token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-env.token.js","sourceRoot":"","sources":["../../../src/config/app-env.token.ts"],"names":[],"mappings":";;;AAsBa,QAAA,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC"}

package/dist/src/config/env-schema.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import type { AppEnv } from './app-env.token';
+declare const appEnvInputSchema: z.ZodObject<{
+    NODE_ENV: z.ZodOptional<z.ZodString>;
+    DATABASE_URL: z.ZodString;
+    HOST: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodCustomStringFormat<"hostname">, z.ZodIPv4]>>>;
+    PORT: z.ZodDefault<z.ZodNumber>;
+    OPENAPI_ENABLED: z.ZodDefault<z.ZodOptional<z.ZodCodec<z.ZodString, z.ZodBoolean>>>;
+    LOG_LEVEL: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        fatal: "fatal";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        debug: "debug";
+        trace: "trace";
+        silent: "silent";
+    }>>>;
+    LOG_FILE_PATH: z.ZodOptional<z.ZodString>;
+    SOURCE_TYPE: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        github: "github";
+    }>>>;
+    DESTINATION_TYPE: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        vibe_kanban: "vibe_kanban";
+    }>>>;
+}, z.core.$loose>;
+export type AppEnvInput = z.input<typeof appEnvInputSchema>;
+export declare function parseAppEnv(env?: NodeJS.ProcessEnv): AppEnv;
+export {};

package/dist/src/config/env-schema.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAppEnv = parseAppEnv;
+const zod_1 = require("zod");
+const integration_types_1 = require("./integration-types");
+const PINO_LOG_LEVELS = [
+    'fatal',
+    'error',
+    'warn',
+    'info',
+    'debug',
+    'trace',
+    'silent',
+];
+const appEnvInputSchema = zod_1.z.looseObject({
+    NODE_ENV: zod_1.z.string().optional(),
+    DATABASE_URL: zod_1.z.string().trim().min(1, 'DATABASE_URL is required'),
+    HOST: zod_1.z.union([zod_1.z.hostname(), zod_1.z.ipv4()]).optional().default('127.0.0.1'),
+    PORT: zod_1.z.number().int().min(1).max(65535).default(3000),
+    OPENAPI_ENABLED: zod_1.z.stringbool().optional().default(true),
+    LOG_LEVEL: zod_1.z.enum(PINO_LOG_LEVELS).optional().default('info'),
+    LOG_FILE_PATH: zod_1.z.string().optional(),
+    SOURCE_TYPE: zod_1.z.enum(integration_types_1.SUPPORTED_SOURCE_TYPES).optional().default('github'),
+    DESTINATION_TYPE: zod_1.z
+        .enum(integration_types_1.SUPPORTED_DESTINATION_TYPES)
+        .optional()
+        .default('vibe_kanban'),
+});
+function parseAppEnv(env = process.env) {
+    const parsed = appEnvInputSchema.parse(env);
+    return {
+        nodeEnv: parsed.NODE_ENV,
+        databaseUrl: parsed.DATABASE_URL,
+        host: parsed.HOST,
+        port: parsed.PORT,
+        openapiEnabled: parsed.OPENAPI_ENABLED,
+        logLevel: parsed.LOG_LEVEL,
+        logFilePath: parsed.LOG_FILE_PATH?.trim() || undefined,
+        sourceType: parsed.SOURCE_TYPE,
+        destinationType: parsed.DESTINATION_TYPE,
+    };
+}
+//# sourceMappingURL=env-schema.js.map

package/dist/src/config/env-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-schema.js","sourceRoot":"","sources":["../../../src/config/env-schema.ts"],"names":[],"mappings":";;AA4CA,kCAcC;AAlDD,6BAAwB;AAExB,2DAG6B;AAG7B,MAAM,eAAe,GAAG;IACtB,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;CACqC,CAAC;AAEhD,MAAM,iBAAiB,GAAG,OAAC,CAAC,WAAW,CAAC;IACtC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;IAClE,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,QAAQ,EAAE,EAAE,OAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IACvE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACtD,eAAe,EAAE,OAAC,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACxD,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAE7D,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAsB,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IACxE,gBAAgB,EAAE,OAAC;SAChB,IAAI,CAAC,+CAA2B,CAAC;SACjC,QAAQ,EAAE;SACV,OAAO,CAAC,aAAa,CAAC;CAC1B,CAAC,CAAC;AAIH,SAAgB,WAAW,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9D,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE5C,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,QAAQ;QACxB,WAAW,EAAE,MAAM,CAAC,YAAY;QAChC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,cAAc,EAAE,MAAM,CAAC,eAAe;QACtC,QAAQ,EAAE,MAAM,CAAC,SAAS;QAC1B,WAAW,EAAE,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,SAAS;QACtD,UAAU,EAAE,MAAM,CAAC,WAAW;QAC9B,eAAe,EAAE,MAAM,CAAC,gBAAgB;KACzC,CAAC;AACJ,CAAC"}

package/dist/src/config/env.module.d.ts

@@ -0,0 +1,5 @@
+import { type DynamicModule } from '@nestjs/common';
+import { type AppEnv } from './app-env.token';
+export declare class EnvModule {
+    static forRoot(env: AppEnv): DynamicModule;
+}

package/dist/src/config/env.module.js

@@ -0,0 +1,27 @@
+"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 EnvModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvModule = void 0;
+const common_1 = require("@nestjs/common");
+const app_env_token_1 = require("./app-env.token");
+let EnvModule = EnvModule_1 = class EnvModule {
+    static forRoot(env) {
+        return {
+            module: EnvModule_1,
+            providers: [{ provide: app_env_token_1.APP_ENV, useValue: env }],
+            exports: [app_env_token_1.APP_ENV],
+        };
+    }
+};
+exports.EnvModule = EnvModule;
+exports.EnvModule = EnvModule = EnvModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], EnvModule);
+//# sourceMappingURL=env.module.js.map

package/dist/src/config/env.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.module.js","sourceRoot":"","sources":["../../../src/config/env.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAoE;AACpE,mDAAuD;AAIhD,IAAM,SAAS,iBAAf,MAAM,SAAS;IACpB,MAAM,CAAC,OAAO,CAAC,GAAW;QACxB,OAAO;YACL,MAAM,EAAE,WAAS;YACjB,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,uBAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;YAChD,OAAO,EAAE,CAAC,uBAAO,CAAC;SACnB,CAAC;IACJ,CAAC;CACF,CAAA;AARY,8BAAS;oBAAT,SAAS;IAFrB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,SAAS,CAQrB"}

package/dist/src/config/integration-types.d.ts

@@ -0,0 +1,4 @@
+export declare const SUPPORTED_SOURCE_TYPES: readonly ["github"];
+export type SupportedSourceType = (typeof SUPPORTED_SOURCE_TYPES)[number];
+export declare const SUPPORTED_DESTINATION_TYPES: readonly ["vibe_kanban"];
+export type SupportedDestinationType = (typeof SUPPORTED_DESTINATION_TYPES)[number];

package/dist/src/config/integration-types.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_DESTINATION_TYPES = exports.SUPPORTED_SOURCE_TYPES = void 0;
+exports.SUPPORTED_SOURCE_TYPES = ['github'];
+exports.SUPPORTED_DESTINATION_TYPES = ['vibe_kanban'];
+//# sourceMappingURL=integration-types.js.map

package/dist/src/config/integration-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-types.js","sourceRoot":"","sources":["../../../src/config/integration-types.ts"],"names":[],"mappings":";;;AACa,QAAA,sBAAsB,GAAG,CAAC,QAAQ,CAAU,CAAC;AAI7C,QAAA,2BAA2B,GAAG,CAAC,aAAa,CAAU,CAAC"}

package/dist/src/config/vk-executors.d.ts

@@ -0,0 +1,5 @@
+export declare const VK_WORKSPACE_EXECUTOR_OPTIONS: ReadonlyArray<{
+    value: string;
+    label: string;
+}>;
+export declare function normalizeVkWorkspaceExecutor(raw: string): string | null;

package/dist/src/config/vk-executors.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VK_WORKSPACE_EXECUTOR_OPTIONS = void 0;
+exports.normalizeVkWorkspaceExecutor = normalizeVkWorkspaceExecutor;
+exports.VK_WORKSPACE_EXECUTOR_OPTIONS = [
+    { value: 'claude-code', label: 'Claude Code' },
+    { value: 'amp', label: 'Amp' },
+    { value: 'gemini', label: 'Gemini' },
+    { value: 'codex', label: 'Codex' },
+    { value: 'opencode', label: 'OpenCode' },
+    { value: 'cursor_agent', label: 'Cursor Agent' },
+    { value: 'qwen-code', label: 'Qwen Code' },
+    { value: 'copilot', label: 'Copilot' },
+    { value: 'droid', label: 'Droid' },
+];
+function normalizeVkWorkspaceExecutor(raw) {
+    const t = raw.trim().toLowerCase();
+    const found = exports.VK_WORKSPACE_EXECUTOR_OPTIONS.find((o) => o.value.toLowerCase() === t);
+    return found ? found.value : null;
+}
+//# sourceMappingURL=vk-executors.js.map

package/dist/src/config/vk-executors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vk-executors.js","sourceRoot":"","sources":["../../../src/config/vk-executors.ts"],"names":[],"mappings":";;;AAgBA,oEAMC;AArBY,QAAA,6BAA6B,GAGrC;IACH,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;IAC9C,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;IAC9B,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;IACpC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;IACxC,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE;IAChD,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;IAC1C,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACtC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;CACnC,CAAC;AAEF,SAAgB,4BAA4B,CAAC,GAAW;IACtD,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,qCAA6B,CAAC,IAAI,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CACnC,CAAC;IACF,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACpC,CAAC"}

package/dist/src/configure-express-app.d.ts

@@ -0,0 +1,2 @@
+import type { NestExpressApplication } from '@nestjs/platform-express';
+export declare function configureExpressApp(app: NestExpressApplication): void;

package/dist/src/configure-express-app.js

@@ -0,0 +1,74 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureExpressApp = configureExpressApp;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const express = __importStar(require("express"));
+const hbs_1 = __importDefault(require("hbs"));
+const UI_LAYOUT_MARKER = (0, node_path_1.join)('views', 'partials', 'layout.hbs');
+function resolveUiRoot() {
+    const siblingUi = (0, node_path_1.join)(__dirname, '..', 'ui');
+    const coLocatedUi = (0, node_path_1.join)(__dirname, 'ui');
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(siblingUi, UI_LAYOUT_MARKER))) {
+        return siblingUi;
+    }
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(coLocatedUi, UI_LAYOUT_MARKER))) {
+        return coLocatedUi;
+    }
+    return siblingUi;
+}
+function configureExpressApp(app) {
+    app.use(express.urlencoded({ extended: true }));
+    const uiRoot = resolveUiRoot();
+    const viewsPath = (0, node_path_1.join)(uiRoot, 'views');
+    const publicPath = (0, node_path_1.join)(uiRoot, 'public');
+    const partialsDir = (0, node_path_1.join)(viewsPath, 'partials');
+    hbs_1.default.registerPartial('layout', (0, node_fs_1.readFileSync)((0, node_path_1.join)(partialsDir, 'layout.hbs'), 'utf8'));
+    hbs_1.default.registerPartial('nav', (0, node_fs_1.readFileSync)((0, node_path_1.join)(partialsDir, 'nav.hbs'), 'utf8'));
+    hbs_1.default.registerHelper('eq', (a, b) => a === b);
+    hbs_1.default.registerHelper('renderBlock', function (options) {
+        const block = options.data?.['partial-block'];
+        return typeof block === 'function' ? block(this, options) : '';
+    });
+    hbs_1.default.registerHelper('json', (context) => JSON.stringify(context ?? null).replace(/</g, '\\u003c'));
+    app.useStaticAssets(publicPath, { prefix: '/ui/assets/' });
+    app.setBaseViewsDir(viewsPath);
+    app.setViewEngine('hbs');
+}
+//# sourceMappingURL=configure-express-app.js.map

package/dist/src/configure-express-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-express-app.js","sourceRoot":"","sources":["../../src/configure-express-app.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,kDA0CC;AAxED,qCAAmD;AACnD,yCAAiC;AAEjC,iDAAmC;AACnC,8CAAsB;AAEtB,MAAM,gBAAgB,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAOjE,SAAS,aAAa;IACpB,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAE1C,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAMD,SAAgB,mBAAmB,CAAC,GAA2B;IAC7D,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAEhD,aAAG,CAAC,eAAe,CACjB,QAAQ,EACR,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,WAAW,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CACtD,CAAC;IACF,aAAG,CAAC,eAAe,CACjB,KAAK,EACL,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CACnD,CAAC;IACF,aAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAU,EAAE,CAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAO9D,aAAG,CAAC,cAAc,CAChB,aAAa,EACb,UAEE,OAEC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,CAAC;QAC9C,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC,CACF,CAAC;IACF,aAAG,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,OAAgB,EAAE,EAAE,CAC9C,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CACzD,CAAC;IAEF,GAAG,CAAC,eAAe,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC3D,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAC/B,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/src/database/resolve-database-url.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureDatabaseUrlFromEnv(): void;
+export declare function databaseUrlToFilePath(url: string): string;

package/dist/src/database/resolve-database-url.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDatabaseUrlFromEnv = ensureDatabaseUrlFromEnv;
+exports.databaseUrlToFilePath = databaseUrlToFilePath;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+function ensureDatabaseUrlFromEnv() {
+    const existing = process.env.DATABASE_URL?.trim();
+    if (existing) {
+        return;
+    }
+    const explicitFile = process.env.DATABASE_PATH?.trim();
+    if (explicitFile) {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(explicitFile), { recursive: true });
+        process.env.DATABASE_URL = (0, node_url_1.pathToFileURL)(explicitFile).href;
+        return;
+    }
+    const dataDir = process.env.VIBE_SQUIRE_DATA_DIR?.trim() || defaultDataDirectory();
+    (0, node_fs_1.mkdirSync)(dataDir, { recursive: true });
+    const dbPath = (0, node_path_1.join)(dataDir, 'vibe-squire.db');
+    process.env.DATABASE_URL = (0, node_url_1.pathToFileURL)(dbPath).href;
+}
+function databaseUrlToFilePath(url) {
+    if (url.startsWith('file://')) {
+        return (0, node_url_1.fileURLToPath)(url);
+    }
+    const raw = url.replace(/^file:/, '');
+    return (0, node_path_1.resolve)(raw);
+}
+function defaultDataDirectory() {
+    if (process.platform === 'win32') {
+        const base = process.env.APPDATA || (0, node_path_1.join)((0, node_os_1.homedir)(), 'AppData', 'Roaming');
+        return (0, node_path_1.join)(base, 'vibe-squire');
+    }
+    if (process.platform === 'darwin') {
+        return (0, node_path_1.join)((0, node_os_1.homedir)(), 'Library', 'Application Support', 'vibe-squire');
+    }
+    const xdg = process.env.XDG_STATE_HOME?.trim();
+    if (xdg) {
+        return (0, node_path_1.join)(xdg, 'vibe-squire');
+    }
+    return (0, node_path_1.join)((0, node_os_1.homedir)(), '.local', 'state', 'vibe-squire');
+}
+//# sourceMappingURL=resolve-database-url.js.map