@crossdelta/platform-sdk 0.13.0 → 0.13.2

package/bin/templates/workspace/.github/actions/resolve-scope-tags/index.js

@@ -1,398 +0,0 @@
-/**
- * Resolve Scope Tags Action
- *
- * Determines the correct Docker image tags for all deployable scopes.
- * Uses change markers from the build job when available, falls back to
- * querying GHCR for the latest tag if a scope wasn't rebuilt.
- *
- * This action bridges the build and deploy jobs by mapping scope short names
- * to their checksum-based image tags.
- *
- * @example
- * - uses: ./.github/actions/resolve-scope-tags
- *   with:
- *     markers-dir: .artifacts
- *     scope-roots: apps,services
- *     github-token: ${{ secrets.GITHUB_TOKEN }}
- *
- * @outputs scope_image_tags - JSON map of shortName -> checksum tag
- */
-
-const { appendFileSync } = require('node:fs')
-const { existsSync, lstatSync, readdirSync, readFileSync, statSync } = require('node:fs')
-const { basename, join, relative } = require('node:path')
-
-// Default directories to scan for scopes (Turborepo convention)
-const defaultRoots = ['apps', 'services']
-
-// Prefix for change marker artifact directories
-const changedMarkerPrefix = 'changed-'
-
-// Maximum pages to check when querying GHCR for existing tags
-const maxPages = Number(process.env.TAG_CHECK_MAX_PAGES ?? '10')
-
-// ============================================================================
-// Input/Output Helpers
-// ============================================================================
-
-/**
- * Builds environment variable keys for GitHub Actions inputs.
- * @param {string} name - Input name
- * @returns {string[]} Possible environment variable keys
- */
-const buildInputKeys = (name) => {
-  const trimmed = name.trim()
-  const upper = trimmed.toUpperCase()
-  const normalized = upper.replace(/[^A-Z0-9]+/g, '_')
-  return Array.from(new Set([`INPUT_${upper}`, `INPUT_${normalized}`]))
-}
-
-/**
- * Retrieves a GitHub Actions input value from environment variables.
- * @param {string} name - Input name as defined in action.yml
- * @param {Object} options - Options
- * @param {boolean} [options.required=false] - Whether the input is required
- * @param {string} [options.defaultValue=''] - Default value if input is not set
- * @returns {string} The input value
- */
-const getInput = (name, { required = false, defaultValue = '' } = {}) => {
-  const keys = buildInputKeys(name)
-  const raw = keys.map((key) => process.env[key]).find((value) => typeof value === 'string')
-  const value = typeof raw === 'string' ? raw.trim() : defaultValue
-
-  if (required && !value) {
-    console.error(`Input "${name}" is required`)
-    process.exit(1)
-  }
-
-  return value
-}
-
-/**
- * Sets a GitHub Actions output value.
- * @param {string} name - Output name
- * @param {string} value - Output value
- */
-const setOutput = (name, value) => {
-  const outputFile = process.env.GITHUB_OUTPUT
-  if (outputFile) {
-    appendFileSync(outputFile, `${name}=${value}\n`)
-  } else {
-    console.log(`${name}=${value}`)
-  }
-}
-
-/**
- * Parses a comma/space separated list into an array.
- * @param {string} value - Input string
- * @returns {string[]} Array of parsed items
- */
-const parseList = (value) => {
-  if (!value) return []
-
-  return value
-    .split(/[^a-zA-Z0-9._-]+/)
-    .map((entry) => entry.trim())
-    .filter(Boolean)
-}
-
-// ============================================================================
-// Configuration
-// ============================================================================
-
-const markersDir = getInput('markers-dir', { defaultValue: '.artifacts' })
-const scopeRoots = parseList(getInput('scope-roots'))
-const deployableScopes = parseList(getInput('deployable-scopes'))
-const allowMissingScopes = new Set(parseList(getInput('allow-missing-scopes')))
-const githubToken = getInput('github-token', { required: true })
-
-// Optional inputs - defaults from environment for portability
-const repositoryOwner = getInput('repository-owner', { defaultValue: process.env.GITHUB_REPOSITORY_OWNER })
-const repositoryPrefixInput = getInput('repository-prefix')
-const repositoryPrefix =
-  repositoryPrefixInput || process.env.GHCR_REPOSITORY_PREFIX || process.env.GITHUB_REPOSITORY?.split('/')[1] || 'platform'
-
-// ============================================================================
-// Scope Discovery
-// ============================================================================
-
-const loadRoots = () => (scopeRoots.length > 0 ? scopeRoots : defaultRoots)
-
-/**
- * Resolves the scope name from package.json or falls back to directory name.
- * @param {string} entryPath - Path to the scope directory
- * @param {string} fallback - Fallback name (usually directory basename)
- * @returns {string} The resolved scope name
- */
-const resolveScopeName = (entryPath, fallback) => {
-  const pkgPath = join(entryPath, 'package.json')
-
-  if (!existsSync(pkgPath)) return fallback
-
-  try {
-    const raw = readFileSync(pkgPath, 'utf8')
-    const pkg = JSON.parse(raw)
-    if (typeof pkg.name === 'string' && pkg.name.trim().length > 0) {
-      return pkg.name
-    }
-  } catch (error) {
-    console.error(`Failed to read package.json for ${entryPath}:`, error)
-    process.exit(1)
-  }
-
-  return fallback
-}
-
-const processScopeEntry = (root, entry, scopes) => {
-  const entryPath = join(root, entry)
-
-  const isDirectory = statSync(entryPath).isDirectory()
-  if (!isDirectory) return
-
-  const dockerfilePath = join(entryPath, 'Dockerfile')
-  const hasDockerfile = existsSync(dockerfilePath)
-  if (!hasDockerfile) return
-
-  const scopeName = resolveScopeName(entryPath, entry)
-  if (scopes.has(scopeName)) return
-
-  const relativeDir = relative(process.cwd(), entryPath).replace(/\\/g, '/')
-  scopes.set(scopeName, {
-    name: scopeName,
-    dir: relativeDir,
-    shortName: basename(relativeDir),
-  })
-}
-
-const discoverScopes = (roots) => {
-  const scopes = new Map()
-
-  for (const root of roots) {
-    let entries = []
-    try {
-      entries = readdirSync(root)
-    } catch (error) {
-      if (error.code === 'ENOENT') {
-        continue
-      }
-      throw error
-    }
-
-    for (const entry of entries) {
-      processScopeEntry(root, entry, scopes)
-    }
-  }
-
-  return scopes
-}
-
-const loadMetadata = () => {
-  const metadataByScope = new Map()
-  if (!existsSync(markersDir)) {
-    return metadataByScope
-  }
-
-  const markers = readdirSync(markersDir).filter((name) => name.startsWith(changedMarkerPrefix))
-
-  for (const marker of markers) {
-    const markerPath = join(markersDir, marker)
-    if (!existsSync(markerPath)) continue
-
-    if (!lstatSync(markerPath).isDirectory()) continue
-    const metadataPath = join(markerPath, 'metadata.json')
-    if (!existsSync(metadataPath) || !lstatSync(metadataPath).isFile()) continue
-
-    try {
-      const raw = readFileSync(metadataPath, 'utf8')
-      const parsed = JSON.parse(raw)
-      if (
-        parsed &&
-        typeof parsed.shortName === 'string' &&
-        parsed.shortName.trim() &&
-        typeof parsed.imageTag === 'string' &&
-        parsed.imageTag.trim()
-      ) {
-        metadataByScope.set(parsed.shortName.trim(), parsed.imageTag.trim())
-      }
-    } catch (error) {
-      console.warn(`Unable to parse metadata at ${metadataPath}:`, error)
-    }
-  }
-
-  return metadataByScope
-}
-
-const headers = {
-  Authorization: `Bearer ${githubToken}`,
-  Accept: 'application/vnd.github+json',
-  'X-GitHub-Api-Version': '2022-11-28',
-}
-
-const repositoryOwnerTypeInput = getInput('repository-owner-type').toLowerCase()
-const ownerTypeCandidates = (() => {
-  if (repositoryOwnerTypeInput === 'user' || repositoryOwnerTypeInput === 'users') {
-    return ['users']
-  }
-
-  if (
-    repositoryOwnerTypeInput === 'org' ||
-    repositoryOwnerTypeInput === 'orgs' ||
-    repositoryOwnerTypeInput === 'organization'
-  ) {
-    return ['orgs']
-  }
-
-  return ['orgs', 'users']
-})()
-
-const requestPackageVersions = async (encodedPackage, page, ownerType) => {
-  const ownerSegment = ownerType === 'users' ? 'users' : 'orgs'
-  const url = `https://api.github.com/${ownerSegment}/${repositoryOwner}/packages/container/${encodedPackage}/versions?per_page=100&page=${page}`
-  const response = await fetch(url, { headers })
-
-  if (response.status === 404) {
-    return { notFound: true, versions: [], hasMore: false }
-  }
-
-  if (!response.ok) {
-    const text = await response.text()
-    throw new Error(`GitHub API error (${response.status}): ${text}`)
-  }
-
-  const data = await response.json()
-  const versions = Array.isArray(data) ? data : []
-
-  return {
-    versions,
-    hasMore: versions.length === 100,
-    notFound: false,
-  }
-}
-
-const pickChecksumTag = (versions) => {
-  for (const version of versions) {
-    const tags = version?.metadata?.container?.tags
-    if (!Array.isArray(tags)) continue
-
-    // Prefer checksum tag (64 hex chars), fallback to 'latest'
-    const checksumTag = tags.find((tag) => typeof tag === 'string' && /^[0-9a-f]{64}$/.test(tag))
-    if (checksumTag) {
-      return checksumTag
-    }
-  }
-
-  // If no checksum tag found, look for 'latest' tag
-  for (const version of versions) {
-    const tags = version?.metadata?.container?.tags
-    if (!Array.isArray(tags)) continue
-
-    if (tags.includes('latest')) {
-      return 'latest'
-    }
-  }
-
-  return null
-}
-
-const fetchLatestChecksumTag = async (packageName) => {
-  const encodedPackage = encodeURIComponent(packageName)
-
-  for (const ownerType of ownerTypeCandidates) {
-    let ownerMissing = false
-
-    for (let page = 1; page <= maxPages; page += 1) {
-      const { versions, hasMore, notFound } = await requestPackageVersions(encodedPackage, page, ownerType)
-      if (notFound) {
-        ownerMissing = true
-        break
-      }
-
-      const checksumTag = pickChecksumTag(versions)
-      if (checksumTag) {
-        return checksumTag
-      }
-
-      if (!hasMore) {
-        break
-      }
-    }
-
-    if (ownerMissing) {
-      console.warn(
-        `Container package ${packageName} not found under ${ownerType === 'users' ? 'user' : 'organization'} ${repositoryOwner}. Trying alternate scope.`,
-      )
-      continue
-    }
-
-    break
-  }
-
-  return null
-}
-
-const main = async () => {
-  const roots = loadRoots()
-  const discoveredScopes = Array.from(discoverScopes(roots).values())
-  const scopes = (() => {
-    if (deployableScopes.length === 0) {
-      return discoveredScopes
-    }
-
-    const scopeMap = new Map(discoveredScopes.map((scope) => [scope.shortName, scope]))
-    const selected = []
-
-    for (const name of deployableScopes) {
-      const match = scopeMap.get(name)
-      if (match) {
-        selected.push(match)
-      } else {
-        console.warn(`DEPLOYABLE_SCOPES entry "${name}" was not found among discovered scopes`)
-      }
-    }
-
-    return selected
-  })()
-
-  const metadataByScope = loadMetadata()
-
-  if (scopes.length === 0) {
-    console.warn('No scopes discovered; emitting empty scope_image_tags output')
-    setOutput('scope_image_tags', '{}')
-    return
-  }
-
-  const result = {}
-  const missing = []
-
-  // Get registry URL from environment (e.g., "ghcr.io/orderboss/platform")
-  const registry = process.env.REGISTRY || `ghcr.io/${repositoryOwner}/${repositoryPrefix}`
-
-  for (const scope of scopes) {
-    const metadataTag = metadataByScope.get(scope.shortName)
-    const imageTag = metadataTag || (await fetchLatestChecksumTag(`${repositoryPrefix}/${scope.shortName}`))
-
-    if (!imageTag) {
-      if (allowMissingScopes.has(scope.shortName)) {
-        console.warn(`Skipping unresolved scope ${scope.shortName} (allowed missing)`)
-        continue
-      }
-      missing.push(scope.shortName)
-      continue
-    }
-
-    // Build full image URL: registry/service:tag
-    result[scope.shortName] = `${registry}/${scope.shortName}:${imageTag}`
-  }
-
-  if (missing.length > 0) {
-    console.error('Unable to resolve image tags for scopes:', missing.join(', '))
-    process.exit(1)
-  }
-
-  setOutput('scope_image_tags', JSON.stringify(result))
-}
-
-main().catch((error) => {
-  console.error('resolve-scope-tags action failed:', error)
-  process.exit(1)
-})

