Hve Core Installer

## Script Usage Examples

### Environment Detection

Detect whether the current environment is local, devcontainer, or Codespaces.

```powershell
./scripts/detect-environment.ps1
```

```bash
./scripts/detect-environment.sh
```

### Collision Detection

Check for existing agent files before copying.

```powershell
./scripts/collision-detection.ps1 -Selection hve-core
```

Use a custom collection with explicit agent paths.

```powershell
./scripts/collision-detection.ps1 -Selection my-collection -CollectionAgents @('my-collection/custom.agent.md')
```

### Agent Copy

Copy agents from the HVE-Core source into the target project.

```powershell
./scripts/agent-copy.ps1 -HveCoreBasePath ./lib/hve-core -CollectionId hve-core -FilesToCopy @('hve-core/task-researcher.agent.md', 'hve-core/task-planner.agent.md')
```

Preserve existing files during an upgrade.

```powershell
./scripts/agent-copy.ps1 -HveCoreBasePath ./lib/hve-core -CollectionId hve-core -FilesToCopy @('hve-core/task-researcher.agent.md') -KeepExisting -Collisions @('.github/agents/task-researcher.agent.md')
```

### Upgrade Detection

Check whether an existing installation needs upgrading.

```powershell
./scripts/upgrade-detection.ps1 -HveCoreBasePath ./lib/hve-core
```

### Validate Installation

Verify a clone-based installation for a specific method.

```powershell
./scripts/validate-installation.ps1 -BasePath ./my-project -Method 1
```

Validate a multi-root workspace installation (method 5).

```powershell
./scripts/validate-installation.ps1 -BasePath ./my-project -Method 5
```

### Validate Extension

Check whether the HVE-Core VS Code extension is installed.

```powershell
./scripts/validate-extension.ps1
```

Use an alternate VS Code CLI.

```powershell
./scripts/validate-extension.ps1 -CodeCli 'code-insiders'
```

### File Status Check

Compare installed file hashes against the tracking manifest.

```powershell
./scripts/file-status-check.ps1
```

### Eject a File

Mark a managed file as ejected so upgrades no longer overwrite it.

```powershell
./scripts/eject.ps1 -FilePath .github/agents/task-researcher.agent.md
```

*🤖 Crafted with precision by ✨Copilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.*


# Copyright (c) Microsoft Corporation.
# SPDX-License-Identifier: MIT
<#
.SYNOPSIS
    Copies selected HVE-Core agents to the target repository.
.DESCRIPTION
    Creates .github/agents/ directory, copies agent files, computes SHA256 hashes,
    and writes .hve-tracking.json manifest for upgrade tracking.
.PARAMETER HveCoreBasePath
    Root path of the local HVE-Core clone used as the copy source.
.PARAMETER CollectionId
    Collection identifier recorded in the tracking manifest.
.PARAMETER FilesToCopy
    Array of agent file paths relative to the source agents directory.
.PARAMETER KeepExisting
    When set, existing files listed in Collisions are preserved instead of overwritten.
.PARAMETER Collisions
    Array of target file paths that already exist and may conflict.
.EXAMPLE
    ./scripts/agent-copy.ps1 -HveCoreBasePath ../hve-core -CollectionId hve-core -FilesToCopy @('hve-core/task-researcher.agent.md')
.OUTPUTS
    Per-file copy status and manifest creation confirmation.
#>
[CmdletBinding()]
param(
    [Parameter(Mandatory)]
    [ValidateScript({ Test-Path $_ })]
    [string]$HveCoreBasePath,

    [Parameter(Mandatory)]
    [ValidateNotNullOrEmpty()]
    [string]$CollectionId,

    [Parameter(Mandatory)]
    [ValidateNotNullOrEmpty()]
    [string[]]$FilesToCopy,

    [Parameter()]
    [switch]$KeepExisting,

    [Parameter()]
    [string[]]$Collisions = @()
)

$ErrorActionPreference = 'Stop'

$sourceBase = "$hveCoreBasePath/.github/agents"
$targetDir = ".github/agents"
$manifestPath = ".hve-tracking.json"

# Create target directory
if (-not (Test-Path $targetDir)) {
    New-