mcp-efficiency-engine 0.1.0

package/scripts/github/sync-repo.ps1

@@ -0,0 +1,267 @@
+#Requires -Version 7
+
+<#
+.SYNOPSIS
+Sincroniza cambios entre repositorios principales mediante GitHub MCP.
+
+.DESCRIPTION
+Detecta cambios en SourceRepo, filtra por patrón de archivos, y crea PR en TargetRepo.
+Usa GitHub MCP Server para operaciones automatizadas.
+
+.PARAMETER SourceRepo
+Repo origen (owner/repo). Por defecto: Sertxito/mcp-efficiency-engine
+
+.PARAMETER TargetRepo
+Repo destino (owner/repo). Por defecto: Sertxito/boost_sertxIA
+
+.PARAMETER FilesPattern
+Patrón glob para filtrar archivos a sincronizar. Por defecto: projects/**
+
+.PARAMETER BranchName
+Nombre de rama para PR. Por defecto: sync/{timestamp}
+
+.EXAMPLE
+.\sync-repo.ps1 -FilesPattern "projects/**" -DryRun
+
+.EXAMPLE
+.\sync-repo.ps1 -SourceRepo "Sertxito/mcp-efficiency-engine" -TargetRepo "Sertxito/boost_sertxIA"
+
+#>
+
+param(
+  [string]$SourceRepo = "Sertxito/mcp-efficiency-engine",
+  [string]$TargetRepo = "Sertxito/boost_sertxIA",
+  [string]$FilesPattern = "projects/**",
+  [string]$BranchName = "sync/$(Get-Date -Format 'yyyyMMdd-HHmmss')",
+  [switch]$DryRun
+)
+
+$ErrorActionPreference = "Stop"
+
+# Verificar MCP GitHub disponible
+function Test-MCPGitHub {
+  try {
+    $result = gh api --version 2>&1
+    Write-Host "✓ GitHub CLI disponible: $result"
+    return $true
+  } catch {
+    Write-Host "✗ GitHub CLI no disponible. Instalar con: gh --version"
+    return $false
+  }
+}
+
+# Obtener cambios entre branches
+function Get-RepoChanges {
+  param([string]$Repo, [string]$BaseBranch = "main")
+  
+  Write-Host "Detectando cambios en $Repo/$BaseBranch..."
+  
+  try {
+    $commits = gh api repos/$Repo/commits --limit 20 | ConvertFrom-Json
+    $files = @()
+    
+    foreach ($commit in $commits) {
+      $commit_data = gh api repos/$Repo/commits/$($commit.sha) | ConvertFrom-Json
+      $files += $commit_data.files | Where-Object { $_.filename -like $FilesPattern }
+    }
+    
+    return $files | Sort-Object filename -Unique
+  } catch {
+    Write-Host "Error al obtener cambios: $_"
+    return @()
+  }
+}
+
+# Crear rama en repo destino
+function New-TargetBranch {
+  param([string]$Repo, [string]$Branch)
+  
+  Write-Host "Creando rama $Branch en $Repo..."
+  
+  if ($DryRun) {
+    Write-Host "[DRY-RUN] gh api repos/$Repo/git/refs -H 'Accept: application/vnd.github+json' -f ref=refs/heads/$Branch"
+    return $true
+  }
+  
+  try {
+    # Obtener ref actual
+    $mainRef = gh api repos/$Repo/git/refs/heads/main | ConvertFrom-Json
+    
+    # Crear nueva rama
+    gh api repos/$Repo/git/refs `
+      -H 'Accept: application/vnd.github+json' `
+      -f ref=refs/heads/$Branch `
+      -f sha=$mainRef.object.sha
+    
+    Write-Host "✓ Rama creada: $Branch"
+    return $true
+  } catch {
+    Write-Host "✗ Error creando rama: $_"
+    return $false
+  }
+}
+
+# Sincronizar archivos
+function Sync-Files {
+  param(
+    [string]$SourceRepo,
+    [string]$TargetRepo,
+    [string]$TargetBranch,
+    [array]$Files
+  )
+  
+  Write-Host "Sincronizando $($Files.Count) archivos..."
+  
+  $synced = 0
+  foreach ($file in $Files) {
+    try {
+      $filePath = $file.filename
+      Write-Host "  Sincronizando: $filePath"
+      
+      # Obtener contenido del archivo fuente
+      $content = gh api repos/$SourceRepo/contents/$filePath | ConvertFrom-Json
+      $fileContent = [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($content.content))
+      
+      if ($DryRun) {
+        Write-Host "  [DRY-RUN] Actualizaría $filePath"
+        $synced++
+        continue
+      }
+      
+      # Intentar obtener SHA actual en destino
+      $targetFile = gh api repos/$TargetRepo/contents/$filePath --jq '.sha' 2>$null || $null
+      
+      # Crear/actualizar archivo en destino
+      $params = @{
+        message = "sync: Sincronizar $filePath desde $SourceRepo"
+        content = [System.Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($fileContent))
+        branch = $TargetBranch
+      }
+      
+      if ($targetFile) {
+        $params.sha = $targetFile
+      }
+      
+      gh api repos/$TargetRepo/contents/$filePath -X PUT @params | Out-Null
+      
+      Write-Host "  ✓ $filePath sincronizado"
+      $synced++
+    } catch {
+      Write-Host "  ⚠ Error sincronizando $($file.filename): $_"
+    }
+  }
+  
+  return $synced
+}
+
+# Crear PR de sincronización
+function New-SyncPullRequest {
+  param(
+    [string]$TargetRepo,
+    [string]$TargetBranch,
+    [int]$FileCount
+  )
+  
+  $title = "sync: Sincronizar cambios desde $SourceRepo"
+  $body = @"
+## Sincronización Automática
+
+**Origen:** $SourceRepo
+**Destino:** $TargetRepo
+**Archivos sincronizados:** $FileCount
+
+### Patrón de archivos
+\`\`\`
+$FilesPattern
+\`\`\`
+
+### Verificación
+- [ ] Revisar cambios
+- [ ] Ejecutar validaciones locales
+- [ ] Confirmar comportamiento esperado
+
+### Referencias
+- Source commit: $(gh api repos/$SourceRepo/commits/main --jq '.sha' | Cut -c 1-7)
+- Sincronizado automáticamente vía GitHub MCP
+"@
+  
+  if ($DryRun) {
+    Write-Host "[DRY-RUN] Crearría PR:"
+    Write-Host "  Título: $title"
+    Write-Host "  Rama: $TargetBranch"
+    return $true
+  }
+  
+  try {
+    $pr = gh pr create `
+      --repo "$TargetRepo" `
+      --base main `
+      --head $TargetBranch `
+      --title $title `
+      --body $body `
+      --draft
+    
+    Write-Host "✓ PR creada: $pr"
+    return $true
+  } catch {
+    Write-Host "✗ Error creando PR: $_"
+    return $false
+  }
+}
+
+# ===================
+# Main Execution
+# ===================
+
+Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+Write-Host "GitHub MCP Repo Synchronizer"
+Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+Write-Host ""
+Write-Host "Origen:  $SourceRepo"
+Write-Host "Destino: $TargetRepo"
+Write-Host "Patrón:  $FilesPattern"
+Write-Host "Rama:    $BranchName"
+
+if ($DryRun) {
+  Write-Host "🔍 Modo DRY-RUN: No se realizarán cambios"
+}
+Write-Host ""
+
+# 1. Verificar MCP GitHub
+if (-not (Test-MCPGitHub)) {
+  exit 1
+}
+
+# 2. Obtener cambios
+$changes = Get-RepoChanges -Repo $SourceRepo
+if ($changes.Count -eq 0) {
+  Write-Host "ℹ No hay cambios que sincronizar"
+  exit 0
+}
+
+Write-Host "Encontrados $($changes.Count) cambios"
+Write-Host ""
+
+# 3. Crear rama destino
+if (-not (New-TargetBranch -Repo $TargetRepo -Branch $BranchName)) {
+  exit 1
+}
+
+# 4. Sincronizar archivos
+$synced = Sync-Files -SourceRepo $SourceRepo -TargetRepo $TargetRepo `
+  -TargetBranch $BranchName -Files $changes
+
+Write-Host ""
+Write-Host "Sincronizados: $synced/$($changes.Count) archivos"
+
+if ($synced -gt 0) {
+  # 5. Crear PR
+  if (-not $DryRun) {
+    New-SyncPullRequest -TargetRepo $TargetRepo -TargetBranch $BranchName -FileCount $synced
+  } else {
+    Write-Host "[DRY-RUN] PR sería creada con $synced archivos"
+  }
+}
+
+Write-Host ""
+Write-Host "✓ Sincronización completada"

package/scripts/intake/agent-pipeline-preflight.py

@@ -0,0 +1,151 @@
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+from typing import Any
+
+
+REQUIRED_AGENT_ALIASES: dict[str, list[str]] = {
+    "backend": ["backend", "backend"],
+    "frontend": ["frontend-agent"],
+    "legacy": ["legacy", "legacy"],
+    "dba": ["dba", "dba"],
+    "rag-local": ["rag-local", "rag-local"],
+    "rag-azure": ["rag-azure", "rag-azure"],
+    "iot": ["iot", "iot"],
+    "ux-ui": ["ux-ui", "ux-ui"],
+    "community-manager": ["community-manager", "community-manager"],
+    "snapshot": ["snapshot", "snapshot"],
+}
+
+AGENT_TEMPLATE: dict[str, str] = {
+    "backend": "Modern development tasks on a single repository.",
+    "frontend-agent": "Frontend development tasks on a single repository.",
+    "legacy": "Legacy/migration and multi-repo impact analysis.",
+    "dba": "SQL/schema/procedure and DBA analysis.",
+    "rag-local": "Local technical docs and knowledge retrieval.",
+    "rag-azure": "Corporate docs with mandatory evidence.",
+    "iot": "IoT/edge/telemetry mixed code+docs workflow.",
+    "ux-ui": "UX/UI governance and design-intent control workflow.",
+    "community-manager": "Education/posts/storytelling from grounded knowledge.",
+    "snapshot": "Portable scope-safe context export.",
+}
+
+
+def load_registry(path: Path) -> dict[str, Any]:
+    content = path.read_text(encoding="utf-8")
+    if content.lstrip().startswith("{"):
+        return json.loads(content)
+    raise ValueError("repo-registry/repos.yml must be JSON-first in this repository")
+
+
+def write_agent_template(agent_name: str, path: Path) -> None:
+    desc = AGENT_TEMPLATE.get(agent_name, "Specialized agent definition.")
+    body = (
+        f"# {agent_name}\n\n"
+        "## Purpose\n\n"
+        f"{desc}\n\n"
+        "## Pipeline\n\n"
+        "1. Memory-first selection.\n"
+        "1. Route by intent/domain/source.\n"
+        "1. Apply always-on optimization.\n"
+        "1. Register feedback into AutoLearning.\n"
+    )
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(body, encoding="utf-8")
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Validate agent -> skills -> boost pipeline prerequisites.")
+    parser.add_argument("--registry", default="repo-registry/repos.yml")
+    parser.add_argument("--agents-dir", default=".github/agents")
+    parser.add_argument("--generated-root", default="repo-intake/generated")
+    parser.add_argument("--create-missing-templates", action="store_true")
+    args = parser.parse_args()
+
+    repo_root = Path(__file__).resolve().parents[2]
+    registry_path = (repo_root / args.registry).resolve()
+    agents_dir = (repo_root / args.agents_dir).resolve()
+    generated_root = (repo_root / args.generated_root).resolve()
+
+    registry = load_registry(registry_path)
+    repos = registry.get("repos", []) if isinstance(registry.get("repos", []), list) else []
+
+    missing_agents: list[str] = []
+    for logical_name, aliases in REQUIRED_AGENT_ALIASES.items():
+        candidates = [agents_dir / f"{alias}.agent.md" for alias in aliases]
+        if not any(path.exists() for path in candidates):
+            missing_agents.append(logical_name)
+
+    if missing_agents and args.create_missing_templates:
+        for logical_name in missing_agents:
+            preferred_name = REQUIRED_AGENT_ALIASES[logical_name][0]
+            write_agent_template(preferred_name, agents_dir / f"{preferred_name}.agent.md")
+
+    missing_boost_paths: list[str] = []
+    missing_manifests: list[str] = []
+    missing_capabilities: list[str] = []
+
+    for repo in repos:
+        if not isinstance(repo, dict):
+            continue
+        name = str(repo.get("name", "")).strip()
+        location = str(repo.get("location", "")).strip()
+        if not name or not location:
+            continue
+
+        abs_path = (repo_root / location).resolve()
+        if not abs_path.exists():
+            missing_boost_paths.append(f"{name} -> {abs_path}")
+
+        slug = name.lower().replace(" ", "-")
+        manifest = generated_root / slug / "context-manifests" / "manifest.json"
+        capability = generated_root / slug / "capabilities" / "capability.json"
+
+        if not manifest.exists():
+            missing_manifests.append(str(manifest))
+        if not capability.exists():
+            missing_capabilities.append(str(capability))
+
+    print("Agent Pipeline Preflight")
+    print(f"- agents_dir: {agents_dir}")
+    print(f"- required_agents: {len(REQUIRED_AGENT_ALIASES)}")
+    print(f"- missing_agents: {len(missing_agents)}")
+    print(f"- missing_boost_paths: {len(missing_boost_paths)}")
+    print(f"- missing_manifests: {len(missing_manifests)}")
+    print(f"- missing_capabilities: {len(missing_capabilities)}")
+
+    if missing_agents:
+        print("\nMissing agent definitions:")
+        for m in missing_agents:
+            accepted = ", ".join([f"{alias}.agent.md" for alias in REQUIRED_AGENT_ALIASES[m]])
+            print(f"  - {m} (accepted: {accepted})")
+        if not args.create_missing_templates:
+            print("Hint: run with --create-missing-templates to scaffold placeholders.")
+
+    if missing_boost_paths:
+        print("\nMissing boost repository paths:")
+        for m in missing_boost_paths:
+            print(f"  - {m}")
+
+    if missing_manifests:
+        print("\nMissing generated manifests:")
+        for m in missing_manifests[:20]:
+            print(f"  - {m}")
+
+    if missing_capabilities:
+        print("\nMissing generated capabilities:")
+        for m in missing_capabilities[:20]:
+            print(f"  - {m}")
+
+    if missing_agents or missing_boost_paths or missing_manifests or missing_capabilities:
+        return 1
+
+    print("Preflight OK. Agent pipeline can route to skills and boost platforms.")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
+

package/scripts/intake/init-template-registry.cmd

@@ -0,0 +1,4 @@
+@echo off
+setlocal
+pwsh -NoProfile -ExecutionPolicy Bypass -File "%~dp0init-template-registry.ps1" %*
+exit /b %ERRORLEVEL%

package/scripts/intake/init-template-registry.ps1

@@ -0,0 +1,258 @@
+param(
+  [switch]$Force,
+  [string]$Owner,
+  [string]$RepoNamePrefix,
+  [string]$InitialRepoName,
+  [string]$InitialRepoDomain,
+  [string]$InitialRepoLocation,
+  [switch]$SkipInitialRepo,
+  [string]$TargetPath
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$repoRoot = (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
+Set-Location $repoRoot
+
+$templatePath = Join-Path $repoRoot 'repo-registry\repos.template.json'
+$targetPath = if ([string]::IsNullOrWhiteSpace($TargetPath)) {
+  Join-Path $repoRoot 'repo-registry\repos.yml'
+}
+else {
+  if ([System.IO.Path]::IsPathRooted($TargetPath)) {
+    $TargetPath
+  }
+  else {
+    Join-Path $repoRoot $TargetPath
+  }
+}
+
+function Read-RequiredValue {
+  param(
+    [Parameter(Mandatory = $true)][string]$Prompt,
+    [string]$DefaultValue = "",
+    [string]$ProvidedValue = ""
+  )
+
+  if (-not [string]::IsNullOrWhiteSpace($ProvidedValue)) {
+    return $ProvidedValue.Trim()
+  }
+
+  while ($true) {
+    $value = if ([string]::IsNullOrWhiteSpace($DefaultValue)) {
+      Read-Host $Prompt
+    }
+    else {
+      $inputValue = Read-Host "$Prompt [$DefaultValue]"
+      if ([string]::IsNullOrWhiteSpace($inputValue)) { $DefaultValue } else { $inputValue.Trim() }
+    }
+
+    if (-not [string]::IsNullOrWhiteSpace($value)) {
+      return $value.Trim()
+    }
+
+    Write-Host 'A value is required.'
+  }
+}
+
+function Read-ChoiceValue {
+  param(
+    [Parameter(Mandatory = $true)][string]$Prompt,
+    [Parameter(Mandatory = $true)][string[]]$AllowedValues,
+    [Parameter(Mandatory = $true)][string]$DefaultValue,
+    [string]$ProvidedValue = ""
+  )
+
+  $allowedLabels = $AllowedValues -join '/'
+  if (-not [string]::IsNullOrWhiteSpace($ProvidedValue)) {
+    $normalizedProvided = $ProvidedValue.Trim().ToLowerInvariant()
+    foreach ($candidate in $AllowedValues) {
+      if ($candidate.ToLowerInvariant() -eq $normalizedProvided) {
+        return $candidate
+      }
+    }
+
+    throw "Invalid value '$ProvidedValue' for $Prompt. Allowed values: $allowedLabels"
+  }
+
+  while ($true) {
+    $value = Read-Host "$Prompt [$DefaultValue] ($allowedLabels)"
+    if ([string]::IsNullOrWhiteSpace($value)) {
+      return $DefaultValue
+    }
+
+    $normalized = $value.Trim().ToLowerInvariant()
+    foreach ($candidate in $AllowedValues) {
+      if ($candidate.ToLowerInvariant() -eq $normalized) {
+        return $candidate
+      }
+    }
+
+    Write-Host "Allowed values: $allowedLabels"
+  }
+}
+
+function Read-YesNoValue {
+  param(
+    [Parameter(Mandatory = $true)][string]$Prompt,
+    [bool]$DefaultValue = $true,
+    [Nullable[bool]]$ProvidedValue = $null
+  )
+
+  if ($null -ne $ProvidedValue) {
+    return [bool]$ProvidedValue
+  }
+
+  $defaultLabel = if ($DefaultValue) { 'Y' } else { 'N' }
+  while ($true) {
+    $value = Read-Host "$Prompt [$defaultLabel]"
+    if ([string]::IsNullOrWhiteSpace($value)) {
+      return $DefaultValue
+    }
+
+    switch ($value.Trim().ToLowerInvariant()) {
+      'y' { return $true }
+      'yes' { return $true }
+      'n' { return $false }
+      'no' { return $false }
+      default { Write-Host 'Answer Y or N.' }
+    }
+  }
+}
+
+function Get-DefaultEnginesForDomain {
+  param([Parameter(Mandatory = $true)][string]$Domain)
+
+  switch ($Domain) {
+    'dev' {
+      return [pscustomobject]@{
+        knowledge = 'codegraph'
+        execution = 'none'
+        snapshot = 'repomix'
+      }
+    }
+    'legacy' {
+      return [pscustomobject]@{
+        knowledge = 'graphify'
+        execution = 'gitnexus'
+        snapshot = 'repomix'
+      }
+    }
+    'dba' {
+      return [pscustomobject]@{
+        knowledge = 'graphify'
+        execution = 'none'
+        snapshot = 'repomix'
+      }
+    }
+    'iot' {
+      return [pscustomobject]@{
+        knowledge = 'graphify'
+        execution = 'gitnexus'
+        snapshot = 'repomix'
+      }
+    }
+    'azure-rag' {
+      return [pscustomobject]@{
+        knowledge = 'azure-rag-builder'
+        execution = 'none'
+        snapshot = 'repomix'
+      }
+    }
+    default {
+      return [pscustomobject]@{
+        knowledge = 'codegraph'
+        execution = 'none'
+        snapshot = 'repomix'
+      }
+    }
+  }
+}
+
+if (-not (Test-Path $templatePath)) {
+  throw "Missing template registry: $templatePath"
+}
+
+if ((Test-Path $targetPath) -and -not $Force) {
+  $currentRaw = Get-Content -Raw -Path $targetPath
+  $currentRegistry = $null
+  try {
+    $currentRegistry = $currentRaw | ConvertFrom-Json -Depth 20
+  }
+  catch {
+    $currentRegistry = $null
+  }
+
+  if ($currentRegistry -and ($currentRegistry.PSObject.Properties.Name -contains 'registry_mode') -and $currentRegistry.registry_mode -eq 'template') {
+    Write-Host "Template registry already initialized at $targetPath"
+    exit 0
+  }
+
+  throw "Registry already exists at $targetPath. Use -Force to overwrite it with the template."
+}
+
+$templateRegistry = Get-Content -Raw -Path $templatePath | ConvertFrom-Json -Depth 20
+
+$defaultOwner = if ([string]::IsNullOrWhiteSpace($Owner)) { 'your-team' } else { $Owner }
+$defaultPrefix = if ([string]::IsNullOrWhiteSpace($RepoNamePrefix)) { 'your-prefix_' } else { $RepoNamePrefix }
+
+$resolvedOwner = Read-RequiredValue -Prompt 'Registry owner' -DefaultValue $defaultOwner -ProvidedValue $Owner
+$resolvedPrefix = Read-RequiredValue -Prompt 'Repository name prefix' -DefaultValue $defaultPrefix -ProvidedValue $RepoNamePrefix
+
+$templateRegistry.governance.owner = $resolvedOwner
+$templateRegistry.governance.repo_name_prefix = $resolvedPrefix
+
+$hasInitialRepoData = @($InitialRepoName, $InitialRepoDomain, $InitialRepoLocation) | Where-Object { -not [string]::IsNullOrWhiteSpace($_) }
+$addInitialRepo = $false
+if ($SkipInitialRepo) {
+  $addInitialRepo = $false
+}
+elseif ($hasInitialRepoData.Count -gt 0) {
+  $addInitialRepo = $true
+}
+else {
+  $addInitialRepo = Read-YesNoValue -Prompt 'Add an initial repo entry now?' -DefaultValue $true
+}
+
+$templateRegistry.repos = @()
+if ($addInitialRepo) {
+  $defaultRepoName = if ([string]::IsNullOrWhiteSpace($InitialRepoName)) { "$resolvedPrefix$((Split-Path $repoRoot -Leaf).ToLowerInvariant())" } else { $InitialRepoName }
+  $defaultRepoDomain = if ([string]::IsNullOrWhiteSpace($InitialRepoDomain)) { 'dev' } else { $InitialRepoDomain }
+  $defaultRepoLocation = if ([string]::IsNullOrWhiteSpace($InitialRepoLocation)) { '.' } else { $InitialRepoLocation }
+
+  $resolvedRepoName = Read-RequiredValue -Prompt 'Initial repo name' -DefaultValue $defaultRepoName -ProvidedValue $InitialRepoName
+  $resolvedRepoDomain = Read-ChoiceValue -Prompt 'Initial repo domain' -AllowedValues @('dev', 'legacy', 'dba', 'iot', 'azure-rag') -DefaultValue $defaultRepoDomain -ProvidedValue $InitialRepoDomain
+  $resolvedRepoLocation = Read-RequiredValue -Prompt 'Initial repo location' -DefaultValue $defaultRepoLocation -ProvidedValue $InitialRepoLocation
+  $resolvedEngines = Get-DefaultEnginesForDomain -Domain $resolvedRepoDomain
+
+  $templateRegistry.repos = @(
+    [pscustomobject]@{
+      name = $resolvedRepoName
+      domain = $resolvedRepoDomain
+      location = $resolvedRepoLocation
+      type = 'local'
+      optional = $false
+      dependencies = @()
+      engines = $resolvedEngines
+    }
+  )
+}
+
+$targetDir = Split-Path -Parent $targetPath
+if (-not (Test-Path $targetDir)) {
+  New-Item -ItemType Directory -Path $targetDir -Force | Out-Null
+}
+
+$templateRegistry | ConvertTo-Json -Depth 20 | Set-Content -Path $targetPath -Encoding utf8
+Write-Host "Template registry initialized at $targetPath"
+Write-Host "Summary:"
+Write-Host "  owner: $resolvedOwner"
+Write-Host "  prefix: $resolvedPrefix"
+Write-Host "  repos: $($templateRegistry.repos.Count)"
+if ($templateRegistry.repos.Count -gt 0) {
+  $firstRepo = $templateRegistry.repos[0]
+  Write-Host "  first repo: $($firstRepo.name) [$($firstRepo.domain)] -> $($firstRepo.location)"
+  Write-Host "  engines: knowledge=$($firstRepo.engines.knowledge), execution=$($firstRepo.engines.execution), snapshot=$($firstRepo.engines.snapshot)"
+}
+Write-Host "Next recommended step: .\\scripts\\intake\\run-repo-intake.cmd"