package/bin/templates/workspace/.github/actions/setup-bun-install/action.yml.hbs

@@ -1,57 +0,0 @@
-name: Setup Bun and install dependencies
-description: Installs Bun, optionally restores cache, and runs Bun install commands.
-author: {{githubOwner}}
-
-inputs:
-  working-directory:
-    description: Directory to run the install command in.
-    default: .
-  install-command:
-    description: Command to install dependencies.
-    default: bun install --frozen-lockfile
-  enable-cache:
-    description: Whether to run the cache step.
-    default: 'false'
-  cache-key:
-    description: Cache key to use when caching is enabled.
-    default: ''
-  cache-restore-keys:
-    description: Restore keys for the cache step.
-    default: ''
-  cache-paths:
-    description: Newline-delimited paths to include in the cache.
-    default: |
-      ~/.bun
-      node_modules
-  bun-version-file:
-    description: Path to a file containing the Bun version (passed to setup-bun).
-    default: ''
-  npm-token:
-    description: NPM token for private registry access.
-    required: false
-    default: ''
-
-runs:
-  using: composite
-  steps:
-    - name: Install Bun
-      uses: oven-sh/setup-bun@v2
-      with:
-        bun-version-file: $\{{ inputs.bun-version-file }}
-
-    - name: Cache dependencies
-      if: $\{{ inputs.enable-cache == 'true' && inputs.cache-key != '' }}
-      uses: actions/cache@v4
-      with:
-        path: $\{{ inputs.cache-paths }}
-        key: $\{{ inputs.cache-key }}
-        restore-keys: $\{{ inputs.cache-restore-keys }}
-
-    - name: Install dependencies
-      shell: bash
-      env:
-        NPM_TOKEN: $\{{ inputs.npm-token }}
-      run: |
-        set -euo pipefail
-        cd "$\{{ inputs.working-directory }}"
-        $\{{ inputs.install-command }}

