@aifabrix/builder 2.52.1 → 2.53.1

package/lib/integration-definition/openapi-enrichment/hubspot-crm-companies.json

@@ -1,205 +0,0 @@
-{
-  "openapi": "3.0.1",
-  "info": {
-    "title": "CRM Companies (enrichment fixture)",
-    "version": "1.0.0"
-  },
-  "paths": {
-    "/crm/v3/objects/companies": {
-      "get": {
-        "operationId": "get-/crm/v3/objects/companies",
-        "summary": "List companies",
-        "parameters": [
-          {
-            "name": "limit",
-            "in": "query",
-            "schema": { "type": "integer" }
-          },
-          {
-            "name": "after",
-            "in": "query",
-            "schema": { "type": "string" }
-          },
-          {
-            "name": "properties",
-            "in": "query",
-            "schema": { "type": "string" }
-          },
-          {
-            "name": "associations",
-            "in": "query",
-            "schema": { "type": "string" }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Results use paging.next.after as the cursor for the next page.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "results": {
-                      "type": "array",
-                      "items": { "$ref": "#/components/schemas/Company" }
-                    },
-                    "paging": {
-                      "type": "object",
-                      "properties": {
-                        "next": {
-                          "type": "object",
-                          "properties": {
-                            "after": { "type": "string" }
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          }
-        }
-      },
-      "post": {
-        "operationId": "post-/crm/v3/objects/companies",
-        "summary": "Create company",
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "properties": {
-                    "type": "object",
-                    "additionalProperties": { "type": "string" }
-                  }
-                }
-              }
-            }
-          }
-        },
-        "responses": {
-          "201": {
-            "description": "Created",
-            "content": {
-              "application/json": {
-                "schema": { "$ref": "#/components/schemas/Company" }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/crm/v3/objects/companies/{companyId}": {
-      "get": {
-        "operationId": "get-/crm/v3/objects/companies/{companyId}",
-        "summary": "Get company",
-        "parameters": [
-          {
-            "name": "companyId",
-            "in": "path",
-            "required": true,
-            "schema": { "type": "string" }
-          },
-          {
-            "name": "properties",
-            "in": "query",
-            "schema": { "type": "string" }
-          },
-          {
-            "name": "associations",
-            "in": "query",
-            "schema": { "type": "string" }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK",
-            "content": {
-              "application/json": {
-                "schema": { "$ref": "#/components/schemas/Company" }
-              }
-            }
-          }
-        }
-      },
-      "patch": {
-        "operationId": "patch-/crm/v3/objects/companies/{companyId}",
-        "summary": "Update company",
-        "parameters": [
-          {
-            "name": "companyId",
-            "in": "path",
-            "required": true,
-            "schema": { "type": "string" }
-          }
-        ],
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "properties": {
-                    "type": "object",
-                    "additionalProperties": { "type": "string" }
-                  }
-                }
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "OK",
-            "content": {
-              "application/json": {
-                "schema": { "$ref": "#/components/schemas/Company" }
-              }
-            }
-          }
-        }
-      },
-      "delete": {
-        "operationId": "delete-/crm/v3/objects/companies/{companyId}",
-        "summary": "Delete company",
-        "parameters": [
-          {
-            "name": "companyId",
-            "in": "path",
-            "required": true,
-            "schema": { "type": "string" }
-          }
-        ],
-        "responses": {
-          "204": { "description": "No Content" }
-        }
-      }
-    }
-  },
-  "components": {
-    "schemas": {
-      "Company": {
-        "type": "object",
-        "properties": {
-          "id": { "type": "string" },
-          "properties": {
-            "type": "object",
-            "properties": {
-              "name": { "type": "string" },
-              "country": { "type": "string" }
-            },
-            "additionalProperties": { "type": "string" }
-          },
-          "associations": {
-            "type": "object",
-            "additionalProperties": true
-          }
-        }
-      }
-    }
-  }
-}

package/packages/builder-api/README.md

@@ -1,120 +0,0 @@
-# @aifabrix/builder-api (154.0)
-
-HTTP orchestration layer for external-system workspace lifecycle. V1 uses the shared
-`lib/programmatic/` adapter over existing Builder CLI libraries (no duplicate facades).
-
-## Run with Builder CLI (recommended)
-
-From the **aifabrix-builder** repository root:
-
-```bash
-# From aifabrix-builder repo root
-aifabrix auth status
-aifabrix up-platform              # full stack (includes builder-api)
-# or incremental when miso + dataplane already run:
-aifabrix up-builder-api
-aifabrix resolve builder-api      # refresh .env from env.template
-aifabrix run builder-api --reload
-```
-
-Hot reload (bind-mount repo root, same pattern as dataplane / miso-controller):
-
-```bash
-pnpm run dev-reload
-# or: aifabrix run builder-api --reload
-```
-
-Logs, stop, and lifecycle match other Builder-managed apps:
-
-```bash
-aifabrix logs builder-api
-aifabrix down-app builder-api
-```
-
-Health (adjust port for your `developer-id`): `GET http://localhost:3105/api/v1/builder/health` (dev 1 → `3005 + 100`).
-
-ReDoc (same as dataplane / miso-controller): `GET http://localhost:3105/api/docs`  
-OpenAPI JSON: `GET /api/v1/builder/api-docs/openapi.json`
-
-Platform integration SSOT lives under `integration/` in the builder repo. Publish Enterprise MCP anchor and repository provider integrations before workspace flows:
-
-```bash
-aifabrix upload enterprise-integration-lifecycle --probe
-aifabrix upload <repository-provider-systemKey> --probe
-pnpm run dev-reload   # builder-api container
-```
-
-See `integration/README.md` in the builder repo.
-
-## Run on host (development / tests only)
-
-For Jest e2e and quick iteration without Docker, resolve from `builder/builder-api/env.template` (uses `url://` tokens like miso-controller/dataplane) or set localhost URLs manually:
-
-```bash
-aifabrix resolve builder-api   # preferred — expands url://miso-controller-internal, url://dataplane-internal, url://keycloak-*
-
-# or manual host overrides:
-export WORKSPACE_ROOT=/tmp/builder-workspaces
-export MISO_CLIENTID=miso-controller-dev-builder-api
-export MISO_CLIENTSECRET=<from aifabrix app register builder-api>
-export MISO_CONTROLLER_URL=http://localhost:3100/miso
-export DATAPLANE_URL=http://localhost:3101/data
-export DEFAULT_ENVIRONMENT=dev
-
-pnpm run dev
-# or Nest bootstrap: npm run builder-api:nest
-```
-
-## Workspace cleanup
-
-Scheduled purge of stale draft workspaces (env `WORKSPACE_DRAFT_TTL_DAYS`, `WORKSPACE_INACTIVE_MAX_DAYS`):
-
-```bash
-npm run builder-api:cleanup
-npm run builder-api:cleanup -- --dry-run
-```
-
-In Docker, schedule via platform cron or sidecar invoking `node bin/builder-api-cleanup.js`.
-
-## Package layout
-
-```text
-builder/builder-api/                    # SSOT (edit here; npm run sync-json → template)
-templates/applications/builder-api/   # Shipped template copy
-packages/builder-api/
-  src/main.ts                           # Nest bootstrap → nest-http-bridge
-  src/app.module.ts
-  MANUAL-CHECKLIST.md
-lib/programmatic/                       # Shared HTTP handlers + Enterprise MCP client
-```
-
-Compile TypeScript: `npm run builder-api:build` (output in `packages/builder-api/dist/`).
-
-## 154.1 routes (Enterprise MCP client)
-
-Provider-neutral HTTP orchestration — remote repository/template via Dataplane Enterprise MCP:
-
-- `POST /systems/{systemKey}/template/materialize`
-- `GET /systems/{systemKey}/workspace/status`
-- `POST /systems/{systemKey}/workspace/diff` / `workspace/reset`
-- `POST /systems/{systemKey}/repository/sync` / `create-review` / `dispatch-pipeline`
-- `GET /systems/{systemKey}/repository/status`
-
-Governance gates use existing Dataplane lifecycle / verify-trust APIs (no can-execute proxy in builder-api V1).
-
-Architecture CI: `npm run check:builder-api-arch`
-
-All other routes require `Authorization: Bearer <token from aifabrix login>`.
-
-See `MANUAL-CHECKLIST.md` for manual verification, `docs/external-systems.md` and `docs/wizard.md` for integration workflow context.
-
-## Nest migration
-
-This package currently reuses the Node HTTP server in `lib/programmatic/builder-api-server.js`.
-NestJS scaffold wraps the same `route-handlers` module via `nest-http-bridge.js`.
-
-## Not builder-server
-
-This service is **not** the dev onboarding `builder-server`. It is stateless multi-user workspace
-orchestration with Dataplane as governance authority. Do **not** use ad hoc `docker compose` under
-`packages/builder-api/` — use `aifabrix run builder-api` for the full application lifecycle.

package/packages/builder-api/package.json

@@ -1,30 +0,0 @@
-{
-  "name": "@aifabrix/builder-api",
-  "version": "0.1.0",
-  "description": "AI Fabrix Builder API — HTTP orchestration for external system lifecycle (plan 154.0)",
-  "private": true,
-  "main": "../../lib/programmatic/builder-api-server.js",
-  "bin": {
-    "builder-api": "../../bin/builder-api-spike.js",
-    "builder-api-nest": "../../bin/builder-api-nest.js"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "start": "node ../../bin/builder-api-spike.js",
-    "start:nest": "node ../../bin/builder-api-nest.js",
-    "cleanup": "node ../../bin/builder-api-cleanup.js"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@aifabrix/miso-client": "4.19.0"
-  },
-  "peerDependencies": {
-    "@nestjs/common": "^10.0.0",
-    "@nestjs/core": "^10.0.0",
-    "@nestjs/platform-express": "^10.0.0",
-    "reflect-metadata": "^0.2.0",
-    "rxjs": "^7.8.0"
-  }
-}

package/packages/builder-api/src/app.module.ts

@@ -1,7 +0,0 @@
-import { Module } from '@nestjs/common';
-
-/**
- * Root Nest module — HTTP routing is delegated to lib/programmatic via nest-http-bridge.
- */
-@Module({})
-export class AppModule {}

package/packages/builder-api/src/auth/auth.module.ts

@@ -1,5 +0,0 @@
-import { Module } from '@nestjs/common';
-
-/** Placeholder for future BearerAuthGuard wiring (V1 auth runs in lib/programmatic). */
-@Module({})
-export class AuthModule {}

package/packages/builder-api/src/external-system/external-system.module.ts

@@ -1,5 +0,0 @@
-import { Module } from '@nestjs/common';
-
-/** Placeholder for route-group modules; handlers live in lib/programmatic today. */
-@Module({})
-export class ExternalSystemModule {}

package/packages/builder-api/src/main.ts

@@ -1,16 +0,0 @@
-import 'reflect-metadata';
-import { NestFactory } from '@nestjs/core';
-import { AppModule } from './app.module';
-
-async function bootstrap() {
-  const app = await NestFactory.create(AppModule, { bodyParser: false });
-  // eslint-disable-next-line @typescript-eslint/no-require-imports
-  const { wireBuilderApiHttpBridge, BASE } = require('../../../lib/programmatic/nest-http-bridge');
-  wireBuilderApiHttpBridge(app.getHttpAdapter().getInstance());
-  const port = Number(process.env.PORT || 3005);
-  await app.listen(port);
-  // eslint-disable-next-line no-console
-  console.log(`builder-api (Nest) listening on http://localhost:${port}${BASE}/health`);
-}
-
-bootstrap();

package/packages/builder-api/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "module": "commonjs",
-    "target": "ES2020",
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true,
-    "skipLibCheck": true,
-    "declaration": false
-  },
-  "include": ["src/**/*.ts"]
-}

