agent-orchestrator-kit 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.5] - 2026-06-27
+
+### Added
+- **`init --ci gitlab|github|none`** — CI provider flag (default: `github`)
+- **GitLab verify** — `.gitlab/agent-verify.yml` fragment with multi-PM detect (npm/yarn/pnpm)
+- **PM-aware prebuild hook** — `verify:openspec` + `prebuild` injection on `--ci gitlab` (zero DevOps config via `npm run build`)
+- **Starter example** — `templates/.gitlab-ci.starter.yml.example` for early push before DevOps owns root CI
+- **OpenSpec specs** — `gitlab-consumer-verify`, `kit-ci-verify` synced to `openspec/specs/`
+
+### Changed
+- **`update`** refreshes `.gitlab/agent-verify.yml` via `KIT_MANAGED_PATHS`
+- **README + AGENTS.md** — GitLab verifier path documented (prebuild hook, not GitHub Actions)
+- **`printNextSteps`** — GitLab hints for `--ci gitlab` users
+
 ## [0.1.4] - 2026-06-27
 
 ### Added
@@ -49,6 +63,7 @@ All notable changes to this project will be documented in this file.
 ### Added
 - Initial release: 5-role orchestration pipeline, `/opsx:*` commands, IDE sync
 
+[0.1.5]: https://github.com/makshc2/agent-orchestrator-kit/compare/v0.1.4...v0.1.5
 [0.1.4]: https://github.com/makshc2/agent-orchestrator-kit/compare/v0.1.3...v0.1.4
 [0.1.3]: https://github.com/makshc2/agent-orchestrator-kit/compare/v0.1.2...v0.1.3
 [0.1.2]: https://github.com/makshc2/agent-orchestrator-kit/compare/v0.1.1...v0.1.2

package/README.md

@@ -64,6 +64,24 @@ npx agent-orchestrator-kit init \
   --lang uk
 ```
 
+For GitLab-hosted projects (verify via `prebuild` hook — no GitHub Actions):
+
+```bash
+npx agent-orchestrator-kit init --ci gitlab
+```
+
+This installs `.gitlab/agent-verify.yml`, injects `verify:openspec` and PM-aware `prebuild` into `package.json`. When DevOps runs `npm run build` (or yarn/pnpm build), npm lifecycle runs `prebuild` first → `npx openspec validate --all --strict` executes automatically.
+
+Optional dev-controlled CI before DevOps setup: copy `templates/.gitlab-ci.starter.yml.example` from the kit to `.gitlab-ci.yml` and adjust stages as needed.
+
+Skip CI files entirely:
+
+```bash
+npx agent-orchestrator-kit init --ci none
+```
+
+Default remains GitHub Actions (`--ci github`).
+
 ### Sync to local IDEs
 
 After init (and after every update):
@@ -80,7 +98,8 @@ This copies `.agents/` to your local IDE directories (not committed to git).
 your-project/
 ├── AGENTS.md
 ├── CLAUDE.md
-├── .github/workflows/agent-verify.yml   # CI: openspec validate + lint + build
+├── .github/workflows/agent-verify.yml   # CI (default --ci github)
+├── .gitlab/agent-verify.yml             # CI fragment (--ci gitlab)
 ├── .agents/
 │   ├── orchestrator.yaml
 │   ├── mcp.json.example                 # Cursor MCP template
@@ -106,7 +125,7 @@ your-project/
 | Orchestration | 5-role pipeline, `AGENTS.md`, `orchestrator.yaml`, review command |
 | OpenSpec skills | All 7 skills for `/opsx:*` workflow |
 | IDE sync | Cursor + Claude Code sync script |
-| CI | `agent-verify.yml` (openspec validate, lint, build, test) |
+| CI | `agent-verify.yml` — GitHub (default) or GitLab fragment + `prebuild` hook |
 | MCP templates | Memory MCP for Cursor and Amp |
 
 ### Not included (install separately)
@@ -285,7 +304,7 @@ npm run lint    # must pass
 
 ### Role 5: Verifier — CI (automatic)
 
-Installed at `.github/workflows/agent-verify.yml`:
+**GitHub (default `--ci github`):** installed at `.github/workflows/agent-verify.yml`:
 
 ```yaml
 - run: npx openspec validate --all --strict
