wal: pause

This commit is contained in:
pqhuy1987
2026-08-07 17:37:03 +07:00
parent 40914682b1
commit b8d22741c7
25 changed files with 1733 additions and 99 deletions

View File

@ -0,0 +1,460 @@
# artifact-integrity.ps1 - MAY DIEM DANH VAT CHUNG (run-folder), do NGHIA khong chi do TON TAI
#
# San thi hanh: broadcasts/inbox/ai_infra/2026-08-04-Governance-upgrade-pack-phased-phu-luc-spec-pitfall.md
# section GD-2 (san (i)-(v) + 4 bay + 6 o nghiem thu)
# Thiet ke : runs/2026-08-07-S180-adap-upgrade-pack-phased/sub-n3-lane-b-gd2.md (13 khoan B-01..B-13, 4 vi tu V-1..V-4)
# Ke hoach : runs/2026-08-07-S180-adap-upgrade-pack-phased/wave-plan-S180.md (W2)
# Khuon may : scripts/naming-scan.ps1 (W1) - giu cung ky luat: pure-ASCII, INFORM-only, luon in mau so.
#
# HOP DONG CUA MAY NAY - doc truoc khi sua:
#
# (1) INFORM-only. LUON exit 0, ke ca khi co co. Lai ma thoat = wave W3b,
# sau khi chu du an chot cau P1 (da chot PA-2). KHONG tu lai ma thoat o day.
#
# (2) VI SAO MAY NAY TON TAI - ca song, khong phai gia thuyet:
# S180 co mot vai ha canh artifact 7.049 B voi 6/10 heading con nhan treo
# sau 202K token. Chay `nhip-no-probe` len dung thu muc do => `run-chua-gom 0`,
# exit 0, SACH. Control-duong (giau *-synthesis.md => 1, tra lai => 0) xac nhan
# thuoc SONG => so 0 kia la MU THAT.
# GOC: moi vi tu dang co deu do KICH THUOC; thu hong la TI LE KHUNG/RUOT.
# Hai dai luong nay KHONG tuong quan - mot tep toan heading tang byte y het
# mot tep day noi dung.
#
# (3) 4 VI TU cua hub -> 4 vi tu cai o day:
# VANG -> V-3 (diem danh 2 nguon: ten neu trong run.md ma vang tren dia)
# RONG -> V-1 nhanh 0-byte (KHONG duoc roi vao 'khong ap dung')
# CUT -> V-2 (nhan treo neo HEADING) chinh + V-1 (ti le ruot/khung) phu
# NEN-QUA-TAY -> V-4 (so ky tu voi ban truoc CUNG DON VI, lay tu git)
#
# (4) LUON IN MAU SO canh moi con so. Phien S180 da 8 ca bay don-vi.
# Va luon in "dem CAI GI": tep / thu muc / muc / dong.
#
# (5) TAP VANG MAT != SACH (chong Goodhart). Neu thu muc goc vang, hoac mot
# luot chay khong con vat nao, may in co THIEU-TAP RIENG canh so 0.
# So 0 khong duoc phep doc thanh 'sach' khi chua co gi de dem.
#
# (6) Pure ASCII (gotcha #30). Nhan treo tieng Viet duoc dung bang MA DIEM
# (xem $TAG_*) chu khong go thang - de tep nay giu 0 byte ngoai ASCII.
#
# (7) KHONG SUA GI. May chi doc va in. Che do -BuildIndex la ngoai le duy nhat:
# no GHI DE mot tep duy nhat (.claude/workflows/runs/_index.md) va tep do
# la DERIVE-VIEW sinh tu dia - cam sua tay, cam dung lam nguon.
#
# Fault-inject: chay voi -RepoRoot <cay-tam> de cay artifact hong / go ra. Khong dung kho that.
[CmdletBinding()]
param(
[string]$RepoRoot,
[string]$RunId, # chi soi 1 thu muc luot chay. Vang => soi TAT CA.
[switch]$V4All, # bat V-4 cho moi tep (moi tep ton ~1-2 lenh git). Mac dinh chi bat khi co -RunId.
[switch]$BuildIndex, # sinh lai muc luc derive-view _index.md tu dia
[double]$K = 3.00 # nguong V-1. Mac dinh = phan vi 5 cua ho sub-*, do 2026-08-07, mau so 446.
)
$ErrorActionPreference = 'Stop'
if (-not $RepoRoot -or $RepoRoot -eq '') { $RepoRoot = Split-Path -Parent $PSScriptRoot }
$RepoRoot = (Resolve-Path -LiteralPath $RepoRoot).Path
$RunsRel = '.claude/workflows/runs'
$RunsRoot = Join-Path $RepoRoot $RunsRel
# ---------------------------------------------------------------------------
# Nhan treo dung bang MA DIEM de giu tep pure-ASCII (luat 6).
# 0x0110 = D co gach ngang (chu HOA) -> dung trong "DANG DO"
# 0x1EDC = O co sung + huyen (chu HOA) -> dung trong "CHO"
# ---------------------------------------------------------------------------
$chDbar = [string][char]0x0110
$chOhg = [string][char]0x1EDC
$TAG_DANGDO = $chDbar + 'ANG ' + $chDbar + 'O'
$TAG_CHO = 'CH' + $chOhg
$TAGSET = @($TAG_DANGDO, $TAG_CHO, 'TODO', 'PENDING') -join '|'
# Neo vao HEADING la chu y trung tam cua V-2: tach DUNG (nhan dang treo)
# khoi NHAC DEN (cau van dinh nghia nhan). Dem tho cho duong-gia tren chinh
# ban da xong - do 2026-08-07: tho=1, neo-heading=0. Lop citation-trap.
$RX_PLACEHOLDER_HEAD = '^#{1,6} .*\[(' + $TAGSET + ')'
$RX_PLACEHOLDER_RAW = '\[(' + $TAGSET + ')'
$RX_HEAD = '^#{1,6} '
$RX_FENCE = '^\s*```'
$RX_SUBFAM = '^(sub-.+|.+-return)\.md$' # cung ho voi governance-detectors.ps1:1102 / :1771
$RX_SYNTH = '.+-synthesis\.md$'
# Ten tep artifact duoc NHAC trong run.md. Mau ky tu CO Y khong chua '<' '>'
# => khuon minh hoa dang `sub-<role>-<i>.md` KHONG bi bat (do 2026-08-07: 0 hit).
$RX_NAMEREF = '(sub-[A-Za-z0-9._-]+\.md|[A-Za-z0-9._-]+-synthesis\.md)'
# ---------------------------------------------------------------------------
# So ke. Co (FLAG) va THIEU-TAP dem TACH NHAU - luat 5.
# ---------------------------------------------------------------------------
$script:Flags = @() # {Kind, Run, Name, Msg}
$script:MissingSets = @() # {Run, Msg}
$script:NFolder = 0; $script:NFile = 0; $script:NSkipV1 = 0
$script:NV4Measured = 0; $script:NV4Unmeasurable = 0
$script:NOutOfShape = @()
$script:NKhongKhai = 0; $script:NTroCheo = 0
# Tap ten MOI tep .md tren toan cay runs/ - de phan giai con tro CHEO giua cac
# luot chay (xem V-3). Dung 1 lan, khong quet lai moi thu muc.
$script:AllNamesInRuns = @{}
function Write-Head([string]$t) { Write-Host ''; Write-Host $t -ForegroundColor Cyan }
function Add-Flag([string]$Kind, [string]$Run, [string]$Name, [string]$Msg) {
$script:Flags += [pscustomobject]@{ Kind = $Kind; Run = $Run; Name = $Name; Msg = $Msg }
}
function Add-Missing([string]$Run, [string]$Msg) {
$script:MissingSets += [pscustomobject]@{ Run = $Run; Msg = $Msg }
}
# ---------------------------------------------------------------------------
# Do 1 tep. Dinh nghia "dem CAI GI" - khai o day mot lan, dung suot:
# head = dong khop '^#{1,6} ' VA KHONG nam trong khoi ma (``` toggle).
# Khong loai khoi ma thi '# comment' trong bash bi dem la heading
# => tep nhieu ma bi danh oan.
# body = moi dong KHONG RONG con lai. Dong bang '|', dong trich '>', va dong
# trong khoi ma DEU TINH LA RUOT. (Ban nhap lane B loai '^\|' khoi tu
# so - do la sai, lane B tu sua o section 3.)
# ---------------------------------------------------------------------------
function Measure-Artifact {
param([System.IO.FileInfo]$File)
$bytes = $File.Length
if ($bytes -eq 0) {
return [pscustomobject]@{ Bytes = 0; Head = 0; Body = 0; Ratio = -1; Ph = 0; PhRaw = 0; Chars = 0; Items = 0 }
}
$text = [System.IO.File]::ReadAllText($File.FullName, [System.Text.Encoding]::UTF8)
$lines = $text -split "`r?`n"
$inFence = $false; $head = 0; $body = 0; $ph = 0; $phRaw = 0; $items = 0
foreach ($ln in $lines) {
if ($ln -match $RX_FENCE) { $inFence = -not $inFence; $body++; continue }
if ($inFence) { if ($ln.Trim() -ne '') { $body++ }; continue }
if ($ln -match $RX_HEAD) {
$head++
if ($ln -match $RX_PLACEHOLDER_HEAD) { $ph++ }
if ($ln -match $RX_PLACEHOLDER_RAW) { $phRaw++ }
continue
}
if ($ln -match $RX_PLACEHOLDER_RAW) { $phRaw++ }
if ($ln -match '^\s*[-*] ' -or $ln -match '^\s*\|') { $items++ }
if ($ln.Trim() -ne '') { $body++ }
}
$ratio = if ($head -gt 0) { [math]::Round($body / $head, 2) } else { -1 }
return [pscustomobject]@{
Bytes = $bytes; Head = $head; Body = $body; Ratio = $ratio
Ph = $ph; PhRaw = $phRaw; Chars = $text.Length; Items = $items
}
}
# ---------------------------------------------------------------------------
# V-4 - nen qua tay. So ky tu voi BAN TRUOC CUNG DON VI.
# KHONG dung HEAD~1: hook `wal:` chen commit vao giua => HEAD~1 thuong KHONG
# phai ban truoc CUA TEP NAY, va phep so se la 'so ban moi voi chinh no'
# (giong het mot phep do hop le). Dung git log CUA CHINH TEP.
# Khong du du lieu => KHONG DO DUOC (dung chu hub), khong doan.
# ---------------------------------------------------------------------------
function Test-Compression {
param([string]$RelPath, [int]$NowChars, [int]$NowItems, [string]$FullPath)
$shas = & git -C $RepoRoot log --format=%H -2 -- $RelPath 2>$null
if ($LASTEXITCODE -ne 0 -or -not $shas) {
return [pscustomobject]@{ Ok = $false; Why = 'tep chua tracked / khong co lich su git' }
}
$shas = @($shas)
if ($shas.Count -lt 2) {
return [pscustomobject]@{ Ok = $false; Why = ('chi co {0} commit cham tep nay - chua co ban truoc CUNG DON VI de so' -f $shas.Count) }
}
$prev = & git -C $RepoRoot show ("{0}:{1}" -f $shas[1], $RelPath) 2>$null
if ($LASTEXITCODE -ne 0) {
return [pscustomobject]@{ Ok = $false; Why = 'khong doc duoc ban truoc tu git' }
}
$prevText = ($prev -join "`n")
$prevChars = $prevText.Length
$prevItems = @($prevText -split "`n" | Where-Object { $_ -match '^\s*[-*] ' -or $_ -match '^\s*\|' }).Count
if ($prevChars -eq 0) {
return [pscustomobject]@{ Ok = $false; Why = 'ban truoc rong - ti le vo nghia' }
}
$r = [math]::Round($NowChars / [double]$prevChars, 3)
return [pscustomobject]@{
Ok = $true; Ratio = $r; PrevChars = $prevChars; PrevItems = $prevItems
PrevSha = $shas[1].Substring(0, 7)
}
}
# ---------------------------------------------------------------------------
# Soi 1 thu muc luot chay.
# ---------------------------------------------------------------------------
function Scan-Run {
param([System.IO.DirectoryInfo]$Dir, [switch]$DoV4)
$run = $Dir.Name
$script:NFolder++
$allMd = @(Get-ChildItem -LiteralPath $Dir.FullName -Recurse -File -Filter '*.md' -ErrorAction SilentlyContinue)
$flat = @($allMd | Where-Object { $_.Directory.FullName -eq $Dir.FullName })
# C8 dual-accept: 5 thu muc cu giu 'sub-md/' + 'harvest/'. Khong tinh chung
# la 'ngoai cau truc' - lam the la de 5 luot chay hop le keu oan ngay ngay dau.
$c8 = @($allMd | Where-Object {
$p = $_.Directory.Name
($p -eq 'harvest' -or $p -eq 'sub-md') -and ($_.Directory.Parent.FullName -eq $Dir.FullName) })
$arts = @($flat + $c8)
$other = @($allMd | Where-Object { $arts -notcontains $_ })
foreach ($o in $other) {
$rel = $o.FullName.Substring($Dir.FullName.Length + 1) -replace '\\', '/'
$script:NOutOfShape += ("{0}/{1}" -f $run, $rel)
}
# --- THIEU-TAP (luat 5 / chieu A2 fault-inject) --------------------------
if ($arts.Count -eq 0) {
Add-Missing $run 'thu muc luot chay KHONG CO vat .md nao - phep do khong ton tai, khong phai "sach"'
Write-Host (" [{0}] FLAG THIEU-TAP: 0 vat .md" -f $run) -ForegroundColor Red
return
}
$runMd = $arts | Where-Object { $_.Name -eq 'run.md' } | Select-Object -First 1
if (-not $runMd) {
Add-Flag 'VANG' $run 'run.md' 'thu muc luot chay khong co run.md - mat NGUON-2 cua diem danh 2 nguon (V-3 khong do duoc o day)'
}
$synth = @($arts | Where-Object { $_.Name -match $RX_SYNTH -and $_.Length -gt 0 })
if ($synth.Count -eq 0 -and $runMd) {
Add-Flag 'VANG' $run '*-synthesis.md' 'khong co ban gom non-empty (dual-accept flat + harvest/) - cung tieu chi voi nhip-no-probe run-chua-gom'
}
# --- V-1 / V-2 tren tung vat ---------------------------------------------
$rows = @()
foreach ($f in $arts) {
$script:NFile++
$m = Measure-Artifact -File $f
$isSub = ($f.Name -match $RX_SUBFAM)
if ($m.Bytes -eq 0) {
Add-Flag 'RONG' $run $f.Name 'tep 0 byte'
$rows += [pscustomobject]@{ N = $f.Name; V = 'RONG'; D = '0 B' }
continue
}
# V-2 - nhan treo neo HEADING (vi tu chinh cho CUT)
if ($m.Ph -gt 0) {
Add-Flag 'CUT' $run $f.Name ('V-2: {0}/{1} heading con nhan treo (mau so = so heading cua chinh tep nay)' -f $m.Ph, $m.Head)
$rows += [pscustomobject]@{ N = $f.Name; V = 'CUT(V-2)'; D = ('{0}/{1} heading treo' -f $m.Ph, $m.Head) }
}
# V-1 - ti le ruot/khung (luoi PHU, chi ap ho sub-*/-return)
if ($isSub) {
if ($m.Head -eq 0) {
$script:NSkipV1++
$rows += [pscustomobject]@{ N = $f.Name; V = 'V1-KHONG-AP-DUNG'; D = ('0 heading, {0} B - khong chia duoc, KHONG doc thanh sach' -f $m.Bytes) }
}
elseif ($m.Ratio -lt $K) {
Add-Flag 'CUT' $run $f.Name ('V-1: ruot/khung {0} < K={1} (body {2} dong / head {3} dong)' -f $m.Ratio, $K, $m.Body, $m.Head)
if ($m.Ph -eq 0) { $rows += [pscustomobject]@{ N = $f.Name; V = 'CUT(V-1)'; D = ('ti le {0} < {1}' -f $m.Ratio, $K) } }
}
}
# V-4 - nen qua tay
if ($DoV4) {
$rel = $f.FullName.Substring($RepoRoot.Length + 1) -replace '\\', '/'
$c = Test-Compression -RelPath $rel -NowChars $m.Chars -NowItems $m.Items -FullPath $f.FullName
if (-not $c.Ok) {
$script:NV4Unmeasurable++
} else {
$script:NV4Measured++
if ($c.Ratio -lt 0.70 -and $m.Items -lt $c.PrevItems) {
$txt = [System.IO.File]::ReadAllText($f.FullName, [System.Text.Encoding]::UTF8)
$mien = ($txt -match 'archive/' -or $txt -match 'con-tro' -or $txt -match 'moved-not-cut' -or $txt -match 'doi verbatim')
if ($mien) {
$rows += [pscustomobject]@{ N = $f.Name; V = 'NEN-MIEN'; D = ('{0}x so voi {1}, NHUNG co khai noi-di (mien tru HIEN HINH)' -f $c.Ratio, $c.PrevSha) }
} else {
Add-Flag 'NEN' $run $f.Name ('V-4: con {0}x so ky tu so voi {1} ({2} -> {3} ky tu) VA so muc giam {4} -> {5}, KHONG thay dong khai noi-di' -f $c.Ratio, $c.PrevSha, $c.PrevChars, $m.Chars, $c.PrevItems, $m.Items)
}
}
}
}
}
# --- V-3 - diem danh HAI NGUON (dia <-> run.md ghi TRUOC launch) -------
$v3 = 'KHONG DO DUOC'
if ($runMd) {
$runTxt = [System.IO.File]::ReadAllText($runMd.FullName, [System.Text.Encoding]::UTF8)
$named = @([regex]::Matches($runTxt, $RX_NAMEREF) | ForEach-Object { $_.Value } | Sort-Object -Unique)
$onDisk = @($arts | ForEach-Object { $_.Name } | Sort-Object -Unique)
if ($named.Count -eq 0) {
$v3 = 'KHONG DO DUOC'
Add-Missing $run 'V-3: run.md KHONG neu ten tep artifact nao => NGUON-2 rong. Day KHONG phai "chenh 0".'
} else {
$missOnDisk = @($named | Where-Object { $onDisk -notcontains $_ })
$notDeclared= @($onDisk | Where-Object { $named -notcontains $_ -and $_ -ne 'run.md' })
# Ten khong co trong thu muc NAY co the la con tro CHEO sang luot chay
# TRUOC - runs/README.md:39 (C2 buoc 3) BAT run.md tro 'input spec:' sang
# synthesis cua luot truoc. Tep co that, nam thu muc khac. So trong MOT thu
# muc roi keu 'vang' la loi cua MAY, khong phai no cua kho.
$crossRef = @(); $reallyMissing = @()
foreach ($x in $missOnDisk) {
if ($script:AllNamesInRuns.ContainsKey($x)) { $crossRef += $x } else { $reallyMissing += $x }
}
$v3 = ('nguon-2 neu {0} ten | thieu-tren-dia {1} | tro-cheo {2} | khong-khai {3}' -f $named.Count, $reallyMissing.Count, $crossRef.Count, $notDeclared.Count)
foreach ($x in $reallyMissing) { Add-Flag 'VANG' $run $x 'V-3: run.md co neu ten nay, va KHONG TIM THAY o bat ky luot chay nao' }
# KHONG-KHAI: dem RIENG, KHONG phai co. Chua he co luat nao bat run.md
# neu ten tep => 245/720 co cho mot luat khong ton tai = duong-gia ngay dau.
# Nhung con SO thi giu, vi no chung minh NGUON-2 mong den muc nao.
$script:NKhongKhai += $notDeclared.Count
$script:NTroCheo += $crossRef.Count
}
}
# --- in per-run ----------------------------------------------------------
$bad = @($rows).Count
$color = if ($bad -gt 0) { 'Yellow' } else { 'DarkGray' }
Write-Host (" [{0}]" -f $run) -ForegroundColor $color
Write-Host (" mau so: {0} vat .md (phang {1} + C8 harvest|sub-md {2}) | V-3: {3}" -f $arts.Count, $flat.Count, $c8.Count, $v3)
foreach ($r in $rows) {
$c = if ($r.V -like 'CUT*' -or $r.V -eq 'RONG') { 'Red' } else { 'DarkGray' }
Write-Host (" [{0,-16}] {1} <- {2}" -f $r.V, $r.N, $r.D) -ForegroundColor $c
}
}
# ---------------------------------------------------------------------------
# -BuildIndex : sinh muc luc DERIVE-VIEW tu dia.
# Vi sao derive-view chu khong phai so chep tay: so chep tay se thanh NGUON-DOI
# ngay khi ai do quen mot dong - va do dung cach `_ledger.md` da chet (15 dong,
# toan 2026-06-18, trong khi dia da di toi 2026-08-07).
# ---------------------------------------------------------------------------
function Build-Index {
if (-not (Test-Path -LiteralPath $RunsRoot)) {
Write-Host ' FLAG THIEU-TAP: khong co thu muc runs/ - khong sinh duoc muc luc.' -ForegroundColor Red
return
}
$dirs = @(Get-ChildItem -LiteralPath $RunsRoot -Directory | Sort-Object Name)
$sb = New-Object System.Text.StringBuilder
$null = $sb.AppendLine('# `runs/_index.md` - MUC LUC SONG (DERIVE-VIEW, sinh tu dia)')
$null = $sb.AppendLine('')
$null = $sb.AppendLine('> **CAM SUA TAY. CAM DUNG LAM NGUON.** Tep nay duoc SINH LAI tron ven bang')
$null = $sb.AppendLine('> `powershell -File scripts/artifact-integrity.ps1 -BuildIndex`. Moi dong deu doc thang tu dia.')
$null = $sb.AppendLine('> Sua tay o day = de ra nguon-doi, dung benh da giet `_ledger.md` (so chep tay, RETIRED H18-B S100:')
$null = $sb.AppendLine('> 15 dong, toan 2026-06-18, trong khi dia da di toi hom nay).')
$null = $sb.AppendLine('>')
$null = $sb.AppendLine('> **Tang-A (goi theo loai) = `README.md` canh ben** - chuc nang, ai ghi, ai doc, bo tep chuan.')
$null = $sb.AppendLine('> **Tang-B (muc luc song) = tep nay.** Hai tang, khong tang nao chep tang kia.')
$null = $sb.AppendLine('>')
$null = $sb.AppendLine('> [!] **Tep nay KHONG duoc dung lam nguon-2 cua diem danh 2 nguon** - no doc thang dia,')
$null = $sb.AppendLine('> tuc no CHINH LA nguon-1. Nguon-2 la anh chup taskList trong tung `run.md` (ghi TRUOC launch).')
$null = $sb.AppendLine('')
$null = $sb.AppendLine(('- **Sinh luc:** {0}' -f (Get-Date -Format 'yyyy-MM-dd HH:mm')))
$null = $sb.AppendLine(('- **Mau so:** {0} thu muc luot chay (dem THU MUC, khong dem entry - `ls` con thay ca tep README/_ledger/_index)' -f $dirs.Count))
$null = $sb.AppendLine('')
$null = $sb.AppendLine('| luot chay | run.md | vat .md | ban gom | co V-2 (nhan treo) | byte |')
$null = $sb.AppendLine('|---|---|---|---|---|---|')
foreach ($d in $dirs) {
$md = @(Get-ChildItem -LiteralPath $d.FullName -Recurse -File -Filter '*.md' -ErrorAction SilentlyContinue)
$hasRun = if ($md | Where-Object { $_.Name -eq 'run.md' -and $_.Directory.FullName -eq $d.FullName }) { 'co' } else { '**VANG**' }
$syn = @($md | Where-Object { $_.Name -match $RX_SYNTH -and $_.Length -gt 0 })
$hasSyn = if ($syn.Count -gt 0) { 'co' } else { '**VANG**' }
$ph = 0
foreach ($f in $md) {
if ($f.Length -eq 0) { continue }
$t = [System.IO.File]::ReadAllText($f.FullName, [System.Text.Encoding]::UTF8)
foreach ($ln in ($t -split "`r?`n")) { if ($ln -match $RX_PLACEHOLDER_HEAD) { $ph++ } }
}
$phTxt = if ($ph -gt 0) { ('**{0}**' -f $ph) } else { '0' }
$bytes = ($md | Measure-Object -Property Length -Sum).Sum
$null = $sb.AppendLine(('| `{0}` | {1} | {2} | {3} | {4} | {5} |' -f $d.Name, $hasRun, $md.Count, $hasSyn, $phTxt, $bytes))
}
$out = Join-Path $RunsRoot '_index.md'
[System.IO.File]::WriteAllText($out, $sb.ToString(), (New-Object System.Text.UTF8Encoding($false)))
Write-Host (" Da sinh: {0}/_index.md ({1} thu muc luot chay)" -f $RunsRel, $dirs.Count) -ForegroundColor Green
}
# ===========================================================================
# MAIN
# ===========================================================================
Write-Host '=== artifact-integrity.ps1 - MAY DIEM DANH VAT CHUNG ===' -ForegroundColor White
Write-Host ("RepoRoot : {0}" -f $RepoRoot)
Write-Host "Che do : INFORM-only. LUON exit 0 ke ca khi co co (lai ma thoat = W3b, sau P1=PA-2)."
Write-Host "Vi tu : V-1 ti le ruot/khung | V-2 nhan treo neo HEADING | V-3 diem danh 2 nguon | V-4 nen qua tay"
Write-Host ("Nguong : K={0} (V-1) = phan vi 5 cua ho sub-*, do 2026-08-07, mau so 446 tep co heading." -f $K)
Write-Host " Tai K nay, 20/446 tep lich su (4,5%) cung nam duoi nguong => co KHONG doc thanh 'hong'."
if ($BuildIndex) {
Write-Head '--- SINH MUC LUC DERIVE-VIEW ---'
Build-Index
Write-Host ''
Write-Host ' Ma thoat: 0 (INFORM-only theo hop dong muc 1).'
exit 0
}
if (-not (Test-Path -LiteralPath $RunsRoot)) {
Write-Head '--- DIEM DANH ---'
Write-Host (" FLAG THIEU-TAP: khong tim thay '{0}'." -f $RunsRel) -ForegroundColor Red
Write-Host " Day KHONG phai [skip]. Tap vang mat => phep do KHONG TON TAI, va so co 0 ben duoi VO NGHIA." -ForegroundColor Red
Add-Missing '(goc)' 'thu muc runs/ vang mat'
$dirs = @()
} elseif ($RunId) {
$one = Join-Path $RunsRoot $RunId
if (-not (Test-Path -LiteralPath $one)) {
Write-Head '--- DIEM DANH ---'
Write-Host (" FLAG THIEU-TAP: khong co luot chay '{0}'." -f $RunId) -ForegroundColor Red
Add-Missing $RunId 'thu muc luot chay duoc chi dinh nhung khong ton tai'
$dirs = @()
} else { $dirs = @(Get-Item -LiteralPath $one) }
} else {
$dirs = @(Get-ChildItem -LiteralPath $RunsRoot -Directory | Sort-Object Name)
}
if (Test-Path -LiteralPath $RunsRoot) {
foreach ($f in (Get-ChildItem -LiteralPath $RunsRoot -Recurse -File -Filter '*.md' -ErrorAction SilentlyContinue)) {
$script:AllNamesInRuns[$f.Name] = $true
}
}
$doV4 = ($RunId -and -not $V4All) -or $V4All
Write-Head ("--- DIEM DANH: {0} thu muc luot chay ---" -f $dirs.Count)
if (-not $doV4) {
Write-Host " V-4 (nen qua tay): KHONG DO DUOC o che do quet-toan-bo - moi tep ton 1-2 lenh git." -ForegroundColor DarkGray
Write-Host " Bat bang -RunId <ten> (1 luot chay) hoac -V4All (chap nhan cham). KHONG phai 'da do va sach'." -ForegroundColor DarkGray
}
foreach ($d in $dirs) { Scan-Run -Dir $d -DoV4:$doV4 }
# ---------------------------------------------------------------------------
Write-Head '=== TONG ==='
Write-Host (" mau so : {0} thu muc luot chay | {1} vat .md da do" -f $script:NFolder, $script:NFile)
$byKind = $script:Flags | Group-Object Kind | Sort-Object Name
if ($script:Flags.Count -eq 0) {
Write-Host (" CO : 0/{0} vat" -f $script:NFile) -ForegroundColor Green
Write-Host " [!] 0 co CHI co nghia khi mau so tren khac 0 VA so THIEU-TAP ben duoi = 0." -ForegroundColor Yellow
} else {
Write-Host (" CO : {0} (tren {1} vat)" -f $script:Flags.Count, $script:NFile) -ForegroundColor Red
foreach ($g in $byKind) { Write-Host (" {0,-11} : {1}" -f $g.Name, $g.Count) -ForegroundColor Red }
}
# THIEU-TAP in RIENG, canh so co - de so 0 mat quyen doc thanh 'sach' (luat 5).
if ($script:MissingSets.Count -gt 0) {
Write-Host (" THIEU-TAP : {0} <- dem TACH khoi so co tren. Moi tap vang lam mot phep do BIEN MAT." -f $script:MissingSets.Count) -ForegroundColor Red
foreach ($m in $script:MissingSets) { Write-Host (" - [{0}] {1}" -f $m.Run, $m.Msg) -ForegroundColor Red }
} else {
Write-Host " THIEU-TAP : 0"
}
Write-Host (" V-1 khong ap dung : {0}/{1} vat (0 heading => khong chia duoc; KHONG phai 'sach')" -f $script:NSkipV1, $script:NFile)
# Hai hang muc DEM RIENG, KHONG phai co - va KHONG duoc giau di. Giau con so nay
# la giau chinh bang chung "nguon-2 mong".
Write-Host (" KHONG-KHAI : {0}/{1} vat co tren dia ma run.md khong neu ten." -f $script:NKhongKhai, $script:NFile)
Write-Host " DEM RIENG, KHONG phai co: chua he co luat bat run.md neu ten tep."
Write-Host " Day la thuoc do do MONG cua NGUON-2, khong phai danh sach vi pham."
Write-Host (" TRO-CHEO : {0}/{1} ten run.md neu ma nam o luot chay KHAC" -f $script:NTroCheo, $script:NFile)
Write-Host " (runs/README.md:39 C2 buoc 3 BAT tro 'input spec:' sang luot truoc) - HOP LE."
if ($doV4) {
Write-Host (" V-4 do duoc : {0} vat | KHONG DO DUOC {1} vat (chua tracked hoac chi 1 commit cham tep)" -f $script:NV4Measured, $script:NV4Unmeasurable)
}
if ($script:NOutOfShape.Count -gt 0) {
Write-Host (" NGOAI CAU TRUC PHANG : {0} tep (C1 doi phang; C8 mien 'harvest/'+'sub-md/'). In ten, KHONG im lang:" -f $script:NOutOfShape.Count) -ForegroundColor Yellow
foreach ($x in $script:NOutOfShape) { Write-Host (" - {0}" -f $x) -ForegroundColor Yellow }
}
if ($script:Flags.Count -gt 0) {
Write-Host ''
Write-Host ' Danh sach CO (tung ten - cam nen thanh so tong):' -ForegroundColor Red
foreach ($x in $script:Flags) { Write-Host (" - [{0,-11}] {1}/{2} <- {3}" -f $x.Kind, $x.Run, $x.Name, $x.Msg) }
}
Write-Host ''
Write-Host ' Ma thoat: 0 (INFORM-only theo hop dong muc 1). Co o tren KHONG lai ma thoat.'
Write-Host ' Lai ma thoat thuoc wave W3b, sau khi chu du an chot phan loai co theo PA-2.'
exit 0