package/scripts/check-builder-api-architecture-grep.js

@@ -1,79 +0,0 @@
-#!/usr/bin/env node
-/**
- * Architecture grep gate for builder-api (plan 154.1).
- *
- * Fails when provider-specific strings appear under lib/programmatic or packages/builder-api.
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const ROOT = path.join(__dirname, '..');
-const SCAN_DIRS = ['lib/programmatic', 'packages/builder-api'];
-const FORBIDDEN = /\b(github|gitlab|bitbucket|octokit|azuredevops|azure devops|git clone)\b/i;
-const ALLOWLIST = new Set([
-  path.normalize('lib/programmatic/openapi-descriptions.js'),
-  path.normalize('lib/programmatic/openapi-spec.js'),
-  path.normalize('packages/builder-api/MANUAL-CHECKLIST.md')
-]);
-
-/**
- * Recursively collect scannable files under a directory.
- * @param {string} dir - Directory path to scan
- * @param {string[]} files - Output file list
- * @returns {void}
- */
-function walk(dir, files) {
-  if (!fs.existsSync(dir)) {
-    return;
-  }
-  for (const name of fs.readdirSync(dir)) {
-    const full = path.join(dir, name);
-    const stat = fs.statSync(full);
-    if (stat.isDirectory()) {
-      walk(full, files);
-      continue;
-    }
-    if (!/\.(js|ts|md|json|yml|yaml)$/.test(name)) {
-      continue;
-    }
-    files.push(full);
-  }
-}
-
-/** @type {string[]} */
-const files = [];
-for (const rel of SCAN_DIRS) {
-  walk(path.join(ROOT, rel), files);
-}
-
-/** @type {Array<{ file: string, line: number, text: string }>} */
-const violations = [];
-
-for (const file of files) {
-  const rel = path.normalize(path.relative(ROOT, file));
-  if (ALLOWLIST.has(rel)) {
-    continue;
-  }
-  const content = fs.readFileSync(file, 'utf8');
-  content.split('\n').forEach((line, index) => {
-    if (FORBIDDEN.test(line)) {
-      violations.push({ file: rel, line: index + 1, text: line.trim() });
-    }
-  });
-}
-
-if (violations.length > 0) {
-  // eslint-disable-next-line no-console
-  console.error('builder-api architecture grep failed:');
-  for (const row of violations) {
-    // eslint-disable-next-line no-console
-    console.error(`  ${row.file}:${row.line}: ${row.text}`);
-  }
-  process.exit(1);
-}
-
-// eslint-disable-next-line no-console
-console.log('builder-api architecture grep passed');