@@ -294,6 +313,17 @@ Installed at `.github/workflows/agent-verify.yml`:
 - run: npm test --if-present
 ```
 
+**GitLab (`--ci gitlab`):** verify runs through the package manager build lifecycle — no GitHub Actions:
+
+```json
+"verify:openspec": "npx openspec validate --all --strict",
+"prebuild": "npm run verify:openspec"
+```
+
+When CI or a developer runs `npm run build`, npm executes `prebuild` first. DevOps pipelines that already call `npm run build` get OpenSpec validate with zero config changes.
+
+Optional: include `.gitlab/agent-verify.yml` in `.gitlab-ci.yml` for full lint/build/test verify before DevOps owns the root CI file. See kit `templates/.gitlab-ci.starter.yml.example`.
+
 Blocks merge if any gate fails.
 
 ---
@@ -429,6 +459,7 @@ npx agent-orchestrator-kit init [options]
   --profile <name>   Stack profile: generic | vue3 | node | mvp
   --lang <code>      Agent language: en | uk | ...
   --name <name>      Project name (default: directory name)
+  --ci <provider>    CI provider: gitlab | github | none (default: github)
   --force            Overwrite existing files
 
 npx agent-orchestrator-kit update
@@ -470,6 +501,16 @@ openspec/                # Committed — spec-driven workflow
 
 ## Changelog
 
+### 0.1.5
+- `init --ci gitlab|github|none` — GitLab verify via prebuild hook + CI fragment
+- PM-aware `verify:openspec` / `prebuild` injection for GitLab projects
+- `.gitlab/agent-verify.yml` template + starter example
+- `update` refreshes GitLab fragment; docs for GitLab verifier path
+
+### 0.1.4
+- Kit repo CI — `.github/workflows/agent-verify.yml`
+- OpenSpec devDependency for local and CI validation
+
 ### 0.1.3
 - Fix gitignore dedup (exact line match, not substring)
 - Add `.claude` to gitignore on init

package/bin/agent-orchestrator.js

@@ -28,9 +28,13 @@ const KIT_MANAGED_PATHS = [
   '.agents/rules',
   ...KIT_SKILL_DIRS.map((s) => `.agents/skills/${s}`),
   '.github/workflows/agent-verify.yml',
+  '.gitlab/agent-verify.yml',
   'scripts/sync-local-agent-skills.sh',
 ];
 
+const VALID_CI_PROVIDERS = ['gitlab', 'github', 'none'];
+const VERIFY_OPENSPEC_SCRIPT = 'npx openspec validate --all --strict';
+
 const GITIGNORE_LINES = ['.cursor', '.cursor/memory.json', '.amp/settings.json', '.claude'];
 
 const log = {
@@ -146,6 +150,79 @@ function installOpenspecConfigExample(projectDir, profile, vars, force) {
   }
 }
 
+function resolveCiProvider(ci) {
+  if (VALID_CI_PROVIDERS.includes(ci)) return ci;
+  log.warn(`Unknown --ci value "${ci}". Valid: ${VALID_CI_PROVIDERS.join(', ')}. Using github.`);
+  return 'github';
+}
+
+function injectVerifyScripts(projectDir, { pm }) {
+  const pkgPath = join(projectDir, 'package.json');
+  if (!existsSync(pkgPath)) {
+    log.warn('skip script injection: no package.json');
+    return;
+  }
+
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+  if (!pkg.scripts) pkg.scripts = {};
+
+  if (pkg.scripts['verify:openspec']) {
+    log.warn('skip (exists): verify:openspec script');
+  } else {
+    pkg.scripts['verify:openspec'] = VERIFY_OPENSPEC_SCRIPT;
+    log.ok('verify:openspec script added');
+  }
+
+  const runCmd = `${pm} run verify:openspec`;
+  const existingPrebuild = pkg.scripts.prebuild;
+
+  if (existingPrebuild && existingPrebuild.includes('verify:openspec')) {
+    log.warn('skip (exists): prebuild already chains verify:openspec');
+  } else if (existingPrebuild) {
+    pkg.scripts.prebuild = `${runCmd} && ${existingPrebuild}`;
+    log.ok('prebuild script chained');
+  } else {
+    pkg.scripts.prebuild = runCmd;
+    log.ok('prebuild script added');
+  }
+
+  writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+}
+
+function installCi(projectDir, templateDir, ci, force) {
+  if (ci === 'none') {
+    log.info('CI install skipped (--ci none)');
+    return;
+  }
+
+  if (ci === 'github') {
+    const githubWorkflow = join(templateDir, '.github', 'workflows', 'agent-verify.yml');
+    const githubDest = join(projectDir, '.github', 'workflows', 'agent-verify.yml');
+    if (!existsSync(githubWorkflow)) return;
+    if (!force && existsSync(githubDest)) {
+      log.warn('skip (exists): .github/workflows/agent-verify.yml');
+      return;
+    }
+    mkdirSync(dirname(githubDest), { recursive: true });
+    copyFileSync(githubWorkflow, githubDest);
+    log.ok('.github/workflows/agent-verify.yml');
+    return;
+  }
+
+  if (ci === 'gitlab') {
+    const gitlabFragment = join(templateDir, '.gitlab', 'agent-verify.yml');
+    const gitlabDest = join(projectDir, '.gitlab', 'agent-verify.yml');
+    if (!existsSync(gitlabFragment)) return;
+    if (!force && existsSync(gitlabDest)) {
+      log.warn('skip (exists): .gitlab/agent-verify.yml');
+      return;
+    }
+    mkdirSync(dirname(gitlabDest), { recursive: true });
+    copyFileSync(gitlabFragment, gitlabDest);
+    log.ok('.gitlab/agent-verify.yml');
+  }
+}
+
 function patchOrchestratorVerifier(projectDir, pm) {
   const orchPath = join(projectDir, '.agents', 'orchestrator.yaml');
   if (!existsSync(orchPath)) return;
@@ -168,7 +245,7 @@ function patchOrchestratorVerifier(projectDir, pm) {
   writeFileSync(orchPath, content);
 }
 
-function printNextSteps(profile, projectDir) {
+function printNextSteps(profile, projectDir, ci = 'github') {
   const pm = detectPackageManager(projectDir);
   const openspecReady = hasOpenSpec(projectDir);
   const lines = [`${pc.bold('Next steps:')}`];
@@ -206,6 +283,11 @@ function printNextSteps(profile, projectDir) {
     lines.push(`  ${pc.dim(`Detected package manager: ${pm} (verifier commands updated in orchestrator.yaml)`)}`);
   }
 
+  if (ci === 'gitlab') {
+    lines.push(`  ${pc.dim(`GitLab verify: ${pm} run build triggers prebuild → verify:openspec automatically`)}`);
+    lines.push(`  ${pc.dim('Optional dev CI: include local .gitlab/agent-verify.yml (see kit templates/.gitlab-ci.starter.yml.example)')}`);
+  }
+
   console.log('\n' + lines.join('\n') + '\n');
 }
 
@@ -236,17 +318,20 @@ program
   .option('--lang <lang>', 'Agent response language (en | uk | ...)', 'en')
   .option('--name <name>', 'Project name (defaults to directory name)')
   .option('--force', 'Overwrite existing files', false)
+  .option('--ci <provider>', 'CI provider: gitlab | github | none', 'github')
   .action((opts) => {
     const projectDir = process.cwd();
     const projectName = opts.name || basename(projectDir);
     const profile = resolveProfile(opts.profile);
     const pm = detectPackageManager(projectDir);
+    const ci = resolveCiProvider(opts.ci);
 
     log.title(`agent-orchestrator init  v${KIT_VERSION}`);
     log.info(`Project: ${projectName}`);
     log.info(`Profile: ${profile}`);
     log.info(`Language: ${opts.lang}`);
     log.info(`Package manager: ${pm}`);
+    log.info(`CI provider: ${ci}`);
 
     const templateDir = join(KIT_ROOT, 'templates');
     const profileDir = join(KIT_ROOT, 'profiles', profile);
@@ -265,16 +350,9 @@ program
     } catch {}
 
     log.title('Installing CI workflow');
-    const githubWorkflow = join(templateDir, '.github', 'workflows', 'agent-verify.yml');
-    const githubDest = join(projectDir, '.github', 'workflows', 'agent-verify.yml');
-    if (existsSync(githubWorkflow)) {
-      if (!opts.force && existsSync(githubDest)) {
-        log.warn('skip (exists): .github/workflows/agent-verify.yml');
-      } else {
-        mkdirSync(dirname(githubDest), { recursive: true });
-        copyFileSync(githubWorkflow, githubDest);
-        log.ok('.github/workflows/agent-verify.yml');
-      }
+    installCi(projectDir, templateDir, ci, opts.force);
+    if (ci === 'gitlab') {
+      injectVerifyScripts(projectDir, { pm });
     }
 
     log.title('Installing root files');
@@ -311,7 +389,7 @@ program
 
     log.title('Done');
     log.ok(`agent-orchestrator-kit v${KIT_VERSION} installed`);
-    printNextSteps(profile, projectDir);
+    printNextSteps(profile, projectDir, ci);
   });
 
 program

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-orchestrator-kit",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Universal AI agent orchestration kit for Cursor, Claude Code, and Amp Code — spec-driven pipeline with OpenSpec integration",
   "keywords": [
     "ai-agent",

package/templates/.gitlab/agent-verify.yml

@@ -0,0 +1,36 @@
+.agent-verify-base:
+  image: node:20
+  before_script:
+    - |
+      if [ -f pnpm-lock.yaml ]; then
+        export PM=pnpm
+        corepack enable
+        pnpm install --frozen-lockfile
+      elif [ -f yarn.lock ]; then
+        export PM=yarn
+        yarn install --frozen-lockfile
+      else
+        export PM=npm
+        npm ci
+      fi
+  script:
+    - npx openspec validate --all --strict
+    - |
+      run_pm_script() {
+        local name=$1
+        if [ "$PM" = "npm" ]; then
+          npm run "$name" --if-present
+        elif node -e "process.exit(require('./package.json').scripts?.['${name}'] ? 0 : 1)"; then
+          $PM run "$name"
+        fi
+      }
+      run_pm_script lint
+      run_pm_script build
+      run_pm_script test
+
+agent-verify:
+  extends: .agent-verify-base
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+    - if: $CI_COMMIT_BRANCH == "develop"

package/templates/.gitlab-ci.starter.yml.example

@@ -0,0 +1,5 @@
+include:
+  - local: '.gitlab/agent-verify.yml'
+
+agent-verify:
+  extends: .agent-verify-base

package/templates/AGENTS.md

@@ -24,6 +24,8 @@ Never mix phases in one chat — this is the single most important rule.
 | Implementer | `/opsx:apply <name>` | writes `src/` | strong |
 | Verifier | CI (automatic) | scripts only | — |
 
+Verifier runs on **GitHub Actions** (default) or **GitLab** via `prebuild` → `verify:openspec` when using `init --ci gitlab`. GitLab projects do not use `.github/workflows/`.
+
 ## Hard Rules
 
 - **One active change per developer** at a time.