bc-w1-reference

# BC W1 Reference

## Overview
Set up and use a local mirror of the standard Business Central (W1) source so you can search for events, APIs, tables, fields, and tests without remote browsing. The default mirror location is a sibling `_aldoc/bc-w1` folder (outside the repo root) to avoid noise in search tools.

**Recommended approach:** For open-ended exploration (finding events, understanding patterns, locating test examples), use the Task tool with `subagent_type=Explore` to search the mirror. This handles multi-step searches and returns synthesized findings.

## Quick Start
Important: Do not run the setup/update scripts automatically. Ask the user to confirm before running them; in most cases, you should not run them at all unless the user explicitly requests it.

1) Ensure the local mirror exists (clones if missing, adds local ignore):

```powershell
<skill-folder>/skills/bc-w1-reference/scripts/setup-bc-w1-mirror.ps1
```

2) Update the mirror (fast-forward only):

```powershell
<skill-folder>/skills/bc-w1-reference/scripts/update-bc-w1.ps1
```

3) Search locally with ripgrep (examples, from repo root; single-file):

```powershell
rg -n "EventSubscriber" "..\_aldoc\bc-w1\Email - SMTP Connector\Test\Email - SMTP Connector Tests\src\SMTPAccountAuthTests.Codeunit.al"
rg -n "OnAfterValidateEvent" "..\_aldoc\bc-w1\ExternalEvents\Source\_Exclude_Business_Events_\src\ARExternalEvents.Codeunit.al"
rg -n "table 27" "..\_aldoc\bc-w1\BaseApp\Source\Base Application\Inventory\Item\Item.Table.al"
```

4) Search structurally with ast-grep (single file to keep output small):

```powershell
ast-grep run -l al -p 'codeunit 130300 "Library - Demo Data"' -C 0 "..\_aldoc\bc-w1\BaseApp\Test\Tests-TestLibraries\LibraryDemoData.Codeunit.al"
```

## Tasks

### 1) Ensure local mirror
Use when the mirror does not exist yet or when you want to re-apply local ignore.

```powershell
<skill-folder>/skills/bc-w1-reference/scripts/setup-bc-w1-mirror.ps1
```

### 2) Update mirror
Use when you w