package/scripts/check-datasource-test-run-schema-sync.js

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-/**
- * CI helper: fail when Builder lib/schema/datasource-test-run.schema.json drifts from Dataplane copy.
- * @fileoverview Schema sync gate (plan §8.1)
- */
-/* eslint-disable no-console -- CLI script */
-
-const path = require('path');
-const { assertDatasourceTestRunSchemasInSync } = require('../lib/utils/datasource-test-run-schema-sync');
-
-const root = path.join(__dirname, '..');
-const builderSchema = path.join(root, 'lib/schema/datasource-test-run.schema.json');
-const dpRoot = process.env.AIFABRIX_DATAPLANE_ROOT || path.join(root, '..', 'aifabrix-dataplane');
-const dataplaneSchema = path.join(dpRoot, 'app/schemas/json/datasource-test-run.schema.json');
-
-const strict = process.env.AIFABRIX_SCHEMA_SYNC_STRICT === '1';
-
-try {
-  const result = assertDatasourceTestRunSchemasInSync(builderSchema, dataplaneSchema);
-  if (result.skipped) {
-    const msg = result.reason || 'Dataplane schema path missing';
-    if (strict) {
-      console.error(`Schema sync failed (strict): ${msg}`);
-      process.exit(1);
-    }
-    console.warn(`Schema sync skipped: ${msg}`);
-    process.exit(0);
-  }
-  console.log(`DatasourceTestRun schema OK (sha256 ${result.builderSha})`);
-  process.exit(0);
-} catch (e) {
-  console.error(e.message || String(e));
-  process.exit(1);
-}