package/bin/templates/workspace/.github/copilot-chat-configuration.json

@@ -1,49 +0,0 @@
-{
-  "version": 1,
-  "scope": {
-    "include": [
-      "apps",
-      "services",
-      "packages",
-      "infra"
-    ],
-    "exclude": [
-      "node_modules",
-      "dist",
-      "build",
-      "coverage",
-      ".turbo",
-      ".github"
-    ]
-  },
-  "guidelines": [
-    "This repository is a Bun-based monorepo orchestrated with Turborepo. Prefer using existing scripts from package.json instead of introducing custom build steps.",
-    "For backend services, use Hono or NestJS depending on the service. Do not introduce new server frameworks such as Express or Fastify.",
-    "Payload validation must be implemented using Zod. Types should be inferred from Zod schemas (z.infer) rather than manually defined or using any.",
-    "Infrastructure is defined via Pulumi inside the infra/ folder. New services must follow existing ServiceConfig patterns inside infra/services/*.ts.",
-    "Code style follows the Biome configuration (biome.json): single quotes, no semicolons, 2-space indentation, and the configured max line width.",
-    "Commit messages must follow Conventional Commits (feat:, fix:, chore:, docs:) to support release automation.",
-    "Before introducing new patterns, inspect existing examples in the same folder or similar services/packages and follow them closely.",
-    "Code should be elegant, readable, and intentionally simple. Prefer clarity over clever constructs.",
-    "Comments, inline documentation, and JSDoc must be written in English.",
-    "Avoid overly complex or deeply nested functions. Keep functions small, focused, and with a single responsibility.",
-    "Avoid unnecessary higher-order abstractions or generic-heavy over-engineering. Only introduce abstractions when they simplify the implementation."
-  ],
-  "quickPrompts": [
-    {
-      "name": "Scaffold New Hono Microservice",
-      "description": "Create a new Hono-based microservice using the platform-sdk.",
-      "prompt": "Use the platform-sdk to scaffold a new Hono microservice. Run `bun pf new hono-micro services/<service-name>` and ensure the generated structure follows the existing pattern: telemetry as the first import, a health endpoint, proper port resolution from environment variables, and a matching infra config under infra/services/<service-name>.ts."
-    },
-    {
-      "name": "Scaffold New NestJS Microservice",
-      "description": "Generate a NestJS microservice using platform-sdk conventions.",
-      "prompt": "Use `bun pf new nest-micro services/<service-name>` to generate a new NestJS microservice. Follow the established folder structure, ensure telemetry is loaded first, and apply the project's conventions. Rely on the generated template instead of inventing a custom layout."
-    },
-    {
-      "name": "Create Service Infra Config",
-      "description": "Generate a Pulumi ServiceConfig using existing infra patterns.",
-      "prompt": "Create a new ServiceConfig file inside infra/services based on existing configurations. Include name, containerPort, healthCheck, env variables, and required secrets. Keep the configuration clean and document special aspects in English."
-    }
-  ]
-}