package/scripts/ci-fix.sh

@@ -1,19 +0,0 @@
-#!/bin/bash
-# CI Fix Script Wrapper
-# This script is a wrapper that calls the actual CI fix script
-# located in tests/scripts/ci-fix.sh
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ACTUAL_SCRIPT="$SCRIPT_DIR/../tests/scripts/ci-fix.sh"
-
-if [ ! -f "$ACTUAL_SCRIPT" ]; then
-  echo "Error: CI fix script not found at $ACTUAL_SCRIPT" >&2
-  exit 1
-fi
-
-# Make sure the script is executable
-chmod +x "$ACTUAL_SCRIPT" 2>/dev/null || true
-
-# Execute the actual script
-exec "$ACTUAL_SCRIPT" "$@"
-

package/scripts/ci-simulate.sh

@@ -1,19 +0,0 @@
-#!/bin/bash
-# CI Simulation Script Wrapper
-# This script is a wrapper that calls the actual CI simulation script
-# located in tests/scripts/ci-simulate.sh
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ACTUAL_SCRIPT="$SCRIPT_DIR/../tests/scripts/ci-simulate.sh"
-
-if [ ! -f "$ACTUAL_SCRIPT" ]; then
-  echo "Error: CI simulation script not found at $ACTUAL_SCRIPT" >&2
-  exit 1
-fi
-
-# Make sure the script is executable
-chmod +x "$ACTUAL_SCRIPT" 2>/dev/null || true
-
-# Execute the actual script
-exec "$ACTUAL_SCRIPT" "$@"
-