package/bin/templates/workspace/.github/copilot-instructions.md.hbs

@@ -1,72 +0,0 @@
-# Copilot Instructions (Project-Agnostic, TypeScript-Focused)
-
-You are assisting in TypeScript-first monorepos using modern TypeScript tooling such as Bun or Node, Turborepo, Hono, NestJS, Zod, event-driven patterns, and Pulumi/Kubernetes infrastructure.
-
-Always generate **minimal diffs**, never full rewrites.
-
-## General Behavior
-- Produce short, focused, code-first answers.
-- Modify only the necessary parts.
-- Analyze only the opened file unless explicitly asked.
-- Follow existing architecture and naming conventions.
-- Prefer strict typing; avoid `any`.
-- **Reuse existing code**: Before implementing new functionality, search the codebase for existing functions, utilities, or services that can be reused. Avoid duplicating logic.
-
-## Code Style
-- Single quotes, no semicolons, 2-space indent, trailing commas.
-- Alphabetically sorted imports; no unused imports.
-- Arrow functions over `function` declarations.
-- Template literals over string concatenation.
-- Prefer pure and functional programming patterns (map/filter/reduce).
-- Avoid mutable state and imperative loops.
-- No decorative section header blocks (no ASCII art separators like `// ─────────────`).
-- Use blank lines to separate logical sections naturally.
-- Organize code: types → helpers → higher-order functions.
-- Use JSDoc for exported functions and complex logic; keep inline comments minimal.
-- Self-documenting code over comments: clear naming, pure functions, obvious control flow.
-
-## Validation & Types
-- Use Zod for schemas.
-- Export inferred types using `z.infer`.
-- Do NOT include literal event types inside schemas.
-- Do not duplicate validation logic across layers.
-
-## Service & Module Structure
-- Entry points handle wiring (server start, telemetry, routing, consumers).
-- Business logic lives in use-case modules.
-- Event handlers must be thin wrappers around use-cases.
-
-## Event Handling
-- Use shared CloudEvents/messaging libraries, not raw clients.
-- Handlers: Schema → inferred type → thin handler → use-case delegation.
-- Handlers named `*.event.ts`.
-
-## Infrastructure
-- Use fluent port builders when available.
-- Expose a `/health` endpoint.
-- Avoid legacy containerPort usage.
-
-## Testing
-- Test use-cases, not handlers or frameworks.
-- Prefer simple direct tests, no mocks.
-- Validate both error and success paths.
-
-## AI Output Format
-- Provide only necessary files.
-- Use relative paths.
-- Keep comments minimal.
-- Do not generate abstractions not already present.
-
-## Service-Specific Guidelines
-
-When working with specific service types or packages, refer to these detailed guidelines:
-
-### Service Generation & Architecture
-- [CLI Service Generator](../packages/platform-sdk/docs/generators/service.md) - AI code generation rules
-
-### Key Packages
-- [@crossdelta/cloudevents](../packages/cloudevents/README.md) - Event handling with NATS and CloudEvents
-- [@crossdelta/telemetry](../packages/telemetry/README.md) - OpenTelemetry instrumentation
-- [@crossdelta/infrastructure](../packages/infrastructure/README.md) - Pulumi/K8s configuration
-
-**When generating services**: Always check the appropriate guidelines above to ensure correct patterns, especially for event-driven architectures.

package/bin/templates/workspace/.github/dependabot.yml

@@ -1,18 +0,0 @@
-version: 2
-registries:
-  npm-github:
-    type: npm-registry
-    url: https://npm.pkg.github.com
-    token: ${{secrets.NPM_TOKEN}}
-    replaces-base: true
-    
-updates:
-  - package-ecosystem: "bun"
-    directory: "/"
-    schedule:
-      interval: "daily"
-    open-pull-requests-limit: 10
-    labels:
-      - "dependencies"
-    registries:
-      - npm-github